概要
single_cat_titleフィルタは、WordPressのカテゴリーアーカイブページで表示されるカテゴリー名をカスタマイズするために使用されます。このフィルタを使用することで、デフォルトのカテゴリー名を変更したり、特定の条件に基づいて異なる表示を行ったりすることができます。
このフィルタの主な用途として、以下のような状況があります：
- カテゴリー名の前後にテキストを追加したい。
- 特定のカテゴリーに応じて異なるタイトルを表示したい。
- 表示されるカテゴリー名のフォーマットを変更したい。
- カテゴリー名を翻訳する際にカスタマイズを行いたい。
- タイトルにSEO向けのキーワードを追加したい。
- 定期的なイベントのためにタイトルを動的に変更したい。
- カスタムフィールドの値を利用してタイトルを生成したい。
- 親カテゴリーの名前に基づいて子カテゴリーのタイトルを変更したい。
構文
add_filter( 'single_cat_title', 'your_custom_function' );
パラメータ
$title(string): デフォルトのカテゴリー名。
戻り値
- (string) 変更されたカテゴリー名。
関連する関数
使用可能なバージョン
- そのフィルタは、WordPress 1.5以降で利用可能です。
コアファイルのパス
/wp-includes/category-template.php
この関数のアクションでの使用可能性
| アクション | 使用可能 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | 〇 |
| template_redirect | |
| get_header | |
| wp_head |
サンプルコード
サンプル 1: カテゴリー名の前にテキストを追加
add_filter( 'single_cat_title', function( $title ) {
return 'カテゴリー: ' . $title;
});
このサンプルコードは、カテゴリー名の前に「カテゴリー: 」というテキストを追加します。
サンプル 2: 特定のカテゴリー名を変更
add_filter( 'single_cat_title', function( $title ) {
if ( is_category( '特定のスラッグ' ) ) {
return 'カスタムタイトル';
}
return $title;
});
このサンプルコードは、特定のカテゴリーの場合にタイトルを「カスタムタイトル」に変更します。
サンプル 3: カテゴリー名を大文字に変換
add_filter( 'single_cat_title', function( $title ) {
return strtoupper( $title );
});
このサンプルコードは、カテゴリー名を全て大文字に変換します。
サンプル 4: SEO向けのキーワードを追加
add_filter( 'single_cat_title', function( $title ) {
return $title . ' – SEO対応';
});
このサンプルコードは、カテゴリー名の後ろに「 – SEO対応」を追加します。
サンプル 5: カテゴリー名を翻訳
add_filter( 'single_cat_title', function( $title ) {
return __( $title, 'text-domain' );
});
このサンプルコードは、カテゴリー名を翻訳用の関数を使って表示します。