WordPress のダッシュボードに「更新」ボタンを足して、押した日を最終更新日として表示する:同じ日時で CSS のキャッシュも消す

WordPress 6.4.3
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

概要説明

記事を直していなくても、ダッシュボードの「更新」ボタンを押した日をページの最終更新日に出す functions.php のコード。同じ日時を CSS の ?ver= に使えば、ブラウザのキャッシュも消せます。ログインなしでも保存できた前の書き方の問題も直し、作業環境で試した結果つきで。

コード:ダッシュボードに「更新」ボタンを足す

サイト全体の「最終更新日」を、自分の好きなときに変えたいことがあります。

このコードを functions.php に追加すると、ダッシュボードに「更新」ボタンの枠が出ます。ボタンを押した日時が保存され、ページに出せるようになります。

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() 画面に出す文字の決まりの書き方
WordPress のダッシュボードに「更新」ボタンを足して、押した日を最終更新日として表示する:同じ日時で CSS のキャッシュも消す

ページに最終更新日を出す

テーマのテンプレート(出したいところ)
<?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 を直したら「更新」ボタンを押すだけです。

functions.php
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 を付けます。

functions.php
// 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 のまま残った
WordPress のダッシュボードに「更新」ボタンを足して、押した日を最終更新日として表示する:同じ日時で CSS のキャッシュも消す

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。