get_post_galleries_images( int|WP_Post $post )

Retrieve the image srcs from galleries from a post’s content, if present


Description Description

See also See also


Top ↑

Parameters Parameters

$post

(int|WP_Post) (Optional) Post ID or WP_Post object. Default is global $post.


Top ↑

Return Return

(array) A list of lists, each containing image srcs parsed. from an expanded shortcode


Top ↑

Source Source

File: wp-includes/media.php

function get_post_galleries_images( $post = 0 ) {
	$galleries = get_post_galleries( $post, false );
	return wp_list_pluck( $galleries, 'src' );
}

Top ↑

Changelog Changelog

Changelog
Version Description
3.6.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    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 list of image URLs to the content if displaying a post with one or more image galleries.
     *
     * @param string $content Post content.
     * @return string (Maybe modified) post 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 all galleries of this post.
    	$galleries = get_post_galleries_images( $post );
    
    	if ( ! empty( $galleries ) ) {
    		$image_list = '<ul>';
    
    		// Loop through all galleries found
    		foreach( $galleries as $gallery ) {
    			// Loop through each image in each gallery.
    			foreach ( $gallery as $image ) {
    				$image_list .= '<li>' . $image . '</li>';
    			}
    		}
    
    		$image_list .= '</ul>';
    
    		// Append our image list to the content of our post
    		$content .= $image_list;
    	}
    	return $content;
     }
    add_filter( 'the_content', 'wpdocs_show_gallery_image_urls' );
    

You must log in before being able to contribute a note or feedback.