get_post_gallery_images( int|WP_Post $post )
Checks a post’s content for galleries and return the image srcs for the first found gallery
Description
See also
Parameters
Return
(array) A list of a gallery's image srcs in order.
Source
File: wp-includes/media.php
function get_post_gallery_images( $post = 0 ) {
$gallery = get_post_gallery( $post, false );
return empty( $gallery['src'] ) ? array() : $gallery['src'];
}
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |
Example
A simple example of how to append the raw image URLs to the content of any post or page that has at least one gallery.
add_filter( 'the_content', 'wpdocs_show_gallery_image_urls' ); /** * Show image URLs below the content */ function wpdocs_show_gallery_image_urls( $content ) { global $post; // Only do this on singular items if( ! is_singular() ) return $content; // Make sure the post has a gallery in it if( ! has_shortcode( $post->post_content, 'gallery' ) ) return $content; // Retrieve the first gallery in the post $gallery = get_post_gallery_images( $post ); $image_list = '<ul>'; // Loop through each image in each gallery foreach( $gallery as $image_url ) { $image_list .= '<li>' . '<img src="' . $image_url . '">' . '</li>'; } $image_list .= '</ul>'; // Append our image list to the content of our post $content .= $image_list; return $content; }Expand full source codeCollapse full source code