get_post_gallery_images() - WordPress 函数参考中文文档

返回介绍

get_post_gallery_images()

发布于 2017-09-10 字数2487 浏览 847 评论 0

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


描述


参数

$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 描述
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;
     }
    
    

上一篇:get_post_gallery()

下一篇:get_post_meta()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!