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.
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 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',
] ); ?>
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.
- Donwload and unpack plugin file, upload
hamelpfolder to/wp-content/pluginsdirectory. - Activate it from admin panel.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Hamelp” is open source software. The following people have contributed to this plugin.
Contributors“Hamelp” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “Hamelp” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by 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 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_rolesfilter). - Add
hamelp_user_contextandhamelp_display_user_rolesfilters 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 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.
