トラブルシューティング

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

コピーボタンが表示されない

原因	対処法
プラグインが無効	「プラグイン」一覧で Kashiwazaki SEO Code Clipper が有効化されているか確認してください
対象モードの設定ミス	設定ページで対象モード（preのみ/codeのみ/両方/CSSクラス指定）が正しく設定されているか確認してください
CSSクラスモードの設定	CSSクラス指定モードの場合、対象要素に指定したクラスが付与されているか確認してください
JavaScriptエラー	ブラウザの開発者ツール（Console）でJSエラーがないか確認してください。他プラグインとの競合の可能性があります
キャッシュ	キャッシュプラグインやCDNのキャッシュをクリアしてください

原因	対処法
HTTP環境	Clipboard APIはHTTPS環境が必要です（localhostを除く）。サイトをHTTPSに移行してください
ブラウザの権限	ブラウザがクリップボードへのアクセスを許可しているか確認してください
JS読み込みエラー	開発者ツールのNetworkタブで、フロントエンドJS（31.2KB）が正しく読み込まれているか確認してください

原因	対処法
言語の自動検出失敗	コードの内容が少ない場合や特殊な言語の場合、自動検出に失敗することがあります。code要素に`language-*`クラスを手動で付与してください
ラベル表示が無効	設定ページで言語ラベル表示が有効になっているか確認してください
テーマのCSS競合	テーマのCSSがラベルのスタイルを上書きしている可能性があります。開発者ツールで確認してください

原因	対処法
REST APIのエラー	開発者ツールのNetworkタブで`kscc/v1/track-copy`へのリクエストが成功しているか確認してください
パーマリンク設定	REST APIを使用するため、パーマリンク設定が「基本」以外に設定されている必要があります
セキュリティプラグイン	WAFやセキュリティプラグインがREST APIリクエストをブロックしている可能性があります

検証方法

REST APIの動作を確認するには、ブラウザの開発者ツールのNetworkタブを開いた状態でコピーボタンをクリックし、kscc/v1/track-copyへのPOSTリクエストのステータスコードを確認してください。

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

プラグインを無効化しても、wp_optionsに保存された設定データ（kscc_options）は残ります。コピーボタンとラベルはプラグインが無効化されると表示されなくなりますが、コードブロック自体には影響しません。

CSSクラス指定モードを使用すると、特定のクラスを持つコードブロックにのみコピーボタンを表示できます。ページ単位での制御が必要な場合は、CSSクラスモードの活用を検討してください。

いいえ。本プラグインは外部HTTP通信、Cronジョブ、メール送信を行いません。REST API（kscc/v1/track-copy）はWordPress内部のエンドポイントであり、外部サーバーへの通信ではありません。

注意

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