WordPress自定义sanitize_title函数在slug前追加字符串失效如何解决

问题根因 #

你遇到的问题由两个核心原因导致：

1. 冒号:不属于自定义过滤规则的允许字符范围：你代码中的$title = preg_replace('/[^%a-zA-Z0-9 _-]/', '', $title);规则仅允许百分号、大小写字母、数字、空格、下划线、横杠，冒号不在允许列表中。虽然你在return阶段才拼接前缀，但sanitize_title钩子会在多个场景下被重复调用，第二次处理你返回的带冒号字符串时，冒号会被移除，甚至可能因特殊字符截断逻辑导致后续原slug内容被误清理。
2. 全局修改sanitize_title逻辑存在副作用：这个钩子是全局生效的，文章、页面、标签、菜单等所有需要清理别名的场景都会触发该过滤，全局拼接前缀会污染其他内容类型的别名，也容易触发重复过滤问题。

解决方案 #

方案1（推荐）：仅针对分类别名加前缀，不全局修改sanitize_title #

如果你只需要给分类（category）的别名加前缀，直接使用pre_category_nicename钩子处理即可，不需要修改原有sanitize_title逻辑，安全性更高不会影响其他内容：

// 直接添加这段代码即可，无需修改原有自定义sanitize_title逻辑
add_filter( 'pre_category_nicename', 'add_category_prefix_to_slug' );
function add_category_prefix_to_slug( $slug ) {
    // 先判断是否已经加过前缀，避免重复添加
    if ( strpos( $slug, 'Category-' ) === false ) {
        // 注意：slug不允许冒号，这里建议将冒号替换为下划线或横杠，如果你一定要用冒号，请看方案2的处理
        $slug = 'Category-' . $slug;
    }
    return $slug;
}

方案2：如果必须在自定义sanitize_title函数中加前缀且保留冒号 #

需要修改两处代码：

• 在正则允许列表中加入冒号，避免二次过滤时被删除
• 增加前缀重复判断，避免多次调用时重复拼接前缀
  修改后的完整函数代码如下：

remove_filter( 'sanitize_title', 'sanitize_title_with_dashes' );
// 指定接收3个参数，方便后续判断处理场景
add_filter( 'sanitize_title', 'wpse5029_sanitize_title_with_dashes', 10, 3 );

function wpse5029_sanitize_title_with_dashes($title, $raw_title, $context) {
    $title = strip_tags($title);
    // Preserve escaped octets.
    $title = preg_replace('|%([a-fA-F0-9][a-fA-F0-9])|', '---$1---', $title);
    // Remove percent signs that are not part of an octet.
    $title = str_replace('%', '', $title);
    // Restore octets.
    $title = preg_replace('|---([a-fA-F0-9][a-fA-F0-9])---|', '%$1', $title);

    $title = remove_accents($title);
    if (seems_utf8($title)) {
        //if (function_exists('mb_strtolower')) {
        //    $title = mb_strtolower($title, 'UTF-8');
        //}
        $title = utf8_uri_encode($title, 200);
    }

    //$title = strtolower($title);
    $title = preg_replace('/&.+?;/', '', $title); // kill entities
    $title = str_replace('.', '-', $title);
    // 修改正则，加入冒号到允许字符列表
    $title = preg_replace('/[^%a-zA-Z0-9 _:-]/', '', $title);
    $title = preg_replace('/\s+/', '_', $title);
    $title = preg_replace('|-+|', '_', $title);
    $title = trim($title, '-');

    // 拼接前缀前先判断是否已经存在前缀，也可自行补充逻辑限定仅分类场景下加前缀
    if ( strpos( $title, 'Category:' ) === false ) {
        $title = "Category:".$title;
    }

    return $title;
}

注意：冒号属于URL特殊字符，出现在别名中会被自动编码为%3A，可能影响URL可读性和SEO效果，非必要建议替换为横杠或下划线。

内容的提问来源于stack exchange，提问作者Suzan