2024年06月14日
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 ) )
上記で重要なキーは下記になります。
キー | 内容 |
'url' | イメージのURL |
'thumbnail_url' | サムネールイメージのURL(URLと同一) |
事例
①ヘッダー画像が登録されていたら画像を表示します。
<?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をエスケープ処理をしてから表示しています。
関連情報
関連関数は テーマのカスタマイズ関連関数 を参照してください。