WordPress短代码内容仅文章页可见，首页/搜索页不显示求助

这个问题很常见，核心原因是首页、搜索结果页默认不会像文章详情页那样自动解析短代码——详情页用的the_content()函数会自动触发do_shortcode()来解析短代码，但首页/搜索页通常调用的是文章摘要（the_excerpt()）或者自定义截取的内容片段，这些默认不会处理短代码；如果你的短代码是放在标题里，the_title()函数也默认不解析短代码。

下面分两种常见场景给出解决方案：

场景1：短代码在文章内容中，首页/搜索页显示的是摘要 #

如果你的主题在列表页用的是the_excerpt()来展示内容，只需要添加一个过滤钩子，让摘要也解析短代码：

// 让文章摘要解析短代码
add_filter('the_excerpt', 'do_shortcode');

如果主题是用wp_trim_words()这类函数自定义截取内容（而不是用the_excerpt()），那需要先解析短代码再截取内容，比如把主题里类似这样的代码：

$trimmed_content = wp_trim_words(get_the_content(), 55);

修改为：

// 先解析短代码，再截取内容
$trimmed_content = wp_trim_words(do_shortcode(get_the_content()), 55);

场景2：短代码在文章标题中 #

如果你的短代码是写在文章标题里，需要给the_title()添加过滤来解析短代码。不过为了避免影响菜单、后台等其他地方的标题，建议限定仅在首页、搜索页、文章列表页生效：

add_filter('the_title', function($title) {
    // 仅在首页、搜索结果页、归档页解析标题中的短代码
    if (is_home() || is_search() || is_archive()) {
        return do_shortcode($title);
    }
    return $title;
});

额外排查点：短代码本身的页面限制 #

还要检查你的短代码函数里有没有写类似「仅在单页显示」的逻辑，比如：

function fx_shortcode($atts) {
    // 这种写法会导致非单页（首页/搜索页）不输出内容
    if (!is_single()) return '';
    
    // 你的短代码逻辑...
}

如果有，把这个限制去掉，或者调整为允许在需要的页面显示，比如：

function fx_shortcode($atts) {
    // 允许在单页、首页、搜索页显示
    if (!is_single() && !is_home() && !is_search()) return '';
    
    ob_start();
    // 你的短代码逻辑
    return ob_get_clean();
}
add_shortcode('fx', 'fx_shortcode');

把上述代码添加到你的主题functions.php文件里，或者自定义插件中，就能解决短代码在首页/搜索页不显示的问题了。

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