WordPress 4.4
[autoinstalls/wordpress.git] / wp-includes / admin-bar.php
index 67e6a1a5a749b0e0501e85e9fcaa5b5762cfb3ab..2bf56a8630a9479c79af736d6884135f41b82e2e 100644 (file)
@@ -1,8 +1,10 @@
 <?php
 /**
- * Admin Bar
+ * Toolbar API: Top-level Toolbar functionality
  *
- * This code handles the building and rendering of the press bar.
+ * @package WordPress
+ * @subpackage Toolbar
+ * @since 3.1.0
  */
 
 /**
@@ -13,6 +15,9 @@
  *
  * @since 3.1.0
  * @access private
+ *
+ * @global WP_Admin_Bar $wp_admin_bar
+ *
  * @return bool Whether the admin bar was successfully initialized.
  */
 function _wp_admin_bar_init() {
@@ -22,7 +27,7 @@ function _wp_admin_bar_init() {
                return false;
 
        /* Load the admin bar class code ready for instantiation */
-       require( ABSPATH . WPINC . '/class-wp-admin-bar.php' );
+       require_once( ABSPATH . WPINC . '/class-wp-admin-bar.php' );
 
        /* Instantiate the admin bar */
 
@@ -44,9 +49,6 @@ function _wp_admin_bar_init() {
 
        return true;
 }
-// Don't remove. Wrong way to disable.
-add_action( 'template_redirect', '_wp_admin_bar_init', 0 );
-add_action( 'admin_init', '_wp_admin_bar_init' );
 
 /**
  * Render the admin bar to the page based on the $wp_admin_bar->menu member var.
@@ -58,12 +60,14 @@ add_action( 'admin_init', '_wp_admin_bar_init' );
  * right before the admin bar is rendered. This also gives you access to the $post global, among others.
  *
  * @since 3.1.0
+ *
+ * @global WP_Admin_Bar $wp_admin_bar
  */
 function wp_admin_bar_render() {
        global $wp_admin_bar;
 
        if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) )
-               return false;
+               return;
 
        /**
         * Load all necessary admin bar items.
@@ -92,8 +96,6 @@ function wp_admin_bar_render() {
         */
        do_action( 'wp_after_admin_bar_render' );
 }
-add_action( 'wp_footer', 'wp_admin_bar_render', 1000 );
-add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );
 
 /**
  * Add the WordPress logo menu.
@@ -105,11 +107,8 @@ add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );
 function wp_admin_bar_wp_menu( $wp_admin_bar ) {
        $wp_admin_bar->add_menu( array(
                'id'    => 'wp-logo',
-               'title' => '<span class="ab-icon"></span>',
+               'title' => '<span class="ab-icon"></span><span class="screen-reader-text">' . __( 'About WordPress' ) . '</span>',
                'href'  => self_admin_url( 'about.php' ),
-               'meta'  => array(
-                       'title' => __('About WordPress'),
-               ),
        ) );
 
        if ( is_user_logged_in() ) {
@@ -118,7 +117,7 @@ function wp_admin_bar_wp_menu( $wp_admin_bar ) {
                        'parent' => 'wp-logo',
                        'id'     => 'about',
                        'title'  => __('About WordPress'),
-                       'href'  => self_admin_url( 'about.php' ),
+                       'href'   => self_admin_url( 'about.php' ),
                ) );
        }
 
@@ -127,7 +126,7 @@ function wp_admin_bar_wp_menu( $wp_admin_bar ) {
                'parent'    => 'wp-logo-external',
                'id'        => 'wporg',
                'title'     => __('WordPress.org'),
-               'href'      => __('http://wordpress.org/'),
+               'href'      => __('https://wordpress.org/'),
        ) );
 
        // Add codex link
@@ -135,7 +134,7 @@ function wp_admin_bar_wp_menu( $wp_admin_bar ) {
                'parent'    => 'wp-logo-external',
                'id'        => 'documentation',
                'title'     => __('Documentation'),
-               'href'      => __('http://codex.wordpress.org/'),
+               'href'      => __('https://codex.wordpress.org/'),
        ) );
 
        // Add forums link
@@ -143,7 +142,7 @@ function wp_admin_bar_wp_menu( $wp_admin_bar ) {
                'parent'    => 'wp-logo-external',
                'id'        => 'support-forums',
                'title'     => __('Support Forums'),
-               'href'      => __('http://wordpress.org/support/'),
+               'href'      => __('https://wordpress.org/support/'),
        ) );
 
        // Add feedback link
@@ -151,7 +150,7 @@ function wp_admin_bar_wp_menu( $wp_admin_bar ) {
                'parent'    => 'wp-logo-external',
                'id'        => 'feedback',
                'title'     => __('Feedback'),
-               'href'      => __('http://wordpress.org/support/forum/requests-and-feedback'),
+               'href'      => __('https://wordpress.org/support/forum/requests-and-feedback'),
        ) );
 }
 
@@ -182,11 +181,18 @@ function wp_admin_bar_sidebar_toggle( $wp_admin_bar ) {
 function wp_admin_bar_my_account_item( $wp_admin_bar ) {
        $user_id      = get_current_user_id();
        $current_user = wp_get_current_user();
-       $profile_url  = get_edit_profile_url( $user_id );
 
        if ( ! $user_id )
                return;
 
+       if ( current_user_can( 'read' ) ) {
+               $profile_url = get_edit_profile_url( $user_id );
+       } elseif ( is_multisite() ) {
+               $profile_url = get_dashboard_url( $user_id, 'profile.php' );
+       } else {
+               $profile_url = false;
+       }
+
        $avatar = get_avatar( $user_id, 26 );
        $howdy  = sprintf( __('Howdy, %1$s'), $current_user->display_name );
        $class  = empty( $avatar ) ? '' : 'with-avatar';
@@ -198,7 +204,6 @@ function wp_admin_bar_my_account_item( $wp_admin_bar ) {
                'href'      => $profile_url,
                'meta'      => array(
                        'class'     => $class,
-                       'title'     => __('My Account'),
                ),
        ) );
 }
@@ -213,11 +218,18 @@ function wp_admin_bar_my_account_item( $wp_admin_bar ) {
 function wp_admin_bar_my_account_menu( $wp_admin_bar ) {
        $user_id      = get_current_user_id();
        $current_user = wp_get_current_user();
-       $profile_url  = get_edit_profile_url( $user_id );
 
        if ( ! $user_id )
                return;
 
+       if ( current_user_can( 'read' ) ) {
+               $profile_url = get_edit_profile_url( $user_id );
+       } elseif ( is_multisite() ) {
+               $profile_url = get_dashboard_url( $user_id, 'profile.php' );
+       } else {
+               $profile_url = false;
+       }
+
        $wp_admin_bar->add_group( array(
                'parent' => 'my-account',
                'id'     => 'user-actions',
@@ -238,12 +250,16 @@ function wp_admin_bar_my_account_menu( $wp_admin_bar ) {
                        'tabindex' => -1,
                ),
        ) );
-       $wp_admin_bar->add_menu( array(
-               'parent' => 'user-actions',
-               'id'     => 'edit-profile',
-               'title'  => __( 'Edit My Profile' ),
-               'href' => $profile_url,
-       ) );
+
+       if ( false !== $profile_url ) {
+               $wp_admin_bar->add_menu( array(
+                       'parent' => 'user-actions',
+                       'id'     => 'edit-profile',
+                       'title'  => __( 'Edit My Profile' ),
+                       'href'   => $profile_url,
+               ) );
+       }
+
        $wp_admin_bar->add_menu( array(
                'parent' => 'user-actions',
                'id'     => 'logout',
@@ -270,13 +286,14 @@ function wp_admin_bar_site_menu( $wp_admin_bar ) {
 
        $blogname = get_bloginfo('name');
 
-       if ( empty( $blogname ) )
+       if ( ! $blogname ) {
                $blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );
+       }
 
        if ( is_network_admin() ) {
                $blogname = sprintf( __('Network Admin: %s'), esc_html( get_current_site()->site_name ) );
        } elseif ( is_user_admin() ) {
-               $blogname = sprintf( __('Global Dashboard: %s'), esc_html( get_current_site()->site_name ) );
+               $blogname = sprintf( __('User Dashboard: %s'), esc_html( get_current_site()->site_name ) );
        }
 
        $title = wp_html_excerpt( $blogname, 40, '&hellip;' );
@@ -284,7 +301,7 @@ function wp_admin_bar_site_menu( $wp_admin_bar ) {
        $wp_admin_bar->add_menu( array(
                'id'    => 'site-name',
                'title' => $title,
-               'href'  => is_admin() ? home_url( '/' ) : admin_url(),
+               'href'  => ( is_admin() || ! current_user_can( 'read' ) ) ? home_url( '/' ) : admin_url(),
        ) );
 
        // Create submenu items.
@@ -307,7 +324,7 @@ function wp_admin_bar_site_menu( $wp_admin_bar ) {
                        ) );
                }
 
-       } else {
+       } else if ( current_user_can( 'read' ) ) {
                // We're on the front end, link to the Dashboard.
                $wp_admin_bar->add_menu( array(
                        'parent' => 'site-name',
@@ -321,6 +338,33 @@ function wp_admin_bar_site_menu( $wp_admin_bar ) {
        }
 }
 
+/**
+ * Adds the "Customize" link to the Toolbar.
+ *
+ * @since 4.3.0
+ *
+ * @param WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance.
+ */
+function wp_admin_bar_customize_menu( $wp_admin_bar ) {
+       // Don't show for users who can't access the customizer or when in the admin.
+       if ( ! current_user_can( 'customize' ) || is_admin() ) {
+               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() );
+
+       $wp_admin_bar->add_menu( 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' );
+}
+
 /**
  * Add the "My Sites/[Site Name]" menu and all submenus.
  *
@@ -337,10 +381,16 @@ function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
        if ( count( $wp_admin_bar->user->blogs ) < 1 && ! is_super_admin() )
                return;
 
+       if ( $wp_admin_bar->user->active_blog ) {
+               $my_sites_url = get_admin_url( $wp_admin_bar->user->active_blog->blog_id, 'my-sites.php' );
+       } else {
+               $my_sites_url = admin_url( 'my-sites.php' );
+       }
+
        $wp_admin_bar->add_menu( array(
                'id'    => 'my-sites',
                'title' => __( 'My Sites' ),
-               'href'  => admin_url( 'my-sites.php' ),
+               'href'  => $my_sites_url,
        ) );
 
        if ( is_super_admin() ) {
@@ -386,6 +436,12 @@ function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
                        'title'  => __( 'Plugins' ),
                        'href'   => network_admin_url( 'plugins.php' ),
                ) );
+               $wp_admin_bar->add_menu( array(
+                       'parent' => 'network-admin',
+                       'id'     => 'network-admin-o',
+                       'title'  => __( 'Settings' ),
+                       'href'   => network_admin_url( 'settings.php' ),
+               ) );
        }
 
        // Add site links
@@ -402,7 +458,12 @@ function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
 
                $blavatar = '<div class="blavatar"></div>';
 
-               $blogname = empty( $blog->blogname ) ? $blog->domain : $blog->blogname;
+               $blogname = $blog->blogname;
+
+               if ( ! $blogname ) {
+                       $blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );
+               }
+
                $menu_id  = 'blog-' . $blog->userblog_id;
 
                $wp_admin_bar->add_menu( array(
@@ -477,6 +538,9 @@ function wp_admin_bar_shortlink_menu( $wp_admin_bar ) {
  *
  * @since 3.1.0
  *
+ * @global WP_Term  $tag
+ * @global WP_Query $wp_the_query
+ *
  * @param WP_Admin_Bar $wp_admin_bar
  */
 function wp_admin_bar_edit_menu( $wp_admin_bar ) {
@@ -493,11 +557,22 @@ function wp_admin_bar_edit_menu( $wp_admin_bar ) {
                        && ( $post_type_object->public )
                        && ( $post_type_object->show_in_admin_bar ) )
                {
-                       $wp_admin_bar->add_menu( array(
-                               'id' => 'view',
-                               'title' => $post_type_object->labels->view_item,
-                               'href' => get_permalink( $post->ID )
-                       ) );
+                       if ( 'draft' == $post->post_status ) {
+                               $draft_link = set_url_scheme( get_permalink( $post->ID ) );
+                               $preview_link = get_preview_post_link( $post, array(), $draft_link );
+                               $wp_admin_bar->add_menu( array(
+                                       'id' => 'preview',
+                                       'title' => $post_type_object->labels->view_item,
+                                       'href' => esc_url( $preview_link ),
+                                       'meta' => array( 'target' => 'wp-preview-' . $post->ID ),
+                               ) );
+                       } else {
+                               $wp_admin_bar->add_menu( array(
+                                       'id' => 'view',
+                                       'title' => $post_type_object->labels->view_item,
+                                       'href' => get_permalink( $post->ID )
+                               ) );
+                       }
                } elseif ( 'edit-tags' == $current_screen->base
                        && isset( $tag ) && is_object( $tag )
                        && ( $tax = get_taxonomy( $tag->taxonomy ) )
@@ -518,22 +593,23 @@ function wp_admin_bar_edit_menu( $wp_admin_bar ) {
                if ( ! empty( $current_object->post_type )
                        && ( $post_type_object = get_post_type_object( $current_object->post_type ) )
                        && current_user_can( 'edit_post', $current_object->ID )
-                       && $post_type_object->show_ui && $post_type_object->show_in_admin_bar )
+                       && $post_type_object->show_in_admin_bar
+                       && $edit_post_link = get_edit_post_link( $current_object->ID ) )
                {
                        $wp_admin_bar->add_menu( array(
                                'id' => 'edit',
                                'title' => $post_type_object->labels->edit_item,
-                               'href' => get_edit_post_link( $current_object->ID )
+                               'href' => $edit_post_link
                        ) );
                } elseif ( ! empty( $current_object->taxonomy )
                        && ( $tax = get_taxonomy( $current_object->taxonomy ) )
                        && current_user_can( $tax->cap->edit_terms )
-                       && $tax->show_ui )
+                       && $edit_term_link = get_edit_term_link( $current_object->term_id, $current_object->taxonomy ) )
                {
                        $wp_admin_bar->add_menu( array(
                                'id' => 'edit',
                                'title' => $tax->labels->edit_item,
-                               'href' => get_edit_term_link( $current_object->term_id, $current_object->taxonomy )
+                               'href' => $edit_term_link
                        ) );
                }
        }
@@ -589,9 +665,6 @@ function wp_admin_bar_new_content_menu( $wp_admin_bar ) {
                'id'    => 'new-content',
                'title' => $title,
                'href'  => admin_url( current( array_keys( $actions ) ) ),
-               'meta'  => array(
-                       'title' => _x( 'Add New', 'admin bar menu group label' ),
-               ),
        ) );
 
        foreach ( $actions as $link => $action ) {
@@ -642,35 +715,55 @@ function wp_admin_bar_comments_menu( $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( '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' ) )
+       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( '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-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',
+                       ),
+               ) );
+       }
 
-       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') ) );
 }
 
 /**
@@ -713,6 +806,7 @@ function wp_admin_bar_search_menu( $wp_admin_bar ) {
 
        $form  = '<form action="' . esc_url( home_url( '/' ) ) . '" method="get" id="adminbarsearch">';
        $form .= '<input class="adminbar-input" name="s" id="adminbar-search" type="text" value="" maxlength="150" />';
+       $form .= '<label for="adminbar-search" class="screen-reader-text">' . __( 'Search' ) . '</label>';
        $form .= '<input type="submit" class="adminbar-button" value="' . __('Search') . '"/>';
        $form .= '</form>';
 
@@ -785,8 +879,9 @@ function _admin_bar_bump_cb() { ?>
  *
  * @since 3.1.0
  *
+ * @global WP_Admin_Bar $wp_admin_bar
+ *
  * @param bool $show Whether to allow the admin bar to show.
- * @return void
  */
 function show_admin_bar( $show ) {
        global $show_admin_bar;
@@ -798,6 +893,9 @@ function show_admin_bar( $show ) {
  *
  * @since 3.1.0
  *
+ * @global WP_Admin_Bar $wp_admin_bar
+ * @global string       $pagenow
+ *
  * @return bool Whether the admin bar should be showing.
  */
 function is_admin_bar_showing() {
@@ -807,6 +905,10 @@ function is_admin_bar_showing() {
        if ( defined('XMLRPC_REQUEST') || defined('DOING_AJAX') || defined('IFRAME_REQUEST') )
                return false;
 
+       if ( is_embed() ) {
+               return false;
+       }
+
        // Integrated into the admin.
        if ( is_admin() )
                return true;