| 开发者 | sijad |
|---|---|
| 更新时间 | 2026年10月6日 21:38 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1.2 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
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
maqsy) — not publicly browsable on their own.[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.
maqsy-faq-ai-chat folder to /wp-content/plugins/, or install the plugin through the Plugins screen in WordPress.[maqsy id="…"] (the shortcode is shown on the FAQ edit screen) to a page or post, or insert the FAQ block.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.
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.
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.
Deleting the plugin removes all FAQ posts it created and its settings option. Deactivating does not delete anything.
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.