WordPress Customizer API添加的面板/区块不显示问题求助

我是WordPress主题开发新手，正在学习Customizer API。尝试通过该API在WordPress自定义器中添加功能以修改导航菜单背景色，但编写代码后，自定义器中未显示新增的面板和区块。当前WordPress版本为6.1，以下是我在functions.php中编写的代码：

function textdomain_pro_theme($wp_customize) {
$wp_customize->add_panel( 'pro_features', array(
    'title' => 'Pro Features',
    'priority' => 10 
));
$wp_customize->add_section( 'color_picking' , array(
    'title' => 'Color Settings',
    'panel' => 'pro_features',
    'priority' => 30
      ));

$wp_customize->add_setting( 'nav_menu_bgcolor', array(
    'type' => 'theme_mod',
    'capability' => 'edit_theme_options',
    'default' => '#ff2525',
    'transport' => 'refresh',
    'sanitize_callback' => 'sanitize_hex_color',
    ));
$wp_customize->add_control( 'nav_menu_bgcolor', array(
    'label' => 'Navigation Bar Color',
    'type' => 'color',
    'section' => 'pro_features',
    ));
}
add_action( 'customize_register', 'textdomain_pro_theme' );

问题排查 #

代码的核心错误在于控件（Control）绑定的区块ID错误：

• 你已创建了color_picking区块，并将其归属到pro_features面板，但在添加颜色控件时，错误地将section属性设置为面板IDpro_features。
• WordPress自定义器要求控件必须挂载到具体的区块（Section）而非面板（Panel），这个错误会导致控件找不到正确的挂载位置，进而整个面板无法正常显示。

修正后的代码 #

function textdomain_pro_theme($wp_customize) {
    // 添加自定义面板
    $wp_customize->add_panel( 'pro_features', array(
        'title'    => 'Pro Features',
        'priority' => 10 
    ));
    // 添加面板下的颜色设置区块
    $wp_customize->add_section( 'color_picking' , array(
        'title'    => 'Color Settings',
        'panel'    => 'pro_features',
        'priority' => 30
    ));
    // 注册导航菜单背景色设置项
    $wp_customize->add_setting( 'nav_menu_bgcolor', array(
        'type'              => 'theme_mod',
        'capability'        => 'edit_theme_options',
        'default'           => '#ff2525',
        'transport'         => 'refresh',
        'sanitize_callback' => 'sanitize_hex_color',
    ));
    // 添加颜色选择控件（修正区块绑定）
    $wp_customize->add_control( 'nav_menu_bgcolor', array(
        'label'   => 'Navigation Bar Color',
        'type'    => 'color',
        'section' => 'color_picking', // 此处为核心修正点
    ));
}
add_action( 'customize_register', 'textdomain_pro_theme' );

关键修改说明 #

• 将add_control中的'section' => 'pro_features'替换为'section' => 'color_picking'，让控件正确挂载到对应的区块下
• 优化了代码缩进，提升可读性，便于后续维护

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