wp_admin_bar_appearance_menu

The timeline below displays how wordpress function wp_admin_bar_appearance_menu has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.3

/**
 * Adds appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar The WP_Admin_Bar instance.
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'background', 'title' => _x('Background', 'custom background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'header', 'title' => _x('Header', 'custom image header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
    }
}

WordPress Version: 5.9

/**
 * Adds appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar The WP_Admin_Bar instance.
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
    }
}

WordPress Version: 5.4

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_node(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
    }
}

WordPress Version: 4.3

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
    }
}

WordPress Version: 4.2

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    $current_url = (is_ssl() ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    $customize_url = add_query_arg('url', urlencode($current_url), wp_customize_url());
    if (current_user_can('switch_themes')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-themes',
                'title' => __('Themes'),
                'href' => add_query_arg(urlencode('autofocus[section]'), 'themes', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
    if (current_user_can('customize')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', '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');
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-widgets',
                'title' => __('Widgets'),
                'href' => add_query_arg(urlencode('autofocus[panel]'), 'widgets', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-background',
                'title' => __('Background'),
                'href' => add_query_arg(urlencode('autofocus[control]'), 'background_image', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-header',
                'title' => __('Header'),
                'href' => add_query_arg(urlencode('autofocus[control]'), 'header_image', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
}

WordPress Version: 4.1

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes') || current_user_can('edit_theme_options')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    $current_url = (is_ssl() ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    $customize_url = add_query_arg('url', urlencode($current_url), wp_customize_url());
    if (current_user_can('customize')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', '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');
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-background',
                'title' => __('Background'),
                'href' => add_query_arg(urlencode('autofocus[control]'), 'background_image', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header'), 'meta' => array('class' => 'hide-if-customize')));
        if (current_user_can('customize')) {
            $wp_admin_bar->add_menu(array(
                'parent' => 'appearance',
                'id' => 'customize-header',
                'title' => __('Header'),
                'href' => add_query_arg(urlencode('autofocus[control]'), 'header_image', $customize_url),
                // urlencode() needed due to #16859
                'meta' => array('class' => 'hide-if-no-customize'),
            ));
        }
    }
}

WordPress Version: 4.0

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes') || current_user_can('edit_theme_options')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    if (current_user_can('customize')) {
        $current_url = (is_ssl() ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'customize', 'title' => __('Customize'), 'href' => add_query_arg('url', urlencode($current_url), wp_customize_url()), 'meta' => array('class' => 'hide-if-no-customize')));
        add_action('wp_before_admin_bar_render', 'wp_customize_support_script');
    }
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header')));
    }
}

WordPress Version: 3.7

/**
 * Add appearance submenu items to the "Site Name" menu.
 *
 * @since 3.1.0
 *
 * @param WP_Admin_Bar $wp_admin_bar
 */
function wp_admin_bar_appearance_menu($wp_admin_bar)
{
    $wp_admin_bar->add_group(array('parent' => 'site-name', 'id' => 'appearance'));
    if (current_user_can('switch_themes') || current_user_can('edit_theme_options')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php')));
    }
    if (!current_user_can('edit_theme_options')) {
        return;
    }
    $current_url = (is_ssl() ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'customize', 'title' => __('Customize'), 'href' => add_query_arg('url', urlencode($current_url), wp_customize_url()), 'meta' => array('class' => 'hide-if-no-customize')));
    add_action('wp_before_admin_bar_render', 'wp_customize_support_script');
    if (current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php')));
    }
    if (current_theme_supports('menus') || current_theme_supports('widgets')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php')));
    }
    if (current_theme_supports('custom-background')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background')));
    }
    if (current_theme_supports('custom-header')) {
        $wp_admin_bar->add_menu(array('parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header')));
    }
}