求助：WordPress的[display_posts_thumbnail]等短码在新站点无法生效

之前在旧站点通过functions.php注册的[display_page_thumbnail]和[display_posts_thumbnail]短码能正常追踪无特色图片的页面/文章，但复制代码到新站点后完全失效，大概率是新站点functions.php的代码或执行环境有问题，按以下步骤排查：

1. 确认短码代码是否完整复制 #

新站点的functions.php里必须包含完整的短码定义和注册代码，从旧站提取的核心代码如下，对照检查：

// 显示无特色图片的页面
function display_page_thumbnail() {
    ob_start();
    $pages = get_pages();
    foreach ($pages as $page) {
        if (!has_post_thumbnail($page->ID)) {
            echo '<p>' . get_the_title($page->ID) . ' (ID: ' . $page->ID . ')</p>';
        }
    }
    return ob_get_clean();
}
add_shortcode('display_page_thumbnail', 'display_page_thumbnail');

// 显示无特色图片的文章
function display_posts_thumbnail() {
    ob_start();
    $args = array('post_type' => 'post', 'posts_per_page' => -1);
    $posts = get_posts($args);
    foreach ($posts as $post) {
        if (!has_post_thumbnail($post->ID)) {
            echo '<p>' . get_the_title($post->ID) . ' (ID: ' . $post->ID . ')</p>';
        }
    }
    return ob_get_clean();
}
add_shortcode('display_posts_thumbnail', 'display_posts_thumbnail');

如果新站里缺了其中某部分，直接补全即可。

2. 检查functions.php的语法错误 #

• 确保短码函数定义在add_shortcode调用之前，顺序反了会导致注册失败
• 检查文件末尾是否有多余空白字符或未闭合的PHP标签（?>），部分服务器环境下会因此中断代码执行
• 开启WP调试模式：在wp-config.php中添加define('WP_DEBUG', true);，刷新页面查看报错信息，根据提示修复问题

3. 排查主题与插件冲突 #

• 切换到WordPress默认主题（如Twenty Twenty-Four）测试短码，若生效则说明当前主题的代码干扰了短码解析
• 暂时禁用所有插件，再逐一启用排查，定位是否有插件拦截短码解析逻辑

4. 验证短码调用方式 #

在编辑器的「文本」模式下直接输入短码，避免在可视化模式下粘贴导致编辑器将短码转义为HTML实体，无法被系统识别。

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