---
title: "single_cat_title() &#8211; カテゴリーアーカイブタイトルを出力・表示する関数"
canonical_url: "https://olein-design.com/blog/single_cat_title"
language: "ja"
date_published: "2024-05-12T08:30:08+09:00"
date_modified: "2024-05-12T08:43:12+09:00"
content_type: "post"
author: "久野晃司"
taxonomies:
  category:
    - "WordPress"
  post_tag:
    - "General Template Tag"
    - "WordPress functions"
---

# single_cat_title() &#8211; カテゴリーアーカイブタイトルを出力・表示する関数

`single_cat_title()` 関数は、カテゴリーアーカイブのページタイトルを表示または取得する関数です。

目次

## single_cat_title() 関数とは

カテゴリーアーカイブページのタイトルを表示するために用意された関数です。カテゴリーテンプレートファイル `category.php` で利用すると便利です。

パラメーターの `$prefix` には自動的にスペースが入らないので、必要であれば任意で調節する必要があります。

## パラメーター

| `$prefix` | タイトルの前に表示したいものを設定 |
| --- | --- |
| `$display` | 出力するかどうかを設定<br>`false` の場合は文字列を返す |

## 使い方

一般的な使い方としては、`category.php` の中で以下にように記述することでアーカイブタイトルを出力できます。

```
single_cat_title();
```

また、タイトルの前に出力したい任意の文言を、第一引数に設定することで表示できます。

```
single_cat_title( 'カテゴリーアーカイブタイトル：' );
```

第二引数に `false` を設定することで値を返します。以下のコードで検証ができます。

```
$single_cat_title = single_cat_title( 'カテゴリーアーカイブタイトル：', false );

echo '<hr>' . basename(__FILE__) . ' :: ' . __LINE__;
echo( '<pre>' );
var_dump( $single_cat_title );
echo( '</pre>' );
echo '<hr>';
```

一部の WordPress 標準テーマの中では、このように使われているケースもありました。

```
printf( __( 'Category Archives: %s', 'twentyfourteen' ), single_cat_title( '', false ) );
```

## フック

ありません。

## まとめ

近年の WordPress 標準テーマでは、あまり活用されてはいないみたいですが、過去には Twenty Twenty-Ten や Twenty Twenty-Twelve、Twenty Fourteen といったテーマの中で活用されていたようです。

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