Linux 软件免费装
Banner图

Maqsy: FAQ Manager and AI Chat

开发者 sijad
更新时间 2026年10月6日 21:38
PHP版本: 7.4 及以上
WordPress版本: 7.1.2
版权: GPL-2.0-or-later
版权网址: 版权信息

标签

faq accordion chatbot structured data ai chat

下载

1.0.0 1.1.0

详情介绍:

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 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.

安装:

  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".

屏幕截图:

  • The chat widget, shown in dark and light mode.
  • Editing a FAQ: drag-to-reorder question/answer pairs, with the ready-to-paste shortcode.
  • The FAQs admin list.
  • The FAQ block in the editor, set to the Accordion template.
  • The FAQ block in the editor, set to the Simple template.

升级注意事项:

1.1.0 Accordion FAQs now use native details/summary markup. Update custom button or .active CSS selectors to target summary and details[open]. 1.0.0 Initial release.

常见问题:

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?

Both FAQ templates and the structured data work without JavaScript. The Accordion template uses native HTML details/summary elements. 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.

更新日志:

1.1.0 1.0.0