ssnepenthe / wp-hashids
A Hashids implementation for WordPress
Installs: 25
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 4
Forks: 1
Open Issues: 5
Type:wordpress-plugin
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-10-08 22:29:29 UTC
README
This plugin provides a Hashids implementation for WordPress.
Requirements
WordPress 4.7 or greater, PHP 5.6 or greater and Composer.
Installation
Install using Composer:
$ composer require ssnepenthe/wp-hashids
Usage
Once the plugin is activated, browse to wp-admin > settings > permalinks
and set a custom structure which contains the tag %hashid%
.
If you need to manually interact with the underlying Hashids instance for some reason, it can be accessed by calling _wph_instance( 'hashids' )
.
Configuration
Sensible defaults are automatically set for you.
If you wish to set custom values, there are two methods for doing so:
- Define any number of
WP_HASHIDS_*
constants (preferred) - Browse to
wp-admin > settings > wp hashids
and set the values via the provided interface.
The following constants can be used for configuration:
WP_HASHIDS_ALPHABET
- valid options arelower
,upper
,lowerupper
,lowernumber
,uppernumber
, andall
. You will need to manually flush rewrite rules after changing this constant by going tosettings > permalinks
.WP_HASHIDS_MIN_LENGTH
- can be any integer >= 0.WP_HASHIDS_SALT
- should be a unique string to ensure hashids are unique to your site.
Keep in mind that any changes to the plugin settings will immediately change all post URLs that use the %hashid%
rewrite tag, and as such, should only be modified immediately after plugin activation.
If all three constants are configured, the WP Hashids
settings page will not be visible.
Considerations
As mentioned previously, changing any config value will result in all of your post URLs changing. This should only be done immediately after installing the plugin.
This plugin provides a method of obfuscating post IDs in URLs, however it makes no attempt to hide them anywhere else. If you need to completely mask post IDs from your users, look elsewhere.
Custom post types are supported but you will need to configure a custom permastruct using add_permastruct()
if you want to remove the post name from the URL.
Warning
HASHIDS ONLY PROVIDES OBFUSCATION OF IDS IN PERMALINKS.
IT DOES NOT PROVIDE ENCRYPTION AND IT IS NOT SECURE.
YOU SHOULD ASSUME THAT YOUR SALT CAN AND WILL BE READ BY ANYONE THAT CAN VIEW YOUR SITE!
FOR THIS REASON, YOU SHOULD NOT (RE)USE ANY SENSITIVE INFORMATION (LIKE PASSWORDS OR CORE SALTS) FOR YOUR HASHIDS SALT.
YOUR SALT SHOULD BE A UNIQUE VALUE THAT IS ONLY USED BY THIS PLUGIN.
FOR MORE INFORMATION, CHECK THE LINKS LISTED HERE.