| @@ -86,8 +86,9 @@ | ||
| 86 | 86 | <button class="mxch-mobile-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button> |
| 87 | 87 | <button class="mxch-mobile-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button> |
| 88 | 88 | <button class="mxch-mobile-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button> |
| 89 | 89 | <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> | |
| 90 | 91 | </div> |
| 91 | 92 | </div> |
| 92 | 93 | <!-- Resources Section --> |
| 93 | 94 | <div class="mxch-mobile-nav-section"> |
| @@ -188,8 +189,9 @@ | ||
| 188 | 189 | <button class="mxch-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button> |
| 189 | 190 | <button class="mxch-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button> |
| 190 | 191 | <button class="mxch-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button> |
| 191 | 192 | <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> | |
| 192 | 194 | </div> |
| 193 | 195 | </div> |
| 194 | 196 | </div> |
| 195 | 197 | |
| @@ -244,8 +246,18 @@ | ||
| 244 | 246 | <h1 class="mxch-content-title"><?php esc_html_e('AI Models', 'mxchat'); ?></h1> |
| 245 | 247 | <p class="mxch-content-subtitle"><?php esc_html_e('Configure the AI models your chatbot will use for conversations and embeddings.', 'mxchat'); ?></p> |
| 246 | 248 | </div> |
| 247 | 249 | |
| 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 | + | |
| 248 | 260 | <div class="mxch-card"> |
| 249 | 261 | <div class="mxch-card-body mxchat-autosave-section"> |
| 250 | 262 | <?php |
| 251 | 263 | // Chat Model |
| @@ -303,22 +315,20 @@ | ||
| 303 | 315 | mxchat_render_field_wrapper('rag_chunks_limit', __('RAG Chunks Limit', 'mxchat'), function() use ($admin_instance) { |
| 304 | 316 | $admin_instance->mxchat_rag_chunks_limit_callback(); |
| 305 | 317 | }, __('Maximum total content chunks sent to the AI across all sources. Higher values provide more context but increase token usage and cost.', 'mxchat')); |
| 306 | 318 | |
| 307 | - // Hybrid keyword boost (plan-38ffa1). Standalone option — never part | |
| 308 | - // of mxchat_options, so mxchat_sanitize() can't strip it. Default OFF. | |
| 309 | - $hybrid_keyword = get_option('mxchat_hybrid_keyword_toggle', 'off'); | |
| 310 | - ?> | |
| 311 | - <div class="mxch-field" style="margin-top: 16px;"> | |
| 312 | - <label class="mxch-toggle"> | |
| 313 | - <input type="checkbox" class="mxch-toggle-input mxchat-autosave-field" id="mxchat_hybrid_keyword_toggle" name="mxchat_hybrid_keyword_toggle" value="on" <?php checked($hybrid_keyword, 'on'); ?>> | |
| 314 | - <span class="mxch-toggle-switch"></span> | |
| 315 | - <span class="mxch-toggle-label"><?php esc_html_e('Hybrid keyword boost (WP-DB knowledge base)', 'mxchat'); ?></span> | |
| 316 | - </label> | |
| 317 | - <p class="mxch-field-description"><?php esc_html_e('Combines keyword matching with vector similarity when searching your WordPress-database knowledge base. Helps exact-token questions — product codes, SKUs, error codes, names — find the right document even when semantic similarity alone would miss it.', 'mxchat'); ?></p> | |
| 318 | - <p class="mxch-field-hint"><?php esc_html_e('Only affects the WordPress-database knowledge base; Pinecone is unaffected. Changes which sources are retrieved on existing installs, so test after enabling. The Transcripts sources panel labels how each match was found while this is on.', 'mxchat'); ?></p> | |
| 319 | - </div> | |
| 320 | - <?php | |
| 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>'; | |
| 321 | 331 | |
| 322 | 332 | // Contextual Awareness |
| 323 | 333 | mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) { |
| 324 | 334 | $admin_instance->mxchat_contextual_awareness_callback(); |
| @@ -328,8 +338,14 @@ | ||
| 328 | 338 | mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) { |
| 329 | 339 | $admin_instance->mxchat_citation_links_toggle_callback(); |
| 330 | 340 | }, __('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')); |
| 331 | 341 | |
| 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 | + | |
| 332 | 348 | // Satisfaction Rating Prompt |
| 333 | 349 | // The toggle callback inline-renders the 5 customization |
| 334 | 350 | // fields inside a single sub-options wrapper (plan-29caac). |
| 335 | 351 | // No separate customization group needed — the wrapper handles |
| @@ -337,12 +353,11 @@ | ||
| 337 | 353 | mxchat_render_field_wrapper('satisfaction_rating', __('Satisfaction Rating Prompt', 'mxchat'), function() use ($admin_instance) { |
| 338 | 354 | $admin_instance->mxchat_satisfaction_rating_toggle_callback(); |
| 339 | 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')); |
| 340 | 356 | |
| 341 | - // Editor Assistant — free, off-by-default block-editor AI actions (plan-8cb0cb). | |
| 342 | - mxchat_render_field_wrapper('mxchat_editor_assistant_enabled', __('Editor Assistant', 'mxchat'), function() use ($admin_instance) { | |
| 343 | - $admin_instance->mxchat_editor_assistant_toggle_callback(); | |
| 344 | - }, __('Add magic-wand AI writing actions (rewrite, summarize, translate, continue, fix grammar) to the WordPress block editor. Opens a sidebar in the post editor. Uses the AI model configured above. Off by default.', 'mxchat')); | |
| 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. | |
| 345 | 360 | ?> |
| 346 | 361 | </div> |
| 347 | 362 | </div> |
| 348 | 363 | </div> |
| @@ -482,8 +497,33 @@ | ||
| 482 | 497 | // Name Placeholder |
| 483 | 498 | mxchat_render_field_wrapper('name_placeholder', __('Name Field Placeholder', 'mxchat'), function() use ($admin_instance) { |
| 484 | 499 | $admin_instance->name_field_placeholder_callback(); |
| 485 | 500 | }, __('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 | + | |
| 517 | + // Also show for logged-in users (c0cfaf) | |
| 518 | + mxchat_render_field_wrapper('lead_capture_logged_in_toggle', __('Also Show for Logged-In Users', 'mxchat'), function() use ($admin_instance) { | |
| 519 | + $admin_instance->lead_capture_logged_in_toggle_callback(); | |
| 520 | + }, __('Show the form to signed-in visitors too, pre-filled from their profile. Off means signed-in visitors skip it, as they do today.', 'mxchat')); | |
| 521 | + | |
| 522 | + // Require email (c0cfaf) | |
| 523 | + mxchat_render_field_wrapper('lead_capture_require_email_toggle', __('Require Email Address', 'mxchat'), function() use ($admin_instance) { | |
| 524 | + $admin_instance->lead_capture_require_email_toggle_callback(); | |
| 525 | + }, __('Off means the email field is optional, so you can collect a name (and consent) without an address.', 'mxchat')); | |
| 486 | 526 | ?> |
| 487 | 527 | </div> |
| 488 | 528 | </div> |
| 489 | 529 | |
| @@ -636,21 +676,16 @@ | ||
| 636 | 676 | <p class="mxch-field-description"><?php esc_html_e('Control when the chatbot script loads to improve page performance.', 'mxchat'); ?></p> |
| 637 | 677 | </div> |
| 638 | 678 | |
| 639 | 679 | <?php |
| 640 | - // Smart asset loading (plan-915355). Standalone option — never part | |
| 641 | - // of mxchat_options, so mxchat_sanitize() can't strip it. | |
| 642 | - $smart_asset_loading = get_option('mxchat_smart_asset_loading', 'off'); | |
| 680 | + // Smart asset loading (plan-915355; rebuilt on the house toggle | |
| 681 | + // pattern in plan-64d34f). Standalone option — never part of | |
| 682 | + // mxchat_options, so mxchat_sanitize() can't strip it. | |
| 683 | + mxchat_render_field_wrapper('mxchat_smart_asset_loading', __('Only load chatbot files on pages where the chatbot appears', 'mxchat'), function() use ($admin_instance) { | |
| 684 | + $admin_instance->mxchat_smart_asset_loading_toggle_callback(); | |
| 685 | + }, __('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'), | |
| 686 | + __('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')); | |
| 643 | 687 | ?> |
| 644 | - <div class="mxch-field" style="margin-top: 16px;"> | |
| 645 | - <label class="mxch-toggle"> | |
| 646 | - <input type="checkbox" class="mxch-toggle-input mxchat-autosave-field" id="mxchat_smart_asset_loading" name="mxchat_smart_asset_loading" value="on" <?php checked($smart_asset_loading, 'on'); ?>> | |
| 647 | - <span class="mxch-toggle-switch"></span> | |
| 648 | - <span class="mxch-toggle-label"><?php esc_html_e('Only load chatbot files on pages where the chatbot appears', 'mxchat'); ?></span> | |
| 649 | - </label> | |
| 650 | - <p class="mxch-field-description"><?php esc_html_e('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'); ?></p> | |
| 651 | - <p class="mxch-field-hint"><?php esc_html_e('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'); ?></p> | |
| 652 | - </div> | |
| 653 | 688 | |
| 654 | 689 | <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;"> |
| 655 | 690 | <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> |
| 656 | 691 | <div> |
| @@ -662,8 +697,21 @@ | ||
| 662 | 697 | <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> |
| 663 | 698 | </ul> |
| 664 | 699 | </div> |
| 665 | 700 | </div> |
| 701 | + | |
| 702 | + <?php | |
| 703 | + // Plan b76ed6 (Support Ticket 468): the floating launcher is rendered hidden | |
| 704 | + // and revealed by chat-script.js, so a cache plugin's "Delay JavaScript" | |
| 705 | + // that holds the script until the visitor interacts shows no chatbot at all. | |
| 706 | + ?> | |
| 707 | + <div class="mxch-notice mxch-notice-warning" style="margin-top: 16px;"> | |
| 708 | + <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> | |
| 709 | + <div> | |
| 710 | + <strong><?php esc_html_e('Using Delay JavaScript in a cache or performance plugin?', 'mxchat'); ?></strong> | |
| 711 | + <?php esc_html_e('Leave chat-script.js out of the delay (FlyingPress, WP Rocket, LiteSpeed Cache and Perfmatters all have an exclusion list). The chat launcher stays hidden until that script runs, so a page that holds it back until the visitor interacts shows no chatbot. If you want the script delayed, pick a strategy above instead: MxChat then loads it on interaction or after a short wait.', 'mxchat'); ?> | |
| 712 | + </div> | |
| 713 | + </div> | |
| 666 | 714 | </div> |
| 667 | 715 | </div> |
| 668 | 716 | |
| 669 | 717 | <!-- Page Cache Compatibility Card --> |
| @@ -673,9 +721,19 @@ | ||
| 673 | 721 | <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> |
| 674 | 722 | <?php esc_html_e('Page Cache Compatibility', 'mxchat'); ?> |
| 675 | 723 | </h3> |
| 676 | 724 | </div> |
| 677 | - <div class="mxch-card-body"> | |
| 725 | + <div class="mxch-card-body mxchat-autosave-section"> | |
| 726 | + <?php | |
| 727 | + // Page-cache purge on settings save (plan b76ed6, Support Ticket 468). | |
| 728 | + // Standalone option, default ON — never part of mxchat_options, so | |
| 729 | + // mxchat_sanitize() cannot strip it. Read by MxChat_Cache_Purge. | |
| 730 | + mxchat_render_field_wrapper('mxchat_cache_purge_enabled', __('Clear page cache when MxChat settings change', 'mxchat'), function() use ($admin_instance) { | |
| 731 | + $admin_instance->mxchat_cache_purge_toggle_callback(); | |
| 732 | + }, __('On, MxChat clears the page caches it can reach (WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, FlyingPress) after its settings are saved, at most once every 30 seconds, so visitors do not keep seeing the old chatbot. Off, nothing is cleared: clear your page cache yourself after changing the chatbot. Turn it off on a large site where every save would throw away the whole cache.', 'mxchat'), | |
| 733 | + __('Developers can narrow which settings trigger the clear with the mxchat_cache_purge_watched_options filter.', 'mxchat')); | |
| 734 | + ?> | |
| 735 | + | |
| 678 | 736 | <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> |
| 679 | 737 | |
| 680 | 738 | <?php |
| 681 | 739 | $mxch_cache_rows = array( |
| @@ -769,8 +827,15 @@ | ||
| 769 | 827 | <?php esc_html_e('Debug Mode', 'mxchat'); ?> |
| 770 | 828 | </h3> |
| 771 | 829 | </div> |
| 772 | 830 | <div class="mxch-card-body"> |
| 831 | + <?php // Deliberate exception to the house .toggle-switch pattern | |
| 832 | + // (audited in plan-64d34f): this card-body is NOT an | |
| 833 | + // autosave section — the toggle saves through its own | |
| 834 | + // dedicated handler (mxchat_toggle_debug_mode, wired at | |
| 835 | + // mxchat-admin.js #mxchat_debug_mode) which appends its own | |
| 836 | + // save indicator inside this label. Converting the markup | |
| 837 | + // would orphan that indicator without touching the JS. ?> | |
| 773 | 838 | <div class="mxch-field"> |
| 774 | 839 | <label class="mxch-toggle"> |
| 775 | 840 | <input type="checkbox" class="mxch-toggle-input" id="mxchat_debug_mode" name="mxchat_options[debug_mode]" value="on" <?php checked($debug_active); ?>> |
| 776 | 841 | <span class="mxch-toggle-switch"></span> |
| @@ -1088,8 +1153,69 @@ | ||
| 1088 | 1153 | </div> |
| 1089 | 1154 | </div> |
| 1090 | 1155 | |
| 1091 | 1156 | <!-- ======================================== |
| 1157 | + INTEGRATIONS - WEBHOOK HANDOFF (plan d88e22) | |
| 1158 | + ======================================== --> | |
| 1159 | + <div id="integrations-webhook" class="mxch-section"> | |
| 1160 | + <div class="mxch-content-header"> | |
| 1161 | + <h1 class="mxch-content-title"><?php esc_html_e('Webhook', 'mxchat'); ?></h1> | |
| 1162 | + <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> | |
| 1163 | + </div> | |
| 1164 | + | |
| 1165 | + <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;"> | |
| 1166 | + <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> | |
| 1167 | + <div> | |
| 1168 | + <?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'); ?> | |
| 1169 | + </div> | |
| 1170 | + </div> | |
| 1171 | + | |
| 1172 | + <div class="mxch-card"> | |
| 1173 | + <div class="mxch-card-body mxchat-autosave-section"> | |
| 1174 | + <table class="form-table"> | |
| 1175 | + <?php do_settings_fields('mxchat-embed', 'mxchat_webhook_handoff_section'); ?> | |
| 1176 | + </table> | |
| 1177 | + </div> | |
| 1178 | + </div> | |
| 1179 | + | |
| 1180 | + <div class="mxch-card" style="margin-top: 24px;"> | |
| 1181 | + <div class="mxch-card-header"> | |
| 1182 | + <h3 class="mxch-card-title"> | |
| 1183 | + <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> | |
| 1184 | + <?php esc_html_e('Payload Reference', 'mxchat'); ?> | |
| 1185 | + </h3> | |
| 1186 | + </div> | |
| 1187 | + <div class="mxch-card-body"> | |
| 1188 | + <p class="mxch-field-description" style="margin-bottom: 12px;"> | |
| 1189 | + <?php esc_html_e('Each handoff arrives at your URL as an HTTPS POST with Content-Type application/json:', 'mxchat'); ?> | |
| 1190 | + </p> | |
| 1191 | + <pre style="background: #f8f9fa; padding: 16px; border-radius: 8px; font-size: 12px; overflow-x: auto; margin: 0 0 16px;"><?php echo esc_html('{ | |
| 1192 | + "event": "live_agent_handoff", | |
| 1193 | + "site": { "name": "Your Site", "url": "https://your-site.com" }, | |
| 1194 | + "session_id": "mxchat_chat_…", | |
| 1195 | + "user_id": 0, | |
| 1196 | + "visitor": { "name": "Ada", "email": "[email protected]" }, | |
| 1197 | + "current_message": "I need to talk to a human", | |
| 1198 | + "recent_messages": [ | |
| 1199 | + { "role": "user", "content": "…", "timestamp": 1755900000 }, | |
| 1200 | + { "role": "assistant", "content": "…", "timestamp": 1755900012 } | |
| 1201 | + ], | |
| 1202 | + "requested_at": "2026-08-22T14:30:00+00:00" | |
| 1203 | +}'); ?></pre> | |
| 1204 | + <p class="mxch-field-description" style="margin-bottom: 12px;"> | |
| 1205 | + <?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'); ?> | |
| 1206 | + </p> | |
| 1207 | + <div class="mxch-webhook-url-display" style="margin-bottom: 16px;"> | |
| 1208 | + <code>X-MxChat-Signature: sha256=<hex hmac-sha256 of the raw body></code> | |
| 1209 | + </div> | |
| 1210 | + <p class="mxch-field-description"> | |
| 1211 | + <?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'); ?> | |
| 1212 | + </p> | |
| 1213 | + </div> | |
| 1214 | + </div> | |
| 1215 | + </div> | |
| 1216 | + | |
| 1217 | + <!-- ======================================== | |
| 1092 | 1218 | TUTORIALS |
| 1093 | 1219 | ======================================== --> |
| 1094 | 1220 | <div id="tutorials" class="mxch-section"> |
| 1095 | 1221 | <div class="mxch-content-header"> |
| @@ -1346,145 +1472,13 @@ | ||
| 1346 | 1472 | </div> |
| 1347 | 1473 | |
| 1348 | 1474 | <script> |
| 1349 | 1475 | document.addEventListener('DOMContentLoaded', function() { |
| 1350 | - // Sidebar navigation | |
| 1351 | - const navLinks = document.querySelectorAll('.mxch-nav-link, .mxch-nav-sub-link'); | |
| 1352 | - const sections = document.querySelectorAll('.mxch-section'); | |
| 1353 | - const navItems = document.querySelectorAll('.mxch-nav-item'); | |
| 1476 | + // Sidebar/tab navigation, accordion groups, ?tab=/#hash deep-linking | |
| 1477 | + // and the mobile menu all live in the shared shell script | |
| 1478 | + // (js/admin-sidebar.js) — consolidated by plan c192a4. Only the | |
| 1479 | + // page-local widgets below remain inline. | |
| 1354 | 1480 | |
| 1355 | - function showSection(target) { | |
| 1356 | - // Show target section | |
| 1357 | - sections.forEach(section => { | |
| 1358 | - section.classList.remove('active'); | |
| 1359 | - if (section.id === target) { | |
| 1360 | - section.classList.add('active'); | |
| 1361 | - } | |
| 1362 | - }); | |
| 1363 | - | |
| 1364 | - // Scroll content area to top | |
| 1365 | - const contentArea = document.querySelector('.mxch-content'); | |
| 1366 | - if (contentArea) { | |
| 1367 | - contentArea.scrollTop = 0; | |
| 1368 | - } | |
| 1369 | - } | |
| 1370 | - | |
| 1371 | - function setActiveNav(clickedLink) { | |
| 1372 | - // Remove active from all links | |
| 1373 | - navLinks.forEach(l => l.classList.remove('active')); | |
| 1374 | - | |
| 1375 | - // Add active to clicked link | |
| 1376 | - clickedLink.classList.add('active'); | |
| 1377 | - | |
| 1378 | - // If clicking a sub-link, also highlight parent | |
| 1379 | - if (clickedLink.classList.contains('mxch-nav-sub-link')) { | |
| 1380 | - const parent = clickedLink.closest('.mxch-nav-item'); | |
| 1381 | - if (parent) { | |
| 1382 | - parent.querySelector('.mxch-nav-link').classList.add('active'); | |
| 1383 | - } | |
| 1384 | - } | |
| 1385 | - } | |
| 1386 | - | |
| 1387 | - navLinks.forEach(link => { | |
| 1388 | - link.addEventListener('click', function(e) { | |
| 1389 | - e.preventDefault(); | |
| 1390 | - e.stopPropagation(); | |
| 1391 | - const target = this.dataset.target; | |
| 1392 | - const parentItem = this.closest('.mxch-nav-item'); | |
| 1393 | - const hasSubmenu = parentItem && parentItem.querySelector('.mxch-nav-sub'); | |
| 1394 | - | |
| 1395 | - // If this is a parent nav link WITH children (expandable menu) | |
| 1396 | - if (this.classList.contains('mxch-nav-link') && hasSubmenu) { | |
| 1397 | - const wasExpanded = parentItem.classList.contains('expanded'); | |
| 1398 | - | |
| 1399 | - // Collapse all other expandable items | |
| 1400 | - navItems.forEach(item => { | |
| 1401 | - if (item !== parentItem && item.querySelector('.mxch-nav-sub')) { | |
| 1402 | - item.classList.remove('expanded'); | |
| 1403 | - } | |
| 1404 | - }); | |
| 1405 | - | |
| 1406 | - // Toggle this item | |
| 1407 | - parentItem.classList.toggle('expanded'); | |
| 1408 | - | |
| 1409 | - // If expanding, show the first sub-item's content and mark it active | |
| 1410 | - if (!wasExpanded) { | |
| 1411 | - const firstSubLink = parentItem.querySelector('.mxch-nav-sub-link'); | |
| 1412 | - if (firstSubLink) { | |
| 1413 | - const firstTarget = firstSubLink.dataset.target; | |
| 1414 | - showSection(firstTarget); | |
| 1415 | - setActiveNav(firstSubLink); | |
| 1416 | - // Also mark parent as active | |
| 1417 | - this.classList.add('active'); | |
| 1418 | - history.replaceState(null, null, '#' + firstTarget); | |
| 1419 | - } | |
| 1420 | - } | |
| 1421 | - } | |
| 1422 | - // If this is a nav link WITHOUT children (like API Keys, Tutorials) | |
| 1423 | - else if (this.classList.contains('mxch-nav-link') && !hasSubmenu && target) { | |
| 1424 | - // Collapse all expandable items | |
| 1425 | - navItems.forEach(item => { | |
| 1426 | - if (item.querySelector('.mxch-nav-sub')) { | |
| 1427 | - item.classList.remove('expanded'); | |
| 1428 | - } | |
| 1429 | - }); | |
| 1430 | - | |
| 1431 | - // Show the section | |
| 1432 | - showSection(target); | |
| 1433 | - setActiveNav(this); | |
| 1434 | - history.replaceState(null, null, '#' + target); | |
| 1435 | - } | |
| 1436 | - // If this is a sub-link | |
| 1437 | - else if (this.classList.contains('mxch-nav-sub-link') && target) { | |
| 1438 | - // Ensure parent stays expanded | |
| 1439 | - if (parentItem) { | |
| 1440 | - parentItem.classList.add('expanded'); | |
| 1441 | - } | |
| 1442 | - showSection(target); | |
| 1443 | - setActiveNav(this); | |
| 1444 | - history.replaceState(null, null, '#' + target); | |
| 1445 | - } | |
| 1446 | - }); | |
| 1447 | - }); | |
| 1448 | - | |
| 1449 | - // Handle initial deep-link (?tab=<slug> takes precedence over #hash so the | |
| 1450 | - // Onboarding setup-step CTAs land on the right sub-tab). Whitelist of valid | |
| 1451 | - // section ids must stay in sync with the .mxch-section[id] values above. | |
| 1452 | - const validTabs = [ | |
| 1453 | - 'chatbot-ai-models', 'chatbot-behavior', 'chatbot-display', | |
| 1454 | - 'chatbot-lead-capture', 'chatbot-quick-questions', 'chatbot-rate-limits', | |
| 1455 | - 'api-keys', 'optimization', 'testing', | |
| 1456 | - 'integrations-toolbar', 'integrations-loops', 'integrations-brave', | |
| 1457 | - 'integrations-slack', 'integrations-telegram', | |
| 1458 | - 'tutorials' | |
| 1459 | - ]; | |
| 1460 | - function activateTab(target) { | |
| 1461 | - if (!target) return false; | |
| 1462 | - if (validTabs.indexOf(target) === -1) return false; | |
| 1463 | - const targetLink = document.querySelector('[data-target="' + target + '"]'); | |
| 1464 | - if (!targetLink) return false; | |
| 1465 | - const parentItem = targetLink.closest('.mxch-nav-item'); | |
| 1466 | - if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) { | |
| 1467 | - parentItem.classList.add('expanded'); | |
| 1468 | - } | |
| 1469 | - showSection(target); | |
| 1470 | - setActiveNav(targetLink); | |
| 1471 | - return true; | |
| 1472 | - } | |
| 1473 | - const urlParams = new URLSearchParams(window.location.search); | |
| 1474 | - const tabParam = urlParams.get('tab'); | |
| 1475 | - let tabActivated = false; | |
| 1476 | - if (tabParam) { | |
| 1477 | - tabActivated = activateTab(tabParam); | |
| 1478 | - // Invalid ?tab=… silently falls through to default (#hash or AI Models). | |
| 1479 | - } | |
| 1480 | - if (!tabActivated) { | |
| 1481 | - const hash = window.location.hash.slice(1); | |
| 1482 | - if (hash) { | |
| 1483 | - activateTab(hash); | |
| 1484 | - } | |
| 1485 | - } | |
| 1486 | - | |
| 1487 | 1481 | // Rate limit accordion |
| 1488 | 1482 | const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header'); |
| 1489 | 1483 | rateLimitHeaders.forEach(header => { |
| 1490 | 1484 | header.addEventListener('click', function(e) { |
| @@ -1511,102 +1505,8 @@ | ||
| 1511 | 1505 | }; |
| 1512 | 1506 | sel.addEventListener('change', sync); |
| 1513 | 1507 | sync(); |
| 1514 | 1508 | }); |
| 1515 | - | |
| 1516 | - // ===================================================== | |
| 1517 | - // Mobile Menu Functionality | |
| 1518 | - // ===================================================== | |
| 1519 | - const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn'); | |
| 1520 | - const mobileMenuClose = document.querySelector('.mxch-mobile-menu-close'); | |
| 1521 | - const mobileMenu = document.querySelector('.mxch-mobile-menu'); | |
| 1522 | - const mobileOverlay = document.querySelector('.mxch-mobile-overlay'); | |
| 1523 | - const mobileNavLinks = document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link'); | |
| 1524 | - | |
| 1525 | - function openMobileMenu() { | |
| 1526 | - mobileMenu.classList.add('open'); | |
| 1527 | - mobileOverlay.classList.add('open'); | |
| 1528 | - document.body.style.overflow = 'hidden'; | |
| 1529 | - } | |
| 1530 | - | |
| 1531 | - function closeMobileMenu() { | |
| 1532 | - mobileMenu.classList.remove('open'); | |
| 1533 | - mobileOverlay.classList.remove('open'); | |
| 1534 | - document.body.style.overflow = ''; | |
| 1535 | - } | |
| 1536 | - | |
| 1537 | - if (mobileMenuBtn) { | |
| 1538 | - mobileMenuBtn.addEventListener('click', openMobileMenu); | |
| 1539 | - } | |
| 1540 | - | |
| 1541 | - if (mobileMenuClose) { | |
| 1542 | - mobileMenuClose.addEventListener('click', closeMobileMenu); | |
| 1543 | - } | |
| 1544 | - | |
| 1545 | - if (mobileOverlay) { | |
| 1546 | - mobileOverlay.addEventListener('click', closeMobileMenu); | |
| 1547 | - } | |
| 1548 | - | |
| 1549 | - // Mobile navigation links | |
| 1550 | - mobileNavLinks.forEach(link => { | |
| 1551 | - link.addEventListener('click', function(e) { | |
| 1552 | - e.preventDefault(); | |
| 1553 | - e.stopPropagation(); | |
| 1554 | - | |
| 1555 | - const target = this.dataset.target; | |
| 1556 | - const parentId = this.dataset.parent; | |
| 1557 | - | |
| 1558 | - // If this is an expandable parent link | |
| 1559 | - if (parentId && !target) { | |
| 1560 | - const subNav = document.querySelector('.mxch-mobile-nav-sub[data-parent="' + parentId + '"]'); | |
| 1561 | - if (subNav) { | |
| 1562 | - const isExpanded = subNav.classList.contains('expanded'); | |
| 1563 | - // Collapse all sub navs | |
| 1564 | - document.querySelectorAll('.mxch-mobile-nav-sub').forEach(nav => { | |
| 1565 | - nav.classList.remove('expanded'); | |
| 1566 | - }); | |
| 1567 | - document.querySelectorAll('.mxch-mobile-nav-link').forEach(l => { | |
| 1568 | - l.classList.remove('expanded'); | |
| 1569 | - }); | |
| 1570 | - // Toggle this one | |
| 1571 | - if (!isExpanded) { | |
| 1572 | - subNav.classList.add('expanded'); | |
| 1573 | - this.classList.add('expanded'); | |
| 1574 | - } | |
| 1575 | - } | |
| 1576 | - } | |
| 1577 | - // If this is a direct link or sub-link with a target | |
| 1578 | - else if (target) { | |
| 1579 | - // Update mobile nav active state | |
| 1580 | - document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link').forEach(l => { | |
| 1581 | - l.classList.remove('active'); | |
| 1582 | - }); | |
| 1583 | - this.classList.add('active'); | |
| 1584 | - | |
| 1585 | - // Also update desktop sidebar nav | |
| 1586 | - const desktopLink = document.querySelector('.mxch-sidebar [data-target="' + target + '"]'); | |
| 1587 | - if (desktopLink) { | |
| 1588 | - setActiveNav(desktopLink); | |
| 1589 | - const parentItem = desktopLink.closest('.mxch-nav-item'); | |
| 1590 | - if (parentItem && desktopLink.classList.contains('mxch-nav-sub-link')) { | |
| 1591 | - parentItem.classList.add('expanded'); | |
| 1592 | - } | |
| 1593 | - } | |
| 1594 | - | |
| 1595 | - // Show section and close menu | |
| 1596 | - showSection(target); | |
| 1597 | - history.replaceState(null, null, '#' + target); | |
| 1598 | - closeMobileMenu(); | |
| 1599 | - } | |
| 1600 | - }); | |
| 1601 | - }); | |
| 1602 | - | |
| 1603 | - // Close mobile menu on escape key | |
| 1604 | - document.addEventListener('keydown', function(e) { | |
| 1605 | - if (e.key === 'Escape' && mobileMenu && mobileMenu.classList.contains('open')) { | |
| 1606 | - closeMobileMenu(); | |
| 1607 | - } | |
| 1608 | - }); | |
| 1609 | 1509 | }); |
| 1610 | 1510 | </script> |
| 1611 | 1511 | <?php |
| 1612 | 1512 | } |
| @@ -1612,10 +1512,14 @@ | ||
| 1612 | 1512 | } |
| 1613 | 1513 | |
| 1614 | 1514 | /** |
| 1615 | 1515 | * Helper function to render a field with consistent wrapper |
| 1516 | + * | |
| 1517 | + * $hint renders as a .mxch-field-hint line under the description — the | |
| 1518 | + * softer "caveats / fine print" slot (added for plan-64d34f so hint-bearing | |
| 1519 | + * fields don't have to hand-roll the wrapper markup). | |
| 1616 | 1520 | */ |
| 1617 | -function mxchat_render_field_wrapper($id, $label, $callback, $description = '') { | |
| 1521 | +function mxchat_render_field_wrapper($id, $label, $callback, $description = '', $hint = '') { | |
| 1618 | 1522 | ?> |
| 1619 | 1523 | <div class="mxch-field"> |
| 1620 | 1524 | <label class="mxch-field-label"><?php echo esc_html($label); ?></label> |
| 1621 | 1525 | <div class="mxch-field-control"> |
| @@ -1622,8 +1526,11 @@ | ||
| 1622 | 1526 | <?php $callback(); ?> |
| 1623 | 1527 | </div> |
| 1624 | 1528 | <?php if ($description): ?> |
| 1625 | 1529 | <p class="mxch-field-description"><?php echo esc_html($description); ?></p> |
| 1530 | + <?php endif; ?> | |
| 1531 | + <?php if ($hint): ?> | |
| 1532 | + <p class="mxch-field-hint"><?php echo esc_html($hint); ?></p> | |
| 1626 | 1533 | <?php endif; ?> |
| 1627 | 1534 | </div> |
| 1628 | 1535 | <?php |
| 1629 | 1536 | } |
