カスタム投稿タイプの記事を表示するテンプレートファイルの作成【WordPress】

アーカイブページ（カスタム投稿の記事一覧）へのリンク方法

投稿した記事が一覧で表示されるページを「アーカイブページ」と言います。
私は以前カスタム投稿タイプを作成したものの、アーカイブページへのリンクの貼り方が分からず困っていました。

しかもURLはパーマリンク設定により異なるため、リンク先URLをテンプレートファイルに直接書いたのではパーマリンク設定を変更した際にURLも変更されてしまいリンク切れとなってしまいます。

WordPressのパーマリンク設定に左右されずアーカイブページのURLを取得するには下記のようにします。

アーカイブページの適切なURLを取得してリンクする

<a href="<?php echo esc_url( get_post_type_archive_link( '投稿タイプスラッグ' ) ); ?>">
  <?php echo esc_html( get_post_type_object( '投稿タイプスラッグ' )->label ); ?> 
</a>

1行目：get_post_type_archive_link()でアーカイブページのURLを取得。
2行目：get_post_type_object()で投稿タイプの情報を取得し、その中からラベルを指定して表示します。

参考リンク
WordPress Codex – get_post_type_archive_link()
WordPress Code – get_post_type_object()

カスタム投稿タイプの表示に使われるテンプレートファイル

アーカイブページで使用されるテンプレートファイル

前述の手順で制作したリンク先がカスタム投稿タイプのアーカイブページ（記事一覧ページ）となります。ページの表示に使われるテンプレートファイルは下記の優先順位で参照されます。

archive-{投稿タイプ名}.php が無ければ archive.php、それも無ければ index.php といった具合です。
一覧表示をカスタマイズする際はこれらのテンプレートファイルを編集します。

1. archive-{投稿タイプ名}.php
2. archive.php
3. index.php

archive-{投稿タイプ名}.phpは指定したカスタム投稿タイプの専用テンプレートとなり、archive.phpは専用テンプレートが無い場合の一覧表示に汎用的に使用されます。

他のアーカイブページと共通でよい場合はarchive-{投稿タイプ名}.phpは無くても構いません。任意のカスタム投稿タイプアーカイブのみレイアウトを変えたいとき等にarchive-{投稿タイプ名}.phpを利用すると便利です。

投稿の単独ページで使用されるテンプレートファイル

投稿単独ページのテンプレートは下記の優先順位で使用されます。
任意のカスタム投稿タイプ専用のテンプレートが必要な場合はsingle-{投稿タイプ名}.phpを用意してください。single-{投稿タイプ名}.phpを用意しない場合は他の汎用テンプレートで表示されます。

1. single-{投稿タイプ名}.php
2. single.php
3. singular.php
4. index.php

サイドバー等に設置するカスタム投稿一覧ブロックの作成

固定ページの一部やサイドバーの一部等、独立したブロックとして表示する方法です。
いくつか手段がありますが、今回はWP_Query()で条件を指定して該当する投稿を抽出します。応用しやすいので私もよく使っている方法になります。

<?php
$q = new WP_Query(
	array(
		'post_type'      => '投稿タイプスラッグ',
		'posts_per_page' => -1,
	)
);
if ( $q->have_posts() ) :
	echo '<ul>';
	while ( $q->have_posts() ) :
		$q->the_post();
		?>
	<li><a href="<?php the_permalink(); ?>"><?php the_title_attribute(); ?></a></li>
		<?php
	endwhile;
	echo '</ul>';
	wp_reset_postdata();
endif;
?>

4行目：表示したいカスタム投稿タイプスラッグを指定します。
5行目：posts_per_pageは表示数を指定します。-1は全て表示となります。

参考リンク
WordPress Codex – WP_Query()

---