PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.2.0
MxChat – AI Chatbot & Content Generation for WordPress v3.2.0
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 +22 -414 3.2.173.2.0 View file →
@@ -223,12 +223,12 @@
223 223 <main class="mxch-content">
224 224 <?php if (!$is_activated): ?>
225 225 <div class="mxch-pro-banner">
226 226 <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>
227 + <h3 class="mxch-pro-banner-title"><?php esc_html_e('MxChat Pro — Lifetime Access', 'mxchat'); ?></h3>
228 + <p class="mxch-pro-banner-text"><?php esc_html_e('One-time purchase. Unlock 14+ premium add-ons: Chat with GSC, WooCommerce, Chatbot Themes, Forms Builder, and more.', 'mxchat'); ?></p>
229 229 </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>
230 + <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Learn More', 'mxchat'); ?></span></a>
231 231 </div>
232 232 <?php endif; ?>
233 233
234 234 <?php
@@ -262,12 +262,12 @@
262 262 mxchat_render_field_wrapper('enable_streaming', __('Enable Streaming', 'mxchat'), function() use ($admin_instance) {
263 263 $admin_instance->enable_streaming_toggle_callback();
264 264 }, __('Enable real-time streaming responses for supported models (OpenAI, Claude, DeepSeek, Grok).', 'mxchat'));
265 265
266 - // Enable Web Search (OpenAI & Gemini)
266 + // Enable Web Search (OpenAI only)
267 267 mxchat_render_field_wrapper('enable_web_search', __('Enable Web Search', 'mxchat'), function() use ($admin_instance) {
268 268 $admin_instance->enable_web_search_toggle_callback();
269 - }, __('Allow the chatbot to search the web for current information (OpenAI and Gemini models).', 'mxchat'));
269 + }, __('Allow the chatbot to search the web for current information (OpenAI models only).', 'mxchat'));
270 270 ?>
271 271 </div>
272 272 </div>
273 273 </div>
@@ -303,21 +303,8 @@
303 303 mxchat_render_field_wrapper('rag_chunks_limit', __('RAG Chunks Limit', 'mxchat'), function() use ($admin_instance) {
304 304 $admin_instance->mxchat_rag_chunks_limit_callback();
305 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 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 307 // Contextual Awareness
321 308 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
322 309 $admin_instance->mxchat_contextual_awareness_callback();
323 310 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
@@ -326,20 +313,8 @@
326 313 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
327 314 $admin_instance->mxchat_citation_links_toggle_callback();
328 315 }, __('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 316
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.
342 317 ?>
343 318 </div>
344 319 </div>
345 320 </div>
@@ -375,23 +350,8 @@
375 350 // Chat Persistence
376 351 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
377 352 $admin_instance->mxchat_chat_persistence_toggle_callback();
378 353 }, __('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 354 ?>
395 355 </div>
396 356 </div>
397 357
@@ -423,13 +383,8 @@
423 383 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
424 384 $admin_instance->mxchat_input_copy_callback();
425 385 }, __('Placeholder text in the chat input field.', 'mxchat'));
426 386
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 387 // Chat Teaser
433 388 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
434 389 $admin_instance->mxchat_pre_chat_message_callback();
435 390 }, __('Message shown before users start chatting.', 'mxchat'));
@@ -632,18 +587,8 @@
632 587 </div>
633 588 <p class="mxch-field-description"><?php esc_html_e('Control when the chatbot script loads to improve page performance.', 'mxchat'); ?></p>
634 589 </div>
635 590
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 591 <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
647 592 <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 593 <div>
649 594 <strong><?php esc_html_e('Loading Strategies:', 'mxchat'); ?></strong>
@@ -657,99 +602,8 @@
657 602 </div>
658 603 </div>
659 604 </div>
660 605
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 606 <!-- Debug Mode Card -->
753 607 <?php
754 608 $debug_mode = isset($options['debug_mode']) ? $options['debug_mode'] : 'off';
755 609 $debug_active = ($debug_mode === 'on');
@@ -761,15 +615,8 @@
761 615 <?php esc_html_e('Debug Mode', 'mxchat'); ?>
762 616 </h3>
763 617 </div>
764 618 <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 619 <div class="mxch-field">
773 620 <label class="mxch-toggle">
774 621 <input type="checkbox" class="mxch-toggle-input" id="mxchat_debug_mode" name="mxchat_options[debug_mode]" value="on" <?php checked($debug_active); ?>>
775 622 <span class="mxch-toggle-switch"></span>
@@ -948,9 +795,9 @@
948 795 <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 796 <div>
950 797 <?php printf(
951 798 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>'
799 + '<a href="https://mxchat.ai/documentation/#slack_integration" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
953 800 ); ?>
954 801 </div>
955 802 </div>
956 803
@@ -1095,40 +942,8 @@
1095 942 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1096 943 <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 944 </div>
1098 945
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 946 <div class="mxch-card" style="margin-bottom: 24px;">
1132 947 <div class="mxch-card-body">
1133 948 <div style="display: flex; align-items: flex-start; gap: 16px;">
1134 949 <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>
@@ -1444,45 +1259,22 @@
1444 1259 }
1445 1260 });
1446 1261 });
1447 1262
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');
1263 + // Handle initial hash
1264 + const hash = window.location.hash.slice(1);
1265 + if (hash) {
1266 + const targetLink = document.querySelector('[data-target="' + hash + '"]');
1267 + if (targetLink) {
1268 + // Expand parent if it's a sub-link
1269 + const parentItem = targetLink.closest('.mxch-nav-item');
1270 + if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1271 + parentItem.classList.add('expanded');
1272 + }
1273 + showSection(hash);
1274 + setActiveNav(targetLink);
1467 1275 }
1468 - showSection(target);
1469 - setActiveNav(targetLink);
1470 - return true;
1471 1276 }
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 1277
1486 1278 // Rate limit accordion
1487 1279 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1488 1280 rateLimitHeaders.forEach(header => {
@@ -1493,26 +1285,8 @@
1493 1285 item.classList.toggle('expanded');
1494 1286 });
1495 1287 });
1496 1288
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 1289 // =====================================================
1516 1290 // Mobile Menu Functionality
1517 1291 // =====================================================
1518 1292 const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
@@ -1611,14 +1385,10 @@
1611 1385 }
1612 1386
1613 1387 /**
1614 1388 * 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 1389 */
1620 -function mxchat_render_field_wrapper($id, $label, $callback, $description = '', $hint = '') {
1390 +function mxchat_render_field_wrapper($id, $label, $callback, $description = '') {
1621 1391 ?>
1622 1392 <div class="mxch-field">
1623 1393 <label class="mxch-field-label"><?php echo esc_html($label); ?></label>
1624 1394 <div class="mxch-field-control">
@@ -1626,11 +1396,8 @@
1626 1396 </div>
1627 1397 <?php if ($description): ?>
1628 1398 <p class="mxch-field-description"><?php echo esc_html($description); ?></p>
1629 1399 <?php endif; ?>
1630 - <?php if ($hint): ?>
1631 - <p class="mxch-field-hint"><?php echo esc_html($hint); ?></p>
1632 - <?php endif; ?>
1633 1400 </div>
1634 1401 <?php
1635 1402 }
1636 1403
@@ -1649,146 +1416,10 @@
1649 1416
1650 1417 $roles = wp_roles()->get_names();
1651 1418 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1652 1419
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 1420 echo '<div class="mxch-rate-limits">';
1668 1421
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 1422 foreach ($roles as $role_id => $role_name) {
1792 1423 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1793 1424 $default_timeframe = 'daily';
1794 1425 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
@@ -1793,9 +1424,9 @@
1793 1424 $default_timeframe = 'daily';
1794 1425 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1795 1426
1796 1427 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1797 - ? (string) $all_options['rate_limits'][$role_id]['limit']
1428 + ? $all_options['rate_limits'][$role_id]['limit']
1798 1429 : $default_limit;
1799 1430
1800 1431 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1801 1432 ? $all_options['rate_limits'][$role_id]['timeframe']
@@ -1805,16 +1436,8 @@
1805 1436 ? $all_options['rate_limits'][$role_id]['message']
1806 1437 : $default_message;
1807 1438
1808 1439 $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 1440 ?>
1818 1441 <div class="mxch-rate-limit-item">
1819 1442 <div class="mxch-rate-limit-header">
1820 1443 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
@@ -1828,28 +1451,13 @@
1828 1451 <div class="mxch-field">
1829 1452 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1830 1453 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1831 1454 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); ?>">
1455 + class="mxch-select mxchat-autosave-field">
1834 1456 <?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>
1457 + <option value="<?php echo esc_attr($limit); ?>" <?php selected($selected_limit, $limit); ?>><?php echo esc_html($limit); ?></option>
1838 1458 <?php endforeach; ?>
1839 - <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1840 1459 </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 1460 </div>
1853 1461 <div class="mxch-field">
1854 1462 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1855 1463 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"