トラブルシューティング

Kashiwazaki SEO Related Posts の使用中に発生しうる問題と対処法、動作要件、技術仕様について解説します。

よくある問題と対処法

関連記事が表示されない

考えられる原因 対処法
プラグインが有効化されていない 管理画面の「プラグイン」一覧で、本プラグインが有効になっていることを確認してください。
OpenAI APIキーが未設定 設定画面でOpenAI APIキーが正しく入力されているか確認してください。
AI分析がまだ実行されていない 投稿に対するAI類似度分析が未実行の場合、関連記事は表示されません。設定画面から分析を実行してください。
投稿個別設定で非表示になっている 投稿編集画面のメタボックスで「関連記事を非表示」が有効になっていないか確認してください。
キャッシュプラグインが古い出力を表示している キャッシュプラグインのキャッシュをクリアしてください。

OpenAI APIエラーが発生する

考えられる原因 対処法
APIキーが無効または期限切れ OpenAI Platform でAPIキーのステータスを確認してください。
APIの利用上限に達している OpenAIアカウントの利用上限を確認してください。必要に応じて上限を引き上げてください。
サーバーの外部通信が制限されている ホスティング環境で wp_remote_post による外部HTTPリクエストが許可されているか確認してください。
OpenAIサービスが一時的にダウンしている OpenAI Status でサービス状況を確認し、復旧後に再試行してください。

関連記事のスタイルが崩れる

考えられる原因 対処法
テーマのCSSとの競合 ブラウザの開発者ツールで、テーマのCSSが関連記事のスタイルを上書きしていないか確認してください。
他のプラグインのCSS/JSとの競合 他のプラグインを一時的に無効にして、競合の原因を特定してください。
スライダーが正しく動作しない JavaScriptエラーがないか確認してください。jQueryの競合が原因の場合があります。

AI分析の結果が不適切

考えられる原因 対処法
投稿数が少なすぎる 関連記事の精度は投稿数に依存します。十分な数の投稿がサイトに存在することを確認してください。
キャッシュが古い 設定画面の「キャッシュクリア」ボタンでキャッシュを削除し、AI分析を再実行してください。
特定の投稿で不適切な結果 投稿個別設定のメタボックスから、手動で関連記事を選択してAI提案を上書きしてください。
ヒント

問題が解決しない場合は、一度プラグインを無効化してから再有効化してみてください。設定値はデータベースに保持されるため、再有効化後も設定は維持されます。

動作要件

項目 要件
WordPress 5.0 以上
PHP 7.4 以上
OpenAI APIキー AI関連記事機能を使用する場合は必須
対応ブラウザ Chrome、Firefox、Safari、Edge（最新版）

技術仕様

アーキテクチャ

Kashiwazaki SEO Related Posts は以下のコンポーネントで構成されています。

フロントエンド

バックエンド

AI分析フロー

1

管理画面またはAJAXリクエストからAI分析が開始されます。

2

投稿のタイトル・本文・カテゴリ情報を収集し、OpenAI APIに wp_remote_post で送信します。

3

GPTが記事間の類似度をスコアリングし、関連度の高い記事を特定します。

4

分析結果をTransientキャッシュに保存し、次回以降のアクセスではキャッシュからデータを返します。

5

フロントエンドで設定に基づいた表示形式・カラーテーマで関連記事を描画します。

補足

カスタムテーブルやCronイベントは使用しないため、プラグインの削除時にデータベースに不要なデータが残ることはありません。wp_options の設定値、post_meta、Transient キャッシュのみが削除対象です。