概要
single_month_titleフィルタは、WordPressの月アーカイブページにおいて、特定の月のタイトルを表示するために使用されます。このフィルタを用いることで、月アーカイブのタイトルをカスタマイズすることができます。例えば、タイトルのフォーマットを変更したり、特定の条件に応じて追加のテキストを挿入したりすることが可能です。
このフィルタは以下のような機能を実装する際によく使われます。
- 月名をカスタマイズする
- 年月をフォーマット指定で整形する
- 特定のイベントに基づいてタイトルを変更する
- 言語設定に応じてタイトルを翻訳する
- デザインに基づいてタイトルのスタイルを変更する
- SEO対策として特定キーワードを強調表示する
- ユーザーの役に立つ情報をタイトルに追加する
- フロントエンドでのユーザー体験を向上させる
構文
add_filter('single_month_title', 'custom_single_month_title', 10, 2);
パラメータ
$title: 生成された月のタイトル$month: 操作対象の月（数値、1から12）
戻り値
フィルタにより変更されたタイトルを返します。
関連する関数
使用可能なバージョン
このフィルタはWordPressのバージョン2.5以降から使用可能です。
コアファイルのパス
wp-includes/theme.php
サンプルコード
サンプル1: 月名を変更する
add_filter('single_month_title', function($title) {
return str_replace('January', 'Jan', $title);
});
このサンプルコードは、アーカイブページで表示される「January」を「Jan」に置き換えます。
サンプル2: 年月をフォーマット指定で整形する
add_filter('single_month_title', function($title, $month) {
return date('F Y', strtotime("first day of +{$month} month"));
}, 10, 2);
このコードは、表示される月のタイトルを「月 年」の形式に変更します。
サンプル3: 特定の条件に基づいてタイトルを変更する
add_filter('single_month_title', function($title, $month) {
if ($month == 12) {
return 'Holiday Season - ' . $title;
}
return $title;
}, 10, 2);
このサンプルは、12月の場合に「Holiday Season – 」をタイトルに追加します。
サンプル4: SEO対策としてキーワードを追加
add_filter('single_month_title', function($title) {
return $title . ' - Your Monthly Updates';
});
アーカイブタイトルの後ろに「- Your Monthly Updates」を追加し、SEO効果を狙います。
サンプル5: 言語設定に応じてタイトルを翻訳
add_filter('single_month_title', function($title) {
return (get_locale() == 'ja') ? '月: ' . $title : $title;
});
日本語の言語設定の場合に、タイトルの前に「月: 」を挿入します。
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| 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 |