ssnepenthe / wp-hashids
WordPress 的 Hashids 实现
Requires
- php: ^5.6 || ^7.0 || ^8.0
- composer/installers: ^1.0
- hashids/hashids: ^2.0 || ^3.0 || ^4.0
- league/plates: ^3.3
- ssnepenthe/metis: ^0.6
- ssnepenthe/wp-requirements: ^0.1
Requires (Dev)
- aaemnnosttv/wp-sqlite-db: dev-master
- brain/monkey: ^2.6.1
- koodimonni/composer-dropin-installer: ^1.4
- phpunit/phpunit: ^5.7 || ^6.0 || ^7.0 || ^8.0 || ^9.0
- roots/wordpress: ^6.1
- wp-phpunit/wp-phpunit: ^6.1
- yoast/phpunit-polyfills: ^1.0.1
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' )
来访问。
配置
已自动为您设置合理的默认值。
如果您想设置自定义值,有两种方法可以实现
- 定义任意数量的
WP_HASHIDS_*
常量(推荐) - 浏览到
wp-admin > 设置 > wp hashids
并通过提供的界面设置值。
以下常量可用于配置
WP_HASHIDS_ALPHABET
- 有效选项为lower
、upper
、lowerupper
、lowernumber
、uppernumber
和all
。更改此常量后,您需要手动刷新重写规则,方法是在设置 > 永久链接
中进行。WP_HASHIDS_MIN_LENGTH
- 可以是任何大于等于 0 的整数。WP_HASHIDS_SALT
- 应该是一个独特的字符串,以确保 hashids 对您的站点是唯一的。
请注意,对插件设置的任何更改都将立即更改所有使用 %hashid%
重写标签的帖子 URL,因此仅在插件激活后立即修改。
如果配置了所有三个常量,则 WP Hashids
设置页面将不可见。
注意事项
如前所述,更改任何配置值都会导致所有帖子 URL 发生变化。这应该在安装插件后立即完成。
本插件提供了一种在 URL 中混淆帖子 ID 的方法,但它并不尝试在其他地方隐藏它们。如果您需要完全从用户那里隐藏帖子 ID,请寻找其他解决方案。
支持自定义帖子类型,但如果您想从 URL 中删除帖子名称,则需要使用 add_permastruct()
配置自定义永久结构。
警告
HASHIDS 仅在永久链接中提供 ID 的混淆。
它不提供加密,也不安全。
您应该假设任何可以查看您站点的人都可以读取您的盐值!
因此,您不应(重新)使用任何敏感信息(如密码或核心盐值)作为 hashids 的盐值。
您的盐值应该是一个独特的值,仅供本插件使用。
有关更多信息,请参阅以下链接 这里。