Slugs mode

With Permalink Manager, you have the ability to customize how the default permalinks are generated for new posts and terms. In the plugin settings, you can select one of three available options in the "Slugs mode" field.

It is important to remember that the "Slugs mode" determines how the default permalinks are created for new posts or terms. This setting will not affect any existing content unless you use the "Regenerate/reset" tool. If you need to, you can manually overwrite any custom permalinks with the URI Editor and adjust them as necessary.

Available settings

Use native slugs

The native slugs are used by WordPress in posts' and terms' original permalinks. They are generated after the post or term is published. Please note that the slug remains unchanged even if you change the post/term title.

Basically, the native slugs are used to identify the posts/terms when they are stored in the database. What is more important, they are also used in the native permalink system. WordPress parses the slug from requested URL and uses it to detect what post/term should be loaded.

In short, when you keep "Use native slugs" mode selected, Permalink Manager will use the same slugs as WordPress does for the default permalinks.

Use actual titles as slugs

Permalink Manager works differently than the native permalink system in WordPress. When a URL is requested and parsed by WordPress, the built-in permalink functions use the native slug to detect what content should be loaded. However, Permalink Manager uses the full URL address instead, providing more flexibility. It will recognize customized URLs as long as they are unique as a whole, regardless of whether they include native slugs or not. This is possible because the plugin stores statically in the database the full permalinks as a whole.

By default, Permalink Manager also uses native slugs when generating custom permalinks. However, if you would like to use actual titles rather than native slugs when creating new custom permalinks (which may be useful if you want to reuse the same slug for multiple pages), you can do so by selecting "Use actual titles as slugs" in the "Slugs mode" option box in Permalink Manager settings.

In the following example, you can see precisely how this works. By default, the permalink had the native slug 'johnny-doe' however in this mode it contains the actual title 'john-doe'.

Another illustration of the difference between a native slug and a slug created from a title may be found in the table below. The the native slug is replaced with actual title not only for the specific page/term but also for its parents (see last column).

This functionality could be also very helpful if you would like to use the same slug in more than one permalink. You can use the same slug more than once, but still you need to make sure that the full URL address is unique.

Inherit parents' slugs

This mode will be useful, if you would like make the child categories or pages inherit the permalink of their parent after it is manually adjusted.

As you can see on above example, the custom permalink for top-category was changed from: shop/apparel to top-clothes. If inherit parents' slug mode is enabled, the default permalinks for child categories will be also affected.

Please note that after you change the parent permalink, the children permalinks will not be automatically updated. The new parent permalink will be inherited only by new terms and pages. For example, if you already have a structure of pages in a parent-child relationship and you change the parent's slug - you will still need to regenerate their permalinks. You can do so in Tools > Permalink Manager > Tools > Regenerate/Reset section.

To prevent this from happening, you need to exclude parents permalinks to make Regenerate/Reset tool ignore them. As shown below, in URI Editor you should select "No (ignore this URI in bulk tools)" option in "Auto-update the URI" option field.

How to override the global settings

If necessary, you can conditionally change the global settings for selected post types or taxonomies. This allows you to customize the behavior of the plugin according to your specific needs and requirements.

Simply use the appropriate filter and specify the post types or taxonomies that you wish to modify, and the plugin will automatically apply the changes to those specific content types.

How to use actual titles for selected taxonomies

Here is a sample snippet that shows how to configure Permalink Manager to use actual titles in the default permalinks of WooCommerce product categories, rather than slugs:

/**
* @param int $mode Set '1' to use actual titles, set '0' to force the default settings and use the native slugs in the custom permalinks.
* @param string $slug The native slug
* @param WP_Post|WP_Term $object Post or term object
*
* @return int The slug mode.
*/
function pm_term_use_title_instead_of_slug( $mode, $slug, $object ) {
return ( ! empty( $object->taxonomy ) && $object->taxonomy == 'product_cat' ) ? 1 : $mode;
}
add_filter( 'permalink_manager_force_custom_slugs', 'pm_term_use_title_instead_of_slug', 9, 3 );

How to use actual titles for selected post types

To complete the instructions, please find below a second code snippet showing how to override the global settings for post types (e.g., WooCommerce products) as well:

/**
* @param int $mode Set '1' to use actual titles, set '0' to force the default settings and use the native slugs in the custom permalinks.
* @param string $slug The native slug
* @param WP_Post|WP_Term $object Post or term object
*
* @return int The slug mode.
*/
function pm_cpt_use_title_instead_of_slug( $mode, $slug, $object ) {
return ( ! empty( $object->post_type ) && $object->post_type == 'product' ) ? 1 : $mode;
}
add_filter( 'permalink_manager_force_custom_slugs', 'pm_cpt_use_title_instead_of_slug', 9, 3 );