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

説明

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

パラメータ

$post

（投稿 ID またはオブジェクト） （必須） ギャラリーのある投稿。

初期値： なし

戻り値

(array) 

画像URLの多次元配列

使用法

<?php  $galleries = get_post_galleries_images( $post ); ?>

使用例

少なくとも1つのギャラリーを載せた投稿またはページに画像の直 URL を追加するシンプルな例を示します。

 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;

 	// 投稿にあるすべての投稿を読み出す。
 	$galleries = get_post_galleries_images( $post );

	$image_list = '<ul>';

	// 読み出された全てのギャラリーに対してループを実行
	foreach( $galleries as $gallery ) {

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

			$image_list .= '<li>' . $image . '</li>';

		}

	}

	$image_list .= '</ul>';

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

 	return $content;

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

改訂履歴

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

ソースファイル

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

関連項目

get_post_galleries(), get_post_gallery_images()

最新英語版： WordPress Codex » Function Reference/get post galleries images （最新版との差分）

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