Ticket #42063: 42063.1.patch

src/wp-admin/includes/template.php

@@ -2234 +2234 @@
  * Outputs the attachment media states as HTML.
  *
  * @since 3.2.0
+ * @since 5.6.0 Added the `$echo` parameter.
  *
  * @param WP_Post $post The attachment post to retrieve states for.
+ * @param bool    $echo Optional. Whether to echo the post states as an HTML string. Default true.
+ * @return string Media states string.
  */
-function _media_states( $post ) {
+function _media_states( $post, $echo = true ) {
+        $media_states = get_media_states( $post );
+        $media_states_string = '';
+
+        if ( ! empty( $media_states ) ) {
+                $state_count = count( $media_states );
+                $i           = 0;
+
+                $media_states_string .= ' — ';
+
+                foreach ( $media_states as $state ) {
+                        $sep = ( ++$i === $state_count ) ? '' : ', ';
+
+                        $media_states_string .= "<span class='post-state'>$state$sep</span>";
+                }
+        }
+
+        if ( $echo ) {
+                echo $media_states_string;
+        }
+
+        return $media_states_string;
+}
+
+/**
+ * Retrieves an array of media states from an attachment.
+ *
+ * @since 5.6.0
+ *
+ * @param WP_Post $post The attachment to retrieve states for.
+ * @return string[] Array of media state labels keyed by their state.
+ */
+function get_media_states( $post ) {
         static $header_images;
 
         $media_states = array();
@@ -2300 +2335 @@
          *                               'Background Image', 'Site Icon', 'Logo'.
          * @param WP_Post  $post         The current attachment object.
          */
-        $media_states = apply_filters( 'display_media_states', $media_states, $post );
-
-        if ( ! empty( $media_states ) ) {
-                $state_count = count( $media_states );
-                $i           = 0;
-
-                echo ' &mdash; ';
-
-                foreach ( $media_states as $state ) {
-                        $sep = ( ++$i === $state_count ) ? '' : ', ';
-
-                        echo "<span class='post-state'>$state$sep</span>";
-                }
-        }
+         return apply_filters( 'display_media_states', $media_states, $post );
 }
 
 /**

src/wp-includes/media-template.php

@@ -442 +442 @@
                                         </div>
                                 <# } #>
 
+                                <# if ( data.mediaStates ) { #>
+                                        <div class="media-states"><strong><?php _e( 'Current state:' ); ?></strong> {{ data.mediaStates }}</div>
+                                <# } #>
+
                                 <div class="compat-meta">
                                         <# if ( data.compat && data.compat.meta ) { #>
                                                 {{{ data.compat.meta }}}
@@ -636 +640 @@
                                         </div>
                                 <# } #>
 
+                                <# if ( data.mediaStates ) { #>
+                                        <div class="media-states"><strong><?php _e( 'Current state:' ); ?></strong> {{ data.mediaStates }}</div>
+                                <# } #>
+
                                 <# if ( ! data.uploading && data.can.remove ) { #>
                                         <?php if ( MEDIA_TRASH ) : ?>
                                         <# if ( 'trash' === data.status ) { #>

src/wp-includes/media.php

@@ -3982 +3982 @@
                 $response['compat'] = get_compat_media_markup( $attachment->ID, array( 'in_modal' => true ) );
         }
 
+        $media_states = get_media_states( $attachment );
+        if ( ! empty( $media_states ) ) {
+                $response['mediaStates'] = implode( ', ', $media_states );
+        }
+
         /**
          * Filters the attachment data prepared for JavaScript.
          *