WordPress.org
Get WordPress

Make WordPress Core

Ticket #37782: 37782.12.diff

File 37782.12.diff, 9.0 KB (added by garrett-eclipse, 6 years ago)

Minor update to address phpDocs and CS. No code change, but still retested to ensure no issues

  • src/wp-admin/css/nav-menus.css

     
    413413        margin-top: -4px;
    414414}
    415415
     416.menu-item-title .post-state {
     417        font-weight: 600;
     418}
     419
    416420/* Nav Menu */
    417421#menu-container .inside {
    418422        padding-bottom: 10px;

  • src/wp-admin/includes/class-walker-nav-menu-checklist.php

     
    9494                } elseif ( isset( $item->post_type ) ) {
    9595                        /** This filter is documented in wp-includes/post-template.php */
    9696                        $title = apply_filters( 'the_title', $item->post_title, $item->ID );
    97                         if ( ! empty( $item->front_or_home ) && _x( 'Home', 'nav menu home label' ) !== $title ) {
    98                                 /* translators: %s: front page title */
    99                                 $title = sprintf( _x( 'Home: %s', 'nav menu front page title' ), $title );
    100                         }
    10197                }
    10298
    10399                $output .= isset( $title ) ? esc_html( $title ) : esc_html( $item->title );
     100
     101                if ( empty( $item->label ) && isset( $item->post_type ) && 'page' === $item->post_type ) {
     102                        /** Append post states */
     103                        $output .= _post_states( $item, false );
     104                }
     105
    104106                $output .= '</label>';
    105107
    106108                // Menu item hidden fields

  • src/wp-admin/includes/nav-menu.php

     
    354354                $args = array_merge( $args, (array) $box['args']->_default_query );
    355355        }
    356356
     357        /**
     358         * If we're dealing with pages, let's prioritize the Front Page,
     359         * Posts Page and Privacy Policy Page at the top of the list.
     360         */
     361        $important_pages = array();
     362        if ( 'page' == $post_type_name ) {
     363                $suppress_page_ids = array();
     364
     365                $front_page = 'page' == get_option( 'show_on_front' ) ? (int) get_option( 'page_on_front' ) : 0;
     366                $posts_page = 'page' == get_option( 'show_on_front' ) ? (int) get_option( 'page_for_posts' ) : 0;
     367
     368                $privacy_policy_page_id        = (int) get_option( 'wp_page_for_privacy_policy' );
     369                $privacy_policy_page_available = false;
     370
     371                if ( ! empty( $privacy_policy_page_id ) ) {
     372                        $privacy_policy_page           = get_post( $privacy_policy_page_id );
     373                        $privacy_policy_page_available = ( $privacy_policy_page instanceof WP_Post && 'publish' === $privacy_policy_page->post_status );
     374                }
     375
     376                // Insert Front Page or custom Home link.
     377                $front_page_obj = null;
     378                if ( ! empty( $front_page ) ) {
     379                        $front_page_obj                = get_post( $front_page );
     380                        $front_page_obj->front_or_home = true;
     381
     382                        $important_pages[]   = $front_page_obj;
     383                        $suppress_page_ids[] = $front_page_obj->ID;
     384                } else {
     385                        $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? intval( $_nav_menu_placeholder ) - 1 : -1;
     386                        $front_page_obj        = (object) array(
     387                                'front_or_home' => true,
     388                                'ID'            => 0,
     389                                'object_id'     => $_nav_menu_placeholder,
     390                                'post_content'  => '',
     391                                'post_excerpt'  => '',
     392                                'post_parent'   => '',
     393                                'post_title'    => _x( 'Home', 'nav menu home label' ),
     394                                'post_type'     => 'nav_menu_item',
     395                                'type'          => 'custom',
     396                                'url'           => home_url( '/' ),
     397                        );
     398
     399                        $important_pages[] = $front_page_obj;
     400                }
     401
     402                // Insert Posts Page.
     403                if ( ! empty( $posts_page ) ) {
     404                        $posts_page_obj             = get_post( $posts_page );
     405                        $posts_page_obj->posts_page = true;
     406
     407                        $important_pages[]   = $posts_page_obj;
     408                        $suppress_page_ids[] = $posts_page_obj->ID;
     409                }
     410
     411                // Insert Privacy Policy Page.
     412                if ( $privacy_policy_page_available ) {
     413                        $privacy_policy_page_obj                      = get_post( $privacy_policy_page_id );
     414                        $privacy_policy_page_obj->privacy_policy_page = true;
     415
     416                        $important_pages[]   = $privacy_policy_page_obj;
     417                        $suppress_page_ids[] = $privacy_policy_page_obj->ID;
     418                }
     419
     420                // Add suppression array to arguments for WP_Query.
     421                if ( ! empty( $suppress_page_ids ) ) {
     422                        $args['post__not_in'] = $suppress_page_ids;
     423                }
     424        }
     425
    357426        // @todo transient caching of these results with proper invalidation on updating of a post of this type
    358427        $get_posts = new WP_Query;
    359428        $posts     = $get_posts->query( $args );
     429
     430        // Only suppress and insert when more than just suppression pages available.
    360431        if ( ! $get_posts->post_count ) {
    361                 echo '<p>' . __( 'No items.' ) . '</p>';
    362                 return;
     432                if ( ! empty( $suppress_page_ids ) ) {
     433                        unset( $args['post__not_in'] );
     434                        $get_posts = new WP_Query;
     435                        $posts     = $get_posts->query( $args );
     436                } else {
     437                        echo '<p>' . __( 'No items.' ) . '</p>';
     438                        return;
     439                }
     440        } else {
     441                if ( ! empty( $important_pages ) ) {
     442                        $posts = array_merge( $important_pages, $posts );
     443                }
    363444        }
    364445
    365446        $num_pages = $get_posts->max_num_pages;
    … …  
    520601                                <?php
    521602                                $args['walker'] = $walker;
    522603
    523                                 /*
    524                                  * If we're dealing with pages, let's put a checkbox for the front
    525                                  * page at the top of the list.
    526                                  */
    527                                 if ( 'page' == $post_type_name ) {
    528                                         $front_page = 'page' == get_option( 'show_on_front' ) ? (int) get_option( 'page_on_front' ) : 0;
    529                                         if ( ! empty( $front_page ) ) {
    530                                                 $front_page_obj                = get_post( $front_page );
    531                                                 $front_page_obj->front_or_home = true;
    532                                                 array_unshift( $posts, $front_page_obj );
    533                                         } else {
    534                                                 $_nav_menu_placeholder = ( 0 > $_nav_menu_placeholder ) ? intval( $_nav_menu_placeholder ) - 1 : -1;
    535                                                 array_unshift(
    536                                                         $posts,
    537                                                         (object) array(
    538                                                                 'front_or_home' => true,
    539                                                                 'ID'            => 0,
    540                                                                 'object_id'     => $_nav_menu_placeholder,
    541                                                                 'post_content'  => '',
    542                                                                 'post_excerpt'  => '',
    543                                                                 'post_parent'   => '',
    544                                                                 'post_title'    => _x( 'Home', 'nav menu home label' ),
    545                                                                 'post_type'     => 'nav_menu_item',
    546                                                                 'type'          => 'custom',
    547                                                                 'url'           => home_url( '/' ),
    548                                                         )
    549                                                 );
    550                                         }
    551                                 }
    552 
    553604                                $post_type = get_post_type_object( $post_type_name );
    554605
    555606                                if ( $post_type->has_archive ) {

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

     
    20092009}
    20102010
    20112011/**
    2012  * @param WP_Post $post
     2012 * Function to echo or return the Post States as an HTML string.
     2013 *
     2014 * @param WP_Post $post The post to retrieve states for.
     2015 * @param boolean $echo Optional. Whether to echo or return the Post States as an HTML string. Default true for echo.
     2016 *
     2017 * @return string|void Post States string when echo is false.
    20132018 */
    2014 function _post_states( $post ) {
     2019function _post_states( $post, $echo = true ) {
     2020        $post_states        = get_post_states( $post );
     2021        $post_states_string = '';
     2022
     2023        if ( ! empty( $post_states ) ) {
     2024                $state_count = count( $post_states );
     2025                $i           = 0;
     2026
     2027                $post_states_string .= ' &mdash; ';
     2028                foreach ( $post_states as $state ) {
     2029                        ++$i;
     2030                        ( $i == $state_count ) ? $sep = '' : $sep = ', ';
     2031                        $post_states_string .= "<span class='post-state'>$state$sep</span>";
     2032                }
     2033        }
     2034
     2035        if ( $echo ) {
     2036                echo $post_states_string;
     2037        }
     2038
     2039        return $post_states_string;
     2040}
     2041
     2042/**
     2043 * Function to retrieve an array of Post States from a Post.
     2044 *
     2045 * @since 5.2.0
     2046 *
     2047 * @param WP_Post $post The post to retrieve states for.
     2048 *
     2049 * @return array $post_states The array of translated post states
     2050 */
     2051function get_post_states( $post ) {
    20152052        $post_states = array();
    20162053        if ( isset( $_REQUEST['post_status'] ) ) {
    20172054                $post_status = $_REQUEST['post_status'];
    … …  
    20222059        if ( ! empty( $post->post_password ) ) {
    20232060                $post_states['protected'] = __( 'Password protected' );
    20242061        }
     2062
    20252063        if ( 'private' == $post->post_status && 'private' != $post_status ) {
    20262064                $post_states['private'] = __( 'Private' );
    20272065        }
     2066
    20282067        if ( 'draft' === $post->post_status ) {
    20292068                if ( get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) {
    20302069                        $post_states[] = __( 'Customization Draft' );
    … …  
    20342073        } elseif ( 'trash' === $post->post_status && get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) {
    20352074                $post_states[] = __( 'Customization Draft' );
    20362075        }
     2076
    20372077        if ( 'pending' == $post->post_status && 'pending' != $post_status ) {
    20382078                $post_states['pending'] = _x( 'Pending', 'post status' );
    20392079        }
     2080
    20402081        if ( is_sticky( $post->ID ) ) {
    20412082                $post_states['sticky'] = __( 'Sticky' );
    20422083        }
    … …  
    20682109         * @param string[] $post_states An array of post display states.
    20692110         * @param WP_Post  $post        The current post object.
    20702111         */
    2071         $post_states = apply_filters( 'display_post_states', $post_states, $post );
    2072 
    2073         if ( ! empty( $post_states ) ) {
    2074                 $state_count = count( $post_states );
    2075                 $i           = 0;
    2076                 echo ' &mdash; ';
    2077                 foreach ( $post_states as $state ) {
    2078                         ++$i;
    2079                         ( $i == $state_count ) ? $sep = '' : $sep = ', ';
    2080                         echo "<span class='post-state'>$state$sep</span>";
    2081                 }
    2082         }
    2083 
     2112        return apply_filters( 'display_post_states', $post_states, $post );
    20842113}
    20852114
    20862115/**