PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.1.3
MxChat – AI Chatbot & Content Generation for WordPress v3.1.3
3.2.21 3.2.20 3.2.19 3.2.18 3.2.17 3.2.16 3.2.15 3.2.14 3.2.12 3.2.13 3.2.11 3.2.10 3.2.9 3.2.8 3.2.7 3.2.6 3.2.5 3.2.4 3.2.3 3.2.2 3.2.1 2.0.3 2.0.4 2.0.5 2.0.6 All 152 releases
← All changes | includes/admin-settings-page.php +25 -498 3.2.123.1.3 View file →
@@ -67,12 +67,8 @@
67 67 <button class="mxch-mobile-nav-link" data-target="optimization">
68 68 <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
69 69 <span><?php esc_html_e('Optimization', 'mxchat'); ?></span>
70 70 </button>
71 - <button class="mxch-mobile-nav-link" data-target="testing">
72 - <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 2v6"/><path d="M15 2v6"/><path d="M12 17v5"/><path d="M5 8h14"/><path d="M6 11v-1a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v1"/><path d="m9 14 3 3 3-3"/></svg>
73 - <span><?php esc_html_e('Testing', 'mxchat'); ?></span>
74 - </button>
75 71 </div>
76 72 <!-- Integrations Section -->
77 73 <div class="mxch-mobile-nav-section">
78 74 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Integrations', 'mxchat'); ?></div>
@@ -159,17 +155,8 @@
159 155 </span>
160 156 <span class="mxch-nav-link-text"><?php esc_html_e('Optimization', 'mxchat'); ?></span>
161 157 </button>
162 158 </div>
163 -
164 - <div class="mxch-nav-item" data-section="testing">
165 - <button class="mxch-nav-link" data-target="testing">
166 - <span class="mxch-nav-link-icon">
167 - <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 2v6"/><path d="M15 2v6"/><path d="M12 17v5"/><path d="M5 8h14"/><path d="M6 11v-1a2 2 0 0 1 2-2h8a2 2 0 0 1 2 2v1"/><path d="m9 14 3 3 3-3"/></svg>
168 - </span>
169 - <span class="mxch-nav-link-text"><?php esc_html_e('Testing', 'mxchat'); ?></span>
170 - </button>
171 - </div>
172 159 </div>
173 160
174 161 <!-- Integrations Section -->
175 162 <div class="mxch-nav-section">
@@ -205,9 +192,8 @@
205 192 <span class="mxch-nav-link-text"><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
206 193 </button>
207 194 </div>
208 195 </div>
209 -
210 196 </nav>
211 197
212 198 <?php if (!$is_activated): ?>
213 199 <div class="mxch-sidebar-footer">
@@ -223,12 +209,12 @@
223 209 <main class="mxch-content">
224 210 <?php if (!$is_activated): ?>
225 211 <div class="mxch-pro-banner">
226 212 <div class="mxch-pro-banner-content">
227 - <h3 class="mxch-pro-banner-title"><?php esc_html_e('Stop paying $50–200/month for AI chatbot tools.', 'mxchat'); ?></h3>
228 - <p class="mxch-pro-banner-text"><?php esc_html_e('One payment unlocks every MxChat Pro add-on for life — MCP server access for Claude / ChatGPT / Claude Code, WooCommerce sales, Google Search Console insights, AI-generated chatbot themes, lead-capture forms, unlimited bots, image analysis, and more. No renewals. No surprise bills.', 'mxchat'); ?></p>
213 + <h3 class="mxch-pro-banner-title"><?php esc_html_e('MxChat Pro — Lifetime Access', 'mxchat'); ?></h3>
214 + <p class="mxch-pro-banner-text"><?php esc_html_e('One-time purchase. Unlock 10+ premium add-ons: Admin AI Assistant, Forms Builder, Chatbot Themes, and more.', 'mxchat'); ?></p>
229 215 </div>
230 - <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Get Lifetime Access →', 'mxchat'); ?></span></a>
216 + <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Learn More', 'mxchat'); ?></span></a>
231 217 </div>
232 218 <?php endif; ?>
233 219
234 220 <?php
@@ -262,12 +248,12 @@
262 248 mxchat_render_field_wrapper('enable_streaming', __('Enable Streaming', 'mxchat'), function() use ($admin_instance) {
263 249 $admin_instance->enable_streaming_toggle_callback();
264 250 }, __('Enable real-time streaming responses for supported models (OpenAI, Claude, DeepSeek, Grok).', 'mxchat'));
265 251
266 - // Enable Web Search (OpenAI & Gemini)
252 + // Enable Web Search (OpenAI only)
267 253 mxchat_render_field_wrapper('enable_web_search', __('Enable Web Search', 'mxchat'), function() use ($admin_instance) {
268 254 $admin_instance->enable_web_search_toggle_callback();
269 - }, __('Allow the chatbot to search the web for current information (OpenAI and Gemini models).', 'mxchat'));
255 + }, __('Allow the chatbot to search the web for current information (OpenAI models only).', 'mxchat'));
270 256 ?>
271 257 </div>
272 258 </div>
273 259 </div>
@@ -298,13 +284,8 @@
298 284 mxchat_render_field_wrapper('rag_sources_limit', __('RAG Sources Limit', 'mxchat'), function() use ($admin_instance) {
299 285 $admin_instance->mxchat_rag_sources_limit_callback();
300 286 }, __('Number of knowledge base sources (pages/documents) to include in AI context. Higher values provide more context but use more tokens.', 'mxchat'));
301 287
302 - // RAG Chunks Limit
303 - mxchat_render_field_wrapper('rag_chunks_limit', __('RAG Chunks Limit', 'mxchat'), function() use ($admin_instance) {
304 - $admin_instance->mxchat_rag_chunks_limit_callback();
305 - }, __('Maximum total content chunks sent to the AI across all sources. Higher values provide more context but increase token usage and cost.', 'mxchat'));
306 -
307 288 // Contextual Awareness
308 289 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
309 290 $admin_instance->mxchat_contextual_awareness_callback();
310 291 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
@@ -313,16 +294,12 @@
313 294 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
314 295 $admin_instance->mxchat_citation_links_toggle_callback();
315 296 }, __('Allow the AI to include citation links from your knowledge database in responses. If disabled, ensure your AI Behavior settings do not mention links or the AI may fabricate URLs.', 'mxchat'));
316 297
317 - // Satisfaction Rating Prompt
318 - // The toggle callback inline-renders the 5 customization
319 - // fields inside a single sub-options wrapper (plan-29caac).
320 - // No separate customization group needed — the wrapper handles
321 - // its own server-side display state based on the toggle value.
322 - mxchat_render_field_wrapper('satisfaction_rating', __('Satisfaction Rating Prompt', 'mxchat'), function() use ($admin_instance) {
323 - $admin_instance->mxchat_satisfaction_rating_toggle_callback();
324 - }, __('Show a 👍 / 👎 prompt after a conversation has had a couple of bot replies and the visitor has been idle for a moment. Disable to hide the prompt site-wide.', 'mxchat'));
298 + // Frontend Debugger
299 + mxchat_render_field_wrapper('frontend_debugger', __('Frontend Debugger', 'mxchat'), function() use ($admin_instance) {
300 + $admin_instance->mxchat_frontend_debugger_callback();
301 + }, __('Show debug panel on frontend for admins. Displays similarity scores and query analysis.', 'mxchat'));
325 302 ?>
326 303 </div>
327 304 </div>
328 305 </div>
@@ -358,23 +335,8 @@
358 335 // Chat Persistence
359 336 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
360 337 $admin_instance->mxchat_chat_persistence_toggle_callback();
361 338 }, __('Keep chat history when users navigate or return within 24 hours.', 'mxchat'));
362 -
363 - // Download Transcript button
364 - mxchat_render_field_wrapper('print_button', __('Show Download Transcript Button', 'mxchat'), function() use ($admin_instance) {
365 - $admin_instance->mxchat_print_button_toggle_callback();
366 - }, __('Show the "Download Transcript" item in the chat window menu.', 'mxchat'));
367 -
368 - // Start-New-Chat button (plan ac2e81) — lets a visitor reset the
369 - // conversation without the owner disabling chat persistence globally.
370 - mxchat_render_field_wrapper('reset_chat_enabled', __('Show Start-New-Chat Button', 'mxchat'), function() use ($admin_instance) {
371 - $admin_instance->mxchat_reset_chat_toggle_callback();
372 - }, __('Show a "Start new chat" item in the chat window menu that clears the current conversation and begins a fresh session.', 'mxchat'));
373 -
374 - mxchat_render_field_wrapper('reset_chat_label', __('Start-New-Chat Button Label', 'mxchat'), function() use ($admin_instance) {
375 - $admin_instance->mxchat_reset_chat_label_callback();
376 - }, __('Label for the Start-New-Chat menu item. Leave blank to use "Start new chat".', 'mxchat'));
377 339 ?>
378 340 </div>
379 341 </div>
380 342
@@ -406,13 +368,8 @@
406 368 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
407 369 $admin_instance->mxchat_input_copy_callback();
408 370 }, __('Placeholder text in the chat input field.', 'mxchat'));
409 371
410 - // Max Input Length (characters) — plan a3fae2 part C
411 - mxchat_render_field_wrapper('max_input_length', __('Max Input Length (characters)', 'mxchat'), function() use ($admin_instance) {
412 - $admin_instance->mxchat_max_input_length_callback();
413 - }, __('Cap how many characters a visitor can type or paste into a single message. Set to 0 for unlimited (default).', 'mxchat'));
414 -
415 372 // Chat Teaser
416 373 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
417 374 $admin_instance->mxchat_pre_chat_message_callback();
418 375 }, __('Message shown before users start chatting.', 'mxchat'));
@@ -630,99 +587,8 @@
630 587 </div>
631 588 </div>
632 589 </div>
633 590
634 - <!-- Page Cache Compatibility Card -->
635 - <div class="mxch-card">
636 - <div class="mxch-card-header">
637 - <h3 class="mxch-card-title">
638 - <svg class="mxch-card-title-icon" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27 6.96 12 12.01 20.73 6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>
639 - <?php esc_html_e('Page Cache Compatibility', 'mxchat'); ?>
640 - </h3>
641 - </div>
642 - <div class="mxch-card-body">
643 - <p class="mxch-field-description" style="margin-top: 0;"><?php esc_html_e('MxChat\'s chat send (and stream send, plus PDF / Word upload) all POST to /wp-admin/admin-ajax.php. Page-cache plugins occasionally cache those responses, which breaks the per-session nonce flow on the first message. MxChat auto-tells the five most common cache plugins to never cache chat AJAX via their own filter APIs — no setup needed for those. For other cache plugins (or Cloudflare APO), copy the manual exclusion string into your cache plugin\'s exclusion list.', 'mxchat'); ?></p>
644 -
645 - <?php
646 - $mxch_cache_rows = array(
647 - array('name' => 'WP Rocket', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax\\.php\\?action=mxchat_.*'),
648 - array('name' => 'LiteSpeed Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
649 - array('name' => 'W3 Total Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
650 - array('name' => 'FlyingPress', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
651 - array('name' => 'WP Super Cache', 'state' => 'auto', 'exclusion' => 'wp-admin/admin-ajax.php'),
652 - array('name' => 'Cloudflare APO', 'state' => 'manual', 'exclusion' => 'Page Rule / Cache Rule: URI Path contains "/wp-admin/admin-ajax.php" → Bypass Cache'),
653 - );
654 - ?>
655 -
656 - <div class="mxch-cache-compat-grid" style="display: grid; grid-template-columns: 1fr; gap: 12px; margin-top: 16px;">
657 - <?php foreach ($mxch_cache_rows as $row) :
658 - $is_auto = ($row['state'] === 'auto');
659 - $pill_class = $is_auto ? 'mxch-status-pill-active' : 'mxch-status-pill-warning';
660 - $pill_label = $is_auto ? __('Auto-handled', 'mxchat') : __('Manual', 'mxchat');
661 - ?>
662 - <div class="mxch-cache-compat-row" style="display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 12px 14px; background: #f8fafc; border: 1px solid var(--mxch-card-border); border-radius: var(--mxch-radius-md);">
663 - <div style="display: flex; align-items: center; gap: 10px; min-width: 0; flex: 0 0 auto;">
664 - <span style="font-weight: 500;"><?php echo esc_html($row['name']); ?></span>
665 - <span class="mxch-status-pill <?php echo esc_attr($pill_class); ?>">
666 - <span class="mxch-status-dot"></span>
667 - <?php echo esc_html($pill_label); ?>
668 - </span>
669 - </div>
670 - <div style="display: flex; align-items: center; gap: 8px; flex: 1 1 auto; min-width: 0;">
671 - <code style="background: #fff; border: 1px solid var(--mxch-card-border); padding: 4px 8px; border-radius: var(--mxch-radius-sm); font-size: 12px; color: var(--mxch-text-secondary); flex: 1 1 auto; overflow-x: auto; white-space: nowrap; min-width: 0;"><?php echo esc_html($row['exclusion']); ?></code>
672 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" data-mxch-copy="<?php echo esc_attr($row['exclusion']); ?>" style="flex: 0 0 auto;">
673 - <?php esc_html_e('Copy', 'mxchat'); ?>
674 - </button>
675 - </div>
676 - </div>
677 - <?php endforeach; ?>
678 - </div>
679 -
680 - <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
681 - <svg class="mxch-notice-icon" xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>
682 - <span><?php esc_html_e('Auto-handled plugins receive a filter from MxChat that excludes chat AJAX from their cache. Even so, having the exclusion in your own exclusion list is harmless and acts as a belt-and-suspenders guarantee.', 'mxchat'); ?></span>
683 - </div>
684 - </div>
685 - </div>
686 -
687 - <!-- Provider Reliability Card -->
688 - <?php
689 - $auto_retry_enabled = !isset($options['auto_retry_on_transient_error']) ||
690 - (string) $options['auto_retry_on_transient_error'] !== '0';
691 - ?>
692 - <div class="mxch-card">
693 - <div class="mxch-card-header">
694 - <h3 class="mxch-card-title">
695 - <svg class="mxch-card-title-icon" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12a9 9 0 1 1-6.219-8.56"/><polyline points="21 4 21 10 15 10"/></svg>
696 - <?php esc_html_e('Provider Reliability', 'mxchat'); ?>
697 - </h3>
698 - <span class="mxch-status-pill <?php echo $auto_retry_enabled ? 'mxch-status-pill-active' : 'mxch-status-pill-disabled'; ?>">
699 - <span class="mxch-status-dot"></span>
700 - <?php echo $auto_retry_enabled ? esc_html__('Active', 'mxchat') : esc_html__('Disabled', 'mxchat'); ?>
701 - </span>
702 - </div>
703 - <div class="mxch-card-body mxchat-autosave-section">
704 - <div class="mxch-field">
705 - <label class="mxch-field-label" for="auto_retry_on_transient_error">
706 - <?php esc_html_e('Auto-retry on provider overload', 'mxchat'); ?>
707 - </label>
708 - <div class="mxch-field-control">
709 - <label class="mxch-toggle">
710 - <input type="checkbox"
711 - id="auto_retry_on_transient_error"
712 - name="mxchat_options[auto_retry_on_transient_error]"
713 - class="mxchat-autosave-field"
714 - value="1"
715 - <?php checked($auto_retry_enabled); ?> />
716 - <span class="mxch-toggle-slider"></span>
717 - </label>
718 - </div>
719 - <p class="mxch-field-description"><?php esc_html_e('When the AI provider returns a transient error (rate-limit / overload / 429 / 503 / Gemini "model overloaded"), MxChat retries the chat-send up to twice before surfacing the error. Visitors see a brief pause instead of a raw provider error in the bot bubble.', 'mxchat'); ?></p>
720 - <p class="mxch-field-hint"><?php esc_html_e('Configuration errors (invalid API key, 401/403/404/422) still surface immediately — never retried.', 'mxchat'); ?></p>
721 - </div>
722 - </div>
723 - </div>
724 -
725 591 <!-- Debug Mode Card -->
726 592 <?php
727 593 $debug_mode = isset($options['debug_mode']) ? $options['debug_mode'] : 'off';
728 594 $debug_active = ($debug_mode === 'on');
@@ -914,9 +780,9 @@
914 780 <svg class="mxch-notice-icon" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>
915 781 <div>
916 782 <?php printf(
917 783 esc_html__('Visit our %s for setup instructions.', 'mxchat'),
918 - '<a href="https://mxchat.ai/documentation/mxchat-core#slack-live-agent-handoff" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
784 + '<a href="https://mxchat.ai/documentation/#slack_integration" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
919 785 ); ?>
920 786 </div>
921 787 </div>
922 788
@@ -1061,40 +927,8 @@
1061 927 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1062 928 <p class="mxch-content-subtitle"><?php esc_html_e('Learn how to get the most out of MxChat with our video guides.', 'mxchat'); ?></p>
1063 929 </div>
1064 930
1065 - <?php
1066 - // Setup Guide — reopen the onboarding wizard (plan-347916, moved here from Display tab).
1067 - // Only shows once the user has dismissed/graduated from the Onboarding page.
1068 - if (function_exists('mxchat_onboarding_is_dismissed') && mxchat_onboarding_is_dismissed()):
1069 - $auto_grad = function_exists('mxchat_onboarding_is_auto_graduated') && mxchat_onboarding_is_auto_graduated();
1070 - ?>
1071 - <div class="mxch-card mxch-onboarding-unhide-card" style="margin-bottom: 24px;">
1072 - <div class="mxch-card-header">
1073 - <h3 class="mxch-card-title">
1074 - <svg class="mxch-card-title-icon" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 10v6M2 10l10-5 10 5-10 5z"/><path d="M6 12v5c0 2 3 3 6 3s6-1 6-3v-5"/></svg>
1075 - <?php esc_html_e('Setup Guide', 'mxchat'); ?>
1076 - </h3>
1077 - </div>
1078 - <div class="mxch-card-body">
1079 - <p style="margin:0 0 12px;color:var(--mxch-text-secondary);font-size:13px;line-height:1.5;">
1080 - <?php if ($auto_grad): ?>
1081 - <?php esc_html_e('You finished the setup guide. Reopen it any time to revisit the steps or change a setup choice.', 'mxchat'); ?>
1082 - <?php else: ?>
1083 - <?php esc_html_e('You hid the setup guide from the MxChat menu. Reopen it any time to revisit the steps.', 'mxchat'); ?>
1084 - <?php endif; ?>
1085 - </p>
1086 - <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>" style="margin:0;">
1087 - <?php wp_nonce_field('mxchat_unhide_onboarding'); ?>
1088 - <input type="hidden" name="action" value="mxchat_unhide_onboarding" />
1089 - <button type="submit" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1090 - <?php esc_html_e('Reopen setup guide', 'mxchat'); ?>
1091 - </button>
1092 - </form>
1093 - </div>
1094 - </div>
1095 - <?php endif; ?>
1096 -
1097 931 <div class="mxch-card" style="margin-bottom: 24px;">
1098 932 <div class="mxch-card-body">
1099 933 <div style="display: flex; align-items: flex-start; gap: 16px;">
1100 934 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="color: var(--mxch-warning); flex-shrink: 0;"><path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><path d="M12 9v4"/><path d="M12 17h.01"/></svg>
@@ -1199,115 +1033,8 @@
1199 1033 <?php endforeach; ?>
1200 1034 </div>
1201 1035 </div>
1202 1036
1203 - <!-- =====================================================
1204 - TESTING SECTION
1205 - ===================================================== -->
1206 - <div id="testing" class="mxch-section">
1207 - <div class="mxch-content-header">
1208 - <h1 class="mxch-content-title"><?php esc_html_e('Testing', 'mxchat'); ?></h1>
1209 - <p class="mxch-content-subtitle"><?php esc_html_e('Test your chatbot and inspect debug data in real time.', 'mxchat'); ?></p>
1210 - </div>
1211 -
1212 - <div class="mxch-testing-layout">
1213 - <!-- Left Column: Debug Panel -->
1214 - <div class="mxch-testing-debug-panel">
1215 - <!-- Quick Actions -->
1216 - <div class="mxch-card">
1217 - <div class="mxch-card-body">
1218 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Quick Actions', 'mxchat'); ?></h3>
1219 - <div class="mxch-testing-actions-row">
1220 - <button type="button" class="mxch-testing-btn mxch-testing-btn-danger" id="mxch-testing-clear-session">
1221 - <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 6h18"/><path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6"/><path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2"/></svg>
1222 - <?php esc_html_e('Clear Chat Session', 'mxchat'); ?>
1223 - </button>
1224 - <button type="button" class="mxch-testing-btn mxch-testing-btn-secondary" id="mxch-testing-clear-debug">
1225 - <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v20M2 12h20"/></svg>
1226 - <?php esc_html_e('Clear Debug Log', 'mxchat'); ?>
1227 - </button>
1228 - </div>
1229 - </div>
1230 - </div>
1231 -
1232 - <!-- Last Query Analysis -->
1233 - <div class="mxch-card">
1234 - <div class="mxch-card-body">
1235 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Last Query Analysis', 'mxchat'); ?></h3>
1236 -
1237 - <div class="mxch-testing-field">
1238 - <label><?php esc_html_e('Similarity Threshold', 'mxchat'); ?></label>
1239 - <span id="mxch-testing-threshold"><?php esc_html_e('Loading...', 'mxchat'); ?></span>
1240 - </div>
1241 -
1242 - <div class="mxch-testing-field">
1243 - <label><?php esc_html_e('User Query', 'mxchat'); ?></label>
1244 - <div id="mxch-testing-last-query" class="mxch-testing-query-display"><?php esc_html_e('Waiting for next query...', 'mxchat'); ?></div>
1245 - </div>
1246 -
1247 - <div class="mxch-testing-field">
1248 - <label><?php esc_html_e('Approved URLs for Citations', 'mxchat'); ?></label>
1249 - <div id="mxch-testing-approved-urls" class="mxch-testing-results">
1250 - <div class="mxch-testing-no-data"><?php esc_html_e('No URL data yet', 'mxchat'); ?></div>
1251 - </div>
1252 - </div>
1253 -
1254 - <div class="mxch-testing-field">
1255 - <label><?php esc_html_e('Document Matches', 'mxchat'); ?></label>
1256 - <div id="mxch-testing-similarity-scores" class="mxch-testing-results">
1257 - <div class="mxch-testing-no-data"><?php esc_html_e('No query data yet', 'mxchat'); ?></div>
1258 - </div>
1259 - </div>
1260 -
1261 - <div class="mxch-testing-field">
1262 - <label><?php esc_html_e('Actions Triggered', 'mxchat'); ?></label>
1263 - <div id="mxch-testing-action-scores" class="mxch-testing-results">
1264 - <div class="mxch-testing-no-data"><?php esc_html_e('No action data yet', 'mxchat'); ?></div>
1265 - </div>
1266 - </div>
1267 - </div>
1268 - </div>
1269 -
1270 - <!-- System Information -->
1271 - <div class="mxch-card">
1272 - <div class="mxch-card-body">
1273 - <h3 class="mxch-testing-section-title"><?php esc_html_e('System Information', 'mxchat'); ?></h3>
1274 -
1275 - <div class="mxch-testing-field">
1276 - <label><?php esc_html_e('System Prompt', 'mxchat'); ?></label>
1277 - <div id="mxch-testing-system-prompt" class="mxch-testing-system-prompt"><?php esc_html_e('Loading...', 'mxchat'); ?></div>
1278 - </div>
1279 -
1280 - <div class="mxch-testing-field">
1281 - <label><?php esc_html_e('Knowledge Base', 'mxchat'); ?></label>
1282 - <span id="mxch-testing-kb-status"><?php esc_html_e('Checking...', 'mxchat'); ?></span>
1283 - </div>
1284 - </div>
1285 - </div>
1286 -
1287 - <!-- Debug Log -->
1288 - <div class="mxch-card">
1289 - <div class="mxch-card-body">
1290 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Debug Log', 'mxchat'); ?></h3>
1291 - <div id="mxch-testing-debug-console" class="mxch-testing-debug-console">
1292 - <div class="mxch-testing-debug-entry"><?php esc_html_e('Debug panel ready - send a message to begin...', 'mxchat'); ?></div>
1293 - </div>
1294 - </div>
1295 - </div>
1296 - </div>
1297 -
1298 - <!-- Right Column: Chatbot Replica -->
1299 - <div class="mxch-testing-chatbot-column">
1300 - <div class="mxch-testing-chatbot-scope">
1301 - <?php
1302 - // Render the chatbot inline for testing
1303 - echo do_shortcode('[mxchat_chatbot floating="no" bot_id="testing"]');
1304 - ?>
1305 - </div>
1306 - </div>
1307 - </div>
1308 - </div>
1309 -
1310 1037 </main>
1311 1038 </div>
1312 1039
1313 1040 <script>
@@ -1410,45 +1137,22 @@
1410 1137 }
1411 1138 });
1412 1139 });
1413 1140
1414 - // Handle initial deep-link (?tab=<slug> takes precedence over #hash so the
1415 - // Onboarding setup-step CTAs land on the right sub-tab). Whitelist of valid
1416 - // section ids must stay in sync with the .mxch-section[id] values above.
1417 - const validTabs = [
1418 - 'chatbot-ai-models', 'chatbot-behavior', 'chatbot-display',
1419 - 'chatbot-lead-capture', 'chatbot-quick-questions', 'chatbot-rate-limits',
1420 - 'api-keys', 'optimization', 'testing',
1421 - 'integrations-toolbar', 'integrations-loops', 'integrations-brave',
1422 - 'integrations-slack', 'integrations-telegram',
1423 - 'tutorials'
1424 - ];
1425 - function activateTab(target) {
1426 - if (!target) return false;
1427 - if (validTabs.indexOf(target) === -1) return false;
1428 - const targetLink = document.querySelector('[data-target="' + target + '"]');
1429 - if (!targetLink) return false;
1430 - const parentItem = targetLink.closest('.mxch-nav-item');
1431 - if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1432 - parentItem.classList.add('expanded');
1141 + // Handle initial hash
1142 + const hash = window.location.hash.slice(1);
1143 + if (hash) {
1144 + const targetLink = document.querySelector('[data-target="' + hash + '"]');
1145 + if (targetLink) {
1146 + // Expand parent if it's a sub-link
1147 + const parentItem = targetLink.closest('.mxch-nav-item');
1148 + if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1149 + parentItem.classList.add('expanded');
1150 + }
1151 + showSection(hash);
1152 + setActiveNav(targetLink);
1433 1153 }
1434 - showSection(target);
1435 - setActiveNav(targetLink);
1436 - return true;
1437 1154 }
1438 - const urlParams = new URLSearchParams(window.location.search);
1439 - const tabParam = urlParams.get('tab');
1440 - let tabActivated = false;
1441 - if (tabParam) {
1442 - tabActivated = activateTab(tabParam);
1443 - // Invalid ?tab=… silently falls through to default (#hash or AI Models).
1444 - }
1445 - if (!tabActivated) {
1446 - const hash = window.location.hash.slice(1);
1447 - if (hash) {
1448 - activateTab(hash);
1449 - }
1450 - }
1451 1155
1452 1156 // Rate limit accordion
1453 1157 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1454 1158 rateLimitHeaders.forEach(header => {
@@ -1459,26 +1163,8 @@
1459 1163 item.classList.toggle('expanded');
1460 1164 });
1461 1165 });
1462 1166
1463 - // Rate-limit "Custom…" toggle: show/hide the integer input below each
1464 - // limit <select> based on whether __custom__ is the active option.
1465 - document.querySelectorAll('.mxch-rate-limit-limit-select').forEach(sel => {
1466 - const targetId = sel.getAttribute('data-mxch-custom-target');
1467 - if (!targetId) return;
1468 - const field = document.querySelector('[data-mxch-custom-for="' + targetId + '"]');
1469 - if (!field) return;
1470 - const sync = () => {
1471 - if (sel.value === '__custom__') {
1472 - field.hidden = false;
1473 - } else {
1474 - field.hidden = true;
1475 - }
1476 - };
1477 - sel.addEventListener('change', sync);
1478 - sync();
1479 - });
1480 -
1481 1167 // =====================================================
1482 1168 // Mobile Menu Functionality
1483 1169 // =====================================================
1484 1170 const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
@@ -1608,146 +1294,10 @@
1608 1294
1609 1295 $roles = wp_roles()->get_names();
1610 1296 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1611 1297
1612 - // Whole-chatbot global cap (sits above per-role; defaults to unlimited so
1613 - // existing installs are unchanged). Stored under mxchat_options['rate_limits_global'].
1614 - $global_cfg = isset($all_options['rate_limits_global']) && is_array($all_options['rate_limits_global'])
1615 - ? $all_options['rate_limits_global']
1616 - : array();
1617 - $global_limit_raw = isset($global_cfg['limit']) ? (string) $global_cfg['limit'] : 'unlimited';
1618 - $global_timeframe = isset($global_cfg['timeframe']) ? (string) $global_cfg['timeframe'] : 'daily';
1619 - $global_is_unlimited = ($global_limit_raw === '' || $global_limit_raw === 'unlimited');
1620 - $global_is_preset = !$global_is_unlimited && in_array($global_limit_raw, $rate_limits, true);
1621 - $global_select_value = $global_is_unlimited ? 'unlimited' : ($global_is_preset ? $global_limit_raw : '__custom__');
1622 - $global_custom_value = (!$global_is_unlimited && !$global_is_preset && ctype_digit($global_limit_raw))
1623 - ? $global_limit_raw
1624 - : '';
1625 -
1626 1298 echo '<div class="mxch-rate-limits">';
1627 1299
1628 - // --- Global cap card -------------------------------------------------
1629 - ?>
1630 - <div class="mxch-rate-limit-item mxch-rate-limit-global mxchat-autosave-section">
1631 - <div class="mxch-rate-limit-header">
1632 - <span class="mxch-rate-limit-role"><?php esc_html_e('Total chatbot message limit', 'mxchat'); ?></span>
1633 - <div class="mxch-rate-limit-summary">
1634 - <span class="mxch-rate-limit-badge mxch-rate-limit-global-badge">
1635 - <?php
1636 - if ($global_is_unlimited) {
1637 - esc_html_e('Unlimited', 'mxchat');
1638 - } else {
1639 - $tf_label = isset($timeframes[$global_timeframe]) ? $timeframes[$global_timeframe] : $global_timeframe;
1640 - echo esc_html(($global_custom_value !== '' ? $global_custom_value : $global_limit_raw) . ' / ' . $tf_label);
1641 - }
1642 - ?>
1643 - </span>
1644 - <svg class="mxch-rate-limit-arrow" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"></polyline></svg>
1645 - </div>
1646 - </div>
1647 - <div class="mxch-rate-limit-body">
1648 - <p class="mxch-field-description" style="margin: 0 0 12px;">
1649 - <?php esc_html_e('A single ceiling across all users and all roles, per timeframe. Independent of the per-role limits below. When both a per-role limit and this global cap are configured, whichever is hit first stops the conversation. Default is Unlimited — existing installs are unchanged.', 'mxchat'); ?>
1650 - </p>
1651 - <div class="mxch-rate-limit-controls">
1652 - <div class="mxch-field">
1653 - <label class="mxch-field-label" for="rate_limits_global_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1654 - <select id="rate_limits_global_limit"
1655 - name="mxchat_options[rate_limits_global][limit]"
1656 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1657 - data-mxch-custom-target="rate_limits_global_limit_custom">
1658 - <?php foreach ($rate_limits as $limit): ?>
1659 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($global_select_value, $limit); ?>>
1660 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1661 - </option>
1662 - <?php endforeach; ?>
1663 - <option value="__custom__" <?php selected($global_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1664 - </select>
1665 - </div>
1666 - <div class="mxch-field mxch-rate-limit-custom-field" data-mxch-custom-for="rate_limits_global_limit_custom" <?php echo $global_select_value === '__custom__' ? '' : 'hidden'; ?>>
1667 - <label class="mxch-field-label" for="rate_limits_global_limit_custom"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1668 - <input type="number"
1669 - min="1"
1670 - step="1"
1671 - id="rate_limits_global_limit_custom"
1672 - name="mxchat_options[rate_limits_global][limit_custom]"
1673 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1674 - placeholder="e.g. 250"
1675 - value="<?php echo esc_attr($global_custom_value); ?>" />
1676 - </div>
1677 - <div class="mxch-field">
1678 - <label class="mxch-field-label" for="rate_limits_global_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1679 - <select id="rate_limits_global_timeframe"
1680 - name="mxchat_options[rate_limits_global][timeframe]"
1681 - class="mxch-select mxchat-autosave-field">
1682 - <?php foreach ($timeframes as $value => $label): ?>
1683 - <option value="<?php echo esc_attr($value); ?>" <?php selected($global_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1684 - <?php endforeach; ?>
1685 - </select>
1686 - </div>
1687 - </div>
1688 - <?php
1689 - // --- Current usage readout (read-only; mirrors the integrator's
1690 - // window-reset math at READ time — never writes the counter here).
1691 - // v1 surfaces the DEFAULT bot's pool. TODO: per-bot selector if asked.
1692 - $global_usage_limit_int = (!$global_is_unlimited && ctype_digit($global_limit_raw))
1693 - ? (int) $global_limit_raw
1694 - : 0;
1695 - $usage_raw = get_option('mxchat_chat_limit_default_global', array('count' => 0, 'timestamp' => time()));
1696 - $usage_count = isset($usage_raw['count']) ? (int) $usage_raw['count'] : 0;
1697 - $usage_ts = isset($usage_raw['timestamp']) ? (int) $usage_raw['timestamp'] : time();
1698 - $usage_windows = array('hourly' => 3600, 'daily' => 86400, 'weekly' => 604800, 'monthly' => 2592000);
1699 - $usage_window = isset($usage_windows[$global_timeframe]) ? $usage_windows[$global_timeframe] : 86400;
1700 - $usage_now = time();
1701 - if (($usage_now - $usage_ts) >= $usage_window) {
1702 - // Window elapsed since the stored timestamp → effective count is 0.
1703 - $usage_count = 0;
1704 - $usage_reset_at = $usage_now + $usage_window;
1705 - } else {
1706 - $usage_reset_at = $usage_ts + $usage_window;
1707 - }
1708 - $usage_left = max(0, $global_usage_limit_int - $usage_count);
1709 - $usage_pct = ($global_usage_limit_int > 0)
1710 - ? min(100, (int) round(($usage_count / $global_usage_limit_int) * 100))
1711 - : 0;
1712 - $usage_reset_nonce = wp_create_nonce('mxchat_reset_global_usage');
1713 - ?>
1714 - <div class="mxch-rate-limit-usage"
1715 - id="mxch-global-usage"
1716 - data-bot-id="default"
1717 - data-reset-nonce="<?php echo esc_attr($usage_reset_nonce); ?>"
1718 - <?php echo $global_is_unlimited ? 'hidden' : ''; ?>>
1719 - <div class="mxch-rate-limit-usage-head">
1720 - <span class="mxch-field-label" style="margin:0;"><?php esc_html_e('Current usage', 'mxchat'); ?></span>
1721 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxch-global-usage-reset"><?php esc_html_e('Reset counter', 'mxchat'); ?></button>
1722 - </div>
1723 - <div class="mxch-progress-bar">
1724 - <div class="mxch-progress-bar-fill" id="mxch-global-usage-fill" style="width: <?php echo esc_attr($usage_pct); ?>%;"></div>
1725 - </div>
1726 - <p class="mxch-progress-label" id="mxch-global-usage-text" style="margin:0;">
1727 - <?php
1728 - printf(
1729 - /* translators: 1: used count, 2: limit, 3: remaining, 4: human-readable time until reset */
1730 - esc_html__('%1$s of %2$s used · %3$s left · resets in %4$s', 'mxchat'),
1731 - esc_html(number_format_i18n($usage_count)),
1732 - esc_html(number_format_i18n($global_usage_limit_int)),
1733 - esc_html(number_format_i18n($usage_left)),
1734 - esc_html(human_time_diff($usage_now, $usage_reset_at))
1735 - );
1736 - ?>
1737 - </p>
1738 - </div>
1739 - <p class="mxch-field-description mxch-rate-limit-usage-unlimited"
1740 - id="mxch-global-usage-unlimited"
1741 - style="margin: 12px 0 0;"
1742 - <?php echo $global_is_unlimited ? '' : 'hidden'; ?>>
1743 - <?php esc_html_e('Unlimited — no cap. Usage tracking applies only when a numeric limit is set.', 'mxchat'); ?>
1744 - </p>
1745 - </div>
1746 - </div>
1747 - <?php
1748 - // ---------------------------------------------------------------------
1749 -
1750 1300 foreach ($roles as $role_id => $role_name) {
1751 1301 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1752 1302 $default_timeframe = 'daily';
1753 1303 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
@@ -1752,9 +1302,9 @@
1752 1302 $default_timeframe = 'daily';
1753 1303 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1754 1304
1755 1305 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1756 - ? (string) $all_options['rate_limits'][$role_id]['limit']
1306 + ? $all_options['rate_limits'][$role_id]['limit']
1757 1307 : $default_limit;
1758 1308
1759 1309 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1760 1310 ? $all_options['rate_limits'][$role_id]['timeframe']
@@ -1764,16 +1314,8 @@
1764 1314 ? $all_options['rate_limits'][$role_id]['message']
1765 1315 : $default_message;
1766 1316
1767 1317 $timeframe_label = isset($timeframes[$selected_timeframe]) ? $timeframes[$selected_timeframe] : $selected_timeframe;
1768 -
1769 - // Custom-value handling: if the stored limit is not in the preset list
1770 - // and not 'unlimited', it's a custom integer. The select shows __custom__
1771 - // and the number input below carries the actual value.
1772 - $is_preset_limit = in_array($selected_limit, $rate_limits, true);
1773 - $role_select_value = $is_preset_limit ? $selected_limit : '__custom__';
1774 - $role_custom_value = (!$is_preset_limit && ctype_digit($selected_limit)) ? $selected_limit : '';
1775 - $custom_field_id = 'rate_limits_' . $role_id . '_limit_custom';
1776 1318 ?>
1777 1319 <div class="mxch-rate-limit-item">
1778 1320 <div class="mxch-rate-limit-header">
1779 1321 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
@@ -1787,28 +1329,13 @@
1787 1329 <div class="mxch-field">
1788 1330 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1789 1331 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1790 1332 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit]"
1791 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1792 - data-mxch-custom-target="<?php echo esc_attr($custom_field_id); ?>">
1333 + class="mxch-select mxchat-autosave-field">
1793 1334 <?php foreach ($rate_limits as $limit): ?>
1794 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($role_select_value, $limit); ?>>
1795 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1796 - </option>
1335 + <option value="<?php echo esc_attr($limit); ?>" <?php selected($selected_limit, $limit); ?>><?php echo esc_html($limit); ?></option>
1797 1336 <?php endforeach; ?>
1798 - <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1799 1337 </select>
1800 - </div>
1801 - <div class="mxch-field mxch-rate-limit-custom-field" data-mxch-custom-for="<?php echo esc_attr($custom_field_id); ?>" <?php echo $role_select_value === '__custom__' ? '' : 'hidden'; ?>>
1802 - <label class="mxch-field-label" for="<?php echo esc_attr($custom_field_id); ?>"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1803 - <input type="number"
1804 - min="1"
1805 - step="1"
1806 - id="<?php echo esc_attr($custom_field_id); ?>"
1807 - name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit_custom]"
1808 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1809 - placeholder="e.g. 250"
1810 - value="<?php echo esc_attr($role_custom_value); ?>" />
1811 1338 </div>
1812 1339 <div class="mxch-field">
1813 1340 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1814 1341 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"