トラブルシューティング

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

ショートコードが展開されない

原因	対処法
プラグインが無効	「プラグイン」一覧で Kashiwazaki SEO Code Snippet Shortcode が有効化されているか確認してください
IDの指定ミス	ショートコードの`id`属性に正しいスニペットIDが指定されているか確認してください。All Snippets画面でIDを確認できます
スニペットが下書き状態	対象スニペットが「公開」状態になっているか確認してください。下書き状態のスニペットはフロントエンドで展開されません
ショートコード未対応エリア	使用場所がショートコードに対応しているか確認してください。一部のテーマやウィジェットでは`do_shortcode`が適用されない場合があります

原因	対処法
プラグインが無効	プラグインが有効化されているか確認してください
クラシックエディタ使用中	Gutenbergブロックはブロックエディタ専用です。クラシックエディタではショートコードを直接入力してください
JavaScriptエラー	ブラウザの開発者ツール（Console）でJSエラーがないか確認してください。他プラグインとの競合の可能性があります

原因	対処法
ルール設定ミス	Settings画面で自動挿入ルールの条件（投稿タイプ、カテゴリ等）が正しく設定されているか確認してください
対象スニペットが未公開	自動挿入対象のスニペットが「公開」状態であるか確認してください
キャッシュ	キャッシュプラグインやCDNのキャッシュをクリアしてください

原因	対処法
スキャン未実行	Usage画面でスキャンを実行してください。使用状況データはスキャン時に更新されます
AJAXエラー	ブラウザの開発者ツール（Console、Network）でAJAXリクエストが正しく処理されているか確認してください
大量の投稿	投稿数が非常に多い場合、スキャンに時間がかかることがあります。完了するまでお待ちください

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

プラグインを無効化しても、wp_optionsに保存された設定データとカスタム投稿タイプ（kscss_snippet）のデータは残ります。ただし、ショートコードが展開されなくなるため、フロントエンドではショートコードのテキストがそのまま表示される場合があります。

はい。スニペットの内容を変更すると、そのスニペットを使用しているすべてのページに変更が反映されます。これが一元管理の利点です。ただし、キャッシュプラグインを使用している場合はキャッシュクリアが必要です。

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

注意

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