MxChat Admin Assistant
AI-powered chat interface built directly into your WordPress admin panel. Work smarter with multiple AI models, image generation, image editing, image analysis, and web search—all without leaving your dashboard.
Requirements
- MxChat Core Plugin (installed and activated)
- MxChat Pro License (active)
- WordPress 5.8 or higher
- PHP 7.4 or higher
- At least one configured API key (OpenAI, Claude, Gemini, xAI, or DeepSeek)
Quick Setup
- Install the Plugin: Upload and activate MxChat Admin Assistant through your WordPress plugins page
- Verify Core Plugin: Ensure MxChat core plugin is installed and active
- Activate Pro License: Your MxChat Pro license must be active
- Configure API Keys: Add at least one API key in
MxChat → Chatbot → Chat Model Selection - Access Admin Chat: Navigate to
MxChat → Admin AI Chatin your WordPress admin menu - Select Your Model: Click the model selector and choose your preferred AI model
Key Features
Multi-Model AI Chat
Access 20+ AI models from 5 major providers all in one interface. Switch between models instantly to compare responses or use specialized models for specific tasks.
Image Generation
Generate images directly in chat using DALL-E 3, GPT Image, xAI Grok-2-Image, or Google Gemini Nano Banana. Toggle image generation mode with Alt+I or click the image icon.
Image Editing (Gemini)
Upload an image and describe changes you want to make. Gemini Nano Banana will intelligently edit your images based on natural language instructions.
Image Analysis
Upload or paste images for analysis using Grok 2 Vision or GPT-4 Vision. Ask questions about images, extract text, or get detailed descriptions. Toggle with Alt+U.
Web Search (Perplexity)
Enable real-time web search for current information, news, or research. Requires the MxChat Perplexity add-on with configured API key. Toggle with Alt+P.
Chat History Management
Automatically saves all conversations. View, search, load, or delete previous chats. Quick access with the History button in the header.
Auto-Save & Session Recovery
Conversations auto-save every 2 seconds. Sessions persist across page refreshes and browser restarts. Never lose your work.
Available AI Models
Google Gemini Models
Gemini 2.0 Flash: Next-gen features, speed, and multimodal generation
Gemini 2.0 Flash-Lite: Cost-efficient with low latency
Gemini 1.5 Pro: Complex reasoning tasks requiring intelligence
Gemini 1.5 Flash: Fast and versatile performance
Configure: MxChat → Chatbot → Select Gemini model → Enter Google API key
OpenAI GPT Models
GPT-5: Best for coding and agentic tasks across domains
GPT-5 Mini: Faster, cost-efficient for well-defined tasks
GPT-5 Nano: Fastest, most cost-efficient GPT-5 version
GPT-4.1: Flagship model for complex tasks
GPT-4o: Recommended for most use cases
GPT-4o Mini: Fast and lightweight
GPT-4 Turbo: High-performance model
GPT-3.5 Turbo: Affordable and fast
Configure: MxChat → Chatbot → Select OpenAI model → Enter API key
Anthropic Claude Models
Claude 4 Opus: Most powerful and intelligent AI model
Claude 4 Sonnet: Advanced intelligence with enhanced capabilities
Claude 3.7 Sonnet: Most intelligent Claude 3 model
Claude 3.5 Sonnet: Intelligent and balanced
Claude 3 Opus: Highly complex tasks
Claude 3 Haiku: Fastest Claude model
Configure: MxChat → Chatbot → Select Claude model → Enter Anthropic API key
xAI Grok Models
Grok Code Fast 1: Speedy and economical, excels at agentic coding
Grok 4: Latest flagship model – unparalleled performance
Grok-3: Powerful model with 131K context
Grok-3 Fast: High performance with faster responses
Grok-3 Mini: Affordable with good performance
Grok 2: Latest X.AI model
Configure: MxChat → Chatbot → Select xAI model → Enter xAI API key
DeepSeek Models
DeepSeek-V3: Advanced AI assistant
Configure: MxChat → Chatbot → Select DeepSeek model → Enter DeepSeek API key
How to Use
Basic Chat
- Navigate to
MxChat → Admin AI Chat - Select your preferred AI model from the dropdown
- Type your message in the input field
- Press
Enterto send (orShift+Enterfor new line) - View the AI’s response with syntax highlighting for code
Image Generation
- Click the image icon or press
Alt+Ito enable image generation mode - Configure settings: Click Settings → Choose model (DALL-E, GPT Image, xAI, or Gemini)
- Describe the image you want to create
- Press
Enterto generate - Image appears in chat with download option
Image Editing (Gemini Only)
- Ensure Gemini is selected as your image generation model in Settings
- Click the camera icon or press
Alt+U - Upload or paste an image
- Click “Edit Mode” button that appears
- Describe the changes you want (e.g., “make the sky more dramatic”)
- Press
Enterto edit the image - Continue editing the result with additional instructions
Image Analysis
- Click the camera icon or press
Alt+U - Upload an image or paste from clipboard
- Ask questions about the image or request analysis
- Choose between Grok 2 Vision or GPT-4 Vision in Settings
- Image preview appears above input field
- Press
Enterto analyze
Web Search
- Install and configure MxChat Perplexity add-on
- Click the Perplexity icon or press
Alt+Pto enable - Ask questions requiring current information
- Responses include citations and sources
- Select Perplexity model in Settings for different response styles
Managing Conversations
- New Chat: Click “New” button to start fresh (auto-saves current chat)
- View History: Click “History” to see all saved conversations
- Load Chat: Click any chat in history to reload it
- Delete Chat: Click trash icon on chat in history
- Search: Use search box in history to find specific conversations
Alt+I for images, Alt+U for upload, Alt+P for Perplexity, and Enter to send.
Settings Configuration
Image Generation Settings
Click the Settings button to configure image generation options.
DALL-E 3 Options
- Size: Square (1024×1024), Landscape (1792×1024), Portrait (1024×1792)
- Quality: Standard or HD
GPT Image Options
- Size: 1024×1024, 1536×1024, 1024×1536, or Auto
- Quality: Low, Medium, High, or Auto
- Format: PNG, JPEG, or WebP
- Background: Opaque, Transparent (PNG/WebP only), or Auto
- Compression: 0-100% for JPEG/WebP
xAI Grok Options
- Image Count: Generate 1-10 images per request
- Response Format: URL or Base64 JSON
Gemini Nano Banana
- Text-based prompts only (per Google’s API)
- Includes SynthID watermark for authenticity
- Supports both generation and editing
Image Analysis Settings
- Grok 2 Vision: Fast and accurate with strong visual understanding
- GPT-4 Vision: Detailed analysis with excellent instruction following
Perplexity Settings
- Model Selection: Choose response style (fast, balanced, or detailed)
- Response Mode: Conversational or Structured with citations
API Key Configuration
API keys are configured in the main MxChat settings and shared across all MxChat features including Admin Chat.
OpenAI API Key
- Go to
MxChat → Chatbot → Chat Model Selection - Select “OpenAI” from the dropdown
- Enter your OpenAI API key
- Click Save
- You can now use GPT models and DALL-E/GPT Image generation
Anthropic API Key (Claude)
- Go to
MxChat → Chatbot → Chat Model Selection - Select any “Claude” model
- Enter your Anthropic API key
- Click Save
- All Claude models are now available
Google Gemini API Key
- Go to
MxChat → Chatbot → Chat Model Selection - Select any “Gemini” model
- Enter your Google API key
- Click Save
- Enables Gemini chat models and Nano Banana image generation/editing
xAI API Key (Grok)
- Go to
MxChat → Chatbot → Chat Model Selection - Select “xAI” model
- Enter your xAI API key
- Click Save
- Enables Grok models, Grok Vision, and Grok image generation
DeepSeek API Key
- Go to
MxChat → Chatbot → Chat Model Selection - Select “DeepSeek” model
- Enter your DeepSeek API key
- Click Save
Perplexity API Key (Web Search)
- Install the MxChat Perplexity add-on
- Go to
MxChat → Perplexity - Enter your Perplexity API key
- Click Save
- Web search toggle becomes active in Admin Chat
Troubleshooting
Error: “No AI models available”
- Configure at least one API key in
MxChat → Chatbot → Chat Model Selection - Verify your MxChat Pro license is active
- Check that the core MxChat plugin is installed and activated
Error: “Conversation Too Long” or context length errors
- Click “New” to start a fresh conversation (current chat auto-saves)
- Each model has token limits – switch to a model with larger context
- Long conversations with code or images reach limits faster
- Admin Chat uses a 10-message context window to prevent this
Timeout errors (AI taking too long)
- Complex requests can take up to 10 minutes (especially with Grok)
- Break large requests into smaller, focused questions
- Image generation and editing take longer than text responses
- Check the AI provider’s status page for outages
Image generation not working
- Verify the correct API key is configured for your chosen model
- OpenAI key required for DALL-E and GPT Image
- xAI key required for Grok-2-Image
- Google key required for Gemini Nano Banana
- Check Settings to confirm the model selection saved
Image editing only shows “Analyze” mode
- Image editing is only available with Gemini Nano Banana
- Go to Settings → Image Generation → Select “Google Gemini Nano Banana”
- Ensure your Google/Gemini API key is configured
- Upload an image – the “Edit Mode” button should appear
Perplexity/Web search not working
- Install the MxChat Perplexity Integration add-on
- Configure Perplexity API key in
MxChat → Perplexity - Toggle must be active (purple highlight) before sending message
- Verify API key is valid and has available credits
Chat history not saving
- Conversations auto-save every 2 seconds after activity
- Page unload triggers immediate save
- Check browser console for JavaScript errors
- Verify WordPress database can store data (check disk space)
Code blocks not highlighting properly
- Syntax highlighting requires Prism.js (auto-loaded with plugin)
- Check browser console for script loading errors
- Clear browser cache and reload the page
- Disable conflicting plugins that modify admin scripts
Images too large / memory errors
- Images are saved server-side to prevent database bloat
- Maximum recommended image size: 20MB
- Images auto-delete after 30 days to manage storage
- Use smaller/compressed images for analysis and editing
Frequently Asked Questions
Do I need MxChat Pro?
Yes, MxChat Admin Assistant requires an active MxChat Pro license to function.
Can I use this on multisite?
Yes, fully compatible with WordPress multisite. Configure at network level or per-site.
Where are conversations stored?
Conversations are stored in your WordPress database as user metadata. Images are stored as files in wp-content/uploads/mxchat-images/.
How long are chats kept?
Chats persist indefinitely until manually deleted. Images auto-delete after 30 days. Session cache expires after 24 hours.
Can multiple admins use this?
Yes, each WordPress admin user has their own separate chat history and sessions.
What’s the difference between analyze and edit mode?
Analyze mode uses vision models (Grok/GPT-4) to answer questions about images. Edit mode uses Gemini to modify images based on text instructions.
Why does image editing only work with Gemini?
Google’s Gemini Nano Banana is currently the only model that supports text-based image editing through the API. Other providers may add this capability in the future.
Can I use multiple API keys from the same provider?
No, only one API key per provider. All models from that provider use the same key.
What happens if I run out of API credits?
You’ll receive error messages from the respective API provider. Add credits to your account with that provider to continue.
Does this affect my frontend chatbot?
No, Admin Chat is completely separate from your frontend chatbot. They use the same API keys but operate independently.
Can I export chat transcripts?
Currently, you can copy individual messages using the copy button. Full export functionality is planned for a future update.
What’s the context window?
Admin Chat sends the last 10 messages (5 exchanges) to the AI for context. This prevents hitting token limits while maintaining conversation flow.
Pro Tips & Best Practices
Choosing the Right Model
- For coding: GPT-5, Grok Code Fast 1, or Claude 4 Opus
- For writing: Claude 3.7 Sonnet or GPT-4
- For speed: GPT-4o Mini, Gemini 2.0 Flash-Lite, or Claude 3 Haiku
- For complex reasoning: Claude 4 Opus or GPT-5
- For cost-efficiency: DeepSeek-V3 or GPT-3.5 Turbo
Keyboard Shortcuts
Enter– Send messageShift + Enter– New line in messageAlt + I– Toggle image generationAlt + U– Toggle image upload/analysisAlt + P– Toggle Perplexity web search
Image Generation Tips
- Be specific and descriptive in your prompts
- Include style, mood, lighting, and composition details
- Use DALL-E 3 for photorealistic images
- Use GPT Image for detailed control over format and quality
- Use xAI Grok for generating multiple variations (1-10 images)
- Use Gemini for images that need text rendering
Image Editing Best Practices
- Start with clear, well-lit images
- Make one change at a time for better results
- Be specific: “make the sky sunset colors” vs “make it better”
- You can edit the same image multiple times iteratively
- Keep images under 10MB for faster processing
Organizing Conversations
- Start a new chat for different topics or projects
- Use descriptive first messages – they become the chat title
- Search history by keywords to quickly find past conversations
- Delete old test chats to keep history organized
Performance Optimization
- Keep conversations focused to avoid context length issues
- Start fresh chats for unrelated topics
- Use faster models for simple queries
- Compress images before uploading for analysis
- Close unused tabs to free up browser memory
Technical Details
System Architecture
- Frontend: jQuery-based interface with modular JavaScript
- Backend: PHP with WordPress AJAX handlers
- Storage: WordPress user meta for conversations, transients for cache
- Images: Server-side file storage in uploads directory
- Session: 24-hour transient cache with localStorage backup
API Timeouts
- Text responses: 300 seconds (5 minutes)
- xAI Grok: 600 seconds (10 minutes)
- Image generation: 120 seconds (2 minutes)
- Image analysis: 60 seconds (1 minute)
- Perplexity search: 180 seconds (3 minutes)
Context Management
- Last 10 messages sent to AI (5 user + 5 assistant)
- Full history stored locally for chat history feature
- Context window prevents token limit errors
- Images not included in context after initial analysis
Security Features
- WordPress nonce verification on all AJAX requests
- Capability checks – requires
manage_options - Input sanitization and output escaping
- User messages stored as plain text, HTML stripped
- Per-user conversation isolation
File Management
- Images saved with unique filenames to prevent conflicts
- Automatic cleanup of images older than 30 days
- .htaccess protection on uploads directory
- Database metadata tracking for all stored images
Browser Compatibility
- Chrome/Edge 90+
- Firefox 88+
- Safari 14+
- Opera 76+
Recent Updates
Version 1.0.7 (Latest)
- Added GPT-5, GPT-5 Mini, and GPT-5 Nano models
- Added xAI Grok Code Fast 1 model for agentic coding
- Added Gemini Nano Banana image generation and editing
- Improved image storage system – files instead of base64
- Enhanced auto-save with session recovery
- Better error handling for timeouts and context length
Version 1.0.6
- Added Grok-4 model support
- Introduced image analysis with Grok and OpenAI vision models
- Image upload and paste functionality
- Improved chat flow and performance
Version 1.0.3
- Added xAI image generation
- Support for additional models
- Updated settings UI
Version 1.0.0
- Initial release
- Multi-model chat interface
- Image generation with DALL-E 3
- Perplexity web search integration
- Chat history management
Need Help?
If you’re experiencing issues not covered in this documentation:
- Visit MxChat.ai for support resources
- Watch tutorials on the MxChat YouTube channel
- Check the browser console (F12) for JavaScript errors
- Verify all plugin requirements are met
- Contact MxChat support with your license key and detailed error description