トラブルシューティング
Kashiwazaki SEO Media Control の使用中に発生しうる問題と対処法、動作要件、技術仕様について解説します。
よくある問題と対処法
所有者変更が反映されない
| 考えられる原因 | 対処法 |
|---|---|
| AJAX通信がブロックされている | ブラウザのコンソールでJavaScriptエラーがないか確認してください。セキュリティプラグインがAJAXリクエストをブロックしている可能性があります。 |
| ユーザー権限が不足している | 管理者権限でログインしていることを確認してください。所有者変更は管理者のみが実行できます。 |
| nonce検証の失敗 | ページを再読み込みしてから再度操作してください。セッションが切れている可能性があります。 |
メディア一覧が表示されない
| 考えられる原因 | 対処法 |
|---|---|
| プラグインが有効化されていない | 管理画面の「プラグイン」一覧で、本プラグインが有効になっていることを確認してください。 |
| メディアファイルが存在しない | メディアライブラリにファイルがアップロードされていることを確認してください。 |
| JavaScriptの読み込みエラー | 他のプラグインとのJavaScript競合がないか確認してください。他のプラグインを一時的に無効化してテストしてください。 |
フィルターが動作しない
| 考えられる原因 | 対処法 |
|---|---|
| AJAX通信の失敗 | ブラウザの開発者ツールの「ネットワーク」タブでAJAXリクエストのステータスを確認してください。 |
| JavaScriptの競合 | 他のプラグインのJavaScriptと競合している可能性があります。他のプラグインを一時的に無効化してテストしてください。 |
一括所有者変更で一部のファイルが変更されない
| 考えられる原因 | 対処法 |
|---|---|
| 処理中にタイムアウトが発生 | 大量のファイルを一度に変更する場合、PHPの実行時間制限に達する可能性があります。少ない数ずつ分けて実行してください。 |
| 対象ファイルの権限問題 | データベースの書き込み権限に問題がないか確認してください。 |
ヒント
問題が解決しない場合は、一度プラグインを無効化してから再有効化してみてください。設定値はデータベースに保持されるため、再有効化後も設定は維持されます。
動作要件
| 項目 | 要件 |
|---|---|
| WordPress | 5.0 以上 |
| PHP | 7.4 以上 |
| 対応ブラウザ | Chrome、Firefox、Safari、Edge（最新版） |
技術仕様
- データ保存: wp_posts (attachment)
- カスタムテーブル: なし
- 外部通信: なし
- Cronイベント: なし
- メール送信: なし
- セキュリティ: nonce検証、権限チェック
アーキテクチャ
Kashiwazaki SEO Media Control は以下のコンポーネントで構成されています。
フロントエンド
- フロントエンド出力は一切なし（JSON-LD、メタタグ、CSS、JavaScriptなし）
- サイトの表示速度やCore Web Vitalsに影響を与えない
バックエンド
- メディアの所有者情報は
wp_postsテーブルのpost_authorフィールドで管理 - 管理画面アセット: CSS（6.3KB）、JavaScript（19KB）
- AJAXによるフィルタリング、個別・一括所有者変更を非同期処理
- すべてのAJAXリクエストにnonce検証を実施
所有者変更フロー
1
管理者がメディア管理画面で対象ファイルを選択し、新しい所有者を指定します。
2
JavaScriptがAJAXリクエストをWordPressのadmin-ajaxエンドポイントに送信します。
3
サーバー側でnonce検証と権限チェックを行い、wp_posts テーブルの post_author を更新します。
4
更新結果がAJAXレスポンスとして返され、画面が自動的にリフレッシュされます。
補足
カスタムテーブルやCronイベントは使用しないため、プラグインの削除時にデータベースに不要なデータが残ることはありません。所有者情報は wp_posts テーブルの標準フィールドを利用しているため、プラグイン削除後もデータは維持されます。