无法向WordPress定制器nav_menus面板添加复选框的问题咨询

这个问题我之前也踩过坑，核心原因在于「Menus」（对应nav_menus面板）和你测试的title_tagline、colors面板的加载逻辑完全不同——它是动态生成的容器型面板，不是常规的静态设置面板。

具体原因拆解 #

常规面板（比如title_tagline、colors）在定制器初始化时就已经注册好了完整的section和控件结构，你直接往它们下面添加控件，定制器的渲染逻辑能立刻识别并显示。但nav_menus本身只是个"空容器"：

• 它的实际内容（每个菜单的专属设置区、每个菜单项的编辑区）都是用户点击进入菜单界面后，才动态生成的；
• 你直接往nav_menus面板的根节点添加控件，定制器的渲染机制根本不会处理这些内容，自然就看不到。

解决方法：根据需求选择正确的注册位置 #

你需要把复选框注册到「Menus」面板下的动态子区域，而不是面板本身，分两种场景：

场景1：给整个菜单添加全局复选框

如果是想给某个菜单加全局开关，要把控件注册到单个菜单的专属section（nav_menu，注意不是nav_menus）里：

add_action( 'customize_register', 'add_menu_global_checkbox' );
function add_menu_global_checkbox( $wp_customize ) {
    // 注册设置，{{menu_id}}会自动替换为当前菜单的ID
    $wp_customize->add_setting( 'nav_menu_custom_checkbox[{{menu_id}}]', array(
        'type' => 'option',
        'sanitize_callback' => 'wp_validate_boolean',
        'default' => false,
    ) );

    // 添加控件到菜单专属设置区域
    $wp_customize->add_control( new WP_Customize_Control( $wp_customize, 'nav_menu_custom_checkbox', array(
        'label'       => __( '启用菜单自定义功能', 'your-text-domain' ),
        'section'     => 'nav_menu', // 单个菜单的设置section
        'settings'    => 'nav_menu_custom_checkbox[{{menu_id}}]',
        'type'        => 'checkbox',
        'priority'    => 10,
    ) ) );
}

场景2：给单个菜单项添加复选框

如果是想给每个菜单项加独立开关，就要注册到nav_menu_item这个section里：

add_action( 'customize_register', 'add_menu_item_checkbox' );
function add_menu_item_checkbox( $wp_customize ) {
    // 注册菜单项元数据设置，{{post_id}}会自动替换为当前菜单项的ID
    $wp_customize->add_setting( 'nav_menu_item_custom_checkbox[{{post_id}}]', array(
        'type' => 'post_meta',
        'sanitize_callback' => 'wp_validate_boolean',
        'capability' => 'edit_theme_options',
        'default' => false,
    ) );

    // 添加控件到菜单项设置区域
    $wp_customize->add_control( new WP_Customize_Control( $wp_customize, 'nav_menu_item_custom_checkbox', array(
        'label'       => __( '标记为特殊菜单项', 'your-text-domain' ),
        'section'     => 'nav_menu_item', // 单个菜单项的设置section
        'settings'    => 'nav_menu_item_custom_checkbox[{{post_id}}]',
        'type'        => 'checkbox',
        'priority'    => 20,
    ) ) );
}

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