From 9950b3668b47e4aa3092ebf7fb7d61b1c68cb922 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Sun, 26 Jul 2020 01:12:51 +0000 Subject: [PATCH] Posts, Post Types: Make `get_post_states()` available on frontend. This allows special pages to be denoted as such when editing a menu in the Customizer. This applies to the Front Page, Posts Page, and Privacy Policy Page. Follow-up to [47211], [47213], [47763]. Props dlh, whyisjake, SergeyBiryukov. Fixes #46829. See #49374. git-svn-id: https://develop.svn.wordpress.org/trunk@48619 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-admin/includes/template.php | 72 ------------------------------ src/wp-includes/nav-menu.php | 12 +++-- src/wp-includes/post.php | 72 ++++++++++++++++++++++++++++++ 3 files changed, 77 insertions(+), 79 deletions(-) diff --git a/src/wp-admin/includes/template.php b/src/wp-admin/includes/template.php index ff2944b7dc..9f76ab3c11 100644 --- a/src/wp-admin/includes/template.php +++ b/src/wp-admin/includes/template.php @@ -2148,78 +2148,6 @@ function _post_states( $post, $echo = true ) { return $post_states_string; } -/** - * Retrieves an array of post states from a post. - * - * @since 5.3.0 - * - * @param WP_Post $post The post to retrieve states for. - * @return string[] Array of post state labels keyed by their state. - */ -function get_post_states( $post ) { - $post_states = array(); - if ( isset( $_REQUEST['post_status'] ) ) { - $post_status = $_REQUEST['post_status']; - } else { - $post_status = ''; - } - - if ( ! empty( $post->post_password ) ) { - $post_states['protected'] = _x( 'Password protected', 'post status' ); - } - - if ( 'private' === $post->post_status && 'private' !== $post_status ) { - $post_states['private'] = _x( 'Private', 'post status' ); - } - - if ( 'draft' === $post->post_status ) { - if ( get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { - $post_states[] = __( 'Customization Draft' ); - } elseif ( 'draft' !== $post_status ) { - $post_states['draft'] = _x( 'Draft', 'post status' ); - } - } elseif ( 'trash' === $post->post_status && get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { - $post_states[] = _x( 'Customization Draft', 'post status' ); - } - - if ( 'pending' === $post->post_status && 'pending' !== $post_status ) { - $post_states['pending'] = _x( 'Pending', 'post status' ); - } - - if ( is_sticky( $post->ID ) ) { - $post_states['sticky'] = _x( 'Sticky', 'post status' ); - } - - if ( 'future' === $post->post_status ) { - $post_states['scheduled'] = _x( 'Scheduled', 'post status' ); - } - - if ( 'page' === get_option( 'show_on_front' ) ) { - if ( intval( get_option( 'page_on_front' ) ) === $post->ID ) { - $post_states['page_on_front'] = _x( 'Front Page', 'page label' ); - } - - if ( intval( get_option( 'page_for_posts' ) ) === $post->ID ) { - $post_states['page_for_posts'] = _x( 'Posts Page', 'page label' ); - } - } - - if ( intval( get_option( 'wp_page_for_privacy_policy' ) ) === $post->ID ) { - $post_states['page_for_privacy_policy'] = _x( 'Privacy Policy Page', 'page label' ); - } - - /** - * Filters the default post display states used in the posts list table. - * - * @since 2.8.0 - * @since 3.6.0 Added the `$post` parameter. - * - * @param string[] $post_states An array of post display states. - * @param WP_Post $post The current post object. - */ - return apply_filters( 'display_post_states', $post_states, $post ); -} - /** * Outputs the attachment media states as HTML. * diff --git a/src/wp-includes/nav-menu.php b/src/wp-includes/nav-menu.php index 36697f1ee9..5d6a177092 100644 --- a/src/wp-includes/nav-menu.php +++ b/src/wp-includes/nav-menu.php @@ -816,13 +816,11 @@ function wp_setup_nav_menu_item( $menu_item ) { $object = get_post_type_object( $menu_item->object ); if ( $object ) { $menu_item->type_label = $object->labels->singular_name; - // Use post states for special pages (only in the admin). - if ( function_exists( 'get_post_states' ) ) { - $menu_post = get_post( $menu_item->object_id ); - $post_states = get_post_states( $menu_post ); - if ( $post_states ) { - $menu_item->type_label = wp_strip_all_tags( implode( ', ', $post_states ) ); - } + // Use post states for special pages. + $menu_post = get_post( $menu_item->object_id ); + $post_states = get_post_states( $menu_post ); + if ( $post_states ) { + $menu_item->type_label = wp_strip_all_tags( implode( ', ', $post_states ) ); } } else { $menu_item->type_label = $menu_item->object; diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php index 50b0aa3b76..e9eb743746 100644 --- a/src/wp-includes/post.php +++ b/src/wp-includes/post.php @@ -933,6 +933,78 @@ function get_post_status( $post = null ) { return apply_filters( 'get_post_status', $post->post_status, $post ); } +/** + * Retrieves an array of post states from a post. + * + * @since 5.3.0 + * + * @param WP_Post $post The post to retrieve states for. + * @return string[] Array of post state labels keyed by their state. + */ +function get_post_states( $post ) { + $post_states = array(); + if ( isset( $_REQUEST['post_status'] ) ) { + $post_status = $_REQUEST['post_status']; + } else { + $post_status = ''; + } + + if ( ! empty( $post->post_password ) ) { + $post_states['protected'] = _x( 'Password protected', 'post status' ); + } + + if ( 'private' === $post->post_status && 'private' !== $post_status ) { + $post_states['private'] = _x( 'Private', 'post status' ); + } + + if ( 'draft' === $post->post_status ) { + if ( get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { + $post_states[] = __( 'Customization Draft' ); + } elseif ( 'draft' !== $post_status ) { + $post_states['draft'] = _x( 'Draft', 'post status' ); + } + } elseif ( 'trash' === $post->post_status && get_post_meta( $post->ID, '_customize_changeset_uuid', true ) ) { + $post_states[] = _x( 'Customization Draft', 'post status' ); + } + + if ( 'pending' === $post->post_status && 'pending' !== $post_status ) { + $post_states['pending'] = _x( 'Pending', 'post status' ); + } + + if ( is_sticky( $post->ID ) ) { + $post_states['sticky'] = _x( 'Sticky', 'post status' ); + } + + if ( 'future' === $post->post_status ) { + $post_states['scheduled'] = _x( 'Scheduled', 'post status' ); + } + + if ( 'page' === get_option( 'show_on_front' ) ) { + if ( intval( get_option( 'page_on_front' ) ) === $post->ID ) { + $post_states['page_on_front'] = _x( 'Front Page', 'page label' ); + } + + if ( intval( get_option( 'page_for_posts' ) ) === $post->ID ) { + $post_states['page_for_posts'] = _x( 'Posts Page', 'page label' ); + } + } + + if ( intval( get_option( 'wp_page_for_privacy_policy' ) ) === $post->ID ) { + $post_states['page_for_privacy_policy'] = _x( 'Privacy Policy Page', 'page label' ); + } + + /** + * Filters the default post display states used in the posts list table. + * + * @since 2.8.0 + * @since 3.6.0 Added the `$post` parameter. + * + * @param string[] $post_states An array of post display states. + * @param WP_Post $post The current post object. + */ + return apply_filters( 'display_post_states', $post_states, $post ); +} + /** * Retrieve all of the WordPress supported post statuses. *