| @@ -1,527 +1,272 @@ | ||
| 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.9 | |
| 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** – Smart vector embedding system understands user intent and triggers lead capture, appointments, redirects, and custom actions automatically | |
| 64 | -🟢 **Document Processing** – Let visitors upload and chat with PDFs and Word documents directly on your frontend | |
| 65 | -🟢 **Pinecone Vector Storage** – Optional lightning-fast knowledge retrieval for large datasets and enterprise-scale deployments | |
| 66 | -🟢 **Web Search Integration** – Brave search provides real-time information beyond your knowledge base | |
| 67 | -🟢 **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 | |
| 68 | -🟢 **Image Generation** – OpenAI GPT Image and Google Imagen for visual content creation within chat conversations | |
| 69 | -🟢 **Streaming Responses** – Real-time response streaming for OpenAI, Claude, Grok, and DeepSeek models for the fastest possible chat experience | |
| 70 | -🟢 **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 | |
| 71 | - | |
| 72 | -## Choose from 100+ Premium AI Models | |
| 73 | -Access the world's most advanced AI models based on your specific needs: | |
| 74 | - | |
| 75 | -**OpenRouter**: 100+ models from multiple providers with a single API key – including OpenAI, Anthropic, Google, Meta, Mistral, and more! | |
| 76 | -**OpenAI**: | |
| 77 | -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 | |
| 78 | -**Anthropic Claude**: | |
| 79 | -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 | |
| 80 | -**X.AI**: | |
| 81 | -**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 | |
| 82 | -**Google Gemini**: | |
| 83 | -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 | |
| 84 | -**DeepSeek**: | |
| 85 | -DeepSeek V3 | |
| 86 | - | |
| 87 | -## Lead Management Dashboard — Turn Chat Traffic Into a Real Lead List | |
| 88 | - | |
| 89 | -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. | |
| 90 | - | |
| 91 | -**What You Get:** | |
| 92 | - | |
| 93 | -- **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 | |
| 94 | -- **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 | |
| 95 | -- **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) | |
| 96 | -- **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 | |
| 97 | -- **One-Click View Conversation** — jump from any lead straight into their latest full conversation in the transcripts viewer | |
| 98 | -- **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 | |
| 99 | -- **Clean, Responsive, Native** — works beautifully on desktop, tablet, and phone with the same polished dashboard feel as the rest of MxChat | |
| 100 | -- **Zero Setup, Zero Migration** — uses your existing chat data, no new database tables, no configuration — turn on lead capture and the dashboard just works | |
| 101 | - | |
| 102 | -**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. | |
| 103 | - | |
| 104 | -## AI Content Generator — Create Blog Posts & Landing Pages with AI | |
| 105 | - | |
| 106 | -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. | |
| 107 | - | |
| 108 | -**How It Works:** | |
| 109 | - | |
| 110 | -1. **Describe Your Content** — Enter a topic, title, or detailed prompt and choose between a blog post or landing page layout | |
| 111 | -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 | |
| 112 | -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 | |
| 113 | -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 | |
| 114 | -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 | |
| 115 | - | |
| 116 | -**Key Content Generator Features:** | |
| 117 | - | |
| 118 | -- Choose from multiple AI models for content generation (GPT-5, Claude, Gemini, Grok, and more) | |
| 119 | -- AI-generated images placed directly into your content with automatic media library uploads | |
| 120 | -- SEO title and meta description generation for search engine optimization | |
| 121 | -- Built-in SEO analysis with real-time scoring and one-click AI auto-optimization | |
| 122 | -- Fullwidth and standard layout options with automatic theme compatibility | |
| 123 | -- Content history to revisit and manage previously generated posts | |
| 124 | -- Works with popular page builders and themes including Elementor, Bricks, Divi, Astra, Kadence, and more | |
| 125 | -- 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 | |
| 126 | - | |
| 127 | -## MxChat Anywhere — Deploy Your Chatbot on Any Website | |
| 128 | - | |
| 129 | -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. | |
| 130 | - | |
| 131 | -**Key Features:** | |
| 132 | - | |
| 133 | -- One script tag to add your chatbot to any site — no coding or framework required | |
| 134 | -- Full style isolation via Shadow DOM so host page CSS never breaks your chatbot | |
| 135 | -- All your MxChat settings carry over automatically — colors, themes, quick questions, email collection, streaming, and more | |
| 136 | -- Multi-bot support lets you deploy different chatbot configurations on different sites | |
| 137 | -- Secure domain whitelisting and API key authentication prevent unauthorized usage | |
| 138 | -- Lightweight vanilla JS widget with zero dependencies — no jQuery needed on the target site | |
| 139 | - | |
| 140 | -**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. | |
| 141 | - | |
| 142 | -## Powerful Add-On Ecosystem | |
| 143 | - | |
| 144 | -**Pro Add-Ons:** | |
| 145 | -🟢 **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. | |
| 146 | -🟢 **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 | |
| 147 | -🟢 **Multi-Bot Manager** – Create and manage multiple specialized chatbots with dedicated knowledge databases for different purposes (support, sales, technical, etc.) | |
| 148 | -🟢 **Video Generation** – Generate stunning AI videos using Google's Veo 2 and Veo 3 models with audio support and multiple aspect ratios | |
| 149 | -🟢 **Admin Assistant** – ChatGPT-like interface in WordPress admin with thread management and image generation | |
| 150 | -🟢 **Chat Themes** – Visual design editor with AI-powered chatbot theme generation from natural language | |
| 151 | -🟢 **MxChat Forms** – Create chatbot-triggered forms for lead capture and support tickets | |
| 152 | -🟢 **Chat Moderation** – Advanced security with email/IP banning and content filtering | |
| 153 | -🟢 **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 | |
| 154 | -🟢 **Perplexity Integration** – Real-time web search with authoritative, well-sourced responses | |
| 155 | -🟢 **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 | |
| 156 | - | |
| 157 | -## 📱 Mobile-Friendly & Fully Customizable | |
| 158 | - | |
| 159 | -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. | |
| 160 | - | |
| 161 | -## 🔐 Reliable, Fast, Secure | |
| 162 | - | |
| 163 | -MxChat is optimized for performance and security. Your AI chatbot runs smoothly, loads fast, and protects your customer data with enterprise-grade security measures. | |
| 164 | - | |
| 165 | -## 🌟 What Makes MxChat the Best AI Chatbot for WordPress? | |
| 166 | - | |
| 167 | -- Used by hundreds of WordPress websites worldwide | |
| 168 | -- 5-star average rating from satisfied customers | |
| 169 | -- Native WordPress integration - no external dependencies | |
| 170 | -- Setup in under 2 minutes with simple API key configuration | |
| 171 | - | |
| 172 | -## 🆓 Start with MxChat’s Powerful Free Plan | |
| 173 | - | |
| 174 | -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: | |
| 175 | - | |
| 176 | -- Access all AI models from 6 major providers | |
| 177 | -- AI Content Generator for blog posts and landing pages with SEO scoring and AI auto-optimization | |
| 178 | -- Train chatbot on unlimited website content | |
| 179 | -- Loops email capture for lead generation | |
| 180 | -- Web search and image generation capabilities | |
| 181 | -- Real-time admin debug panel | |
| 182 | -- Chat transcript review and export | |
| 183 | -- RAG support & contextual awareness | |
| 184 | - | |
| 185 | -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. | |
| 186 | - | |
| 187 | -== Developer Hooks & Filters == | |
| 188 | - | |
| 189 | -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/). | |
| 190 | - | |
| 191 | -= mxchat_before_process_post = | |
| 192 | - | |
| 193 | -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. | |
| 194 | - | |
| 195 | -= mxchat_system_instructions = | |
| 196 | - | |
| 197 | -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. | |
| 198 | - | |
| 199 | -## ✅ Get Started with MxChat AI Chatbot Today | |
| 200 | - | |
| 201 | -Installing MxChat for WordPress takes just a few clicks. Get started with our free plan and upgrade anytime to access our complete add-on ecosystem and premium features. | |
| 202 | - | |
| 203 | -## 💰 Pricing | |
| 204 | - | |
| 205 | -Most powerful features are included in the free plan. Upgrade to Pro for the complete add-on ecosystem and advanced capabilities. | |
| 206 | -[View all pricing options](https://mxchat.ai/) | |
| 207 | - | |
| 208 | -== Use of Third-Party Services == | |
| 209 | - | |
| 210 | -This plugin connects to AI service providers to generate responses: | |
| 211 | - | |
| 212 | -**Service Providers:** | |
| 213 | -- [OpenRouter](https://openrouter.ai/) - [Terms](https://openrouter.ai/terms) | [Privacy](https://openrouter.ai/privacy) | |
| 214 | -- [OpenAI](https://openai.com/) - [Terms](https://openai.com/policies/terms-of-use/) | [Privacy](https://openai.com/policies/privacy-policy/) | |
| 215 | -- [Anthropic](https://anthropic.com/) - [Terms](https://www.anthropic.com/terms) | [Privacy](https://www.anthropic.com/privacy) | |
| 216 | -- [Google](https://ai.google.dev/) - [Terms](https://ai.google.dev/terms) | [Privacy](https://policies.google.com/privacy) | |
| 217 | -- [X.AI](https://x.ai/) - [Terms](https://x.ai/terms-of-service) | [Privacy](https://x.ai/privacy-policy) | |
| 218 | -- [DeepSeek](https://deepseek.com/) - [Terms](https://deepseek.com/terms) | [Privacy](https://deepseek.com/privacy) | |
| 219 | - | |
| 220 | -Please ensure compliance with applicable terms and data privacy laws. | |
| 221 | - | |
| 222 | -== Installation == | |
| 223 | - | |
| 224 | -1. Upload the `mxchat-basic` folder to the `/wp-content/plugins/` directory. | |
| 225 | -2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 226 | -3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 227 | - | |
| 228 | -== Frequently Asked Questions == | |
| 229 | - | |
| 230 | -= What AI models does MxChat support? = | |
| 231 | - | |
| 232 | -MxChat supports 100+ AI models including OpenAI GPT-5.5, GPT-5.1 Chat Latest, GPT-5, Anthropic Claude Opus 4.8, Claude Sonnet 4.6, Claude Haiku 4.5, Google Gemini 3.5 Flash, Gemini 3.1 Pro, xAI Grok 4, Grok 3, DeepSeek V3, and many more. With OpenRouter integration, you get access to models from OpenAI, Anthropic, Google, Meta, Mistral, and other providers with a single API key. | |
| 233 | - | |
| 234 | -= How do I get API keys for the AI chatbot? = | |
| 235 | - | |
| 236 | -For OpenAI, visit platform.openai.com and create an account. For Anthropic Claude, visit console.anthropic.com. For Google Gemini, visit ai.google.dev. For xAI Grok, visit x.ai. For DeepSeek, visit platform.deepseek.com. For OpenRouter (100+ models), visit openrouter.ai. Each provider offers different pricing tiers and free credits for new users. | |
| 237 | - | |
| 238 | -= Can I train the AI chatbot on my website content? = | |
| 239 | - | |
| 240 | -Yes. MxChat supports unlimited knowledge base training using RAG (Retrieval-Augmented Generation) technology. Import content from WordPress pages, posts, WooCommerce products, custom post types, PDFs, Word documents, text files, sitemaps, and manual Q&A entries. The AI chatbot will use your content to provide accurate, contextually relevant responses. | |
| 241 | - | |
| 242 | -= What is RAG technology and how does it work? = | |
| 243 | - | |
| 244 | -RAG (Retrieval-Augmented Generation) is an AI technique that retrieves relevant information from your knowledge base before generating responses. When a visitor asks a question, MxChat searches your trained content using vector embeddings, finds the most relevant matches, and provides that context to the AI model. This ensures accurate, factual answers based on your actual website content rather than generic AI responses. | |
| 245 | - | |
| 246 | -= Does MxChat work with WooCommerce? = | |
| 247 | - | |
| 248 | -Yes. MxChat includes full WooCommerce integration. The AI chatbot can be trained on your product catalog including titles, descriptions, pricing, SKUs, categories, and custom fields. Enable auto-sync to automatically update the knowledge base when products change. Your chatbot can answer questions about products, pricing, availability, and help customers find what they need. | |
| 249 | - | |
| 250 | -= Can I customize the AI chatbot appearance? = | |
| 251 | - | |
| 252 | -Yes. MxChat offers extensive customization options including custom colors, chatbot icon, AI avatar, chat bubble size, light/dark/system themes, positioning (left/right), custom CSS, greeting messages, placeholder text, and widget layouts. Use the built-in AI Theme Generator to describe your ideal design and let AI create custom styling automatically. | |
| 253 | - | |
| 254 | -= How do I add the chatbot to my WordPress site? = | |
| 255 | - | |
| 256 | -You can add the chatbot using the shortcode `[mxchat_chatbot floating="yes"]` for a floating widget or `[mxchat_chatbot floating="no"]` for an embedded chat. Alternatively, enable "Append to Body" in settings to automatically display the chatbot on all pages without shortcodes. | |
| 257 | - | |
| 258 | -= Does MxChat support streaming responses? = | |
| 259 | - | |
| 260 | -Yes. MxChat supports real-time streaming responses for OpenAI, Anthropic Claude, xAI Grok, and DeepSeek models. Streaming displays AI responses word-by-word as they're generated, providing a faster, more engaging chat experience for your visitors. | |
| 261 | - | |
| 262 | -= What is the Chat Transcripts feature? = | |
| 263 | - | |
| 264 | -The Chat Transcripts dashboard provides comprehensive conversation management. View all chat histories, see detailed conversation flows, track which knowledge sources the AI used for each response, monitor user engagement, and analyze chat analytics including daily activity, peak hours, and user distribution. | |
| 265 | - | |
| 266 | -= Can I see which content the AI chatbot used to answer questions? = | |
| 267 | - | |
| 268 | -Yes. MxChat includes full knowledge source transparency. In the Chat Transcripts and the optional debug panel, you can see exactly which pages, posts, products, or Q&A entries the AI retrieved and used to generate each response, along with relevance scores. | |
| 269 | - | |
| 270 | -= Is Pinecone vector database required? = | |
| 271 | - | |
| 272 | -No. MxChat includes free, unlimited local vector storage in your WordPress database. Pinecone integration is optional and recommended only for enterprise-scale knowledge bases with thousands of entries requiring faster search performance. | |
| 273 | - | |
| 274 | -= Does MxChat support multiple languages? = | |
| 275 | - | |
| 276 | -Yes. The AI chatbot supports multi-language conversations and automatically responds in the language your visitors use. MxChat also supports right-to-left (RTL) languages like Arabic and Hebrew. | |
| 277 | - | |
| 278 | -= How much do AI API calls cost? = | |
| 279 | - | |
| 280 | -API costs depend on your chosen provider and model. OpenAI, Anthropic, Google, and others charge based on token usage. DeepSeek and Google Gemini offer generous free tiers. MxChat includes intelligent token optimization to minimize API costs. You can also set rate limits for guests and logged-in users to control usage. | |
| 281 | - | |
| 282 | -= Is MxChat GDPR compliant? = | |
| 283 | - | |
| 284 | -Yes. All conversation data is stored locally on your WordPress site, giving you complete control. Configure automatic data retention policies, export chat transcripts, or delete conversations as needed for compliance. | |
| 285 | - | |
| 286 | -= Can I restrict chatbot access to certain users? = | |
| 287 | - | |
| 288 | -Yes. MxChat includes role-based access controls. Restrict the chatbot to logged-in users only, specific user roles, or keep it public. You can also restrict specific knowledge base content to certain user roles. | |
| 289 | - | |
| 290 | -= Does MxChat support live chat handoff? = | |
| 291 | - | |
| 292 | -Yes. MxChat integrates with Slack for live agent handoff. When the AI cannot help or a visitor requests human support, conversations can be seamlessly transferred to your team via Slack. | |
| 293 | - | |
| 294 | -= What are Actions and how do they work? = | |
| 295 | - | |
| 296 | -Actions are custom triggers that execute when user intent is detected. Create actions for lead capture, appointment booking, support tickets, page redirects, or custom JavaScript. The AI automatically recognizes when users want to perform these actions and triggers them contextually. | |
| 297 | - | |
| 298 | -= Can visitors upload documents to chat? = | |
| 299 | - | |
| 300 | -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. | |
| 301 | - | |
| 302 | -= Does MxChat support image generation? = | |
| 303 | - | |
| 304 | -Yes. With OpenAI GPT Image and Google Imagen integration, the AI chatbot can generate images based on user descriptions directly within the chat conversation. | |
| 305 | - | |
| 306 | -= How does the knowledge base auto-sync work? = | |
| 307 | - | |
| 308 | -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. | |
| 309 | - | |
| 310 | -= Can I use Advanced Custom Fields (ACF) with MxChat? = | |
| 311 | - | |
| 312 | -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. | |
| 313 | - | |
| 314 | -= What embedding models does MxChat support? = | |
| 315 | - | |
| 316 | -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. | |
| 317 | - | |
| 318 | -= Is there a free version of MxChat? = | |
| 319 | - | |
| 320 | -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. | |
| 321 | - | |
| 322 | -== Screenshots == | |
| 323 | - | |
| 324 | -1. **Chat Transcripts Insights** - Review and analyze conversations insights to see engagement rate, peak activity, and user distribution. | |
| 325 | -2. **Chat Transcripts Insights** - View 7 day activity trend graph. | |
| 326 | -3. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 327 | -4. **Action Page** - Set custom action triggers to complete specific actions. | |
| 328 | -5. **Plugin Settings Page** - Configure your API key and other settings. | |
| 329 | -6. **MxChat Debug Panel** - Easily debug and view your content matching scores, citation URLs, triggered actions and more. | |
| 330 | - | |
| 331 | -*(Note: Screenshots will be added in future updates)* | |
| 332 | - | |
| 333 | -== Changelog == | |
| 334 | - | |
| 335 | -= 3.2.9 - June 11, 2026 = | |
| 336 | -* New: Claude Fable 5 — Anthropic's newest flagship model — available in the Select AI Model picker and the Content Generator | |
| 337 | -* 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) | |
| 338 | -* New: Stop button — visitors can halt a streaming response mid-answer; the text already written is kept | |
| 339 | -* New: "Show Download Transcript Button" toggle to hide the chat menu's Download Transcript item (on by default) | |
| 340 | -* 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 | |
| 341 | -* New: "Images per Article" slider (1–5, default 3) in the Content Generator's image settings | |
| 342 | -* Fixed: Chat widget interface text no longer appears in your pages' Google search-result snippets | |
| 343 | -* Fixed: Admin navigation now displays correctly on right-to-left language sites (Arabic, Hebrew, Persian, and others) | |
| 344 | -* Fixed: In-chat PDF and Word document upload works again, including for signed-in administrators | |
| 345 | -* Fixed: Messages sent right after a bot reply no longer vanish on sites running the Image Analysis add-on | |
| 346 | -* Fixed: The "Was this helpful?" rating prompt only appears when its setting is turned on | |
| 347 | -* Fixed: Rebuilt translation template (mxchat.pot) — syncing a translation no longer discards existing translations | |
| 348 | -* Fixed: PHP 8.2 deprecation notices no longer logged during chat requests | |
| 349 | - | |
| 350 | -= 3.2.8 - June 4, 2026 = | |
| 351 | -* New: Total chatbot message limit — one cap across all users and roles per timeframe, with a live usage readout and one-click reset | |
| 352 | -* New: Global and per-role rate limits accept custom values beyond the presets | |
| 353 | -* Improved: Custom Provider and Azure OpenAI embeddings work end-to-end for indexing and live queries (re-index if you had this enabled) | |
| 354 | -* Fixed: Feedback "Send" button no longer renders as an invisible white-on-white block | |
| 355 | - | |
| 356 | -= 3.2.7 - May 29, 2026 = | |
| 357 | -* New: Guided onboarding wizard for first-time setup — reopen any time from Settings → Tutorials | |
| 358 | -* New: Claude Opus 4.8 and the Google Gemini 3.x lineup; sites on retired models are migrated automatically | |
| 359 | -* Improved: First message is reliable behind full-page caches (WP Rocket, LiteSpeed, FlyingPress, W3 Total Cache, Cloudflare APO) | |
| 360 | -* Improved: Streaming and standard chat retry transient provider errors before showing a failure | |
| 361 | -* Improved: Floating chat button is fully keyboard-operable (WCAG 2.1 Level A) | |
| 362 | - | |
| 363 | -= 3.2.6 - May 21, 2026 = | |
| 364 | -* New: Custom Provider (OpenAI-compatible) — point MxChat at Ollama, LM Studio, vLLM, llama.cpp, or Azure OpenAI, with a Test Connection button | |
| 365 | -* New: End-of-session "Was this helpful?" satisfaction rating with admin reporting and a dashboard card | |
| 366 | -* New: ACF PDF auto-indexing — PDF text from ACF file fields is extracted into the knowledge base (opt-in) | |
| 367 | -* New: Image Quality control for OpenAI GPT Image in the Content Generator | |
| 368 | -* New: Claude Opus 4.7, GPT-5.5, and GPT Image 2 in the model picker | |
| 369 | -* New: REST bulk-delete endpoint for chat sessions and an embedding chunk-metadata filter for developers | |
| 370 | -* Improved: Page-cache plugins are automatically told not to cache the chat endpoint, with a per-plugin status card | |
| 371 | -* Fixed: Intermittent "Access denied" on the first chat message under full-page caching | |
| 372 | -* Fixed: Print preview was blank on pages with MxChat installed | |
| 373 | - | |
| 374 | -= 3.2.5 - May 12, 2026 = | |
| 375 | -* New: REST API with bearer-token auth — read transcripts, push knowledge, bulk-delete sessions (disabled by default) | |
| 376 | -* New: Download Transcript menu item — saves the conversation as a Markdown file (replaces Print Conversation) | |
| 377 | -* New: Redesigned chat-widget header with X-close icon and keyboard-accessible 3-dot menu | |
| 378 | -* New: Content Generator writes SEO-title meta for Rank Math/Yoast/AIOSEO and syncs image alt text to the media library | |
| 379 | -* New: Transcript retention setting (1–3650 days) with automatic daily cleanup | |
| 380 | -* Fixed: Header dropdown menu inherits the bubble theme colors instead of hardcoded white | |
| 381 | - | |
| 382 | -= 3.2.4 - May 3, 2026 = | |
| 383 | -* Fixed: WooCommerce product Short Description Visual tab broken by a script 404 | |
| 384 | -* Fixed: User's last message scrolls to the top after streaming replies | |
| 385 | - | |
| 386 | -= 3.2.3 - April 29, 2026 = | |
| 387 | -* New: Embedding model switch protection — warning dialog and admin notice when stored embeddings don't match the selected model | |
| 388 | -* Improved: Landing Page Generator plans more sections and writes fuller copy | |
| 389 | -* Fixed: Landing Page "Full Width" option honored on WordPress block themes | |
| 390 | -* Fixed: Manual knowledge entries no longer cited with internal placeholder URLs | |
| 391 | - | |
| 392 | -= 3.2.2 - April 21, 2026 = | |
| 393 | -* New: Lead Management Dashboard — deduplicated lead list with filters, top-pages analytics, CSV export, and one-click jump to conversations | |
| 394 | -* Fixed: Orphaned Pinecone vectors removed when posts or products are unpublished, deleted, or renamed | |
| 395 | -* Fixed: Source and chunk count settings now apply on all retrieval paths | |
| 396 | - | |
| 397 | -= 3.2.1 - April 17, 2026 = | |
| 398 | -* Fixed: Admin Testing Tab debug panel missing similarity scores and sources when web search and streaming were both enabled | |
| 399 | -* Fixed: Web search responses now save their sources to chat transcripts | |
| 400 | - | |
| 401 | -= 3.2.0 - April 15, 2026 = | |
| 402 | -* New: mxchat_similarity_results filter hook for add-ons | |
| 403 | -* Fixed: Removed attribute injection that conflicted with cache and optimization plugins | |
| 404 | - | |
| 405 | -= 3.1.9 - April 7, 2026 = | |
| 406 | -* Fixed: "Session expired" errors caused by session-ownership issues | |
| 407 | - | |
| 408 | -= 3.1.8 - April 6, 2026 = | |
| 409 | -* New: Admin Testing Tab — embedded chatbot replica with a real-time debug panel | |
| 410 | -* New: Individual trigger-phrase embeddings for more accurate action matching | |
| 411 | -* New: Loading indicator while chat initializes | |
| 412 | -* Improved: "Delete All" in the Knowledge Base respects the active content-type filter | |
| 413 | - | |
| 414 | -= 3.1.7 - April 1, 2026 = | |
| 415 | -* New: Google Drive PDF links auto-convert to direct downloads for knowledge import | |
| 416 | -* Fixed: Chat history not appearing for returning visitors with persistence on and email collection off | |
| 417 | -* Fixed: Lead capture form not displaying for new visitors when email collection is enabled | |
| 418 | -* Fixed: Editing a legacy manual knowledge entry no longer deletes others sharing the same source URL | |
| 419 | - | |
| 420 | -= 3.1.6 - March 30, 2026 = | |
| 421 | -* Fixed: Pre-chat popup stays dismissed for 24 hours instead of reappearing on every refresh | |
| 422 | -* Fixed: Chat history not loading for returning visitors | |
| 423 | -* Fixed: Links with special characters being cut off or rendered as plain text | |
| 424 | - | |
| 425 | -= 3.1.5 - March 25, 2026 = | |
| 426 | -* New: RAG Chunks Limit setting and tuned source defaults to balance answer quality and token cost | |
| 427 | -* New: Per-page chatbot visibility control from the page editor meta box | |
| 428 | -* Improved: Debugger and transcripts show the actual sources and chunks used | |
| 429 | - | |
| 430 | -= 3.1.4 - March 22, 2026 = | |
| 431 | -* New: OpenAI GPT-5.4 family and GPT-5.3 Chat models | |
| 432 | -* New: Editable default prompts for blog posts and landing pages in the Content Generator | |
| 433 | -* New: Inline knowledge-entry editing with automatic re-chunking and re-embedding | |
| 434 | -* New: Sitemap import supports PDF URLs | |
| 435 | - | |
| 436 | -= 3.1.3 - March 16, 2026 = | |
| 437 | -* New: Content Calendar tab on the Content page | |
| 438 | -* New: Multi-line chat teaser pop-up messages | |
| 439 | -* Improved: Session cookies deferred until first interaction — passive visitors no longer create sessions | |
| 440 | -* Improved: Markdown table rendering with column alignment and responsive scrolling | |
| 441 | - | |
| 442 | -= 3.1.2 - March 13, 2026 = | |
| 443 | -* New: Per-check AI fix buttons and batch "Optimize Selected" on the SEO dashboard | |
| 444 | -* Improved: Image generation upgraded from deprecated DALL-E 3 to GPT Image and Gemini Imagen 4 | |
| 445 | -* Fixed: Emojis in bot responses no longer prevent transcripts from saving | |
| 446 | -* Fixed: WooCommerce product cards display correctly in chat transcripts | |
| 447 | -* Fixed: "Optimize All" runs SEO fixes sequentially so they no longer overwrite each other | |
| 448 | - | |
| 449 | -= 3.1.1 - March 4, 2026 = | |
| 450 | -* New: SEO analysis panel with real-time scoring and one-click AI Auto-Optimize | |
| 451 | -* New: Google Search Console integration (Pro) in the Content editor | |
| 452 | -* New: Slack agents can hand the conversation back to AI with !endchat, optionally with a farewell message | |
| 453 | -* Fixed: Stale nonce causing "Invalid nonce" errors on sites with full-page caching | |
| 454 | -* Fixed: Security-scanner false positives on transcript and PDF temp files | |
| 455 | - | |
| 456 | -= 3.1.0 - March 1, 2026 = | |
| 457 | -* New: mxchat_before_process_post and mxchat_system_instructions filter hooks, with shortcode support in the system prompt | |
| 458 | -* Fixed: Manually entered knowledge content not used despite high similarity scores | |
| 459 | -* Fixed: Chat input remaining blocked after live-agent handoff | |
| 460 | -* Fixed: Pinecone scans failing with text-embedding-3-large (wrong vector dimension) | |
| 461 | -* Fixed: Shortcode stripping losing content on pages with large or deeply nested shortcodes | |
| 462 | - | |
| 463 | -= 3.0.9 - February 24, 2026 = | |
| 464 | -* New: AI Content Generator — full blog posts and landing pages from a prompt, with AI images, SEO metadata, live preview, and inline AI editing | |
| 465 | -* New: Advanced Content Editor premium add-on | |
| 466 | -* Improved: Compatibility with optimization and caching plugins | |
| 467 | - | |
| 468 | -= 3.0.8 - February 20, 2026 = | |
| 469 | -* New: Debug and optimization tools with log viewer, settings export, and reset options | |
| 470 | -* New: Claude Sonnet 4.6 model | |
| 471 | - | |
| 472 | -= 3.0.7 - February 15, 2026 = | |
| 473 | -* Fixed: GPT-5.1 Chat Latest returning an API error when web search was disabled | |
| 474 | - | |
| 475 | -= 3.0.6 - February 11, 2026 = | |
| 476 | -* New: RAG Sources Limit slider and {visitor_name} placeholder for personalized greetings | |
| 477 | -* New: Claude Opus 4.6 and Claude Opus 4.5 models | |
| 478 | -* Fixed: Chat persistence OFF now starts a fresh AI context on page reload | |
| 479 | -* Updated: Deprecated OpenAI GPT-4/GPT-3.5 and Claude 3.x models removed; affected sites migrated automatically | |
| 480 | - | |
| 481 | -= 3.0.5 - January 28, 2026 = | |
| 482 | -* Fixed: Gemini embedding model updated to the stable gemini-embedding-001 | |
| 483 | -* Fixed: Notification settings not saving on new installations | |
| 484 | -* Fixed: Save indicators not visible on several settings fields | |
| 485 | - | |
| 486 | -= 3.0.4 - January 24, 2026 = | |
| 487 | -* New: Latest Google Gemini models | |
| 488 | -* New: Transcript translation — auto-translate chat transcripts to any language | |
| 489 | -* Fixed: Lead capture forms broken by multi-bot class ID changes | |
| 490 | - | |
| 491 | -= 3.0.3 - January 21, 2026 = | |
| 492 | -* Fixed: Chat input not re-enabling when web search was on | |
| 493 | - | |
| 494 | -= 3.0.2 - January 21, 2026 = | |
| 495 | -* New: Telegram Live Agent integration for live chat handoff | |
| 496 | -* New: Citation Links toggle to show or hide source URLs in AI responses | |
| 497 | - | |
| 498 | -= 3.0.1 - January 18, 2026 = | |
| 499 | -* New: OpenAI Vector Store integration and custom post-meta whitelist for embeddings | |
| 500 | -* New: Multi-select with bulk "Delete Selected" in the knowledge base | |
| 501 | -* Improved: Chatbot CSS migrated from IDs to classes for multi-bot support (Theme Customizer users: update the add-on and click "Migrate") | |
| 502 | - | |
| 503 | -= 3.0.0 - January 14, 2026 = | |
| 504 | -* New: Complete admin UI overhaul with modern sidebar navigation across all pages | |
| 505 | -* New: Automatic sitemap detection with one-click processing | |
| 506 | -* New: Real-time knowledge base updates and improved mobile responsiveness | |
| 507 | - | |
| 508 | -Older releases are archived in the plugin's full version history on WordPress.org. | |
| 509 | - | |
| 510 | -== Upgrade Notice == | |
| 511 | - | |
| 512 | -= 3.2.9 - June 11, 2026 = | |
| 513 | -Adds Claude Fable 5 — Anthropic's newest flagship model — to the model picker and Content Generator (and fixes Claude Opus 4.7/4.8 as Content Generator models). Adds a Stop button to halt streaming responses mid-answer, an "Images per Article" slider for the Content Generator, and a toggle to hide the Download Transcript menu item. Settings changes now apply immediately on cached sites — no more clearing caches after toggling. Restores in-chat PDF/Word upload, keeps chat-widget text out of your Google search snippets, and rebuilds the translation template so translators no longer lose work on updates. Also includes RTL admin-navigation, satisfaction-prompt, message-loss, and PHP 8.2 fixes. | |
| 514 | - | |
| 515 | -== License & Warranty == | |
| 516 | - | |
| 517 | -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. | |
| 518 | - | |
| 519 | -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. | |
| 520 | - | |
| 521 | -== Credits == | |
| 522 | - | |
| 523 | -This plugin incorporates the following third-party library: | |
| 524 | - | |
| 525 | -- **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). | |
| 526 | - | |
| 527 | -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, OpenAI, Claude, WooCommerce | |
| 5 | +Requires at least: 5.0 | |
| 6 | +Tested up to: 6.6 | |
| 7 | +Requires PHP: 7.2 | |
| 8 | +Stable tag: 1.2 | |
| 9 | +License: GPLv2 or later | |
| 10 | +License URI: https://www.gnu.org/licenses/gpl-2.0.html | |
| 11 | + | |
| 12 | +MxChat is a customizable AI chatbot plugin for WordPress, leveraging OpenAI's GPT models to enhance user interaction. | |
| 13 | + | |
| 14 | +== Description == | |
| 15 | + | |
| 16 | +**MxChat** is a powerful and customizable **AI chatbot plugin** for **WordPress**, seamlessly integrating **OpenAI's GPT models** and **Anthropic's Claude models** to deliver intelligent, real-time user interactions. With **MxChat**, you can effortlessly enhance engagement and support by leveraging features like **WooCommerce integration**, lead capture via **Loops**, and a variety of **customization options** to match your site’s branding. | |
| 17 | + | |
| 18 | +**MxChat** supports direct submission of **context to the chatbot's knowledge base** through multiple methods: **manually**, via **URL**, or by submitting your website's **sitemap**. This ensures that the AI can provide highly relevant and context-aware responses. Additionally, the plugin allows full **theme customization** to align with your website’s branding, and **WooCommerce** support for an integrated shopping experience. | |
| 19 | + | |
| 20 | +The latest version also introduces **X.AI API support** (Pro feature) and **Claude API support** (Pro feature), enabling access to advanced language models like `grok-beta` from X.AI and **Claude 3.5 Sonnet** from Anthropic. This expands your options beyond OpenAI, offering flexible model selection for smarter, context-aware conversations. With **customizable settings** and GDPR-compliant options via **Complianz integration**, **MxChat** offers a robust solution for businesses seeking a versatile, AI-powered chatbot. | |
| 21 | + | |
| 22 | +For more information, visit [MxChat](https://mxchat.ai/). | |
| 23 | + | |
| 24 | +### Personalize the AI Chatbot with Custom Knowledge: | |
| 25 | + | |
| 26 | +One of the standout features of **MxChat** is the ability to fine-tune the AI’s responses by adding **personalized content** directly through the WordPress admin dashboard. This is achieved through **vector embeddings**, a powerful technique that allows the AI to reference specific information you provide. | |
| 27 | + | |
| 28 | +Whether you want the chatbot to answer questions based on your company’s unique services, products, or content, you can easily submit this information manually or via your website's sitemap. By submitting custom knowledge, you guide the AI to understand and prioritize the most relevant data, ensuring that the responses are not only accurate but also highly contextual to your business or website. | |
| 29 | + | |
| 30 | +- **Manual Content Submission**: Within the WordPress admin, you can manually add specific articles, FAQs, or any text that you want the AI to use as a reference. The plugin processes this content using vector embeddings, enhancing the chatbot's ability to deliver precise, context-aware answers. | |
| 31 | + | |
| 32 | +- **Sitemap and URL Submission**: MxChat now supports both sitemap and individual URL submissions. By submitting your website’s sitemap, MxChat automatically extracts content from the URLs listed, adding it to the chatbot’s knowledge base. You can also manually submit specific URLs to ensure targeted content is included. This integration helps keep the AI well-informed about your site’s content, enhancing the overall user experience. [Watch a demo of the Sitemap and URL Submission feature here.](https://www.youtube.com/watch?v=A2xGy7nenjU&t=52s) | |
| 33 | + | |
| 34 | +### GDPR Compliance & Multilingual Support: | |
| 35 | + | |
| 36 | +- **Complianz Integration (Pro Feature)**: With the new [Complianz integration](https://www.youtube.com/watch?v=TM3wlkOgcZg), MxChat ensures GDPR compliance by only displaying the chatbot to users who have consented to marketing cookies. This helps website owners stay compliant with data privacy regulations, and is available as a **Pro feature** for enhanced privacy controls. | |
| 37 | + | |
| 38 | +- **Customizable Privacy Policy Text**: To support multilingual websites and specific legal requirements, MxChat allows you to customize the privacy policy text displayed with the chatbot, ensuring that users are informed about data usage in a transparent and compliant manner. | |
| 39 | + | |
| 40 | +These features make MxChat an ideal solution for businesses seeking multilingual support and GDPR compliance while delivering a seamless and personalized AI-driven chatbot experience. | |
| 41 | + | |
| 42 | +### New in Version 1.2: | |
| 43 | + | |
| 44 | +- **Popular Questions Buttons**: You can now add up to three frequently asked questions (FAQ-style buttons) directly to the chatbot interface. This feature allows users to click on popular questions, which the chatbot will automatically ask and respond to. The first question is free to use, while the second and third questions are part of the **Pro version**. | |
| 45 | + | |
| 46 | +- **Inline Edit Button for Knowledge Database**: Managing your knowledge base is easier than ever with the new **Edit button**. Instead of deleting and re-entering entries in your knowledge database, you can now edit entries directly from the knowledge base interface. This streamlined workflow improves database management for both free and Pro users. | |
| 47 | + | |
| 48 | +### New in Version 1.1.9: | |
| 49 | + | |
| 50 | +- **Claude API Integration (Pro Feature)**: We are excited to announce the integration of **Claude models** from **Anthropic**! Pro users can now take advantage of advanced language models like **Claude 3.5 Sonnet** for intelligent, real-time interactions. This integration expands the model selection beyond OpenAI and X.AI, giving you access to Claude’s sophisticated language capabilities. Users can input their **Claude API key** in the settings and switch between OpenAI, X.AI, and Claude models seamlessly. | |
| 51 | + | |
| 52 | +### Available AI Models: | |
| 53 | + | |
| 54 | +MxChat offers a variety of powerful AI models from **OpenAI**, **X.AI**, and **Claude (Anthropic)**. Each model is designed for specific use cases, allowing you to tailor your chatbot's performance to your needs. | |
| 55 | + | |
| 56 | +- **OpenAI Models:** | |
| 57 | + - **GPT-4o** (Recommended): OpenAI's flagship model for complex and multi-step tasks. Ideal for businesses needing a high level of AI intelligence. | |
| 58 | + - **GPT-4o-mini**: A smaller, lightweight version of GPT-4o, offering a balance between speed and intelligence for simpler tasks. | |
| 59 | + - **GPT-4-turbo**: The advanced high-intelligence model for demanding tasks requiring deep reasoning. | |
| 60 | + - **GPT-4**: The previous generation of high-performance models designed for complex reasoning and creative responses. | |
| 61 | + - **GPT-3.5-turbo**: A fast and cost-effective model for simple tasks and rapid responses. | |
| 62 | + | |
| 63 | +- **X.AI Models** (Pro Feature): | |
| 64 | + - **grok-beta** (Early Beta): A cutting-edge model by X.AI, designed for natural, human-like conversations. It offers advanced language comprehension for personalized and context-aware responses. Ideal for users exploring new AI technology. | |
| 65 | + | |
| 66 | +- **Claude (Anthropic) Models** (Pro Feature): | |
| 67 | + - **Claude 3.5 Sonnet** (Most Intelligent): A top-tier model for highly intelligent conversations, capable of handling complex queries with in-depth understanding. | |
| 68 | + - **Claude 3 Opus** (Highly Complex Tasks): Designed for managing intricate tasks and providing detailed responses. | |
| 69 | + - **Claude 3 Sonnet** (Balanced): A well-rounded model offering a blend of speed and intelligence, ideal for most use cases. | |
| 70 | + - **Claude 3 Haiku** (Fastest): Optimized for speed while maintaining accuracy, perfect for quick and responsive interactions. | |
| 71 | + | |
| 72 | +These models offer flexibility and performance for a wide range of applications, ensuring that MxChat can handle everything from simple customer support queries to advanced, real-time interactions. | |
| 73 | + | |
| 74 | +### Key Features: | |
| 75 | + | |
| 76 | +- **Popular Questions Buttons**: Enhance user interaction by adding up to three frequently asked questions (FAQ-style buttons) to the chatbot. Users can quickly ask these questions with a single click. The first button is available for free, while the second and third are included in the Pro version. | |
| 77 | +- **Email Capture with Loops Integration**: MxChat now supports email capture directly through the chatbot, integrated seamlessly with Loops. Users can provide their email addresses in response to custom trigger phrases, and MxChat will automatically add them to your selected Loops mailing list. This feature allows for easy lead capture, ensuring users stay connected and informed about your offerings. | |
| 78 | +- **Claude API Integration** (Pro Feature): Unlock the power of **Claude models** from **Anthropic**, like **Claude 3.5 Sonnet** for enhanced real-time interactions and smarter conversations. Add your Claude API key to the settings for seamless integration. | |
| 79 | +- **Integrate OpenAI API**: Use your own OpenAI API key to leverage the power of AI-driven responses on your WordPress site. | |
| 80 | +- **X.AI API Integration** (Pro Feature): Leverage X.AI's advanced language models like `grok-beta` for chat completions, giving you even more options for powering your chatbot with cutting-edge AI technology. | |
| 81 | +- **Customizable Chatbot Settings**: Tailor the chatbot's behavior, including the AI model, introductory message, and more, to fit your specific needs. | |
| 82 | +- **Knowledge Base Integration**: Submit custom knowledge content using vector embeddings, allowing the chatbot to provide more accurate and contextually relevant responses. | |
| 83 | +- **Sitemap and URL Submission**: MxChat now supports both sitemap and individual URL submissions. By submitting your website’s sitemap, MxChat automatically extracts content from the URLs listed, adding it to the chatbot’s knowledge base. You can also manually submit specific URLs to ensure targeted content is included. This integration helps keep the AI well-informed about your site’s content, enhancing the overall user experience. | |
| 84 | +- **WooCommerce Integration**: Directly integrate WooCommerce products into your chatbot for a seamless shopping experience. | |
| 85 | +- **Chat Transcripts**: Review and analyze chat transcripts directly from your WordPress dashboard. This feature allows you to monitor conversations, identify frequently asked questions, and further align and tune your AI chatbot based on real user interactions. | |
| 86 | +- **Easy Integration**: Add the chatbot to any page using a shortcode or automatically append it to the body element of your site. | |
| 87 | +- **Pro Version with Advanced Features**: Upgrade to the Pro version to unlock advanced features like Theme Customization, Rate Limit Settings, and WooCommerce Integration, allowing you to fully control the chatbot's appearance and functionality. | |
| 88 | +- **Link Target Toggle for Chatbot Links**: Added a toggle in the admin panel to control whether links in chatbot conversations open in a new tab (`_blank`) or the same tab (`_self`). This gives website owners more flexibility in how links behave. | |
| 89 | +- **Customizable Privacy Policy Text**: Website owners can now fully customize the privacy policy text that appears below the chatbot. This allows greater flexibility for sites with multiple languages or specific wording requirements. | |
| 90 | +- **Complianz Integration for GDPR Compliance**: For pro users we've added integration with the Complianz plugin, allowing your chatbot to fully comply with GDPR consent requirements. The chatbot will only activate if the user has given consent for marketing, ensuring that personal data is handled responsibly and in accordance with GDPR regulations. | |
| 91 | + | |
| 92 | +For more demos and tutorials, visit the [MxChat YouTube channel](https://www.youtube.com/@MxChat/videos). | |
| 93 | + | |
| 94 | +### Why Choose MxChat? | |
| 95 | + | |
| 96 | +MxChat is more than just a chatbot plugin; it’s a **complete AI-powered solution** designed to transform how your website engages with visitors. Whether you're using **WordPress** as a **page builder** or a **website builder**, MxChat integrates seamlessly to provide intelligent, real-time interactions that drive user engagement, boost satisfaction, and streamline customer support. | |
| 97 | + | |
| 98 | +With **flexible customization options**, MxChat adapts to the unique needs of your website, offering powerful integrations such as **WooCommerce** for eCommerce, **Loops** for lead capture, and the latest **X.AI API** for advanced conversational AI. You can easily submit and update custom knowledge through **URLs**, **sitemaps**, or **manual content submissions**, ensuring your chatbot is always relevant and context-aware. | |
| 99 | + | |
| 100 | +Designed for **simplicity and flexibility**, MxChat is the perfect solution for website owners, developers, and agencies looking to deliver cutting-edge AI capabilities without the complexity. Whether you're running a small business or managing a large-scale site, MxChat helps you create a personalized, efficient, and responsive user experience with minimal effort. | |
| 101 | + | |
| 102 | +### Use of Third-Party Services: | |
| 103 | + | |
| 104 | +This plugin requires an active connection to the **OpenAI API** or **X.AI API** to generate AI-driven responses. By using this plugin, you consent to sending data to OpenAI's and/or X.AI's servers, which may include user queries and other relevant information. | |
| 105 | + | |
| 106 | +- **Service Providers**: | |
| 107 | + - [OpenAI](https://openai.com/) | |
| 108 | + - [X.AI](https://x.ai/) | |
| 109 | +- **Terms of Use**: | |
| 110 | + - [OpenAI API Terms](https://openai.com/policies/terms-of-use/) | |
| 111 | + - [X.AI API Terms](https://x.ai/terms-of-service) | |
| 112 | +- **Privacy Policies**: | |
| 113 | + - [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy/) | |
| 114 | + - [X.AI Privacy Policy](https://x.ai/privacy-policy) | |
| 115 | + | |
| 116 | +Please ensure compliance with OpenAI’s & X.AI terms and any applicable data privacy laws. | |
| 117 | + | |
| 118 | +== Installation == | |
| 119 | + | |
| 120 | +1. Upload the `mxchat` folder to the `/wp-content/plugins/` directory. | |
| 121 | +2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 122 | +3. Navigate to the 'MxChat' settings page to configure your OpenAI API key and other settings. | |
| 123 | + | |
| 124 | +== Frequently Asked Questions == | |
| 125 | + | |
| 126 | +### How do I obtain an API key for OpenAI? | |
| 127 | + | |
| 128 | +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. | |
| 129 | + | |
| 130 | +### Can I customize the chatbot's appearance? | |
| 131 | + | |
| 132 | +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. | |
| 133 | + | |
| 134 | +### How do I add the chatbot to my site? | |
| 135 | + | |
| 136 | +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. | |
| 137 | + | |
| 138 | +### How does the knowledge submission feature work? | |
| 139 | + | |
| 140 | +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. | |
| 141 | + | |
| 142 | +### What is the sitemap submission feature? | |
| 143 | + | |
| 144 | +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. | |
| 145 | + | |
| 146 | +### What additional features does the Pro version offer? | |
| 147 | + | |
| 148 | +The **Pro version** unlocks advanced features such as: | |
| 149 | +- **Theme Customization**: Change the colors and styling of the AI Chatbot widget. | |
| 150 | +- **WooCommerce Integration**: Integrate your WooCommerce products directly into the chatbot, allowing users to search for and purchase products via chat. | |
| 151 | +- **Order Management**: The chatbot can now interact with users about their WooCommerce orders. It can fetch order history, retrieve details about individual orders (such as item lists, statuses, and total costs), and even provide license key information for digital products. This feature allows users to check their order status or history in a conversational way without leaving the chat. | |
| 152 | +- **Loops Integration for Lead Capture**: Capture user email addresses through the chatbot based on custom trigger phrases and automatically add them to your Loops mailing list. | |
| 153 | +- **X.AI API Integration**: Access advanced conversational AI through X.AI models like `grok-beta` for even more powerful chatbot interactions. | |
| 154 | +- **Exclusive Pro Features**: Access additional customization options and future enhancements, along with ongoing updates to improve chatbot functionality. | |
| 155 | + | |
| 156 | +== Screenshots == | |
| 157 | + | |
| 158 | +1. **Plugin Settings Page** - Configure your API key and other settings. | |
| 159 | +2. **Knowledge & Sitemap Submission** - Submit custom content to enhance the chatbot's responses. | |
| 160 | +3. **Chat Transcripts** - Review and analyze conversations to refine your AI chatbot. | |
| 161 | +4. **Activation Page** - Easily upgrade to MxChat Pro by entering your activation key. Unlock advanced features like theme customization directly from the MxChat settings page. | |
| 162 | +5. **MxChat Floating Widget (Closed)** - The MxChat widget in its minimized state, seamlessly integrated into your website’s interface. | |
| 163 | +6. **Mxchat Floating Widget (Open)** - See how the chatbot interacts with users on your site. | |
| 164 | + | |
| 165 | +*(Note: Screenshots will be added in future updates)* | |
| 166 | + | |
| 167 | +== Changelog == | |
| 168 | + | |
| 169 | +#### 1.2: | |
| 170 | +- Added **Popular Questions Buttons** with one free question and two available in the **Pro version**. | |
| 171 | +- Added **Inline Edit Button** to the Knowledge Database for easy content management. | |
| 172 | + | |
| 173 | += 1.1.9 = | |
| 174 | +* Added integration with Claude (Anthropic) API (Pro feature) for advanced conversational models like `Claude 3.5 Sonnet` and `Claude 3 Haiku`. | |
| 175 | + | |
| 176 | += 1.1.8 = | |
| 177 | +* Added integration with X.AI API (Pro feature) for advanced chat completions using models like `grok-beta`. | |
| 178 | +* Introduced new model selection dropdown that separates OpenAI and X.AI models, with X.AI models disabled for free users. | |
| 179 | +* Enhanced API key management, allowing users to input and manage both OpenAI and X.AI API keys in settings. | |
| 180 | + | |
| 181 | += 1.1.7 = | |
| 182 | +* Added chat session persistence option for users to maintain conversations across visits for up to 24 hours. | |
| 183 | +* Updated navigation tabs CSS and scripts to prevent conflicts with other plugins. | |
| 184 | +* Rate limit settings are now available to all users, offering better control over chat usage. | |
| 185 | + | |
| 186 | += 1.1.6 = | |
| 187 | +* Minor CSS update. | |
| 188 | + | |
| 189 | += 1.1.5 = | |
| 190 | +* Fixed error when users didn't have WooCommerce it would return "Error communicating with server". | |
| 191 | + | |
| 192 | += 1.1.4 = | |
| 193 | +* Minor bug fixes. | |
| 194 | + | |
| 195 | += 1.1.3 = | |
| 196 | +* Added Loops integration for email capture, allowing emails to be captured through the chatbot and added to a Loops mailing list. | |
| 197 | +* Configurable Loops integration settings, including API key entry, mailing list selection, custom trigger keywords, and personalized responses. | |
| 198 | +* Fixed the rate limit setting to ensure accurate rate-limiting based on configuration. | |
| 199 | +* Resolved issues with the "Open Links in New Tab" toggle for improved link behavior. | |
| 200 | + | |
| 201 | += 1.1.2 = | |
| 202 | +* Added URL submission to sitemap submission, enabling both types to be handled seamlessly. | |
| 203 | +* Enhanced manual submission with a URL field, allowing easy pairing of manual content with specific URLs. | |
| 204 | +* Improved error display for content submissions, providing clearer feedback on submission issues. | |
| 205 | +* Expanded WooCommerce integration with new "Add to Cart" and checkout features, enhancing user shopping interactions. | |
| 206 | +* Replaced the "General" section with a dedicated FAQ section, adding common questions and answers for user guidance. | |
| 207 | + | |
| 208 | += 1.1.1 = | |
| 209 | +* Fixed CSS bug preventing the send button from showing. | |
| 210 | + | |
| 211 | += 1.1.0 = | |
| 212 | +* Complianz Integration (Pro Feature): Added integration with the Complianz plugin to ensure GDPR compliance. The chatbot now only displays based on user consent for marketing cookies, making it easier for site owners to stay compliant with data privacy regulations. | |
| 213 | + | |
| 214 | += 1.0.11 = | |
| 215 | +* Added a customizable privacy policy text field allowing site owners to define their own message. | |
| 216 | +* Introduced a new admin setting to customize the chatbot input placeholder text, supporting multilingual websites. | |
| 217 | +* Improved localization options for sites using different languages, making customization easier for global users. | |
| 218 | + | |
| 219 | += 1.0.10 = | |
| 220 | +* Added a toggle in the admin panel to control whether chatbot links open in a new tab (`_blank`) or the same tab (`_self`). | |
| 221 | +* Enhanced CSS for the privacy policy notice to prevent theme overrides and ensure consistent styling across themes. | |
| 222 | + | |
| 223 | += 1.0.9 = | |
| 224 | +* Added IP address masking for enhanced user privacy in chat transcripts. | |
| 225 | +* Introduced the option to display a privacy policy notice below the chatbot, with a customizable URL. | |
| 226 | +* Website owners can toggle the privacy policy notice on or off via the admin panel. | |
| 227 | +* Various code optimizations for improved security and compliance with privacy standards. | |
| 228 | + | |
| 229 | += 1.0.8 = | |
| 230 | +* Usernames are now included in chat transcripts when users are logged in, providing better context in conversation history. | |
| 231 | +* The chatbot can now interact with users about their WooCommerce orders, including retrieving order history, order statuses, item details, and more. | |
| 232 | +* Various bug fixes and UI enhancements for a smoother user experience. | |
| 233 | + | |
| 234 | += 1.0.6 = | |
| 235 | +* Added WooCommerce Integration feature, allowing users to integrate WooCommerce products directly into the chatbot. | |
| 236 | +* Updated developer credit link to https://mxchat.ai/. | |
| 237 | +* Rearranged the layout and styling of the main settings page, which is now broken down into tabs for easier navigation. | |
| 238 | + | |
| 239 | += 1.0.5 = | |
| 240 | +* Preparing for WordPress Directory standardization and improvements. | |
| 241 | +* Added new pre-message feature. | |
| 242 | + | |
| 243 | += 1.0.4 = | |
| 244 | +* Released Chat Transcripts feature, allowing users to review and analyze conversations directly from the WordPress dashboard. | |
| 245 | +* Enhanced user experience with the ability to monitor and refine AI responses based on real interactions. | |
| 246 | + | |
| 247 | += 1.0.3 = | |
| 248 | +* Added Activation Key for unlocking Pro features like Theme Customization and Rate Limit Settings. | |
| 249 | +* Enhanced theme customization options for the AI Chatbot widget. | |
| 250 | + | |
| 251 | += 1.0.1 = | |
| 252 | +* Added sitemap submission feature to automatically add content from URLs in the sitemap to the knowledge base, enhancing the AI's responses. | |
| 253 | +* Enhanced admin interface and styling. | |
| 254 | + | |
| 255 | += 1.0 = | |
| 256 | +* Initial release of MxChat. | |
| 257 | + | |
| 258 | +== Upgrade Notice == | |
| 259 | + | |
| 260 | += 1.2 = | |
| 261 | +* Introduced **Popular Questions Buttons**, allowing up to three pre-configured questions for users to quickly ask. The first question is free, while questions two and three are available in the Pro version. | |
| 262 | +* Added an **Inline Edit Button** for the Knowledge Database, simplifying the content management process. | |
| 263 | + | |
| 264 | +== License & Warranty == | |
| 265 | + | |
| 266 | +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. | |
| 267 | + | |
| 268 | +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. | |
| 269 | + | |
| 270 | +== Credits == | |
| 271 | + | |
| 272 | +This plugin was developed by [MxChat](https://mxchat.ai/). | |
