PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.2.23
MxChat – AI Chatbot & Content Generation for WordPress v3.2.23
3.2.25 3.2.24 3.2.23 3.2.22 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 All 156 releases
← All changes | includes/admin-settings-page.php +108 -230 3.2.17 → 3.2.23 View file →
@@ -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
@@ -326,8 +338,14 @@
326 338 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
327 339 $admin_instance->mxchat_citation_links_toggle_callback();
328 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'));
329 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 +
330 348 // Satisfaction Rating Prompt
331 349 // The toggle callback inline-renders the 5 customization
332 350 // fields inside a single sub-options wrapper (plan-29caac).
333 351 // No separate customization group needed — the wrapper handles
@@ -479,8 +497,33 @@
479 497 // Name Placeholder
480 498 mxchat_render_field_wrapper('name_placeholder', __('Name Field Placeholder', 'mxchat'), function() use ($admin_instance) {
481 499 $admin_instance->name_field_placeholder_callback();
482 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'));
483 526 ?>
484 527 </div>
485 528 </div>
486 529
@@ -1087,8 +1130,69 @@
1087 1130 </div>
1088 1131 </div>
1089 1132
1090 1133 <!-- ========================================
1134 + INTEGRATIONS - WEBHOOK HANDOFF (plan d88e22)
1135 + ======================================== -->
1136 + <div id="integrations-webhook" class="mxch-section">
1137 + <div class="mxch-content-header">
1138 + <h1 class="mxch-content-title"><?php esc_html_e('Webhook', 'mxchat'); ?></h1>
1139 + <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>
1140 + </div>
1141 +
1142 + <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
1143 + <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>
1144 + <div>
1145 + <?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'); ?>
1146 + </div>
1147 + </div>
1148 +
1149 + <div class="mxch-card">
1150 + <div class="mxch-card-body mxchat-autosave-section">
1151 + <table class="form-table">
1152 + <?php do_settings_fields('mxchat-embed', 'mxchat_webhook_handoff_section'); ?>
1153 + </table>
1154 + </div>
1155 + </div>
1156 +
1157 + <div class="mxch-card" style="margin-top: 24px;">
1158 + <div class="mxch-card-header">
1159 + <h3 class="mxch-card-title">
1160 + <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>
1161 + <?php esc_html_e('Payload Reference', 'mxchat'); ?>
1162 + </h3>
1163 + </div>
1164 + <div class="mxch-card-body">
1165 + <p class="mxch-field-description" style="margin-bottom: 12px;">
1166 + <?php esc_html_e('Each handoff arrives at your URL as an HTTPS POST with Content-Type application/json:', 'mxchat'); ?>
1167 + </p>
1168 + <pre style="background: #f8f9fa; padding: 16px; border-radius: 8px; font-size: 12px; overflow-x: auto; margin: 0 0 16px;"><?php echo esc_html('{
1169 + "event": "live_agent_handoff",
1170 + "site": { "name": "Your Site", "url": "https://your-site.com" },
1171 + "session_id": "mxchat_chat_…",
1172 + "user_id": 0,
1173 + "visitor": { "name": "Ada", "email": "[email protected]" },
1174 + "current_message": "I need to talk to a human",
1175 + "recent_messages": [
1176 + { "role": "user", "content": "…", "timestamp": 1755900000 },
1177 + { "role": "assistant", "content": "…", "timestamp": 1755900012 }
1178 + ],
1179 + "requested_at": "2026-08-22T14:30:00+00:00"
1180 +}'); ?></pre>
1181 + <p class="mxch-field-description" style="margin-bottom: 12px;">
1182 + <?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'); ?>
1183 + </p>
1184 + <div class="mxch-webhook-url-display" style="margin-bottom: 16px;">
1185 + <code>X-MxChat-Signature: sha256=&lt;hex hmac-sha256 of the raw body&gt;</code>
1186 + </div>
1187 + <p class="mxch-field-description">
1188 + <?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'); ?>
1189 + </p>
1190 + </div>
1191 + </div>
1192 + </div>
1193 +
1194 + <!-- ========================================
1091 1195 TUTORIALS
1092 1196 ======================================== -->
1093 1197 <div id="tutorials" class="mxch-section">
1094 1198 <div class="mxch-content-header">
@@ -1345,145 +1449,13 @@
1345 1449 </div>
1346 1450
1347 1451 <script>
1348 1452 document.addEventListener('DOMContentLoaded', function() {
1349 - // Sidebar navigation
1350 - const navLinks = document.querySelectorAll('.mxch-nav-link, .mxch-nav-sub-link');
1351 - const sections = document.querySelectorAll('.mxch-section');
1352 - const navItems = document.querySelectorAll('.mxch-nav-item');
1453 + // Sidebar/tab navigation, accordion groups, ?tab=/#hash deep-linking
1454 + // and the mobile menu all live in the shared shell script
1455 + // (js/admin-sidebar.js) — consolidated by plan c192a4. Only the
1456 + // page-local widgets below remain inline.
1353 1457
1354 - function showSection(target) {
1355 - // Show target section
1356 - sections.forEach(section => {
1357 - section.classList.remove('active');
1358 - if (section.id === target) {
1359 - section.classList.add('active');
1360 - }
1361 - });
1362 -
1363 - // Scroll content area to top
1364 - const contentArea = document.querySelector('.mxch-content');
1365 - if (contentArea) {
1366 - contentArea.scrollTop = 0;
1367 - }
1368 - }
1369 -
1370 - function setActiveNav(clickedLink) {
1371 - // Remove active from all links
1372 - navLinks.forEach(l => l.classList.remove('active'));
1373 -
1374 - // Add active to clicked link
1375 - clickedLink.classList.add('active');
1376 -
1377 - // If clicking a sub-link, also highlight parent
1378 - if (clickedLink.classList.contains('mxch-nav-sub-link')) {
1379 - const parent = clickedLink.closest('.mxch-nav-item');
1380 - if (parent) {
1381 - parent.querySelector('.mxch-nav-link').classList.add('active');
1382 - }
1383 - }
1384 - }
1385 -
1386 - navLinks.forEach(link => {
1387 - link.addEventListener('click', function(e) {
1388 - e.preventDefault();
1389 - e.stopPropagation();
1390 - const target = this.dataset.target;
1391 - const parentItem = this.closest('.mxch-nav-item');
1392 - const hasSubmenu = parentItem && parentItem.querySelector('.mxch-nav-sub');
1393 -
1394 - // If this is a parent nav link WITH children (expandable menu)
1395 - if (this.classList.contains('mxch-nav-link') && hasSubmenu) {
1396 - const wasExpanded = parentItem.classList.contains('expanded');
1397 -
1398 - // Collapse all other expandable items
1399 - navItems.forEach(item => {
1400 - if (item !== parentItem && item.querySelector('.mxch-nav-sub')) {
1401 - item.classList.remove('expanded');
1402 - }
1403 - });
1404 -
1405 - // Toggle this item
1406 - parentItem.classList.toggle('expanded');
1407 -
1408 - // If expanding, show the first sub-item's content and mark it active
1409 - if (!wasExpanded) {
1410 - const firstSubLink = parentItem.querySelector('.mxch-nav-sub-link');
1411 - if (firstSubLink) {
1412 - const firstTarget = firstSubLink.dataset.target;
1413 - showSection(firstTarget);
1414 - setActiveNav(firstSubLink);
1415 - // Also mark parent as active
1416 - this.classList.add('active');
1417 - history.replaceState(null, null, '#' + firstTarget);
1418 - }
1419 - }
1420 - }
1421 - // If this is a nav link WITHOUT children (like API Keys, Tutorials)
1422 - else if (this.classList.contains('mxch-nav-link') && !hasSubmenu && target) {
1423 - // Collapse all expandable items
1424 - navItems.forEach(item => {
1425 - if (item.querySelector('.mxch-nav-sub')) {
1426 - item.classList.remove('expanded');
1427 - }
1428 - });
1429 -
1430 - // Show the section
1431 - showSection(target);
1432 - setActiveNav(this);
1433 - history.replaceState(null, null, '#' + target);
1434 - }
1435 - // If this is a sub-link
1436 - else if (this.classList.contains('mxch-nav-sub-link') && target) {
1437 - // Ensure parent stays expanded
1438 - if (parentItem) {
1439 - parentItem.classList.add('expanded');
1440 - }
1441 - showSection(target);
1442 - setActiveNav(this);
1443 - history.replaceState(null, null, '#' + target);
1444 - }
1445 - });
1446 - });
1447 -
1448 - // Handle initial deep-link (?tab=<slug> takes precedence over #hash so the
1449 - // Onboarding setup-step CTAs land on the right sub-tab). Whitelist of valid
1450 - // section ids must stay in sync with the .mxch-section[id] values above.
1451 - const validTabs = [
1452 - 'chatbot-ai-models', 'chatbot-behavior', 'chatbot-display',
1453 - 'chatbot-lead-capture', 'chatbot-quick-questions', 'chatbot-rate-limits',
1454 - 'api-keys', 'optimization', 'testing',
1455 - 'integrations-toolbar', 'integrations-loops', 'integrations-brave',
1456 - 'integrations-slack', 'integrations-telegram',
1457 - 'tutorials'
1458 - ];
1459 - function activateTab(target) {
1460 - if (!target) return false;
1461 - if (validTabs.indexOf(target) === -1) return false;
1462 - const targetLink = document.querySelector('[data-target="' + target + '"]');
1463 - if (!targetLink) return false;
1464 - const parentItem = targetLink.closest('.mxch-nav-item');
1465 - if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1466 - parentItem.classList.add('expanded');
1467 - }
1468 - showSection(target);
1469 - setActiveNav(targetLink);
1470 - return true;
1471 - }
1472 - const urlParams = new URLSearchParams(window.location.search);
1473 - const tabParam = urlParams.get('tab');
1474 - let tabActivated = false;
1475 - if (tabParam) {
1476 - tabActivated = activateTab(tabParam);
1477 - // Invalid ?tab=… silently falls through to default (#hash or AI Models).
1478 - }
1479 - if (!tabActivated) {
1480 - const hash = window.location.hash.slice(1);
1481 - if (hash) {
1482 - activateTab(hash);
1483 - }
1484 - }
1485 -
1486 1458 // Rate limit accordion
1487 1459 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1488 1460 rateLimitHeaders.forEach(header => {
1489 1461 header.addEventListener('click', function(e) {
@@ -1509,102 +1481,8 @@
1509 1481 }
1510 1482 };
1511 1483 sel.addEventListener('change', sync);
1512 1484 sync();
1513 - });
1514 -
1515 - // =====================================================
1516 - // Mobile Menu Functionality
1517 - // =====================================================
1518 - const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
1519 - const mobileMenuClose = document.querySelector('.mxch-mobile-menu-close');
1520 - const mobileMenu = document.querySelector('.mxch-mobile-menu');
1521 - const mobileOverlay = document.querySelector('.mxch-mobile-overlay');
1522 - const mobileNavLinks = document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link');
1523 -
1524 - function openMobileMenu() {
1525 - mobileMenu.classList.add('open');
1526 - mobileOverlay.classList.add('open');
1527 - document.body.style.overflow = 'hidden';
1528 - }
1529 -
1530 - function closeMobileMenu() {
1531 - mobileMenu.classList.remove('open');
1532 - mobileOverlay.classList.remove('open');
1533 - document.body.style.overflow = '';
1534 - }
1535 -
1536 - if (mobileMenuBtn) {
1537 - mobileMenuBtn.addEventListener('click', openMobileMenu);
1538 - }
1539 -
1540 - if (mobileMenuClose) {
1541 - mobileMenuClose.addEventListener('click', closeMobileMenu);
1542 - }
1543 -
1544 - if (mobileOverlay) {
1545 - mobileOverlay.addEventListener('click', closeMobileMenu);
1546 - }
1547 -
1548 - // Mobile navigation links
1549 - mobileNavLinks.forEach(link => {
1550 - link.addEventListener('click', function(e) {
1551 - e.preventDefault();
1552 - e.stopPropagation();
1553 -
1554 - const target = this.dataset.target;
1555 - const parentId = this.dataset.parent;
1556 -
1557 - // If this is an expandable parent link
1558 - if (parentId && !target) {
1559 - const subNav = document.querySelector('.mxch-mobile-nav-sub[data-parent="' + parentId + '"]');
1560 - if (subNav) {
1561 - const isExpanded = subNav.classList.contains('expanded');
1562 - // Collapse all sub navs
1563 - document.querySelectorAll('.mxch-mobile-nav-sub').forEach(nav => {
1564 - nav.classList.remove('expanded');
1565 - });
1566 - document.querySelectorAll('.mxch-mobile-nav-link').forEach(l => {
1567 - l.classList.remove('expanded');
1568 - });
1569 - // Toggle this one
1570 - if (!isExpanded) {
1571 - subNav.classList.add('expanded');
1572 - this.classList.add('expanded');
1573 - }
1574 - }
1575 - }
1576 - // If this is a direct link or sub-link with a target
1577 - else if (target) {
1578 - // Update mobile nav active state
1579 - document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link').forEach(l => {
1580 - l.classList.remove('active');
1581 - });
1582 - this.classList.add('active');
1583 -
1584 - // Also update desktop sidebar nav
1585 - const desktopLink = document.querySelector('.mxch-sidebar [data-target="' + target + '"]');
1586 - if (desktopLink) {
1587 - setActiveNav(desktopLink);
1588 - const parentItem = desktopLink.closest('.mxch-nav-item');
1589 - if (parentItem && desktopLink.classList.contains('mxch-nav-sub-link')) {
1590 - parentItem.classList.add('expanded');
1591 - }
1592 - }
1593 -
1594 - // Show section and close menu
1595 - showSection(target);
1596 - history.replaceState(null, null, '#' + target);
1597 - closeMobileMenu();
1598 - }
1599 - });
1600 - });
1601 -
1602 - // Close mobile menu on escape key
1603 - document.addEventListener('keydown', function(e) {
1604 - if (e.key === 'Escape' && mobileMenu && mobileMenu.classList.contains('open')) {
1605 - closeMobileMenu();
1606 - }
1607 1485 });
1608 1486 });
1609 1487 </script>
1610 1488 <?php