トラブルシューティング

よくある問題とその解決方法をまとめています。

ショートコードがそのまま表示される

原因: プラグインが無効化されている、またはショートコード名が間違っている

WordPress管理画面の「プラグイン」ページで「Kashiwazaki SEO Dynamic Date」が有効になっているか確認する

ショートコード名が [ksdate] であることを確認する（大文字・スペースに注意）

ブロックエディターの場合、「ショートコード」ブロックまたは「カスタムHTML」ブロックに記述しているか確認する

クラシックエディターでは本文に直接 [ksdate] と記述するだけで動作します。

原因: 無効なフォーマットやオフセット値を指定している

format 属性にPHPの日付フォーマットとして有効な文字列を指定しているか確認する

offset 属性が [+-]数値[ymwd] の形式になっているか確認する（例: +3d, -1m）

diff 属性が YYYY, YYYY-MM, YYYY-MM-DD のいずれかの形式になっているか確認する

管理画面の「プレビュー」タブで同じパラメータを試して正常に出力されるか確認する

エラーが発生した場合、本プラグインはユーザーにエラーメッセージを表示せず空文字を返します。これはフロントエンドの表示を崩さないための仕様です。

この節の出力例は、2026年8月10日に表示した場合の値です。

原因: unit を省略したため、基準日の精度で単位が決まっている

unit を省略した場合、単位は基準日の書き方で決まります。YYYY なら年、YYYY-MM なら月、YYYY-MM-DD なら日です。[ksdate diff="2020-01"] が「79ヶ月」になるのはこのためです。

意図した単位を明示するには unit を指定します（year / month / day）。指定すると数字だけが返るので、単位の文字は投稿側で書きます。例: [ksdate diff="2020-01" unit="year"]年目

「まであと」と書いているのに経過期間が出る場合は、基準日がすでに過去になっています。過去の日付は経過期間、未来の日付は残り期間を返します。

過去は切り捨て、未来は切り上げです。1年11ヶ月経過なら「1年」、あと4ヶ月なら「1年」になります。

単位の一覧と別名はショートコードの使い方で確認できます。

原因: ページキャッシュやCDNキャッシュにより古い日付が表示されている

使用しているキャッシュプラグイン（WP Super Cache、W3 Total Cache等）のキャッシュをクリアする

CDN（Cloudflare等）を使用している場合はCDNのキャッシュもパージする

キャッシュの有効期限を動的日付の更新頻度に合わせて調整する（例: 日付単位の表示なら24時間以内に設定）

ショートコードの日付はサーバーサイドでページ表示時に計算されます。ページ全体がキャッシュされている場合、キャッシュの有効期限まで日付は更新されません。

原因: WordPressのタイムゾーン設定が正しくない

WordPress管理画面の「設定」→「一般」を開く

「タイムゾーン」が正しく設定されているか確認する（日本の場合は Asia/Tokyo または UTC+9）

設定を保存し、ショートコードの出力を再確認する

本プラグインは wp_date() および wp_timezone() を使用しており、WordPressのタイムゾーン設定に従います。

原因: 権限不足またはプラグインの競合

管理者（Administrator）権限でログインしているか確認する（manage_options 権限が必要）

他のプラグインを一時的に無効化し、競合がないか確認する

テーマをデフォルトテーマに切り替えて動作するか確認する

原因: JavaScriptエラーまたはAJAXの問題

ブラウザの開発者ツール（F12）を開き、コンソールにエラーが表示されていないか確認する

jQueryが正しく読み込まれているか確認する

他のプラグインやテーマがJavaScriptエラーを発生させていないか確認する