Changeset 48619

Timestamp:

07/26/2020 01:12:51 AM (4 years ago)

Author:

SergeyBiryukov

Message:

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.

Location:

trunk/src

Files:

• wp-admin/includes/template.php (modified) (1 diff)
• wp-includes/nav-menu.php (modified) (1 diff)
• wp-includes/post.php (modified) (1 diff)

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

@@ -2150 +2150 @@
 
 /**
- * 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.
  *

trunk/src/wp-includes/nav-menu.php

@@ -817 +817 @@
                 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 {

trunk/src/wp-includes/post.php

@@ -932 +932 @@
      */
     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 );
 }