Ticket #38100: 38100.diff

src/wp-includes/media.php

@@ -1792 +1792 @@
                         <{$icontag} class='gallery-icon {$orientation}'>
                                 $image_output
                         </{$icontag}>";
-                if ( $captiontag && trim($attachment->post_excerpt) ) {
+                if ( $captiontag && trim( $attachment->post_excerpt ) ) {
+                        /**
+                         * Filters the gallery attachments caption.
+                         *
+                         * Filter that can be used for extend, edit, reformat and etc. the caption of certain attachment in a gallery.
+                         * The filter "id" argument gives you the opportunity to select specific attachment in the gallery.
+                         *
+                         * @since 5.1
+                         *
+                         * @param string        $attachment->post_excerpt       Contains the caption value entered via the media library.
+                         * @param int           $id                                             Contains the post ID of the attachment.
+                         */
+                        $gallery_caption = wptexturize( apply_filters( 'gallery_caption', $attachment->post_excerpt, $id ) );
+
                         $output .= "
                                 <{$captiontag} class='wp-caption-text gallery-caption' id='$selector-$id'>
-                                " . wptexturize($attachment->post_excerpt) . "
+                                " . $gallery_caption . "
                                 </{$captiontag}>";
                 }
                 $output .= "</{$itemtag}>";