WordPress.org
Get WordPress

Make WordPress Core

Ticket #19647: 19647.diff

File 19647.diff, 14.8 KB (added by morganestes, 7 years ago)

Adds a deprecated notice to add_menu() and directs use of add_node()

  • src/wp-includes/admin-bar.php 

    diff --git src/wp-includes/admin-bar.php src/wp-includes/admin-bar.php
index 2bf56a8..244c0dd 100644
    function wp_admin_bar_render() { 
    105105 * @param WP_Admin_Bar $wp_admin_bar
    106106 */
    107107function wp_admin_bar_wp_menu( $wp_admin_bar ) {
    108         $wp_admin_bar->add_menu( array(
     108        $wp_admin_bar->add_node( array(
    109109                'id'    => 'wp-logo',
    110110                'title' => '<span class="ab-icon"></span><span class="screen-reader-text">' . __( 'About WordPress' ) . '</span>',
    111111                'href'  => self_admin_url( 'about.php' ),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    113113
    114114        if ( is_user_logged_in() ) {
    115115                // Add "About WordPress" link
    116                 $wp_admin_bar->add_menu( array(
     116                $wp_admin_bar->add_node( array(
    117117                        'parent' => 'wp-logo',
    118118                        'id'     => 'about',
    119119                        'title'  => __('About WordPress'),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    122122        }
    123123
    124124        // Add WordPress.org link
    125         $wp_admin_bar->add_menu( array(
     125        $wp_admin_bar->add_node( array(
    126126                'parent'    => 'wp-logo-external',
    127127                'id'        => 'wporg',
    128128                'title'     => __('WordPress.org'),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    130130        ) );
    131131
    132132        // Add codex link
    133         $wp_admin_bar->add_menu( array(
     133        $wp_admin_bar->add_node( array(
    134134                'parent'    => 'wp-logo-external',
    135135                'id'        => 'documentation',
    136136                'title'     => __('Documentation'),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    138138        ) );
    139139
    140140        // Add forums link
    141         $wp_admin_bar->add_menu( array(
     141        $wp_admin_bar->add_node( array(
    142142                'parent'    => 'wp-logo-external',
    143143                'id'        => 'support-forums',
    144144                'title'     => __('Support Forums'),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    146146        ) );
    147147
    148148        // Add feedback link
    149         $wp_admin_bar->add_menu( array(
     149        $wp_admin_bar->add_node( array(
    150150                'parent'    => 'wp-logo-external',
    151151                'id'        => 'feedback',
    152152                'title'     => __('Feedback'),
    … … function wp_admin_bar_wp_menu( $wp_admin_bar ) { 
    163163 */
    164164function wp_admin_bar_sidebar_toggle( $wp_admin_bar ) {
    165165        if ( is_admin() ) {
    166                 $wp_admin_bar->add_menu( array(
     166                $wp_admin_bar->add_node( array(
    167167                        'id'    => 'menu-toggle',
    168168                        'title' => '<span class="ab-icon"></span><span class="screen-reader-text">' . __( 'Menu' ) . '</span>',
    169169                        'href'  => '#',
    … … function wp_admin_bar_my_account_item( $wp_admin_bar ) { 
    197197        $howdy  = sprintf( __('Howdy, %1$s'), $current_user->display_name );
    198198        $class  = empty( $avatar ) ? '' : 'with-avatar';
    199199
    200         $wp_admin_bar->add_menu( array(
     200        $wp_admin_bar->add_node( array(
    201201                'id'        => 'my-account',
    202202                'parent'    => 'top-secondary',
    203203                'title'     => $howdy . $avatar,
    … … function wp_admin_bar_my_account_menu( $wp_admin_bar ) { 
    241241        if ( $current_user->display_name !== $current_user->user_login )
    242242                $user_info .= "<span class='username'>{$current_user->user_login}</span>";
    243243
    244         $wp_admin_bar->add_menu( array(
     244        $wp_admin_bar->add_node( array(
    245245                'parent' => 'user-actions',
    246246                'id'     => 'user-info',
    247247                'title'  => $user_info,
    … … function wp_admin_bar_my_account_menu( $wp_admin_bar ) { 
    252252        ) );
    253253
    254254        if ( false !== $profile_url ) {
    255                 $wp_admin_bar->add_menu( array(
     255                $wp_admin_bar->add_node( array(
    256256                        'parent' => 'user-actions',
    257257                        'id'     => 'edit-profile',
    258258                        'title'  => __( 'Edit My Profile' ),
    … … function wp_admin_bar_my_account_menu( $wp_admin_bar ) { 
    260260                ) );
    261261        }
    262262
    263         $wp_admin_bar->add_menu( array(
     263        $wp_admin_bar->add_node( array(
    264264                'parent' => 'user-actions',
    265265                'id'     => 'logout',
    266266                'title'  => __( 'Log Out' ),
    … … function wp_admin_bar_site_menu( $wp_admin_bar ) { 
    298298
    299299        $title = wp_html_excerpt( $blogname, 40, '&hellip;' );
    300300
    301         $wp_admin_bar->add_menu( array(
     301        $wp_admin_bar->add_node( array(
    302302                'id'    => 'site-name',
    303303                'title' => $title,
    304304                'href'  => ( is_admin() || ! current_user_can( 'read' ) ) ? home_url( '/' ) : admin_url(),
    … … function wp_admin_bar_site_menu( $wp_admin_bar ) { 
    308308
    309309        if ( is_admin() ) {
    310310                // Add an option to visit the site.
    311                 $wp_admin_bar->add_menu( array(
     311                $wp_admin_bar->add_node( array(
    312312                        'parent' => 'site-name',
    313313                        'id'     => 'view-site',
    314314                        'title'  => __( 'Visit Site' ),
    … … function wp_admin_bar_site_menu( $wp_admin_bar ) { 
    316316                ) );
    317317
    318318                if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {
    319                         $wp_admin_bar->add_menu( array(
     319                        $wp_admin_bar->add_node( array(
    320320                                'parent' => 'site-name',
    321321                                'id'     => 'edit-site',
    322322                                'title'  => __( 'Edit Site' ),
    … … function wp_admin_bar_site_menu( $wp_admin_bar ) { 
    326326
    327327        } else if ( current_user_can( 'read' ) ) {
    328328                // We're on the front end, link to the Dashboard.
    329                 $wp_admin_bar->add_menu( array(
     329                $wp_admin_bar->add_node( array(
    330330                        'parent' => 'site-name',
    331331                        'id'     => 'dashboard',
    332332                        'title'  => __( 'Dashboard' ),
    … … function wp_admin_bar_customize_menu( $wp_admin_bar ) { 
    354354        $current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
    355355        $customize_url = add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() );
    356356
    357         $wp_admin_bar->add_menu( array(
     357        $wp_admin_bar->add_node( array(
    358358                'id'     => 'customize',
    359359                'title'  => __( 'Customize' ),
    360360                'href'   => $customize_url,
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    387387                $my_sites_url = admin_url( 'my-sites.php' );
    388388        }
    389389
    390         $wp_admin_bar->add_menu( array(
     390        $wp_admin_bar->add_node( array(
    391391                'id'    => 'my-sites',
    392392                'title' => __( 'My Sites' ),
    393393                'href'  => $my_sites_url,
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    399399                        'id'     => 'my-sites-super-admin',
    400400                ) );
    401401
    402                 $wp_admin_bar->add_menu( array(
     402                $wp_admin_bar->add_node( array(
    403403                        'parent' => 'my-sites-super-admin',
    404404                        'id'     => 'network-admin',
    405405                        'title'  => __('Network Admin'),
    406406                        'href'   => network_admin_url(),
    407407                ) );
    408408
    409                 $wp_admin_bar->add_menu( array(
     409                $wp_admin_bar->add_node( array(
    410410                        'parent' => 'network-admin',
    411411                        'id'     => 'network-admin-d',
    412412                        'title'  => __( 'Dashboard' ),
    413413                        'href'   => network_admin_url(),
    414414                ) );
    415                 $wp_admin_bar->add_menu( array(
     415                $wp_admin_bar->add_node( array(
    416416                        'parent' => 'network-admin',
    417417                        'id'     => 'network-admin-s',
    418418                        'title'  => __( 'Sites' ),
    419419                        'href'   => network_admin_url( 'sites.php' ),
    420420                ) );
    421                 $wp_admin_bar->add_menu( array(
     421                $wp_admin_bar->add_node( array(
    422422                        'parent' => 'network-admin',
    423423                        'id'     => 'network-admin-u',
    424424                        'title'  => __( 'Users' ),
    425425                        'href'   => network_admin_url( 'users.php' ),
    426426                ) );
    427                 $wp_admin_bar->add_menu( array(
     427                $wp_admin_bar->add_node( array(
    428428                        'parent' => 'network-admin',
    429429                        'id'     => 'network-admin-t',
    430430                        'title'  => __( 'Themes' ),
    431431                        'href'   => network_admin_url( 'themes.php' ),
    432432                ) );
    433                 $wp_admin_bar->add_menu( array(
     433                $wp_admin_bar->add_node( array(
    434434                        'parent' => 'network-admin',
    435435                        'id'     => 'network-admin-p',
    436436                        'title'  => __( 'Plugins' ),
    437437                        'href'   => network_admin_url( 'plugins.php' ),
    438438                ) );
    439                 $wp_admin_bar->add_menu( array(
     439                $wp_admin_bar->add_node( array(
    440440                        'parent' => 'network-admin',
    441441                        'id'     => 'network-admin-o',
    442442                        'title'  => __( 'Settings' ),
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    466466
    467467                $menu_id  = 'blog-' . $blog->userblog_id;
    468468
    469                 $wp_admin_bar->add_menu( array(
     469                $wp_admin_bar->add_node( array(
    470470                        'parent'    => 'my-sites-list',
    471471                        'id'        => $menu_id,
    472472                        'title'     => $blavatar . $blogname,
    473473                        'href'      => admin_url(),
    474474                ) );
    475475
    476                 $wp_admin_bar->add_menu( array(
     476                $wp_admin_bar->add_node( array(
    477477                        'parent' => $menu_id,
    478478                        'id'     => $menu_id . '-d',
    479479                        'title'  => __( 'Dashboard' ),
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    481481                ) );
    482482
    483483                if ( current_user_can( get_post_type_object( 'post' )->cap->create_posts ) ) {
    484                         $wp_admin_bar->add_menu( array(
     484                        $wp_admin_bar->add_node( array(
    485485                                'parent' => $menu_id,
    486486                                'id'     => $menu_id . '-n',
    487487                                'title'  => __( 'New Post' ),
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    490490                }
    491491
    492492                if ( current_user_can( 'edit_posts' ) ) {
    493                         $wp_admin_bar->add_menu( array(
     493                        $wp_admin_bar->add_node( array(
    494494                                'parent' => $menu_id,
    495495                                'id'     => $menu_id . '-c',
    496496                                'title'  => __( 'Manage Comments' ),
    … … function wp_admin_bar_my_sites_menu( $wp_admin_bar ) { 
    498498                        ) );
    499499                }
    500500
    501                 $wp_admin_bar->add_menu( array(
     501                $wp_admin_bar->add_node( array(
    502502                        'parent' => $menu_id,
    503503                        'id'     => $menu_id . '-v',
    504504                        'title'  => __( 'Visit Site' ),
    … … function wp_admin_bar_shortlink_menu( $wp_admin_bar ) { 
    525525
    526526        $html = '<input class="shortlink-input" type="text" readonly="readonly" value="' . esc_attr( $short ) . '" />';
    527527
    528         $wp_admin_bar->add_menu( array(
     528        $wp_admin_bar->add_node( array(
    529529                'id' => $id,
    530530                'title' => __( 'Shortlink' ),
    531531                'href' => $short,
    … … function wp_admin_bar_edit_menu( $wp_admin_bar ) { 
    560560                        if ( 'draft' == $post->post_status ) {
    561561                                $draft_link = set_url_scheme( get_permalink( $post->ID ) );
    562562                                $preview_link = get_preview_post_link( $post, array(), $draft_link );
    563                                 $wp_admin_bar->add_menu( array(
     563                                $wp_admin_bar->add_node( array(
    564564                                        'id' => 'preview',
    565565                                        'title' => $post_type_object->labels->view_item,
    566566                                        'href' => esc_url( $preview_link ),
    567567                                        'meta' => array( 'target' => 'wp-preview-' . $post->ID ),
    568568                                ) );
    569569                        } else {
    570                                 $wp_admin_bar->add_menu( array(
     570                                $wp_admin_bar->add_node( array(
    571571                                        'id' => 'view',
    572572                                        'title' => $post_type_object->labels->view_item,
    573573                                        'href' => get_permalink( $post->ID )
    … … function wp_admin_bar_edit_menu( $wp_admin_bar ) { 
    578578                        && ( $tax = get_taxonomy( $tag->taxonomy ) )
    579579                        && $tax->public )
    580580                {
    581                         $wp_admin_bar->add_menu( array(
     581                        $wp_admin_bar->add_node( array(
    582582                                'id' => 'view',
    583583                                'title' => $tax->labels->view_item,
    584584                                'href' => get_term_link( $tag )
    … … function wp_admin_bar_edit_menu( $wp_admin_bar ) { 
    596596                        && $post_type_object->show_in_admin_bar
    597597                        && $edit_post_link = get_edit_post_link( $current_object->ID ) )
    598598                {
    599                         $wp_admin_bar->add_menu( array(
     599                        $wp_admin_bar->add_node( array(
    600600                                'id' => 'edit',
    601601                                'title' => $post_type_object->labels->edit_item,
    602602                                'href' => $edit_post_link
    … … function wp_admin_bar_edit_menu( $wp_admin_bar ) { 
    606606                        && current_user_can( $tax->cap->edit_terms )
    607607                        && $edit_term_link = get_edit_term_link( $current_object->term_id, $current_object->taxonomy ) )
    608608                {
    609                         $wp_admin_bar->add_menu( array(
     609                        $wp_admin_bar->add_node( array(
    610610                                'id' => 'edit',
    611611                                'title' => $tax->labels->edit_item,
    612612                                'href' => $edit_term_link
    … … function wp_admin_bar_new_content_menu( $wp_admin_bar ) { 
    661661
    662662        $title = '<span class="ab-icon"></span><span class="ab-label">' . _x( 'New', 'admin bar menu group label' ) . '</span>';
    663663
    664         $wp_admin_bar->add_menu( array(
     664        $wp_admin_bar->add_node( array(
    665665                'id'    => 'new-content',
    666666                'title' => $title,
    667667                'href'  => admin_url( current( array_keys( $actions ) ) ),
    … … function wp_admin_bar_new_content_menu( $wp_admin_bar ) { 
    670670        foreach ( $actions as $link => $action ) {
    671671                list( $title, $id ) = $action;
    672672
    673                 $wp_admin_bar->add_menu( array(
     673                $wp_admin_bar->add_node( array(
    674674                        'parent'    => 'new-content',
    675675                        'id'        => $id,
    676676                        'title'     => $title,
    … … function wp_admin_bar_comments_menu( $wp_admin_bar ) { 
    697697        $icon  = '<span class="ab-icon"></span>';
    698698        $title = '<span id="ab-awaiting-mod" class="ab-label awaiting-mod pending-count count-' . $awaiting_mod . '">' . number_format_i18n( $awaiting_mod ) . '</span>';
    699699
    700         $wp_admin_bar->add_menu( array(
     700        $wp_admin_bar->add_node( array(
    701701                'id'    => 'comments',
    702702                'title' => $icon . $title,
    703703                'href'  => admin_url('edit-comments.php'),
    … … function wp_admin_bar_appearance_menu( $wp_admin_bar ) { 
    716716        $wp_admin_bar->add_group( array( 'parent' => 'site-name', 'id' => 'appearance' ) );
    717717
    718718        if ( current_user_can( 'switch_themes' ) ) {
    719                 $wp_admin_bar->add_menu( array(
     719                $wp_admin_bar->add_node( array(
    720720                        'parent' => 'appearance',
    721721                        'id'     => 'themes',
    722722                        'title'  => __( 'Themes' ),
    … … function wp_admin_bar_appearance_menu( $wp_admin_bar ) { 
    729729        }
    730730
    731731        if ( current_theme_supports( 'widgets' )  ) {
    732                 $wp_admin_bar->add_menu( array(
     732                $wp_admin_bar->add_node( array(
    733733                        'parent' => 'appearance',
    734734                        'id'     => 'widgets',
    735735                        'title'  => __( 'Widgets' ),
    … … function wp_admin_bar_appearance_menu( $wp_admin_bar ) { 
    738738        }
    739739
    740740        if ( current_theme_supports( 'menus' ) || current_theme_supports( 'widgets' ) )
    741                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php') ) );
     741                $wp_admin_bar->add_node( array( 'parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php') ) );
    742742
    743743        if ( current_theme_supports( 'custom-background' ) ) {
    744                 $wp_admin_bar->add_menu( array(
     744                $wp_admin_bar->add_node( array(
    745745                        'parent' => 'appearance',
    746746                        'id'     => 'background',
    747747                        'title'  => __( 'Background' ),
    … … function wp_admin_bar_appearance_menu( $wp_admin_bar ) { 
    753753        }
    754754
    755755        if ( current_theme_supports( 'custom-header' ) ) {
    756                 $wp_admin_bar->add_menu( array(
     756                $wp_admin_bar->add_node( array(
    757757                        'parent' => 'appearance',
    758758                        'id'     => 'header',
    759759                        'title'  => __( 'Header' ),
    … … function wp_admin_bar_updates_menu( $wp_admin_bar ) { 
    783783        $title = '<span class="ab-icon"></span><span class="ab-label">' . number_format_i18n( $update_data['counts']['total'] ) . '</span>';
    784784        $title .= '<span class="screen-reader-text">' . $update_data['title'] . '</span>';
    785785
    786         $wp_admin_bar->add_menu( array(
     786        $wp_admin_bar->add_node( array(
    787787                'id'    => 'updates',
    788788                'title' => $title,
    789789                'href'  => network_admin_url( 'update-core.php' ),
    … … function wp_admin_bar_search_menu( $wp_admin_bar ) { 
    810810        $form .= '<input type="submit" class="adminbar-button" value="' . __('Search') . '"/>';
    811811        $form .= '</form>';
    812812
    813         $wp_admin_bar->add_menu( array(
     813        $wp_admin_bar->add_node( array(
    814814                'parent' => 'top-secondary',
    815815                'id'     => 'search',
    816816                'title'  => $form,

  • src/wp-includes/class-wp-admin-bar.php 

    diff --git src/wp-includes/class-wp-admin-bar.php src/wp-includes/class-wp-admin-bar.php
index 2fa3135..961f143 100644
    class WP_Admin_Bar { 
    8282        }
    8383
    8484        /**
    85          * @param array $node
     85         * Add a node (menu item) to the Admin Bar menu.
     86         *
     87         * @since 3.3.0
     88         * @since 4.5.0 Deprecated in favor of `WP_Admin_Bar::add_node()`.
     89         *
     90         * @param array $node The attributes that define the node.
    8691         */
    8792        public function add_menu( $node ) {
     93                _deprecated_function( __METHOD__, '4.5.0', __CLASS__ . '::add_node()' );
    8894                $this->add_node( $node );
    8995        }
    9096