| @@ -1,556 +1,573 @@ | ||
| 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 | |
| 7 | -Requires PHP: 7.2 | |
| 8 | -Stable tag: 3.2.11 | |
| 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, 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 | -✅ **6 Major AI Providers in One Plugin**: OpenRouter, OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 100+ models instantly | |
| 23 | -✅ **Train on Your Website Data**: Advanced RAG technology learns from sitemaps, PDFs, URLs, or manual input for ultra-relevant responses | |
| 24 | -✅ **Live Agent Handoff via Slack**: Seamlessly escalate from AI to human support when customers need personal assistance | |
| 25 | -✅ **Real-Time Debug Panel**: See exactly what your chatbot retrieves and triggers with our admin testing interface | |
| 26 | -✅ **Boost Sales with WooCommerce**: Product cards, cart management, and AI-powered shopping assistance | |
| 27 | -✅ **AI Content Generator**: Create full blog posts and landing pages with AI-generated images, SEO metadata, and real-time preview editing | |
| 28 | -✅ **Extensive Add-On Ecosystem**: Forms, moderation, recommendations, theme customization, and more | |
| 29 | - | |
| 30 | -🎬 [Quick Setup with MxChat](https://www.youtube.com/watch?v=3BqoiyWaQiM) – Learn how to quickly setup and understand how your chatbot works | |
| 31 | - | |
| 32 | -### 📦 Optional Premium Add-Ons | |
| 33 | -Extend the free plugin with these optional premium features: | |
| 34 | - | |
| 35 | -- [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 | |
| 36 | -- [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 | |
| 37 | -- [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 | |
| 38 | -- [Forms Add-On](https://mxchat.ai/add-ons/mxchat-forms/) – Capture leads and data with custom in-chat forms | |
| 39 | -- [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 | |
| 40 | -- [AI Chatbot Theme Customizer Add-On](https://mxchat.ai/add-ons/mxchat-theme/) – Instantly design chatbot themes with natural language using AI | |
| 41 | -- [Multi-Bot Add-On](https://mxchat.ai/add-ons/mxchat-multi-bot/) – Run unlimited AI chatbots with custom knowledge and personalities | |
| 42 | -- [Image Analysis Add-On](https://mxchat.ai/add-ons/mxchat-vision/) – Enable AI-powered image analysis and OCR inside chats | |
| 43 | - | |
| 44 | -👉 [Visit our website to view all add-ons](https://mxchat.ai) | |
| 45 | - | |
| 46 | -## 🔥 What's New in Version 3.2.9 | |
| 47 | - | |
| 48 | -- **NEW: Stop Button for Streaming Responses** — visitors can halt a streaming answer mid-reply; the send button becomes a Stop control while the bot is typing, keeping the text already written | |
| 49 | -- **NEW: "Images per Article" Slider** — choose how many images (1–5) the Content Generator places in each article, instead of the AI deciding for you | |
| 50 | -- **NEW: Download Transcript Toggle** — show or hide the chat menu's "Download Transcript" item from settings (on by default) | |
| 51 | -- **FIXED: Google Search Snippets** — the chat widget's greeting and quick-question text no longer leak into your pages' search-result snippets | |
| 52 | -- **FIXED: In-Chat Document Upload** — PDF and Word uploads from the chat toolbar work again, whether or not you're signed in | |
| 53 | -- **Plus:** right-to-left admin-navigation fix, a rebuilt translation template so translators stop losing work on updates, satisfaction-prompt and message-loss fixes, and PHP 8.2 cleanup | |
| 54 | - | |
| 55 | -## Core Features That Set MxChat Apart | |
| 56 | - | |
| 57 | -🟢 **100+ AI Models** – Access ChatGPT, Claude, Gemini, Grok, DeepSeek, and 100+ models from OpenRouter with a single plugin | |
| 58 | -🟢 **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 | |
| 59 | -🟢 **Chat Transcripts Dashboard** – Review all conversations, analyze chat history, track user engagement, and see exactly which knowledge sources the AI used for each response | |
| 60 | -🟢 **WooCommerce Product Training** – Train your AI chatbot on your entire product catalog including descriptions, pricing, SKUs, and categories for intelligent shopping assistance | |
| 61 | -🟢 **Live Agent Handoff** – Seamlessly escalate conversations from AI to human support via Slack when customers need personal assistance | |
| 62 | -🟢 **ACF Field Control** – Choose exactly which Advanced Custom Fields are included in your knowledge base—perfect for excluding private notes or internal data | |
| 63 | -🟢 **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 | |
| 64 | -🟢 **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) | |
| 65 | -🟢 **Document Processing** – Let visitors upload and chat with PDFs and Word documents directly on your frontend | |
| 66 | -🟢 **Pinecone Vector Storage** – Optional lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments | |
| 67 | -🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base | |
| 68 | -🟢 **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 | |
| 69 | -🟢 **Image Generation** – OpenAI GPT Image and Google Imagen for visual content creation within chat conversations | |
| 70 | -🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, Grok, and DeepSeek models for the fastest possible chat experience | |
| 71 | -🟢 **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 | |
| 72 | - | |
| 73 | -## Choose from 100+ Premium AI Models | |
| 74 | -Access the world's most advanced AI models based on your specific needs: | |
| 75 | - | |
| 76 | -**OpenRouter**: 100+ models from multiple providers with a single API key – including OpenAI, Anthropic, Google, Meta, Mistral, and more! | |
| 77 | -**OpenAI**: | |
| 78 | -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 | |
| 79 | -**Anthropic Claude**: | |
| 80 | -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 | |
| 81 | -**X.AI**: | |
| 82 | -**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 | |
| 83 | -**Google Gemini**: | |
| 84 | -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 | |
| 85 | -**DeepSeek**: | |
| 86 | -DeepSeek V3 | |
| 87 | - | |
| 88 | -## Lead Management Dashboard — Turn Chat Traffic Into a Real Lead List | |
| 89 | - | |
| 90 | -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. | |
| 91 | - | |
| 92 | -**What You Get:** | |
| 93 | - | |
| 94 | -- **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 | |
| 95 | -- **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 | |
| 96 | -- **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) | |
| 97 | -- **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 | |
| 98 | -- **One-Click View Conversation** — jump from any lead straight into their latest full conversation in the transcripts viewer | |
| 99 | -- **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 | |
| 100 | -- **Clean, Responsive, Native** — works beautifully on desktop, tablet, and phone with the same polished dashboard feel as the rest of MxChat | |
| 101 | -- **Zero Setup, Zero Migration** — uses your existing chat data, no new database tables, no configuration — turn on lead capture and the dashboard just works | |
| 102 | - | |
| 103 | -**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. | |
| 104 | - | |
| 105 | -## AI Content Generator — Create Blog Posts & Landing Pages with AI | |
| 106 | - | |
| 107 | -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. | |
| 108 | - | |
| 109 | -**How It Works:** | |
| 110 | - | |
| 111 | -1. **Describe Your Content** — Enter a topic, title, or detailed prompt and choose between a blog post or landing page layout | |
| 112 | -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 | |
| 113 | -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 | |
| 114 | -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 | |
| 115 | -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 | |
| 116 | - | |
| 117 | -**Key Content Generator Features:** | |
| 118 | - | |
| 119 | -- Choose from multiple AI models for content generation (GPT-5, Claude, Gemini, Grok, and more) | |
| 120 | -- AI-generated images placed directly into your content with automatic media library uploads | |
| 121 | -- SEO title and meta description generation for search engine optimization | |
| 122 | -- Built-in SEO analysis with real-time scoring and one-click AI auto-optimization | |
| 123 | -- Fullwidth and standard layout options with automatic theme compatibility | |
| 124 | -- Content history to revisit and manage previously generated posts | |
| 125 | -- Works with popular page builders and themes including Elementor, Bricks, Divi, Astra, Kadence, and more | |
| 126 | -- 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 | |
| 127 | - | |
| 128 | -## MxChat Anywhere — Deploy Your Chatbot on Any Website | |
| 129 | - | |
| 130 | -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. | |
| 131 | - | |
| 132 | -**Key Features:** | |
| 133 | - | |
| 134 | -- One script tag to add your chatbot to any site — no coding or framework required | |
| 135 | -- Full style isolation via Shadow DOM so host page CSS never breaks your chatbot | |
| 136 | -- All your MxChat settings carry over automatically — colors, themes, quick questions, email collection, streaming, and more | |
| 137 | -- Multi-bot support lets you deploy different chatbot configurations on different sites | |
| 138 | -- Secure domain whitelisting and API key authentication prevent unauthorized usage | |
| 139 | -- Lightweight vanilla JS widget with zero dependencies — no jQuery needed on the target site | |
| 140 | - | |
| 141 | -**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. | |
| 142 | - | |
| 143 | -## Powerful Add-On Ecosystem | |
| 144 | - | |
| 145 | -**Pro Add-Ons:** | |
| 146 | -🟢 **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. | |
| 147 | -🟢 **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 | |
| 148 | -🟢 **Multi-Bot Manager** – Create and manage multiple specialized chatbots with dedicated knowledge databases for different purposes (support, sales, technical, etc.) | |
| 149 | -🟢 **Video Generation** – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios | |
| 150 | -🟢 **Admin Assistant** – ChatGPT-like interface in WordPress admin with thread management and image generation | |
| 151 | -🟢 **Chat Themes** – Visual design editor with AI-powered chatbot theme generation from natural language | |
| 152 | -🟢 **MxChat Forms** – Create chatbot-triggered forms for lead capture and support tickets | |
| 153 | -🟢 **Chat Moderation** – Advanced security with email/IP banning and content filtering | |
| 154 | -🟢 **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 | |
| 155 | -🟢 **Perplexity Integration** – Real-time web search with authoritative, well-sourced responses | |
| 156 | -🟢 **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 | |
| 157 | - | |
| 158 | -## 📱 Mobile-Friendly & Fully Customizable | |
| 159 | - | |
| 160 | -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. | |
| 161 | - | |
| 162 | -## 🔐 Reliable, Fast, Secure | |
| 163 | - | |
| 164 | -MxChat is optimized for performance and security. Your AI chatbot runs smoothly, loads fast, and protects your customer data with enterprise-grade security measures. | |
| 165 | - | |
| 166 | -## 🌟 What Makes MxChat the Best AI Chatbot for WordPress? | |
| 167 | - | |
| 168 | -- Used by hundreds of WordPress websites worldwide | |
| 169 | -- 5-star average rating from satisfied customers | |
| 170 | -- Native WordPress integration - no external dependencies | |
| 171 | -- Setup in under 2 minutes with simple API key configuration | |
| 172 | - | |
| 173 | -## 🆓 Start with MxChat’s Powerful Free Plan | |
| 174 | - | |
| 175 | -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: | |
| 176 | - | |
| 177 | -- Access all AI models from 6 major providers | |
| 178 | -- AI Content Generator for blog posts and landing pages with SEO scoring and AI auto-optimization | |
| 179 | -- Train chatbot on unlimited website content | |
| 180 | -- Loops email capture for lead generation | |
| 181 | -- Web search and image generation capabilities | |
| 182 | -- Real-time admin debug panel | |
| 183 | -- Chat transcript review and export | |
| 184 | -- RAG support & contextual awareness | |
| 185 | - | |
| 186 | -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. | |
| 187 | - | |
| 188 | -== Developer Hooks & Filters == | |
| 189 | - | |
| 190 | -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/). | |
| 191 | - | |
| 192 | -= mxchat_before_process_post = | |
| 193 | - | |
| 194 | -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. | |
| 195 | - | |
| 196 | -= mxchat_system_instructions = | |
| 197 | - | |
| 198 | -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. | |
| 199 | - | |
| 200 | -## ✅ Get Started with MxChat AI Chatbot Today | |
| 201 | - | |
| 202 | -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. | |
| 203 | - | |
| 204 | -## 💰 Pricing | |
| 205 | - | |
| 206 | -Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities. | |
| 207 | -[View all pricing options](https://mxchat.ai/) | |
| 208 | - | |
| 209 | -== Use of Third-Party Services == | |
| 210 | - | |
| 211 | -This plugin connects to AI service providers to generate responses: | |
| 212 | - | |
| 213 | -**Service Providers:** | |
| 214 | -- [OpenRouter](https://openrouter.ai/) - [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy) | |
| 215 | -- [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/) | |
| 216 | -- [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy) | |
| 217 | -- [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy) | |
| 218 | -- [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy) | |
| 219 | -- [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy) | |
| 220 | - | |
| 221 | -Please ensure compliance with applicable terms and data privacy laws. | |
| 222 | - | |
| 223 | -== Installation == | |
| 224 | - | |
| 225 | -1. Upload the `mxchat-basic` folder to the `/wp-content/plugins/` directory. | |
| 226 | -2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 227 | -3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 228 | - | |
| 229 | -== Frequently Asked Questions == | |
| 230 | - | |
| 231 | -= What AI models does MxChat support? = | |
| 232 | - | |
| 233 | -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. | |
| 234 | - | |
| 235 | -= How do I get API keys for the AI chatbot? = | |
| 236 | - | |
| 237 | -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. | |
| 238 | - | |
| 239 | -= Can I train the AI chatbot on my website content? = | |
| 240 | - | |
| 241 | -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. | |
| 242 | - | |
| 243 | -= What is RAG technology and how does it work? = | |
| 244 | - | |
| 245 | -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. | |
| 246 | - | |
| 247 | -= Does MxChat work with WooCommerce? = | |
| 248 | - | |
| 249 | -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. | |
| 250 | - | |
| 251 | -= Can I customize the AI chatbot appearance? = | |
| 252 | - | |
| 253 | -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. | |
| 254 | - | |
| 255 | -= How do I add the chatbot to my WordPress site? = | |
| 256 | - | |
| 257 | -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. | |
| 258 | - | |
| 259 | -= Does MxChat support streaming responses? = | |
| 260 | - | |
| 261 | -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. | |
| 262 | - | |
| 263 | -= What is the Chat Transcripts feature? = | |
| 264 | - | |
| 265 | -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. | |
| 266 | - | |
| 267 | -= Can I see which content the AI chatbot used to answer questions? = | |
| 268 | - | |
| 269 | -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. | |
| 270 | - | |
| 271 | -= Is Pinecone vector database required? = | |
| 272 | - | |
| 273 | -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. | |
| 274 | - | |
| 275 | -= Does MxChat support multiple languages? = | |
| 276 | - | |
| 277 | -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. | |
| 278 | - | |
| 279 | -= How much do AI API calls cost? = | |
| 280 | - | |
| 281 | -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. | |
| 282 | - | |
| 283 | -= Is MxChat GDPR compliant? = | |
| 284 | - | |
| 285 | -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. | |
| 286 | - | |
| 287 | -= Can I restrict chatbot access to certain users? = | |
| 288 | - | |
| 289 | -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. | |
| 290 | - | |
| 291 | -= Does MxChat support live chat handoff? = | |
| 292 | - | |
| 293 | -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. | |
| 294 | - | |
| 295 | -= What are Actions and how do they work? = | |
| 296 | - | |
| 297 | -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: | |
| 298 | - | |
| 299 | -* **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. | |
| 300 | -* **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. | |
| 301 | - | |
| 302 | -Manage both from the Actions area in your MxChat settings, which holds Trigger Phrases and AI Tools side by side. | |
| 303 | - | |
| 304 | -= Can visitors upload documents to chat? = | |
| 305 | - | |
| 306 | -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. | |
| 307 | - | |
| 308 | -= Does MxChat support image generation? = | |
| 309 | - | |
| 310 | -Yes. With OpenAI GPT Image and Google Imagen integration, the AI chatbot can generate images based on user descriptions directly within the chat conversation. | |
| 311 | - | |
| 312 | -= How does the knowledge base auto-sync work? = | |
| 313 | - | |
| 314 | -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. | |
| 315 | - | |
| 316 | -= Can I use Advanced Custom Fields (ACF) with MxChat? = | |
| 317 | - | |
| 318 | -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. | |
| 319 | - | |
| 320 | -= What embedding models does MxChat support? = | |
| 321 | - | |
| 322 | -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. | |
| 323 | - | |
| 324 | -= Is there a free version of MxChat? = | |
| 325 | - | |
| 326 | -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. | |
| 327 | - | |
| 328 | -== Screenshots == | |
| 329 | - | |
| 330 | -1. **Chat Transcripts Insights** - Review and analyze conversations insights to see engagement rate, peak activity, and user distribution. | |
| 331 | -2. **Chat Transcripts Insights** - View 7 day activity trend graph. | |
| 332 | -3. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 333 | -4. **Action Page** - Set up Trigger Phrases and AI Tools (function calling) to complete specific actions. | |
| 334 | -5. **Plugin Settings Page** - Configure your API key and other settings. | |
| 335 | -6. **MxChat Debug Panel** - Easily debug and view your content matching scores, citation URLs, triggered actions and more. | |
| 336 | - | |
| 337 | -*(Note: Screenshots will be added in future updates)* | |
| 338 | - | |
| 339 | -== Changelog == | |
| 340 | - | |
| 341 | -= 3.2.11 - June 29, 2026 = | |
| 342 | -* 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. | |
| 343 | -* 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. | |
| 344 | -* 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. | |
| 345 | -* 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. | |
| 346 | -* 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. | |
| 347 | -* 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. | |
| 348 | -* 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. | |
| 349 | -* 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. | |
| 350 | -* 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. | |
| 351 | -* 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. | |
| 352 | -* 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. | |
| 353 | - | |
| 354 | -= 3.2.10 - June 19, 2026 = | |
| 355 | -* 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 | |
| 356 | -* 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) | |
| 357 | -* 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 | |
| 358 | -* 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 | |
| 359 | -* 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 | |
| 360 | -* 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 | |
| 361 | -* 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 | |
| 362 | -* Fixed: The Slack live-agent setup notice in Settings now links to the current setup guide on the MxChat Core documentation page | |
| 363 | -* 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 | |
| 364 | -= 3.2.9 - June 11, 2026 = | |
| 365 | -* New: Claude Fable 5 — Anthropic's newest flagship model — available in the Select AI Model picker and the Content Generator | |
| 366 | -* 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) | |
| 367 | -* New: Stop button — visitors can halt a streaming response mid-answer; the text already written is kept | |
| 368 | -* New: "Show Download Transcript Button" toggle to hide the chat menu's Download Transcript item (on by default) | |
| 369 | -* 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 | |
| 370 | -* New: "Images per Article" slider (1–5, default 3) in the Content Generator's image settings | |
| 371 | -* Fixed: Chat widget interface text no longer appears in your pages' Google search-result snippets | |
| 372 | -* Fixed: Admin navigation now displays correctly on right-to-left language sites (Arabic, Hebrew, Persian, and others) | |
| 373 | -* Fixed: In-chat PDF and Word document upload works again, including for signed-in administrators | |
| 374 | -* Fixed: Messages sent right after a bot reply no longer vanish on sites running the Image Analysis add-on | |
| 375 | -* Fixed: The "Was this helpful?" rating prompt only appears when its setting is turned on | |
| 376 | -* Fixed: Rebuilt translation template (mxchat.pot) — syncing a translation no longer discards existing translations | |
| 377 | -* Fixed: PHP 8.2 deprecation notices no longer logged during chat requests | |
| 378 | - | |
| 379 | -= 3.2.8 - June 4, 2026 = | |
| 380 | -* New: Total chatbot message limit — one cap across all users and roles per timeframe, with a live usage readout and one-click reset | |
| 381 | -* New: Global and per-role rate limits accept custom values beyond the presets | |
| 382 | -* Improved: Custom Provider and Azure OpenAI embeddings work end-to-end for indexing and live queries (re-index if you had this enabled) | |
| 383 | -* Fixed: Feedback "Send" button no longer renders as an invisible white-on-white block | |
| 384 | - | |
| 385 | -= 3.2.7 - May 29, 2026 = | |
| 386 | -* New: Guided onboarding wizard for first-time setup — reopen any time from Settings → Tutorials | |
| 387 | -* New: Claude Opus 4.8 and the Google Gemini 3.x lineup; sites on retired models are migrated automatically | |
| 388 | -* Improved: First message is reliable behind full-page caches (WP Rocket, LiteSpeed, FlyingPress, W3 Total Cache, Cloudflare APO) | |
| 389 | -* Improved: Streaming and standard chat retry transient provider errors before showing a failure | |
| 390 | -* Improved: Floating chat button is fully keyboard-operable (WCAG 2.1 Level A) | |
| 391 | - | |
| 392 | -= 3.2.6 - May 21, 2026 = | |
| 393 | -* New: Custom Provider (OpenAI-compatible) — point MxChat at Ollama, LM Studio, vLLM, llama.cpp, or Azure OpenAI, with a Test Connection button | |
| 394 | -* New: End-of-session "Was this helpful?" satisfaction rating with admin reporting and a dashboard card | |
| 395 | -* New: ACF PDF auto-indexing — PDF text from ACF file fields is extracted into the knowledge base (opt-in) | |
| 396 | -* New: Image Quality control for OpenAI GPT Image in the Content Generator | |
| 397 | -* New: Claude Opus 4.7, GPT-5.5, and GPT Image 2 in the model picker | |
| 398 | -* New: REST bulk-delete endpoint for chat sessions and an embedding chunk-metadata filter for developers | |
| 399 | -* Improved: Page-cache plugins are automatically told not to cache the chat endpoint, with a per-plugin status card | |
| 400 | -* Fixed: Intermittent "Access denied" on the first chat message under full-page caching | |
| 401 | -* Fixed: Print preview was blank on pages with MxChat installed | |
| 402 | - | |
| 403 | -= 3.2.5 - May 12, 2026 = | |
| 404 | -* New: REST API with bearer-token auth — read transcripts, push knowledge, bulk-delete sessions (disabled by default) | |
| 405 | -* New: Download Transcript menu item — saves the conversation as a Markdown file (replaces Print Conversation) | |
| 406 | -* New: Redesigned chat-widget header with X-close icon and keyboard-accessible 3-dot menu | |
| 407 | -* New: Content Generator writes SEO-title meta for Rank Math/Yoast/AIOSEO and syncs image alt text to the media library | |
| 408 | -* New: Transcript retention setting (1–3650 days) with automatic daily cleanup | |
| 409 | -* Fixed: Header dropdown menu inherits the bubble theme colors instead of hardcoded white | |
| 410 | - | |
| 411 | -= 3.2.4 - May 3, 2026 = | |
| 412 | -* Fixed: WooCommerce product Short Description Visual tab broken by a script 404 | |
| 413 | -* Fixed: User's last message scrolls to the top after streaming replies | |
| 414 | - | |
| 415 | -= 3.2.3 - April 29, 2026 = | |
| 416 | -* New: Embedding model switch protection — warning dialog and admin notice when stored embeddings don't match the selected model | |
| 417 | -* Improved: Landing Page Generator plans more sections and writes fuller copy | |
| 418 | -* Fixed: Landing Page "Full Width" option honored on WordPress block themes | |
| 419 | -* Fixed: Manual knowledge entries no longer cited with internal placeholder URLs | |
| 420 | - | |
| 421 | -= 3.2.2 - April 21, 2026 = | |
| 422 | -* New: Lead Management Dashboard — deduplicated lead list with filters, top-pages analytics, CSV export, and one-click jump to conversations | |
| 423 | -* Fixed: Orphaned Pinecone vectors removed when posts or products are unpublished, deleted, or renamed | |
| 424 | -* Fixed: Source and chunk count settings now apply on all retrieval paths | |
| 425 | - | |
| 426 | -= 3.2.1 - April 17, 2026 = | |
| 427 | -* Fixed: Admin Testing Tab debug panel missing similarity scores and sources when web search and streaming were both enabled | |
| 428 | -* Fixed: Web search responses now save their sources to chat transcripts | |
| 429 | - | |
| 430 | -= 3.2.0 - April 15, 2026 = | |
| 431 | -* New: mxchat_similarity_results filter hook for add-ons | |
| 432 | -* Fixed: Removed attribute injection that conflicted with cache and optimization plugins | |
| 433 | - | |
| 434 | -= 3.1.9 - April 7, 2026 = | |
| 435 | -* Fixed: "Session expired" errors caused by session-ownership issues | |
| 436 | - | |
| 437 | -= 3.1.8 - April 6, 2026 = | |
| 438 | -* New: Admin Testing Tab — embedded chatbot replica with a real-time debug panel | |
| 439 | -* New: Individual trigger-phrase embeddings for more accurate action matching | |
| 440 | -* New: Loading indicator while chat initializes | |
| 441 | -* Improved: "Delete All" in the Knowledge Base respects the active content-type filter | |
| 442 | - | |
| 443 | -= 3.1.7 - April 1, 2026 = | |
| 444 | -* New: Google Drive PDF links auto-convert to direct downloads for knowledge import | |
| 445 | -* Fixed: Chat history not appearing for returning visitors with persistence on and email collection off | |
| 446 | -* Fixed: Lead capture form not displaying for new visitors when email collection is enabled | |
| 447 | -* Fixed: Editing a legacy manual knowledge entry no longer deletes others sharing the same source URL | |
| 448 | - | |
| 449 | -= 3.1.6 - March 30, 2026 = | |
| 450 | -* Fixed: Pre-chat popup stays dismissed for 24 hours instead of reappearing on every refresh | |
| 451 | -* Fixed: Chat history not loading for returning visitors | |
| 452 | -* Fixed: Links with special characters being cut off or rendered as plain text | |
| 453 | - | |
| 454 | -= 3.1.5 - March 25, 2026 = | |
| 455 | -* New: RAG Chunks Limit setting and tuned source defaults to balance answer quality and token cost | |
| 456 | -* New: Per-page chatbot visibility control from the page editor meta box | |
| 457 | -* Improved: Debugger and transcripts show the actual sources and chunks used | |
| 458 | - | |
| 459 | -= 3.1.4 - March 22, 2026 = | |
| 460 | -* New: OpenAI GPT-5.4 family and GPT-5.3 Chat models | |
| 461 | -* New: Editable default prompts for blog posts and landing pages in the Content Generator | |
| 462 | -* New: Inline knowledge-entry editing with automatic re-chunking and re-embedding | |
| 463 | -* New: Sitemap import supports PDF URLs | |
| 464 | - | |
| 465 | -= 3.1.3 - March 16, 2026 = | |
| 466 | -* New: Content Calendar tab on the Content page | |
| 467 | -* New: Multi-line chat teaser pop-up messages | |
| 468 | -* Improved: Session cookies deferred until first interaction — passive visitors no longer create sessions | |
| 469 | -* Improved: Markdown table rendering with column alignment and responsive scrolling | |
| 470 | - | |
| 471 | -= 3.1.2 - March 13, 2026 = | |
| 472 | -* New: Per-check AI fix buttons and batch "Optimize Selected" on the SEO dashboard | |
| 473 | -* Improved: Image generation upgraded from deprecated DALL-E 3 to GPT Image and Gemini Imagen 4 | |
| 474 | -* Fixed: Emojis in bot responses no longer prevent transcripts from saving | |
| 475 | -* Fixed: WooCommerce product cards display correctly in chat transcripts | |
| 476 | -* Fixed: "Optimize All" runs SEO fixes sequentially so they no longer overwrite each other | |
| 477 | - | |
| 478 | -= 3.1.1 - March 4, 2026 = | |
| 479 | -* New: SEO analysis panel with real-time scoring and one-click AI Auto-Optimize | |
| 480 | -* New: Google Search Console integration (Pro) in the Content editor | |
| 481 | -* New: Slack agents can hand the conversation back to AI with !endchat, optionally with a farewell message | |
| 482 | -* Fixed: Stale nonce causing "Invalid nonce" errors on sites with full-page caching | |
| 483 | -* Fixed: Security-scanner false positives on transcript and PDF temp files | |
| 484 | - | |
| 485 | -= 3.1.0 - March 1, 2026 = | |
| 486 | -* New: mxchat_before_process_post and mxchat_system_instructions filter hooks, with shortcode support in the system prompt | |
| 487 | -* Fixed: Manually entered knowledge content not used despite high similarity scores | |
| 488 | -* Fixed: Chat input remaining blocked after live-agent handoff | |
| 489 | -* Fixed: Pinecone scans failing with text-embedding-3-large (wrong vector dimension) | |
| 490 | -* Fixed: Shortcode stripping losing content on pages with large or deeply nested shortcodes | |
| 491 | - | |
| 492 | -= 3.0.9 - February 24, 2026 = | |
| 493 | -* New: AI Content Generator — full blog posts and landing pages from a prompt, with AI images, SEO metadata, live preview, and inline AI editing | |
| 494 | -* New: Advanced Content Editor premium add-on | |
| 495 | -* Improved: Compatibility with optimization and caching plugins | |
| 496 | - | |
| 497 | -= 3.0.8 - February 20, 2026 = | |
| 498 | -* New: Debug and optimization tools with log viewer, settings export, and reset options | |
| 499 | -* New: Claude Sonnet 4.6 model | |
| 500 | - | |
| 501 | -= 3.0.7 - February 15, 2026 = | |
| 502 | -* Fixed: GPT-5.1 Chat Latest returning an API error when web search was disabled | |
| 503 | - | |
| 504 | -= 3.0.6 - February 11, 2026 = | |
| 505 | -* New: RAG Sources Limit slider and {visitor_name} placeholder for personalized greetings | |
| 506 | -* New: Claude Opus 4.6 and Claude Opus 4.5 models | |
| 507 | -* Fixed: Chat persistence OFF now starts a fresh AI context on page reload | |
| 508 | -* Updated: Deprecated OpenAI GPT-4/GPT-3.5 and Claude 3.x models removed; affected sites migrated automatically | |
| 509 | - | |
| 510 | -= 3.0.5 - January 28, 2026 = | |
| 511 | -* Fixed: Gemini embedding model updated to the stable gemini-embedding-001 | |
| 512 | -* Fixed: Notification settings not saving on new installations | |
| 513 | -* Fixed: Save indicators not visible on several settings fields | |
| 514 | - | |
| 515 | -= 3.0.4 - January 24, 2026 = | |
| 516 | -* New: Latest Google Gemini models | |
| 517 | -* New: Transcript translation — auto-translate chat transcripts to any language | |
| 518 | -* Fixed: Lead capture forms broken by multi-bot class ID changes | |
| 519 | - | |
| 520 | -= 3.0.3 - January 21, 2026 = | |
| 521 | -* Fixed: Chat input not re-enabling when web search was on | |
| 522 | - | |
| 523 | -= 3.0.2 - January 21, 2026 = | |
| 524 | -* New: Telegram Live Agent integration for live chat handoff | |
| 525 | -* New: Citation Links toggle to show or hide source URLs in AI responses | |
| 526 | - | |
| 527 | -= 3.0.1 - January 18, 2026 = | |
| 528 | -* New: OpenAI Vector Store integration and custom post-meta whitelist for embeddings | |
| 529 | -* New: Multi-select with bulk "Delete Selected" in the knowledge base | |
| 530 | -* Improved: Chatbot CSS migrated from IDs to classes for multi-bot support (Theme Customizer users: update the add-on and click "Migrate") | |
| 531 | - | |
| 532 | -= 3.0.0 - January 14, 2026 = | |
| 533 | -* New: Complete admin UI overhaul with modern sidebar navigation across all pages | |
| 534 | -* New: Automatic sitemap detection with one-click processing | |
| 535 | -* New: Real-time knowledge base updates and improved mobile responsiveness | |
| 536 | - | |
| 537 | -Older releases are archived in the plugin's full version history on WordPress.org. | |
| 538 | - | |
| 539 | -== Upgrade Notice == | |
| 540 | - | |
| 541 | -= 3.2.11 - June 29, 2026 = | |
| 542 | -Adds a Test key button to each AI provider API key field so you can confirm a provider key works in one click without spending credits. Adds built-in WPML and Polylang compatibility, so the chat widget's visible text appears automatically in WPML String Translation and can be translated per language without hand-registering each field. Knowledge Role Restrictions now accept a tag by its display name or its slug, with a clearer field label and an actionable error, so entering a real tag by its name no longer returns a confusing "tag does not exist" message. Also fixes Pinecone sites silently ignoring manual Direct Content knowledge entries when one was the best match, so the bot now answers from them as expected. Adds an optional Max Input Length setting to cap how many characters a visitor can send in one message (0 means unlimited, the default, so existing sites are unchanged); when a cap is set, the chat box now shows a language-neutral live character counter that ramps from neutral to amber to red as the visitor nears the limit, with a gentle nudge at the cap, instead of silently refusing further typing. Extends the built-in Web Search option to Google Gemini chat models, which now answer using live Google Search results (previously Web Search only worked for OpenAI models and was a silent no-op for Gemini), using the Gemini API key already configured and at no extra cost. Includes a security hardening fix for the chat intro message setting following a Wordfence advisory. Also improves the Slack live-agent integration: visitors now receive clean clickable links from agents instead of Slack's raw formatting, and the Slack channel shows the visitor's name and email at the top of the conversation. Adds a View indexed content button on each Knowledge entry that opens a read-only panel showing exactly what was indexed for it, including the stored text split into the same chunks the search uses, each chunk's length, and any stored metadata, so you can confirm what a page or manual entry actually saved without changing anything. | |
| 543 | - | |
| 544 | -== License & Warranty == | |
| 545 | - | |
| 546 | -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. | |
| 547 | - | |
| 548 | -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. | |
| 549 | - | |
| 550 | -== Credits == | |
| 551 | - | |
| 552 | -This plugin incorporates the following third-party library: | |
| 553 | - | |
| 554 | -- **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). | |
| 555 | - | |
| 556 | -This plugin was developed by [MxChat](https://mxchat.ai/). | |
| 1 | +=== MxChat - AI Chatbot for WordPress === | |
| 2 | +Contributors: mxchat | |
| 3 | +Author: [MxChat](https://mxchat.ai) | |
| 4 | +Tags: AI, Chatbot, ChatGPT, Live Chat, Live Support | |
| 5 | +Requires at least: 5.0 | |
| 6 | +Tested up to: 6.8 | |
| 7 | +Requires PHP: 7.2 | |
| 8 | +Stable tag: 2.4.6 | |
| 9 | +License: GPLv2 or later | |
| 10 | +License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 11 | + | |
| 12 | +AI chatbot with OpenAI, Gemini, Claude, Grok, DeepSeek, live agent, PDF uploads, WooCommerce, and training on website data. | |
| 13 | + | |
| 14 | +== Description == | |
| 15 | + | |
| 16 | +[Documentation](https://mxchat.ai/documentation/) | |
| 17 | + | |
| 18 | +### 📦 Optional Premium Add-Ons | |
| 19 | +Extend the free plugin with these optional premium features: | |
| 20 | + | |
| 21 | +- [Forms Action Add-On](https://mxchat.ai/forms-action/) – Capture leads and data with custom in-chat forms | |
| 22 | +- [WooCommerce Add-On](https://mxchat.ai/woocommerce/) – AI-powered shopping assistance and product recommendations | |
| 23 | +- [AI Theme Customizer Add-On](https://mxchat.ai/ai-theme-customizer/) – Instantly design chatbot themes with natural language | |
| 24 | +- [Multi-Bot Add-On](https://mxchat.ai/multi-bot/) – Run unlimited AI chatbots with custom knowledge and personalities | |
| 25 | +- [Image Analysis Add-On](https://mxchat.ai/image-analysis/) – Enable AI-powered image analysis and OCR inside chats | |
| 26 | + | |
| 27 | +👉 [Visit our website to view all add-ons](https://mxchat.ai) | |
| 28 | + | |
| 29 | +### 🎥 Product Demo Videos | |
| 30 | +[Explore all product videos on YouTube](https://www.youtube.com/@MxChat/videos) | |
| 31 | + | |
| 32 | +## Why Choose MxChat AI Chatbot for Your WordPress Website? | |
| 33 | + | |
| 34 | +✅ **5 Major AI Providers in One Plugin**: OpenAI GPT, Claude, Gemini, xAI Grok, and DeepSeek - switch between 25+ models instantly | |
| 35 | +✅ **Train on Your Website Data**: Advanced RAG technology learns from sitemaps, PDFs, URLs, or manual input for ultra-relevant responses | |
| 36 | +✅ **Live Agent Handoff via Slack**: Seamlessly escalate from AI to human support when customers need personal assistance | |
| 37 | +✅ **Real-Time Debug Panel**: See exactly what your chatbot retrieves and triggers with our admin testing interface | |
| 38 | +✅ **Boost Sales with WooCommerce**: Product cards, cart management, and AI-powered shopping assistance | |
| 39 | +✅ **Extensive Add-On Ecosystem**: Forms, moderation, recommendations, theme customization, and more | |
| 40 | + | |
| 41 | +## 🔥 What's New in Version 2.4.4 | |
| 42 | + | |
| 43 | +🐞 **Bug Fixes** | |
| 44 | +- Default similarity is now accurate across all settings | |
| 45 | +- Improved streaming responses to prevent dropped characters or words | |
| 46 | + | |
| 47 | +⚡ **Enhancements** | |
| 48 | +- Removed unnecessary Pinecone caching in the knowledge database for more accurate results | |
| 49 | + | |
| 50 | +## Core Features That Set MxChat Apart | |
| 51 | + | |
| 52 | +🟢 **Advanced Action Recognition** – Smart vector embedding system understands user intent and triggers precise actions automatically | |
| 53 | +🟢 **AI Theme Generator** – Describe your ideal design in plain English and watch AI create custom CSS styling in real-time | |
| 54 | +🟢 **Pinecone Vector Storage** – Lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments | |
| 55 | +🟢 **Document Processing** – Users can upload and chat with PDFs and Word documents directly on your frontend | |
| 56 | +🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base | |
| 57 | +🟢 **Image Generation** – DALL-E integration for visual content creation within chat conversations | |
| 58 | +🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, and Grok models for the fastest possible chat experience | |
| 59 | + | |
| 60 | +## Choose from 25+ Premium AI Models | |
| 61 | + | |
| 62 | +Access the world's most advanced AI models based on your specific needs: | |
| 63 | + | |
| 64 | +**OpenAI**: GPT-5, GPT-5-mini, GPT-5-nano, GPT-4.1, GPT-4o, GPT-4o-mini, GPT-4-turbo, GPT-4, GPT-3.5-turbo | |
| 65 | +**X.AI**: Grok-4, Grok-3, Grok-3 Fast, Grok-3 Mini, Grok-3 Mini Fast, Grok-2 | |
| 66 | +**Claude**: Claude 4 Sonnet, Claude 4 Opus, Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3 Opus | |
| 67 | +**DeepSeek**: DeepSeek V3 | |
| 68 | +**Google Gemini**: Gemini 2.0 Flash, Gemini 2.0 Flash-Lite, Gemini 1.5 Pro, Gemini 1.5 Flash | |
| 69 | + | |
| 70 | +## Supercharge Your eCommerce with AI | |
| 71 | + | |
| 72 | +Transform online shopping with intelligent assistance through direct WooCommerce integration: | |
| 73 | + | |
| 74 | +- Engage visitors in real time with product-aware conversations | |
| 75 | +- Recommend products and upsell with native WooCommerce product cards | |
| 76 | +- Access order history, inventory, and customer data seamlessly | |
| 77 | +- Convert passive users into paying customers with live support | |
| 78 | +- Handle order inquiries and status updates directly through chat | |
| 79 | + | |
| 80 | +## Powerful Add-On Ecosystem | |
| 81 | + | |
| 82 | +**Pro Add-Ons:** | |
| 83 | +🟢 **Multi-Bot Manager** – Create and manage multiple specialized chatbots with dedicated knowledge databases for different purposes (support, sales, technical, etc.) | |
| 84 | +🟢 **Video Generation** – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios | |
| 85 | +🟢 **Admin Assistant** – ChatGPT-like interface in WordPress admin with thread management and image generation | |
| 86 | +🟢 **Theme Customizer** – Visual design editor with AI-powered chatbot theme generation from natural language | |
| 87 | +🟢 **MxChat Forms** – Create chatbot-triggered forms for lead capture and support tickets | |
| 88 | +🟢 **Chat Moderation** – Advanced security with email/IP banning and content filtering | |
| 89 | +🟢 **Smart Recommender** – Intelligent recommendation flows with customizable matching algorithms | |
| 90 | +🟢 **Perplexity Integration** – Real-time web search with authoritative, well-sourced responses | |
| 91 | + | |
| 92 | +## 📱 Mobile-Friendly & Fully Customizable | |
| 93 | + | |
| 94 | +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. | |
| 95 | + | |
| 96 | +## 🔐 Reliable, Fast, Secure | |
| 97 | + | |
| 98 | +MxChat is optimized for performance and security. Your AI chatbot runs smoothly, loads fast, and protects your customer data with enterprise-grade security measures. | |
| 99 | + | |
| 100 | +## 🌟 What Makes MxChat the Best AI Chatbot for WordPress? | |
| 101 | + | |
| 102 | +- Used by hundreds of WordPress websites worldwide | |
| 103 | +- 5-star average rating from satisfied customers | |
| 104 | +- Native WordPress integration - no external dependencies | |
| 105 | +- Setup in under 2 minutes with simple API key configuration | |
| 106 | + | |
| 107 | +## 🆓 Start with MxChat’s Powerful Free Plan | |
| 108 | + | |
| 109 | +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: | |
| 110 | + | |
| 111 | +- Access all AI models from 5 major providers | |
| 112 | +- Train chatbot on unlimited website content | |
| 113 | +- Loops email capture for lead generation | |
| 114 | +- Web search and image generation capabilities | |
| 115 | +- Real-time admin debug panel | |
| 116 | +- Chat transcript review and export | |
| 117 | +- RAG support & contextual awareness | |
| 118 | + | |
| 119 | +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. | |
| 120 | + | |
| 121 | +## ✅ Get Started with MxChat AI Chatbot Today | |
| 122 | + | |
| 123 | +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. | |
| 124 | + | |
| 125 | +## 💰 Pricing | |
| 126 | + | |
| 127 | +Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities. | |
| 128 | +[View all pricing options](https://mxchat.ai/) | |
| 129 | + | |
| 130 | +== Use of Third-Party Services == | |
| 131 | + | |
| 132 | +This plugin connects to AI service providers to generate responses: | |
| 133 | + | |
| 134 | +**Service Providers:** | |
| 135 | +- [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/) | |
| 136 | +- [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy) | |
| 137 | +- [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy) | |
| 138 | +- [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy) | |
| 139 | +- [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy) | |
| 140 | + | |
| 141 | +Please ensure compliance with applicable terms and data privacy laws. | |
| 142 | + | |
| 143 | +== Installation == | |
| 144 | + | |
| 145 | +1. Upload the `mxchat` folder to the `/wp-content/plugins/` directory. | |
| 146 | +2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 147 | +3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 148 | + | |
| 149 | +== Frequently Asked Questions == | |
| 150 | + | |
| 151 | +### How do I obtain an API key for OpenAI? | |
| 152 | + | |
| 153 | +You can obtain an API key by signing up on the OpenAI website. Once you have the API key, enter it in the plugin settings to start using the AI chatbot. | |
| 154 | + | |
| 155 | +### Can I customize the chatbot’s appearance? | |
| 156 | + | |
| 157 | +Yes, the **Pro version** offers extensive **theme customization options**, including the ability to change the chatbot’s colors, fonts, and background to match your website’s design. | |
| 158 | + | |
| 159 | +### How do I add the chatbot to my site? | |
| 160 | + | |
| 161 | +You can add the chatbot to your site using the `[mxchat_chatbot floating="yes"]` or `[mxchat_chatbot floating="no"]` shortcode. Additionally, you can automatically append the chatbot to your site’s body element from the settings page. | |
| 162 | + | |
| 163 | +### How does the knowledge submission feature work? | |
| 164 | + | |
| 165 | +You can submit custom content to the knowledge base from the 'Knowledge' submenu. This content is processed using vector embeddings, allowing the AI chatbot to provide more accurate and contextually relevant responses. | |
| 166 | + | |
| 167 | +### What is the sitemap submission feature? | |
| 168 | + | |
| 169 | +The sitemap submission feature allows you to submit a sitemap URL. The plugin will fetch, extract, and add content from the URLs listed in the sitemap to the chatbot’s knowledge base, enhancing the AI’s ability to provide precise and contextually relevant answers. | |
| 170 | + | |
| 171 | +== Screenshots == | |
| 172 | + | |
| 173 | +1. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 174 | +2. **Action Page** - Set custom action triggers to complete specific actions. | |
| 175 | +3. **Plugin Settings Page** - Configure your API key and other settings. | |
| 176 | +4. **Add-ons Page** - Extend MxChat’s functionality with add-ons to customize your needs. | |
| 177 | +5. **Activation Page** - Easily upgrade to MxChat Pro by entering your activation key. Unlock advanced features like theme customization directly from the MxChat settings page. | |
| 178 | +6. **Chat Transcripts** - Review and analyze conversations to refine your AI chatbot. | |
| 179 | + | |
| 180 | +*(Note: Screenshots will be added in future updates)* | |
| 181 | + | |
| 182 | +== Changelog == | |
| 183 | + | |
| 184 | += 2.4.6 - October, 3, 2025 = | |
| 185 | +- Update: Added plugin URI information. | |
| 186 | + | |
| 187 | += 2.4.5 - September 30, 2025 = | |
| 188 | +- Bug Fix: Restored missing CSS properties for popular questions collapse/toggle buttons that were accidentally removed during code cleanup. | |
| 189 | +- Bug Fix: Fixed button hover, focus, and active states for question navigation controls. | |
| 190 | +- Bug Fix: Restored proper SVG styling and display logic for collapsible question buttons. | |
| 191 | + | |
| 192 | += 2.4.4 - September 24, 2025 = | |
| 193 | +- Bug Fix: Default similarity is now accurate across all settings. | |
| 194 | +- Bug Fix: Improved streaming responses to prevent dropped characters or words. | |
| 195 | +- Enhanced: Removed unnecessary Pinecone caching in the knowledge database for more accurate results. | |
| 196 | + | |
| 197 | += 2.4.3 - September 23, 2025 = | |
| 198 | +- Added: Support for upcoming multi-bot update that allows for more customized settings such as individual chat models. | |
| 199 | +- Improved: CSS for chatbot UI & more robust markdown support. | |
| 200 | + | |
| 201 | += 2.4.2 - September 18, 2025 = | |
| 202 | +- Added: Multi-bot support via the new Multi-Bot Manager premium add-on. | |
| 203 | +- Improved: Minor CSS adjustments for better compatibility. | |
| 204 | +- Updated: Add-on links and references throughout the plugin. | |
| 205 | + | |
| 206 | += 2.4.1 - September 4, 2025 = | |
| 207 | +- Fixed: Email collection form not submitting properly when "Require email to chat" is enabled. | |
| 208 | +- Improved: PDF processing now provides clearer error messages with repair suggestions when corrupted files are detected. | |
| 209 | + | |
| 210 | += 2.4.0 - September 3, 2025 = | |
| 211 | +- Added new MxChat Video Generation add-on with support for Google Veo 2 and Veo 3 models, featuring audio generation and multiple aspect ratios. | |
| 212 | +- Fixed console error when "Require email to chat" option is disabled by adding proper validation check. | |
| 213 | +- Resolved "error chat history not found" message when chat persistence is enabled but user has no existing chat history. | |
| 214 | +- Fixed agent indicator not updating properly when switching between live agent and chatbot modes without page refresh. | |
| 215 | + | |
| 216 | += 2.3.9 - August 17, 2025 = | |
| 217 | +- Updated Slack channel naming logic to prioritize client’s name, falling back to email, then chat ID. | |
| 218 | +- Added streaming response support for DeepSeek models. | |
| 219 | +- Enabled multiple direct content entries without requiring a source URL. | |
| 220 | +- Fixed auto sync drafts so posts moved from posted to draft are removed from the knowledge database. | |
| 221 | +- Implemented role-based chatbot information access restrictions for enhanced security and relevance. | |
| 222 | +- Added option in the admin panel’s post edit page to hide the floating chatbot on specific pages. | |
| 223 | + | |
| 224 | += 2.3.8 - August 12, 2025 = | |
| 225 | +- Fixed extra backslashes appearing in knowledgebase content during editing. | |
| 226 | +- Added optional name field to Require Email to Chat form; transcripts now display email and name if enabled. | |
| 227 | +- Updated Slack channel naming for live agent notifications: uses user's email if logged in, email if Require Email to Chat is enabled, or chat ID otherwise. | |
| 228 | + | |
| 229 | += 2.3.7 - August 8, 2025 = | |
| 230 | +- New Models: Added GPT-5 family (GPT-5, GPT-5 Mini, GPT-5 Nano) to expand capabilities with faster, smarter, and more cost-efficient options. | |
| 231 | += 2.3.6 - August 6, 2025 = | |
| 232 | +- Bug Fix: Fixed streaming fallback to properly display responses when streaming fails, preventing blank chat bubbles. | |
| 233 | +- New Feature: Added streaming test button to help users verify if streaming is compatible with their setup. | |
| 234 | + | |
| 235 | += 2.3.5 - August 6, 2025 = | |
| 236 | +- Redesigned chat transcript UI for a cleaner, more professional experience. | |
| 237 | +- Transcripts now show the page where the chat started and any links clicked. | |
| 238 | +- Added ability to select and delete transcripts directly from the header. | |
| 239 | + | |
| 240 | += 2.3.4 - July 30, 2025 = | |
| 241 | +- Fixed streaming compatibility issues with Cloudflare and WP Engine by implementing automatic fallback to regular chat when streaming is buffered. | |
| 242 | +- Enhanced email capture intents to use AI-generated conversational responses instead of hard-coded messages, allowing for more natural user interactions while maintaining the same functionality. | |
| 243 | + | |
| 244 | += 2.3.3 - July 29, 2025 = | |
| 245 | +- Improved streaming performance by fixing output buffering issues using enhanced flush logic. | |
| 246 | +- Added contextual awareness support via the new `data-mxchat-context` HTML attribute. | |
| 247 | +- Revamped license key management system with domain linking, deactivation, and real-time usage dashboard. | |
| 248 | +- Fixed transcript timestamp display to use WordPress site's local timezone correctly. | |
| 249 | + | |
| 250 | += 2.3.2 - July 24, 2025 = | |
| 251 | +- Added full support for OpenAI Assistants API via the new Assistant add-on. | |
| 252 | +- Improved email collection form performance and reliability with better loading states and timeout handling. | |
| 253 | +- Enhanced WooCommerce product labeling accuracy in WordPress import with improved URL matching. | |
| 254 | +- Fixed ACF field processing errors when handling WP_Post objects and relationship fields. | |
| 255 | + | |
| 256 | += 2.3.1 - July 20, 2025 = | |
| 257 | +- Enhanced hyperlink functionality to include mailto links, enabling email addresses in bot responses to be clickable. | |
| 258 | +- Added full support for the new MxChat Image Analysis add-on, allowing users to upload and analyze images directly in chat using OpenAI Vision and Grok APIs. | |
| 259 | +- Added message filtering hooks system for developers to customize prompts and responses without modifying core plugin files. | |
| 260 | + | |
| 261 | += 2.3.0 - July 13, 2025 = | |
| 262 | +- Added Grok-4 model support, the world's smartest AI model available. | |
| 263 | +- Added streaming response support for all Grok models (Grok-4, Grok-3, etc.), delivering real-time response generation for faster and smoother chat experiences. | |
| 264 | + | |
| 265 | += 2.2.9 - July 6, 2025 = | |
| 266 | +- Improved quick question UI: suggestions now collapse after user input and can be toggled with up/down icons | |
| 267 | +- Increased sitemap batch processing limit from 5 to 50 for faster indexing | |
| 268 | +- Expanded action similarity threshold range to support values from 10 to 95 | |
| 269 | + | |
| 270 | += 2.2.8 - June 27, 2025 = | |
| 271 | +- Added brand new contextual awareness option that automatically provides chatbot access to current page content and URL for contextually relevant responses | |
| 272 | +- Enhanced WordPress knowledge base import to include Advanced Custom Fields (ACF) data for more comprehensive content training | |
| 273 | +- Major README structure update with improved formatting and visual presentation | |
| 274 | + | |
| 275 | += 2.2.7 = | |
| 276 | +- Fixed a bug that occured when deleting all pinecone records & added support for markdown hyperlinking in rate limit messages. | |
| 277 | + | |
| 278 | += 2.2.6 = | |
| 279 | +- Brand New Admin Debug Panel – Added a comprehensive frontend debug panel for administrators! You can now see retrieved documents, triggered actions, and other debug and setting information in real-time while testing your chatbot, making it easier than ever to fine-tune your bot's performance. | |
| 280 | +- Fixed Pinecone Single Entry Deletion – Resolved a bug that prevented individual entries from being properly deleted from Pinecone vector storage. | |
| 281 | +- Improved Pinecone UI Records Retrieval – Enhanced the Pinecone database panel with better record loading and display functionality for smoother management of your vector database. | |
| 282 | +- Fixed WordPress KB Entry Editing – Resolved an issue where editing knowledge base entries in the WordPress database wasn't working properly, ensuring seamless content management. | |
| 283 | + | |
| 284 | += 2.2.5 = | |
| 285 | +- Streaming Response Support – You can now enable streaming responses for OpenAI and Claude models. This delivers a faster, smoother chat experience for users by displaying replies in real-time as they’re generated. | |
| 286 | +- Slack Live Agent Fix – Resolved a minor bug that occasionally caused duplicate messages in Slack during live agent conversations. | |
| 287 | +- Pinecone UI Update – Fixed a UI display issue in the Pinecone database panel when using the TE3 model. | |
| 288 | + | |
| 289 | += 2.2.4 = | |
| 290 | +- Critical update to error when working with large databases in Pinecone. | |
| 291 | + | |
| 292 | += 2.2.3 = | |
| 293 | +- Various critical bug fixes that occured from the codebase refactoring. | |
| 294 | + | |
| 295 | += 2.2.2 = | |
| 296 | +- Enhanced Slack integration: live agent handoff now creates new Slack channels per conversation; agents can reply directly in channel to chat with website users. | |
| 297 | +- Major codebase refactoring for improved organization and optimization. | |
| 298 | +- Improved sitemap and PDF processing: added retry mechanism, display of failed pages/URLs, and manual batch processing button. | |
| 299 | +- Fixed Pinecone setting not toggling on for users who previously did not have the add-on. | |
| 300 | + | |
| 301 | += 2.2.1 = | |
| 302 | +- Added Claude Sonnet 4 and Claude Opus 4 chat models. | |
| 303 | +- Integrated Google Gemini embedding model (gemini-embedding-exp-03-07). | |
| 304 | +- Built Pinecone vector database support directly into core plugin. | |
| 305 | +- Removed dependency on separate Pinecone add-on. | |
| 306 | + | |
| 307 | += 2.2.0 = | |
| 308 | +- Added WordPress Content Importer for posts and pages. | |
| 309 | +- Implemented tabbed interface for knowledge base management. | |
| 310 | +- Added content filtering by type and knowledge base status. | |
| 311 | +- Added bulk import with real-time progress tracking. | |
| 312 | + | |
| 313 | += 2.1.9 = | |
| 314 | +- Added email notification feature for new chat sessions. | |
| 315 | +- Implemented pagination on transcripts page (50 per page) to improve performance. | |
| 316 | +- Fixed bug with Brave image search not returning images correctly from the API. | |
| 317 | +- Enhanced performance by changing chat transcripts to disable autoload. | |
| 318 | + | |
| 319 | += 2.1.7 = | |
| 320 | +- Fixed Pro activation issues when the plugin has been translated. | |
| 321 | +- Improved tab behavior to always default to the first tab. | |
| 322 | +- Major rework to rate limits: added custom rate limit timeframes and messages for each individual role. | |
| 323 | +- Added support for new MxChat Smart Recommender add-on. | |
| 324 | +- Fixed bug with Loops where manual list selection from dropdown was required for functionality. | |
| 325 | + | |
| 326 | += 2.1.6 = | |
| 327 | +- Added new AI models: GPT-4.1 and the complete suite of Grok 3 models. | |
| 328 | +- Updated AI service providers to use their official SVG logos for better visual representation. | |
| 329 | +- Fixed an issue where API key fields would try to autosave when no data was entered. | |
| 330 | +- Various other minor bug fixes for improved stability and performance. | |
| 331 | + | |
| 332 | += 2.1.5 = | |
| 333 | +- Added RTL Language support, allowing languages that align right to automatically do so in both chat input and AI responses. | |
| 334 | +- Improved error messaging for API calls in the frontend of the chatbot, and enhanced error messages when submitting sitemaps, URLs, and PDFs. | |
| 335 | +- Fixed an auto save issue that caused an error if no changes were made. | |
| 336 | +- Various other minor bug fixes for improved stability and performance. | |
| 337 | + | |
| 338 | += 2.1.4 = | |
| 339 | +- Added the ability to easily customize the "AI Agent" text displayed in the top bar for greater personalization. | |
| 340 | +- Fixed a bug where data scraping failed to retrieve all content from certain websites. | |
| 341 | +- Added HTML support in the intro message for richer customization. | |
| 342 | +- Resolved an issue where API input fields triggered browser autofill, improving user input accuracy. | |
| 343 | + | |
| 344 | += 2.1.3 = | |
| 345 | +- Added support for Google Gemini models: Gemini 2.0 Flash, Gemini 2.0 Flash-Lite, Gemini 1.5 Pro, and Gemini 1.5 Flash. | |
| 346 | +- Improved chat model selection UI for a more intuitive user experience. | |
| 347 | +- Redesigned embedding model selection UI for better clarity and usability. | |
| 348 | +- Enhanced error handling for sitemap submissions with more helpful user feedback. | |
| 349 | +- Fixed an issue in the knowledge database where editing entries erased or prevented changes to citation URLs. | |
| 350 | + | |
| 351 | += 2.1.2 = | |
| 352 | +- Rebranded intents page to "Actions" with a revamped UI, displaying pro/add-on requirements and brief descriptions. | |
| 353 | +- Added ability to toggle actions on/off without deleting; moved image generation action from pro to free tier. | |
| 354 | +- Introduced advanced knowledge base sync feature to pull in custom post data. | |
| 355 | + | |
| 356 | += 2.1.1 = | |
| 357 | +- Made Claude and X.AI API models available to all users. | |
| 358 | +- Improved API key management UI - only showing relevant API key fields based on selected models. | |
| 359 | +- Enhanced knowledge import interface with clear credit requirement warnings. | |
| 360 | +- Fixed embedding error notifications for better clarity. | |
| 361 | + | |
| 362 | += 2.1.0 = | |
| 363 | +- Fixed a bug impacting the header color in the output. | |
| 364 | +- Updated embedding error notification when submitting sitemaps or PDFs. | |
| 365 | +- Improved context extraction parser. | |
| 366 | + | |
| 367 | += 2.0.9 = | |
| 368 | +- Revamped UI on the main settings page to match the rest of the plugin. | |
| 369 | +- Added real-time updates for sitemap and PDF processing. | |
| 370 | +- Renamed "MxChat Intent Tester" add-on to "MxChat Similarity Tester". | |
| 371 | +- Various minor bug fixes and improvements. | |
| 372 | + | |
| 373 | += 2.0.8 = | |
| 374 | +- Minor bug fix impacting similarity adjustment. | |
| 375 | + | |
| 376 | += 2.0.7 = | |
| 377 | +- **Perplexity Integration Add-On** – Added Perplexity web search, integrated into intent management with a toolbar toggle. | |
| 378 | +- **Sonnet 3.7 Support** – Introduced Anthropic’s Claude Sonnet 3.7, the latest high-intelligence model. | |
| 379 | +- **Bug Fixes & Improvements** – Fixed title tag formatting in responses and tightened knowledge database similarity range to 20. | |
| 380 | + | |
| 381 | += 2.0.5 = | |
| 382 | +- **Auto-Expanding AI Instructions** – AI instructions text field now auto-expands to fit content. | |
| 383 | +- **Chat Transcripts UI & Export** – Redesigned chat transcripts UI and added Excel export feature. | |
| 384 | +- **Quick Questions Rebrand** – Renamed "Popular Questions" to "Quick Questions" with updated copy. | |
| 385 | +- **Security Enhancement** – Improved security to better prevent XSS attacks. | |
| 386 | +- **Intent Testing Add-On** – Integrated new Intent Tester add-on for enhanced chatbot performance. | |
| 387 | + | |
| 388 | += 2.0.4 = | |
| 389 | +- **Markdown Response Fix** – Resolved markdown formatting issues in the chatbot UI. | |
| 390 | +- **Agent Mode Customization** – Improved indicator text theme and background styling. | |
| 391 | +- **WooCommerce Core Extraction** – Moved WooCommerce features to the dedicated MxChat WooCommerce add-on. | |
| 392 | + | |
| 393 | += 2.0.3 = | |
| 394 | +- **Bug Fix:** Resolved issues preventing DeepSeek and Claude models from working correctly. | |
| 395 | +- **New:** Added integration for the MxChat Form Collection add-on (Pro only). | |
| 396 | +- **New:** Forms now display dynamically within the chat interface in real-time. | |
| 397 | +- **New:** Automatic intent handling for seamless form triggering. | |
| 398 | +- **Update:** Improved submission management with CSV export functionality. | |
| 399 | + | |
| 400 | += 2.0.2 = | |
| 401 | +- **Bug Fix:** Auto-sync now properly deletes posts/pages when enabled. | |
| 402 | +- **Update:** Theme customization moved to an add-on with live preview support. | |
| 403 | +- **New:** Added MxChat Moderation plugin to ban users by email or IP. | |
| 404 | + | |
| 405 | += 2.0.1 = | |
| 406 | +- **Bug Fix:** Fixed a DivisionByZeroError in sitemap processing that occurred when submitting an empty or malformed sitemap. | |
| 407 | +- **Bug Fix:** Resolved a similar DivisionByZeroError in PDF processing to prevent crashes when handling PDFs with 0 pages. | |
| 408 | + | |
| 409 | += 2.0.0 = | |
| 410 | +- **New UI & Branding:** Redesigned the entire plugin interface to align with the new MXChat brand for a modern and seamless experience. | |
| 411 | +- **Add-Ons System Introduced:** Added a dedicated Add-Ons page, allowing users to extend the plugin with optional features. Add-ons are completely optional and do not impact core functionality. | |
| 412 | +- **First Add-On Released – Pinecone DB Manager:** Now available for free! This add-on provides an intuitive interface for managing your Pinecone vector database directly within MXChat. | |
| 413 | + | |
| 414 | += 1.6.5 = | |
| 415 | +- Optimized knowledge database retrieval to prevent memory issues with large product databases (2000+ products) | |
| 416 | +- Fixed bug with tab switching control in chat interface | |
| 417 | + | |
| 418 | += 1.6.4 = | |
| 419 | +- Added chat notifications for improved user experience when chat persistence is enabled. | |
| 420 | +- Made the entire plugin fully translatable, allowing compatibility with translation services like Loco Translate. | |
| 421 | +- Improved Slack integration: When a user requests a live agent, the last five messages from the conversation are now sent to Slack for better context. | |
| 422 | + | |
| 423 | += 1.6.4 = | |
| 424 | +- Added chat notifications for improved user experience when chat persistence is enabled. | |
| 425 | +- Made the entire plugin fully translatable, allowing compatibility with translation services like Loco Translate. | |
| 426 | +- Improved Slack integration: When a user requests a live agent, the last five messages from the conversation are now sent to Slack for better context. | |
| 427 | + | |
| 428 | += 1.6.3 = | |
| 429 | +- Added the new "Rate Limit by User Role" feature, replacing the previous rate limit for logged-in users. | |
| 430 | +- Introduced DeepSeek as a new AI service provider, with full support for their models. | |
| 431 | +- Integrated DeepSeek V3, enhancing chatbot natural language understanding and performance. | |
| 432 | + | |
| 433 | += 1.6.2 = | |
| 434 | +- Fixed a bug preventing the ability to save edits in the knowledge database. | |
| 435 | + | |
| 436 | += 1.6.0 = | |
| 437 | +- Redesigned knowledgebase UI for a cleaner, more user-friendly interface. | |
| 438 | +- Introduced auto-sync functionality for posts and pages, enabling automatic addition of new or updated content to the knowledgebase. | |
| 439 | +- Enhanced XML sitemap submission to prevent duplicate entries by checking and updating existing pages or adding new ones as needed. | |
| 440 | +- Reworked chatbot settings to enable individual autosave after updates, removing the need for manual saving. | |
| 441 | +- Fixed paragraph formatting in the chatbot UI to display line breaks and improve readability. | |
| 442 | + | |
| 443 | += 1.5.9 = | |
| 444 | +- Enhanced transcripts page with new analytics dashboard and improved UI | |
| 445 | +- Added support for X.AI's Grok model | |
| 446 | +- Improved message formatting to preserve paragraphs in intro messages | |
| 447 | +- Updated admin panel interface with better organization and styling | |
| 448 | +- Added better mobile responsiveness across admin screens | |
| 449 | + | |
| 450 | += 1.5.8 = | |
| 451 | +- Introduced a new setting to require an email address before starting a chat. When enabled, this email will be displayed at the top of the chat transcript if needed. | |
| 452 | + | |
| 453 | += 1.5.7 = | |
| 454 | +- Enhanced Complianz plugin integration to support the premium version and improve reliability. | |
| 455 | +- Fixed an issue where names were not appearing in chat transcripts for logged-in users. | |
| 456 | +- Added the ability to customize the title bar icon in the theme settings. | |
| 457 | +- Grouped intents by category in dropdown menus for better organization and usability. | |
| 458 | + | |
| 459 | += 1.5.6 = | |
| 460 | +- Improved "Add to Cart" and product recommendation intents for WooCommerce. | |
| 461 | +- Enhanced Brave Search intent for more accurate and structured results. | |
| 462 | +- Added an **Edit** button to the intent management section for easier adjustments. | |
| 463 | +- Fixed the Word document upload toolbar button for seamless functionality. | |
| 464 | + | |
| 465 | += 1.5.5 = | |
| 466 | +- Chat transcripts now display in newest-to-oldest order and are mobile responsive. | |
| 467 | +- Updated various setting texts with clearer descriptions for better usability. | |
| 468 | +- Fixed issue with rate limit not working properly. | |
| 469 | +- Added Word document upload to the frontend toolbar for direct chatbot interface use. | |
| 470 | +- Improved chatbot's contextual response accuracy. | |
| 471 | +- Major enhancements to "Add to Cart," "Checkout," and "Chat with PDF via URL" intents. | |
| 472 | + | |
| 473 | += 1.5.4 = | |
| 474 | +- Enhanced chat transcripts layout for improved readability, better formatting support (e.g., bold, italics), and inclusion of test agent names from **MxChat AI Agents**. | |
| 475 | +- Introduced **MxChat AI Agents**, now available free for Pro users for a limited time, providing a revolutionary way to test and deploy your chatbot. | |
| 476 | + | |
| 477 | += 1.5.3 = | |
| 478 | +- Major bug fix to the similarity threshold comparison which prevented the chatbot from finding relevant content. | |
| 479 | + | |
| 480 | += 1.5.2 = | |
| 481 | +- Enhanced checkout intent functionality to work more robustly, no longer requiring add-to-cart intent trigger. | |
| 482 | +- Fixed issue with send button not displaying properly on iPhone/iOS devices. | |
| 483 | +- Added admin control for similarity threshold matching to fine-tune relevant content results. | |
| 484 | + | |
| 485 | += 1.5.1 = | |
| 486 | +- Vastly improved the ability for the chatbot to give contextually relevant responses from the knowledge database. | |
| 487 | +- Fixed the issue with loops in the lead capture intent. | |
| 488 | +- Updated the PDF upload icon in the frontend chatbot UI to a clearer design, now showing a PDF file icon. | |
| 489 | +- Enhanced the order history intent, recommendation intent, and product card intent for more robust and contextually relevant responses. | |
| 490 | + | |
| 491 | += 1.5 = | |
| 492 | +- **Live Agent Transfer**: Seamless integration for live agent handoffs and AI chatbot switching. | |
| 493 | +- **PDF Toolbar**: Added PDF upload to the chatbot interface and knowledge base processing with cron jobs. | |
| 494 | + | |
| 495 | += 1.4.6 = | |
| 496 | +- **Product Recommendation Intent**: Added personalized product recommendations based on order history, cart contents, and trending items. | |
| 497 | +- **Custom Chatbot Icon**: Users can upload custom PNG icons for a more personalized chatbot appearance. | |
| 498 | +- **Codeblock Copy Button**: Introduced a copy button for codeblocks to simplify copying code snippets. | |
| 499 | +- **Expanded Popular Questions**: Increased flexibility by allowing more than the default three popular questions. | |
| 500 | +- **CSS Compatibility Fixes**: Improved chatbot CSS for better theme compatibility. | |
| 501 | + | |
| 502 | += 1.4.5 = | |
| 503 | +- **Fixed "Open Links in New Tab" Setting**: Resolved an issue where the setting to open links in a new tab was not functioning as expected. | |
| 504 | + | |
| 505 | += 1.4.4 = | |
| 506 | +- **Custom Rate Limits**: Set different rate limits for logged-in and logged-out users. | |
| 507 | +- **PDF Intent Enhancements**: Added customizable trigger, success, and error messages, plus a max PDF page limit setting. | |
| 508 | +- **Improved Flexibility**: Greater control over chatbot behavior and user interactions. | |
| 509 | + | |
| 510 | += 1.4.3 = | |
| 511 | +- **PDF Intent**: Added support for processing and analyzing PDF content via provided URLs using vector embeddings. | |
| 512 | +- **Compatibility Fix**: Fixed a rendering issue that prevented the chatbot from displaying in certain environments. | |
| 513 | + | |
| 514 | += 1.4.2 = | |
| 515 | +- **Fixed Knowledge Search**: Fixed a bug impacting the ability to search knowledge database information. | |
| 516 | + | |
| 517 | += 1.4.1 = | |
| 518 | +- **Fixed Intent Loading Issue**: Fixed a bug which prevented new intents from being shown on certain installs. | |
| 519 | + | |
| 520 | += 1.4 = | |
| 521 | +- **Customizable Sensitivity Threshold**: Added support for individual sensitivity thresholds on each intent, offering more precise control over intent recognition. | |
| 522 | +- **Enhanced Usability Improvements**: Introduced a "Delete All" button for quick knowledgebase management, resolved activation key UI issues to prevent unnecessary re-activation, and improved chatbot viewport scrolling for better visibility of longer responses. | |
| 523 | + | |
| 524 | += 1.3 = | |
| 525 | +- **Advanced Intent Recognition**: Introduced vector embedding for enhanced intent detection, improving chatbot responsiveness. | |
| 526 | +- **New Integrations**: Added **Brave Web Search**, **Brave Image Search**, and **DALL-E Image Generation** intents. | |
| 527 | +- **Security Update**: Minor update to unserialization handling for enhanced security. | |
| 528 | + | |
| 529 | += 1.2.1 = | |
| 530 | +- **Product Card Display**: Added a dynamic product card for WooCommerce users, showing product image, price, and an "Add to Cart" button triggered by product-related keywords. | |
| 531 | +- Enhanced **Popular Questions** and **Pre-Chat Message** functionalities for improved user engagement and streamlined chat initiation. | |
| 532 | + | |
| 533 | += 1.2 = | |
| 534 | +- Added **Popular Questions Buttons** with one free question and two available in the **Pro version**. | |
| 535 | +- Added **Inline Edit Button** to the Knowledge Database for easy content management. | |
| 536 | + | |
| 537 | += 1.1.9 = | |
| 538 | +- Added integration with Claude (Anthropic) API (Pro feature) for advanced conversational models like `Claude 3.5 Sonnet` and `Claude 3 Haiku`. | |
| 539 | + | |
| 540 | += 1.1.8 = | |
| 541 | +- Added integration with X.AI API (Pro feature) for advanced chat completions using models like `grok-beta`. | |
| 542 | +- Introduced new model selection dropdown that separates OpenAI and X.AI models, with X.AI models disabled for free users. | |
| 543 | +- Enhanced API key management, allowing users to input and manage both OpenAI and X.AI API keys in settings. | |
| 544 | + | |
| 545 | += 1.1.7 = | |
| 546 | +* Added chat session persistence option for users to maintain conversations across visits for up to 24 hours. | |
| 547 | +* Updated navigation tabs CSS and scripts to prevent conflicts with other plugins. | |
| 548 | +* Rate limit settings are now available to all users, offering better control over chat usage. | |
| 549 | + | |
| 550 | += 1.1.6 = | |
| 551 | +* Minor CSS update. | |
| 552 | + | |
| 553 | += 1.1.5 = | |
| 554 | +* Fixed error when users didn't have WooCommerce it would return "Error communicating with server". | |
| 555 | + | |
| 556 | +== Upgrade Notice == | |
| 557 | + | |
| 558 | += 2.4.6 = | |
| 559 | +- Update: Added plugin URI information. | |
| 560 | + | |
| 561 | +== License & Warranty == | |
| 562 | + | |
| 563 | +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. | |
| 564 | + | |
| 565 | +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. | |
| 566 | + | |
| 567 | +== Credits == | |
| 568 | + | |
| 569 | +This plugin incorporates the following third-party library: | |
| 570 | + | |
| 571 | +- **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). | |
| 572 | + | |
| 573 | +This plugin was developed by [MxChat](https://mxchat.ai/). | |
