Question

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

---

参数

$post

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

---

返回值

(array) A list of a gallery's image srcs in order.

---

源代码

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'];
}

---

更新日志

Version	description
3.6.0	Introduced.

---

相关函数

Uses

• wp-includes/media.php: get_post_gallery()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   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;
    }