Make WordPress Core

Opened 8 years ago

Last modified 4 years ago

#36270 new enhancement

Allow filtering of the final HTML output of media related shortcodes

Reported by: gnotaras's profile gnotaras Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version: 4.7.2
Component: Media Keywords: needs-patch
Focuses: Cc:


Sometimes it is required to further process the final HTML output of the media related shortcodes, eg caption or gallery, so as to add extra HTML code such as enclosing div or span elements or just modify the existing HTML code during run time.

For instance the final output of img_caption_shortcode could be filtered:

Passing all relevant image attachment data, like ID and size, would also be very useful.

I hope that I am not missing anything but right now the only way to insert code inside the <figure> or <figcaption> block seems to be the complete override of the img_caption_shortcode function.

Change History (5)

#1 @SergeyBiryukov
8 years ago

  • Component changed from General to Media

Related: #14130, #20230, #29832.

Last edited 8 years ago by SergeyBiryukov (previous) (diff)

#2 @obenland
8 years ago

  • Type changed from defect (bug) to enhancement
  • Version trunk deleted

#3 @desrosj
7 years ago

  • Keywords needs-patch added
  • Version set to 4.7.2

#4 @mlchaves
4 years ago


I created a filter to allow caption customisation. Here's the Gist.

This Gist has two screen grabs.

  1. Gallery with the media attachment title and caption displayed using default formatting.
  2. Gallery with the media attachment title, caption, and description using a styled H4 captiontag .

I'd like to submit a pull request if you feel this is worthy.

Thanks for your time!

#5 @mlchaves
4 years ago


I developed the Gallery Image Captions (GIC) plugin that allows caption customisations.

With GIC, you can write a filter to modify, style, and even add attachment meta to the WordPress gallery caption.

Note: See TracTickets for help on using tickets.