概要
comment_form_titleフィルタは、WordPressのコメント投稿フォームのタイトルを表示する際に使用されるフィルタです。このフィルタを使用することで、デフォルトのタイトルをカスタマイズしたり、特定の条件に基づいてタイトルを変更することが可能です。主な機能としては、以下のような場面で活用されます：
- 特定の投稿タイプやページに応じたコメントタイトルの変更
- コメント欄のタイトルにカスタムメッセージを追加
- 投稿の人気度によるタイトルのダイナミックな変更
- ユーザーの役割に基づいたカスタムタイトル
- スパム防止のための警告メッセージの追加
- 複数言語対応のためのタイトル変換
- SEOの最適化を目的としたタイトルの変更
- 短期間のイベントに合わせたタイトルの更新
構文
apply_filters( 'comment_form_title', $title, $id );
パラメータ
$title(文字列) – 現在のタイトル。$id(整数) – コメント対象の投稿ID。
戻り値
- 変更されたタイトル (文字列)。
関連する関数
使用可能なバージョン
- このフィルタは、WordPress 2.7.0以降で使用可能です。
コアファイルのパス
wp-includes/comment-template.php
サンプルコード
サンプルコード1: コメントのタイトルをカスタマイズする
function my_custom_comment_title( $title, $id ) {
return 'カスタムタイトル: ' . get_the_title($id);
}
add_filter( 'comment_form_title', 'my_custom_comment_title', 10, 2 );
このコードは、コメントタイトルを投稿のタイトルに基づいてカスタマイズします。
サンプルコード2: 特定のページでタイトルを変更する
function change_comment_title_on_specific_page( $title, $id ) {
if ( is_page( 'contact' ) ) {
return 'お問合せに対するコメント';
}
return $title;
}
add_filter( 'comment_form_title', 'change_comment_title_on_specific_page', 10, 2 );
このコードは、特定の「contact」ページでコメントタイトルを変更します。
サンプルコード3: ログインユーザーに特別なタイトルを表示
function custom_title_for_logged_in_users( $title, $id ) {
if ( is_user_logged_in() ) {
return 'あなたのコメントをお待ちしています！';
}
return $title;
}
add_filter( 'comment_form_title', 'custom_title_for_logged_in_users', 10, 2 );
このコードは、ログインユーザーに特別なコメントタイトルを表示します。
サンプルコード4: 言語に応じたタイトルの変更
function language_based_comment_title( $title, $id ) {
if ( get_locale() == 'jp' ) {
return 'コメントを追加する';
}
return $title;
}
add_filter( 'comment_form_title', 'language_based_comment_title', 10, 2 );
このコードは、ロケールに基づいてコメントタイトルを日本語に変更します。
サンプルコード5: SEOフレンドリーなタイトルに変更
function seo_friendly_comment_title( $title, $id ) {
return 'あなたの意見をお聞かせください！ - ' . get_the_title($id);
}
add_filter( 'comment_form_title', 'seo_friendly_comment_title', 10, 2 );
このコードは、SEOを意識したフレンドリーなコメントタイトルを生成します。
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| 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 |
非推奨または削除されたバージョン
- 現在のところ、
comment_form_titleフィルタは特定のバージョンで非推奨や削除されていません。