post_type_archive_title()

post_type_archive_title()の用途

post_type_archive_title() は、WordPressでカスタム投稿タイプ（post_type）のアーカイブページタイトルを表示するためのテンプレートタグです。この関数は、特に「投稿タイプアーカイブページ」で使用され、該当する投稿タイプの「名前（ラベル）」を取得して出力します。

post_type_archive_title()の使用方法

post_type_archive_title( string $prefix = '', bool $display = true )

post_type_archive_title()のパラメータ

post_type_archive_title()の返り値

• $display が false の場合、**投稿タイプのアーカイブタイトル（ラベル名）**が文字列で返されます。
• $display が true の場合は、**画面上にそのまま出力（echo）**され、返り値は null になります。

post_type_archive_title()の使い方の例

タイトルを直接出力する場合（通常）

<h1><?php post_type_archive_title(); ?></h1>

プレフィックス付きで出力する

<h1><?php post_type_archive_title( '一覧：' ); ?></h1>

→ 例: 「一覧：イベント」

取得だけしてカスタム処理したい場合

<?php
$title = post_type_archive_title( '', false );
echo '<h1 class="archive-title">' . esc_html( $title ) . '</h1>';
?>

post_type_archive_title()はいつ使う？

• archive-{post_type}.php（カスタム投稿タイプのアーカイブテンプレート）で使うケースが最も多いです。
• 通常の is_post_type_archive() チェックとセットで使うこともあります。

<?php if ( is_post_type_archive() ) : ?>
  <h1><?php post_type_archive_title(); ?></h1>
<?php endif; ?>

post_type_archive_title()の注意点

• カスタム投稿タイプ登録時に 'has_archive' => true を設定していないと使えません。
• 投稿タイプの labels 配列内の 'name' を元にタイトルが生成されます。

post_type_archive_title()と似た関数との比較