概述

wp_admin_bar_customize_menu() 函数用于在 WordPress 工具栏中添加“自定义”链接，允许用户快速访问定制器。该函数包含条件检查，确保链接仅在适当情况下显示。

关键要点

• 函数接受一个 WP_Admin_Bar 实例参数，用于添加工具栏节点。
• 在块主题激活且无插件使用定制器时，链接不会显示。
• 仅当用户具有 'customize' 权限且不在管理界面时显示链接。
• 在定制器预览模式下，检查用户是否有编辑当前 customize_changeset 的权限。
• 生成定制器 URL，处理 SSL 和查询参数，如 changeset_uuid。
• 使用 WP_Admin_Bar::add_node() 添加节点，并关联 wp_customize_support_script 动作。

代码示例

function wp_admin_bar_customize_menu( $wp_admin_bar ) {
    global $wp_customize;

    // Don't show if a block theme is activated and no plugins use the customizer.
    if ( wp_is_block_theme() && ! has_action( 'customize_register' ) ) {
        return;
    }

    // Don't show for users who can't access the customizer or when in the admin.
    if ( ! current_user_can( 'customize' ) || is_admin() ) {
        return;
    }

    // Don't show if the user cannot edit a given customize_changeset post currently being previewed.
    if ( is_customize_preview() && $wp_customize->changeset_post_id()
        && ! current_user_can( get_post_type_object( 'customize_changeset' )->cap->edit_post, $wp_customize->changeset_post_id() )
    ) {
        return;
    }

    $current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    if ( is_customize_preview() && $wp_customize->changeset_uuid() ) {
        $current_url = remove_query_arg( 'customize_changeset_uuid', $current_url );
    }

    $customize_url = add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() );
    if ( is_customize_preview() ) {
        $customize_url = add_query_arg( array( 'changeset_uuid' => $wp_customize->changeset_uuid() ), $customize_url );
    }

    $wp_admin_bar->add_node(
        array(
            'id'    => 'customize',
            'title' => __( 'Customize' ),
            'href'  => $customize_url,
            'meta'  => array(
                'class' => 'hide-if-no-customize',
            ),
        )
    );
    add_action( 'wp_before_admin_bar_render', 'wp_customize_support_script' );
}