Commit 55dc02a8 authored by Sergey Biryukov's avatar Sergey Biryukov
Browse files

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.
Built from https://develop.svn.wordpress.org/trunk@48619


git-svn-id: https://core.svn.wordpress.org/trunk@48381 1a063a9b-81f0-0310-95a4-ce76da25c4cd
parent 30116969

wp-admin/includes/template.php

+0 −72
Original line number Diff line number Diff line
@@ -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.

 *

wp-includes/nav-menu.php

+5 −7
Original line number Diff line number Diff line
@@ -816,14 +816,12 @@ 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' ) ) {

					// 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;

					$menu_item->_invalid   = true;

wp-includes/post.php

+72 −0
Original line number Diff line number Diff line
@@ -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.

 *

wp-includes/version.php

+1 −1
Original line number Diff line number Diff line
@@ -13,7 +13,7 @@ 
 *

 * @global string $wp_version

 */

$wp_version = '5.5-beta3-48618';

$wp_version = '5.5-beta3-48619';



/**

 * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.