トラブルシューティング

テーマの使用中に発生しうる問題と解決方法をまとめています。

デザイン・レイアウトの問題

問題 原因 解決方法
カラーテーマを変更してもデザインが反映されない ブラウザキャッシュが残っている ブラウザのキャッシュをクリアするか、「開発者設定」のキャッシュバスティングを有効にしてください。キャッシュプラグインを使用している場合はプラグインのキャッシュもクリアしてください。
サイドバーが表示されない 1カラムまたはフルワイドレイアウトが選択されている 「レイアウト設定」で2カラムまたは3カラムを選択してください。投稿タイプ別の設定で「継承」以外が選択されている場合もあります。また、個別投稿のレイアウトメタボックスで上書きされている可能性も確認してください。
メインビジュアルが表示されない 複数の原因が考えられます 以下を順に確認してください: (1) 投稿のアイキャッチ画像が設定されているか (2)「メインビジュアル設定」で表示が有効になっているか (3) 個別モードの場合、該当する投稿タイプで有効になっているか (4) 投稿の編集画面でメインビジュアル表示が「非表示」に上書きされていないか
サブディレクトリ別のデザインが適用されない パスの設定が間違っている 「サブディレクトリ別ロゴ」セクションのパスがURLパスと一致しているか確認してください（例: /blog/ → パスは blog）。先頭・末尾のスラッシュは不要です。
スティッキーヘッダーが動作しない 設定が無効になっている、またはJavaScriptエラー 「レイアウト設定」でスティッキーヘッダーが有効になっているか確認してください。ブラウザの開発者ツール（F12）でJavaScriptエラーがないかも確認してください。カスタムJS注入のコードにエラーがあると動作しない場合があります。
スクロールトップボタンが見えない 設定が無効、またはページ内容が短い 「レイアウト設定」でスクロールトップボタンが有効になっているか確認してください。ページの内容がビューポートより短い場合はスクロールが発生しないため表示されません。
モバイルでデスクトップメニューが表示されない モバイルメニュー非表示ブレークポイントが設定されている 「メニュー」セクションの「モバイルメニュー非表示ブレークポイント」を確認してください。「モバイル（767px）」や「タブレット（1279px）」が選択されている場合、該当幅以下でデスクトップメニューが非表示になります。ハンバーガーメニュープラグインとの併用を想定した機能です。

フロントページの問題

問題 原因 解決方法
カスタムフロントページが表示されない フロントページモードが「既存のページを使用」になっている 「フロントページ設定」で「カスタムフロントページを使用」を選択してください。
フロントページのセクションが表示されない セクションが無効になっている 各リストセクション/個別セクションの「有効」チェックボックスがオンになっているか確認してください。また、セクション順序コントロールでセクションが配置されているかも確認してください。
フロントページの説明文が空 取得元の設定が不一致 説明文の取得元が「手動入力」の場合はWYSIWYGエディターに内容を入力してください。「ページから取得」の場合はソースページが選択されているか確認してください。
ヒーロー画像が表示されない 画像が未設定 「フロントページ設定」のヒーロー画像でメディアライブラリから画像を選択してください。推奨サイズは1920×800px以上です。

SEO・メタ情報の問題

問題 原因 解決方法
メタディスクリプションが二重に出力される SEOプラグインとテーマの両方がメタディスクリプションを出力している カスタマイザーの「記事メタ情報設定」→「メタディスクリプション自動生成」を手動で無効化してください。テーマにはSEOプラグインの自動検知機能はないため、手動での切り替えが必要です。
JSON-LDが出力されない カスタムヘッダーコードの入力形式に問題がある 投稿編集画面の「カスタムヘッダーコード」メタボックスに <script type="application/ld+json"> タグを含む完全なJSON-LD形式で入力されているか確認してください。JSONの構文が正しいことを Google リッチリザルトテスト で検証できます。
メタキーワードが出力されない 設定が無効になっている 「記事メタ情報設定」→「メタキーワード自動生成」が有効になっているか確認してください。
旧形式のページネーションURL（/page/2/）でアクセスできない リダイレクトが正常に動作していない パーマリンク設定を一度「変更を保存」してリライトルールを再生成してください（「設定」→「パーマリンク」→「変更を保存」）。
/tag/ や /category/ ルートページが404になる リライトルールが登録されていない パーマリンク設定を一度「変更を保存」してリライトルールを再生成してください。テーマを再有効化することでも修正されます。

カスタムJS/CSSの問題

問題 原因 解決方法
カスタムJS/CSSが動作しない 構文エラーまたはキャッシュの影響 ブラウザの開発者ツール（F12）でConsoleタブのエラーを確認してください。キャッシュをクリアし、「有効」チェックボックスがオンになっていることも確認してください。
カスタムJS/CSSの入力欄が表示されない 権限が不足している カスタムJS/CSSの入力には unfiltered_html 権限が必要です。通常は管理者ロールに付与されています。マルチサイトの場合はスーパー管理者のみが利用可能です。
投稿タイプ別JS/CSSがアーカイブページで適用されない 仕様による制限 投稿タイプ別のJS/CSSはシングルページ（個別投稿/固定ページの表示）でのみ適用されます。アーカイブページ（一覧ページ）には全体共通JS/CSSを使用してください。

プラグインとの互換性

SEOプラグイン

テーマは一般的なSEOプラグイン（Yoast SEO、All in One SEO、Rank Math等）との共存を想定しています。SEOプラグインを使用する場合は、カスタマイザーの「記事メタ情報設定」から「メタディスクリプション自動生成」および「メタキーワード自動生成」を手動で無効化してください。

テーマの「カスタムヘッダーコード」機能とSEOプラグインの構造化データ出力を併用する場合、同じタイプのJSON-LD（例: Article Schema）が重複しないように注意してください。重複はGoogle Search Consoleでエラーとして報告されます。

キャッシュプラグイン

WP Super Cache、W3 Total Cache、LiteSpeed Cache等のキャッシュプラグインと併用できます。カスタマイザーで設定を変更した後はキャッシュをクリアしてください。キャッシュプラグインの「HTMLの最小化」機能がJSON-LDの出力を壊す場合があるため、問題が発生した場合はJSON-LD出力の最小化対象からの除外を検討してください。

ページビルダー

Elementor、Beaver Builder等のページビルダーは、テーマのレイアウト設定と干渉する場合があります。

フォームプラグイン

Contact Form 7、WPForms等のフォームプラグインと併用できます。「フォーム表示設定」セクションの設定がフォームプラグインの入力フィールドにも適用されます。フォームプラグイン独自のスタイルと競合する場合は、フォーム表示設定の値を0（ブラウザデフォルト）に設定してください。

パフォーマンスに関する注意

動作要件

項目 要件
WordPress5.0 以上
PHP7.2 以上
推奨ブラウザChrome、Firefox、Safari、Edge の最新版

テーマのファイル構成

ディレクトリ/ファイル 内容 主要ファイル
style.cssテーマ情報ヘッダー-
functions.phpテーマの機能定義・フック登録・テーマサポート宣言-
inc/customizer/カスタマイザーの設定ファイル群design-settings.php, layout-settings.php, hero-image-settings.php, archive-settings.php, post-meta-settings.php, front-page-settings.php, custom-js-settings.php, custom-css-settings.php, subdirectory-*.php 等
inc/utilities/ヘルパー関数群core-utilities.php（メタディスクリプション、ページネーション）, hero-image-utilities.php 等
inc/meta-boxes/投稿編集画面のメタボックスcustom-schema-meta.php（カスタムヘッダーコード）, hero-image-meta.php, layout-meta.php
inc/color-themes/カラーテーマのJSONファイル44種類のJSON（天体名×ライト/ダーク）
template-parts/テンプレートパーツhero-image.php, front-page-custom.php, sections/（ヒーロー, リスト, 個別, フリーコンテンツ）
css/CSSアセット（27ファイル）base.css, layouts.css, responsive.css, hero-image-styles.css, front-page-sections.css, archive-grid.css 等
js/JavaScriptアセット（17ファイル）customizer-*.js（9ファイル）, search-popup-simple.js, subdirectory-*.js 等

デバッグ方法

HTMLソースの確認

メタディスクリプションやJSON-LDの出力を確認するには、ブラウザでページを表示し、右クリック→「ページのソースを表示」で <head> 内を確認してください。

カスタマイザー設定値の確認

テーマの設定値はWordPressの theme_mods として保存されています。問題の切り分けにはブラウザの開発者ツール（F12）のConsoleタブで以下を実行することで現在の設定値を確認できます。

テーマの再有効化

設定が正しいにもかかわらず問題が発生する場合、テーマを一度別のテーマに切り替えてから再度有効化することで、リライトルールやキャッシュがリセットされます。カスタマイザーの設定値は保持されます。

サポート

テーマに関する問題や質問は、GitHubリポジトリのIssuesページで受け付けています。

報告時に記載してほしい情報