説明
このプラグインは新しいカスタム投稿タイプ「よくある質問」を追加します。いくつかの機能を使ってユーザーのためのヘルプページを作ることができます。ヘルプセンターとはなんでしょうか ? いくつかの例を GitHub Wiki に挙げていますので、ご覧ください。
ライブデモ: https://demo.kunoichiwp.com/pubplafaq/ — トップページで AI オーバービューをお試しください。でもは日本語ですが、架空のアンチエイジングサブスクリプション「ジョヴィアン」のデモで、FAQコンテンツに書いてある内容から AI がどのような答えを返すか(または書いていないことがどう処理されるか)を試すことができます。
ポータルを作成する
このプラグインが提供する機能は……
- シングルページとアーカイブページを持つカスタムタクソノミー。
- カスタム投稿タイプに紐づくカスタムタクソノミー。
- インクリメンタル検索ボックス。
- AI オーバービュー (2.0.0から)
AI オーバービュー
AI オーバービューは、大規模言語モデルを使って FAQ コンテンツに基づいてユーザーの質問に回答します。
WordPress 7.0からコアに同梱されている wp-ai-client を使用しており、WordPress で AI サービスが設定されている必要があります。
要件: AI オーバービューには WordPress 7.0以降が必要です。古い WordPress バージョンでは、AI オーバービューブロックとテンプレート関数はエディターとフロントエンドに表示されますが、検索フォームは機能しません (動作に必要な REST エンドポイントが無効になっています)。このプラグインの他の機能 (FAQ カスタム投稿タイプ、インクリメンタル検索、ショートコード) は WordPress 6.6以上で引き続き動作します。AI オーバービューを有効化するには WordPress を7.0にアップグレードしてください。
管理パネルの「設定 > ヘルプセンター」から AI の動作とレート制限を設定できます。設定ページには、LLM コンテキストとして使用される FAQ カタログを手動で更新するための「今すぐカタログを再構築」ボタンも含まれています。
ブロックを使う
AI FAQ オーバービュー ブロックをエディターに追加してください。ブロックには次のオプションがあります。
- プレースホルダー — 入力欄のプレースホルダー。
- ボタンテキスト — 送信ボタンのラベル
-
引用元を表示 — 回答の下に関連する FAQ のリンクを表示します。
テンプレート関数を使う
テーマテンプレートで hamelp_render_ai_overview() 関数を使うこともできます。
<?php echo hamelp_render_ai_overview(); ?>
関数はオプションの引数を配列で受け取ります。
<php
echo hamelp_render_ai_overview( [
'placeholder' => 'Ask a question...',
'button_text' => 'Ask AI',
'show_sources' => true,
] );
?>
この関数は必要な JavaScript と CSS アセットを自動で読み込みます。
検索ボックス
インクリメンタル FAQ 検索ボックスは3つの形式で利用できます。
ブロックを使う
ブロックエディターに FAQ 検索ボックスブロックを追加してください。ブロックには次のオプションがあります。
- ラベル — 入力欄のプレースホルダーテキスト。
-
ボタンテキスト — 送信ボタンのラベル
ショートコードを使う
ページ本文で hamelp-search ショートコードを利用することができます。
[hamelp-search label='Enter your question here.'][/hamelp-search]
テンプレート関数を使う
テーマテンプレートから hamelp_render_search_box() を直接呼び出すこともできます。
<?php echo hamelp_render_search_box( [
'label' => 'Enter your question here.',
'btn' => 'Search',
] ); ?>
ブロック
このプラグインは2個のブロックを提供します。
- AI FAQ Overview AI-powered FAQ search that answers user questions based on FAQ content.
- FAQ Search Box Incremental search box for FAQ posts.
インストール
インストールは簡単です。管理画面からの自動インストールをおすすめします。hamelp で検索してください。
- プラグインファイルをダウンロードしてから解答し、
hamelpフォルダーを/wp-content/pluginsディレクトリにアップロードしてください。 - 管理画面から有効化してください。
評価
このプラグインにはレビューがありません。
貢献者と開発者
PubPla AI ヘルプセンター はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。
貢献者変更履歴
各バージョンの完全はリリースノートは GitHub Releases をご覧ください。
2.4.3
- Fix the AI Overview send button appearing as a horizontal ellipse on themes that set a button min-width. The button’s width is now constrained (complementing the height fix in 2.4.2) so it stays a circle regardless of theme styles.
2.4.2
- Fix the AI Overview send button rendering as an oversized rectangle (with the arrow sometimes hidden) on themes whose button styles overrode the plugin CSS. The button’s structural styles are now scoped so theme styles can no longer override its size and shape.
2.4.1
- Redesign the AI Overview question box as a ChatGPT-style auto-growing textarea with a circular send button inset at the bottom-right. Submit with Enter (Shift+Enter for a newline), with IME composition handled. Adds accessible labels and focus handling, a helper hint, and a responsive full-width layout.
2.4.0
- AI モデル 設定でプロバイダー・モデルを指定できるように。設定が完了したコネクター(WordPress 7.0 設定 コネクタ)だけが表示されます。選択したモデルがのちに利用不可能になった場合、自動選択にフォールバックされます。
- デフォルトで temperature を無視するように。いくつかのモデル(例・Claude Opus/Sonnet)は温度を受け付けず、400エラーを返します。自動選択を含め、温度を無視するのがどのモデルでも安全です。どうしても必要な時だけ値を設定してください。
hamelp_ai_modelとhamelp_ai_temperatureフィルターでモデルとサンプリング温度を上書きできるように。- 引用元を改善:「関連するFAQ」をリネームし、 引用元 に見出しを変更。リストは順序付きリストにし、回答に含まれる参照符の
(Ref. N)と番号が揃うように。
2.3.1
- 参照元のプレフィックス (Ref. 1) を変更できるように。
2.3.0
- 運営を Tarosky へ移管しました。
- プラグイン名をPubPla AI Help Centerに変更しました。プラグインスラッグ、テキストドメイン、REST ルート、PHP API は後方互換のため
hamelpのままです。そのため設定やコードの変更は不要です。 - AI 要約がマルチターン会話に対応しました。フォローアップの質問は前回までのやり取りを文脈として保持し、回答は Q&A スレッドとして積み重なります。会話履歴はブラウザー側で保持され、リクエストごとに送信されるため、サーバーには何も保存されません。
- LLM に送信する過去のメッセージ数を制限する
hamelp_history_windowフィルターを追加しました (デフォルト 10)。 - 質問マイニングのために会話を保存できるようになりました (デフォルトはオフ)。設定画面で有効にすると、会話は管理画面で閲覧できる非公開の投稿タイプとして保存され、訪問者が実際に何を質問しているかを確認できます。会話を保存設定または
hamelp_save_conversationsフィルターで切り替えます。 - 自動削除までの日数の保持設定を追加しました。毎日実行される cron が、設定した日数より古い匿名の会話を削除します (0 = 削除しない)。ログイン済みユーザーの会話は自動削除されません。
- AI 要約のモード設定を追加: 会話 (マルチターン、デフォルト)、単発回答 (フォローアップなし、低コスト)、無効。コストを抑えたい場合やリクエスト殺到時に機能を止めたい場合は単発回答/無効を使用します。
hamelp_ai_overview_modeフィルターでも利用できます。 - フロントエンドがモードを反映するようになりました。単発回答では質問ごとに前の回答を置き換え、会話では「この会話を続ける」トグルが表示され、訪問者はフォローアップを続けるか、新しい会話を始める (スレッドをクリアする) かを選べます。
2.2.3
*--wp--preset--color--*を使用してテーマのデザインに合わせる CSS 構造の変更。bissy さんプルリクエストありがとうございます。
2.2.2
- FAQ 検索ボックスブロック (
hamelp/search-box) を追加。既存の[hamelp-search]ショートコードは引き続き機能し、同じレンダリングロジックを共有するようにしました。 hamelp_render_search_box()をパブリックなテンプレート関数として公開し、テーマがショートコードパーサーを通さずに検索ボックスをレンダリングできるようにしました。
2.2.0
- 同梱の wp-ai-client Composer 依存関係を削除。AI オーバービューは WordPress コアに同梱されている wp-ai-client を使用するようにしました。WordPress 7.0以降が必要です。
- WordPress 7.0 より古いバージョンでは、AI オーバービューブロックと検索フォームはレンダリングされますが、送信が失敗します (REST ルートなし)。FAQ カスタム投稿タイプ、インクリメンタル検索、その他の機能は引き続き正常に動作します。
- プラグイン有効化時に FAQ カタログを自動再構築するようにしました。これにより、手動で
wp hamelp rebuildを実行しなくても AI オーバービューがすぐに使えます。 - 設定ページに手動でカタログを更新するための「今すぐカタログを再構築」ボタンを追加。
2.1.0
- 返答をパーソナライズするために AI オーバービューにユーザーコンテキストを追加。
- セキュリティのため、ホワイトリスト方式のユーザー役割フィルター (
hamelp_allowed_user_rolesfilter) を追加。 - カスタマイズ用に
hamelp_user_contextとhamelp_display_user_rolesフィルターを追加。 - ローカル環境でのテストのために開発用フックのサポートを追加。
- GlotPress (WordPress.org) を優先するため、同梱の言語ファイルを削除。
2.0.0
- AI オーバービュー機能を追加
- 最小要件を引き上げ: PHP >=7.4, WordPress >= 6.6
1.0.4
- FAQPage の構造化データを追加。
1.0.3
- バグフィックスとグローバル関数の変更。
1.0.2
- Gutenberg でタクソノミーが表示されるように。
1.0.1
- vendor ディレクトリが含まれないバグを修正。
1.0.0
- 最初のリリース。
