如何让自定义WordPress主题支持通过仪表盘从仓库更新父主题？

1. 配置父主题的更新检测逻辑 #

要让WordPress仪表盘能从代码仓库获取父主题更新，需在父主题中添加版本检测代码，让系统识别仓库的最新版本信息：

add_filter('pre_set_site_transient_update_themes', 'custom_theme_update_check');
function custom_theme_update_check($transient) {
    if (empty($transient->checked)) return $transient;
    
    // 替换为你的代码仓库信息
    $theme_slug = get_template();
    $repo_api_url = 'https://api.github.com/repos/你的用户名/你的主题仓库/releases/latest'; // 以GitHub为例
    $response = wp_remote_get($repo_api_url);
    
    if (is_wp_error($response)) return $transient;
    
    $repo_data = json_decode(wp_remote_retrieve_body($response), true);
    $latest_version = str_replace('v', '', $repo_data['tag_name']); // 去除版本号前的v前缀
    $current_version = wp_get_theme($theme_slug)->get('Version');
    
    if (version_compare($latest_version, $current_version, '>')) {
        $transient->response[$theme_slug] = array(
            'theme'       => $theme_slug,
            'new_version' => $latest_version,
            'package'     => $repo_data['zipball_url'],
            'url'         => $repo_data['html_url']
        );
    }
    
    return $transient;
}

• 将上述代码添加到父主题的functions.php文件中，替换$repo_api_url为你的代码仓库API地址（不同仓库平台API格式不同，需对应调整）。
• 这段代码会定期对比仓库最新版本与当前主题版本，若有更新则推送到仪表盘。

2. 验证更新提示是否出现 #

• 登录WordPress仪表盘，进入「外观」→「主题」页面，查看父主题卡片是否显示「更新可用」标识。
• 若未自动显示，可手动触发检查：在仪表盘主题页面的URL后追加?force-check=1（如wp-admin/themes.php?force-check=1），刷新页面即可。

3. 执行父主题更新 #

• 点击父主题卡片上的「更新现在」按钮，系统会自动从代码仓库下载最新版本压缩包，替换当前父主题文件。
• 更新完成后，仪表盘会提示更新成功，所有登录用户即可看到更新后的主题效果。

4. 日常维护注意事项 #

• 代码仓库发布新版本时，需使用语义化版本号（如1.2.3或v1.2.3），确保版本对比逻辑正常工作。
• 若更换代码仓库平台，需同步更新检测代码中的API地址和数据解析逻辑。

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