WP関数：get_uploaded_header_images()

この関数の説明

WP関数の get_uploaded_header_images() は、[外観→カスタマイズ]の[ヘッダ画像]の中に登録した画像を連想配列で取り出す関数です。

※ヘッダ画像をスライドさせる場合は、この関数を使います。

関数

get_uploaded_header_images()

オプション

ありません

返り値

連想配列で、画像情報が返されます。

下記は、2つの画像が設定された事例です。

Array
(
    [4344] => Array
        (
            [attachment_id] => 4344
            [url] => https://school.t-spirits.com/wp-content/uploads/2020/12/cropped-86-3.jpg
            [thumbnail_url] => https://school.t-spirits.com/wp-content/uploads/2020/12/cropped-86-3.jpg
            [alt_text] => 
            [attachment_parent] => 444
            [width] => 959
            [height] => 323
        )

    [4346] => Array
        (
            [attachment_id] => 4346
            [url] => https://school.t-spirits.com/wp-content/uploads/2020/12/cropped-crown.jpg
            [thumbnail_url] => https://school.t-spirits.com/wp-content/uploads/2020/12/cropped-crown.jpg
            [alt_text] => 
            [attachment_parent] => 451
            [width] => 905
            [height] => 300
        )

)

上記で重要なキーは下記になります。

事例

①ヘッダー画像が登録されていたら画像を表示します。

<?php if(has_header_image()):?><!-- ヘッダ画像が設定されている場合 -->
	<div id='top_slide'>
		<?php foreach (get_uploaded_header_images() as $key => $value): ?>
			<img src='<?php echo esc_url($value['url']);?> 'width="100%">
		<?php endforeach;?>
	</div>
<?php endif;?>

■画像のURLはURLをエスケープ処理をしてから表示しています。

関連情報

関連関数は テーマのカスタマイズ関連関数 を参照してください。