Title: Hamelp
Author: Fumiki Takahashi
Published: <strong>2018 年 8 月 7 日</strong>
Last modified: 2026 年 5 月 21 日

---

搜尋外掛

![](https://ps.w.org/hamelp/assets/banner-772x250.jpg?rev=1920764)

![](https://ps.w.org/hamelp/assets/icon-256x256.png?rev=1920789)

# Hamelp

 由 [Fumiki Takahashi](https://profiles.wordpress.org/takahashi_fumiki/) 開發

[下載](https://downloads.wordpress.org/plugin/hamelp.2.2.2.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/hamelp/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/hamelp/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/hamelp/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/hamelp/#developers)

 [技術支援](https://wordpress.org/support/plugin/hamelp/)

## 外掛說明

This plugin add new custom post type ‘FAQ’. With some functionality, you can build
help center for your user.
 What is help center? We collect examples at our [github wiki](https://github.com/hametuha/hamelp/wiki).

#### Creating Portal

This plugin will provide…

 * Custom post type with single page and archive page.
 * Custom taxonomy associated to CPT.
 * Incremental search box.
 * AI Overview(Since 2.0.0)

#### AI Overview

AI Overview answers user questions based on your FAQ content using a large language
model.
 It uses the [wp-ai-client](https://github.com/WordPress/wp-ai-client) bundled
with WordPress core since WordPress 7.0, which requires an AI service to be configured
in WordPress.

**Requirements:** AI Overview requires **WordPress 7.0 or later**. On older WordPress
versions, the AI Overview block and template function will still appear in the editor
and on the front-end, but the search form will not work (the REST endpoint that 
powers it is disabled). Other features of this plugin (FAQ custom post type, incremental
search, shortcode) continue to work on WordPress 6.6+. Upgrade WordPress to 7.0 
to enable AI Overview.

You can configure AI behavior and rate limiting from **Settings > Hamelp** in the
admin panel. The settings page also includes a **Rebuild Catalog Now** button to
manually refresh the FAQ catalog used as LLM context.

Using the Block

Add the **AI FAQ Overview** block in the block editor. The block has the following
options:

 * **Placeholder** — Input placeholder text.
 * **Button Text** — Submit button label.
 * **Show Sources** — Display related FAQ links below the answer.
 * Using the Template Function

You can also use `hamelp_render_ai_overview()` in your theme templates:

    ```
    <?php echo hamelp_render_ai_overview(); ?>
    ```

The function accepts an optional array of arguments:

    ```
    <php
    echo hamelp_render_ai_overview( [
        'placeholder'  => 'Ask a question...',
        'button_text'  => 'Ask AI',
        'show_sources' => true,
    ] );
    ?>
    ```

The function automatically enqueues the required JavaScript and CSS assets.

#### Search Box

The incremental FAQ search box is available in three forms.

Using the Block

Add the **FAQ Search Box** block in the block editor. The block has the following
options:

 * **Label** — Input placeholder text.
 * **Button Text** — Submit button label.
 * Using the Shortcode

You can use shortcode `hamelp-search` in page content.

    ```
    [hamelp-search label='Enter your question here.'][/hamelp-search]
    ```

Using the Template Function

You can also call `hamelp_render_search_box()` directly from your theme templates:

    ```
    <?php echo hamelp_render_search_box( [
        'label' => 'Enter your question here.',
        'btn'   => 'Search',
    ] ); ?>
    ```

## 適用於區塊編輯器

這個外掛提供 2 個可供 Gutenberg/區塊編輯器使用的區塊。

 *   AI FAQ Overview AI-powered FAQ search that answers user questions based on 
   FAQ content.
 *   FAQ Search Box Incremental search box for FAQ posts.

## 安裝方式

Install itself is easy. Auto install from admin panel is recommended. Search with`
hamelp`.

 1. Donwload and unpack plugin file, upload `hamelp` folder to `/wp-content/plugins`
    directory.
 2. Activate it from admin panel.

## 常見問題集

### How can I contribute?

You can contribute to our github repo. Any [issues](https://github.com/hametuha/hamelp/issues)
or [PRs](https://github.com/hametuha/hamelp/pulls) are welcomed.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈Hamelp〉的開發相關工作。

參與者

 *   [ Fumiki Takahashi ](https://profiles.wordpress.org/takahashi_fumiki/)
 *   [ Hametuha INC. ](https://profiles.wordpress.org/hametuha/)

〈Hamelp〉外掛目前已有 1 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/hamelp/contributors)
為這個外掛做出的貢獻。

[將〈Hamelp〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/hamelp)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/hamelp/)、查看
[SVN 存放庫](https://plugins.svn.wordpress.org/hamelp/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/hamelp/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/hamelp/)。

## 變更記錄

#### 2.3.0

 * Add **FAQ Search Box** block (`hamelp/search-box`). The existing `[hamelp-search]`
   shortcode continues to work and now shares the same render logic.
 * Expose `hamelp_render_search_box()` as a public template function so themes can
   render the search box without going through the shortcode parser.

#### 2.2.0

 * Remove bundled [wp-ai-client](https://github.com/WordPress/wp-ai-client) Composer
   dependency. AI Overview now uses the wp-ai-client bundled with WordPress core,
   which requires **WordPress 7.0 or later**.
 * On WordPress versions earlier than 7.0, the AI Overview block and search form
   still render but submissions fail (no REST route). FAQ custom post type, incremental
   search, and other features remain functional.
 * Auto-rebuild the FAQ catalog on plugin activation, so the AI Overview works out
   of the box without manually running `wp hamelp rebuild`.
 * Add a **Rebuild Catalog Now** button to the settings page for manual catalog 
   refresh.

#### 2.1.0

 * Add user context to AI Overview for personalized responses.
 * Add whitelist-based user role filtering for security (`hamelp_allowed_user_roles`
   filter).
 * Add `hamelp_user_context` and `hamelp_display_user_roles` filters for customization.
 * Add development hooks support for local environment testing.
 * Remove bundled translations in favor of GlotPress (WordPress.org).

#### 2.0.0

 * Add AI Overview Feature.
 * Bump minimum requirements: PHP >=7.4, WordPress >= 6.6

#### 1.0.4

 * Add [structured data](https://developers.google.com/search/docs/data-types/faqpage)
   for FAQPage.

#### 1.0.3

 * Bugfix and change glocal functions.

#### 1.0.2

 * Fix taxonomy to be shown in Gutenberg.

#### 1.0.1

 * Fix no vendor directory bug.

#### 1.0.0

 * Initial release.

## 中繼資料

 *  版本 **2.2.2**
 *  最後更新 **2 週前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 6.6 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.0**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/hamelp/) 及 [Japanese](https://ja.wordpress.org/plugins/hamelp/).
 *  [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/hamelp)
 * 標籤:
 * [faq](https://tw.wordpress.org/plugins/tags/faq/)[help](https://tw.wordpress.org/plugins/tags/help/)
 *  [進階檢視](https://tw.wordpress.org/plugins/hamelp/advanced/)

## 評分

這個項目尚無任何評論記錄。

[Your review](https://wordpress.org/support/plugin/hamelp/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/hamelp/reviews/)

## 參與者

 *   [ Fumiki Takahashi ](https://profiles.wordpress.org/takahashi_fumiki/)
 *   [ Hametuha INC. ](https://profiles.wordpress.org/hametuha/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/hamelp/)