Skip to content

Update documentation for gallery_style and use_default_gallery_style filters #12060

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
sabernhardt wants to merge 5 commits into from
+11 −1
Closed

Update documentation for gallery_style and use_default_gallery_style filters #12060

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
52a3f01
Update documentation for `gallery_style` and `use_default_gallery_sty…
sabernhardt Jun 2, 2026
c6614f7
Fix version number
sabernhardt Jun 2, 2026
732754f
Emphasize the more important change from r46164
sabernhardt Jun 2, 2026
ef0cf02
Merge branch 'trunk' into gallery-style-docs
westonruter Jun 3, 2026
7f73d73
Improve formatting of code block
westonruter Jun 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion src/wp-includes/media.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2885,6 +2885,7 @@ function gallery_shortcode( $attr ) {
* Filters whether to print default gallery styles.
*
* @since 3.1.0
* @since 3.9.0 Set the default to false when the theme supports HTML5 galleries.
*
* @param bool $print Whether to print default gallery styles.
* Defaults to false if the theme supports HTML5 galleries.
Expand Down Expand Up @@ -2916,9 +2917,18 @@ function gallery_shortcode( $attr ) {
$gallery_div = "<div id='$selector' class='gallery galleryid-{$id} gallery-columns-{$columns} gallery-size-{$size_class}'>";

/**
* Filters the default gallery shortcode CSS styles.
* Filters the gallery shortcode's default CSS styles and opening HTML div container.
*
* To remove the CSS entirely, use the `use_default_gallery_style` filter instead:
*
* add_filter( 'use_default_gallery_style', '__return_false' );
*
* @since 2.5.0
* @since 3.1.0 Added classes for number of columns and size to opening div.
* @since 5.3.0 Removed the `type` attribute for `style` tags when the theme
* supports HTML5 style, and changed the quotes from single to
* double for other themes.
* @since 7.0.0 Removed the `type` attribute for any theme.
*
* @param string $gallery_style Default CSS styles and opening HTML div container
* for the gallery shortcode output.
Expand Down
Loading