カスタム投稿タイプのアーカイブページにアイキャッチ画像を表示するカスタマイズ方法

カスタム投稿タイプのアーカイブ（一覧）ページのヘッダーにアイキャッチ画像を表示するカスタマイズ方法について紹介します。

このページは上級者向けマニュアルです。

自作のプラグインや子テーマを使ってPHPでカスタマイズする内容が含まれます。

WordPress勉強中の方は知らない単語や関数などを調べながらカスタマイズにチャレンジしてみてください。

※このカスタマイズにはyStandard v4.16.0以上が必要になります。

カスタム投稿タイプのアーカイブページにアイキャッチ画像を表示する

カスタム投稿タイプの一覧ページにアイキャッチ画像を表示するサンプルコードです▼

// 投稿タイプ「manual」の一覧ページにアイキャッチ画像を表示する.
add_filter(
	'ys_get_header_post_thumbnail',
	function ( $thumbnail ) {
		// カスタム投稿タイプのアーカイブページの場合に画像(img)タグを返す.
		if( is_post_type_archive( 'manual' ) ) {
			return '<img src="[画像URL]" alt="[画像alt]" />';
		}
		// 変更しない場合はnullを返す.
		return null;
	}
);

フィルターフックys_get_header_post_thumbnailを使い、カスタム投稿タイプアーカイブページの時に画像タグを返すと、ヘッダーアイキャッチ画像を表示するためのHTML等を生成します。

※「[画像URL]」「[画像alt]」は適宜変更してください。