ssnepenthe/wp-hashids

WordPress 的 Hashids 实现

安装: 25

依赖项: 0

建议者: 0

安全性: 0

星标: 3

关注者: 4

分支: 1

开放问题: 5

类型:wordpress-plugin

0.1.5 2023-02-06 01:11 UTC

This package is auto-updated.

Last update: 2024-09-08 22:18:33 UTC


README

本插件为 WordPress 提供了 Hashids 实现。

需求

WordPress 4.7 或更高版本,PHP 5.6 或更高版本,以及 Composer。

安装

使用 Composer 安装

$ composer require ssnepenthe/wp-hashids

使用方法

激活插件后,浏览到 wp-admin > 设置 > 永久链接 并设置包含标签 %hashid% 的自定义结构。

如果由于某种原因需要手动与底层的 Hashids 实例交互,可以通过调用 _wph_instance( 'hashids' ) 来访问。

配置

已自动为您设置合理的默认值。

如果您想设置自定义值,有两种方法可以实现

  1. 定义任意数量的 WP_HASHIDS_* 常量(推荐)
  2. 浏览到 wp-admin > 设置 > wp hashids 并通过提供的界面设置值。

以下常量可用于配置

  • WP_HASHIDS_ALPHABET - 有效选项为 lowerupperlowerupperlowernumberuppernumberall。更改此常量后,您需要手动刷新重写规则,方法是在 设置 > 永久链接 中进行。
  • WP_HASHIDS_MIN_LENGTH - 可以是任何大于等于 0 的整数。
  • WP_HASHIDS_SALT - 应该是一个独特的字符串,以确保 hashids 对您的站点是唯一的。

请注意,对插件设置的任何更改都将立即更改所有使用 %hashid% 重写标签的帖子 URL,因此仅在插件激活后立即修改。

如果配置了所有三个常量,则 WP Hashids 设置页面将不可见。

注意事项

如前所述,更改任何配置值都会导致所有帖子 URL 发生变化。这应该在安装插件后立即完成。

本插件提供了一种在 URL 中混淆帖子 ID 的方法,但它并不尝试在其他地方隐藏它们。如果您需要完全从用户那里隐藏帖子 ID,请寻找其他解决方案。

支持自定义帖子类型,但如果您想从 URL 中删除帖子名称,则需要使用 add_permastruct() 配置自定义永久结构。

警告

HASHIDS 仅在永久链接中提供 ID 的混淆。

它不提供加密,也不安全。

您应该假设任何可以查看您站点的人都可以读取您的盐值!

因此,您不应(重新)使用任何敏感信息(如密码或核心盐值)作为 hashids 的盐值。

您的盐值应该是一个独特的值,仅供本插件使用。

有关更多信息,请参阅以下链接 这里