コード:ダッシュボードに「更新」ボタンを足す
サイト全体の「最終更新日」を、自分の好きなときに変えたいことがあります。
このコードを functions.php に追加すると、ダッシュボードに「更新」ボタンの枠が出ます。ボタンを押した日時が保存され、ページに出せるようになります。
/*----------------------------------------------------
ダッシュボードの「更新」ボタンを押した日時を保存して、ページに表示する
----------------------------------------------------*/
const MY_MANUAL_UPDATE_OPTION = 'my_manual_update_time';
// 保存した日時を、好きな形で返す(まだ押していなければ空)
function my_get_manual_update( $format = 'Y/m/d' ) {
$time = (int) get_option( MY_MANUAL_UPDATE_OPTION, 0 );
return $time ? wp_date( $format, $time ) : '';
}
// ダッシュボードに枠を足す(設定を変えられる人だけ)
function my_manual_update_widget_setup() {
if ( current_user_can( 'manage_options' ) ) {
wp_add_dashboard_widget( 'my_manual_update', '更新日表示用', 'my_manual_update_widget' );
}
}
add_action( 'wp_dashboard_setup', 'my_manual_update_widget_setup' );
// 枠の内容:admin-post.php に送るフォーム
function my_manual_update_widget() {
$now = my_get_manual_update( 'Y/m/d H:i' );
echo '<form method="post" action="' . esc_url( admin_url( 'admin-post.php' ) ) . '">';
echo '<input type="hidden" name="action" value="my_manual_update">';
wp_nonce_field( 'my_manual_update' );
echo '<p><button type="submit" class="button button-primary">更新</button> ';
echo esc_html( $now ? '最終更新 : ' . $now : 'まだ押していません' ) . '</p>';
echo '</form>';
}
// 保存:権限と nonce を確認してから、今の日時を保存してダッシュボードに戻す
function my_manual_update_save() {
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( '権限がありません。', 403 );
}
check_admin_referer( 'my_manual_update' );
update_option( MY_MANUAL_UPDATE_OPTION, time(), false );
wp_safe_redirect( admin_url( 'index.php' ) );
exit;
}
add_action( 'admin_post_my_manual_update', 'my_manual_update_save' );
| 書き方 | 役目 |
|---|---|
| get_option()・update_option() | 押した日時を、サイトの設定(オプション)に 1 つだけ保存する |
| time() で保存して wp_date() で出す | 保存は世界共通の時刻。出すときにサイトの時間帯(日本なら日本時間)に直す |
current_user_can( 'manage_options' ) |
管理者だけに枠を出し、管理者だけが保存できる |
| wp_nonce_field()・check_admin_referer() | ほかのサイトから勝手にフォームを送られても、保存しない |
| admin-post.php と admin_post_ のフック | このフォームが送られたときだけ、保存の処理が動く |
| wp_safe_redirect() で戻る | 保存のあとダッシュボードに戻る。再読み込みしても、もう一度送られない |
| esc_html() | 画面に出す文字の決まりの書き方 |

ページに最終更新日を出す
<?php if ( my_get_manual_update() ) : ?> <p class="last-update">最終更新 : <?php echo esc_html( my_get_manual_update() ); ?></p> <?php endif; ?>
出したいところに書くだけで表示できます。ボタンをまだ押していないときは、何も出ません。
| 書き方 | 出る文字の例 |
|---|---|
| my_get_manual_update() | 2026/10/11 |
my_get_manual_update( 'Y年n月j日' ) |
2026年10月11日 |
my_get_manual_update( 'Y/m/d H:i' ) |
2026/10/11 18:20 |
my_get_manual_update( 'YmdHis' ) |
20261011182008(下の CSS で使う) |
上の画像は前のバージョンの画面です。今のコードでも、同じように「更新」ボタンと最終更新の日時が出ます。
同じ日時で CSS のキャッシュを消す
style.css?ver=20261011182008
ブラウザは、一度読んだ CSS をしばらく取っておきます。CSS を直しても、見ている人の画面がすぐに変わらないことがあります。
CSS の URL の後ろに、ボタンを押した日時を付けておくと、押すたびに URL が変わり、ブラウザが新しい CSS を読み直します。CSS を直したら「更新」ボタンを押すだけです。
function my_enqueue_style() {
$ver = my_get_manual_update( 'YmdHis' );
wp_enqueue_style( 'my-style', get_stylesheet_uri(), array(), $ver ? $ver : false );
}
add_action( 'wp_enqueue_scripts', 'my_enqueue_style' );
| 書き方 | 役目 |
|---|---|
| wp_enqueue_style() の 4 つ目 | CSS の URL の ?ver= に入る値。ここに押した日時を設定する |
| $ver ? $ver : false | まだ押していないときは、WordPress の決まりの値(WordPress のバージョン)にする |
| wp_enqueue_scripts のフック | ページの CSS を読み込むときに動かす |
前のバージョンでは、キャッシュ用に別の枠(下の画像)を作っていました。今のコードでは、1 つのボタンで最終更新日と CSS の両方が変わります。分けたいときは、オプションの名前と関数をもう 1 組作ります。
ver が外れるときと、ファイルの日時を使うやり方
WordPress のバージョンを隠すために、URL の ?ver= を外すプラグインやコードがあります。このサイトの作業環境でも外れていました。そのときは、URL に自分で date を付けます。
// ver を外すプラグインやコードを使っているとき:URL に date を付ける
function my_enqueue_style() {
wp_enqueue_style( 'my-style', add_query_arg( 'date', my_get_manual_update( 'YmdHis' ), get_stylesheet_uri() ), array(), null );
}
add_action( 'wp_enqueue_scripts', 'my_enqueue_style' );
// ボタンを押さなくてもよいとき:ファイルを保存した日時を使う
function my_enqueue_style_mtime() {
$file = get_stylesheet_directory() . '/style.css';
wp_enqueue_style( 'my-style', get_stylesheet_uri(), array(), (string) filemtime( $file ) );
}
// 使うのは、上の my_enqueue_style とこれのどちらか 1 つだけ
// add_action( 'wp_enqueue_scripts', 'my_enqueue_style_mtime' );
上の「同じ日時で CSS のキャッシュを消す」のコードと、ここのコードは、どちらも my_enqueue_style という同じ名前の関数です。両方を functions.php に書くと、Fatal error でサイトが表示されなくなるので、どちらか 1 つだけにします。
テーマの header.php に CSS を直接書いているときは、href の後ろに ?date=<?php echo esc_attr( my_get_manual_update( 'YmdHis' ) ); ?> を付けます。
前の書き方との違い
| ところ | 前の書き方 | 今の書き方 |
|---|---|---|
| 保存の処理 | admin_init で、POST に date_update_flag=1 があれば保存していた。admin-ajax.php はログインしていなくても admin_init を動かすので、だれでも日付を変えられた | admin-post.php で、管理者で nonce が正しいときだけ保存する |
| 枠が出る人 | ダッシュボードを見られる人全員 | 管理者だけ |
| 保存する場所 | ユーザー ID 1 のユーザーの情報。ID 1 のユーザーを消すと、値も消える | サイトの設定(オプション) |
| 保存したあと | 同じ画面のまま。再読み込みでもう一度送られた | ダッシュボードに戻る |
| CSS の例の version_num() | 有料テーマにある関数で、ほかのテーマでは「関数がない」エラーで止まる | 使わない |
| function_exists() の囲み | 1 つの名前だけを調べて、ほかの関数をまとめて作っていた | my_ を付けた名前にして、囲まない |
確認した結果
このサイトの作業環境(WordPress 7.1.3・PHP 8.3)で、上のコードを読み込んで試しました。試しのユーザーと保存した値は、終わったあとに消しました。
| 試したこと | 結果 |
|---|---|
| 前の書き方:ログインなしで date_update_flag=1 を送る | 保存された(2026/10/11) |
| ログインなしで保存を送る | 403「権限がありません。」で止まった |
| 購読者で保存を送る | 403 で止まった。ダッシュボードに枠も出ない |
| 管理者・nonce なし/まちがった nonce | 403「辿ったリンクは期限が切れています。」で止まり、保存されない |
| 管理者・正しい nonce | 保存されて、ダッシュボードに戻った |
| 表示(押す前/押したあと) | 空/2026/10/11(日本時間) |
| CSS の ?ver= | style.css?ver=20261011182008 になった。ver を外すコードがあると外れた |
| CSS の ?date= | ver を外すコードがあっても style.css?date=20261011182008 のまま残った |


