PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.2.14
MxChat – AI Chatbot & Content Generation for WordPress v3.2.14
3.2.21 3.2.20 3.2.19 3.2.18 3.2.17 3.2.16 3.2.15 3.2.14 3.2.12 3.2.13 3.2.11 3.2.10 3.2.9 3.2.8 3.2.7 3.2.6 3.2.5 3.2.4 3.2.3 3.2.2 3.2.1 2.0.3 2.0.4 2.0.5 2.0.6 All 152 releases
mxchat-basic / readme.txt

readme.txt in MxChat – AI Chatbot & Content Generation for WordPress 3.2.14, at readme.txt

580 lines 50.0 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === MxChat - AI Chatbot & Content Generation for WordPress ===
2 Contributors: mxchat
3 Author: [MxChat](https://mxchat.ai)
4 Tags: ai chatbot, chatgpt, woocommerce, customer support, content generation
5 Requires at least: 5.0
6 Tested up to: 7.0.1
7 Requires PHP: 7.2
8 Stable tag: 3.2.14
9 License: GPLv2 or later
10 License URI: https://www.gnu.org/licenses/gpl-2.0.html
11
12 MxChat is the best free AI chatbot and content generation plugin for WordPress in 2026. Train ChatGPT, Claude, Gemini, or Grok on your website content. Generate full blog posts and landing pages with AI. WooCommerce ready with RAG knowledge base, live chat handoff, and 100+ AI models.
13
14 == Description ==
15
16 **MxChat is the most powerful free AI chatbot and content generation plugin for WordPress** — connecting your website to ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ AI models through a single, easy-to-use interface. Train your AI chatbot on your website content, WooCommerce products, PDFs, YouTube videos, and more using advanced RAG (Retrieval-Augmented Generation) technology. Now with a built-in AI Content Generator to create full blog posts and landing pages complete with images, SEO metadata, and inline AI editing.
17
18 [Documentation](https://mxchat.ai/documentation/) | [Demo Videos](https://www.youtube.com/@MxChat/videos)
19
20 ## Why Choose MxChat as Your WordPress AI Chatbot?
21
22
23 **6 Major AI Providers in One Plugin**: OpenRouter, OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 100+ models instantly
24
25 **Train on Your Website Data**: Advanced RAG technology learns from sitemaps, PDFs, URLs, YouTube videos, or manual input for ultra-relevant responses
26
27 **Live Agent Handoff via Slack**: Seamlessly escalate from AI to human support when customers need personal assistance
28
29 **Real-Time Debug Panel**: See exactly what your chatbot retrieves and triggers with our admin testing interface
30
31 **Boost Sales with WooCommerce**: Product cards, cart management, and AI-powered shopping assistance
32
33 **AI Content Generator**: Create full blog posts and landing pages with AI-generated images, SEO metadata, and real-time preview editing
34
35 **Extensive Add-On Ecosystem**: Forms, moderation, recommendations, theme customization, and more
36
37 🎬 [Quick Setup with MxChat](https://www.youtube.com/watch?v=3BqoiyWaQiM) – Learn how to quickly setup and understand how your chatbot works
38
39 ### 📦 Optional Premium Add-Ons
40 Extend the free plugin with these optional premium features:
41
42 - [MCP Server Add-On](https://mxchat.ai/add-ons/mxchat-mcp/) – Turn your MxChat install into a Model Context Protocol server so Claude, ChatGPT, and Claude Code list transcripts, push knowledge, and inspect bots natively — JSON-RPC 2.0 + OAuth + bearer auth, no per-message fees
43 - [Advanced Content Editor Add-On](https://mxchat.ai/add-ons/mxchat-advanced-content/) – Smart internal linking, AI image management, readability analysis, Google Search Console integration, advanced SEO optimization, and 30-day AI Content Calendar for automated blog scheduling
44 - [WooCommerce Add-On](https://mxchat.ai/add-ons/mxchat-woo/) – AI-powered shopping assistance with product-aware conversations, native product cards with images and pricing, upselling and recommendations, order inquiry handling, cart management, and real-time inventory awareness
45 - [Forms Add-On](https://mxchat.ai/add-ons/mxchat-forms/) – Capture leads and data with custom in-chat forms
46 - [MxChat Anywhere Add-On](https://mxchat.ai/add-ons/mxchat-embed/) – Deploy your chatbot on any website with one script tag — Shopify, Squarespace, Wix, static HTML, and more
47 - [AI Chatbot Theme Customizer Add-On](https://mxchat.ai/add-ons/mxchat-theme/) – Instantly design chatbot themes with natural language using AI
48 - [Multi-Bot Add-On](https://mxchat.ai/add-ons/mxchat-multi-bot/) – Run unlimited AI chatbots with custom knowledge and personalities
49 - [Image Analysis Add-On](https://mxchat.ai/add-ons/mxchat-vision/) – Enable AI-powered image analysis and OCR inside chats
50
51 👉 [Visit our website to view all add-ons](https://mxchat.ai)
52
53 ## Core Features That Set MxChat Apart
54
55 🟢 **100+ AI Models** – Access ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ models from OpenRouter with a single plugin
56 🟢 **Lead Management Dashboard** – Dedicated Leads tab inside Transcripts shows every captured email and name deduplicated by lead, with filters, bulk delete, CSV export, and one-click jump to each lead's latest conversation
57 🟢 **Chat Transcripts Dashboard** – Review all conversations, analyze chat history, track user engagement, and see exactly which knowledge sources the AI used for each response
58 🟢 **WooCommerce Product Training** – Train your AI chatbot on your entire product catalog including descriptions, pricing, SKUs, and categories for intelligent shopping assistance
59 🟢 **Live Agent Handoff** – Seamlessly escalate conversations from AI to human support via Slack when customers need personal assistance
60 🟢 **ACF Field Control** – Choose exactly which Advanced Custom Fields are included in your knowledge base—perfect for excluding private notes or internal data
61 🟢 **Advanced Action Recognition** – Trigger Phrases use a smart vector embedding system to understand user intent and fire lead capture, appointments, redirects, and custom actions automatically — precise, deterministic control over when each action runs
62 🟢 **AI Tools (Function Calling)** – Let the chatbot decide on its own when to run an enabled action straight from natural language, with no phrases to set up. Use Trigger Phrases, AI Tools, or both together (function calling needs a tool-capable AI model)
63 🟢 **Document Processing** – Let visitors upload and chat with PDFs and Word documents directly on your frontend
64 🟢 **Pinecone Vector Storage** – Optional lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments
65 🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base
66 🟢 **AI Content Generator** – Create full blog posts and landing pages from a prompt with AI images, SEO metadata, real-time preview, and inline AI editing via chat
67 🟢 **Image Generation** – OpenAI GPT Image and Google Imagen for visual content creation within chat conversations
68 🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, Grok, and DeepSeek models for the fastest possible chat experience
69 🟢 **REST API** – Bearer-token endpoints to read transcripts, push knowledge, and bulk-delete sessions — wire MxChat into n8n, Zapier, analytics dashboards, GDPR workflows, or your own agents
70
71 ## Choose from 100+ Premium AI Models
72 Access the world's most advanced AI models based on your specific needs:
73
74 **OpenRouter**: 100+ models from multiple providers with a single API key – including OpenAI, Anthropic, Google, Meta, Mistral, and more!
75 **OpenAI**:
76 GPT-5.5, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5.3 Chat, GPT-5.2, GPT-5.1 Chat Latest, GPT-5.1, GPT-5, GPT-5 Mini, GPT-5 Nano
77 **Anthropic Claude**:
78 Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 4.6, Claude Opus 4.5, Claude Sonnet 4.5, Claude Opus 4.1, Claude Haiku 4.5, Claude 4 Opus, Claude 4 Sonnet
79 **X.AI**:
80 **Grok 4.1 Fast (Reasoning)**, **Grok 4.1 Fast (Non-Reasoning)**, Grok 4, Grok-3, Grok-3 Fast, Grok-3 Mini, Grok-3 Mini Fast
81 **Google Gemini**:
82 Gemini 3.5 Flash, Gemini 3.1 Pro, Gemini 3 Flash, Gemini 3.1 Flash-Lite, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite
83 **DeepSeek**:
84 DeepSeek V3
85
86 ## Lead Management Dashboard — Turn Chat Traffic Into a Real Lead List
87
88 Every email and name your chatbot captures now lands in one clean, sortable dashboard — so you can finally see your leads as a list instead of hunting through individual transcripts.
89
90 **What You Get:**
91
92 - **One Row Per Lead** — emails captured across multiple sessions are automatically deduplicated, so each lead appears once with a conversation count and a "last seen" timestamp
93 - **Top Pages Capturing Leads** — instantly see which pages on your site are driving the most lead captures; click any page to filter the list to leads from that page only
94 - **Powerful Filtering** — search by email or name, filter by date range (24h / 7d / 30d / 90d / all-time), or filter by status (leads with a conversation vs. orphan leads who submitted the form but never chatted)
95 - **Orphan Lead Tracking** — visitors who drop their email in the pre-chat form but never send a message are surfaced separately so you never lose a captured contact
96 - **One-Click View Conversation** — jump from any lead straight into their latest full conversation in the transcripts viewer
97 - **Bulk Delete + CSV Export** — select multiple leads to delete or export in one action; CSV export supports email-only or email + name + conversation count + last-seen + top page
98 - **Clean, Responsive, Native** — works beautifully on desktop, tablet, and phone with the same polished dashboard feel as the rest of MxChat
99 - **Zero Setup, Zero Migration** — uses your existing chat data, no new database tables, no configuration — turn on lead capture and the dashboard just works
100
101 **Perfect for** sales teams managing inbound leads, agencies reporting to clients, and anyone who wants to see the actual ROI of their chatbot at a glance without digging through individual conversations.
102
103 ## AI Content Generator — Create Blog Posts & Landing Pages with AI
104
105 MxChat includes a built-in AI Content Generator that lets you create full blog posts and landing pages directly from your WordPress dashboard — no external tools or copy-pasting required.
106
107 **How It Works:**
108
109 1. **Describe Your Content** — Enter a topic, title, or detailed prompt and choose between a blog post or landing page layout
110 2. **AI Generates Everything** — The AI produces fully styled HTML with responsive CSS, ready-to-publish content, and optional AI-generated images using OpenAI GPT Image, Gemini, or Grok
111 3. **Real-Time Preview** — See your content exactly as it will appear on your site with a live scaled preview, including desktop and mobile viewport switching
112 4. **Edit with AI Chat** — Use the built-in AI chat panel to request changes like "make the heading bigger" or "change the background to blue" — the AI updates your content in real time
113 5. **Publish Instantly** — Content is saved as a native WordPress post or page with clean HTML, SEO metadata, and responsive design that works with any theme
114
115 **Key Content Generator Features:**
116
117 - Choose from multiple AI models for content generation (GPT-5, Claude, Gemini, Grok, and more)
118 - AI-generated images placed directly into your content with automatic media library uploads
119 - SEO title and meta description generation for search engine optimization
120 - Built-in SEO analysis with real-time scoring and one-click AI auto-optimization
121 - Fullwidth and standard layout options with automatic theme compatibility
122 - Content history to revisit and manage previously generated posts
123 - Works with popular page builders and themes including Elementor, Bricks, Divi, Astra, Kadence, and more
124 - Optional [Advanced Content Editor Add-On](https://mxchat.ai/add-ons/mxchat-advanced-content/) for Google Search Console analytics, smart internal linking, readability analysis, and advanced SEO optimization
125
126 ## MxChat Anywhere — Deploy Your Chatbot on Any Website
127
128 Your WordPress site powers the AI, but your chatbot doesn't have to live there. The [MxChat Anywhere Add-On](https://mxchat.ai/add-ons/mxchat-embed/) lets you deploy your fully configured chatbot on any website with a single script tag — Shopify, Squarespace, Wix, static HTML, SaaS apps, documentation sites, or anything with an HTML page.
129
130 **Key Features:**
131
132 - One script tag to add your chatbot to any site — no coding or framework required
133 - Full style isolation via Shadow DOM so host page CSS never breaks your chatbot
134 - All your MxChat settings carry over automatically — colors, themes, quick questions, email collection, streaming, and more
135 - Multi-bot support lets you deploy different chatbot configurations on different sites
136 - Secure domain whitelisting and API key authentication prevent unauthorized usage
137 - Lightweight vanilla JS widget with zero dependencies — no jQuery needed on the target site
138
139 **Ideal for** SaaS products with a WordPress blog but a separate web app, e-commerce brands on Shopify, documentation sites, or any business that needs their chatbot beyond WordPress.
140
141 ## Powerful Add-On Ecosystem
142
143 **Pro Add-Ons:**
144 🟢 **MCP Server** – Expose your MxChat install as a Model Context Protocol server so Claude, ChatGPT, and Claude Code can list transcripts, push knowledge, and inspect bots through a JSON-RPC 2.0 endpoint with OAuth + bearer auth — no per-message fees, no middleman API. Includes a WooCommerce extension for product, order, and customer lookups.
145 🟢 **Advanced Content Editor** – Google Search Console integration with per-page impressions, clicks, and search queries. Smart internal linking, AI readability optimization, image ALT text generation, and advanced SEO checks
146 🟢 **Multi-Bot Manager** – Create and manage multiple specialized chatbots with dedicated knowledge databases for different purposes (support, sales, technical, etc.)
147 🟢 **Video Generation** – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios
148 🟢 **Admin Assistant** – ChatGPT-like interface in WordPress admin with thread management and image generation
149 🟢 **Chat Themes** – Visual design editor with AI-powered chatbot theme generation from natural language
150 🟢 **MxChat Forms** – Create chatbot-triggered forms for lead capture and support tickets
151 🟢 **Chat Moderation** – Advanced security with email/IP banning and content filtering
152 🟢 **MxChat Anywhere** – Deploy your chatbot on any website with one script tag — Shopify, Squarespace, Wix, static HTML, and custom web apps with Shadow DOM style isolation
153 🟢 **Perplexity Integration** – Real-time web search with authoritative, well-sourced responses
154 🟢 **MxChat Trigger** – Turn any element into a conversation starter — chat trigger buttons and links that open MxChat and send predefined messages, perfect for CTAs and guided experiences
155
156 ## 📱 Mobile-Friendly & Fully Customizable
157
158 MxChat’s chatbot widget adapts seamlessly to all devices — desktop, tablet, or mobile. Customize colors, greetings, and placement to match your brand and provide a smooth experience across your entire website.
159
160 ## 🔐 Reliable, Fast, Secure
161
162 MxChat is optimized for performance and security. Your AI chatbot runs smoothly, loads fast, and protects your customer data with enterprise-grade security measures.
163
164 ## 🌟 What Makes MxChat the Best AI Chatbot for WordPress?
165
166 - Used by hundreds of WordPress websites worldwide
167 - 5-star average rating from satisfied customers
168 - Native WordPress integration - no external dependencies
169 - Setup in under 2 minutes with simple API key configuration
170
171 ## 🆓 Start with MxChat’s Powerful Free Plan
172
173 MxChat offers a fully functional free plan that includes everything you need to get started with AI chatbot and customer support. With no credit card required, you can:
174
175 - Access all AI models from 6 major providers
176 - AI Content Generator for blog posts and landing pages with SEO scoring and AI auto-optimization
177 - Train chatbot on unlimited website content
178 - Loops email capture for lead generation
179 - Web search and image generation capabilities
180 - Real-time admin debug panel
181 - Chat transcript review and export
182 - RAG support & contextual awareness
183
184 Whether you're running a small business or launching a new online store, MxChat’s free plan gives you the tools to offer intelligent customer support and grow your business — without paying a cent.
185
186 == Developer Hooks & Filters ==
187
188 MxChat provides WordPress filter hooks so developers can extend and customize chatbot behavior without modifying core plugin files. [View full documentation with code examples](https://mxchat.ai/mxchat-developer-hooks-filters/).
189
190 = mxchat_before_process_post =
191
192 Runs during knowledge base indexing and lets you modify a post's data before MxChat processes it. Use this to include custom field data (e.g. product specifications or ACF fields), strip internal content you don't want the chatbot to learn, or transform posts based on bot ID. Receives the WP_Post object and the bot ID.
193
194 = mxchat_system_instructions =
195
196 Dynamically modify the system prompt before every AI response. Use this to inject live data such as business hours, inventory status, or user-specific context into the prompt at runtime. Receives the instructions text, bot ID, and session ID. MxChat also supports WordPress shortcodes directly in the system prompt field — any registered shortcodes are automatically expanded before being sent to the AI.
197
198 ## �
199 Get Started with MxChat AI Chatbot Today
200
201 Installing MxChat for WordPress takes just a few clicks. Get started with our free plan and upgrade anytime to access our complete add-on ecosystem and premium features.
202
203 ## 💰 Pricing
204
205 Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities.
206 [View all pricing options](https://mxchat.ai/)
207
208 == Use of Third-Party Services ==
209
210 This plugin connects to AI service providers to generate responses:
211
212 **Service Providers:**
213 - [OpenRouter](https://openrouter.ai/) - [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy)
214 - [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/)
215 - [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy)
216 - [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy)
217 - [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy)
218 - [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy)
219
220 Please ensure compliance with applicable terms and data privacy laws.
221
222 == Installation ==
223
224 1. Upload the `mxchat-basic` folder to the `/wp-content/plugins/` directory.
225 2. Activate the plugin through the 'Plugins' menu in WordPress.
226 3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings.
227
228 == Frequently Asked Questions ==
229
230 = What AI models does MxChat support? =
231
232 MxChat supports 100+ AI models including OpenAI GPT-5.5, GPT-5.1 Chat Latest, GPT-5, Anthropic Claude Opus 4.8, Claude Sonnet 4.6, Claude Haiku 4.5, Google Gemini 3.5 Flash, Gemini 3.1 Pro, xAI Grok 4, Grok 3, DeepSeek V3, and many more. With OpenRouter integration, you get access to models from OpenAI, Anthropic, Google, Meta, Mistral, and other providers with a single API key.
233
234 = How do I get API keys for the AI chatbot? =
235
236 For OpenAI, visit platform.openai.com and create an account. For Anthropic Claude, visit console.anthropic.com. For Google Gemini, visit ai.google.dev. For xAI Grok, visit x.ai. For DeepSeek, visit platform.deepseek.com. For OpenRouter (100+ models), visit openrouter.ai. Each provider offers different pricing tiers and free credits for new users.
237
238 = Can I train the AI chatbot on my website content? =
239
240 Yes. MxChat supports unlimited knowledge base training using RAG (Retrieval-Augmented Generation) technology. Import content from WordPress pages, posts, WooCommerce products, custom post types, PDFs, Word documents, text files, sitemaps, and manual Q&A entries. The AI chatbot will use your content to provide accurate, contextually relevant responses.
241
242 = What is RAG technology and how does it work? =
243
244 RAG (Retrieval-Augmented Generation) is an AI technique that retrieves relevant information from your knowledge base before generating responses. When a visitor asks a question, MxChat searches your trained content using vector embeddings, finds the most relevant matches, and provides that context to the AI model. This ensures accurate, factual answers based on your actual website content rather than generic AI responses.
245
246 = Does MxChat work with WooCommerce? =
247
248 Yes. MxChat includes full WooCommerce integration. The AI chatbot can be trained on your product catalog including titles, descriptions, pricing, SKUs, categories, and custom fields. Enable auto-sync to automatically update the knowledge base when products change. Your chatbot can answer questions about products, pricing, availability, and help customers find what they need.
249
250 = Can I customize the AI chatbot appearance? =
251
252 Yes. MxChat offers extensive customization options including custom colors, chatbot icon, AI avatar, chat bubble size, light/dark/system themes, positioning (left/right), custom CSS, greeting messages, placeholder text, and widget layouts. Use the built-in AI Theme Generator to describe your ideal design and let AI create custom styling automatically.
253
254 = How do I add the chatbot to my WordPress site? =
255
256 You can add the chatbot using the shortcode `[mxchat_chatbot floating="yes"]` for a floating widget or `[mxchat_chatbot floating="no"]` for an embedded chat. Alternatively, enable "Append to Body" in settings to automatically display the chatbot on all pages without shortcodes.
257
258 = Does MxChat support streaming responses? =
259
260 Yes. MxChat supports real-time streaming responses for OpenAI, Anthropic Claude, xAI Grok, and DeepSeek models. Streaming displays AI responses word-by-word as they're generated, providing a faster, more engaging chat experience for your visitors.
261
262 = What is the Chat Transcripts feature? =
263
264 The Chat Transcripts dashboard provides comprehensive conversation management. View all chat histories, see detailed conversation flows, track which knowledge sources the AI used for each response, monitor user engagement, and analyze chat analytics including daily activity, peak hours, and user distribution.
265
266 = Can I see which content the AI chatbot used to answer questions? =
267
268 Yes. MxChat includes full knowledge source transparency. In the Chat Transcripts and the optional debug panel, you can see exactly which pages, posts, products, or Q&A entries the AI retrieved and used to generate each response, along with relevance scores.
269
270 = Is Pinecone vector database required? =
271
272 No. MxChat includes free, unlimited local vector storage in your WordPress database. Pinecone integration is optional and recommended only for enterprise-scale knowledge bases with thousands of entries requiring faster search performance.
273
274 = Does MxChat support multiple languages? =
275
276 Yes. The AI chatbot supports multi-language conversations and automatically responds in the language your visitors use. MxChat also supports right-to-left (RTL) languages like Arabic and Hebrew.
277
278 = How much do AI API calls cost? =
279
280 API costs depend on your chosen provider and model. OpenAI, Anthropic, Google, and others charge based on token usage. DeepSeek and Google Gemini offer generous free tiers. MxChat includes intelligent token optimization to minimize API costs. You can also set rate limits for guests and logged-in users to control usage.
281
282 = Is MxChat GDPR compliant? =
283
284 Yes. All conversation data is stored locally on your WordPress site, giving you complete control. Configure automatic data retention policies, export chat transcripts, or delete conversations as needed for compliance.
285
286 = Can I restrict chatbot access to certain users? =
287
288 Yes. MxChat includes role-based access controls. Restrict the chatbot to logged-in users only, specific user roles, or keep it public. You can also restrict specific knowledge base content to certain user roles.
289
290 = Does MxChat support live chat handoff? =
291
292 Yes. MxChat integrates with Slack for live agent handoff. When the AI cannot help or a visitor requests human support, conversations can be seamlessly transferred to your team via Slack.
293
294 = What are Actions and how do they work? =
295
296 Actions are capabilities your chatbot can perform — lead capture, appointment booking, support tickets, page redirects, image generation, web search, or custom JavaScript. MxChat gives you two ways to fire them, and you can use either one or both together:
297
298 * **Trigger Phrases** – the original system. A smart vector embedding match fires an action when a visitor's message matches a phrase you've set up. Precise, deterministic control over exactly when each action runs.
299 * **AI Tools (function calling)** – the chatbot decides on its own when to run an enabled action, straight from natural language, with no phrases to configure. The easiest way to get started; it needs a tool-capable AI model.
300
301 Manage both from the Actions area in your MxChat settings, which holds Trigger Phrases and AI Tools side by side.
302
303 = Can visitors upload documents to chat? =
304
305 Yes. Enable document uploads to let visitors chat with PDFs and Word documents. The AI extracts and processes document content in real-time, allowing contextual Q&A about uploaded files.
306
307 = Does MxChat support image generation? =
308
309 Yes. With OpenAI GPT Image and Google Imagen integration, the AI chatbot can generate images based on user descriptions directly within the chat conversation.
310
311 = How does the knowledge base auto-sync work? =
312
313 Enable auto-sync for posts, pages, WooCommerce products, or custom post types. When you publish or update content, MxChat automatically updates the knowledge base with the new information. No manual re-importing required.
314
315 = Can I use Advanced Custom Fields (ACF) with MxChat? =
316
317 Yes. MxChat fully supports Advanced Custom Fields. ACF field data is automatically included when importing content. Use the ACF Field Settings to control which custom fields are included or excluded from the knowledge base—perfect for hiding private notes or internal data from the chatbot.
318
319 = What embedding models does MxChat support? =
320
321 MxChat supports multiple embedding models for vector search including OpenAI text-embedding-ada-002, text-embedding-3-small, text-embedding-3-large, Google Gemini embedding, and Voyage AI embeddings. Choose the model that best fits your accuracy and cost requirements.
322
323 = Is there a free version of MxChat? =
324
325 Yes. MxChat is available for free on the WordPress plugin repository with full AI chatbot functionality. Premium add-ons are available for advanced features like the AI Theme Generator and priority support.
326
327 == Screenshots ==
328
329 1. **Chat Transcripts Insights** - Review and analyze conversations insights to see engagement rate, peak activity, and user distribution.
330 2. **Chat Transcripts Insights** - View 7 day activity trend graph.
331 3. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses.
332 4. **Action Page** - Set up Trigger Phrases and AI Tools (function calling) to complete specific actions.
333 5. **Plugin Settings Page** - Configure your API key and other settings.
334 6. **MxChat Debug Panel** - Easily debug and view your content matching scores, citation URLs, triggered actions and more.
335
336 *(Note: Screenshots will be added in future updates)*
337
338 == Changelog ==
339
340 = 3.2.14 - July 18, 2026 =
341 * New: Editor Assistant — optional AI writing actions right inside the WordPress block editor. Select a paragraph, heading, list, or quote block and rewrite it (concise, expanded, formal, or casual), summarize it, translate it to another language, continue writing, or fix grammar and spelling, then Accept or Discard. It is off by default and uses the AI model you already configured.
342 * New: You can now add YouTube videos to your knowledge base. A new YouTube option on the Import screen takes a video link and, per video, either auto-fetches its title, channel, and captions or lets you write your own description. When a visitor's question matches a video, the answer includes it as a playable embed right inside the chat that loads no YouTube player or Google cookies until the visitor taps play.
343 * New: Live agent handoff can now follow an availability schedule, so visitors are only offered a human during the days and hours your team is actually reachable, and the chatbot simply keeps answering outside them. Slack and Telegram each get their own independent schedule on their own settings tab, so a channel staffed at different hours keeps its own calendar. It is off by default and uses your site timezone.
344 * New: Added the latest OpenAI GPT-5.6 models — Sol, Terra, and Luna — for both your chatbot and content generation.
345 * New: MxChat AI Search now appears on the Pro and Extensions page alongside the other add-ons, so you can discover it from inside your dashboard.
346 * New: Developers can now add their own trusted links to the chatbot's allowed-links list with the new mxchat_valid_urls filter, so links returned by custom function-calling tools stay clickable in replies.
347 * Fixed: Editing a Knowledge Base entry no longer throws away your work. Clicking outside the edit box, or selecting text and releasing the mouse just past its edge, used to close it and discard everything you had typed. The box now closes only when you ask it to — the close or cancel button, the Escape key, or a successful save — and confirms first if you have unsaved changes. The same fix applies to the Add Tool and Edit Tool dialog on the Actions screen.
348 * Fixed: Product and image search now correctly refine your search terms when a GPT-5 model is selected. Previously the refinement step silently stopped working and fell back to the raw text, weakening results.
349 * Fixed: The Telegram live-agent webhook is no longer accepted without verification when a secret token has not been set; requests are now validated by origin and a reminder is shown to configure a secret.
350 * Fixed: The Testing page's chatbot replica now uses the exact same knowledge base as your live chatbot. On sites running Pinecone with the Multi-Bot add-on active, the testing chat was quietly searching the WordPress database instead.
351 * Fixed: Automatic transcript deletion now repairs its own schedule if the scheduled cleanup task is ever lost, so old transcripts no longer stop being deleted while your settings still say retention is on. The Transcripts settings also now show when the next cleanup will run.
352
353 = 3.2.13 - July 10, 2026 =
354 * New: Claude Sonnet 5 is now selectable as both a chat model and a content generation model.
355 * New: The Knowledge Base Custom Post Meta section can scan your content and suggest custom meta keys as clickable options, so you can add non-ACF meta to the embedding whitelist without knowing the exact key names.
356 * Fixed: Knowledge Base imports of PDFs and web pages no longer fail with a 403 error on firewall-protected hosts (SiteGround, Wordfence, Cloudflare) — MXChat now identifies itself with an honest, versioned MXChatBot user agent you can allowlist if needed.
357 * Fixed: PDFs a visitor links in a live chat now use the same MXChatBot identity, so a firewall that allowlists MXChatBot lets them through too.
358 * Fixed: The close button on the pre-chat greeting bubble now works on chatbots with a custom bot ID, including Multi-Bot setups, not just the default chatbot.
359 * Improved: The Custom Post Meta help text now points to the built-in key scanner and notes that array and repeater values are flattened during embedding.
360
361 = 3.2.12 - June 30, 2026 =
362 * Fixed: Resolved a WordPress.org packaging issue from the previous release that could cause the update to fail to download or appear to hang in the WordPress dashboard on some sites. This maintenance release republishes the plugin so every site can update normally and receive the recent improvements from 3.2.11 — including the per-provider Test API key buttons, built-in WPML and Polylang translation for the chat widget, Google Gemini web search, the optional Max Input Length character counter, cleaner Slack live-agent links, the Knowledge View indexed content panel, and the security and Pinecone matching fixes. No functional changes from 3.2.11; no settings or data are affected.
363
364 = 3.2.11 - June 29, 2026 =
365 * New: Each AI provider API key field (OpenAI, X.AI, Claude, DeepSeek, Google Gemini, OpenRouter) now has a Test key button that checks whether the key actually works in one click, so you can confirm a key is valid right after pasting it instead of finding out only when a chat fails. It runs a quick, free validation check and never spends credits.
366 * Fixed: When restricting knowledge by tag under Knowledge then Role Restrictions, you can now enter a tag by its display name or its slug. Previously only the exact slug worked, so typing a real tag's name returned a confusing error; the field is now labeled Tag (name or slug) and gives an actionable message when no matching tag exists.
367 * Fixed: On sites using Pinecone for knowledge, answers added directly through Knowledge then Import Options then Direct Content (manual entries with no source link) are now used by the chatbot when they are the best match. Previously the bot could reply that it did not have the information even though the manual entry clearly matched, and the testing panel showed zero sources used; both are now correct.
368 * New: Built-in WPML and Polylang compatibility for the chat widget text. The widget's visible strings (top bar title, greeting, AI agent label, input placeholder, the email and name capture form copy, and the satisfaction prompts) now show up automatically in WPML String Translation, so you can translate the widget into each language without registering every field by hand.
369 * New: Optional Max Input Length setting caps how many characters a visitor can type or paste into a single message, so you can stop overly long pastes from being sent to the AI. It sits just below the Input Placeholder option in the chatbot settings. Leave it at 0 for unlimited, which is the default and keeps existing behavior unchanged.
370 * Fixed: Security hardening for the chat intro message setting, following a Wordfence advisory. The intro message is now escaped when shown on the settings page and sanitized when saved, so a crafted value can no longer run script in the admin area on multisite sites or sites where unfiltered HTML is disabled.
371 * Fixed: When a live agent replies from Slack with a link, the website visitor now sees a clean, clickable link instead of Slack's raw formatting with a stray closing bracket. Slack user and channel mentions and escaped characters are also tidied up before the message reaches the visitor.
372 * New: The Slack live-agent channel now shows the visitor's name and email at the top of the conversation when they were captured at the start of the chat, so your agent can see who they are talking to instead of just a session ID and a user ID of zero for guests.
373 * Improved: When a maximum message length is set, the chat box now shows a small live character counter as the visitor nears the limit, ramping from a neutral color to amber to red, with a gentle nudge if they reach the cap. This replaces the old behavior where typing past the limit silently did nothing and looked broken. The counter uses only numbers, so it reads correctly on sites in any language.
374 * New: When the built-in Web Search option is on, chatbots using a Google Gemini model now answer using live Google Search results, just like OpenAI models already do. Previously the Web Search setting only affected OpenAI models and silently did nothing for Gemini, so Gemini users had to add the separate Perplexity add-on to get web-grounded answers. Gemini's built-in search uses the Google API key you already configured, at no extra cost.
375 * New: Each Knowledge entry now has a View indexed content button that opens a read-only panel showing exactly what the chatbot indexed for it: the stored text broken into the same chunks the search uses, each chunk's length, and for Pinecone the stored metadata fields. This makes it easy to confirm what was actually saved and searched for a page or a manual entry, so you can tell at a glance why a piece of content is or is not being matched, without changing anything.
376
377 = 3.2.10 - June 19, 2026 =
378 * New: AI Tools (function calling) — the chatbot can now decide on its own when to use your enabled tools, such as web search, image generation, answering from an uploaded PDF, and active add-on actions like WooCommerce, straight from natural language with no trigger phrases to set up. Turn it on under Actions then AI Tools (off by default; needs a tool-capable AI model), add the tools you want with a guided picker, and optionally tell the assistant in plain language when to use each one. Tools that spend money, expose customer data, or hand off to a human stay off until you enable them deliberately
379 * New: Optional "Start new chat" button in the chat window menu — lets visitors clear the current conversation and start fresh in one click, without turning off chat persistence (off by default; enable it under Chatbot then Display, with a customizable label)
380 * Improved: The Actions area is clearer — the original phrase-matching system is now called Trigger Phrases and sits alongside AI Tools under one Actions menu, with AI Tools listed first as the recommended path and a plain-language explainer of when to use each
381 * Improved: Readable, leak-safe AI error messages now cover every provider (Claude, OpenAI, xAI, Google Gemini, DeepSeek and OpenRouter) for both API errors and connection or timeout failures — site admins get an actionable hint such as choosing another model in Settings, while visitors only ever see a friendly fallback and never raw API or network details
382 * Improved: Applying or changing an AI theme, and toggling Pinecone, now auto-clears supported page caches the same way other settings changes do — no more stale widget appearance after a theme change
383 * Fixed: On multi-bot sites, non-streaming replies now correctly use the bot assigned to the visitor's session instead of falling back to the default bot's prompt and knowledge, and a repeated PHP notice in the debug log is gone
384 * Fixed: Images created with the Gemini image generator now display correctly in the chat window — previously the bot reported it had made an image but nothing appeared, because the file was saved with the wrong file type
385 * Fixed: The Slack live-agent setup notice in Settings now links to the current setup guide on the MxChat Core documentation page
386 * Fixed: Two older Claude models that Anthropic has now retired (Claude 4 Opus and Claude 4 Sonnet, the May 2025 versions) have been removed from the model pickers; if your site had either one selected, it is automatically switched to the current equivalent (Claude Opus 4.8 or Claude Sonnet 4.6) so chat keeps working without any action from you
387 = 3.2.9 - June 11, 2026 =
388 * New: Claude Fable 5 — Anthropic's newest flagship model — available in the Select AI Model picker and the Content Generator
389 * Fixed: Claude Opus 4.7 and 4.8 now work as the Content Generator model (these models reject the temperature setting; it is no longer sent)
390 * New: Stop button — visitors can halt a streaming response mid-answer; the text already written is kept
391 * New: "Show Download Transcript Button" toggle to hide the chat menu's Download Transcript item (on by default)
392 * Improved: Settings changes now apply immediately on cached sites — MxChat purges supported page caches on save, and the chat widget fetches fresh settings when opened, so toggles no longer require clearing caches
393 * New: "Images per Article" slider (1–5, default 3) in the Content Generator's image settings
394 * Fixed: Chat widget interface text no longer appears in your pages' Google search-result snippets
395 * Fixed: Admin navigation now displays correctly on right-to-left language sites (Arabic, Hebrew, Persian, and others)
396 * Fixed: In-chat PDF and Word document upload works again, including for signed-in administrators
397 * Fixed: Messages sent right after a bot reply no longer vanish on sites running the Image Analysis add-on
398 * Fixed: The "Was this helpful?" rating prompt only appears when its setting is turned on
399 * Fixed: Rebuilt translation template (mxchat.pot) — syncing a translation no longer discards existing translations
400 * Fixed: PHP 8.2 deprecation notices no longer logged during chat requests
401
402 = 3.2.8 - June 4, 2026 =
403 * New: Total chatbot message limit — one cap across all users and roles per timeframe, with a live usage readout and one-click reset
404 * New: Global and per-role rate limits accept custom values beyond the presets
405 * Improved: Custom Provider and Azure OpenAI embeddings work end-to-end for indexing and live queries (re-index if you had this enabled)
406 * Fixed: Feedback "Send" button no longer renders as an invisible white-on-white block
407
408 = 3.2.7 - May 29, 2026 =
409 * New: Guided onboarding wizard for first-time setup — reopen any time from Settings → Tutorials
410 * New: Claude Opus 4.8 and the Google Gemini 3.x lineup; sites on retired models are migrated automatically
411 * Improved: First message is reliable behind full-page caches (WP Rocket, LiteSpeed, FlyingPress, W3 Total Cache, Cloudflare APO)
412 * Improved: Streaming and standard chat retry transient provider errors before showing a failure
413 * Improved: Floating chat button is fully keyboard-operable (WCAG 2.1 Level A)
414
415 = 3.2.6 - May 21, 2026 =
416 * New: Custom Provider (OpenAI-compatible) — point MxChat at Ollama, LM Studio, vLLM, llama.cpp, or Azure OpenAI, with a Test Connection button
417 * New: End-of-session "Was this helpful?" satisfaction rating with admin reporting and a dashboard card
418 * New: ACF PDF auto-indexing — PDF text from ACF file fields is extracted into the knowledge base (opt-in)
419 * New: Image Quality control for OpenAI GPT Image in the Content Generator
420 * New: Claude Opus 4.7, GPT-5.5, and GPT Image 2 in the model picker
421 * New: REST bulk-delete endpoint for chat sessions and an embedding chunk-metadata filter for developers
422 * Improved: Page-cache plugins are automatically told not to cache the chat endpoint, with a per-plugin status card
423 * Fixed: Intermittent "Access denied" on the first chat message under full-page caching
424 * Fixed: Print preview was blank on pages with MxChat installed
425
426 = 3.2.5 - May 12, 2026 =
427 * New: REST API with bearer-token auth — read transcripts, push knowledge, bulk-delete sessions (disabled by default)
428 * New: Download Transcript menu item — saves the conversation as a Markdown file (replaces Print Conversation)
429 * New: Redesigned chat-widget header with X-close icon and keyboard-accessible 3-dot menu
430 * New: Content Generator writes SEO-title meta for Rank Math/Yoast/AIOSEO and syncs image alt text to the media library
431 * New: Transcript retention setting (1–3650 days) with automatic daily cleanup
432 * Fixed: Header dropdown menu inherits the bubble theme colors instead of hardcoded white
433
434 = 3.2.4 - May 3, 2026 =
435 * Fixed: WooCommerce product Short Description Visual tab broken by a script 404
436 * Fixed: User's last message scrolls to the top after streaming replies
437
438 = 3.2.3 - April 29, 2026 =
439 * New: Embedding model switch protection — warning dialog and admin notice when stored embeddings don't match the selected model
440 * Improved: Landing Page Generator plans more sections and writes fuller copy
441 * Fixed: Landing Page "Full Width" option honored on WordPress block themes
442 * Fixed: Manual knowledge entries no longer cited with internal placeholder URLs
443
444 = 3.2.2 - April 21, 2026 =
445 * New: Lead Management Dashboard — deduplicated lead list with filters, top-pages analytics, CSV export, and one-click jump to conversations
446 * Fixed: Orphaned Pinecone vectors removed when posts or products are unpublished, deleted, or renamed
447 * Fixed: Source and chunk count settings now apply on all retrieval paths
448
449 = 3.2.1 - April 17, 2026 =
450 * Fixed: Admin Testing Tab debug panel missing similarity scores and sources when web search and streaming were both enabled
451 * Fixed: Web search responses now save their sources to chat transcripts
452
453 = 3.2.0 - April 15, 2026 =
454 * New: mxchat_similarity_results filter hook for add-ons
455 * Fixed: Removed attribute injection that conflicted with cache and optimization plugins
456
457 = 3.1.9 - April 7, 2026 =
458 * Fixed: "Session expired" errors caused by session-ownership issues
459
460 = 3.1.8 - April 6, 2026 =
461 * New: Admin Testing Tab — embedded chatbot replica with a real-time debug panel
462 * New: Individual trigger-phrase embeddings for more accurate action matching
463 * New: Loading indicator while chat initializes
464 * Improved: "Delete All" in the Knowledge Base respects the active content-type filter
465
466 = 3.1.7 - April 1, 2026 =
467 * New: Google Drive PDF links auto-convert to direct downloads for knowledge import
468 * Fixed: Chat history not appearing for returning visitors with persistence on and email collection off
469 * Fixed: Lead capture form not displaying for new visitors when email collection is enabled
470 * Fixed: Editing a legacy manual knowledge entry no longer deletes others sharing the same source URL
471
472 = 3.1.6 - March 30, 2026 =
473 * Fixed: Pre-chat popup stays dismissed for 24 hours instead of reappearing on every refresh
474 * Fixed: Chat history not loading for returning visitors
475 * Fixed: Links with special characters being cut off or rendered as plain text
476
477 = 3.1.5 - March 25, 2026 =
478 * New: RAG Chunks Limit setting and tuned source defaults to balance answer quality and token cost
479 * New: Per-page chatbot visibility control from the page editor meta box
480 * Improved: Debugger and transcripts show the actual sources and chunks used
481
482 = 3.1.4 - March 22, 2026 =
483 * New: OpenAI GPT-5.4 family and GPT-5.3 Chat models
484 * New: Editable default prompts for blog posts and landing pages in the Content Generator
485 * New: Inline knowledge-entry editing with automatic re-chunking and re-embedding
486 * New: Sitemap import supports PDF URLs
487
488 = 3.1.3 - March 16, 2026 =
489 * New: Content Calendar tab on the Content page
490 * New: Multi-line chat teaser pop-up messages
491 * Improved: Session cookies deferred until first interaction — passive visitors no longer create sessions
492 * Improved: Markdown table rendering with column alignment and responsive scrolling
493
494 = 3.1.2 - March 13, 2026 =
495 * New: Per-check AI fix buttons and batch "Optimize Selected" on the SEO dashboard
496 * Improved: Image generation upgraded from deprecated DALL-E 3 to GPT Image and Gemini Imagen 4
497 * Fixed: Emojis in bot responses no longer prevent transcripts from saving
498 * Fixed: WooCommerce product cards display correctly in chat transcripts
499 * Fixed: "Optimize All" runs SEO fixes sequentially so they no longer overwrite each other
500
501 = 3.1.1 - March 4, 2026 =
502 * New: SEO analysis panel with real-time scoring and one-click AI Auto-Optimize
503 * New: Google Search Console integration (Pro) in the Content editor
504 * New: Slack agents can hand the conversation back to AI with !endchat, optionally with a farewell message
505 * Fixed: Stale nonce causing "Invalid nonce" errors on sites with full-page caching
506 * Fixed: Security-scanner false positives on transcript and PDF temp files
507
508 = 3.1.0 - March 1, 2026 =
509 * New: mxchat_before_process_post and mxchat_system_instructions filter hooks, with shortcode support in the system prompt
510 * Fixed: Manually entered knowledge content not used despite high similarity scores
511 * Fixed: Chat input remaining blocked after live-agent handoff
512 * Fixed: Pinecone scans failing with text-embedding-3-large (wrong vector dimension)
513 * Fixed: Shortcode stripping losing content on pages with large or deeply nested shortcodes
514
515 = 3.0.9 - February 24, 2026 =
516 * New: AI Content Generator — full blog posts and landing pages from a prompt, with AI images, SEO metadata, live preview, and inline AI editing
517 * New: Advanced Content Editor premium add-on
518 * Improved: Compatibility with optimization and caching plugins
519
520 = 3.0.8 - February 20, 2026 =
521 * New: Debug and optimization tools with log viewer, settings export, and reset options
522 * New: Claude Sonnet 4.6 model
523
524 = 3.0.7 - February 15, 2026 =
525 * Fixed: GPT-5.1 Chat Latest returning an API error when web search was disabled
526
527 = 3.0.6 - February 11, 2026 =
528 * New: RAG Sources Limit slider and {visitor_name} placeholder for personalized greetings
529 * New: Claude Opus 4.6 and Claude Opus 4.5 models
530 * Fixed: Chat persistence OFF now starts a fresh AI context on page reload
531 * Updated: Deprecated OpenAI GPT-4/GPT-3.5 and Claude 3.x models removed; affected sites migrated automatically
532
533 = 3.0.5 - January 28, 2026 =
534 * Fixed: Gemini embedding model updated to the stable gemini-embedding-001
535 * Fixed: Notification settings not saving on new installations
536 * Fixed: Save indicators not visible on several settings fields
537
538 = 3.0.4 - January 24, 2026 =
539 * New: Latest Google Gemini models
540 * New: Transcript translation — auto-translate chat transcripts to any language
541 * Fixed: Lead capture forms broken by multi-bot class ID changes
542
543 = 3.0.3 - January 21, 2026 =
544 * Fixed: Chat input not re-enabling when web search was on
545
546 = 3.0.2 - January 21, 2026 =
547 * New: Telegram Live Agent integration for live chat handoff
548 * New: Citation Links toggle to show or hide source URLs in AI responses
549
550 = 3.0.1 - January 18, 2026 =
551 * New: OpenAI Vector Store integration and custom post-meta whitelist for embeddings
552 * New: Multi-select with bulk "Delete Selected" in the knowledge base
553 * Improved: Chatbot CSS migrated from IDs to classes for multi-bot support (Theme Customizer users: update the add-on and click "Migrate")
554
555 = 3.0.0 - January 14, 2026 =
556 * New: Complete admin UI overhaul with modern sidebar navigation across all pages
557 * New: Automatic sitemap detection with one-click processing
558 * New: Real-time knowledge base updates and improved mobile responsiveness
559
560 Older releases are archived in the plugin's full version history on WordPress.org.
561
562 == Upgrade Notice ==
563
564 = 3.2.14 =
565 Adds the Editor Assistant, YouTube videos in the knowledge base with consent-safe in-chat embeds, independent Slack and Telegram live agent availability schedules, and the latest GPT-5.6 models. Also fixes a Knowledge Base edit data-loss bug, GPT-5 product and image search, and self-healing automatic transcript deletion — existing sites are unaffected until you turn the new features on.
566
567 == License & Warranty ==
568
569 This plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
570
571 This plugin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
572
573 == Credits ==
574
575 This plugin incorporates the following third-party library:
576
577 - **Smalot PDF Parser**: Used for parsing and extracting text from PDF files. This library is developed by Smalot and distributed under the MIT License. For more details, visit the [Smalot PDF Parser GitHub repository](https://github.com/smalot/pdfparser).
578
579 This plugin was developed by [MxChat](https://mxchat.ai/).
580