PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / trunk
MxChat – AI Chatbot & Content Generation for WordPress vtrunk
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
mxchat-basic / includes / admin-settings-page.php

admin-settings-page.php in MxChat – AI Chatbot & Content Generation for WordPress trunk, at includes/admin-settings-page.php

1,747 lines 128.5 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 /**
3 * MxChat Admin Settings Page - Redesigned with Sidebar Navigation
4 *
5 * @package MxChat
6 * @since 2.7.0
7 */
8
9 if (!defined('ABSPATH')) {
10 exit;
11 }
12
13 /**
14 * Render the new sidebar-based admin settings page
15 */
16 function mxchat_render_settings_page($admin_instance) {
17 $is_activated = $admin_instance->is_activated();
18 $options = get_option('mxchat_options', array());
19 $plugin_url = plugin_dir_url(dirname(__FILE__));
20 ?>
21 <div class="mxch-admin-wrapper">
22 <!-- Mobile Header -->
23 <header class="mxch-mobile-header">
24 <a href="#" class="mxch-mobile-logo">
25 <div class="mxch-mobile-logo-icon">
26 <img src="<?php echo esc_url($plugin_url . 'images/icon-128x128.png'); ?>" alt="MxChat">
27 </div>
28 <span class="mxch-mobile-logo-text">MxChat</span>
29 </a>
30 <button type="button" class="mxch-mobile-menu-btn" aria-label="<?php esc_attr_e('Open menu', 'mxchat'); ?>">
31 <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"><circle cx="12" cy="12" r="1"/><circle cx="12" cy="5" r="1"/><circle cx="12" cy="19" r="1"/></svg>
32 </button>
33 </header>
34
35 <!-- Mobile Menu Overlay -->
36 <div class="mxch-mobile-overlay"></div>
37
38 <!-- Mobile Menu Modal -->
39 <div class="mxch-mobile-menu">
40 <div class="mxch-mobile-menu-header">
41 <span class="mxch-mobile-menu-title"><?php esc_html_e('Settings', 'mxchat'); ?></span>
42 <button type="button" class="mxch-mobile-menu-close" aria-label="<?php esc_attr_e('Close menu', 'mxchat'); ?>">
43 <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"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
44 </button>
45 </div>
46 <nav class="mxch-mobile-menu-nav">
47 <!-- Configuration Section -->
48 <div class="mxch-mobile-nav-section">
49 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Configuration', 'mxchat'); ?></div>
50 <button class="mxch-mobile-nav-link" data-parent="chatbot">
51 <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="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/></svg>
52 <span><?php esc_html_e('Chatbot', 'mxchat'); ?></span>
53 <svg class="mxch-mobile-nav-arrow" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="9 18 15 12 9 6"></polyline></svg>
54 </button>
55 <div class="mxch-mobile-nav-sub" data-parent="chatbot">
56 <button class="mxch-mobile-nav-sub-link active" data-target="chatbot-ai-models"><?php esc_html_e('AI Models', 'mxchat'); ?></button>
57 <button class="mxch-mobile-nav-sub-link" data-target="chatbot-behavior"><?php esc_html_e('Behavior', 'mxchat'); ?></button>
58 <button class="mxch-mobile-nav-sub-link" data-target="chatbot-display"><?php esc_html_e('Display', 'mxchat'); ?></button>
59 <button class="mxch-mobile-nav-sub-link" data-target="chatbot-lead-capture"><?php esc_html_e('Lead Capture', 'mxchat'); ?></button>
60 <button class="mxch-mobile-nav-sub-link" data-target="chatbot-quick-questions"><?php esc_html_e('Quick Questions', 'mxchat'); ?></button>
61 <button class="mxch-mobile-nav-sub-link" data-target="chatbot-rate-limits"><?php esc_html_e('Rate Limits', 'mxchat'); ?></button>
62 </div>
63 <button class="mxch-mobile-nav-link" data-target="api-keys">
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 <span><?php esc_html_e('API Keys', 'mxchat'); ?></span>
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 </div>
76 <!-- Integrations Section -->
77 <div class="mxch-mobile-nav-section">
78 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Integrations', 'mxchat'); ?></div>
79 <button class="mxch-mobile-nav-link" data-parent="integrations">
80 <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="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>
81 <span><?php esc_html_e('Integrations', 'mxchat'); ?></span>
82 <svg class="mxch-mobile-nav-arrow" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="9 18 15 12 9 6"></polyline></svg>
83 </button>
84 <div class="mxch-mobile-nav-sub" data-parent="integrations">
85 <button class="mxch-mobile-nav-sub-link" data-target="integrations-toolbar"><?php esc_html_e('Toolbar', 'mxchat'); ?></button>
86 <button class="mxch-mobile-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button>
87 <button class="mxch-mobile-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button>
88 <button class="mxch-mobile-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button>
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>
91 </div>
92 </div>
93 <!-- Resources Section -->
94 <div class="mxch-mobile-nav-section">
95 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Resources', 'mxchat'); ?></div>
96 <button class="mxch-mobile-nav-link" data-target="tutorials">
97 <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"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
98 <span><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
99 </button>
100 </div>
101 <?php if (!$is_activated): ?>
102 <div class="mxch-mobile-menu-footer">
103 <a href="https://mxchat.ai/" target="_blank" class="mxch-mobile-upgrade-btn">
104 <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="M6 9H4.5a2.5 2.5 0 0 1 0-5H6"/><path d="M18 9h1.5a2.5 2.5 0 0 0 0-5H18"/><path d="M4 22h16"/><path d="M10 14.66V17c0 .55-.47.98-.97 1.21C7.85 18.75 7 20.24 7 22"/><path d="M14 14.66V17c0 .55.47.98.97 1.21C16.15 18.75 17 20.24 17 22"/><path d="M18 2H6v7a6 6 0 0 0 12 0V2Z"/></svg>
105 <?php esc_html_e('Upgrade to Pro', 'mxchat'); ?>
106 </a>
107 </div>
108 <?php endif; ?>
109 </nav>
110 </div>
111
112 <!-- Sidebar Navigation -->
113 <aside class="mxch-sidebar">
114 <div class="mxch-sidebar-header">
115 <a href="#" class="mxch-sidebar-logo">
116 <div class="mxch-sidebar-logo-icon">
117 <img src="<?php echo esc_url($plugin_url . 'images/icon-128x128.png'); ?>" alt="MxChat">
118 </div>
119 <span class="mxch-sidebar-logo-text">MxChat</span>
120 <span class="mxch-sidebar-version">v<?php echo esc_html(MXCHAT_VERSION ?? '2.7.0'); ?></span>
121 </a>
122 </div>
123
124 <nav class="mxch-sidebar-nav">
125 <!-- Chatbot Section -->
126 <div class="mxch-nav-section">
127 <div class="mxch-nav-section-title"><?php esc_html_e('Configuration', 'mxchat'); ?></div>
128
129 <div class="mxch-nav-item expanded" data-section="chatbot">
130 <button class="mxch-nav-link active">
131 <span class="mxch-nav-link-icon">
132 <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="M12 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/></svg>
133 </span>
134 <span class="mxch-nav-link-text"><?php esc_html_e('Chatbot', 'mxchat'); ?></span>
135 <svg class="mxch-nav-link-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="9 18 15 12 9 6"></polyline></svg>
136 </button>
137 <div class="mxch-nav-sub">
138 <button class="mxch-nav-sub-link active" data-target="chatbot-ai-models"><?php esc_html_e('AI Models', 'mxchat'); ?></button>
139 <button class="mxch-nav-sub-link" data-target="chatbot-behavior"><?php esc_html_e('Behavior', 'mxchat'); ?></button>
140 <button class="mxch-nav-sub-link" data-target="chatbot-display"><?php esc_html_e('Display', 'mxchat'); ?></button>
141 <button class="mxch-nav-sub-link" data-target="chatbot-lead-capture"><?php esc_html_e('Lead Capture', 'mxchat'); ?></button>
142 <button class="mxch-nav-sub-link" data-target="chatbot-quick-questions"><?php esc_html_e('Quick Questions', 'mxchat'); ?></button>
143 <button class="mxch-nav-sub-link" data-target="chatbot-rate-limits"><?php esc_html_e('Rate Limits', 'mxchat'); ?></button>
144 </div>
145 </div>
146
147 <div class="mxch-nav-item" data-section="api-keys">
148 <button class="mxch-nav-link" data-target="api-keys">
149 <span class="mxch-nav-link-icon">
150 <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 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>
151 </span>
152 <span class="mxch-nav-link-text"><?php esc_html_e('API Keys', 'mxchat'); ?></span>
153 </button>
154 </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 </div>
174
175 <!-- Integrations Section -->
176 <div class="mxch-nav-section">
177 <div class="mxch-nav-section-title"><?php esc_html_e('Integrations', 'mxchat'); ?></div>
178
179 <div class="mxch-nav-item" data-section="integrations">
180 <button class="mxch-nav-link">
181 <span class="mxch-nav-link-icon">
182 <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="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>
183 </span>
184 <span class="mxch-nav-link-text"><?php esc_html_e('Integrations', 'mxchat'); ?></span>
185 <svg class="mxch-nav-link-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="9 18 15 12 9 6"></polyline></svg>
186 </button>
187 <div class="mxch-nav-sub">
188 <button class="mxch-nav-sub-link" data-target="integrations-toolbar"><?php esc_html_e('Toolbar', 'mxchat'); ?></button>
189 <button class="mxch-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button>
190 <button class="mxch-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button>
191 <button class="mxch-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button>
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>
194 </div>
195 </div>
196 </div>
197
198 <!-- Resources Section -->
199 <div class="mxch-nav-section">
200 <div class="mxch-nav-section-title"><?php esc_html_e('Resources', 'mxchat'); ?></div>
201
202 <div class="mxch-nav-item" data-section="tutorials">
203 <button class="mxch-nav-link" data-target="tutorials">
204 <span class="mxch-nav-link-icon">
205 <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"><polygon points="23 7 16 12 23 17 23 7"/><rect x="1" y="5" width="15" height="14" rx="2" ry="2"/></svg>
206 </span>
207 <span class="mxch-nav-link-text"><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
208 </button>
209 </div>
210 </div>
211
212 </nav>
213
214 <?php if (!$is_activated): ?>
215 <div class="mxch-sidebar-footer">
216 <a href="https://mxchat.ai/" target="_blank" class="mxch-sidebar-upgrade-v2">
217 <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"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
218 <?php esc_html_e('Pro Upgrade', 'mxchat'); ?>
219 </a>
220 </div>
221 <?php endif; ?>
222 </aside>
223
224 <!-- Main Content Area -->
225 <main class="mxch-content">
226 <?php if (!$is_activated): ?>
227 <div class="mxch-pro-banner">
228 <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>
231 </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>
233 </div>
234 <?php endif; ?>
235
236 <?php
237 // Show theme migration notice for Pro users
238 $admin_instance->show_theme_migration_banner();
239 ?>
240
241 <!-- ========================================
242 CHATBOT - AI MODELS
243 ======================================== -->
244 <div id="chatbot-ai-models" class="mxch-section active">
245 <div class="mxch-content-header">
246 <h1 class="mxch-content-title"><?php esc_html_e('AI Models', 'mxchat'); ?></h1>
247 <p class="mxch-content-subtitle"><?php esc_html_e('Configure the AI models your chatbot will use for conversations and embeddings.', 'mxchat'); ?></p>
248 </div>
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
260 <div class="mxch-card">
261 <div class="mxch-card-body mxchat-autosave-section">
262 <?php
263 // Chat Model
264 mxchat_render_field_wrapper('model', __('Chat Model', 'mxchat'), function() use ($admin_instance) {
265 $admin_instance->mxchat_model_callback();
266 }, __('Select the AI model your chatbot will use for conversations.', 'mxchat'));
267
268 // Embedding Model
269 mxchat_render_field_wrapper('embedding_model', __('Embedding Model', 'mxchat'), function() use ($admin_instance) {
270 $admin_instance->embedding_model_callback();
271 }, __('Vector embedding model for knowledge base matching. Changing models requires reconfiguring knowledge data.', 'mxchat'));
272
273 // Enable Streaming
274 mxchat_render_field_wrapper('enable_streaming', __('Enable Streaming', 'mxchat'), function() use ($admin_instance) {
275 $admin_instance->enable_streaming_toggle_callback();
276 }, __('Enable real-time streaming responses for supported models (OpenAI, Claude, DeepSeek, Grok).', 'mxchat'));
277
278 // Enable Web Search (OpenAI & Gemini)
279 mxchat_render_field_wrapper('enable_web_search', __('Enable Web Search', 'mxchat'), function() use ($admin_instance) {
280 $admin_instance->enable_web_search_toggle_callback();
281 }, __('Allow the chatbot to search the web for current information (OpenAI and Gemini models).', 'mxchat'));
282 ?>
283 </div>
284 </div>
285 </div>
286
287 <!-- ========================================
288 CHATBOT - BEHAVIOR
289 ======================================== -->
290 <div id="chatbot-behavior" class="mxch-section">
291 <div class="mxch-content-header">
292 <h1 class="mxch-content-title"><?php esc_html_e('Behavior', 'mxchat'); ?></h1>
293 <p class="mxch-content-subtitle"><?php esc_html_e('Control how your AI chatbot responds and processes queries.', 'mxchat'); ?></p>
294 </div>
295
296 <div class="mxch-card">
297 <div class="mxch-card-body mxchat-autosave-section">
298 <?php
299 // AI Instructions
300 mxchat_render_field_wrapper('system_prompt_instructions', __('AI Instructions (Behavior)', 'mxchat'), function() use ($admin_instance) {
301 $admin_instance->system_prompt_instructions_callback();
302 }, __('Provide system-level instructions to guide the AI\'s behavior and responses.', 'mxchat'));
303
304 // Similarity Threshold
305 mxchat_render_field_wrapper('similarity_threshold', __('Similarity Threshold', 'mxchat'), function() use ($admin_instance) {
306 $admin_instance->mxchat_similarity_threshold_callback();
307 }, __('Adjust threshold for content matching. Lower values = more matches, higher values = stricter matching.', 'mxchat'));
308
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 // Contextual Awareness
333 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
334 $admin_instance->mxchat_contextual_awareness_callback();
335 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
336
337 // Citation Links
338 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
339 $admin_instance->mxchat_citation_links_toggle_callback();
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'));
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
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.
360 ?>
361 </div>
362 </div>
363 </div>
364
365 <!-- ========================================
366 CHATBOT - DISPLAY
367 ======================================== -->
368 <div id="chatbot-display" class="mxch-section">
369 <div class="mxch-content-header">
370 <h1 class="mxch-content-title"><?php esc_html_e('Display Settings', 'mxchat'); ?></h1>
371 <p class="mxch-content-subtitle"><?php esc_html_e('Customize how and where your chatbot appears on your website.', 'mxchat'); ?></p>
372 </div>
373
374 <div class="mxch-card">
375 <div class="mxch-card-header">
376 <h3 class="mxch-card-title">
377 <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"><rect x="3" y="3" width="18" height="18" rx="2" ry="2"/><line x1="3" y1="9" x2="21" y2="9"/><line x1="9" y1="21" x2="9" y2="9"/></svg>
378 <?php esc_html_e('Visibility', 'mxchat'); ?>
379 </h3>
380 </div>
381 <div class="mxch-card-body mxchat-autosave-section">
382 <?php
383 // Auto-Display
384 mxchat_render_field_wrapper('auto_display', __('Auto-Display Chatbot', 'mxchat'), function() use ($admin_instance) {
385 $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'));
387
388 // Open Links in New Tab
389 mxchat_render_field_wrapper('link_target', __('Open Links in New Tab', 'mxchat'), function() use ($admin_instance) {
390 $admin_instance->mxchat_link_target_toggle_callback();
391 }, __('Open links clicked in chat responses in a new browser tab.', 'mxchat'));
392
393 // Chat Persistence
394 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
395 $admin_instance->mxchat_chat_persistence_toggle_callback();
396 }, __('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 ?>
413 </div>
414 </div>
415
416 <div class="mxch-card">
417 <div class="mxch-card-header">
418 <h3 class="mxch-card-title">
419 <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 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>
420 <?php esc_html_e('Text & Labels', 'mxchat'); ?>
421 </h3>
422 </div>
423 <div class="mxch-card-body mxchat-autosave-section">
424 <?php
425 // Top Bar Title
426 mxchat_render_field_wrapper('top_bar_title', __('Top Bar Title', 'mxchat'), function() use ($admin_instance) {
427 $admin_instance->mxchat_top_bar_title_callback();
428 }, __('Title text shown in the chatbot header.', 'mxchat'));
429
430 // AI Agent Text
431 mxchat_render_field_wrapper('ai_agent_text', __('AI Agent Text', 'mxchat'), function() use ($admin_instance) {
432 $admin_instance->mxchat_ai_agent_text_callback();
433 }, __('Text shown for AI agents in the status indicator.', 'mxchat'));
434
435 // Intro Message
436 mxchat_render_field_wrapper('intro_message', __('Introductory Message', 'mxchat'), function() use ($admin_instance) {
437 $admin_instance->mxchat_intro_message_callback();
438 }, __('First message shown when chat opens. HTML allowed.', 'mxchat'));
439
440 // Input Placeholder
441 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
442 $admin_instance->mxchat_input_copy_callback();
443 }, __('Placeholder text in the chat input field.', 'mxchat'));
444
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 // Chat Teaser
451 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
452 $admin_instance->mxchat_pre_chat_message_callback();
453 }, __('Message shown before users start chatting.', 'mxchat'));
454 ?>
455 </div>
456 </div>
457 </div>
458
459 <!-- ========================================
460 CHATBOT - LEAD CAPTURE
461 ======================================== -->
462 <div id="chatbot-lead-capture" class="mxch-section">
463 <div class="mxch-content-header">
464 <h1 class="mxch-content-title"><?php esc_html_e('Lead Capture', 'mxchat'); ?></h1>
465 <p class="mxch-content-subtitle"><?php esc_html_e('Collect user information and manage privacy settings.', 'mxchat'); ?></p>
466 </div>
467
468 <div class="mxch-card">
469 <div class="mxch-card-header">
470 <h3 class="mxch-card-title">
471 <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"><rect x="2" y="4" width="20" height="16" rx="2"/><path d="m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7"/></svg>
472 <?php esc_html_e('Email Capture', 'mxchat'); ?>
473 </h3>
474 </div>
475 <div class="mxch-card-body mxchat-autosave-section">
476 <?php
477 // Require Email
478 mxchat_render_field_wrapper('enable_email_block', __('Require Email to Chat', 'mxchat'), function() use ($admin_instance) {
479 $admin_instance->enable_email_block_callback();
480 }, __('Require users to enter their email before chatting. Shows for non-logged-in users.', 'mxchat'));
481
482 // Email Form Content
483 mxchat_render_field_wrapper('email_blocker_header', __('Email Form Content', 'mxchat'), function() use ($admin_instance) {
484 $admin_instance->email_blocker_header_content_callback();
485 }, __('HTML content shown above the email form.', 'mxchat'));
486
487 // Email Button Text
488 mxchat_render_field_wrapper('email_blocker_button', __('Submit Button Text', 'mxchat'), function() use ($admin_instance) {
489 $admin_instance->email_blocker_button_text_callback();
490 }, __('Text for the email form submit button.', 'mxchat'));
491
492 // Require Name
493 mxchat_render_field_wrapper('enable_name_field', __('Also Require Name', 'mxchat'), function() use ($admin_instance) {
494 $admin_instance->enable_name_field_callback();
495 }, __('Also require users to enter their name with email.', 'mxchat'));
496
497 // Name Placeholder
498 mxchat_render_field_wrapper('name_placeholder', __('Name Field Placeholder', 'mxchat'), function() use ($admin_instance) {
499 $admin_instance->name_field_placeholder_callback();
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 </div>
518 </div>
519
520 <div class="mxch-card">
521 <div class="mxch-card-header">
522 <h3 class="mxch-card-title">
523 <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 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>
524 <?php esc_html_e('Privacy & Compliance', 'mxchat'); ?>
525 </h3>
526 </div>
527 <div class="mxch-card-body mxchat-autosave-section">
528 <?php
529 // Privacy Notice
530 mxchat_render_field_wrapper('privacy_toggle', __('Privacy Notice', 'mxchat'), function() use ($admin_instance) {
531 $admin_instance->mxchat_privacy_toggle_callback();
532 }, __('Show privacy notice below the chat widget.', 'mxchat'));
533
534 // Complianz
535 mxchat_render_field_wrapper('complianz_toggle', __('Complianz Integration', 'mxchat'), function() use ($admin_instance) {
536 $admin_instance->mxchat_complianz_toggle_callback();
537 }, __('Apply Complianz consent logic to the chatbot (requires Complianz plugin).', 'mxchat'));
538 ?>
539 </div>
540 </div>
541 </div>
542
543 <!-- ========================================
544 CHATBOT - QUICK QUESTIONS
545 ======================================== -->
546 <div id="chatbot-quick-questions" class="mxch-section">
547 <div class="mxch-content-header">
548 <h1 class="mxch-content-title"><?php esc_html_e('Quick Questions', 'mxchat'); ?></h1>
549 <p class="mxch-content-subtitle"><?php esc_html_e('Pre-defined questions displayed above the chat input to help users get started.', 'mxchat'); ?></p>
550 </div>
551
552 <div class="mxch-card">
553 <div class="mxch-card-body mxchat-autosave-section">
554 <?php
555 // Quick Question 1
556 mxchat_render_field_wrapper('popular_question_1', __('Quick Question 1', 'mxchat'), function() use ($admin_instance) {
557 $admin_instance->mxchat_popular_question_1_callback();
558 });
559
560 // Quick Question 2
561 mxchat_render_field_wrapper('popular_question_2', __('Quick Question 2', 'mxchat'), function() use ($admin_instance) {
562 $admin_instance->mxchat_popular_question_2_callback();
563 });
564
565 // Quick Question 3
566 mxchat_render_field_wrapper('popular_question_3', __('Quick Question 3', 'mxchat'), function() use ($admin_instance) {
567 $admin_instance->mxchat_popular_question_3_callback();
568 });
569
570 // Additional Questions
571 mxchat_render_field_wrapper('additional_questions', __('Additional Questions', 'mxchat'), function() use ($admin_instance) {
572 $admin_instance->mxchat_additional_popular_questions_callback();
573 }, __('Add as many quick questions as you need.', 'mxchat'));
574 ?>
575 </div>
576 </div>
577 </div>
578
579 <!-- ========================================
580 CHATBOT - RATE LIMITS
581 ======================================== -->
582 <div id="chatbot-rate-limits" class="mxch-section">
583 <div class="mxch-content-header">
584 <h1 class="mxch-content-title"><?php esc_html_e('Rate Limits', 'mxchat'); ?></h1>
585 <p class="mxch-content-subtitle"><?php esc_html_e('Set message limits for each user role to manage API usage.', 'mxchat'); ?></p>
586 </div>
587
588 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
589 <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>
590 <div>
591 <strong><?php esc_html_e('Placeholders available:', 'mxchat'); ?></strong>
592 <code>{limit}</code>, <code>{timeframe}</code>, <code>{count}</code>, <code>{remaining}</code>
593 <br>
594 <strong><?php esc_html_e('Markdown links supported:', 'mxchat'); ?></strong>
595 <code>[Link text](https://example.com)</code>
596 </div>
597 </div>
598
599 <div class="mxch-card">
600 <div class="mxch-card-body mxchat-autosave-section">
601 <?php
602 // Render rate limits with accordion
603 mxchat_render_rate_limits_accordion($admin_instance);
604 ?>
605 </div>
606 </div>
607 </div>
608
609 <!-- ========================================
610 API KEYS
611 ======================================== -->
612 <div id="api-keys" class="mxch-section">
613 <div class="mxch-content-header">
614 <h1 class="mxch-content-title"><?php esc_html_e('API Keys', 'mxchat'); ?></h1>
615 <p class="mxch-content-subtitle"><?php esc_html_e('Manage API keys for AI providers and integrations.', 'mxchat'); ?></p>
616 </div>
617
618 <div class="mxch-card">
619 <div class="mxch-card-header">
620 <h3 class="mxch-card-title">
621 <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 8V4H8"/><rect width="16" height="12" x="4" y="8" rx="2"/><path d="M2 14h2"/><path d="M20 14h2"/><path d="M15 13v2"/><path d="M9 13v2"/></svg>
622 <?php esc_html_e('AI Providers', 'mxchat'); ?>
623 </h3>
624 </div>
625 <div class="mxch-card-body mxchat-autosave-section">
626 <table class="form-table">
627 <?php do_settings_fields('mxchat-api-keys', 'mxchat_api_keys_section'); ?>
628 </table>
629 </div>
630 </div>
631 </div>
632
633 <!-- ========================================
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 INTEGRATIONS - TOOLBAR
919 ======================================== -->
920 <div id="integrations-toolbar" class="mxch-section">
921 <div class="mxch-content-header">
922 <h1 class="mxch-content-title"><?php esc_html_e('Toolbar Settings', 'mxchat'); ?></h1>
923 <p class="mxch-content-subtitle"><?php esc_html_e('Configure the chat toolbar and document upload features.', 'mxchat'); ?></p>
924 </div>
925
926 <div class="mxch-card">
927 <div class="mxch-card-body mxchat-autosave-section">
928 <table class="form-table">
929 <?php do_settings_fields('mxchat-embed', 'mxchat_pdf_intent_section'); ?>
930 </table>
931 </div>
932 </div>
933 </div>
934
935 <!-- ========================================
936 INTEGRATIONS - LOOPS
937 ======================================== -->
938 <div id="integrations-loops" class="mxch-section">
939 <div class="mxch-content-header">
940 <h1 class="mxch-content-title"><?php esc_html_e('Loops Integration', 'mxchat'); ?></h1>
941 <p class="mxch-content-subtitle"><?php esc_html_e('Configure email capture with Loops for mailing list growth.', 'mxchat'); ?></p>
942 </div>
943
944 <div class="mxch-card">
945 <div class="mxch-card-body mxchat-autosave-section">
946 <table class="form-table">
947 <?php do_settings_fields('mxchat-embed', 'mxchat_loops_section'); ?>
948 </table>
949 </div>
950 </div>
951 </div>
952
953 <!-- ========================================
954 INTEGRATIONS - BRAVE SEARCH
955 ======================================== -->
956 <div id="integrations-brave" class="mxch-section">
957 <div class="mxch-content-header">
958 <h1 class="mxch-content-title"><?php esc_html_e('Brave Search', 'mxchat'); ?></h1>
959 <p class="mxch-content-subtitle"><?php esc_html_e('Configure Brave Search API for web search capabilities.', 'mxchat'); ?></p>
960 </div>
961
962 <div class="mxch-card">
963 <div class="mxch-card-body mxchat-autosave-section">
964 <table class="form-table">
965 <?php do_settings_fields('mxchat-embed', 'mxchat_brave_section'); ?>
966 </table>
967 </div>
968 </div>
969 </div>
970
971 <!-- ========================================
972 INTEGRATIONS - SLACK
973 ======================================== -->
974 <div id="integrations-slack" class="mxch-section">
975 <div class="mxch-content-header">
976 <h1 class="mxch-content-title"><?php esc_html_e('Slack', 'mxchat'); ?></h1>
977 <p class="mxch-content-subtitle"><?php esc_html_e('Connect your chatbot to Slack for live human support.', 'mxchat'); ?></p>
978 </div>
979
980 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
981 <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 <div>
983 <?php printf(
984 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>'
986 ); ?>
987 </div>
988 </div>
989
990 <div class="mxch-card">
991 <div class="mxch-card-body mxchat-autosave-section">
992 <table class="form-table">
993 <?php do_settings_fields('mxchat-embed', 'mxchat_live_agent_section'); ?>
994 </table>
995 </div>
996 </div>
997
998 <div class="mxch-card" style="margin-top: 24px;">
999 <div class="mxch-card-header">
1000 <h3 class="mxch-card-title">
1001 <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="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
1002 <?php esc_html_e('Test Connection', 'mxchat'); ?>
1003 </h3>
1004 </div>
1005 <div class="mxch-card-body">
1006 <p class="mxch-field-description" style="margin-bottom: 16px;">
1007 <?php esc_html_e('Test your Slack bot token to verify it has the required permissions. This will check if the bot can authenticate and create channels.', 'mxchat'); ?>
1008 </p>
1009 <button type="button" id="mxchat-test-slack-connection" class="mxch-btn mxch-btn-secondary">
1010 <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="margin-right: 8px;"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
1011 <?php esc_html_e('Test Slack Connection', 'mxchat'); ?>
1012 </button>
1013 <div id="mxchat-slack-test-result" style="margin-top: 16px; display: none;"></div>
1014 </div>
1015 </div>
1016
1017 <div class="mxch-card" style="margin-top: 24px;">
1018 <div class="mxch-card-header">
1019 <h3 class="mxch-card-title">
1020 <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"><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>
1021 <?php esc_html_e('Required OAuth Scopes', 'mxchat'); ?>
1022 </h3>
1023 </div>
1024 <div class="mxch-card-body">
1025 <p class="mxch-field-description" style="margin-bottom: 12px;">
1026 <?php esc_html_e('Your Slack app needs these Bot Token Scopes (OAuth & Permissions > Scopes):', 'mxchat'); ?>
1027 </p>
1028 <div style="display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 8px; background: #f8f9fa; padding: 16px; border-radius: 8px; font-family: monospace; font-size: 13px;">
1029 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">channels:manage</code>
1030 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">channels:read</code>
1031 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">chat:write</code>
1032 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">chat:write.public</code>
1033 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">groups:write</code>
1034 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">users:read</code>
1035 </div>
1036 <p class="mxch-field-description" style="margin-top: 12px;">
1037 <?php esc_html_e('After adding scopes, reinstall the app to your workspace.', 'mxchat'); ?>
1038 </p>
1039 </div>
1040 </div>
1041 </div>
1042
1043 <!-- ========================================
1044 INTEGRATIONS - TELEGRAM
1045 ======================================== -->
1046 <div id="integrations-telegram" class="mxch-section">
1047 <div class="mxch-content-header">
1048 <h1 class="mxch-content-title"><?php esc_html_e('Telegram', 'mxchat'); ?></h1>
1049 <p class="mxch-content-subtitle"><?php esc_html_e('Connect your chatbot to Telegram for live human support.', 'mxchat'); ?></p>
1050 </div>
1051
1052 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
1053 <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>
1054 <div>
1055 <?php esc_html_e('Telegram Live Agent requires a Telegram bot and a supergroup with forum topics enabled.', 'mxchat'); ?>
1056 <a href="https://mxchat.ai/documentation-bot/" target="_blank" style="margin-left: 5px;"><?php esc_html_e('Chat with our advanced doc bot for assistance setting up.', 'mxchat'); ?></a>
1057 </div>
1058 </div>
1059
1060 <div class="mxch-card">
1061 <div class="mxch-card-body mxchat-autosave-section">
1062 <table class="form-table">
1063 <?php do_settings_fields('mxchat-embed', 'mxchat_telegram_section'); ?>
1064 </table>
1065 </div>
1066 </div>
1067
1068 <div class="mxch-card" style="margin-top: 24px;">
1069 <div class="mxch-card-header">
1070 <h3 class="mxch-card-title">
1071 <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>
1072 <?php esc_html_e('Webhook Setup', 'mxchat'); ?>
1073 </h3>
1074 </div>
1075 <div class="mxch-card-body">
1076 <?php
1077 $telegram_bot_token = $options['telegram_bot_token'] ?? '';
1078 $telegram_webhook_secret = $options['telegram_webhook_secret'] ?? '';
1079 $webhook_url = rest_url('mxchat/v1/telegram-webhook');
1080 ?>
1081
1082 <p class="mxch-field-description" style="margin-bottom: 8px;">
1083 <strong><?php esc_html_e('Your Webhook URL:', 'mxchat'); ?></strong>
1084 </p>
1085 <div class="mxch-webhook-url-display" style="margin-bottom: 20px;">
1086 <code id="mxch-telegram-webhook-url"><?php echo esc_url($webhook_url); ?></code>
1087 <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" onclick="navigator.clipboard.writeText(document.getElementById('mxch-telegram-webhook-url').textContent); this.textContent='Copied!'; setTimeout(() => this.textContent='Copy', 2000);">
1088 <?php esc_html_e('Copy', 'mxchat'); ?>
1089 </button>
1090 </div>
1091
1092 <?php if (!empty($telegram_bot_token)) : ?>
1093 <p class="mxch-field-description" style="margin-bottom: 8px;">
1094 <strong><?php esc_html_e('Register Webhook URL:', 'mxchat'); ?></strong><br>
1095 <?php esc_html_e('Copy and paste this URL into your browser to register the webhook with Telegram:', 'mxchat'); ?>
1096 </p>
1097 <?php
1098 $registration_url = 'https://api.telegram.org/bot' . $telegram_bot_token . '/setWebhook?url=' . urlencode($webhook_url);
1099 if (!empty($telegram_webhook_secret)) {
1100 $registration_url .= '&secret_token=' . urlencode($telegram_webhook_secret);
1101 }
1102 ?>
1103 <div class="mxch-webhook-url-display" style="margin-bottom: 12px;">
1104 <code id="mxch-telegram-registration-url" style="word-break: break-all; font-size: 12px;"><?php echo esc_url($registration_url); ?></code>
1105 <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" onclick="navigator.clipboard.writeText(document.getElementById('mxch-telegram-registration-url').textContent); this.textContent='Copied!'; setTimeout(() => this.textContent='Copy', 2000);">
1106 <?php esc_html_e('Copy', 'mxchat'); ?>
1107 </button>
1108 </div>
1109 <p class="mxch-field-description" style="color: #22c55e;">
1110 <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" style="vertical-align: middle; margin-right: 4px;"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>
1111 <?php esc_html_e('You should see {"ok":true,"result":true,"description":"Webhook was set"} after visiting the URL.', 'mxchat'); ?>
1112 </p>
1113 <?php else : ?>
1114 <p class="mxch-field-description" style="color: #f59e0b;">
1115 <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" style="vertical-align: middle; margin-right: 4px;"><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>
1116 <?php esc_html_e('Enter your Bot Token above and save to generate the registration URL.', 'mxchat'); ?>
1117 </p>
1118 <?php endif; ?>
1119 </div>
1120 </div>
1121 </div>
1122
1123 <!-- ========================================
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 TUTORIALS
1186 ======================================== -->
1187 <div id="tutorials" class="mxch-section">
1188 <div class="mxch-content-header">
1189 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1190 <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 </div>
1192
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 <div class="mxch-card" style="margin-bottom: 24px;">
1226 <div class="mxch-card-body">
1227 <div style="display: flex; align-items: flex-start; gap: 16px;">
1228 <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>
1229 <div>
1230 <h3 style="margin: 0 0 8px 0; font-size: 16px; font-weight: 600;"><?php esc_html_e('Need Help?', 'mxchat'); ?></h3>
1231 <p style="margin: 0 0 12px 0; color: var(--mxch-text-secondary);"><?php esc_html_e('If you\'re having trouble or believe something is not working as expected, please submit a support ticket.', 'mxchat'); ?></p>
1232 <a href="https://wordpress.org/support/plugin/mxchat-basic/" target="_blank" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1233 <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 9a2 2 0 0 1-2 2H6l-4 4V4c0-1.1.9-2 2-2h8a2 2 0 0 1 2 2v5Z"/><path d="M18 9h2a2 2 0 0 1 2 2v11l-4-4h-6a2 2 0 0 1-2-2v-1"/></svg>
1234 <?php esc_html_e('Submit Support Ticket', 'mxchat'); ?>
1235 </a>
1236 </div>
1237 </div>
1238 </div>
1239 </div>
1240
1241 <div class="mxch-tutorials-grid">
1242 <?php
1243 $tutorials = array(
1244 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 'title' => __('AI Theme Generator', 'mxchat'),
1261 'description' => __('Learn how to instantly restyle your chatbot using plain English prompts with real-time previews.', 'mxchat'),
1262 'url' => 'https://www.youtube.com/watch?v=rSQDW2qbtRU&t'
1263 ),
1264 array(
1265 'title' => __('MxChat Forms', 'mxchat'),
1266 'description' => __('Create and manage smart forms that automatically trigger during chat conversations.', 'mxchat'),
1267 'url' => 'https://www.youtube.com/watch?v=3MrWy5dRalA'
1268 ),
1269 array(
1270 'title' => __('Admin Assistant Add-on', 'mxchat'),
1271 'description' => __('Bring a ChatGPT-like experience directly inside your WordPress dashboard.', 'mxchat'),
1272 'url' => 'https://youtu.be/AdEA1k-UCFM'
1273 ),
1274 array(
1275 'title' => __('Chat Themes', 'mxchat'),
1276 'description' => __('Customize appearance with real-time previews to match your brand.', 'mxchat'),
1277 'url' => 'https://youtu.be/MfbB9mZi6ag'
1278 ),
1279 array(
1280 'title' => __('WooCommerce Integration', 'mxchat'),
1281 'description' => __('Provide product recommendations and shopping assistance to customers.', 'mxchat'),
1282 'url' => 'https://www.youtube.com/watch?v=WsqAppHRGdA'
1283 ),
1284 array(
1285 'title' => __('Knowledge Base Setup', 'mxchat'),
1286 'description' => __('Set up your knowledge base using PDFs, sitemaps, and manual entries.', 'mxchat'),
1287 'url' => 'https://www.youtube.com/watch?v=8Ztjs66-VTo'
1288 ),
1289 array(
1290 'title' => __('Document Chat', 'mxchat'),
1291 'description' => __('Chat with PDF and Word documents for enhanced document analysis.', 'mxchat'),
1292 'url' => 'https://www.youtube.com/watch?v=j_c45WWCTG0'
1293 ),
1294 array(
1295 'title' => __('Perplexity Integration', 'mxchat'),
1296 'description' => __('Enable real-time web search capabilities for your chatbot.', 'mxchat'),
1297 'url' => 'https://youtu.be/wpKkbt24-bo'
1298 ),
1299 array(
1300 'title' => __('Brave Search Intent', 'mxchat'),
1301 'description' => __('Leverage Brave Search for improved query understanding.', 'mxchat'),
1302 'url' => 'https://www.youtube.com/watch?v=7vDL5H7vToc'
1303 ),
1304 array(
1305 'title' => __('Loops Email Capture', 'mxchat'),
1306 'description' => __('Set up email capture with Loops to grow your mailing list.', 'mxchat'),
1307 'url' => 'https://www.youtube.com/watch?v=CNgm5TYDyTc'
1308 ),
1309 array(
1310 'title' => __('AI Agent Testing', 'mxchat'),
1311 'description' => __('Evaluate and improve your chatbot\'s performance and accuracy.', 'mxchat'),
1312 'url' => 'https://www.youtube.com/watch?v=A0jowbpyX54'
1313 ),
1314 );
1315
1316 foreach ($tutorials as $tutorial): ?>
1317 <div class="mxch-tutorial-card">
1318 <div class="mxch-tutorial-content">
1319 <h3 class="mxch-tutorial-title"><?php echo esc_html($tutorial['title']); ?></h3>
1320 <p class="mxch-tutorial-description"><?php echo esc_html($tutorial['description']); ?></p>
1321 <a href="<?php echo esc_url($tutorial['url']); ?>" target="_blank" rel="noopener" class="mxch-tutorial-link">
1322 <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="5 3 19 12 5 21 5 3"/></svg>
1323 <?php esc_html_e('Watch Tutorial', 'mxchat'); ?>
1324 </a>
1325 </div>
1326 </div>
1327 <?php endforeach; ?>
1328 </div>
1329 </div>
1330
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>
1339
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>
1359
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>
1364
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>
1369
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>
1374
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>
1381
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>
1388
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>
1397
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>
1402
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>
1407
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>
1414
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>
1425
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>
1437
1438 </main>
1439 </div>
1440
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 // Rate limit accordion
1449 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1450 rateLimitHeaders.forEach(header => {
1451 header.addEventListener('click', function(e) {
1452 e.preventDefault();
1453 e.stopPropagation();
1454 const item = this.closest('.mxch-rate-limit-item');
1455 item.classList.toggle('expanded');
1456 });
1457 });
1458
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;
1471 }
1472 };
1473 sel.addEventListener('change', sync);
1474 sync();
1475 });
1476 });
1477 </script>
1478 <?php
1479 }
1480
1481 /**
1482 * 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 */
1488 function mxchat_render_field_wrapper($id, $label, $callback, $description = '', $hint = '') {
1489 ?>
1490 <div class="mxch-field">
1491 <label class="mxch-field-label"><?php echo esc_html($label); ?></label>
1492 <div class="mxch-field-control">
1493 <?php $callback(); ?>
1494 </div>
1495 <?php if ($description): ?>
1496 <p class="mxch-field-description"><?php echo esc_html($description); ?></p>
1497 <?php endif; ?>
1498 <?php if ($hint): ?>
1499 <p class="mxch-field-hint"><?php echo esc_html($hint); ?></p>
1500 <?php endif; ?>
1501 </div>
1502 <?php
1503 }
1504
1505 /**
1506 * Render rate limits as collapsible accordion
1507 */
1508 function mxchat_render_rate_limits_accordion($admin_instance) {
1509 $all_options = get_option('mxchat_options', []);
1510 $rate_limits = array('1', '3', '5', '10', '15', '20', '50', '100', 'unlimited');
1511 $timeframes = array(
1512 'hourly' => __('Per Hour', 'mxchat'),
1513 'daily' => __('Per Day', 'mxchat'),
1514 'weekly' => __('Per Week', 'mxchat'),
1515 'monthly' => __('Per Month', 'mxchat')
1516 );
1517
1518 $roles = wp_roles()->get_names();
1519 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1520
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 echo '<div class="mxch-rate-limits">';
1536
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 foreach ($roles as $role_id => $role_name) {
1660 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1661 $default_timeframe = 'daily';
1662 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1663
1664 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1665 ? (string) $all_options['rate_limits'][$role_id]['limit']
1666 : $default_limit;
1667
1668 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1669 ? $all_options['rate_limits'][$role_id]['timeframe']
1670 : $default_timeframe;
1671
1672 $custom_message = isset($all_options['rate_limits'][$role_id]['message'])
1673 ? $all_options['rate_limits'][$role_id]['message']
1674 : $default_message;
1675
1676 $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 ?>
1686 <div class="mxch-rate-limit-item">
1687 <div class="mxch-rate-limit-header">
1688 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
1689 <div class="mxch-rate-limit-summary">
1690 <span class="mxch-rate-limit-badge"><?php echo esc_html($selected_limit . ' / ' . $timeframe_label); ?></span>
1691 <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>
1692 </div>
1693 </div>
1694 <div class="mxch-rate-limit-body mxchat-autosave-section">
1695 <div class="mxch-rate-limit-controls">
1696 <div class="mxch-field">
1697 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1698 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1699 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); ?>">
1702 <?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>
1706 <?php endforeach; ?>
1707 <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1708 </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 </div>
1721 <div class="mxch-field">
1722 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1723 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"
1724 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][timeframe]"
1725 class="mxch-select mxchat-autosave-field">
1726 <?php foreach ($timeframes as $value => $label): ?>
1727 <option value="<?php echo esc_attr($value); ?>" <?php selected($selected_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1728 <?php endforeach; ?>
1729 </select>
1730 </div>
1731 </div>
1732 <div class="mxch-field">
1733 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_message"><?php esc_html_e('Custom Message', 'mxchat'); ?></label>
1734 <textarea id="rate_limits_<?php echo esc_attr($role_id); ?>_message"
1735 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][message]"
1736 class="mxch-textarea mxchat-autosave-field"
1737 rows="2"
1738 placeholder="<?php esc_attr_e('Message shown when rate limit is reached', 'mxchat'); ?>"><?php echo esc_textarea($custom_message); ?></textarea>
1739 </div>
1740 </div>
1741 </div>
1742 <?php
1743 }
1744
1745 echo '</div>';
1746 }
1747