トラブルシューティング
Kashiwazaki SEO Published & Last Updated Dates の使用中に発生しうる問題と対処法、動作要件、技術仕様について解説します。
よくある問題と対処法
日付が表示されない
| 考えられる原因 | 対処法 |
|---|---|
| プラグインが有効化されていない | 管理画面の「プラグイン」一覧で、本プラグインが有効になっていることを確認してください。 |
| 該当の投稿タイプが無効になっている | 設定画面で表示対象の投稿タイプが有効になっているか確認してください。 |
| JavaScriptエラーが発生している | ブラウザの開発者ツール（F12）でコンソールエラーを確認してください。他のプラグインやテーマのJSとの競合が原因の場合があります。 |
| キャッシュプラグインが古い出力を表示している | キャッシュプラグインのキャッシュをクリアしてください。 |
日付のスタイルが崩れる
| 考えられる原因 | 対処法 |
|---|---|
| テーマのCSSとの競合 | カスタムHTML要素はShadow DOMでスタイルをカプセル化していますが、一部のテーマではグローバルスタイルが影響する場合があります。設定画面で色・フォントを調整してください。 |
| ブラウザがカスタム要素をサポートしていない | カスタムHTML要素はIE11ではサポートされません。モダンブラウザ（Chrome、Firefox、Safari、Edge）で確認してください。 |
JSON-LDが出力されない
| 考えられる原因 | 対処法 |
|---|---|
テーマが wp_head() を呼び出していない |
テーマの header.php に <?php wp_head(); ?> が記述されていることを確認してください。 |
| 他のプラグインがJSON-LDを上書きしている | 他のSEOプラグインのJSON-LD出力と重複がないか確認してください。 |
更新日が表示されない（公開日のみ表示される）
| 考えられる原因 | 対処法 |
|---|---|
| 投稿が一度も更新されていない | 公開後に一度も編集・更新されていない投稿では、更新日が公開日と同一のため表示が省略される場合があります。 |
| 更新日の表示設定が無効 | 設定画面で「更新日の表示」が有効になっているか確認してください。 |
ヒント
問題が解決しない場合は、一度プラグインを無効化してから再有効化してみてください。設定値はデータベースに保持されるため、再有効化後も設定は維持されます。
動作要件
| 項目 | 要件 |
|---|---|
| WordPress | 5.0 以上 |
| PHP | 7.4 以上 |
| 対応ブラウザ | Chrome、Firefox、Safari、Edge（最新版） |
技術仕様
- データ保存: wp_options (ksplud_settings)
- カスタムテーブル: なし
- 外部通信: なし
- Cronイベント: なし
- メール送信: なし
- フロントエンド: CSS 8.4KB、JS 5.4KB（カスタム要素定義）
アーキテクチャ
Kashiwazaki SEO Published & Last Updated Dates は以下のコンポーネントで構成されています。
フロントエンド
- カスタムHTML要素
<ksplud-date>で日付を表示（Shadow DOMでスタイルカプセル化） - CSS（8.4KB）で4種類のデザインパターンを実装
- JavaScript（5.4KB）でカスタム要素の定義と初期化を実行
- DigitalDocument + CreateAction/UpdateAction JSON-LD を
<head>内にインライン出力
バックエンド
- 設定データは
wp_optionsテーブルにksplud_settingsキーで保存 the_contentフィルターを使用してコンテンツの前後に日付要素を挿入- 投稿タイプごとの表示制御はバックエンドで処理
日付表示フロー
1
the_content フィルターで投稿コンテンツの出力時に処理が呼び出されます。
2
現在の投稿タイプが表示対象かどうかを確認します。対象外の場合はそのままコンテンツを返します。
3
投稿の公開日・更新日を取得し、設定に基づいて <ksplud-date> カスタム要素を生成します。
4
設定された表示位置（前・後・前後）に応じてカスタム要素をコンテンツに挿入します。
5
同時に wp_head アクションで DigitalDocument + CreateAction/UpdateAction のJSON-LDを出力します。
補足
カスタムテーブルやCronイベントは使用しないため、プラグインの削除時にデータベースに不要なデータが残ることはありません。wp_options の設定値のみが削除対象です。