content for an admin page. + * Filters the title tag content for an admin page. * * @since 3.1.0 * @@ -84,7 +101,7 @@ do_action( 'admin_enqueue_scripts', $hook_suffix ); * * @since 2.6.0 */ -do_action( "admin_print_styles-$hook_suffix" ); +do_action( "admin_print_styles-{$hook_suffix}" ); /** * Fires when styles are printed for all admin pages. @@ -98,7 +115,7 @@ do_action( 'admin_print_styles' ); * * @since 2.1.0 */ -do_action( "admin_print_scripts-$hook_suffix" ); +do_action( "admin_print_scripts-{$hook_suffix}" ); /** * Fires when scripts are printed for all admin pages. @@ -108,14 +125,17 @@ do_action( "admin_print_scripts-$hook_suffix" ); do_action( 'admin_print_scripts' ); /** - * Fires in <head> for a specific admin page based on $hook_suffix. + * Fires in head section for a specific admin page. + * + * The dynamic portion of the hook, `$hook_suffix`, refers to the hook suffix + * for the admin page. * * @since 2.1.0 */ -do_action( "admin_head-$hook_suffix" ); +do_action( "admin_head-{$hook_suffix}" ); /** - * Fires in <head> for all admin pages. + * Fires in head section for all admin pages. * * @since 2.1.0 */ @@ -139,10 +159,10 @@ if ( $current_screen->post_type ) if ( $current_screen->taxonomy ) $admin_body_class .= ' taxonomy-' . $current_screen->taxonomy; -$admin_body_class .= ' branch-' . str_replace( array( '.', ',' ), '-', floatval( $wp_version ) ); -$admin_body_class .= ' version-' . str_replace( '.', '-', preg_replace( '/^([.0-9]+).*/', '$1', $wp_version ) ); +$admin_body_class .= ' branch-' . str_replace( array( '.', ',' ), '-', floatval( get_bloginfo( 'version' ) ) ); +$admin_body_class .= ' version-' . str_replace( '.', '-', preg_replace( '/^([.0-9]+).*/', '$1', get_bloginfo( 'version' ) ) ); $admin_body_class .= ' admin-color-' . sanitize_html_class( get_user_option( 'admin_color' ), 'fresh' ); -$admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_locale() ) ) ); +$admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) ); if ( wp_is_mobile() ) $admin_body_class .= ' mobile'; @@ -159,18 +179,22 @@ $admin_body_class .= ' no-customize-support no-svg'; </head> <?php /** - * Filter the admin <body> CSS classes. + * Filters the CSS classes for the body tag in the admin. + * + * This filter differs from the {@see 'post_class'} and {@see 'body_class'} filters + * in two important ways: * - * This filter differs from the post_class or body_class filters in two important ways: - * 1. $classes is a space-separated string of class names instead of an array. - * 2. Not all core admin classes are filterable, notably: wp-admin, wp-core-ui, and no-js cannot be removed. + * 1. `$classes` is a space-separated string of class names instead of an array. + * 2. Not all core admin classes are filterable, notably: wp-admin, wp-core-ui, + * and no-js cannot be removed. * * @since 2.3.0 * - * @param string $classes Space-separated string of CSS classes. + * @param string $classes Space-separated list of CSS classes. */ +$admin_body_classes = apply_filters( 'admin_body_class', '' ); ?> -<body class="wp-admin wp-core-ui no-js <?php echo apply_filters( 'admin_body_class', '' ) . " $admin_body_class"; ?>"> +<body class="wp-admin wp-core-ui no-js <?php echo $admin_body_classes . ' ' . $admin_body_class; ?>"> <script type="text/javascript"> document.body.className = document.body.className.replace('no-js','js'); </script> @@ -183,7 +207,6 @@ if ( current_user_can( 'customize' ) ) { ?> <div id="wpwrap"> -<a tabindex="1" href="#wpbody-content" class="screen-reader-shortcut"><?php _e('Skip to main content'); ?></a> <?php require(ABSPATH . 'wp-admin/menu-header.php'); ?> <div id="wpcontent"> @@ -196,7 +219,7 @@ if ( current_user_can( 'customize' ) ) { do_action( 'in_admin_header' ); ?> -<div id="wpbody"> +<div id="wpbody" role="main"> <?php unset($title_class, $blog_name, $total_update_count, $update_title); @@ -211,21 +234,21 @@ $current_screen->render_screen_meta(); if ( is_network_admin() ) { /** - * Print network admin screen notices. + * Prints network admin screen notices. * * @since 3.1.0 */ do_action( 'network_admin_notices' ); } elseif ( is_user_admin() ) { /** - * Print user admin screen notices. + * Prints user admin screen notices. * * @since 3.1.0 */ do_action( 'user_admin_notices' ); } else { /** - * Print admin screen notices. + * Prints admin screen notices. * * @since 3.1.0 */ @@ -233,7 +256,7 @@ if ( is_network_admin() ) { } /** - * Print generic admin screen notices. + * Prints generic admin screen notices. * * @since 3.1.0 */

X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/48ab98cb1779cf2088c1351ac3dd3d0da6fb31d3..ef91a7f4f3c6468973e192335a27ec0e0faca0b5:/wp-admin/admin-header.php diff --git a/wp-admin/admin-header.php b/wp-admin/admin-header.php index c9d49d2b..d5ceeccd 100644 --- a/wp-admin/admin-header.php +++ b/wp-admin/admin-header.php @@ -10,8 +10,19 @@ if ( ! defined( 'WP_ADMIN' ) ) require_once( dirname( __FILE__ ) . '/admin.php' ); -// In case admin-header.php is included in a function. -global $title, $hook_suffix, $current_screen, $wp_locale, $pagenow, $wp_version, +/** + * In case admin-header.php is included in a function. + * + * @global string $title + * @global string $hook_suffix + * @global WP_Screen $current_screen + * @global WP_Locale $wp_locale + * @global string $pagenow + * @global string $update_title + * @global int $total_update_count + * @global string $parent_file + */ +global $title, $hook_suffix, $current_screen, $wp_locale, $pagenow, $update_title, $total_update_count, $parent_file; // Catch plugins that include admin-header.php before admin.php completes. @@ -21,20 +32,26 @@ if ( empty( $current_screen ) ) get_admin_page_title(); $title = esc_html( strip_tags( $title ) ); -if ( is_network_admin() ) - $admin_title = sprintf( __( 'Network Admin: %s' ), esc_html( get_current_site()->site_name ) ); -elseif ( is_user_admin() ) - $admin_title = sprintf( __( 'Global Dashboard: %s' ), esc_html( get_current_site()->site_name ) ); -else +if ( is_network_admin() ) { + /* translators: Network admin screen title. 1: Network name */ + $admin_title = sprintf( __( 'Network Admin: %s' ), esc_html( get_network()->site_name ) ); +} elseif ( is_user_admin() ) { + /* translators: User dashboard screen title. 1: Network name */ + $admin_title = sprintf( __( 'User Dashboard: %s' ), esc_html( get_network()->site_name ) ); +} else { $admin_title = get_bloginfo( 'name' ); +} -if ( $admin_title == $title ) +if ( $admin_title == $title ) { + /* translators: Admin screen title. 1: Admin screen name */ $admin_title = sprintf( __( '%1$s — WordPress' ), $title ); -else +} else { + /* translators: Admin screen title. 1: Admin screen name, 2: Network or site name */ $admin_title = sprintf( __( '%1$s ‹ %2$s — WordPress' ), $title, $admin_title ); +} /** - * Filter the content for an admin page. + * Filters the title tag content for an admin page. * * @since 3.1.0 * @@ -84,7 +101,7 @@ do_action( 'admin_enqueue_scripts', $hook_suffix ); * * @since 2.6.0 */ -do_action( "admin_print_styles-$hook_suffix" ); +do_action( "admin_print_styles-{$hook_suffix}" ); /** * Fires when styles are printed for all admin pages. @@ -98,7 +115,7 @@ do_action( 'admin_print_styles' ); * * @since 2.1.0 */ -do_action( "admin_print_scripts-$hook_suffix" ); +do_action( "admin_print_scripts-{$hook_suffix}" ); /** * Fires when scripts are printed for all admin pages. @@ -108,14 +125,17 @@ do_action( "admin_print_scripts-$hook_suffix" ); do_action( 'admin_print_scripts' ); /** - * Fires in <head> for a specific admin page based on $hook_suffix. + * Fires in head section for a specific admin page. + * + * The dynamic portion of the hook, `$hook_suffix`, refers to the hook suffix + * for the admin page. * * @since 2.1.0 */ -do_action( "admin_head-$hook_suffix" ); +do_action( "admin_head-{$hook_suffix}" ); /** - * Fires in <head> for all admin pages. + * Fires in head section for all admin pages. * * @since 2.1.0 */ @@ -139,10 +159,10 @@ if ( $current_screen->post_type ) if ( $current_screen->taxonomy ) $admin_body_class .= ' taxonomy-' . $current_screen->taxonomy; -$admin_body_class .= ' branch-' . str_replace( array( '.', ',' ), '-', floatval( $wp_version ) ); -$admin_body_class .= ' version-' . str_replace( '.', '-', preg_replace( '/^([.0-9]+).*/', '$1', $wp_version ) ); +$admin_body_class .= ' branch-' . str_replace( array( '.', ',' ), '-', floatval( get_bloginfo( 'version' ) ) ); +$admin_body_class .= ' version-' . str_replace( '.', '-', preg_replace( '/^([.0-9]+).*/', '$1', get_bloginfo( 'version' ) ) ); $admin_body_class .= ' admin-color-' . sanitize_html_class( get_user_option( 'admin_color' ), 'fresh' ); -$admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_locale() ) ) ); +$admin_body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_user_locale() ) ) ); if ( wp_is_mobile() ) $admin_body_class .= ' mobile'; @@ -159,18 +179,22 @@ $admin_body_class .= ' no-customize-support no-svg'; </head> <?php /** - * Filter the admin <body> CSS classes. + * Filters the CSS classes for the body tag in the admin. + * + * This filter differs from the {@see 'post_class'} and {@see 'body_class'} filters + * in two important ways: * - * This filter differs from the post_class or body_class filters in two important ways: - * 1. $classes is a space-separated string of class names instead of an array. - * 2. Not all core admin classes are filterable, notably: wp-admin, wp-core-ui, and no-js cannot be removed. + * 1. `$classes` is a space-separated string of class names instead of an array. + * 2. Not all core admin classes are filterable, notably: wp-admin, wp-core-ui, + * and no-js cannot be removed. * * @since 2.3.0 * - * @param string $classes Space-separated string of CSS classes. + * @param string $classes Space-separated list of CSS classes. */ +$admin_body_classes = apply_filters( 'admin_body_class', '' ); ?> -<body class="wp-admin wp-core-ui no-js <?php echo apply_filters( 'admin_body_class', '' ) . " $admin_body_class"; ?>"> +<body class="wp-admin wp-core-ui no-js <?php echo $admin_body_classes . ' ' . $admin_body_class; ?>"> <script type="text/javascript"> document.body.className = document.body.className.replace('no-js','js'); </script> @@ -183,7 +207,6 @@ if ( current_user_can( 'customize' ) ) { ?> <div id="wpwrap"> -<a tabindex="1" href="#wpbody-content" class="screen-reader-shortcut"><?php _e('Skip to main content'); ?></a> <?php require(ABSPATH . 'wp-admin/menu-header.php'); ?> <div id="wpcontent"> @@ -196,7 +219,7 @@ if ( current_user_can( 'customize' ) ) { do_action( 'in_admin_header' ); ?> -<div id="wpbody"> +<div id="wpbody" role="main"> <?php unset($title_class, $blog_name, $total_update_count, $update_title); @@ -211,21 +234,21 @@ $current_screen->render_screen_meta(); if ( is_network_admin() ) { /** - * Print network admin screen notices. + * Prints network admin screen notices. * * @since 3.1.0 */ do_action( 'network_admin_notices' ); } elseif ( is_user_admin() ) { /** - * Print user admin screen notices. + * Prints user admin screen notices. * * @since 3.1.0 */ do_action( 'user_admin_notices' ); } else { /** - * Print admin screen notices. + * Prints admin screen notices. * * @since 3.1.0 */ @@ -233,7 +256,7 @@ if ( is_network_admin() ) { } /** - * Print generic admin screen notices. + * Prints generic admin screen notices. * * @since 3.1.0 */