Changeset 62683

Timestamp:

07/09/2026 09:16:36 PM (4 weeks ago)

Author:

joedolson

Message:

Media: Update labels for media caption inputs.

All media types used the label Caption for the data stored in $post->post_excerpt. This label is only meaningful for image media types, and misrepresents the content for video and audio, where caption has a different specific meaning.

Change the labels to use Image Caption for the image case, and Short Description for all other cases, so that the label represents the explicit usage where core uses the data, and represents the internal storage model for cases where core does not use the data.

Props postphotos, bridgetwillard, kirasong, joemcgill, afercia, pento, karmatosed, desrosj, jamesbregenzer, abcd95, aperto, joedolson.
Fixes #43178.

Location:

trunk/src

Files:

• wp-admin/includes/media.php (modified) (1 diff)
• wp-includes/media-template.php (modified) (2 diffs)

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

@@ -3275 +3275 @@
 
                 <p>
-                        <label for="attachment_caption"><strong><?php _e( 'Caption' ); ?></strong></label><br />
+                        <label for="attachment_caption"><strong>
+                                <?php
+                                if ( wp_attachment_is( 'image', $post ) ) {
+                                        esc_html_e( 'Image Caption' );
+                                } else {
+                                        esc_html_e( 'Short Description' );
+                                }
+                                ?>
+                        </strong></label><br />
                         <textarea class="widefat" name="excerpt" id="attachment_caption"><?php echo $post->post_excerpt; ?></textarea>
                 </p>

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

@@ -545 +545 @@
                                 <# } #>
                                 <span class="setting" data-setting="caption">
-                                        <label for="attachment-details-two-column-caption" class="name"><?php _e( 'Caption' ); ?></label>
+                                        <# if ( 'image' === data.type ) { #>
+                                        <label for="attachment-details-two-column-caption" class="name"><?php esc_html_e( 'Image Caption' ); ?></label>
+                                        <# } else { #>
+                                        <label for="attachment-details-two-column-caption" class="name"><?php esc_html_e( 'Short Description' ); ?></label>
+                                        <# } #>
                                         <textarea id="attachment-details-two-column-caption" {{ maybeReadOnly }}>{{ data.caption }}</textarea>
                                 </span>
@@ -797 +801 @@
                 <# } #>
                 <span class="setting" data-setting="caption">
-                        <label for="attachment-details-caption" class="name"><?php _e( 'Caption' ); ?></label>
+                        <# if ( 'image' === data.type ) { #>
+                        <label for="attachment-details-caption" class="name"><?php esc_html_e( 'Image Caption' ); ?></label>
+                        <# } else { #>
+                        <label for="attachment-details-caption" class="name"><?php esc_html_e( 'Short Description' ); ?></label>
+                        <# } #>
                         <textarea id="attachment-details-caption" {{ maybeReadOnly }}>{{ data.caption }}</textarea>
                 </span>