如何在WordPress全站（前后端）批量替换指定词汇？

问题背景 #

需要在WordPress全站（前后端）批量替换以下词汇：

'Partner User' => 'Spa Owner',
'Hotel' => 'Spa',
'Hotels' => 'Spas',
'hotel' => 'spa',
'hotels' => 'spas',
'Hotel(s)' => 'Spa(s)',
'hotel(s)' => 'spa(s)'

尝试通过主题functions.php添加gettext过滤器实现，但仅后台部分区域和前端少数位置生效，怀疑语言文件加载顺序覆盖了替换效果，同时纠结是否用Poedit修改语言文件（担心操作复杂、手动工作量大），需要找到全站生效、不受主题更新影响的解决方案。

原代码的问题 #

你的代码存在两个核心问题：

1. 语法错误：替换数组中'hotel(s)' => 'spa(s)'后缺少逗号，导致PHP解析失败，代码无法完整执行
2. 覆盖场景不全：仅使用gettext过滤器，未处理复数翻译（ngettext）、带上下文的翻译（gettext_with_context），且优先级默认10，可能被后续加载的语言文件覆盖

修复后的全站生效代码方案 #

核心改进点 #

• 修复数组语法错误
• 提高过滤器优先级（设为99），确保在其他翻译逻辑之后执行
• 覆盖gettext/ngettext/gettext_with_context三类翻译场景
• 建议将代码放在自定义插件中（而非主题functions.php），彻底避免主题更新影响

完整代码 #

<?php
/*
Plugin Name: 全站文本替换工具
Description: 批量替换WordPress全站指定文本
Version: 1.0
Author: 自定义
*/

function global_text_replace( $translated, $original, $domain = null ) {
    // 替换规则数组
    $replacements = array(
        'Partner User' => 'Spa Owner',
        'Hotel' => 'Spa',
        'Hotels' => 'Spas',
        'hotel' => 'spa',
        'hotels' => 'spas',
        'Hotel(s)' => 'Spa(s)',
        'hotel(s)' => 'spa(s)',
        'Register' => 'Sign Up',
        'Confirm and go to payment page' => 'Complete registration',
        'No events available...' => 'No upcoming classes at this time...',
        'click here to add a new state/province' => 'click here to enter address outside US/Canada'
    );

    // 处理普通文本替换
    if ( isset( $replacements[$original] ) ) {
        $translated = $replacements[$original];
    }

    return $translated;
}

function global_text_replace_plural( $translated, $single, $plural, $number, $domain ) {
    // 复数替换规则（可根据需要扩展）
    $plural_replacements = array(
        'Hotel' => array('Spa', 'Spas'),
        'hotel' => array('spa', 'spas'),
        'Hotel(s)' => array('Spa(s)', 'Spa(s)'),
        'hotel(s)' => array('spa(s)', 'spa(s)')
    );

    // 处理单数/复数替换
    if ( isset( $plural_replacements[$single] ) ) {
        $translated = ( $number == 1 ) ? $plural_replacements[$single][0] : $plural_replacements[$single][1];
    }

    return $translated;
}

// 注册过滤器，优先级设为99确保最后执行
add_filter( 'gettext', 'global_text_replace', 99, 3 );
add_filter( 'gettext_with_context', 'global_text_replace', 99, 4 );
add_filter( 'ngettext', 'global_text_replace_plural', 99, 5 );

使用说明 #

1. 将上述代码保存为global-text-replace.php文件
2. 上传到wp-content/plugins/目录
3. 在WordPress后台启用该插件

替代方案：自定义语言包（无需代码） #

如果偏好使用语言文件实现，可按以下步骤操作，且不受主题/插件更新影响：

1. 获取原语言模板：从主题/插件目录找到.pot文件（比如your-theme.pot）
2. 用Poedit编辑：
   • 打开Poedit，选择「新建翻译」，导入.pot文件
   • 设置目标语言（如en_US）
   • 搜索需要替换的字符串，批量修改翻译内容
3. 保存并上传：生成.po和.mo文件，命名为your-theme-en_US.po/.mo，上传到wp-content/languages/themes/（主题）或wp-content/languages/plugins/（插件）目录

该目录下的语言文件不会被主题/插件更新覆盖，可长期生效。

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