PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.0.7
MxChat – AI Chatbot & Content Generation for WordPress v3.0.7
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 +35 -684 3.2.183.0.7 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,26 +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 - // Hybrid keyword boost MOVED to Knowledge → Chunking &
308 - // Retrieval (plan 11720c) — it is KB retrieval tuning, not
309 - // conversation behavior. Same option key over there. The
310 - // breadcrumb below is a one-release courtesy: drop it in
311 - // the release after 3.2.17.
312 - echo '<p class="mxch-field-description">';
313 - printf(
314 - /* translators: %s: link to the Chunking & Retrieval settings tab. */
315 - esc_html__('Hybrid keyword boost has moved to %s.', 'mxchat'),
316 - '<a href="' . esc_url(admin_url('admin.php?page=mxchat-prompts#chunking')) . '">' . esc_html__('Knowledge, Chunking & Retrieval', 'mxchat') . '</a>'
317 - );
318 - echo '</p>';
319 -
320 288 // Contextual Awareness
321 289 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
322 290 $admin_instance->mxchat_contextual_awareness_callback();
323 291 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
@@ -326,20 +294,12 @@
326 294 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
327 295 $admin_instance->mxchat_citation_links_toggle_callback();
328 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'));
329 297
330 - // Satisfaction Rating Prompt
331 - // The toggle callback inline-renders the 5 customization
332 - // fields inside a single sub-options wrapper (plan-29caac).
333 - // No separate customization group needed — the wrapper handles
334 - // its own server-side display state based on the toggle value.
335 - mxchat_render_field_wrapper('satisfaction_rating', __('Satisfaction Rating Prompt', 'mxchat'), function() use ($admin_instance) {
336 - $admin_instance->mxchat_satisfaction_rating_toggle_callback();
337 - }, __('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'));
338 -
339 - // Editor Assistant toggle moved to Content → Settings (plan-f7df40):
340 - // it's a content feature, so it lives on the screen that owns it.
341 - // Rendering is in admin-content-page.php; option + save path unchanged.
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'));
342 302 ?>
343 303 </div>
344 304 </div>
345 305 </div>
@@ -364,9 +324,9 @@
364 324 <?php
365 325 // Auto-Display
366 326 mxchat_render_field_wrapper('auto_display', __('Auto-Display Chatbot', 'mxchat'), function() use ($admin_instance) {
367 327 $admin_instance->mxchat_append_to_body_callback();
368 - }, __('Show chatbot automatically on all pages. Disable to use shortcode [mxchat_chatbot floating="yes"] for floating widget or [mxchat_chatbot floating="no"] for embedded chat.', 'mxchat'));
328 + }, __('Show chatbot automatically on all pages. Disable to use shortcode [mxchat_chatbot] instead.', 'mxchat'));
369 329
370 330 // Open Links in New Tab
371 331 mxchat_render_field_wrapper('link_target', __('Open Links in New Tab', 'mxchat'), function() use ($admin_instance) {
372 332 $admin_instance->mxchat_link_target_toggle_callback();
@@ -375,23 +335,8 @@
375 335 // Chat Persistence
376 336 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
377 337 $admin_instance->mxchat_chat_persistence_toggle_callback();
378 338 }, __('Keep chat history when users navigate or return within 24 hours.', 'mxchat'));
379 -
380 - // Download Transcript button
381 - mxchat_render_field_wrapper('print_button', __('Show Download Transcript Button', 'mxchat'), function() use ($admin_instance) {
382 - $admin_instance->mxchat_print_button_toggle_callback();
383 - }, __('Show the "Download Transcript" item in the chat window menu.', 'mxchat'));
384 -
385 - // Start-New-Chat button (plan ac2e81) — lets a visitor reset the
386 - // conversation without the owner disabling chat persistence globally.
387 - mxchat_render_field_wrapper('reset_chat_enabled', __('Show Start-New-Chat Button', 'mxchat'), function() use ($admin_instance) {
388 - $admin_instance->mxchat_reset_chat_toggle_callback();
389 - }, __('Show a "Start new chat" item in the chat window menu that clears the current conversation and begins a fresh session.', 'mxchat'));
390 -
391 - mxchat_render_field_wrapper('reset_chat_label', __('Start-New-Chat Button Label', 'mxchat'), function() use ($admin_instance) {
392 - $admin_instance->mxchat_reset_chat_label_callback();
393 - }, __('Label for the Start-New-Chat menu item. Leave blank to use "Start new chat".', 'mxchat'));
394 339 ?>
395 340 </div>
396 341 </div>
397 342
@@ -423,13 +368,8 @@
423 368 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
424 369 $admin_instance->mxchat_input_copy_callback();
425 370 }, __('Placeholder text in the chat input field.', 'mxchat'));
426 371
427 - // Max Input Length (characters) — plan a3fae2 part C
428 - mxchat_render_field_wrapper('max_input_length', __('Max Input Length (characters)', 'mxchat'), function() use ($admin_instance) {
429 - $admin_instance->mxchat_max_input_length_callback();
430 - }, __('Cap how many characters a visitor can type or paste into a single message. Set to 0 for unlimited (default).', 'mxchat'));
431 -
432 372 // Chat Teaser
433 373 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
434 374 $admin_instance->mxchat_pre_chat_message_callback();
435 375 }, __('Message shown before users start chatting.', 'mxchat'));
@@ -601,13 +541,12 @@
601 541 OPTIMIZATION
602 542 ======================================== -->
603 543 <div id="optimization" class="mxch-section">
604 544 <div class="mxch-content-header">
605 - <h1 class="mxch-content-title"><?php esc_html_e('Optimization & Diagnostics', 'mxchat'); ?></h1>
606 - <p class="mxch-content-subtitle"><?php esc_html_e('Optimize performance, debug issues, and manage plugin settings.', 'mxchat'); ?></p>
545 + <h1 class="mxch-content-title"><?php esc_html_e('Optimization', 'mxchat'); ?></h1>
546 + <p class="mxch-content-subtitle"><?php esc_html_e('Optimize chatbot loading for better page performance and Core Web Vitals.', 'mxchat'); ?></p>
607 547 </div>
608 548
609 - <!-- Script Loading Card -->
610 549 <div class="mxch-card">
611 550 <div class="mxch-card-header">
612 551 <h3 class="mxch-card-title">
613 552 <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="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
@@ -632,18 +571,8 @@
632 571 </div>
633 572 <p class="mxch-field-description"><?php esc_html_e('Control when the chatbot script loads to improve page performance.', 'mxchat'); ?></p>
634 573 </div>
635 574
636 - <?php
637 - // Smart asset loading (plan-915355; rebuilt on the house toggle
638 - // pattern in plan-64d34f). Standalone option — never part of
639 - // mxchat_options, so mxchat_sanitize() can't strip it.
640 - mxchat_render_field_wrapper('mxchat_smart_asset_loading', __('Only load chatbot files on pages where the chatbot appears', 'mxchat'), function() use ($admin_instance) {
641 - $admin_instance->mxchat_smart_asset_loading_toggle_callback();
642 - }, __('Skips the chatbot\'s CSS and JavaScript on pages where the widget is hidden (per-page visibility, post type include/exclude, or auto-display disabled). Pages using the chatbot shortcode still load everything automatically. Helps with "reduce unused CSS/JS" audit findings.', 'mxchat'),
643 - __('If your theme or page builder inserts the chatbot in an unusual way and it stops appearing, turn this off — or force-load assets with the mxchat_should_load_assets filter.', 'mxchat'));
644 - ?>
645 -
646 575 <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
647 576 <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>
648 577 <div>
649 578 <strong><?php esc_html_e('Loading Strategies:', 'mxchat'); ?></strong>
@@ -656,230 +585,8 @@
656 585 </div>
657 586 </div>
658 587 </div>
659 588 </div>
660 -
661 - <!-- Page Cache Compatibility Card -->
662 - <div class="mxch-card">
663 - <div class="mxch-card-header">
664 - <h3 class="mxch-card-title">
665 - <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>
666 - <?php esc_html_e('Page Cache Compatibility', 'mxchat'); ?>
667 - </h3>
668 - </div>
669 - <div class="mxch-card-body">
670 - <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>
671 -
672 - <?php
673 - $mxch_cache_rows = array(
674 - array('name' => 'WP Rocket', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax\\.php\\?action=mxchat_.*'),
675 - array('name' => 'LiteSpeed Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
676 - array('name' => 'W3 Total Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
677 - array('name' => 'FlyingPress', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
678 - array('name' => 'WP Super Cache', 'state' => 'auto', 'exclusion' => 'wp-admin/admin-ajax.php'),
679 - array('name' => 'Cloudflare APO', 'state' => 'manual', 'exclusion' => 'Page Rule / Cache Rule: URI Path contains "/wp-admin/admin-ajax.php" → Bypass Cache'),
680 - );
681 - ?>
682 -
683 - <div class="mxch-cache-compat-grid" style="display: grid; grid-template-columns: 1fr; gap: 12px; margin-top: 16px;">
684 - <?php foreach ($mxch_cache_rows as $row) :
685 - $is_auto = ($row['state'] === 'auto');
686 - $pill_class = $is_auto ? 'mxch-status-pill-active' : 'mxch-status-pill-warning';
687 - $pill_label = $is_auto ? __('Auto-handled', 'mxchat') : __('Manual', 'mxchat');
688 - ?>
689 - <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);">
690 - <div style="display: flex; align-items: center; gap: 10px; min-width: 0; flex: 0 0 auto;">
691 - <span style="font-weight: 500;"><?php echo esc_html($row['name']); ?></span>
692 - <span class="mxch-status-pill <?php echo esc_attr($pill_class); ?>">
693 - <span class="mxch-status-dot"></span>
694 - <?php echo esc_html($pill_label); ?>
695 - </span>
696 - </div>
697 - <div style="display: flex; align-items: center; gap: 8px; flex: 1 1 auto; min-width: 0;">
698 - <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>
699 - <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;">
700 - <?php esc_html_e('Copy', 'mxchat'); ?>
701 - </button>
702 - </div>
703 - </div>
704 - <?php endforeach; ?>
705 - </div>
706 -
707 - <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
708 - <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>
709 - <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>
710 - </div>
711 - </div>
712 - </div>
713 -
714 - <!-- Provider Reliability Card -->
715 - <?php
716 - $auto_retry_enabled = !isset($options['auto_retry_on_transient_error']) ||
717 - (string) $options['auto_retry_on_transient_error'] !== '0';
718 - ?>
719 - <div class="mxch-card">
720 - <div class="mxch-card-header">
721 - <h3 class="mxch-card-title">
722 - <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>
723 - <?php esc_html_e('Provider Reliability', 'mxchat'); ?>
724 - </h3>
725 - <span class="mxch-status-pill <?php echo $auto_retry_enabled ? 'mxch-status-pill-active' : 'mxch-status-pill-disabled'; ?>">
726 - <span class="mxch-status-dot"></span>
727 - <?php echo $auto_retry_enabled ? esc_html__('Active', 'mxchat') : esc_html__('Disabled', 'mxchat'); ?>
728 - </span>
729 - </div>
730 - <div class="mxch-card-body mxchat-autosave-section">
731 - <div class="mxch-field">
732 - <label class="mxch-field-label" for="auto_retry_on_transient_error">
733 - <?php esc_html_e('Auto-retry on provider overload', 'mxchat'); ?>
734 - </label>
735 - <div class="mxch-field-control">
736 - <label class="mxch-toggle">
737 - <input type="checkbox"
738 - id="auto_retry_on_transient_error"
739 - name="mxchat_options[auto_retry_on_transient_error]"
740 - class="mxchat-autosave-field"
741 - value="1"
742 - <?php checked($auto_retry_enabled); ?> />
743 - <span class="mxch-toggle-slider"></span>
744 - </label>
745 - </div>
746 - <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>
747 - <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>
748 - </div>
749 - </div>
750 - </div>
751 -
752 - <!-- Debug Mode Card -->
753 - <?php
754 - $debug_mode = isset($options['debug_mode']) ? $options['debug_mode'] : 'off';
755 - $debug_active = ($debug_mode === 'on');
756 - ?>
757 - <div class="mxch-card">
758 - <div class="mxch-card-header">
759 - <h3 class="mxch-card-title">
760 - <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="M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z"/><path d="m9 12 2 2 4-4"/></svg>
761 - <?php esc_html_e('Debug Mode', 'mxchat'); ?>
762 - </h3>
763 - </div>
764 - <div class="mxch-card-body">
765 - <?php // Deliberate exception to the house .toggle-switch pattern
766 - // (audited in plan-64d34f): this card-body is NOT an
767 - // autosave section — the toggle saves through its own
768 - // dedicated handler (mxchat_toggle_debug_mode, wired at
769 - // mxchat-admin.js #mxchat_debug_mode) which appends its own
770 - // save indicator inside this label. Converting the markup
771 - // would orphan that indicator without touching the JS. ?>
772 - <div class="mxch-field">
773 - <label class="mxch-toggle">
774 - <input type="checkbox" class="mxch-toggle-input" id="mxchat_debug_mode" name="mxchat_options[debug_mode]" value="on" <?php checked($debug_active); ?>>
775 - <span class="mxch-toggle-switch"></span>
776 - <span class="mxch-toggle-label"><?php esc_html_e('Enable Debug Logging', 'mxchat'); ?></span>
777 - </label>
778 - <p class="mxch-field-description"><?php esc_html_e('Tracks settings changes, knowledge base errors, API issues, and embedding failures. Enable only when troubleshooting. Max 100 entries stored.', 'mxchat'); ?></p>
779 - </div>
780 - </div>
781 - </div>
782 -
783 - <!-- Debug Log Viewer Card -->
784 - <div class="mxch-card">
785 - <div class="mxch-card-header" style="display: flex; justify-content: space-between; align-items: center;">
786 - <h3 class="mxch-card-title">
787 - <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="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg>
788 - <?php esc_html_e('Debug Log', 'mxchat'); ?>
789 - </h3>
790 - <div style="display: flex; gap: 8px; align-items: center;">
791 - <span id="mxchat-log-count" class="mxch-badge" style="display: none;"></span>
792 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-refresh-log">
793 - <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="M21.5 2v6h-6M2.5 22v-6h6M2 11.5a10 10 0 0 1 18.8-4.3M22 12.5a10 10 0 0 1-18.8 4.2"/></svg>
794 - <?php esc_html_e('Refresh', 'mxchat'); ?>
795 - </button>
796 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-clear-log">
797 - <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"><polyline points="3 6 5 6 21 6"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/></svg>
798 - <?php esc_html_e('Clear', 'mxchat'); ?>
799 - </button>
800 - </div>
801 - </div>
802 - <div class="mxch-card-body">
803 - <div id="mxchat-debug-log" class="mxchat-debug-log-viewer">
804 - <div class="mxchat-debug-log-empty">
805 - <svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1" stroke-linecap="round" stroke-linejoin="round" style="opacity: 0.3;"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>
806 - <p><?php esc_html_e('No log entries yet. Enable debug mode to start logging.', 'mxchat'); ?></p>
807 - </div>
808 - </div>
809 - </div>
810 - </div>
811 -
812 - <!-- Settings Tools Card -->
813 - <div class="mxch-card">
814 - <div class="mxch-card-header">
815 - <h3 class="mxch-card-title">
816 - <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="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg>
817 - <?php esc_html_e('Settings Tools', 'mxchat'); ?>
818 - </h3>
819 - </div>
820 - <div class="mxch-card-body">
821 - <div class="mxch-tools-grid">
822 - <!-- Export Settings -->
823 - <div class="mxch-tool-item">
824 - <div class="mxch-tool-icon">
825 - <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="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
826 - </div>
827 - <div class="mxch-tool-content">
828 - <h4><?php esc_html_e('Export Settings', 'mxchat'); ?></h4>
829 - <p><?php esc_html_e('Download a JSON file of your current settings for backup or support. API keys are masked for security.', 'mxchat'); ?></p>
830 - <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-export-settings">
831 - <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="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
832 - <?php esc_html_e('Export Settings', 'mxchat'); ?>
833 - </button>
834 - </div>
835 - </div>
836 -
837 - <!-- Reset All Settings -->
838 - <div class="mxch-tool-item mxch-tool-item-danger">
839 - <div class="mxch-tool-icon">
840 - <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="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"/><line x1="10" y1="11" x2="10" y2="17"/><line x1="14" y1="11" x2="14" y2="17"/></svg>
841 - </div>
842 - <div class="mxch-tool-content">
843 - <h4><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h4>
844 - <p><?php esc_html_e('Reset all MxChat settings to their default values. This action cannot be undone.', 'mxchat'); ?></p>
845 - <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-settings">
846 - <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"/></svg>
847 - <?php esc_html_e('Reset All Settings', 'mxchat'); ?>
848 - </button>
849 - </div>
850 - </div>
851 - </div>
852 - </div>
853 - </div>
854 -
855 - <!-- Reset Confirmation Modal -->
856 - <div id="mxchat-reset-modal" class="mxch-modal" style="display: none;">
857 - <div class="mxch-modal-backdrop"></div>
858 - <div class="mxch-modal-content">
859 - <div class="mxch-modal-header">
860 - <h3><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h3>
861 - <button type="button" class="mxch-modal-close" id="mxchat-reset-modal-close">&times;</button>
862 - </div>
863 - <div class="mxch-modal-body">
864 - <div class="mxch-notice mxch-notice-warning">
865 - <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"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>
866 - <div>
867 - <strong><?php esc_html_e('Warning: This action cannot be undone!', 'mxchat'); ?></strong>
868 - <p><?php esc_html_e('All your MxChat settings including API keys, customizations, and configurations will be permanently deleted.', 'mxchat'); ?></p>
869 - </div>
870 - </div>
871 - <div class="mxch-field" style="margin-top: 20px;">
872 - <label class="mxch-field-label"><?php esc_html_e('Type RESET to confirm:', 'mxchat'); ?></label>
873 - <input type="text" id="mxchat-reset-confirmation" class="mxch-input" placeholder="RESET" autocomplete="off">
874 - </div>
875 - </div>
876 - <div class="mxch-modal-footer">
877 - <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-reset-cancel"><?php esc_html_e('Cancel', 'mxchat'); ?></button>
878 - <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-confirm" disabled><?php esc_html_e('Reset All Settings', 'mxchat'); ?></button>
879 - </div>
880 - </div>
881 - </div>
882 589 </div>
883 590
884 591 <!-- ========================================
885 592 INTEGRATIONS - TOOLBAR
@@ -948,9 +655,9 @@
948 655 <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>
949 656 <div>
950 657 <?php printf(
951 658 esc_html__('Visit our %s for setup instructions.', 'mxchat'),
952 - '<a href="https://mxchat.ai/documentation/mxchat-core#slack-live-agent-handoff" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
659 + '<a href="https://mxchat.ai/documentation/#slack_integration" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
953 660 ); ?>
954 661 </div>
955 662 </div>
956 663
@@ -1095,40 +802,8 @@
1095 802 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1096 803 <p class="mxch-content-subtitle"><?php esc_html_e('Learn how to get the most out of MxChat with our video guides.', 'mxchat'); ?></p>
1097 804 </div>
1098 805
1099 - <?php
1100 - // Setup Guide — reopen the onboarding wizard (plan-347916, moved here from Display tab).
1101 - // Only shows once the user has dismissed/graduated from the Onboarding page.
1102 - if (function_exists('mxchat_onboarding_is_dismissed') && mxchat_onboarding_is_dismissed()):
1103 - $auto_grad = function_exists('mxchat_onboarding_is_auto_graduated') && mxchat_onboarding_is_auto_graduated();
1104 - ?>
1105 - <div class="mxch-card mxch-onboarding-unhide-card" style="margin-bottom: 24px;">
1106 - <div class="mxch-card-header">
1107 - <h3 class="mxch-card-title">
1108 - <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>
1109 - <?php esc_html_e('Setup Guide', 'mxchat'); ?>
1110 - </h3>
1111 - </div>
1112 - <div class="mxch-card-body">
1113 - <p style="margin:0 0 12px;color:var(--mxch-text-secondary);font-size:13px;line-height:1.5;">
1114 - <?php if ($auto_grad): ?>
1115 - <?php esc_html_e('You finished the setup guide. Reopen it any time to revisit the steps or change a setup choice.', 'mxchat'); ?>
1116 - <?php else: ?>
1117 - <?php esc_html_e('You hid the setup guide from the MxChat menu. Reopen it any time to revisit the steps.', 'mxchat'); ?>
1118 - <?php endif; ?>
1119 - </p>
1120 - <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>" style="margin:0;">
1121 - <?php wp_nonce_field('mxchat_unhide_onboarding'); ?>
1122 - <input type="hidden" name="action" value="mxchat_unhide_onboarding" />
1123 - <button type="submit" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1124 - <?php esc_html_e('Reopen setup guide', 'mxchat'); ?>
1125 - </button>
1126 - </form>
1127 - </div>
1128 - </div>
1129 - <?php endif; ?>
1130 -
1131 806 <div class="mxch-card" style="margin-bottom: 24px;">
1132 807 <div class="mxch-card-body">
1133 808 <div style="display: flex; align-items: flex-start; gap: 16px;">
1134 809 <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>
@@ -1147,23 +822,8 @@
1147 822 <div class="mxch-tutorials-grid">
1148 823 <?php
1149 824 $tutorials = array(
1150 825 array(
1151 - 'title' => __('Quick Setup with MxChat', 'mxchat'),
1152 - 'description' => __('Learn how to quickly setup and understand how your chatbot works.', 'mxchat'),
1153 - 'url' => 'https://www.youtube.com/watch?v=3BqoiyWaQiM&t'
1154 - ),
1155 - array(
1156 - 'title' => __('AI Content Generation', 'mxchat'),
1157 - 'description' => __('Generate full blog posts and landing pages with AI—from prompt to publish in minutes.', 'mxchat'),
1158 - 'url' => 'https://www.youtube.com/watch?v=n8TeEeHpxs4'
1159 - ),
1160 - array(
1161 - 'title' => __('Chat With Your GSC Data', 'mxchat'),
1162 - 'description' => __('Find content gaps, quick win keywords, and SEO opportunities by chatting with your Google Search Console data using the Admin Assistant add-on.', 'mxchat'),
1163 - 'url' => 'https://www.youtube.com/watch?v=ytgMou_7SZA&t=2s'
1164 - ),
1165 - array(
1166 826 'title' => __('AI Theme Generator', 'mxchat'),
1167 827 'description' => __('Learn how to instantly restyle your chatbot using plain English prompts with real-time previews.', 'mxchat'),
1168 828 'url' => 'https://www.youtube.com/watch?v=rSQDW2qbtRU&t'
1169 829 ),
@@ -1177,9 +837,14 @@
1177 837 'description' => __('Bring a ChatGPT-like experience directly inside your WordPress dashboard.', 'mxchat'),
1178 838 'url' => 'https://youtu.be/AdEA1k-UCFM'
1179 839 ),
1180 840 array(
1181 - 'title' => __('Chat Themes', 'mxchat'),
841 + 'title' => __('Intent Tester Guide', 'mxchat'),
842 + 'description' => __('Fine-tune your chatbot\'s responses and ensure accurate query understanding.', 'mxchat'),
843 + 'url' => 'https://www.youtube.com/watch?v=uTr14tn59Hc'
844 + ),
845 + array(
846 + 'title' => __('Theme Customizer', 'mxchat'),
1182 847 'description' => __('Customize appearance with real-time previews to match your brand.', 'mxchat'),
1183 848 'url' => 'https://youtu.be/MfbB9mZi6ag'
1184 849 ),
1185 850 array(
@@ -1233,115 +898,8 @@
1233 898 <?php endforeach; ?>
1234 899 </div>
1235 900 </div>
1236 901
1237 - <!-- =====================================================
1238 - TESTING SECTION
1239 - ===================================================== -->
1240 - <div id="testing" class="mxch-section">
1241 - <div class="mxch-content-header">
1242 - <h1 class="mxch-content-title"><?php esc_html_e('Testing', 'mxchat'); ?></h1>
1243 - <p class="mxch-content-subtitle"><?php esc_html_e('Test your chatbot and inspect debug data in real time.', 'mxchat'); ?></p>
1244 - </div>
1245 -
1246 - <div class="mxch-testing-layout">
1247 - <!-- Left Column: Debug Panel -->
1248 - <div class="mxch-testing-debug-panel">
1249 - <!-- Quick Actions -->
1250 - <div class="mxch-card">
1251 - <div class="mxch-card-body">
1252 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Quick Actions', 'mxchat'); ?></h3>
1253 - <div class="mxch-testing-actions-row">
1254 - <button type="button" class="mxch-testing-btn mxch-testing-btn-danger" id="mxch-testing-clear-session">
1255 - <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>
1256 - <?php esc_html_e('Clear Chat Session', 'mxchat'); ?>
1257 - </button>
1258 - <button type="button" class="mxch-testing-btn mxch-testing-btn-secondary" id="mxch-testing-clear-debug">
1259 - <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>
1260 - <?php esc_html_e('Clear Debug Log', 'mxchat'); ?>
1261 - </button>
1262 - </div>
1263 - </div>
1264 - </div>
1265 -
1266 - <!-- Last Query Analysis -->
1267 - <div class="mxch-card">
1268 - <div class="mxch-card-body">
1269 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Last Query Analysis', 'mxchat'); ?></h3>
1270 -
1271 - <div class="mxch-testing-field">
1272 - <label><?php esc_html_e('Similarity Threshold', 'mxchat'); ?></label>
1273 - <span id="mxch-testing-threshold"><?php esc_html_e('Loading...', 'mxchat'); ?></span>
1274 - </div>
1275 -
1276 - <div class="mxch-testing-field">
1277 - <label><?php esc_html_e('User Query', 'mxchat'); ?></label>
1278 - <div id="mxch-testing-last-query" class="mxch-testing-query-display"><?php esc_html_e('Waiting for next query...', 'mxchat'); ?></div>
1279 - </div>
1280 -
1281 - <div class="mxch-testing-field">
1282 - <label><?php esc_html_e('Approved URLs for Citations', 'mxchat'); ?></label>
1283 - <div id="mxch-testing-approved-urls" class="mxch-testing-results">
1284 - <div class="mxch-testing-no-data"><?php esc_html_e('No URL data yet', 'mxchat'); ?></div>
1285 - </div>
1286 - </div>
1287 -
1288 - <div class="mxch-testing-field">
1289 - <label><?php esc_html_e('Document Matches', 'mxchat'); ?></label>
1290 - <div id="mxch-testing-similarity-scores" class="mxch-testing-results">
1291 - <div class="mxch-testing-no-data"><?php esc_html_e('No query data yet', 'mxchat'); ?></div>
1292 - </div>
1293 - </div>
1294 -
1295 - <div class="mxch-testing-field">
1296 - <label><?php esc_html_e('Actions Triggered', 'mxchat'); ?></label>
1297 - <div id="mxch-testing-action-scores" class="mxch-testing-results">
1298 - <div class="mxch-testing-no-data"><?php esc_html_e('No action data yet', 'mxchat'); ?></div>
1299 - </div>
1300 - </div>
1301 - </div>
1302 - </div>
1303 -
1304 - <!-- System Information -->
1305 - <div class="mxch-card">
1306 - <div class="mxch-card-body">
1307 - <h3 class="mxch-testing-section-title"><?php esc_html_e('System Information', 'mxchat'); ?></h3>
1308 -
1309 - <div class="mxch-testing-field">
1310 - <label><?php esc_html_e('System Prompt', 'mxchat'); ?></label>
1311 - <div id="mxch-testing-system-prompt" class="mxch-testing-system-prompt"><?php esc_html_e('Loading...', 'mxchat'); ?></div>
1312 - </div>
1313 -
1314 - <div class="mxch-testing-field">
1315 - <label><?php esc_html_e('Knowledge Base', 'mxchat'); ?></label>
1316 - <span id="mxch-testing-kb-status"><?php esc_html_e('Checking...', 'mxchat'); ?></span>
1317 - </div>
1318 - </div>
1319 - </div>
1320 -
1321 - <!-- Debug Log -->
1322 - <div class="mxch-card">
1323 - <div class="mxch-card-body">
1324 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Debug Log', 'mxchat'); ?></h3>
1325 - <div id="mxch-testing-debug-console" class="mxch-testing-debug-console">
1326 - <div class="mxch-testing-debug-entry"><?php esc_html_e('Debug panel ready - send a message to begin...', 'mxchat'); ?></div>
1327 - </div>
1328 - </div>
1329 - </div>
1330 - </div>
1331 -
1332 - <!-- Right Column: Chatbot Replica -->
1333 - <div class="mxch-testing-chatbot-column">
1334 - <div class="mxch-testing-chatbot-scope">
1335 - <?php
1336 - // Render the chatbot inline for testing
1337 - echo do_shortcode('[mxchat_chatbot floating="no" bot_id="testing"]');
1338 - ?>
1339 - </div>
1340 - </div>
1341 - </div>
1342 - </div>
1343 -
1344 902 </main>
1345 903 </div>
1346 904
1347 905 <script>
@@ -1444,45 +1002,22 @@
1444 1002 }
1445 1003 });
1446 1004 });
1447 1005
1448 - // Handle initial deep-link (?tab=<slug> takes precedence over #hash so the
1449 - // Onboarding setup-step CTAs land on the right sub-tab). Whitelist of valid
1450 - // section ids must stay in sync with the .mxch-section[id] values above.
1451 - const validTabs = [
1452 - 'chatbot-ai-models', 'chatbot-behavior', 'chatbot-display',
1453 - 'chatbot-lead-capture', 'chatbot-quick-questions', 'chatbot-rate-limits',
1454 - 'api-keys', 'optimization', 'testing',
1455 - 'integrations-toolbar', 'integrations-loops', 'integrations-brave',
1456 - 'integrations-slack', 'integrations-telegram',
1457 - 'tutorials'
1458 - ];
1459 - function activateTab(target) {
1460 - if (!target) return false;
1461 - if (validTabs.indexOf(target) === -1) return false;
1462 - const targetLink = document.querySelector('[data-target="' + target + '"]');
1463 - if (!targetLink) return false;
1464 - const parentItem = targetLink.closest('.mxch-nav-item');
1465 - if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1466 - parentItem.classList.add('expanded');
1006 + // Handle initial hash
1007 + const hash = window.location.hash.slice(1);
1008 + if (hash) {
1009 + const targetLink = document.querySelector('[data-target="' + hash + '"]');
1010 + if (targetLink) {
1011 + // Expand parent if it's a sub-link
1012 + const parentItem = targetLink.closest('.mxch-nav-item');
1013 + if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1014 + parentItem.classList.add('expanded');
1015 + }
1016 + showSection(hash);
1017 + setActiveNav(targetLink);
1467 1018 }
1468 - showSection(target);
1469 - setActiveNav(targetLink);
1470 - return true;
1471 1019 }
1472 - const urlParams = new URLSearchParams(window.location.search);
1473 - const tabParam = urlParams.get('tab');
1474 - let tabActivated = false;
1475 - if (tabParam) {
1476 - tabActivated = activateTab(tabParam);
1477 - // Invalid ?tab=… silently falls through to default (#hash or AI Models).
1478 - }
1479 - if (!tabActivated) {
1480 - const hash = window.location.hash.slice(1);
1481 - if (hash) {
1482 - activateTab(hash);
1483 - }
1484 - }
1485 1020
1486 1021 // Rate limit accordion
1487 1022 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1488 1023 rateLimitHeaders.forEach(header => {
@@ -1493,26 +1028,8 @@
1493 1028 item.classList.toggle('expanded');
1494 1029 });
1495 1030 });
1496 1031
1497 - // Rate-limit "Custom…" toggle: show/hide the integer input below each
1498 - // limit <select> based on whether __custom__ is the active option.
1499 - document.querySelectorAll('.mxch-rate-limit-limit-select').forEach(sel => {
1500 - const targetId = sel.getAttribute('data-mxch-custom-target');
1501 - if (!targetId) return;
1502 - const field = document.querySelector('[data-mxch-custom-for="' + targetId + '"]');
1503 - if (!field) return;
1504 - const sync = () => {
1505 - if (sel.value === '__custom__') {
1506 - field.hidden = false;
1507 - } else {
1508 - field.hidden = true;
1509 - }
1510 - };
1511 - sel.addEventListener('change', sync);
1512 - sync();
1513 - });
1514 -
1515 1032 // =====================================================
1516 1033 // Mobile Menu Functionality
1517 1034 // =====================================================
1518 1035 const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
@@ -1611,14 +1128,10 @@
1611 1128 }
1612 1129
1613 1130 /**
1614 1131 * Helper function to render a field with consistent wrapper
1615 - *
1616 - * $hint renders as a .mxch-field-hint line under the description — the
1617 - * softer "caveats / fine print" slot (added for plan-64d34f so hint-bearing
1618 - * fields don't have to hand-roll the wrapper markup).
1619 1132 */
1620 -function mxchat_render_field_wrapper($id, $label, $callback, $description = '', $hint = '') {
1133 +function mxchat_render_field_wrapper($id, $label, $callback, $description = '') {
1621 1134 ?>
1622 1135 <div class="mxch-field">
1623 1136 <label class="mxch-field-label"><?php echo esc_html($label); ?></label>
1624 1137 <div class="mxch-field-control">
@@ -1626,11 +1139,8 @@
1626 1139 </div>
1627 1140 <?php if ($description): ?>
1628 1141 <p class="mxch-field-description"><?php echo esc_html($description); ?></p>
1629 1142 <?php endif; ?>
1630 - <?php if ($hint): ?>
1631 - <p class="mxch-field-hint"><?php echo esc_html($hint); ?></p>
1632 - <?php endif; ?>
1633 1143 </div>
1634 1144 <?php
1635 1145 }
1636 1146
@@ -1649,146 +1159,10 @@
1649 1159
1650 1160 $roles = wp_roles()->get_names();
1651 1161 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1652 1162
1653 - // Whole-chatbot global cap (sits above per-role; defaults to unlimited so
1654 - // existing installs are unchanged). Stored under mxchat_options['rate_limits_global'].
1655 - $global_cfg = isset($all_options['rate_limits_global']) && is_array($all_options['rate_limits_global'])
1656 - ? $all_options['rate_limits_global']
1657 - : array();
1658 - $global_limit_raw = isset($global_cfg['limit']) ? (string) $global_cfg['limit'] : 'unlimited';
1659 - $global_timeframe = isset($global_cfg['timeframe']) ? (string) $global_cfg['timeframe'] : 'daily';
1660 - $global_is_unlimited = ($global_limit_raw === '' || $global_limit_raw === 'unlimited');
1661 - $global_is_preset = !$global_is_unlimited && in_array($global_limit_raw, $rate_limits, true);
1662 - $global_select_value = $global_is_unlimited ? 'unlimited' : ($global_is_preset ? $global_limit_raw : '__custom__');
1663 - $global_custom_value = (!$global_is_unlimited && !$global_is_preset && ctype_digit($global_limit_raw))
1664 - ? $global_limit_raw
1665 - : '';
1666 -
1667 1163 echo '<div class="mxch-rate-limits">';
1668 1164
1669 - // --- Global cap card -------------------------------------------------
1670 - ?>
1671 - <div class="mxch-rate-limit-item mxch-rate-limit-global mxchat-autosave-section">
1672 - <div class="mxch-rate-limit-header">
1673 - <span class="mxch-rate-limit-role"><?php esc_html_e('Total chatbot message limit', 'mxchat'); ?></span>
1674 - <div class="mxch-rate-limit-summary">
1675 - <span class="mxch-rate-limit-badge mxch-rate-limit-global-badge">
1676 - <?php
1677 - if ($global_is_unlimited) {
1678 - esc_html_e('Unlimited', 'mxchat');
1679 - } else {
1680 - $tf_label = isset($timeframes[$global_timeframe]) ? $timeframes[$global_timeframe] : $global_timeframe;
1681 - echo esc_html(($global_custom_value !== '' ? $global_custom_value : $global_limit_raw) . ' / ' . $tf_label);
1682 - }
1683 - ?>
1684 - </span>
1685 - <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>
1686 - </div>
1687 - </div>
1688 - <div class="mxch-rate-limit-body">
1689 - <p class="mxch-field-description" style="margin: 0 0 12px;">
1690 - <?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'); ?>
1691 - </p>
1692 - <div class="mxch-rate-limit-controls">
1693 - <div class="mxch-field">
1694 - <label class="mxch-field-label" for="rate_limits_global_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1695 - <select id="rate_limits_global_limit"
1696 - name="mxchat_options[rate_limits_global][limit]"
1697 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1698 - data-mxch-custom-target="rate_limits_global_limit_custom">
1699 - <?php foreach ($rate_limits as $limit): ?>
1700 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($global_select_value, $limit); ?>>
1701 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1702 - </option>
1703 - <?php endforeach; ?>
1704 - <option value="__custom__" <?php selected($global_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1705 - </select>
1706 - </div>
1707 - <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'; ?>>
1708 - <label class="mxch-field-label" for="rate_limits_global_limit_custom"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1709 - <input type="number"
1710 - min="1"
1711 - step="1"
1712 - id="rate_limits_global_limit_custom"
1713 - name="mxchat_options[rate_limits_global][limit_custom]"
1714 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1715 - placeholder="e.g. 250"
1716 - value="<?php echo esc_attr($global_custom_value); ?>" />
1717 - </div>
1718 - <div class="mxch-field">
1719 - <label class="mxch-field-label" for="rate_limits_global_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1720 - <select id="rate_limits_global_timeframe"
1721 - name="mxchat_options[rate_limits_global][timeframe]"
1722 - class="mxch-select mxchat-autosave-field">
1723 - <?php foreach ($timeframes as $value => $label): ?>
1724 - <option value="<?php echo esc_attr($value); ?>" <?php selected($global_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1725 - <?php endforeach; ?>
1726 - </select>
1727 - </div>
1728 - </div>
1729 - <?php
1730 - // --- Current usage readout (read-only; mirrors the integrator's
1731 - // window-reset math at READ time — never writes the counter here).
1732 - // v1 surfaces the DEFAULT bot's pool. TODO: per-bot selector if asked.
1733 - $global_usage_limit_int = (!$global_is_unlimited && ctype_digit($global_limit_raw))
1734 - ? (int) $global_limit_raw
1735 - : 0;
1736 - $usage_raw = get_option('mxchat_chat_limit_default_global', array('count' => 0, 'timestamp' => time()));
1737 - $usage_count = isset($usage_raw['count']) ? (int) $usage_raw['count'] : 0;
1738 - $usage_ts = isset($usage_raw['timestamp']) ? (int) $usage_raw['timestamp'] : time();
1739 - $usage_windows = array('hourly' => 3600, 'daily' => 86400, 'weekly' => 604800, 'monthly' => 2592000);
1740 - $usage_window = isset($usage_windows[$global_timeframe]) ? $usage_windows[$global_timeframe] : 86400;
1741 - $usage_now = time();
1742 - if (($usage_now - $usage_ts) >= $usage_window) {
1743 - // Window elapsed since the stored timestamp → effective count is 0.
1744 - $usage_count = 0;
1745 - $usage_reset_at = $usage_now + $usage_window;
1746 - } else {
1747 - $usage_reset_at = $usage_ts + $usage_window;
1748 - }
1749 - $usage_left = max(0, $global_usage_limit_int - $usage_count);
1750 - $usage_pct = ($global_usage_limit_int > 0)
1751 - ? min(100, (int) round(($usage_count / $global_usage_limit_int) * 100))
1752 - : 0;
1753 - $usage_reset_nonce = wp_create_nonce('mxchat_reset_global_usage');
1754 - ?>
1755 - <div class="mxch-rate-limit-usage"
1756 - id="mxch-global-usage"
1757 - data-bot-id="default"
1758 - data-reset-nonce="<?php echo esc_attr($usage_reset_nonce); ?>"
1759 - <?php echo $global_is_unlimited ? 'hidden' : ''; ?>>
1760 - <div class="mxch-rate-limit-usage-head">
1761 - <span class="mxch-field-label" style="margin:0;"><?php esc_html_e('Current usage', 'mxchat'); ?></span>
1762 - <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>
1763 - </div>
1764 - <div class="mxch-progress-bar">
1765 - <div class="mxch-progress-bar-fill" id="mxch-global-usage-fill" style="width: <?php echo esc_attr($usage_pct); ?>%;"></div>
1766 - </div>
1767 - <p class="mxch-progress-label" id="mxch-global-usage-text" style="margin:0;">
1768 - <?php
1769 - printf(
1770 - /* translators: 1: used count, 2: limit, 3: remaining, 4: human-readable time until reset */
1771 - esc_html__('%1$s of %2$s used · %3$s left · resets in %4$s', 'mxchat'),
1772 - esc_html(number_format_i18n($usage_count)),
1773 - esc_html(number_format_i18n($global_usage_limit_int)),
1774 - esc_html(number_format_i18n($usage_left)),
1775 - esc_html(human_time_diff($usage_now, $usage_reset_at))
1776 - );
1777 - ?>
1778 - </p>
1779 - </div>
1780 - <p class="mxch-field-description mxch-rate-limit-usage-unlimited"
1781 - id="mxch-global-usage-unlimited"
1782 - style="margin: 12px 0 0;"
1783 - <?php echo $global_is_unlimited ? '' : 'hidden'; ?>>
1784 - <?php esc_html_e('Unlimited — no cap. Usage tracking applies only when a numeric limit is set.', 'mxchat'); ?>
1785 - </p>
1786 - </div>
1787 - </div>
1788 - <?php
1789 - // ---------------------------------------------------------------------
1790 -
1791 1165 foreach ($roles as $role_id => $role_name) {
1792 1166 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1793 1167 $default_timeframe = 'daily';
1794 1168 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
@@ -1793,9 +1167,9 @@
1793 1167 $default_timeframe = 'daily';
1794 1168 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1795 1169
1796 1170 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1797 - ? (string) $all_options['rate_limits'][$role_id]['limit']
1171 + ? $all_options['rate_limits'][$role_id]['limit']
1798 1172 : $default_limit;
1799 1173
1800 1174 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1801 1175 ? $all_options['rate_limits'][$role_id]['timeframe']
@@ -1805,16 +1179,8 @@
1805 1179 ? $all_options['rate_limits'][$role_id]['message']
1806 1180 : $default_message;
1807 1181
1808 1182 $timeframe_label = isset($timeframes[$selected_timeframe]) ? $timeframes[$selected_timeframe] : $selected_timeframe;
1809 -
1810 - // Custom-value handling: if the stored limit is not in the preset list
1811 - // and not 'unlimited', it's a custom integer. The select shows __custom__
1812 - // and the number input below carries the actual value.
1813 - $is_preset_limit = in_array($selected_limit, $rate_limits, true);
1814 - $role_select_value = $is_preset_limit ? $selected_limit : '__custom__';
1815 - $role_custom_value = (!$is_preset_limit && ctype_digit($selected_limit)) ? $selected_limit : '';
1816 - $custom_field_id = 'rate_limits_' . $role_id . '_limit_custom';
1817 1183 ?>
1818 1184 <div class="mxch-rate-limit-item">
1819 1185 <div class="mxch-rate-limit-header">
1820 1186 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
@@ -1828,28 +1194,13 @@
1828 1194 <div class="mxch-field">
1829 1195 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1830 1196 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1831 1197 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit]"
1832 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1833 - data-mxch-custom-target="<?php echo esc_attr($custom_field_id); ?>">
1198 + class="mxch-select mxchat-autosave-field">
1834 1199 <?php foreach ($rate_limits as $limit): ?>
1835 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($role_select_value, $limit); ?>>
1836 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1837 - </option>
1200 + <option value="<?php echo esc_attr($limit); ?>" <?php selected($selected_limit, $limit); ?>><?php echo esc_html($limit); ?></option>
1838 1201 <?php endforeach; ?>
1839 - <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1840 1202 </select>
1841 - </div>
1842 - <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'; ?>>
1843 - <label class="mxch-field-label" for="<?php echo esc_attr($custom_field_id); ?>"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1844 - <input type="number"
1845 - min="1"
1846 - step="1"
1847 - id="<?php echo esc_attr($custom_field_id); ?>"
1848 - name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit_custom]"
1849 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1850 - placeholder="e.g. 250"
1851 - value="<?php echo esc_attr($role_custom_value); ?>" />
1852 1203 </div>
1853 1204 <div class="mxch-field">
1854 1205 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1855 1206 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"