トラブルシューティング

Kashiwazaki SEO Headline Generator の使用中に発生する可能性のある問題と、その対処方法をまとめています。

見出し分析が表示されない

原因	対処法
プラグインが無効	「プラグイン」一覧で Kashiwazaki SEO Headline Generator が有効化されているか確認してください
JavaScriptエラー	ブラウザの開発者ツール（Console）でJSエラーがないか確認してください。他プラグインとの競合の可能性があります
管理画面JS未読込	開発者ツールのNetworkタブで管理画面JS（32KB）が正しく読み込まれているか確認してください
投稿タイプ非対応	カスタム投稿タイプを使用している場合、見出し分析の対象になっているか設定を確認してください

原因	対処法
TOC自動挿入が無効	設定ページで「目次の自動挿入」が有効になっているか確認してください
見出しが少ない	記事内に対象レベルの見出しが一定数以上存在しない場合、TOCが生成されないことがあります
キャッシュ	キャッシュプラグインやCDNのキャッシュをクリアしてください
テーマとの競合	テーマが独自のTOC機能を持っている場合、競合する可能性があります。どちらか一方を無効にしてください

原因	対処法
自動ID付与が無効	設定ページで「見出し自動ID付与」が有効になっているか確認してください
the_contentフィルタ未適用	テーマが`the_content`フィルタを適用していない場所に見出しがある場合、IDは付与されません
他プラグインとの競合	他のTOCプラグインやID付与プラグインと競合している場合、一方を無効にしてください

原因	対処法
機能が無効	設定ページでカニバリゼーション検出が有効になっているか確認してください
AJAXエラー	ブラウザの開発者ツール（Console、Network）でAJAXリクエストが正しく処理されているか確認してください
タイムアウト	投稿数が非常に多い場合、スキャンがタイムアウトする場合があります。PHPの`max_execution_time`を確認してください
セキュリティプラグイン	WAFやセキュリティプラグインがAJAXリクエストをブロックしている可能性があります

検証方法

カニバリゼーション検出のスキャンが失敗する場合、ブラウザの開発者ツールのNetworkタブでadmin-ajax.phpへのリクエストとレスポンスを確認してください。

原因	対処法
権限不足	設定の変更には`manage_options`権限（管理者）が必要です。現在のユーザーの権限を確認してください
nonce検証エラー	セッションが切れている可能性があります。ページをリロードして再度保存してください
セキュリティプラグイン	WAFやセキュリティプラグインがPOSTリクエストをブロックしている可能性があります。一時的に無効化して確認してください

プラグインを無効化しても、wp_optionsに保存された設定データ（kashiwazaki_seo_headline_options）は残ります。見出しのIDと目次はプラグインが無効化されると出力されなくなりますが、記事の見出し自体には影響しません。

技術的には併用可能ですが、目次が重複して表示される場合があります。他のTOCプラグインを使用している場合は、本プラグインの目次自動挿入機能を無効にし、見出し分析・カニバリゼーション検出のみを使用することを推奨します。

いいえ。本プラグインは外部HTTP通信、Cronジョブ、メール送信を行いません。AJAXハンドラ（2件）はWordPress内部のadmin-ajax.phpを使用しており、外部サーバーへの通信ではありません。

注意

問題が解決しない場合は、WordPress本体（5.0以上）・PHP（7.4以上）・テーマのバージョンが要件を満たしているか確認してください。また、他プラグインとの競合を確認するため、プラグインを1つずつ無効化して問題の切り分けを行ってください。