概要
the_modified_author フィルタは、WordPressの投稿やページの更新者名を表示するために使用されます。このフィルタを使うことで、表示される更新者名を変更することができます。主に以下の機能を実装する際に利用されます:
- 更新者名のフォーマットを変更する
- 特定の条件に基づいて異なる更新者名を表示する
- 更新者名に追加情報を付加する(例:役職名)
- マルチサイト環境でのユーザー名をカスタマイズする
- 異なる言語やロケールに合わせた名前の表示
- 特定のユーザーグループの表示名を変更する
- セキュリティのための匿名化処理
- プラグインやテーマに依存しない独自の更新者名ロジックの実装
構文
add_filter('the_modified_author', 'custom_modified_author');
パラメータ
$data(string): 現在の更新者名。
戻り値
- (string): フィルタを通した後の更新者名。
関連する関数
https://refwp.com/?titleonly=1&s=the_modified_author
使用可能なバージョン
the_modified_author フィルタは、WordPress 2.1.0 以降で利用可能です。
コアファイルのパス
wp-includes/post.php
サンプルコード
サンプル1: 更新者名を大文字に変換
このサンプルコードは、投稿の更新者名をすべて大文字に変換して表示します。
add_filter('the_modified_author', 'uppercase_modified_author');
function uppercase_modified_author($author) {
return strtoupper($author);
}
サンプル2: 更新者名に役職を追加
このコードでは、更新者名の後に役職を追加して表示します。
add_filter('the_modified_author', 'append_role_to_author');
function append_role_to_author($author) {
$role = 'Editor'; // 役職名を設定
return $author . ' (' . $role . ')';
}
サンプル3: 特定のユーザーの更新者名を非表示
このサンプルでは、特定のユーザーの更新者名を非表示にします。
add_filter('the_modified_author', 'hide_specific_author');
function hide_specific_author($author) {
if ($author === 'confidential_user') {
return '匿名';
}
return $author;
}
サンプル4: 更新者名をカスタムフィールドから取得
このコードは、投稿のカスタムフィールドから更新者名を取得して表示します。
add_filter('the_modified_author', 'get_author_from_custom_field');
function get_author_from_custom_field($author) {
$custom_author = get_post_meta(get_the_ID(), 'custom_author', true);
return $custom_author ? $custom_author : $author;
}
サンプル5: お知らせ表示を追加
このサンプルは、更新者名の前に「更新者は次の通りです」と表示します。
add_filter('the_modified_author', 'add_notice_to_author');
function add_notice_to_author($author) {
return '更新者は次の通りです: ' . $author;
}
この関数のアクションでの使用可能性
| アクション | 使用例 |
|---|---|
| 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 |
非推奨または削除されたバージョン
このフィルタは、特定のWordPressバージョンで非推奨または削除されていません。