• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/get post gallery images

提供: WordPress Codex 日本語版
移動先: 案内検索

投稿に追加された1つまたは複数のギャラリーのうち、最初のギャラリーにある画像の URL を配列として読み出す関数です。

パラメータ

$post
投稿 ID またはオブジェクト) (必須) ギャラリーのある投稿。
初期値: なし

戻り値

(array) 
画像URLの多次元配列

使用法

<?php  $gallery = get_post_gallery_images( $post ); ?>

使用例

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.

 function pw_show_gallery_image_urls( $content ) {

 	global $post;

 	// is_single()、is_page() 、is_attachment() いづれかのシングルページに対してのみ実行。
 	if( ! is_singular() )
 		return $content;

 	// 投稿にギャラリーが載っていることを確認。
 	if( ! has_shortcode( $post->post_content, 'gallery' ) )
 		return $content;

  	// 投稿にある最初の投稿を読み出す。
 	$gallery = get_post_gallery_images( $post );

	$image_list = '<ul>';

	// ギャラリーの各イメージに対してループを実行
        foreach( $gallery as $image_url ) {

        $image_list .= '<li>' . '<img src="' . $image_url . '">' . '</li>';

	}

	$image_list .= '</ul>';

	// 投稿に画像リストを挿入
	$content .= $image_list;

 	return $content;

 }
 add_filter( 'the_content', 'pw_show_gallery_image_urls' );

改訂履歴

  • 3.6.0 にて導入されました。

ソースファイル

get_post_gallery_images()wp-includes/media.php にあります。

get_post_gallery(), get_post_galleries(), get_post_galleries_images()

投稿フォーマット: set_post_format(), get_post_format(), has_post_format(), the_post_format_audio() /en, get_the_post_format_media() /en, get_content_audio() /en, the_post_format_chat() /en, get_the_post_format_chat() /en, get_content_chat() /en, add_chat_detection_format() /en, the_post_format_gallery() /en, get_content_galleries() /en, get_post_gallery_images(), the_post_format_image() /en, get_the_post_format_image() /en, get_content_images() /en, the_post_format_quote() /en, get_the_post_format_quote() /en, get_content_quote() /en, the_post_format_url() /en, get_the_post_format_url() /en, get_content_url() /en, the_post_format_video() /en, get_content_video() /en, the_remaining_content() /en, get_the_remaining_content() /en, get_post_format_meta() /en, post_format_content_class() /en, get_post_format_content_class() /en, post_formats_compat() /en


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/get post gallery images最新版との差分

この記事は翻訳時に編集が必要であるとマークされていました。その為Codex原文が大きく編集されている可能性があります。内容を確認される際は原文を参照していただき、可能であれば本項目へ反映させてください。よりよいCodexを作成するためのお手伝いをお願いします。