如何在WordPress更新页面替换父主题缩略图？

要替换Astra（或其他主题）在更新页面中的默认缩略图，可使用WordPress原生钩子update_themes_thumbnail_html实现，以下是具体方案：

核心实现思路 #

WordPress的update_themes_thumbnail_html钩子允许过滤主题更新页面中输出的缩略图HTML代码，通过判断目标主题的目录ID（不受白标名称修改影响），替换为自定义缩略图即可。

代码示例（针对Astra主题） #

将以下代码添加到子主题的functions.php文件或自定义功能插件中：

add_filter( 'update_themes_thumbnail_html', 'custom_replace_astra_update_thumbnail', 10, 3 );
function custom_replace_astra_update_thumbnail( $html, $theme, $theme_name ) {
    // 通过主题目录ID精准定位Astra主题
    if ( 'astra' === $theme['id'] ) {
        // 自定义缩略图的URL，示例为子主题images目录下的图片
        $custom_thumb_url = get_stylesheet_directory_uri() . '/assets/images/custom-theme-thumb.png';
        
        // 重新构建缩略图HTML，确保输出安全
        $html = sprintf(
            '<div class="theme-screenshot"><img src="%s" alt="%s" /></div>',
            esc_url( $custom_thumb_url ),
            esc_attr( $theme_name )
        );
    }
    return $html;
}

代码说明 #

• $theme['id']：对应主题的目录名称（Astra的目录名是astra），用这个判断比主题名称更可靠，避免白标修改名称后失效。
• get_stylesheet_directory_uri()：获取当前子主题的根URL，确保自定义缩略图路径不受父主题更新影响。
• esc_url()和esc_attr()：遵循WordPress安全规范，对URL和属性进行转义处理。

适配其他主题的修改方式 #

如果需要替换其他主题的更新缩略图，只需将代码中的'astra' === $theme['id']改为目标主题的目录名称即可（比如twentytwentyfour）。

注意事项 #

• 自定义缩略图建议使用80×80像素左右的尺寸，适配WordPress后台更新页面的样式。
• 不要直接修改父主题的代码，避免主题更新后代码丢失。

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