ワードプレスのthe_modified_dateフィルタの使用方法・解説

概要

the_modified_dateフィルタは、投稿データの更新日時を表示するために使用されます。このフィルタは、特に以下のような機能を実装する際によく使われます。

1. 投稿の最終更新日時をカスタマイズして表示する
2. フォーマットを変更して日付を見やすくする
3. 投稿日と更新日時を区別して表示する
4. サイトのスタイルに合わせて日付の表示スタイルを変更する
5. 特定の条件に基づいて日付を変化させる
6. 言語による日付の表記を調整する
7. 日付を国際化するための追加情報を付与する
8. 日付にアイコンやテキストを追加して視覚的に強調する

構文

add_filter( 'the_modified_date', 'callback_function', 10, 3 );

パラメータ

• string $the_modified_date – フィルタの適用対象である、投稿の更新日時の文字列。
• string $d – 日付フォーマット。
• int $post – 投稿ID。

戻り値

フィルタを適用した後の更新日時の文字列。

関連する関数

the_modified_date

使用可能なバージョン

このフィルタは、WordPress 1.5以降で使用可能です。

ワードプレスのコアファイルのパス

wp-includes/post-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('the_modified_date', 'custom_modified_date');
function custom_modified_date($the_modified_date) {
    return '最終更新: ' . $the_modified_date;
}

このコードは、投稿の更新日時に「最終更新: 」というプレフィックスを付け加えます。

サンプルコード2: フォーマット指定の日付表示

add_filter('the_modified_date', 'format_modified_date', 10, 2);
function format_modified_date($the_modified_date, $d) {
    return date_i18n('Y年n月j日', strtotime($the_modified_date));
}

このコードは、更新日時を「YYYY年MM月DD日」形式で表示します。

サンプルコード3: 投稿IDの取得と条件分岐処理

add_filter('the_modified_date', 'conditional_modified_date', 10, 3);
function conditional_modified_date($the_modified_date, $d, $post) {
    if ($post == 42) {
        return '特別更新: ' . $the_modified_date;
    }
    return $the_modified_date;
}

このコードは、特定の投稿ID（42）の場合のみ「特別更新: 」というフレーズを付加します。

サンプルコード4: 国際化対応の日付

add_filter('the_modified_date', 'internationalized_modified_date', 10, 2);
function internationalized_modified_date($the_modified_date, $d) {
    return translate($the_modified_date, 'text-domain');
}

このコードは、更新日時を国際化された形式で表示します。

サンプルコード5: アイコンの追加

add_filter('the_modified_date', 'iconified_modified_date');
function iconified_modified_date($the_modified_date) {
    return '<i class="fas fa-clock"></i> ' . $the_modified_date;
}

このコードは、Font Awesomeの時計アイコンを更新日時の前に追加します。