Title: Maqsy: FAQ Manager and AI Chat Author: sijad Published: September 2, 2026 Last modified: September 2, 2026 --- Search plugins ![](https://ps.w.org/maqsy-faq-ai-chat/assets/banner-772x250.png?rev=3677252) ![](https://ps.w.org/maqsy-faq-ai-chat/assets/icon-256x256.png?rev=3677252) # Maqsy: FAQ Manager and AI Chat By [sijad](https://profiles.wordpress.org/sijad/) [Download](https://downloads.wordpress.org/plugin/maqsy-faq-ai-chat.1.0.0.zip) * [Details](https://wordpress.org/plugins/maqsy-faq-ai-chat/#description) * [Reviews](https://wordpress.org/plugins/maqsy-faq-ai-chat/#reviews) * [Installation](https://wordpress.org/plugins/maqsy-faq-ai-chat/#installation) * [Development](https://wordpress.org/plugins/maqsy-faq-ai-chat/#developers) [Support](https://wordpress.org/support/plugin/maqsy-faq-ai-chat/) ## Description Maqsy lets you write and organise frequently asked questions as a dedicated post type, then place any FAQ on a page with a shortcode or a block. Each FAQ outputs clean, accessible markup plus `FAQPage` JSON-LD structured data so search engines can understand it. It also ships an **optional** AI chat widget: a small floating button that, when a visitor clicks it, lazy-loads a chat UI whose answers are grounded in your published FAQs. The chat feature is off by default and does nothing until you add an API key. #### FAQ management * FAQs are a private custom post type (`maqsy`) — not publicly browsable on their own. * Each FAQ holds an ordered list of question/answer pairs, edited with a drag-to- reorder UI and the standard WordPress editor for answers. * Two display templates: **Simple** (a definition list) and **Accordion** (WAI- ARIA disclosure pattern with keyboard support). #### Placing a FAQ Shortcode: ``` [maqsy id="123"] [maqsy id="123" template="accordion"] ``` Block: insert the **FAQ** block, pick a FAQ, and optionally override the template. Both render through the same code path. #### Structured data On singular views, each rendered FAQ emits `schema.org/FAQPage` JSON-LD built from its question/answer text. Output is limited to singular views (not archives, feeds or search) to follow Google’s one-FAQPage-per-URL guidance. #### AI chat widget (optional) Configure a provider and API key under **FAQs AI Chat Settings** and turn on “ Enable AI chat”. The always-loaded launcher script is tiny; the chat interface is only downloaded when a visitor actually opens the chat. Answers are grounded in your published FAQs plus any site/branding instructions you enter in settings, and the public endpoint is rate-limited per IP. The built-in provider works with any OpenAI-compatible `/chat/completions` API ( OpenAI, OpenRouter, or a self-hosted compatible endpoint — you choose the base URL). Other plugins can register additional providers via the maqsy_ai_providers filter. ### External services This plugin’s AI chat feature is **optional and disabled by default**. It does not contact any external service unless a site administrator enables the AI chat and saves an API key. When the AI chat is enabled and a visitor sends a message, the plugin makes a server- to-server request to the AI API endpoint you configure (“API base URL” in settings). By default this is OpenRouter (`https://openrouter.ai/api/v1`); you can change it to OpenAI (`https://api.openai.com/v1`) or any other OpenAI-compatible endpoint. **What is sent, and when:** * On each visitor chat message: the visitor’s message text, the text of your published FAQ posts, and any “Site & branding instructions” you entered — sent to the configured endpoint together with your API key, so the model can generate a reply. * When an administrator clicks “Fetch models” on the settings page: a request to the endpoint’s `/models` route, authenticated with the API key entered in the form. No data is sent to the plugin’s author or to WordPress.org. The plugin does not add analytics, tracking, or telemetry. Because you choose the endpoint, review the terms and privacy policy of whichever provider you configure. For the two presets: * OpenRouter — Terms: https://openrouter.ai/terms ; Privacy: https://openrouter. ai/privacy * OpenAI — Terms: https://openai.com/policies/terms-of-use/ ; Privacy: https:// openai.com/policies/privacy-policy/ ### Source code and build process Compiled assets in `build/` are generated from the human-readable sources included in this package: * `src/` — admin, front-end and block scripts/styles, built with `@wordpress/scripts`( webpack). See `webpack.config.js`. * `chat-runtime/src/` — the lazy-loaded chat UI (React 19 + TypeScript), bundled with esbuild, and its Tailwind stylesheet. See `package.json` and `tailwind.config. js`. To build from source: ``` npm install npm --prefix chat-runtime install npm run build ``` Development repository: https://github.com/sijad/maqsy-faq-ai-chat Bundled third-party libraries in the chat bundle (all MIT-licensed): React and ReactDOM, scheduler, use-sync-external-store, @floating-ui, @shadcn/react, clsx, tailwind-merge. ## Screenshots [⌊The AI Chat Settings screen.⌉⌊The AI Chat Settings screen.⌉[ The AI Chat Settings screen. [⌊The chat widget, shown in dark and light mode.⌉⌊The chat widget, shown in dark and light mode.⌉[ The chat widget, shown in dark and light mode. [⌊Editing a FAQ: drag-to-reorder question/answer pairs, with the ready-to-paste shortcode.⌉⌊Editing a FAQ: drag-to-reorder question/answer pairs, with the ready- to-paste shortcode.⌉[ Editing a FAQ: drag-to-reorder question/answer pairs, with the ready-to-paste shortcode. [⌊The FAQs admin list.⌉⌊The FAQs admin list.⌉[ The FAQs admin list. [⌊The FAQ block in the editor, set to the Accordion template.⌉⌊The FAQ block in the editor, set to the Accordion template.⌉[ The FAQ block in the editor, set to the Accordion template. [⌊The FAQ block in the editor, set to the Simple template.⌉⌊The FAQ block in the editor, set to the Simple template.⌉[ The FAQ block in the editor, set to the Simple template. ## Blocks This plugin provides 1 block. * FAQ Insert a Maqsy FAQ, with an optional template override. ## Installation 1. Upload the `maqsy-faq-ai-chat` folder to `/wp-content/plugins/`, or install the plugin through the Plugins screen in WordPress. 2. Activate the plugin through the **Plugins** screen. 3. Open the new **FAQs** menu and add a FAQ with one or more question/answer pairs. 4. Add `[maqsy id="…"]` (the shortcode is shown on the FAQ edit screen) to a page or post, or insert the **FAQ** block. 5. (Optional) To enable the AI chat, go to **FAQs AI Chat Settings**, enter an API key for an OpenAI-compatible provider, and turn on “Enable AI chat”. ## FAQ ### Do I need an API key to use the plugin? No. FAQ management, the shortcode, the block, and the structured-data output all work with no configuration. An API key is only required for the optional AI chat widget. ### Where does the AI chat get its answers? From the text of your published FAQ posts plus any instructions you add in settings. The system prompt instructs the model not to invent facts that aren’t in that content. See the “External services” section for exactly what is sent. ### Does the plugin work without JavaScript? The Simple template and the structured data are pure server-side HTML. The Accordion template’s expand/collapse needs JavaScript. The AI chat widget needs JavaScript. ### What happens to my data when I uninstall? Deleting the plugin removes all FAQ posts it created and its settings option. Deactivating does not delete anything. ### Can I add my own AI provider? Yes. Implement `Maqsy_AI_Provider` and add it via the `maqsy_ai_providers` filter. The filters `maqsy_ai_system_prompt`, `maqsy_ai_before_request` and `maqsy_ai_after_response` are also available. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Maqsy: FAQ Manager and AI Chat” is open source software. The following people have contributed to this plugin. Contributors * [ sijad ](https://profiles.wordpress.org/sijad/) [Translate “Maqsy: FAQ Manager and AI Chat” into your language.](https://translate.wordpress.org/projects/wp-plugins/maqsy-faq-ai-chat) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/maqsy-faq-ai-chat/), check out the [SVN repository](https://plugins.svn.wordpress.org/maqsy-faq-ai-chat/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/maqsy-faq-ai-chat/) by [RSS](https://plugins.trac.wordpress.org/log/maqsy-faq-ai-chat/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release. ## Meta * Version **1.0.0** * Last updated **2 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.1** * PHP version ** 7.4 or higher ** * Tags * [Accordion](https://wordpress.org/plugins/tags/accordion/)[AI chat](https://wordpress.org/plugins/tags/ai-chat/) [chatbot](https://wordpress.org/plugins/tags/chatbot/)[faq](https://wordpress.org/plugins/tags/faq/) [structured data](https://wordpress.org/plugins/tags/structured-data/) * [Advanced View](https://wordpress.org/plugins/maqsy-faq-ai-chat/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/maqsy-faq-ai-chat/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/maqsy-faq-ai-chat/reviews/) ## Contributors * [ sijad ](https://profiles.wordpress.org/sijad/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/maqsy-faq-ai-chat/)