PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.0.3
MxChat – AI Chatbot & Content Generation for WordPress v3.0.3
3.2.21 3.2.20 3.2.19 3.2.18 3.2.17 3.2.16 3.2.15 3.2.14 3.2.12 3.2.13 3.2.11 3.2.10 3.2.9 3.2.8 3.2.7 3.2.6 3.2.5 3.2.4 3.2.3 3.2.2 3.2.1 2.0.3 2.0.4 2.0.5 2.0.6 All 152 releases
← All changes | includes/admin-settings-page.php +217 -803 3.2.20 → 3.0.3 View file →
@@ -63,16 +63,8 @@
63 63 <button class="mxch-mobile-nav-link" data-target="api-keys">
64 64 <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="m21 2-2 2m-7.61 7.61a5.5 5.5 0 1 1-7.778 7.778 5.5 5.5 0 0 1 7.777-7.777zm0 0L15.5 7.5m0 0 3 3L22 7l-3-3m-3.5 3.5L19 4"/></svg>
65 65 <span><?php esc_html_e('API Keys', 'mxchat'); ?></span>
66 66 </button>
67 - <button class="mxch-mobile-nav-link" data-target="optimization">
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 - <span><?php esc_html_e('Optimization', 'mxchat'); ?></span>
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 67 </div>
76 68 <!-- Integrations Section -->
77 69 <div class="mxch-mobile-nav-section">
78 70 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Integrations', 'mxchat'); ?></div>
@@ -86,9 +78,8 @@
86 78 <button class="mxch-mobile-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button>
87 79 <button class="mxch-mobile-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button>
88 80 <button class="mxch-mobile-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button>
89 81 <button class="mxch-mobile-nav-sub-link" data-target="integrations-telegram"><?php esc_html_e('Telegram', 'mxchat'); ?></button>
90 - <button class="mxch-mobile-nav-sub-link" data-target="integrations-webhook"><?php esc_html_e('Webhook', 'mxchat'); ?></button>
91 82 </div>
92 83 </div>
93 84 <!-- Resources Section -->
94 85 <div class="mxch-mobile-nav-section">
@@ -151,26 +142,8 @@
151 142 </span>
152 143 <span class="mxch-nav-link-text"><?php esc_html_e('API Keys', 'mxchat'); ?></span>
153 144 </button>
154 145 </div>
155 -
156 - <div class="mxch-nav-item" data-section="optimization">
157 - <button class="mxch-nav-link" data-target="optimization">
158 - <span class="mxch-nav-link-icon">
159 - <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="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>
160 - </span>
161 - <span class="mxch-nav-link-text"><?php esc_html_e('Optimization', 'mxchat'); ?></span>
162 - </button>
163 - </div>
164 -
165 - <div class="mxch-nav-item" data-section="testing">
166 - <button class="mxch-nav-link" data-target="testing">
167 - <span class="mxch-nav-link-icon">
168 - <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>
169 - </span>
170 - <span class="mxch-nav-link-text"><?php esc_html_e('Testing', 'mxchat'); ?></span>
171 - </button>
172 - </div>
173 146 </div>
174 147
175 148 <!-- Integrations Section -->
176 149 <div class="mxch-nav-section">
@@ -189,9 +162,8 @@
189 162 <button class="mxch-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button>
190 163 <button class="mxch-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button>
191 164 <button class="mxch-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button>
192 165 <button class="mxch-nav-sub-link" data-target="integrations-telegram"><?php esc_html_e('Telegram', 'mxchat'); ?></button>
193 - <button class="mxch-nav-sub-link" data-target="integrations-webhook"><?php esc_html_e('Webhook', 'mxchat'); ?></button>
194 166 </div>
195 167 </div>
196 168 </div>
197 169
@@ -207,9 +179,8 @@
207 179 <span class="mxch-nav-link-text"><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
208 180 </button>
209 181 </div>
210 182 </div>
211 -
212 183 </nav>
213 184
214 185 <?php if (!$is_activated): ?>
215 186 <div class="mxch-sidebar-footer">
@@ -225,12 +196,12 @@
225 196 <main class="mxch-content">
226 197 <?php if (!$is_activated): ?>
227 198 <div class="mxch-pro-banner">
228 199 <div class="mxch-pro-banner-content">
229 - <h3 class="mxch-pro-banner-title"><?php esc_html_e('Stop paying $50–200/month for AI chatbot tools.', 'mxchat'); ?></h3>
230 - <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>
200 + <h3 class="mxch-pro-banner-title"><?php esc_html_e('MxChat Pro — Lifetime Access', 'mxchat'); ?></h3>
201 + <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>
231 202 </div>
232 - <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Get Lifetime Access →', 'mxchat'); ?></span></a>
203 + <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Learn More', 'mxchat'); ?></span></a>
233 204 </div>
234 205 <?php endif; ?>
235 206
236 207 <?php
@@ -246,18 +217,8 @@
246 217 <h1 class="mxch-content-title"><?php esc_html_e('AI Models', 'mxchat'); ?></h1>
247 218 <p class="mxch-content-subtitle"><?php esc_html_e('Configure the AI models your chatbot will use for conversations and embeddings.', 'mxchat'); ?></p>
248 219 </div>
249 220
250 - <?php
251 - // Model-retirement warning (b65e8d). Rendered HERE rather than via
252 - // admin_notices because the branded shell paints over WP's notice
253 - // region — a core notice on this screen is invisible. No-ops unless
254 - // the daily liveness check has flagged the configured model.
255 - if (class_exists('MxChat_Model_Liveness')) {
256 - MxChat_Model_Liveness::render_inline_notice();
257 - }
258 - ?>
259 -
260 221 <div class="mxch-card">
261 222 <div class="mxch-card-body mxchat-autosave-section">
262 223 <?php
263 224 // Chat Model
@@ -274,12 +235,12 @@
274 235 mxchat_render_field_wrapper('enable_streaming', __('Enable Streaming', 'mxchat'), function() use ($admin_instance) {
275 236 $admin_instance->enable_streaming_toggle_callback();
276 237 }, __('Enable real-time streaming responses for supported models (OpenAI, Claude, DeepSeek, Grok).', 'mxchat'));
277 238
278 - // Enable Web Search (OpenAI & Gemini)
239 + // Enable Web Search (OpenAI only)
279 240 mxchat_render_field_wrapper('enable_web_search', __('Enable Web Search', 'mxchat'), function() use ($admin_instance) {
280 241 $admin_instance->enable_web_search_toggle_callback();
281 - }, __('Allow the chatbot to search the web for current information (OpenAI and Gemini models).', 'mxchat'));
242 + }, __('Allow the chatbot to search the web for current information (OpenAI models only).', 'mxchat'));
282 243 ?>
283 244 </div>
284 245 </div>
285 246 </div>
@@ -305,31 +266,8 @@
305 266 mxchat_render_field_wrapper('similarity_threshold', __('Similarity Threshold', 'mxchat'), function() use ($admin_instance) {
306 267 $admin_instance->mxchat_similarity_threshold_callback();
307 268 }, __('Adjust threshold for content matching. Lower values = more matches, higher values = stricter matching.', 'mxchat'));
308 269
309 - // RAG Sources Limit
310 - mxchat_render_field_wrapper('rag_sources_limit', __('RAG Sources Limit', 'mxchat'), function() use ($admin_instance) {
311 - $admin_instance->mxchat_rag_sources_limit_callback();
312 - }, __('Number of knowledge base sources (pages/documents) to include in AI context. Higher values provide more context but use more tokens.', 'mxchat'));
313 -
314 - // RAG Chunks Limit
315 - mxchat_render_field_wrapper('rag_chunks_limit', __('RAG Chunks Limit', 'mxchat'), function() use ($admin_instance) {
316 - $admin_instance->mxchat_rag_chunks_limit_callback();
317 - }, __('Maximum total content chunks sent to the AI across all sources. Higher values provide more context but increase token usage and cost.', 'mxchat'));
318 -
319 - // Hybrid keyword boost MOVED to Knowledge → Chunking &
320 - // Retrieval (plan 11720c) — it is KB retrieval tuning, not
321 - // conversation behavior. Same option key over there. The
322 - // breadcrumb below is a one-release courtesy: drop it in
323 - // the release after 3.2.17.
324 - echo '<p class="mxch-field-description">';
325 - printf(
326 - /* translators: %s: link to the Chunking & Retrieval settings tab. */
327 - esc_html__('Hybrid keyword boost has moved to %s.', 'mxchat'),
328 - '<a href="' . esc_url(admin_url('admin.php?page=mxchat-prompts#chunking')) . '">' . esc_html__('Knowledge, Chunking & Retrieval', 'mxchat') . '</a>'
329 - );
330 - echo '</p>';
331 -
332 270 // Contextual Awareness
333 271 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
334 272 $admin_instance->mxchat_contextual_awareness_callback();
335 273 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
@@ -338,26 +276,12 @@
338 276 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
339 277 $admin_instance->mxchat_citation_links_toggle_callback();
340 278 }, __('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'));
341 279
342 - // Strip Unapproved Links (plan 58f8b4) — enforcement is now
343 - // its own control instead of riding Citation Links.
344 - mxchat_render_field_wrapper('strip_unapproved_links', __('Strip Unapproved Links', 'mxchat'), function() use ($admin_instance) {
345 - $admin_instance->mxchat_strip_unapproved_links_toggle_callback();
346 - }, __('Remove links the AI invents from its answers, even when Citation Links is off. Approved citations, real pages on this site, and links returned by your integrations (e.g. WooCommerce products) are always kept. On by default for new installs; existing sites keep their current behavior until enabled.', 'mxchat'));
347 -
348 - // Satisfaction Rating Prompt
349 - // The toggle callback inline-renders the 5 customization
350 - // fields inside a single sub-options wrapper (plan-29caac).
351 - // No separate customization group needed — the wrapper handles
352 - // its own server-side display state based on the toggle value.
353 - mxchat_render_field_wrapper('satisfaction_rating', __('Satisfaction Rating Prompt', 'mxchat'), function() use ($admin_instance) {
354 - $admin_instance->mxchat_satisfaction_rating_toggle_callback();
355 - }, __('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'));
356 -
357 - // Editor Assistant toggle moved to Content → Settings (plan-f7df40):
358 - // it's a content feature, so it lives on the screen that owns it.
359 - // Rendering is in admin-content-page.php; option + save path unchanged.
280 + // Frontend Debugger
281 + mxchat_render_field_wrapper('frontend_debugger', __('Frontend Debugger', 'mxchat'), function() use ($admin_instance) {
282 + $admin_instance->mxchat_frontend_debugger_callback();
283 + }, __('Show debug panel on frontend for admins. Displays similarity scores and query analysis.', 'mxchat'));
360 284 ?>
361 285 </div>
362 286 </div>
363 287 </div>
@@ -382,9 +306,9 @@
382 306 <?php
383 307 // Auto-Display
384 308 mxchat_render_field_wrapper('auto_display', __('Auto-Display Chatbot', 'mxchat'), function() use ($admin_instance) {
385 309 $admin_instance->mxchat_append_to_body_callback();
386 - }, __('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'));
310 + }, __('Show chatbot automatically on all pages. Disable to use shortcode [mxchat_chatbot] instead.', 'mxchat'));
387 311
388 312 // Open Links in New Tab
389 313 mxchat_render_field_wrapper('link_target', __('Open Links in New Tab', 'mxchat'), function() use ($admin_instance) {
390 314 $admin_instance->mxchat_link_target_toggle_callback();
@@ -393,23 +317,8 @@
393 317 // Chat Persistence
394 318 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
395 319 $admin_instance->mxchat_chat_persistence_toggle_callback();
396 320 }, __('Keep chat history when users navigate or return within 24 hours.', 'mxchat'));
397 -
398 - // Download Transcript button
399 - mxchat_render_field_wrapper('print_button', __('Show Download Transcript Button', 'mxchat'), function() use ($admin_instance) {
400 - $admin_instance->mxchat_print_button_toggle_callback();
401 - }, __('Show the "Download Transcript" item in the chat window menu.', 'mxchat'));
402 -
403 - // Start-New-Chat button (plan ac2e81) — lets a visitor reset the
404 - // conversation without the owner disabling chat persistence globally.
405 - mxchat_render_field_wrapper('reset_chat_enabled', __('Show Start-New-Chat Button', 'mxchat'), function() use ($admin_instance) {
406 - $admin_instance->mxchat_reset_chat_toggle_callback();
407 - }, __('Show a "Start new chat" item in the chat window menu that clears the current conversation and begins a fresh session.', 'mxchat'));
408 -
409 - mxchat_render_field_wrapper('reset_chat_label', __('Start-New-Chat Button Label', 'mxchat'), function() use ($admin_instance) {
410 - $admin_instance->mxchat_reset_chat_label_callback();
411 - }, __('Label for the Start-New-Chat menu item. Leave blank to use "Start new chat".', 'mxchat'));
412 321 ?>
413 322 </div>
414 323 </div>
415 324
@@ -441,13 +350,8 @@
441 350 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
442 351 $admin_instance->mxchat_input_copy_callback();
443 352 }, __('Placeholder text in the chat input field.', 'mxchat'));
444 353
445 - // Max Input Length (characters) — plan a3fae2 part C
446 - mxchat_render_field_wrapper('max_input_length', __('Max Input Length (characters)', 'mxchat'), function() use ($admin_instance) {
447 - $admin_instance->mxchat_max_input_length_callback();
448 - }, __('Cap how many characters a visitor can type or paste into a single message. Set to 0 for unlimited (default).', 'mxchat'));
449 -
450 354 // Chat Teaser
451 355 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
452 356 $admin_instance->mxchat_pre_chat_message_callback();
453 357 }, __('Message shown before users start chatting.', 'mxchat'));
@@ -497,23 +401,8 @@
497 401 // Name Placeholder
498 402 mxchat_render_field_wrapper('name_placeholder', __('Name Field Placeholder', 'mxchat'), function() use ($admin_instance) {
499 403 $admin_instance->name_field_placeholder_callback();
500 404 }, __('Placeholder text for the name input field.', 'mxchat'));
501 -
502 - // Consent Checkbox (b062c4)
503 - mxchat_render_field_wrapper('enable_consent_checkbox', __('Consent Checkbox', 'mxchat'), function() use ($admin_instance) {
504 - $admin_instance->enable_consent_checkbox_callback();
505 - }, __('Show a consent checkbox on the email form. The decision, time, and exact label shown are stored with the lead.', 'mxchat'));
506 -
507 - // Consent Label
508 - mxchat_render_field_wrapper('consent_checkbox_label', __('Consent Label', 'mxchat'), function() use ($admin_instance) {
509 - $admin_instance->consent_checkbox_label_callback();
510 - }, __('Text shown beside the checkbox. Anchor tags are allowed so you can link your Privacy Policy; other HTML is stripped.', 'mxchat'));
511 -
512 - // Consent Required
513 - mxchat_render_field_wrapper('consent_checkbox_required', __('Require Consent to Submit', 'mxchat'), function() use ($admin_instance) {
514 - $admin_instance->consent_checkbox_required_callback();
515 - }, __('Block form submission until the box is ticked. Off means the checkbox is optional (a soft opt-in).', 'mxchat'));
516 405 ?>
517 406 </div>
518 407 </div>
519 408
@@ -630,292 +519,8 @@
630 519 </div>
631 520 </div>
632 521
633 522 <!-- ========================================
634 - OPTIMIZATION
635 - ======================================== -->
636 - <div id="optimization" class="mxch-section">
637 - <div class="mxch-content-header">
638 - <h1 class="mxch-content-title"><?php esc_html_e('Optimization & Diagnostics', 'mxchat'); ?></h1>
639 - <p class="mxch-content-subtitle"><?php esc_html_e('Optimize performance, debug issues, and manage plugin settings.', 'mxchat'); ?></p>
640 - </div>
641 -
642 - <!-- Script Loading Card -->
643 - <div class="mxch-card">
644 - <div class="mxch-card-header">
645 - <h3 class="mxch-card-title">
646 - <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>
647 - <?php esc_html_e('Script Loading', 'mxchat'); ?>
648 - </h3>
649 - </div>
650 - <div class="mxch-card-body mxchat-autosave-section">
651 - <?php
652 - $script_loading_strategy = isset($options['script_loading_strategy']) ? $options['script_loading_strategy'] : 'default';
653 - ?>
654 - <div class="mxch-field">
655 - <label class="mxch-field-label"><?php esc_html_e('Script Loading Strategy', 'mxchat'); ?></label>
656 - <div class="mxch-field-control">
657 - <select name="mxchat_options[script_loading_strategy]" id="script_loading_strategy" class="mxch-select mxchat-autosave-field">
658 - <option value="default" <?php selected($script_loading_strategy, 'default'); ?>><?php esc_html_e('Default (Immediate)', 'mxchat'); ?></option>
659 - <option value="defer" <?php selected($script_loading_strategy, 'defer'); ?>><?php esc_html_e('Deferred', 'mxchat'); ?></option>
660 - <option value="delay_1s" <?php selected($script_loading_strategy, 'delay_1s'); ?>><?php esc_html_e('Delay 1 Second', 'mxchat'); ?></option>
661 - <option value="delay_3s" <?php selected($script_loading_strategy, 'delay_3s'); ?>><?php esc_html_e('Delay 3 Seconds', 'mxchat'); ?></option>
662 - <option value="delay_5s" <?php selected($script_loading_strategy, 'delay_5s'); ?>><?php esc_html_e('Delay 5 Seconds', 'mxchat'); ?></option>
663 - <option value="on_interaction" <?php selected($script_loading_strategy, 'on_interaction'); ?>><?php esc_html_e('On User Interaction', 'mxchat'); ?></option>
664 - </select>
665 - </div>
666 - <p class="mxch-field-description"><?php esc_html_e('Control when the chatbot script loads to improve page performance.', 'mxchat'); ?></p>
667 - </div>
668 -
669 - <?php
670 - // Smart asset loading (plan-915355; rebuilt on the house toggle
671 - // pattern in plan-64d34f). Standalone option — never part of
672 - // mxchat_options, so mxchat_sanitize() can't strip it.
673 - mxchat_render_field_wrapper('mxchat_smart_asset_loading', __('Only load chatbot files on pages where the chatbot appears', 'mxchat'), function() use ($admin_instance) {
674 - $admin_instance->mxchat_smart_asset_loading_toggle_callback();
675 - }, __('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'),
676 - __('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'));
677 - ?>
678 -
679 - <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
680 - <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>
681 - <div>
682 - <strong><?php esc_html_e('Loading Strategies:', 'mxchat'); ?></strong>
683 - <ul style="margin: 8px 0 0 0; padding-left: 20px;">
684 - <li><strong><?php esc_html_e('Default:', 'mxchat'); ?></strong> <?php esc_html_e('Script loads immediately in the footer. Best for sites where chat is critical.', 'mxchat'); ?></li>
685 - <li><strong><?php esc_html_e('Deferred:', 'mxchat'); ?></strong> <?php esc_html_e('Script loads after HTML parsing completes. Good balance of performance and availability.', 'mxchat'); ?></li>
686 - <li><strong><?php esc_html_e('Delay:', 'mxchat'); ?></strong> <?php esc_html_e('Script loads after a set delay. Helps improve LCP scores.', 'mxchat'); ?></li>
687 - <li><strong><?php esc_html_e('On User Interaction:', 'mxchat'); ?></strong> <?php esc_html_e('Script loads when user scrolls, moves mouse, or touches screen. Best for Core Web Vitals but chat appears with slight delay.', 'mxchat'); ?></li>
688 - </ul>
689 - </div>
690 - </div>
691 - </div>
692 - </div>
693 -
694 - <!-- Page Cache Compatibility Card -->
695 - <div class="mxch-card">
696 - <div class="mxch-card-header">
697 - <h3 class="mxch-card-title">
698 - <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>
699 - <?php esc_html_e('Page Cache Compatibility', 'mxchat'); ?>
700 - </h3>
701 - </div>
702 - <div class="mxch-card-body">
703 - <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>
704 -
705 - <?php
706 - $mxch_cache_rows = array(
707 - array('name' => 'WP Rocket', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax\\.php\\?action=mxchat_.*'),
708 - array('name' => 'LiteSpeed Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
709 - array('name' => 'W3 Total Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
710 - array('name' => 'FlyingPress', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
711 - array('name' => 'WP Super Cache', 'state' => 'auto', 'exclusion' => 'wp-admin/admin-ajax.php'),
712 - array('name' => 'Cloudflare APO', 'state' => 'manual', 'exclusion' => 'Page Rule / Cache Rule: URI Path contains "/wp-admin/admin-ajax.php" → Bypass Cache'),
713 - );
714 - ?>
715 -
716 - <div class="mxch-cache-compat-grid" style="display: grid; grid-template-columns: 1fr; gap: 12px; margin-top: 16px;">
717 - <?php foreach ($mxch_cache_rows as $row) :
718 - $is_auto = ($row['state'] === 'auto');
719 - $pill_class = $is_auto ? 'mxch-status-pill-active' : 'mxch-status-pill-warning';
720 - $pill_label = $is_auto ? __('Auto-handled', 'mxchat') : __('Manual', 'mxchat');
721 - ?>
722 - <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);">
723 - <div style="display: flex; align-items: center; gap: 10px; min-width: 0; flex: 0 0 auto;">
724 - <span style="font-weight: 500;"><?php echo esc_html($row['name']); ?></span>
725 - <span class="mxch-status-pill <?php echo esc_attr($pill_class); ?>">
726 - <span class="mxch-status-dot"></span>
727 - <?php echo esc_html($pill_label); ?>
728 - </span>
729 - </div>
730 - <div style="display: flex; align-items: center; gap: 8px; flex: 1 1 auto; min-width: 0;">
731 - <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>
732 - <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;">
733 - <?php esc_html_e('Copy', 'mxchat'); ?>
734 - </button>
735 - </div>
736 - </div>
737 - <?php endforeach; ?>
738 - </div>
739 -
740 - <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
741 - <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>
742 - <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>
743 - </div>
744 - </div>
745 - </div>
746 -
747 - <!-- Provider Reliability Card -->
748 - <?php
749 - $auto_retry_enabled = !isset($options['auto_retry_on_transient_error']) ||
750 - (string) $options['auto_retry_on_transient_error'] !== '0';
751 - ?>
752 - <div class="mxch-card">
753 - <div class="mxch-card-header">
754 - <h3 class="mxch-card-title">
755 - <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>
756 - <?php esc_html_e('Provider Reliability', 'mxchat'); ?>
757 - </h3>
758 - <span class="mxch-status-pill <?php echo $auto_retry_enabled ? 'mxch-status-pill-active' : 'mxch-status-pill-disabled'; ?>">
759 - <span class="mxch-status-dot"></span>
760 - <?php echo $auto_retry_enabled ? esc_html__('Active', 'mxchat') : esc_html__('Disabled', 'mxchat'); ?>
761 - </span>
762 - </div>
763 - <div class="mxch-card-body mxchat-autosave-section">
764 - <div class="mxch-field">
765 - <label class="mxch-field-label" for="auto_retry_on_transient_error">
766 - <?php esc_html_e('Auto-retry on provider overload', 'mxchat'); ?>
767 - </label>
768 - <div class="mxch-field-control">
769 - <label class="mxch-toggle">
770 - <input type="checkbox"
771 - id="auto_retry_on_transient_error"
772 - name="mxchat_options[auto_retry_on_transient_error]"
773 - class="mxchat-autosave-field"
774 - value="1"
775 - <?php checked($auto_retry_enabled); ?> />
776 - <span class="mxch-toggle-slider"></span>
777 - </label>
778 - </div>
779 - <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>
780 - <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>
781 - </div>
782 - </div>
783 - </div>
784 -
785 - <!-- Debug Mode Card -->
786 - <?php
787 - $debug_mode = isset($options['debug_mode']) ? $options['debug_mode'] : 'off';
788 - $debug_active = ($debug_mode === 'on');
789 - ?>
790 - <div class="mxch-card">
791 - <div class="mxch-card-header">
792 - <h3 class="mxch-card-title">
793 - <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>
794 - <?php esc_html_e('Debug Mode', 'mxchat'); ?>
795 - </h3>
796 - </div>
797 - <div class="mxch-card-body">
798 - <?php // Deliberate exception to the house .toggle-switch pattern
799 - // (audited in plan-64d34f): this card-body is NOT an
800 - // autosave section — the toggle saves through its own
801 - // dedicated handler (mxchat_toggle_debug_mode, wired at
802 - // mxchat-admin.js #mxchat_debug_mode) which appends its own
803 - // save indicator inside this label. Converting the markup
804 - // would orphan that indicator without touching the JS. ?>
805 - <div class="mxch-field">
806 - <label class="mxch-toggle">
807 - <input type="checkbox" class="mxch-toggle-input" id="mxchat_debug_mode" name="mxchat_options[debug_mode]" value="on" <?php checked($debug_active); ?>>
808 - <span class="mxch-toggle-switch"></span>
809 - <span class="mxch-toggle-label"><?php esc_html_e('Enable Debug Logging', 'mxchat'); ?></span>
810 - </label>
811 - <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>
812 - </div>
813 - </div>
814 - </div>
815 -
816 - <!-- Debug Log Viewer Card -->
817 - <div class="mxch-card">
818 - <div class="mxch-card-header" style="display: flex; justify-content: space-between; align-items: center;">
819 - <h3 class="mxch-card-title">
820 - <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>
821 - <?php esc_html_e('Debug Log', 'mxchat'); ?>
822 - </h3>
823 - <div style="display: flex; gap: 8px; align-items: center;">
824 - <span id="mxchat-log-count" class="mxch-badge" style="display: none;"></span>
825 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-refresh-log">
826 - <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>
827 - <?php esc_html_e('Refresh', 'mxchat'); ?>
828 - </button>
829 - <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-clear-log">
830 - <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>
831 - <?php esc_html_e('Clear', 'mxchat'); ?>
832 - </button>
833 - </div>
834 - </div>
835 - <div class="mxch-card-body">
836 - <div id="mxchat-debug-log" class="mxchat-debug-log-viewer">
837 - <div class="mxchat-debug-log-empty">
838 - <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>
839 - <p><?php esc_html_e('No log entries yet. Enable debug mode to start logging.', 'mxchat'); ?></p>
840 - </div>
841 - </div>
842 - </div>
843 - </div>
844 -
845 - <!-- Settings Tools Card -->
846 - <div class="mxch-card">
847 - <div class="mxch-card-header">
848 - <h3 class="mxch-card-title">
849 - <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>
850 - <?php esc_html_e('Settings Tools', 'mxchat'); ?>
851 - </h3>
852 - </div>
853 - <div class="mxch-card-body">
854 - <div class="mxch-tools-grid">
855 - <!-- Export Settings -->
856 - <div class="mxch-tool-item">
857 - <div class="mxch-tool-icon">
858 - <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>
859 - </div>
860 - <div class="mxch-tool-content">
861 - <h4><?php esc_html_e('Export Settings', 'mxchat'); ?></h4>
862 - <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>
863 - <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-export-settings">
864 - <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>
865 - <?php esc_html_e('Export Settings', 'mxchat'); ?>
866 - </button>
867 - </div>
868 - </div>
869 -
870 - <!-- Reset All Settings -->
871 - <div class="mxch-tool-item mxch-tool-item-danger">
872 - <div class="mxch-tool-icon">
873 - <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>
874 - </div>
875 - <div class="mxch-tool-content">
876 - <h4><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h4>
877 - <p><?php esc_html_e('Reset all MxChat settings to their default values. This action cannot be undone.', 'mxchat'); ?></p>
878 - <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-settings">
879 - <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>
880 - <?php esc_html_e('Reset All Settings', 'mxchat'); ?>
881 - </button>
882 - </div>
883 - </div>
884 - </div>
885 - </div>
886 - </div>
887 -
888 - <!-- Reset Confirmation Modal -->
889 - <div id="mxchat-reset-modal" class="mxch-modal" style="display: none;">
890 - <div class="mxch-modal-backdrop"></div>
891 - <div class="mxch-modal-content">
892 - <div class="mxch-modal-header">
893 - <h3><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h3>
894 - <button type="button" class="mxch-modal-close" id="mxchat-reset-modal-close">&times;</button>
895 - </div>
896 - <div class="mxch-modal-body">
897 - <div class="mxch-notice mxch-notice-warning">
898 - <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>
899 - <div>
900 - <strong><?php esc_html_e('Warning: This action cannot be undone!', 'mxchat'); ?></strong>
901 - <p><?php esc_html_e('All your MxChat settings including API keys, customizations, and configurations will be permanently deleted.', 'mxchat'); ?></p>
902 - </div>
903 - </div>
904 - <div class="mxch-field" style="margin-top: 20px;">
905 - <label class="mxch-field-label"><?php esc_html_e('Type RESET to confirm:', 'mxchat'); ?></label>
906 - <input type="text" id="mxchat-reset-confirmation" class="mxch-input" placeholder="RESET" autocomplete="off">
907 - </div>
908 - </div>
909 - <div class="mxch-modal-footer">
910 - <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-reset-cancel"><?php esc_html_e('Cancel', 'mxchat'); ?></button>
911 - <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-confirm" disabled><?php esc_html_e('Reset All Settings', 'mxchat'); ?></button>
912 - </div>
913 - </div>
914 - </div>
915 - </div>
916 -
917 - <!-- ========================================
918 523 INTEGRATIONS - TOOLBAR
919 524 ======================================== -->
920 525 <div id="integrations-toolbar" class="mxch-section">
921 526 <div class="mxch-content-header">
@@ -981,9 +586,9 @@
981 586 <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>
982 587 <div>
983 588 <?php printf(
984 589 esc_html__('Visit our %s for setup instructions.', 'mxchat'),
985 - '<a href="https://mxchat.ai/documentation/mxchat-core#slack-live-agent-handoff" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
590 + '<a href="https://mxchat.ai/documentation/#slack_integration" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
986 591 ); ?>
987 592 </div>
988 593 </div>
989 594
@@ -1120,69 +725,8 @@
1120 725 </div>
1121 726 </div>
1122 727
1123 728 <!-- ========================================
1124 - INTEGRATIONS - WEBHOOK HANDOFF (plan d88e22)
1125 - ======================================== -->
1126 - <div id="integrations-webhook" class="mxch-section">
1127 - <div class="mxch-content-header">
1128 - <h1 class="mxch-content-title"><?php esc_html_e('Webhook', 'mxchat'); ?></h1>
1129 - <p class="mxch-content-subtitle"><?php esc_html_e('Route live-agent handoffs to any URL you choose — your helpdesk, an automation flow, a CRM.', 'mxchat'); ?></p>
1130 - </div>
1131 -
1132 - <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
1133 - <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>
1134 - <div>
1135 - <?php esc_html_e('This destination is outbound-only: MxChat delivers the handoff to your URL and the chatbot keeps assisting the visitor. Your team follows up separately — by email, phone, or your own support tool.', 'mxchat'); ?>
1136 - </div>
1137 - </div>
1138 -
1139 - <div class="mxch-card">
1140 - <div class="mxch-card-body mxchat-autosave-section">
1141 - <table class="form-table">
1142 - <?php do_settings_fields('mxchat-embed', 'mxchat_webhook_handoff_section'); ?>
1143 - </table>
1144 - </div>
1145 - </div>
1146 -
1147 - <div class="mxch-card" style="margin-top: 24px;">
1148 - <div class="mxch-card-header">
1149 - <h3 class="mxch-card-title">
1150 - <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"><polyline points="16 18 22 12 16 6"/><polyline points="8 6 2 12 8 18"/></svg>
1151 - <?php esc_html_e('Payload Reference', 'mxchat'); ?>
1152 - </h3>
1153 - </div>
1154 - <div class="mxch-card-body">
1155 - <p class="mxch-field-description" style="margin-bottom: 12px;">
1156 - <?php esc_html_e('Each handoff arrives at your URL as an HTTPS POST with Content-Type application/json:', 'mxchat'); ?>
1157 - </p>
1158 - <pre style="background: #f8f9fa; padding: 16px; border-radius: 8px; font-size: 12px; overflow-x: auto; margin: 0 0 16px;"><?php echo esc_html('{
1159 - "event": "live_agent_handoff",
1160 - "site": { "name": "Your Site", "url": "https://your-site.com" },
1161 - "session_id": "mxchat_chat_…",
1162 - "user_id": 0,
1163 - "visitor": { "name": "Ada", "email": "ada@example.com" },
1164 - "current_message": "I need to talk to a human",
1165 - "recent_messages": [
1166 - { "role": "user", "content": "…", "timestamp": 1755900000 },
1167 - { "role": "assistant", "content": "…", "timestamp": 1755900012 }
1168 - ],
1169 - "requested_at": "2026-08-22T14:30:00+00:00"
1170 -}'); ?></pre>
1171 - <p class="mxch-field-description" style="margin-bottom: 12px;">
1172 - <?php esc_html_e('When a Signing Secret is set, each request also carries this header so your endpoint can verify the sender — compute the HMAC of the raw request body with your secret and compare:', 'mxchat'); ?>
1173 - </p>
1174 - <div class="mxch-webhook-url-display" style="margin-bottom: 16px;">
1175 - <code>X-MxChat-Signature: sha256=&lt;hex hmac-sha256 of the raw body&gt;</code>
1176 - </div>
1177 - <p class="mxch-field-description">
1178 - <?php esc_html_e('Answer with any 2xx status. Delivery uses a 5-second timeout with one retry on transport errors and 5xx responses; redirects are not followed. The last failed delivery is shown under the Webhook URL field above.', 'mxchat'); ?>
1179 - </p>
1180 - </div>
1181 - </div>
1182 - </div>
1183 -
1184 - <!-- ========================================
1185 729 TUTORIALS
1186 730 ======================================== -->
1187 731 <div id="tutorials" class="mxch-section">
1188 732 <div class="mxch-content-header">
@@ -1189,40 +733,8 @@
1189 733 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1190 734 <p class="mxch-content-subtitle"><?php esc_html_e('Learn how to get the most out of MxChat with our video guides.', 'mxchat'); ?></p>
1191 735 </div>
1192 736
1193 - <?php
1194 - // Setup Guide — reopen the onboarding wizard (plan-347916, moved here from Display tab).
1195 - // Only shows once the user has dismissed/graduated from the Onboarding page.
1196 - if (function_exists('mxchat_onboarding_is_dismissed') && mxchat_onboarding_is_dismissed()):
1197 - $auto_grad = function_exists('mxchat_onboarding_is_auto_graduated') && mxchat_onboarding_is_auto_graduated();
1198 - ?>
1199 - <div class="mxch-card mxch-onboarding-unhide-card" style="margin-bottom: 24px;">
1200 - <div class="mxch-card-header">
1201 - <h3 class="mxch-card-title">
1202 - <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>
1203 - <?php esc_html_e('Setup Guide', 'mxchat'); ?>
1204 - </h3>
1205 - </div>
1206 - <div class="mxch-card-body">
1207 - <p style="margin:0 0 12px;color:var(--mxch-text-secondary);font-size:13px;line-height:1.5;">
1208 - <?php if ($auto_grad): ?>
1209 - <?php esc_html_e('You finished the setup guide. Reopen it any time to revisit the steps or change a setup choice.', 'mxchat'); ?>
1210 - <?php else: ?>
1211 - <?php esc_html_e('You hid the setup guide from the MxChat menu. Reopen it any time to revisit the steps.', 'mxchat'); ?>
1212 - <?php endif; ?>
1213 - </p>
1214 - <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>" style="margin:0;">
1215 - <?php wp_nonce_field('mxchat_unhide_onboarding'); ?>
1216 - <input type="hidden" name="action" value="mxchat_unhide_onboarding" />
1217 - <button type="submit" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1218 - <?php esc_html_e('Reopen setup guide', 'mxchat'); ?>
1219 - </button>
1220 - </form>
1221 - </div>
1222 - </div>
1223 - <?php endif; ?>
1224 -
1225 737 <div class="mxch-card" style="margin-bottom: 24px;">
1226 738 <div class="mxch-card-body">
1227 739 <div style="display: flex; align-items: flex-start; gap: 16px;">
1228 740 <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>
@@ -1241,23 +753,8 @@
1241 753 <div class="mxch-tutorials-grid">
1242 754 <?php
1243 755 $tutorials = array(
1244 756 array(
1245 - 'title' => __('Quick Setup with MxChat', 'mxchat'),
1246 - 'description' => __('Learn how to quickly setup and understand how your chatbot works.', 'mxchat'),
1247 - 'url' => 'https://www.youtube.com/watch?v=3BqoiyWaQiM&t'
1248 - ),
1249 - array(
1250 - 'title' => __('AI Content Generation', 'mxchat'),
1251 - 'description' => __('Generate full blog posts and landing pages with AI—from prompt to publish in minutes.', 'mxchat'),
1252 - 'url' => 'https://www.youtube.com/watch?v=n8TeEeHpxs4'
1253 - ),
1254 - array(
1255 - 'title' => __('Chat With Your GSC Data', 'mxchat'),
1256 - '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'),
1257 - 'url' => 'https://www.youtube.com/watch?v=ytgMou_7SZA&t=2s'
1258 - ),
1259 - array(
1260 757 'title' => __('AI Theme Generator', 'mxchat'),
1261 758 'description' => __('Learn how to instantly restyle your chatbot using plain English prompts with real-time previews.', 'mxchat'),
1262 759 'url' => 'https://www.youtube.com/watch?v=rSQDW2qbtRU&t'
1263 760 ),
@@ -1271,9 +768,14 @@
1271 768 'description' => __('Bring a ChatGPT-like experience directly inside your WordPress dashboard.', 'mxchat'),
1272 769 'url' => 'https://youtu.be/AdEA1k-UCFM'
1273 770 ),
1274 771 array(
1275 - 'title' => __('Chat Themes', 'mxchat'),
772 + 'title' => __('Intent Tester Guide', 'mxchat'),
773 + 'description' => __('Fine-tune your chatbot\'s responses and ensure accurate query understanding.', 'mxchat'),
774 + 'url' => 'https://www.youtube.com/watch?v=uTr14tn59Hc'
775 + ),
776 + array(
777 + 'title' => __('Theme Customizer', 'mxchat'),
1276 778 'description' => __('Customize appearance with real-time previews to match your brand.', 'mxchat'),
1277 779 'url' => 'https://youtu.be/MfbB9mZi6ag'
1278 780 ),
1279 781 array(
@@ -1327,125 +829,127 @@
1327 829 <?php endforeach; ?>
1328 830 </div>
1329 831 </div>
1330 832
1331 - <!-- =====================================================
1332 - TESTING SECTION
1333 - ===================================================== -->
1334 - <div id="testing" class="mxch-section">
1335 - <div class="mxch-content-header">
1336 - <h1 class="mxch-content-title"><?php esc_html_e('Testing', 'mxchat'); ?></h1>
1337 - <p class="mxch-content-subtitle"><?php esc_html_e('Test your chatbot and inspect debug data in real time.', 'mxchat'); ?></p>
1338 - </div>
833 + </main>
834 + </div>
1339 835
1340 - <div class="mxch-testing-layout">
1341 - <!-- Left Column: Debug Panel -->
1342 - <div class="mxch-testing-debug-panel">
1343 - <!-- Quick Actions -->
1344 - <div class="mxch-card">
1345 - <div class="mxch-card-body">
1346 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Quick Actions', 'mxchat'); ?></h3>
1347 - <div class="mxch-testing-actions-row">
1348 - <button type="button" class="mxch-testing-btn mxch-testing-btn-danger" id="mxch-testing-clear-session">
1349 - <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>
1350 - <?php esc_html_e('Clear Chat Session', 'mxchat'); ?>
1351 - </button>
1352 - <button type="button" class="mxch-testing-btn mxch-testing-btn-secondary" id="mxch-testing-clear-debug">
1353 - <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>
1354 - <?php esc_html_e('Clear Debug Log', 'mxchat'); ?>
1355 - </button>
1356 - </div>
1357 - </div>
1358 - </div>
836 + <script>
837 + document.addEventListener('DOMContentLoaded', function() {
838 + // Sidebar navigation
839 + const navLinks = document.querySelectorAll('.mxch-nav-link, .mxch-nav-sub-link');
840 + const sections = document.querySelectorAll('.mxch-section');
841 + const navItems = document.querySelectorAll('.mxch-nav-item');
1359 842
1360 - <!-- Last Query Analysis -->
1361 - <div class="mxch-card">
1362 - <div class="mxch-card-body">
1363 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Last Query Analysis', 'mxchat'); ?></h3>
843 + function showSection(target) {
844 + // Show target section
845 + sections.forEach(section => {
846 + section.classList.remove('active');
847 + if (section.id === target) {
848 + section.classList.add('active');
849 + }
850 + });
1364 851
1365 - <div class="mxch-testing-field">
1366 - <label><?php esc_html_e('Similarity Threshold', 'mxchat'); ?></label>
1367 - <span id="mxch-testing-threshold"><?php esc_html_e('Loading...', 'mxchat'); ?></span>
1368 - </div>
852 + // Scroll content area to top
853 + const contentArea = document.querySelector('.mxch-content');
854 + if (contentArea) {
855 + contentArea.scrollTop = 0;
856 + }
857 + }
1369 858
1370 - <div class="mxch-testing-field">
1371 - <label><?php esc_html_e('User Query', 'mxchat'); ?></label>
1372 - <div id="mxch-testing-last-query" class="mxch-testing-query-display"><?php esc_html_e('Waiting for next query...', 'mxchat'); ?></div>
1373 - </div>
859 + function setActiveNav(clickedLink) {
860 + // Remove active from all links
861 + navLinks.forEach(l => l.classList.remove('active'));
1374 862
1375 - <div class="mxch-testing-field">
1376 - <label><?php esc_html_e('Approved URLs for Citations', 'mxchat'); ?></label>
1377 - <div id="mxch-testing-approved-urls" class="mxch-testing-results">
1378 - <div class="mxch-testing-no-data"><?php esc_html_e('No URL data yet', 'mxchat'); ?></div>
1379 - </div>
1380 - </div>
863 + // Add active to clicked link
864 + clickedLink.classList.add('active');
1381 865
1382 - <div class="mxch-testing-field">
1383 - <label><?php esc_html_e('Document Matches', 'mxchat'); ?></label>
1384 - <div id="mxch-testing-similarity-scores" class="mxch-testing-results">
1385 - <div class="mxch-testing-no-data"><?php esc_html_e('No query data yet', 'mxchat'); ?></div>
1386 - </div>
1387 - </div>
866 + // If clicking a sub-link, also highlight parent
867 + if (clickedLink.classList.contains('mxch-nav-sub-link')) {
868 + const parent = clickedLink.closest('.mxch-nav-item');
869 + if (parent) {
870 + parent.querySelector('.mxch-nav-link').classList.add('active');
871 + }
872 + }
873 + }
1388 874
1389 - <div class="mxch-testing-field">
1390 - <label><?php esc_html_e('Actions Triggered', 'mxchat'); ?></label>
1391 - <div id="mxch-testing-action-scores" class="mxch-testing-results">
1392 - <div class="mxch-testing-no-data"><?php esc_html_e('No action data yet', 'mxchat'); ?></div>
1393 - </div>
1394 - </div>
1395 - </div>
1396 - </div>
875 + navLinks.forEach(link => {
876 + link.addEventListener('click', function(e) {
877 + e.preventDefault();
878 + e.stopPropagation();
879 + const target = this.dataset.target;
880 + const parentItem = this.closest('.mxch-nav-item');
881 + const hasSubmenu = parentItem && parentItem.querySelector('.mxch-nav-sub');
1397 882
1398 - <!-- System Information -->
1399 - <div class="mxch-card">
1400 - <div class="mxch-card-body">
1401 - <h3 class="mxch-testing-section-title"><?php esc_html_e('System Information', 'mxchat'); ?></h3>
883 + // If this is a parent nav link WITH children (expandable menu)
884 + if (this.classList.contains('mxch-nav-link') && hasSubmenu) {
885 + const wasExpanded = parentItem.classList.contains('expanded');
1402 886
1403 - <div class="mxch-testing-field">
1404 - <label><?php esc_html_e('System Prompt', 'mxchat'); ?></label>
1405 - <div id="mxch-testing-system-prompt" class="mxch-testing-system-prompt"><?php esc_html_e('Loading...', 'mxchat'); ?></div>
1406 - </div>
887 + // Collapse all other expandable items
888 + navItems.forEach(item => {
889 + if (item !== parentItem && item.querySelector('.mxch-nav-sub')) {
890 + item.classList.remove('expanded');
891 + }
892 + });
1407 893
1408 - <div class="mxch-testing-field">
1409 - <label><?php esc_html_e('Knowledge Base', 'mxchat'); ?></label>
1410 - <span id="mxch-testing-kb-status"><?php esc_html_e('Checking...', 'mxchat'); ?></span>
1411 - </div>
1412 - </div>
1413 - </div>
894 + // Toggle this item
895 + parentItem.classList.toggle('expanded');
1414 896
1415 - <!-- Debug Log -->
1416 - <div class="mxch-card">
1417 - <div class="mxch-card-body">
1418 - <h3 class="mxch-testing-section-title"><?php esc_html_e('Debug Log', 'mxchat'); ?></h3>
1419 - <div id="mxch-testing-debug-console" class="mxch-testing-debug-console">
1420 - <div class="mxch-testing-debug-entry"><?php esc_html_e('Debug panel ready - send a message to begin...', 'mxchat'); ?></div>
1421 - </div>
1422 - </div>
1423 - </div>
1424 - </div>
897 + // If expanding, show the first sub-item's content and mark it active
898 + if (!wasExpanded) {
899 + const firstSubLink = parentItem.querySelector('.mxch-nav-sub-link');
900 + if (firstSubLink) {
901 + const firstTarget = firstSubLink.dataset.target;
902 + showSection(firstTarget);
903 + setActiveNav(firstSubLink);
904 + // Also mark parent as active
905 + this.classList.add('active');
906 + history.replaceState(null, null, '#' + firstTarget);
907 + }
908 + }
909 + }
910 + // If this is a nav link WITHOUT children (like API Keys, Tutorials)
911 + else if (this.classList.contains('mxch-nav-link') && !hasSubmenu && target) {
912 + // Collapse all expandable items
913 + navItems.forEach(item => {
914 + if (item.querySelector('.mxch-nav-sub')) {
915 + item.classList.remove('expanded');
916 + }
917 + });
1425 918
1426 - <!-- Right Column: Chatbot Replica -->
1427 - <div class="mxch-testing-chatbot-column">
1428 - <div class="mxch-testing-chatbot-scope">
1429 - <?php
1430 - // Render the chatbot inline for testing
1431 - echo do_shortcode('[mxchat_chatbot floating="no" bot_id="testing"]');
1432 - ?>
1433 - </div>
1434 - </div>
1435 - </div>
1436 - </div>
919 + // Show the section
920 + showSection(target);
921 + setActiveNav(this);
922 + history.replaceState(null, null, '#' + target);
923 + }
924 + // If this is a sub-link
925 + else if (this.classList.contains('mxch-nav-sub-link') && target) {
926 + // Ensure parent stays expanded
927 + if (parentItem) {
928 + parentItem.classList.add('expanded');
929 + }
930 + showSection(target);
931 + setActiveNav(this);
932 + history.replaceState(null, null, '#' + target);
933 + }
934 + });
935 + });
1437 936
1438 - </main>
1439 - </div>
937 + // Handle initial hash
938 + const hash = window.location.hash.slice(1);
939 + if (hash) {
940 + const targetLink = document.querySelector('[data-target="' + hash + '"]');
941 + if (targetLink) {
942 + // Expand parent if it's a sub-link
943 + const parentItem = targetLink.closest('.mxch-nav-item');
944 + if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
945 + parentItem.classList.add('expanded');
946 + }
947 + showSection(hash);
948 + setActiveNav(targetLink);
949 + }
950 + }
1440 951
1441 - <script>
1442 - document.addEventListener('DOMContentLoaded', function() {
1443 - // Sidebar/tab navigation, accordion groups, ?tab=/#hash deep-linking
1444 - // and the mobile menu all live in the shared shell script
1445 - // (js/admin-sidebar.js) — consolidated by plan c192a4. Only the
1446 - // page-local widgets below remain inline.
1447 -
1448 952 // Rate limit accordion
1449 953 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1450 954 rateLimitHeaders.forEach(header => {
1451 955 header.addEventListener('click', function(e) {
@@ -1455,25 +959,101 @@
1455 959 item.classList.toggle('expanded');
1456 960 });
1457 961 });
1458 962
1459 - // Rate-limit "Custom…" toggle: show/hide the integer input below each
1460 - // limit <select> based on whether __custom__ is the active option.
1461 - document.querySelectorAll('.mxch-rate-limit-limit-select').forEach(sel => {
1462 - const targetId = sel.getAttribute('data-mxch-custom-target');
1463 - if (!targetId) return;
1464 - const field = document.querySelector('[data-mxch-custom-for="' + targetId + '"]');
1465 - if (!field) return;
1466 - const sync = () => {
1467 - if (sel.value === '__custom__') {
1468 - field.hidden = false;
1469 - } else {
1470 - field.hidden = true;
963 + // =====================================================
964 + // Mobile Menu Functionality
965 + // =====================================================
966 + const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
967 + const mobileMenuClose = document.querySelector('.mxch-mobile-menu-close');
968 + const mobileMenu = document.querySelector('.mxch-mobile-menu');
969 + const mobileOverlay = document.querySelector('.mxch-mobile-overlay');
970 + const mobileNavLinks = document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link');
971 +
972 + function openMobileMenu() {
973 + mobileMenu.classList.add('open');
974 + mobileOverlay.classList.add('open');
975 + document.body.style.overflow = 'hidden';
976 + }
977 +
978 + function closeMobileMenu() {
979 + mobileMenu.classList.remove('open');
980 + mobileOverlay.classList.remove('open');
981 + document.body.style.overflow = '';
982 + }
983 +
984 + if (mobileMenuBtn) {
985 + mobileMenuBtn.addEventListener('click', openMobileMenu);
986 + }
987 +
988 + if (mobileMenuClose) {
989 + mobileMenuClose.addEventListener('click', closeMobileMenu);
990 + }
991 +
992 + if (mobileOverlay) {
993 + mobileOverlay.addEventListener('click', closeMobileMenu);
994 + }
995 +
996 + // Mobile navigation links
997 + mobileNavLinks.forEach(link => {
998 + link.addEventListener('click', function(e) {
999 + e.preventDefault();
1000 + e.stopPropagation();
1001 +
1002 + const target = this.dataset.target;
1003 + const parentId = this.dataset.parent;
1004 +
1005 + // If this is an expandable parent link
1006 + if (parentId && !target) {
1007 + const subNav = document.querySelector('.mxch-mobile-nav-sub[data-parent="' + parentId + '"]');
1008 + if (subNav) {
1009 + const isExpanded = subNav.classList.contains('expanded');
1010 + // Collapse all sub navs
1011 + document.querySelectorAll('.mxch-mobile-nav-sub').forEach(nav => {
1012 + nav.classList.remove('expanded');
1013 + });
1014 + document.querySelectorAll('.mxch-mobile-nav-link').forEach(l => {
1015 + l.classList.remove('expanded');
1016 + });
1017 + // Toggle this one
1018 + if (!isExpanded) {
1019 + subNav.classList.add('expanded');
1020 + this.classList.add('expanded');
1021 + }
1022 + }
1471 1023 }
1472 - };
1473 - sel.addEventListener('change', sync);
1474 - sync();
1024 + // If this is a direct link or sub-link with a target
1025 + else if (target) {
1026 + // Update mobile nav active state
1027 + document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link').forEach(l => {
1028 + l.classList.remove('active');
1029 + });
1030 + this.classList.add('active');
1031 +
1032 + // Also update desktop sidebar nav
1033 + const desktopLink = document.querySelector('.mxch-sidebar [data-target="' + target + '"]');
1034 + if (desktopLink) {
1035 + setActiveNav(desktopLink);
1036 + const parentItem = desktopLink.closest('.mxch-nav-item');
1037 + if (parentItem && desktopLink.classList.contains('mxch-nav-sub-link')) {
1038 + parentItem.classList.add('expanded');
1039 + }
1040 + }
1041 +
1042 + // Show section and close menu
1043 + showSection(target);
1044 + history.replaceState(null, null, '#' + target);
1045 + closeMobileMenu();
1046 + }
1047 + });
1475 1048 });
1049 +
1050 + // Close mobile menu on escape key
1051 + document.addEventListener('keydown', function(e) {
1052 + if (e.key === 'Escape' && mobileMenu && mobileMenu.classList.contains('open')) {
1053 + closeMobileMenu();
1054 + }
1055 + });
1476 1056 });
1477 1057 </script>
1478 1058 <?php
1479 1059 }
@@ -1479,14 +1059,10 @@
1479 1059 }
1480 1060
1481 1061 /**
1482 1062 * Helper function to render a field with consistent wrapper
1483 - *
1484 - * $hint renders as a .mxch-field-hint line under the description — the
1485 - * softer "caveats / fine print" slot (added for plan-64d34f so hint-bearing
1486 - * fields don't have to hand-roll the wrapper markup).
1487 1063 */
1488 -function mxchat_render_field_wrapper($id, $label, $callback, $description = '', $hint = '') {
1064 +function mxchat_render_field_wrapper($id, $label, $callback, $description = '') {
1489 1065 ?>
1490 1066 <div class="mxch-field">
1491 1067 <label class="mxch-field-label"><?php echo esc_html($label); ?></label>
1492 1068 <div class="mxch-field-control">
@@ -1494,11 +1070,8 @@
1494 1070 </div>
1495 1071 <?php if ($description): ?>
1496 1072 <p class="mxch-field-description"><?php echo esc_html($description); ?></p>
1497 1073 <?php endif; ?>
1498 - <?php if ($hint): ?>
1499 - <p class="mxch-field-hint"><?php echo esc_html($hint); ?></p>
1500 - <?php endif; ?>
1501 1074 </div>
1502 1075 <?php
1503 1076 }
1504 1077
@@ -1517,146 +1090,10 @@
1517 1090
1518 1091 $roles = wp_roles()->get_names();
1519 1092 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1520 1093
1521 - // Whole-chatbot global cap (sits above per-role; defaults to unlimited so
1522 - // existing installs are unchanged). Stored under mxchat_options['rate_limits_global'].
1523 - $global_cfg = isset($all_options['rate_limits_global']) && is_array($all_options['rate_limits_global'])
1524 - ? $all_options['rate_limits_global']
1525 - : array();
1526 - $global_limit_raw = isset($global_cfg['limit']) ? (string) $global_cfg['limit'] : 'unlimited';
1527 - $global_timeframe = isset($global_cfg['timeframe']) ? (string) $global_cfg['timeframe'] : 'daily';
1528 - $global_is_unlimited = ($global_limit_raw === '' || $global_limit_raw === 'unlimited');
1529 - $global_is_preset = !$global_is_unlimited && in_array($global_limit_raw, $rate_limits, true);
1530 - $global_select_value = $global_is_unlimited ? 'unlimited' : ($global_is_preset ? $global_limit_raw : '__custom__');
1531 - $global_custom_value = (!$global_is_unlimited && !$global_is_preset && ctype_digit($global_limit_raw))
1532 - ? $global_limit_raw
1533 - : '';
1534 -
1535 1094 echo '<div class="mxch-rate-limits">';
1536 1095
1537 - // --- Global cap card -------------------------------------------------
1538 - ?>
1539 - <div class="mxch-rate-limit-item mxch-rate-limit-global mxchat-autosave-section">
1540 - <div class="mxch-rate-limit-header">
1541 - <span class="mxch-rate-limit-role"><?php esc_html_e('Total chatbot message limit', 'mxchat'); ?></span>
1542 - <div class="mxch-rate-limit-summary">
1543 - <span class="mxch-rate-limit-badge mxch-rate-limit-global-badge">
1544 - <?php
1545 - if ($global_is_unlimited) {
1546 - esc_html_e('Unlimited', 'mxchat');
1547 - } else {
1548 - $tf_label = isset($timeframes[$global_timeframe]) ? $timeframes[$global_timeframe] : $global_timeframe;
1549 - echo esc_html(($global_custom_value !== '' ? $global_custom_value : $global_limit_raw) . ' / ' . $tf_label);
1550 - }
1551 - ?>
1552 - </span>
1553 - <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>
1554 - </div>
1555 - </div>
1556 - <div class="mxch-rate-limit-body">
1557 - <p class="mxch-field-description" style="margin: 0 0 12px;">
1558 - <?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'); ?>
1559 - </p>
1560 - <div class="mxch-rate-limit-controls">
1561 - <div class="mxch-field">
1562 - <label class="mxch-field-label" for="rate_limits_global_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1563 - <select id="rate_limits_global_limit"
1564 - name="mxchat_options[rate_limits_global][limit]"
1565 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1566 - data-mxch-custom-target="rate_limits_global_limit_custom">
1567 - <?php foreach ($rate_limits as $limit): ?>
1568 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($global_select_value, $limit); ?>>
1569 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1570 - </option>
1571 - <?php endforeach; ?>
1572 - <option value="__custom__" <?php selected($global_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1573 - </select>
1574 - </div>
1575 - <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'; ?>>
1576 - <label class="mxch-field-label" for="rate_limits_global_limit_custom"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1577 - <input type="number"
1578 - min="1"
1579 - step="1"
1580 - id="rate_limits_global_limit_custom"
1581 - name="mxchat_options[rate_limits_global][limit_custom]"
1582 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1583 - placeholder="e.g. 250"
1584 - value="<?php echo esc_attr($global_custom_value); ?>" />
1585 - </div>
1586 - <div class="mxch-field">
1587 - <label class="mxch-field-label" for="rate_limits_global_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1588 - <select id="rate_limits_global_timeframe"
1589 - name="mxchat_options[rate_limits_global][timeframe]"
1590 - class="mxch-select mxchat-autosave-field">
1591 - <?php foreach ($timeframes as $value => $label): ?>
1592 - <option value="<?php echo esc_attr($value); ?>" <?php selected($global_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1593 - <?php endforeach; ?>
1594 - </select>
1595 - </div>
1596 - </div>
1597 - <?php
1598 - // --- Current usage readout (read-only; mirrors the integrator's
1599 - // window-reset math at READ time — never writes the counter here).
1600 - // v1 surfaces the DEFAULT bot's pool. TODO: per-bot selector if asked.
1601 - $global_usage_limit_int = (!$global_is_unlimited && ctype_digit($global_limit_raw))
1602 - ? (int) $global_limit_raw
1603 - : 0;
1604 - $usage_raw = get_option('mxchat_chat_limit_default_global', array('count' => 0, 'timestamp' => time()));
1605 - $usage_count = isset($usage_raw['count']) ? (int) $usage_raw['count'] : 0;
1606 - $usage_ts = isset($usage_raw['timestamp']) ? (int) $usage_raw['timestamp'] : time();
1607 - $usage_windows = array('hourly' => 3600, 'daily' => 86400, 'weekly' => 604800, 'monthly' => 2592000);
1608 - $usage_window = isset($usage_windows[$global_timeframe]) ? $usage_windows[$global_timeframe] : 86400;
1609 - $usage_now = time();
1610 - if (($usage_now - $usage_ts) >= $usage_window) {
1611 - // Window elapsed since the stored timestamp → effective count is 0.
1612 - $usage_count = 0;
1613 - $usage_reset_at = $usage_now + $usage_window;
1614 - } else {
1615 - $usage_reset_at = $usage_ts + $usage_window;
1616 - }
1617 - $usage_left = max(0, $global_usage_limit_int - $usage_count);
1618 - $usage_pct = ($global_usage_limit_int > 0)
1619 - ? min(100, (int) round(($usage_count / $global_usage_limit_int) * 100))
1620 - : 0;
1621 - $usage_reset_nonce = wp_create_nonce('mxchat_reset_global_usage');
1622 - ?>
1623 - <div class="mxch-rate-limit-usage"
1624 - id="mxch-global-usage"
1625 - data-bot-id="default"
1626 - data-reset-nonce="<?php echo esc_attr($usage_reset_nonce); ?>"
1627 - <?php echo $global_is_unlimited ? 'hidden' : ''; ?>>
1628 - <div class="mxch-rate-limit-usage-head">
1629 - <span class="mxch-field-label" style="margin:0;"><?php esc_html_e('Current usage', 'mxchat'); ?></span>
1630 - <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>
1631 - </div>
1632 - <div class="mxch-progress-bar">
1633 - <div class="mxch-progress-bar-fill" id="mxch-global-usage-fill" style="width: <?php echo esc_attr($usage_pct); ?>%;"></div>
1634 - </div>
1635 - <p class="mxch-progress-label" id="mxch-global-usage-text" style="margin:0;">
1636 - <?php
1637 - printf(
1638 - /* translators: 1: used count, 2: limit, 3: remaining, 4: human-readable time until reset */
1639 - esc_html__('%1$s of %2$s used · %3$s left · resets in %4$s', 'mxchat'),
1640 - esc_html(number_format_i18n($usage_count)),
1641 - esc_html(number_format_i18n($global_usage_limit_int)),
1642 - esc_html(number_format_i18n($usage_left)),
1643 - esc_html(human_time_diff($usage_now, $usage_reset_at))
1644 - );
1645 - ?>
1646 - </p>
1647 - </div>
1648 - <p class="mxch-field-description mxch-rate-limit-usage-unlimited"
1649 - id="mxch-global-usage-unlimited"
1650 - style="margin: 12px 0 0;"
1651 - <?php echo $global_is_unlimited ? '' : 'hidden'; ?>>
1652 - <?php esc_html_e('Unlimited — no cap. Usage tracking applies only when a numeric limit is set.', 'mxchat'); ?>
1653 - </p>
1654 - </div>
1655 - </div>
1656 - <?php
1657 - // ---------------------------------------------------------------------
1658 -
1659 1096 foreach ($roles as $role_id => $role_name) {
1660 1097 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1661 1098 $default_timeframe = 'daily';
1662 1099 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
@@ -1661,9 +1098,9 @@
1661 1098 $default_timeframe = 'daily';
1662 1099 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1663 1100
1664 1101 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1665 - ? (string) $all_options['rate_limits'][$role_id]['limit']
1102 + ? $all_options['rate_limits'][$role_id]['limit']
1666 1103 : $default_limit;
1667 1104
1668 1105 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1669 1106 ? $all_options['rate_limits'][$role_id]['timeframe']
@@ -1673,16 +1110,8 @@
1673 1110 ? $all_options['rate_limits'][$role_id]['message']
1674 1111 : $default_message;
1675 1112
1676 1113 $timeframe_label = isset($timeframes[$selected_timeframe]) ? $timeframes[$selected_timeframe] : $selected_timeframe;
1677 -
1678 - // Custom-value handling: if the stored limit is not in the preset list
1679 - // and not 'unlimited', it's a custom integer. The select shows __custom__
1680 - // and the number input below carries the actual value.
1681 - $is_preset_limit = in_array($selected_limit, $rate_limits, true);
1682 - $role_select_value = $is_preset_limit ? $selected_limit : '__custom__';
1683 - $role_custom_value = (!$is_preset_limit && ctype_digit($selected_limit)) ? $selected_limit : '';
1684 - $custom_field_id = 'rate_limits_' . $role_id . '_limit_custom';
1685 1114 ?>
1686 1115 <div class="mxch-rate-limit-item">
1687 1116 <div class="mxch-rate-limit-header">
1688 1117 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
@@ -1696,28 +1125,13 @@
1696 1125 <div class="mxch-field">
1697 1126 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1698 1127 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1699 1128 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit]"
1700 - class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1701 - data-mxch-custom-target="<?php echo esc_attr($custom_field_id); ?>">
1129 + class="mxch-select mxchat-autosave-field">
1702 1130 <?php foreach ($rate_limits as $limit): ?>
1703 - <option value="<?php echo esc_attr($limit); ?>" <?php selected($role_select_value, $limit); ?>>
1704 - <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1705 - </option>
1131 + <option value="<?php echo esc_attr($limit); ?>" <?php selected($selected_limit, $limit); ?>><?php echo esc_html($limit); ?></option>
1706 1132 <?php endforeach; ?>
1707 - <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1708 1133 </select>
1709 - </div>
1710 - <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'; ?>>
1711 - <label class="mxch-field-label" for="<?php echo esc_attr($custom_field_id); ?>"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1712 - <input type="number"
1713 - min="1"
1714 - step="1"
1715 - id="<?php echo esc_attr($custom_field_id); ?>"
1716 - name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit_custom]"
1717 - class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1718 - placeholder="e.g. 250"
1719 - value="<?php echo esc_attr($role_custom_value); ?>" />
1720 1134 </div>
1721 1135 <div class="mxch-field">
1722 1136 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1723 1137 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"