Title: Hamelp
Author: Fumiki Takahashi
Published: 07 Aogositra 2018
Last modified: 21 May 2026
---
Search plugins
# Hamelp
By [Fumiki Takahashi](https://profiles.wordpress.org/takahashi_fumiki/)
[Download](https://downloads.wordpress.org/plugin/hamelp.2.2.2.zip)
* [Details](https://mg.wordpress.org/plugins/hamelp/#description)
* [Reviews](https://mg.wordpress.org/plugins/hamelp/#reviews)
* [Installation](https://mg.wordpress.org/plugins/hamelp/#installation)
* [Development](https://mg.wordpress.org/plugins/hamelp/#developers)
[Support](https://wordpress.org/support/plugin/hamelp/)
## Description
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:
```
```
The function accepts an optional array of arguments:
```
'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:
```
'Enter your question here.',
'btn' => 'Search',
] ); ?>
```
## Blocks
This plugin provides 2 blocks.
* AI FAQ Overview AI-powered FAQ search that answers user questions based on
FAQ content.
* FAQ Search Box Incremental search box for FAQ posts.
## Installation
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.
## FAQ
### 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.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Hamelp” is open source software. The following people have contributed to this
plugin.
Contributors
* [ Fumiki Takahashi ](https://profiles.wordpress.org/takahashi_fumiki/)
* [ Hametuha INC. ](https://profiles.wordpress.org/hametuha/)
“Hamelp” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/hamelp/contributors)
for their contributions.
[Translate “Hamelp” into your language.](https://translate.wordpress.org/projects/wp-plugins/hamelp)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/hamelp/), check out
the [SVN repository](https://plugins.svn.wordpress.org/hamelp/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/hamelp/) by [RSS](https://plugins.trac.wordpress.org/log/hamelp/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 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.
## Meta
* Version **2.2.2**
* Last updated **1 herinandro ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.6 or higher **
* Tested up to **7.0**
* PHP version ** 7.4 or higher **
* Languages
* [English (US)](https://wordpress.org/plugins/hamelp/) sy [Japanese](https://ja.wordpress.org/plugins/hamelp/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/hamelp)
* Tags
* [faq](https://mg.wordpress.org/plugins/tags/faq/)[help](https://mg.wordpress.org/plugins/tags/help/)
* [Advanced View](https://mg.wordpress.org/plugins/hamelp/advanced/)
## Ratings
Mbola tsy misy domberina voaray hatreto.
[Your review](https://wordpress.org/support/plugin/hamelp/reviews/#new-post)
[Hijery ny domberina rehetra](https://wordpress.org/support/plugin/hamelp/reviews/)
## Contributors
* [ Fumiki Takahashi ](https://profiles.wordpress.org/takahashi_fumiki/)
* [ Hametuha INC. ](https://profiles.wordpress.org/hametuha/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/hamelp/)