Custom Permalink Editor

Advanced Filters

For developers who need more control, Custom Permalink Editor provides several filters to customize its behavior.

Add PATH_INFO in $_SERVER Variable

Enable PATH_INFO support in the $_SERVER variable. This is useful for certain server configurations.

Usage:

add_filter( 'cp_editor_path_info', '__return_true' );

Exclude Specific Permalinks

Prevent specific permalinks from being processed by the plugin. Useful for excluding system files like sitemaps or special pages.

Example: Exclude sitemap.xml from processing

function team_kcg_exclude_permalink( $permalink ) { // Check if permalink contains 'sitemap.xml' if ( false !== strpos( $permalink, 'sitemap.xml' ) ) { return '__true'; } return; } add_filter( 'cp_editor_exclude_permalink', 'team_kcg_exclude_permalink' );

Exclude Specific Post Types

Remove the Custom Permalink Editor form from specific post types. Helpful if you want to disable the feature for certain content types.

Example: Exclude a custom post type called ‘custompost’

function team_kcg_exclude_post_type( $post_type ) { // Replace 'custompost' with your actual post type name if ( 'custompost' === $post_type ) { return '__true'; } return '__false'; } add_filter( 'cp_editor_exclude_post_type', 'team_kcg_exclude_post_type' );

Exclude Specific Posts

Exclude individual posts or pages from showing the Custom Permalink Editor form. You can filter by ID, template, or any post property.

Example: Exclude post with ID 1557

function team_kcg_exclude_posts( $post ) { // Exclude specific post by ID if ( 1557 === $post->ID ) { return true; } // You can also exclude by other criteria // Example: Exclude posts with a specific template // if ( get_page_template_slug( $post->ID ) === 'template-landing.php' ) { // return true; // } return false; } add_filter( 'cp_editor_exclude_posts', 'team_kcg_exclude_posts' );

Allow Accented Characters

By default, the plugin removes accents from permalinks for better URL compatibility. Enable this filter if you need to preserve accented characters.

Usage:

function team_kcg_allow_accents() { return true; } add_filter( 'cp_editor_allow_accents', 'team_kcg_allow_accents' );

Allow Capital Letters

By default, permalinks are converted to lowercase. Use this filter to preserve capital letters in your custom URLs.

Usage:

function team_kcg_allow_capitals() { return true; } add_filter( 'cp_editor_allow_caps', 'team_kcg_allow_capitals' );

Note: Add these code snippets to your theme’s functions.php file or use a custom plugin/code snippets plugin.

How To Use

Changing a Post or Page Permalink:

1. 06Navigate to Posts > All Posts (or Pages > All Pages)
2. 07Click on the post/page you want to edit
3. 08Scroll down to find the “Custom Permalink Editor” meta box
4. 09Enter your desired custom URL in the text field (without the domain)
5. 10Click “Update” or “Publish” to save your changes
6. 11Visit your post to see the new permalink in action!

Example: – Default URL: yoursite.com/2026/01/11/my-blog-post/ – Custom URL: yoursite.com/seo-friendly-custom-url/

Reverting to Default Permalinks:

Simply deactivate the plugin and all posts will automatically revert to WordPress default permalink structure.