WordPress短代码在home.html中失效问题求助

问题概述 #

• 站点使用Email Address Encoder插件，[encode link="..."]...[/encode]短代码在页脚、Impressum页面正常解析，但首页直接显示短代码文本
• 未修改首页对应区块，WordPress版本6.2.1；测试WordPress默认短代码，同样仅在首页失效
• 已尝试将短代码从<p>标签切换到shortcode块，问题依旧

排查与解决步骤 #

1. 检查首页模板的短代码过滤 #

首页模板（如front-page.php、home.php或自定义模板文件）可能缺失短代码解析逻辑：

• 打开主题的首页模板，找到内容输出代码（比如the_content()），确认是否应用了do_shortcode过滤器
• 如果是自定义字段或自定义内容输出，需手动添加短代码解析：

  echo do_shortcode( get_post_meta( get_the_ID(), '自定义字段键名', true ) );
  

• 检查主题是否在首页移除了短代码过滤（比如存在remove_filter('the_content', 'do_shortcode');），若有则删除该代码

2. 清空首页缓存 #

首页大概率被静态缓存（插件缓存、CDN缓存或WordPress自带缓存），导致短代码未实时解析：

• 清空站点缓存插件（如WP Rocket、LiteSpeed Cache）的首页缓存
• 强制刷新CDN缓存（若使用CDN服务）
• 手动刷新浏览器缓存（Ctrl+F5）后测试

3. 验证首页编辑器的短代码状态 #

• 切换到首页的代码编辑器模式，检查短代码是否被转义（例如变成\[encode link="..."]...\[\/encode]），若存在转义字符，手动修正为正常短代码格式
• 检查首页使用的区块是否有“禁用短代码”的隐藏设置（部分第三方区块插件会提供此选项），若有则取消勾选

4. 排查主题/插件冲突 #

• 临时切换到WordPress默认主题（如Twenty Twenty-Three），测试首页短代码是否正常，排除主题兼容性问题
• 逐个禁用站点内的其他插件，每禁用一个就测试首页短代码，找到冲突插件后，优先更新插件版本，若仍无效则替换功能类似的插件

5. 强制为首页添加短代码支持 #

若以上方法均无效，可在主题的functions.php文件中添加以下代码，强制首页解析短代码：

add_action('template_redirect', function() {
    if (is_front_page()) {
        add_filter('the_content', 'do_shortcode', 11);
    }
});

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