---
title: "post_type_archive_title – カスタム投稿タイプのアーカイブページタイトルを出力する関数"
canonical_url: "https://olein-design.com/blog/post_type_archive_title"
language: "ja"
date_published: "2024-05-11T11:38:39+09:00"
date_modified: "2024-05-11T11:38:39+09:00"
content_type: "post"
author: "久野晃司"
taxonomies:
  category:
    - "WordPress"
  post_tag:
    - "General Template Tag"
    - "WordPress functions"
---

# post_type_archive_title – カスタム投稿タイプのアーカイブページタイトルを出力する関数

このページでは、カスタム投稿タイプのアーカイブページタイトルを出力する `post_type_archive_title()` 関数について詳しく紹介します。

目次

## post_type_archive_title() 関数とは

`archive.php` と `archive-{$post_type}.php` のテンプレートファイル（要するにアーカイブ関係のテンプレート）でカスタム投稿タイプのタイトルを表示するために最適化されています。

## パラメーター

| `$prefix` | カスタム投稿タイプタイトルの前に出力したいものを設定 |
| --- | --- |
| `$display` | 表示するかどうかを設定 |

## 使い方

一般的にはアーカイブを表示するテンプレートに設置することが多いでしょう。

```
post_type_archive_title();
```

出力するタイトルの前に挿入する文言などを設定することができます。

```
post_type_archive_title( 'カスタム投稿タイプタイトル：');
```

## フック

### post_type_archive_title

```
apply_filters( ‘post_type_archive_title’, string $post_type_name, string $post_type )
```

第一引数に `post_type_name` 、第二引数に `$post_type` にフィルターすることができます。

以下のコードで値を確認することができます。

```
add_filter(
	'post_type_archive_title',
	function ( $post_type_name, $post_type ) {
		echo '<hr>' . basename(__FILE__) . ' :: ' . __LINE__;
		echo( '<pre>' );
		var_dump( $post_type_name, $post_type );
		echo( '</pre>' );
		echo '<hr>';

		return $post_type_name;
	},
	10,
	2
);
```

## まとめ

WordPress テーマ開発において、カスタム投稿タイプに対応することは多くあるでしょう。その際には、当然アーカイブページも用意するでしょうし、そこで使われる関数が今回紹介した `post_type_archive_title()` 関数です。ぜひしっかり確認しておきましょう。

[埋め込みコンテンツ](https://developer.wordpress.org/reference/functions/post_type_archive_title)