※当サイトの一部記事には広告を含みます。
うさねこ気まぐれPG開発室

【WordPress対応】エオルゼア時間をリアルタイムで表示するショートコード(PHP+CSS)を作成してみた

自作ショートコード実装してみた

ねこちゃん
ねこちゃん

うさちゃんが、とっても便利なファイナルファンタジーXIVブログ内ツールを作ってくれました。

うさちゃん
うさちゃん

今回、うさねこ散歩ブログ内で、エオルゼア時間を表示できるようにしてみました🐰✨
記事表示内では

  • 「ポップアップ型」=下書きページ内のどこか1か所に記載すればOK
  • 「記事内表示型」=時間を表示したい場所に記載

このふたつ。

ねこちゃん
ねこちゃん

よくわかんないけど、とりあえず表示できるんですね?!

うさちゃん
うさちゃん

できるってば😅🌿
ショートコード使用例まとめも書いておいたので、ねこちゃんも少しずつ覚えていこうね~✨
最初は「theme="pink"」とか「animate="pop"」みたいに、気に入ったものだけ覚えればいいから。

エオルゼア時間表示

ショートコード例:ページ内でポップアップ

表示例:画面左上に表示されてホームページスクロールしても追従する

画像はエオルゼア時間が昼の状態での表示例です(theme=”pink”)。
[eorzea_floating_clock
 popup="true"
 popup_position="left"
 format_et="24h"
 format_jt="24h"
 theme="pink"
 mascot="true"
 animate="pop"
 font_size="18px"
 show_on_mobile="true"
]
広告
Nintendo Switch 2(日本語・国内専用)
Nintendo Switch 2(日本語・国内専用)
本商品は、日本語・国内専用商品です。
本体で使用できる言語は「日本語」のみです。
「国/地域」設定が「日本」のニンテンドーアカウントのみ連携できます。
「ニンテンドーeショップ」で購入できるソフトは日本地域を対象にしたソフトのみです。
最新の価格・在庫状況はAmazonでご確認ください。

UsaNeko Eorzea Floating Clock

サーバー時刻同期・ET/JST対応フローティング時計(WordPress用)

本記事では、WordPressに
エオルゼア時間(ET)と日本時間(JST)を同時表示できるフローティング時計
を実装するための仕組みと、実装のポイントをメモとして残しておきます。

本コードは、
👉 実運用で使っている構成をベースに、ポイントだけ抜粋して紹介します。


この時計でできること

  • エオルゼア時間(ET)をリアルタイム表示
  • 日本時間(JST)を同時表示
  • サーバー時刻と同期(閲覧者の端末時計ズレを補正)
  • 昼/夜で配色とアイコンが自動切替
  • 固定表示/インライン表示に対応
  • ショートコードで簡単に設置可能
  • 外部ライブラリ・外部CSSファイルは使用せず、WordPress標準機能のみで実装しています。

実装方針(先に結論)

この時計は、次の考え方で作られています。

  • 1ページに1個置く前提
  • 動作が分かりやすく、トラブルが起きにくい構成
  • WordPress標準機能のみを使用
  • 「高度すぎない」ことを重視

そのため、
ブログ内ツールとして扱いやすく、仕組みも理解しやすい構成にしています。


全体構成

PHPコードは、大きく次の3パートで構成されています。

① CSS(インラインCSSとして登録)
② サーバー時刻取得用 REST API
③ ショートコード(HTML + JavaScript)

広告
Logicool G 8000Hz ガスケットマウント G316 X 98 ゲーミングキーボード 日本語配列 リニア 静音 ホワイト 国内正規品 | 有線 メカニカル ホットスワップ G316X-98-LNWHd LIGHTSYNC RGB ゲーミング キーボード メカニカルキーボード ブラック 黒 PC windows Amazon.co.jp限定 壁紙ダウンロード付き
Logicool G 8000Hz ガスケットマウント G316 X 98 ゲーミングキーボード 日本語配列 リニア 静音 ホワイト 国内正規品 | 有線 メカニカル ホットスワップ G316X-98-LNWHd LIGHTSYNC RGB ゲーミング キーボード メカニカルキーボード ブラック 黒 PC windows Amazon.co.jp限定 壁紙ダウンロード付き
8,000Hzの有線レポートレートを提供、「G316 X 98 ゲーミングキーボード」/瞬時の入力が勝敗を左右するFPSやアクションゲームで圧倒的な反応速度を実現/プレイヤーの素早く正確な操作をダイレクトに反映します
ガスケットマウント構造で快適な打鍵感と静音性を実現/制振層を備えたガスケットマウント構造により、キー入力時の振動やノイズを抑制し、ソフトで安定した打鍵感を提供します
LIGHTSYNC RGB搭載で没入感のあるゲーミング体験/独自のLIGHTSYNC RGBを搭載し、ゲーム内のアクションや操作に合わせたライティング演出を実現 ※「Logicool G HUB」を使用してライティングをカスタマイズできます。
インタラクティブ ドットマトリックス ディスプレイ搭載/本体にドットスタイルのLEDディスプレイが、プレイ中でも各種ステータスを直感的に確認でき、デザイン性と実用性を両立してゲーミング環境を個性的に演出します
ホットスワップ対応メカニカルスイッチで自由なカスタマイズ/キースイッチを自由に交換可能なメカニカルリニアスイッチを採用/ゲームジャンルやプレイスタイルに応じて打鍵感や音をカスタマイズできます
最新の価格・在庫状況はAmazonでご確認ください。

① CSS:時計の見た目を定義

※以下は理解しやすいように要点のみ抜粋しています。

add_action( 'wp_enqueue_scripts', function () {
    wp_register_style( 'usaneko-eorzea-clock', false );
    wp_enqueue_style( 'usaneko-eorzea-clock' );
    wp_add_inline_style( 'usaneko-eorzea-clock', $css );
});

解説

  • 外部CSSファイルは使用しません
  • WordPressの wp_add_inline_style() を使い、CSSを安全に出力
  • テーマやキャッシュ設定の影響を受けにくい構成です

昼夜テーマ切替

  • .day / .night クラスをJavaScript側で制御
  • 配色・文字色・アイコンをET基準で切替

② サーバー時刻取得 REST API

register_rest_route(
  'usaneko/v1',
  '/time',
  array(
    'methods'  => 'GET',
    'callback' => function () {
      return array(
        'server_ms' => (int) round( microtime( true ) * 1000 ),
      );
    },
    'permission_callback' => '__return_true',
  )
);

なぜサーバー時刻を使うのか?

JavaScriptの Date.now() は
👉 閲覧者のPCやスマホの時計に依存します。

そこでこのコードでは、

  1. サーバーの現在時刻を取得
  2. 通信遅延を考慮して補正
  3. クライアント側の時計ズレを吸収

という仕組みを採用しています。

結果として、

どの端末で見ても、ほぼ同じ時刻を表示

できるようになります。


③ ショートコード(HTML + JavaScript)

ショートコード登録

add_shortcode( 'eorzea_floating_clock', 'usaneko_get_eorzea_clock_html' );

記事内では、次のように使えます。

[eorzea_floating_clock]

HTML構造

<div id="usaneko-eorzea-floating-clock">
  <span class="icon">☀️</span>
  <span class="label">Eorzea</span>
  <span id="usaneko-et">--:--</span>
  /
  <span class="label">Japan</span>
  <span id="usaneko-jt">--:--:--</span>
</div>
  • #usaneko-et:エオルゼア時間
  • #usaneko-jt:日本時間
  • ☀️ / 🌙:昼夜状態アイコン

広告
スーパーマリオ 3Dコレクション -CHIP
スーパーマリオ 3Dコレクション -CHIP
3Dマリオの歴史をNintendo Switchで
『スーパーマリオ64』、『スーパーマリオサンシャイン』、『スーパーマリオギャラクシー』。3つの歴代3Dマリオを1本のソフトに収録した『スーパーマリオ 3Dコレクション』がNintendo Switchに登場。グラフィックがHD画質に対応したほか、Nintendo Switchで遊びやすいように、タイトルごとに少しずつリニューアルしています。
本作ではさらに、収録3タイトルのサウンドトラックをゲーム内に収録。「画面オフ再生」にも対応し、思い出BGM全175曲をいつでもどこでも楽しめます。
【本品は、2021年3月末までの期間限定生産となります。】
最新の価格・在庫状況はAmazonでご確認ください。

JavaScriptの仕組み(核心)

エオルゼア時間の計算

ET_RATE = 86400 / 4200;
  • 現実時間 70分 = ET 24時間
  • この比率を使ってET時刻を算出

サーバー時刻との同期

offsetMs = server_ms + (通信時間 / 2) - Date.now();
  • サーバーとクライアントの時刻差を補正
  • 表示は常に Date.now() + offsetMs

更新処理

setInterval(update, 1000);
  • 毎秒 ET / JST を更新
  • 60秒ごとにサーバー時刻を再同期

昼夜の自動切替

(et.hh >= 7 && et.hh < 18) ? "day" : "night";
  • ET基準で昼夜を判定
  • CSSクラスとアイコンを切替

ショートコード属性一覧

属性説明
themegreen / pink / night
positionfixed / inline
top / right / bottom / left固定表示時の位置
format_et24h / 12h
format_jt24h / 12h
mascottrue / false
popuptrue / false
popup_positioncenter / left / right
show_on_mobiletrue / false

※ 仕様はすべて 掲載コードどおり です。


注意点(重要)

  • 1ページに1個のみ設置前提
  • 複数設置するとIDが競合します
  • 高度な最適化(JS遅延・結合)環境では挙動が変わる可能性があります
    (DOM生成タイミングやJavaScript実行順の影響を受けるため)

これは仕様上の割り切りで、プログラミングを学び始めた頃の自分でも管理できるシンプルさを優先しています。
※コードは自由に改変OKですが、複数設置(同一ページに2つ以上)はID競合で動作しないため非推奨です。


免責事項

本記事に掲載しているプログラムは、「うさねこ散歩」による個人のプログラム学習および検証を目的として作成された非公式ファンメイドプログラムです。 『ファイナルファンタジーXIV』は、株式会社スクウェア・エニックスの著作物です。 本ツールの利用により発生したいかなるトラブル・損害についても、作者は一切の責任を負いません。
広告
8番出口・8番のりば -Switch
8番出口・8番のりば -Switch
累計100万本以上のセールスを記録した『8番出口』とその続編『8番のりば』がセットになったパッケージ版が登場!
『8番出口』では、あなたは無限に続く地下通路に閉じ込められている。周囲をよく観察し、「8番出口」まで辿り着こう。
『8番のりば』では、あなたは永遠に走り続ける電車に閉じ込められている。周囲の異変に注意しながら、脱出する方法を見つけよう。
最新の価格・在庫状況はAmazonでご確認ください。

書籍

※本文中に記載の会社名・製品名・サービス名・ゲームタイトル名等は、各社の商標または登録商標であり、権利は各社に帰属します。

※サンプルはテストを行っていますが、すべての環境での動作を保証するものではありません。ご利用は自己責任でお願いいたします。

※本記事の仕様・価格・対応状況等は執筆時点で確認できた情報をもとに掲載しています。最新の情報はメーカー公式サイトをご確認ください。

※当サイトでは一部の記事において、アイキャッチ画像にAI生成を使用しています。

※Amazonのアソシエイトとして、うさねこ散歩は適格販売により収入を得ています。