WordPress切换主题后插件集成的customizer内容不显示该如何解决？

你遇到的核心问题是Customizer设置的存储类型默认绑定主题，以及钩子挂载逻辑可能存在问题，按以下步骤修改即可：

1. 修正设置的存储类型 #

默认add_setting方法的type参数值为theme_mod，这类配置是和当前激活主题绑定的，切换主题后自然不会读取到之前的配置。你需要显式将type设置为全局存储的option类型：

$wp_customize->add_setting( 'site_logo', array(
    'sanitize_callback' => 'esc_url_raw',
    'transport' => 'postMessage',
    'type' => 'option' // 新增这一行，改为全局选项存储
));

对应的前端调用代码也要同步修改，原来如果是get_theme_mod('site_logo')的要改成get_option('site_logo')。

2. 确保Customizer注册逻辑挂载到正确的全局钩子 #

你需要确保整个customizer.php里的注册逻辑是挂载在customize_register钩子上的，且钩子是在插件主文件中全局注册，不依赖任何主题的加载逻辑：
首先修改customizer.php的结构，将所有注册逻辑包裹在回调函数中：

function gswmi_customize_register( $wp_customize ) {
    if ( class_exists( 'WP_Customize_Panel' ) ):

        $wp_customize->add_panel( 'panel_general', array(
            'priority' => 29,
            'capability' => 'edit_theme_options',
            'title' => __( 'General options', 'gswmi' )
        ));

        /* LOGO */
        $wp_customize->add_setting( 'site_logo', array(
            'sanitize_callback' => 'esc_url_raw',
            'transport' => 'postMessage',
            'type' => 'option'
        ));

        $wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'themeslug_logo',
            array(
            'label' => __( 'Logo' ),
            'section' => 'title_tagline',
            'settings' => 'site_logo',
            'priority' => 1,
            )
        )); 
    endif;
}

然后在插件主文件引入customizer.php之后，挂载钩子：

require( plugin_dir_path( __FILE__ ) . 'inc/customizer.php' );
add_action( 'customize_register', 'gswmi_customize_register' );

3. 避免和主题的Customizer配置冲突 #

如果第二套主题本身有移除title_tagline section或者覆盖Customizer优先级的逻辑，你可以调整你注册的优先级，确保晚于主题的Customizer逻辑执行：

// 第三个参数设置为999，优先级低于主题默认的10，确保后执行
add_action( 'customize_register', 'gswmi_customize_register', 999 );

修改完成后清理缓存重新测试，即可实现切换主题后Customizer配置和前端展示保持一致。

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