Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/v24kuon/chatbot/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Gemini File Search Chatbot Plugin
このプラグインは、WordPress 管理画面とウェブページに Google Gemini API（gemini-3-flash-preview）ベースのチャットボットを追加するものです。管理画面でアップロードしたファイル（PDFや画像など）を Gemini File Search に保存し、その内容や手動 FAQ を参照しながら自然言語の質問に回答します。
主な特徴
| 項目 | 説明 |
| --- | --- |
| RAG チャット | アップロード済みファイルを File Search で検索し、生成モデルを使って回答。Gemini 最新モデルを採用。 |
| 手動回答の自動選択 | Gemini で候補を絞り込み、意味的に合致する手動回答を優先表示。なければ自動生成。 |
| アップロード処理 | ファイルをストアに直接アップロードし、Operation の完了を待ってから一覧に追加。失敗時はローカルファイルを削除。 |
| ファイル削除 | ファイル単体 / 全削除いずれも Gemini 上のドキュメントを消した後、ローカルパスとキャッシュを一貫してクリーンアップ。 |
| API制限の安全装置 | 429/503 発生時は 60 秒のトランジェントを立ててチャットフォームを一時停止し、ユーザーに「混雑中」の文言を表示。 |
| セッション & ログ | 匿名の Cookie セッション、チャットログ（未回答フラグ付き）、手動回答テーブルを保持。 |
要件
WordPress 6.0 以上
PHP 7.4 以上
Google Cloud アカウントと Gemini API キー（gemini-3-flash-preview へのアクセス権）
インストール / 有効化
1. リポジトリを wp-content/plugins/chatbot に配置。
2. WordPress 管理画面 → プラグインから「Gemini File Search Chatbot」を有効化。
3. 初回有効化時にカスタムテーブル（wpchatsessions、wpchatmessages、wpmanualanswers）が自動作成されます。
4. Update URI: false を設定済みなので、無効化中も WordPress が外部アップデートを確認しません。
管理画面の主な操作
1. API キーの登録
管理画面「Gemini Chatbot」→「API キー」に進み、Google AI Studio などで取得した API キーを登録します。UI 上では保存済みキーはマスク表示されます。
2. ストアの作成 / 再作成
「ストア管理」セクションで任意の名前を入力して