PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.2.8
MxChat – AI Chatbot & Content Generation for WordPress v3.2.8
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 3.2.8, at includes/admin-settings-page.php

1,818 lines 126.2 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 </div>
91 </div>
92 <!-- Resources Section -->
93 <div class="mxch-mobile-nav-section">
94 <div class="mxch-mobile-nav-section-title"><?php esc_html_e('Resources', 'mxchat'); ?></div>
95 <button class="mxch-mobile-nav-link" data-target="tutorials">
96 <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>
97 <span><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
98 </button>
99 </div>
100 <?php if (!$is_activated): ?>
101 <div class="mxch-mobile-menu-footer">
102 <a href="https://mxchat.ai/" target="_blank" class="mxch-mobile-upgrade-btn">
103 <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>
104 <?php esc_html_e('Upgrade to Pro', 'mxchat'); ?>
105 </a>
106 </div>
107 <?php endif; ?>
108 </nav>
109 </div>
110
111 <!-- Sidebar Navigation -->
112 <aside class="mxch-sidebar">
113 <div class="mxch-sidebar-header">
114 <a href="#" class="mxch-sidebar-logo">
115 <div class="mxch-sidebar-logo-icon">
116 <img src="<?php echo esc_url($plugin_url . 'images/icon-128x128.png'); ?>" alt="MxChat">
117 </div>
118 <span class="mxch-sidebar-logo-text">MxChat</span>
119 <span class="mxch-sidebar-version">v<?php echo esc_html(MXCHAT_VERSION ?? '2.7.0'); ?></span>
120 </a>
121 </div>
122
123 <nav class="mxch-sidebar-nav">
124 <!-- Chatbot Section -->
125 <div class="mxch-nav-section">
126 <div class="mxch-nav-section-title"><?php esc_html_e('Configuration', 'mxchat'); ?></div>
127
128 <div class="mxch-nav-item expanded" data-section="chatbot">
129 <button class="mxch-nav-link active">
130 <span class="mxch-nav-link-icon">
131 <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>
132 </span>
133 <span class="mxch-nav-link-text"><?php esc_html_e('Chatbot', 'mxchat'); ?></span>
134 <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>
135 </button>
136 <div class="mxch-nav-sub">
137 <button class="mxch-nav-sub-link active" data-target="chatbot-ai-models"><?php esc_html_e('AI Models', 'mxchat'); ?></button>
138 <button class="mxch-nav-sub-link" data-target="chatbot-behavior"><?php esc_html_e('Behavior', 'mxchat'); ?></button>
139 <button class="mxch-nav-sub-link" data-target="chatbot-display"><?php esc_html_e('Display', 'mxchat'); ?></button>
140 <button class="mxch-nav-sub-link" data-target="chatbot-lead-capture"><?php esc_html_e('Lead Capture', 'mxchat'); ?></button>
141 <button class="mxch-nav-sub-link" data-target="chatbot-quick-questions"><?php esc_html_e('Quick Questions', 'mxchat'); ?></button>
142 <button class="mxch-nav-sub-link" data-target="chatbot-rate-limits"><?php esc_html_e('Rate Limits', 'mxchat'); ?></button>
143 </div>
144 </div>
145
146 <div class="mxch-nav-item" data-section="api-keys">
147 <button class="mxch-nav-link" data-target="api-keys">
148 <span class="mxch-nav-link-icon">
149 <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>
150 </span>
151 <span class="mxch-nav-link-text"><?php esc_html_e('API Keys', 'mxchat'); ?></span>
152 </button>
153 </div>
154
155 <div class="mxch-nav-item" data-section="optimization">
156 <button class="mxch-nav-link" data-target="optimization">
157 <span class="mxch-nav-link-icon">
158 <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>
159 </span>
160 <span class="mxch-nav-link-text"><?php esc_html_e('Optimization', 'mxchat'); ?></span>
161 </button>
162 </div>
163
164 <div class="mxch-nav-item" data-section="testing">
165 <button class="mxch-nav-link" data-target="testing">
166 <span class="mxch-nav-link-icon">
167 <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>
168 </span>
169 <span class="mxch-nav-link-text"><?php esc_html_e('Testing', 'mxchat'); ?></span>
170 </button>
171 </div>
172 </div>
173
174 <!-- Integrations Section -->
175 <div class="mxch-nav-section">
176 <div class="mxch-nav-section-title"><?php esc_html_e('Integrations', 'mxchat'); ?></div>
177
178 <div class="mxch-nav-item" data-section="integrations">
179 <button class="mxch-nav-link">
180 <span class="mxch-nav-link-icon">
181 <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>
182 </span>
183 <span class="mxch-nav-link-text"><?php esc_html_e('Integrations', 'mxchat'); ?></span>
184 <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>
185 </button>
186 <div class="mxch-nav-sub">
187 <button class="mxch-nav-sub-link" data-target="integrations-toolbar"><?php esc_html_e('Toolbar', 'mxchat'); ?></button>
188 <button class="mxch-nav-sub-link" data-target="integrations-loops"><?php esc_html_e('Loops', 'mxchat'); ?></button>
189 <button class="mxch-nav-sub-link" data-target="integrations-brave"><?php esc_html_e('Brave Search', 'mxchat'); ?></button>
190 <button class="mxch-nav-sub-link" data-target="integrations-slack"><?php esc_html_e('Slack', 'mxchat'); ?></button>
191 <button class="mxch-nav-sub-link" data-target="integrations-telegram"><?php esc_html_e('Telegram', 'mxchat'); ?></button>
192 </div>
193 </div>
194 </div>
195
196 <!-- Resources Section -->
197 <div class="mxch-nav-section">
198 <div class="mxch-nav-section-title"><?php esc_html_e('Resources', 'mxchat'); ?></div>
199
200 <div class="mxch-nav-item" data-section="tutorials">
201 <button class="mxch-nav-link" data-target="tutorials">
202 <span class="mxch-nav-link-icon">
203 <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>
204 </span>
205 <span class="mxch-nav-link-text"><?php esc_html_e('Tutorials', 'mxchat'); ?></span>
206 </button>
207 </div>
208 </div>
209
210 </nav>
211
212 <?php if (!$is_activated): ?>
213 <div class="mxch-sidebar-footer">
214 <a href="https://mxchat.ai/" target="_blank" class="mxch-sidebar-upgrade-v2">
215 <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>
216 <?php esc_html_e('Pro Upgrade', 'mxchat'); ?>
217 </a>
218 </div>
219 <?php endif; ?>
220 </aside>
221
222 <!-- Main Content Area -->
223 <main class="mxch-content">
224 <?php if (!$is_activated): ?>
225 <div class="mxch-pro-banner">
226 <div class="mxch-pro-banner-content">
227 <h3 class="mxch-pro-banner-title"><?php esc_html_e('Stop paying $50–200/month for AI chatbot tools.', 'mxchat'); ?></h3>
228 <p class="mxch-pro-banner-text"><?php esc_html_e('One payment unlocks every MxChat Pro add-on for life — MCP server access for Claude / ChatGPT / Claude Code, WooCommerce sales, Google Search Console insights, AI-generated chatbot themes, lead-capture forms, unlimited bots, image analysis, and more. No renewals. No surprise bills.', 'mxchat'); ?></p>
229 </div>
230 <a href="https://mxchat.ai/" target="_blank" class="mxch-pro-banner-btn"><span><?php esc_html_e('Get Lifetime Access →', 'mxchat'); ?></span></a>
231 </div>
232 <?php endif; ?>
233
234 <?php
235 // Show theme migration notice for Pro users
236 $admin_instance->show_theme_migration_banner();
237 ?>
238
239 <!-- ========================================
240 CHATBOT - AI MODELS
241 ======================================== -->
242 <div id="chatbot-ai-models" class="mxch-section active">
243 <div class="mxch-content-header">
244 <h1 class="mxch-content-title"><?php esc_html_e('AI Models', 'mxchat'); ?></h1>
245 <p class="mxch-content-subtitle"><?php esc_html_e('Configure the AI models your chatbot will use for conversations and embeddings.', 'mxchat'); ?></p>
246 </div>
247
248 <div class="mxch-card">
249 <div class="mxch-card-body mxchat-autosave-section">
250 <?php
251 // Chat Model
252 mxchat_render_field_wrapper('model', __('Chat Model', 'mxchat'), function() use ($admin_instance) {
253 $admin_instance->mxchat_model_callback();
254 }, __('Select the AI model your chatbot will use for conversations.', 'mxchat'));
255
256 // Embedding Model
257 mxchat_render_field_wrapper('embedding_model', __('Embedding Model', 'mxchat'), function() use ($admin_instance) {
258 $admin_instance->embedding_model_callback();
259 }, __('Vector embedding model for knowledge base matching. Changing models requires reconfiguring knowledge data.', 'mxchat'));
260
261 // Enable Streaming
262 mxchat_render_field_wrapper('enable_streaming', __('Enable Streaming', 'mxchat'), function() use ($admin_instance) {
263 $admin_instance->enable_streaming_toggle_callback();
264 }, __('Enable real-time streaming responses for supported models (OpenAI, Claude, DeepSeek, Grok).', 'mxchat'));
265
266 // Enable Web Search (OpenAI only)
267 mxchat_render_field_wrapper('enable_web_search', __('Enable Web Search', 'mxchat'), function() use ($admin_instance) {
268 $admin_instance->enable_web_search_toggle_callback();
269 }, __('Allow the chatbot to search the web for current information (OpenAI models only).', 'mxchat'));
270 ?>
271 </div>
272 </div>
273 </div>
274
275 <!-- ========================================
276 CHATBOT - BEHAVIOR
277 ======================================== -->
278 <div id="chatbot-behavior" class="mxch-section">
279 <div class="mxch-content-header">
280 <h1 class="mxch-content-title"><?php esc_html_e('Behavior', 'mxchat'); ?></h1>
281 <p class="mxch-content-subtitle"><?php esc_html_e('Control how your AI chatbot responds and processes queries.', 'mxchat'); ?></p>
282 </div>
283
284 <div class="mxch-card">
285 <div class="mxch-card-body mxchat-autosave-section">
286 <?php
287 // AI Instructions
288 mxchat_render_field_wrapper('system_prompt_instructions', __('AI Instructions (Behavior)', 'mxchat'), function() use ($admin_instance) {
289 $admin_instance->system_prompt_instructions_callback();
290 }, __('Provide system-level instructions to guide the AI\'s behavior and responses.', 'mxchat'));
291
292 // Similarity Threshold
293 mxchat_render_field_wrapper('similarity_threshold', __('Similarity Threshold', 'mxchat'), function() use ($admin_instance) {
294 $admin_instance->mxchat_similarity_threshold_callback();
295 }, __('Adjust threshold for content matching. Lower values = more matches, higher values = stricter matching.', 'mxchat'));
296
297 // RAG Sources Limit
298 mxchat_render_field_wrapper('rag_sources_limit', __('RAG Sources Limit', 'mxchat'), function() use ($admin_instance) {
299 $admin_instance->mxchat_rag_sources_limit_callback();
300 }, __('Number of knowledge base sources (pages/documents) to include in AI context. Higher values provide more context but use more tokens.', 'mxchat'));
301
302 // RAG Chunks Limit
303 mxchat_render_field_wrapper('rag_chunks_limit', __('RAG Chunks Limit', 'mxchat'), function() use ($admin_instance) {
304 $admin_instance->mxchat_rag_chunks_limit_callback();
305 }, __('Maximum total content chunks sent to the AI across all sources. Higher values provide more context but increase token usage and cost.', 'mxchat'));
306
307 // Contextual Awareness
308 mxchat_render_field_wrapper('contextual_awareness', __('Contextual Awareness', 'mxchat'), function() use ($admin_instance) {
309 $admin_instance->mxchat_contextual_awareness_callback();
310 }, __('Allow the chatbot to understand and reference the current page content for more relevant responses.', 'mxchat'));
311
312 // Citation Links
313 mxchat_render_field_wrapper('citation_links', __('Citation Links', 'mxchat'), function() use ($admin_instance) {
314 $admin_instance->mxchat_citation_links_toggle_callback();
315 }, __('Allow the AI to include citation links from your knowledge database in responses. If disabled, ensure your AI Behavior settings do not mention links or the AI may fabricate URLs.', 'mxchat'));
316
317 // Satisfaction Rating Prompt
318 // The toggle callback inline-renders the 5 customization
319 // fields inside a single sub-options wrapper (plan-29caac).
320 // No separate customization group needed — the wrapper handles
321 // its own server-side display state based on the toggle value.
322 mxchat_render_field_wrapper('satisfaction_rating', __('Satisfaction Rating Prompt', 'mxchat'), function() use ($admin_instance) {
323 $admin_instance->mxchat_satisfaction_rating_toggle_callback();
324 }, __('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'));
325 ?>
326 </div>
327 </div>
328 </div>
329
330 <!-- ========================================
331 CHATBOT - DISPLAY
332 ======================================== -->
333 <div id="chatbot-display" class="mxch-section">
334 <div class="mxch-content-header">
335 <h1 class="mxch-content-title"><?php esc_html_e('Display Settings', 'mxchat'); ?></h1>
336 <p class="mxch-content-subtitle"><?php esc_html_e('Customize how and where your chatbot appears on your website.', 'mxchat'); ?></p>
337 </div>
338
339 <div class="mxch-card">
340 <div class="mxch-card-header">
341 <h3 class="mxch-card-title">
342 <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>
343 <?php esc_html_e('Visibility', 'mxchat'); ?>
344 </h3>
345 </div>
346 <div class="mxch-card-body mxchat-autosave-section">
347 <?php
348 // Auto-Display
349 mxchat_render_field_wrapper('auto_display', __('Auto-Display Chatbot', 'mxchat'), function() use ($admin_instance) {
350 $admin_instance->mxchat_append_to_body_callback();
351 }, __('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'));
352
353 // Open Links in New Tab
354 mxchat_render_field_wrapper('link_target', __('Open Links in New Tab', 'mxchat'), function() use ($admin_instance) {
355 $admin_instance->mxchat_link_target_toggle_callback();
356 }, __('Open links clicked in chat responses in a new browser tab.', 'mxchat'));
357
358 // Chat Persistence
359 mxchat_render_field_wrapper('chat_persistence', __('Chat Persistence', 'mxchat'), function() use ($admin_instance) {
360 $admin_instance->mxchat_chat_persistence_toggle_callback();
361 }, __('Keep chat history when users navigate or return within 24 hours.', 'mxchat'));
362 ?>
363 </div>
364 </div>
365
366 <div class="mxch-card">
367 <div class="mxch-card-header">
368 <h3 class="mxch-card-title">
369 <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>
370 <?php esc_html_e('Text & Labels', 'mxchat'); ?>
371 </h3>
372 </div>
373 <div class="mxch-card-body mxchat-autosave-section">
374 <?php
375 // Top Bar Title
376 mxchat_render_field_wrapper('top_bar_title', __('Top Bar Title', 'mxchat'), function() use ($admin_instance) {
377 $admin_instance->mxchat_top_bar_title_callback();
378 }, __('Title text shown in the chatbot header.', 'mxchat'));
379
380 // AI Agent Text
381 mxchat_render_field_wrapper('ai_agent_text', __('AI Agent Text', 'mxchat'), function() use ($admin_instance) {
382 $admin_instance->mxchat_ai_agent_text_callback();
383 }, __('Text shown for AI agents in the status indicator.', 'mxchat'));
384
385 // Intro Message
386 mxchat_render_field_wrapper('intro_message', __('Introductory Message', 'mxchat'), function() use ($admin_instance) {
387 $admin_instance->mxchat_intro_message_callback();
388 }, __('First message shown when chat opens. HTML allowed.', 'mxchat'));
389
390 // Input Placeholder
391 mxchat_render_field_wrapper('input_copy', __('Input Placeholder', 'mxchat'), function() use ($admin_instance) {
392 $admin_instance->mxchat_input_copy_callback();
393 }, __('Placeholder text in the chat input field.', 'mxchat'));
394
395 // Chat Teaser
396 mxchat_render_field_wrapper('pre_chat_message', __('Chat Teaser Pop-up', 'mxchat'), function() use ($admin_instance) {
397 $admin_instance->mxchat_pre_chat_message_callback();
398 }, __('Message shown before users start chatting.', 'mxchat'));
399 ?>
400 </div>
401 </div>
402 </div>
403
404 <!-- ========================================
405 CHATBOT - LEAD CAPTURE
406 ======================================== -->
407 <div id="chatbot-lead-capture" class="mxch-section">
408 <div class="mxch-content-header">
409 <h1 class="mxch-content-title"><?php esc_html_e('Lead Capture', 'mxchat'); ?></h1>
410 <p class="mxch-content-subtitle"><?php esc_html_e('Collect user information and manage privacy settings.', 'mxchat'); ?></p>
411 </div>
412
413 <div class="mxch-card">
414 <div class="mxch-card-header">
415 <h3 class="mxch-card-title">
416 <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>
417 <?php esc_html_e('Email Capture', 'mxchat'); ?>
418 </h3>
419 </div>
420 <div class="mxch-card-body mxchat-autosave-section">
421 <?php
422 // Require Email
423 mxchat_render_field_wrapper('enable_email_block', __('Require Email to Chat', 'mxchat'), function() use ($admin_instance) {
424 $admin_instance->enable_email_block_callback();
425 }, __('Require users to enter their email before chatting. Shows for non-logged-in users.', 'mxchat'));
426
427 // Email Form Content
428 mxchat_render_field_wrapper('email_blocker_header', __('Email Form Content', 'mxchat'), function() use ($admin_instance) {
429 $admin_instance->email_blocker_header_content_callback();
430 }, __('HTML content shown above the email form.', 'mxchat'));
431
432 // Email Button Text
433 mxchat_render_field_wrapper('email_blocker_button', __('Submit Button Text', 'mxchat'), function() use ($admin_instance) {
434 $admin_instance->email_blocker_button_text_callback();
435 }, __('Text for the email form submit button.', 'mxchat'));
436
437 // Require Name
438 mxchat_render_field_wrapper('enable_name_field', __('Also Require Name', 'mxchat'), function() use ($admin_instance) {
439 $admin_instance->enable_name_field_callback();
440 }, __('Also require users to enter their name with email.', 'mxchat'));
441
442 // Name Placeholder
443 mxchat_render_field_wrapper('name_placeholder', __('Name Field Placeholder', 'mxchat'), function() use ($admin_instance) {
444 $admin_instance->name_field_placeholder_callback();
445 }, __('Placeholder text for the name input field.', 'mxchat'));
446 ?>
447 </div>
448 </div>
449
450 <div class="mxch-card">
451 <div class="mxch-card-header">
452 <h3 class="mxch-card-title">
453 <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>
454 <?php esc_html_e('Privacy & Compliance', 'mxchat'); ?>
455 </h3>
456 </div>
457 <div class="mxch-card-body mxchat-autosave-section">
458 <?php
459 // Privacy Notice
460 mxchat_render_field_wrapper('privacy_toggle', __('Privacy Notice', 'mxchat'), function() use ($admin_instance) {
461 $admin_instance->mxchat_privacy_toggle_callback();
462 }, __('Show privacy notice below the chat widget.', 'mxchat'));
463
464 // Complianz
465 mxchat_render_field_wrapper('complianz_toggle', __('Complianz Integration', 'mxchat'), function() use ($admin_instance) {
466 $admin_instance->mxchat_complianz_toggle_callback();
467 }, __('Apply Complianz consent logic to the chatbot (requires Complianz plugin).', 'mxchat'));
468 ?>
469 </div>
470 </div>
471 </div>
472
473 <!-- ========================================
474 CHATBOT - QUICK QUESTIONS
475 ======================================== -->
476 <div id="chatbot-quick-questions" class="mxch-section">
477 <div class="mxch-content-header">
478 <h1 class="mxch-content-title"><?php esc_html_e('Quick Questions', 'mxchat'); ?></h1>
479 <p class="mxch-content-subtitle"><?php esc_html_e('Pre-defined questions displayed above the chat input to help users get started.', 'mxchat'); ?></p>
480 </div>
481
482 <div class="mxch-card">
483 <div class="mxch-card-body mxchat-autosave-section">
484 <?php
485 // Quick Question 1
486 mxchat_render_field_wrapper('popular_question_1', __('Quick Question 1', 'mxchat'), function() use ($admin_instance) {
487 $admin_instance->mxchat_popular_question_1_callback();
488 });
489
490 // Quick Question 2
491 mxchat_render_field_wrapper('popular_question_2', __('Quick Question 2', 'mxchat'), function() use ($admin_instance) {
492 $admin_instance->mxchat_popular_question_2_callback();
493 });
494
495 // Quick Question 3
496 mxchat_render_field_wrapper('popular_question_3', __('Quick Question 3', 'mxchat'), function() use ($admin_instance) {
497 $admin_instance->mxchat_popular_question_3_callback();
498 });
499
500 // Additional Questions
501 mxchat_render_field_wrapper('additional_questions', __('Additional Questions', 'mxchat'), function() use ($admin_instance) {
502 $admin_instance->mxchat_additional_popular_questions_callback();
503 }, __('Add as many quick questions as you need.', 'mxchat'));
504 ?>
505 </div>
506 </div>
507 </div>
508
509 <!-- ========================================
510 CHATBOT - RATE LIMITS
511 ======================================== -->
512 <div id="chatbot-rate-limits" class="mxch-section">
513 <div class="mxch-content-header">
514 <h1 class="mxch-content-title"><?php esc_html_e('Rate Limits', 'mxchat'); ?></h1>
515 <p class="mxch-content-subtitle"><?php esc_html_e('Set message limits for each user role to manage API usage.', 'mxchat'); ?></p>
516 </div>
517
518 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
519 <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>
520 <div>
521 <strong><?php esc_html_e('Placeholders available:', 'mxchat'); ?></strong>
522 <code>{limit}</code>, <code>{timeframe}</code>, <code>{count}</code>, <code>{remaining}</code>
523 <br>
524 <strong><?php esc_html_e('Markdown links supported:', 'mxchat'); ?></strong>
525 <code>[Link text](https://example.com)</code>
526 </div>
527 </div>
528
529 <div class="mxch-card">
530 <div class="mxch-card-body mxchat-autosave-section">
531 <?php
532 // Render rate limits with accordion
533 mxchat_render_rate_limits_accordion($admin_instance);
534 ?>
535 </div>
536 </div>
537 </div>
538
539 <!-- ========================================
540 API KEYS
541 ======================================== -->
542 <div id="api-keys" class="mxch-section">
543 <div class="mxch-content-header">
544 <h1 class="mxch-content-title"><?php esc_html_e('API Keys', 'mxchat'); ?></h1>
545 <p class="mxch-content-subtitle"><?php esc_html_e('Manage API keys for AI providers and integrations.', 'mxchat'); ?></p>
546 </div>
547
548 <div class="mxch-card">
549 <div class="mxch-card-header">
550 <h3 class="mxch-card-title">
551 <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>
552 <?php esc_html_e('AI Providers', 'mxchat'); ?>
553 </h3>
554 </div>
555 <div class="mxch-card-body mxchat-autosave-section">
556 <table class="form-table">
557 <?php do_settings_fields('mxchat-api-keys', 'mxchat_api_keys_section'); ?>
558 </table>
559 </div>
560 </div>
561 </div>
562
563 <!-- ========================================
564 OPTIMIZATION
565 ======================================== -->
566 <div id="optimization" class="mxch-section">
567 <div class="mxch-content-header">
568 <h1 class="mxch-content-title"><?php esc_html_e('Optimization & Diagnostics', 'mxchat'); ?></h1>
569 <p class="mxch-content-subtitle"><?php esc_html_e('Optimize performance, debug issues, and manage plugin settings.', 'mxchat'); ?></p>
570 </div>
571
572 <!-- Script Loading Card -->
573 <div class="mxch-card">
574 <div class="mxch-card-header">
575 <h3 class="mxch-card-title">
576 <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>
577 <?php esc_html_e('Script Loading', 'mxchat'); ?>
578 </h3>
579 </div>
580 <div class="mxch-card-body mxchat-autosave-section">
581 <?php
582 $script_loading_strategy = isset($options['script_loading_strategy']) ? $options['script_loading_strategy'] : 'default';
583 ?>
584 <div class="mxch-field">
585 <label class="mxch-field-label"><?php esc_html_e('Script Loading Strategy', 'mxchat'); ?></label>
586 <div class="mxch-field-control">
587 <select name="mxchat_options[script_loading_strategy]" id="script_loading_strategy" class="mxch-select mxchat-autosave-field">
588 <option value="default" <?php selected($script_loading_strategy, 'default'); ?>><?php esc_html_e('Default (Immediate)', 'mxchat'); ?></option>
589 <option value="defer" <?php selected($script_loading_strategy, 'defer'); ?>><?php esc_html_e('Deferred', 'mxchat'); ?></option>
590 <option value="delay_1s" <?php selected($script_loading_strategy, 'delay_1s'); ?>><?php esc_html_e('Delay 1 Second', 'mxchat'); ?></option>
591 <option value="delay_3s" <?php selected($script_loading_strategy, 'delay_3s'); ?>><?php esc_html_e('Delay 3 Seconds', 'mxchat'); ?></option>
592 <option value="delay_5s" <?php selected($script_loading_strategy, 'delay_5s'); ?>><?php esc_html_e('Delay 5 Seconds', 'mxchat'); ?></option>
593 <option value="on_interaction" <?php selected($script_loading_strategy, 'on_interaction'); ?>><?php esc_html_e('On User Interaction', 'mxchat'); ?></option>
594 </select>
595 </div>
596 <p class="mxch-field-description"><?php esc_html_e('Control when the chatbot script loads to improve page performance.', 'mxchat'); ?></p>
597 </div>
598
599 <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
600 <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>
601 <div>
602 <strong><?php esc_html_e('Loading Strategies:', 'mxchat'); ?></strong>
603 <ul style="margin: 8px 0 0 0; padding-left: 20px;">
604 <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>
605 <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>
606 <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>
607 <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>
608 </ul>
609 </div>
610 </div>
611 </div>
612 </div>
613
614 <!-- Page Cache Compatibility Card -->
615 <div class="mxch-card">
616 <div class="mxch-card-header">
617 <h3 class="mxch-card-title">
618 <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>
619 <?php esc_html_e('Page Cache Compatibility', 'mxchat'); ?>
620 </h3>
621 </div>
622 <div class="mxch-card-body">
623 <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>
624
625 <?php
626 $mxch_cache_rows = array(
627 array('name' => 'WP Rocket', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax\\.php\\?action=mxchat_.*'),
628 array('name' => 'LiteSpeed Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
629 array('name' => 'W3 Total Cache', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
630 array('name' => 'FlyingPress', 'state' => 'auto', 'exclusion' => '/wp-admin/admin-ajax.php?action=mxchat_*'),
631 array('name' => 'WP Super Cache', 'state' => 'auto', 'exclusion' => 'wp-admin/admin-ajax.php'),
632 array('name' => 'Cloudflare APO', 'state' => 'manual', 'exclusion' => 'Page Rule / Cache Rule: URI Path contains "/wp-admin/admin-ajax.php" → Bypass Cache'),
633 );
634 ?>
635
636 <div class="mxch-cache-compat-grid" style="display: grid; grid-template-columns: 1fr; gap: 12px; margin-top: 16px;">
637 <?php foreach ($mxch_cache_rows as $row) :
638 $is_auto = ($row['state'] === 'auto');
639 $pill_class = $is_auto ? 'mxch-status-pill-active' : 'mxch-status-pill-warning';
640 $pill_label = $is_auto ? __('Auto-handled', 'mxchat') : __('Manual', 'mxchat');
641 ?>
642 <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);">
643 <div style="display: flex; align-items: center; gap: 10px; min-width: 0; flex: 0 0 auto;">
644 <span style="font-weight: 500;"><?php echo esc_html($row['name']); ?></span>
645 <span class="mxch-status-pill <?php echo esc_attr($pill_class); ?>">
646 <span class="mxch-status-dot"></span>
647 <?php echo esc_html($pill_label); ?>
648 </span>
649 </div>
650 <div style="display: flex; align-items: center; gap: 8px; flex: 1 1 auto; min-width: 0;">
651 <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>
652 <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;">
653 <?php esc_html_e('Copy', 'mxchat'); ?>
654 </button>
655 </div>
656 </div>
657 <?php endforeach; ?>
658 </div>
659
660 <div class="mxch-notice mxch-notice-info" style="margin-top: 16px;">
661 <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>
662 <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>
663 </div>
664 </div>
665 </div>
666
667 <!-- Provider Reliability Card -->
668 <?php
669 $auto_retry_enabled = !isset($options['auto_retry_on_transient_error']) ||
670 (string) $options['auto_retry_on_transient_error'] !== '0';
671 ?>
672 <div class="mxch-card">
673 <div class="mxch-card-header">
674 <h3 class="mxch-card-title">
675 <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>
676 <?php esc_html_e('Provider Reliability', 'mxchat'); ?>
677 </h3>
678 <span class="mxch-status-pill <?php echo $auto_retry_enabled ? 'mxch-status-pill-active' : 'mxch-status-pill-disabled'; ?>">
679 <span class="mxch-status-dot"></span>
680 <?php echo $auto_retry_enabled ? esc_html__('Active', 'mxchat') : esc_html__('Disabled', 'mxchat'); ?>
681 </span>
682 </div>
683 <div class="mxch-card-body mxchat-autosave-section">
684 <div class="mxch-field">
685 <label class="mxch-field-label" for="auto_retry_on_transient_error">
686 <?php esc_html_e('Auto-retry on provider overload', 'mxchat'); ?>
687 </label>
688 <div class="mxch-field-control">
689 <label class="mxch-toggle">
690 <input type="checkbox"
691 id="auto_retry_on_transient_error"
692 name="mxchat_options[auto_retry_on_transient_error]"
693 class="mxchat-autosave-field"
694 value="1"
695 <?php checked($auto_retry_enabled); ?> />
696 <span class="mxch-toggle-slider"></span>
697 </label>
698 </div>
699 <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>
700 <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>
701 </div>
702 </div>
703 </div>
704
705 <!-- Debug Mode Card -->
706 <?php
707 $debug_mode = isset($options['debug_mode']) ? $options['debug_mode'] : 'off';
708 $debug_active = ($debug_mode === 'on');
709 ?>
710 <div class="mxch-card">
711 <div class="mxch-card-header">
712 <h3 class="mxch-card-title">
713 <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>
714 <?php esc_html_e('Debug Mode', 'mxchat'); ?>
715 </h3>
716 </div>
717 <div class="mxch-card-body">
718 <div class="mxch-field">
719 <label class="mxch-toggle">
720 <input type="checkbox" class="mxch-toggle-input" id="mxchat_debug_mode" name="mxchat_options[debug_mode]" value="on" <?php checked($debug_active); ?>>
721 <span class="mxch-toggle-switch"></span>
722 <span class="mxch-toggle-label"><?php esc_html_e('Enable Debug Logging', 'mxchat'); ?></span>
723 </label>
724 <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>
725 </div>
726 </div>
727 </div>
728
729 <!-- Debug Log Viewer Card -->
730 <div class="mxch-card">
731 <div class="mxch-card-header" style="display: flex; justify-content: space-between; align-items: center;">
732 <h3 class="mxch-card-title">
733 <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>
734 <?php esc_html_e('Debug Log', 'mxchat'); ?>
735 </h3>
736 <div style="display: flex; gap: 8px; align-items: center;">
737 <span id="mxchat-log-count" class="mxch-badge" style="display: none;"></span>
738 <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-refresh-log">
739 <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>
740 <?php esc_html_e('Refresh', 'mxchat'); ?>
741 </button>
742 <button type="button" class="mxch-btn mxch-btn-secondary mxch-btn-sm" id="mxchat-clear-log">
743 <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>
744 <?php esc_html_e('Clear', 'mxchat'); ?>
745 </button>
746 </div>
747 </div>
748 <div class="mxch-card-body">
749 <div id="mxchat-debug-log" class="mxchat-debug-log-viewer">
750 <div class="mxchat-debug-log-empty">
751 <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>
752 <p><?php esc_html_e('No log entries yet. Enable debug mode to start logging.', 'mxchat'); ?></p>
753 </div>
754 </div>
755 </div>
756 </div>
757
758 <!-- Settings Tools Card -->
759 <div class="mxch-card">
760 <div class="mxch-card-header">
761 <h3 class="mxch-card-title">
762 <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>
763 <?php esc_html_e('Settings Tools', 'mxchat'); ?>
764 </h3>
765 </div>
766 <div class="mxch-card-body">
767 <div class="mxch-tools-grid">
768 <!-- Export Settings -->
769 <div class="mxch-tool-item">
770 <div class="mxch-tool-icon">
771 <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>
772 </div>
773 <div class="mxch-tool-content">
774 <h4><?php esc_html_e('Export Settings', 'mxchat'); ?></h4>
775 <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>
776 <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-export-settings">
777 <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>
778 <?php esc_html_e('Export Settings', 'mxchat'); ?>
779 </button>
780 </div>
781 </div>
782
783 <!-- Reset All Settings -->
784 <div class="mxch-tool-item mxch-tool-item-danger">
785 <div class="mxch-tool-icon">
786 <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>
787 </div>
788 <div class="mxch-tool-content">
789 <h4><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h4>
790 <p><?php esc_html_e('Reset all MxChat settings to their default values. This action cannot be undone.', 'mxchat'); ?></p>
791 <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-settings">
792 <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>
793 <?php esc_html_e('Reset All Settings', 'mxchat'); ?>
794 </button>
795 </div>
796 </div>
797 </div>
798 </div>
799 </div>
800
801 <!-- Reset Confirmation Modal -->
802 <div id="mxchat-reset-modal" class="mxch-modal" style="display: none;">
803 <div class="mxch-modal-backdrop"></div>
804 <div class="mxch-modal-content">
805 <div class="mxch-modal-header">
806 <h3><?php esc_html_e('Reset All Settings', 'mxchat'); ?></h3>
807 <button type="button" class="mxch-modal-close" id="mxchat-reset-modal-close">&times;</button>
808 </div>
809 <div class="mxch-modal-body">
810 <div class="mxch-notice mxch-notice-warning">
811 <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>
812 <div>
813 <strong><?php esc_html_e('Warning: This action cannot be undone!', 'mxchat'); ?></strong>
814 <p><?php esc_html_e('All your MxChat settings including API keys, customizations, and configurations will be permanently deleted.', 'mxchat'); ?></p>
815 </div>
816 </div>
817 <div class="mxch-field" style="margin-top: 20px;">
818 <label class="mxch-field-label"><?php esc_html_e('Type RESET to confirm:', 'mxchat'); ?></label>
819 <input type="text" id="mxchat-reset-confirmation" class="mxch-input" placeholder="RESET" autocomplete="off">
820 </div>
821 </div>
822 <div class="mxch-modal-footer">
823 <button type="button" class="mxch-btn mxch-btn-secondary" id="mxchat-reset-cancel"><?php esc_html_e('Cancel', 'mxchat'); ?></button>
824 <button type="button" class="mxch-btn mxch-btn-danger" id="mxchat-reset-confirm" disabled><?php esc_html_e('Reset All Settings', 'mxchat'); ?></button>
825 </div>
826 </div>
827 </div>
828 </div>
829
830 <!-- ========================================
831 INTEGRATIONS - TOOLBAR
832 ======================================== -->
833 <div id="integrations-toolbar" class="mxch-section">
834 <div class="mxch-content-header">
835 <h1 class="mxch-content-title"><?php esc_html_e('Toolbar Settings', 'mxchat'); ?></h1>
836 <p class="mxch-content-subtitle"><?php esc_html_e('Configure the chat toolbar and document upload features.', 'mxchat'); ?></p>
837 </div>
838
839 <div class="mxch-card">
840 <div class="mxch-card-body mxchat-autosave-section">
841 <table class="form-table">
842 <?php do_settings_fields('mxchat-embed', 'mxchat_pdf_intent_section'); ?>
843 </table>
844 </div>
845 </div>
846 </div>
847
848 <!-- ========================================
849 INTEGRATIONS - LOOPS
850 ======================================== -->
851 <div id="integrations-loops" class="mxch-section">
852 <div class="mxch-content-header">
853 <h1 class="mxch-content-title"><?php esc_html_e('Loops Integration', 'mxchat'); ?></h1>
854 <p class="mxch-content-subtitle"><?php esc_html_e('Configure email capture with Loops for mailing list growth.', 'mxchat'); ?></p>
855 </div>
856
857 <div class="mxch-card">
858 <div class="mxch-card-body mxchat-autosave-section">
859 <table class="form-table">
860 <?php do_settings_fields('mxchat-embed', 'mxchat_loops_section'); ?>
861 </table>
862 </div>
863 </div>
864 </div>
865
866 <!-- ========================================
867 INTEGRATIONS - BRAVE SEARCH
868 ======================================== -->
869 <div id="integrations-brave" class="mxch-section">
870 <div class="mxch-content-header">
871 <h1 class="mxch-content-title"><?php esc_html_e('Brave Search', 'mxchat'); ?></h1>
872 <p class="mxch-content-subtitle"><?php esc_html_e('Configure Brave Search API for web search capabilities.', 'mxchat'); ?></p>
873 </div>
874
875 <div class="mxch-card">
876 <div class="mxch-card-body mxchat-autosave-section">
877 <table class="form-table">
878 <?php do_settings_fields('mxchat-embed', 'mxchat_brave_section'); ?>
879 </table>
880 </div>
881 </div>
882 </div>
883
884 <!-- ========================================
885 INTEGRATIONS - SLACK
886 ======================================== -->
887 <div id="integrations-slack" class="mxch-section">
888 <div class="mxch-content-header">
889 <h1 class="mxch-content-title"><?php esc_html_e('Slack', 'mxchat'); ?></h1>
890 <p class="mxch-content-subtitle"><?php esc_html_e('Connect your chatbot to Slack for live human support.', 'mxchat'); ?></p>
891 </div>
892
893 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
894 <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>
895 <div>
896 <?php printf(
897 esc_html__('Visit our %s for setup instructions.', 'mxchat'),
898 '<a href="https://mxchat.ai/documentation/#slack_integration" target="_blank">' . esc_html__('documentation page', 'mxchat') . '</a>'
899 ); ?>
900 </div>
901 </div>
902
903 <div class="mxch-card">
904 <div class="mxch-card-body mxchat-autosave-section">
905 <table class="form-table">
906 <?php do_settings_fields('mxchat-embed', 'mxchat_live_agent_section'); ?>
907 </table>
908 </div>
909 </div>
910
911 <div class="mxch-card" style="margin-top: 24px;">
912 <div class="mxch-card-header">
913 <h3 class="mxch-card-title">
914 <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>
915 <?php esc_html_e('Test Connection', 'mxchat'); ?>
916 </h3>
917 </div>
918 <div class="mxch-card-body">
919 <p class="mxch-field-description" style="margin-bottom: 16px;">
920 <?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'); ?>
921 </p>
922 <button type="button" id="mxchat-test-slack-connection" class="mxch-btn mxch-btn-secondary">
923 <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>
924 <?php esc_html_e('Test Slack Connection', 'mxchat'); ?>
925 </button>
926 <div id="mxchat-slack-test-result" style="margin-top: 16px; display: none;"></div>
927 </div>
928 </div>
929
930 <div class="mxch-card" style="margin-top: 24px;">
931 <div class="mxch-card-header">
932 <h3 class="mxch-card-title">
933 <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>
934 <?php esc_html_e('Required OAuth Scopes', 'mxchat'); ?>
935 </h3>
936 </div>
937 <div class="mxch-card-body">
938 <p class="mxch-field-description" style="margin-bottom: 12px;">
939 <?php esc_html_e('Your Slack app needs these Bot Token Scopes (OAuth & Permissions > Scopes):', 'mxchat'); ?>
940 </p>
941 <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;">
942 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">channels:manage</code>
943 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">channels:read</code>
944 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">chat:write</code>
945 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">chat:write.public</code>
946 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">groups:write</code>
947 <code style="background: #e9ecef; padding: 4px 8px; border-radius: 4px;">users:read</code>
948 </div>
949 <p class="mxch-field-description" style="margin-top: 12px;">
950 <?php esc_html_e('After adding scopes, reinstall the app to your workspace.', 'mxchat'); ?>
951 </p>
952 </div>
953 </div>
954 </div>
955
956 <!-- ========================================
957 INTEGRATIONS - TELEGRAM
958 ======================================== -->
959 <div id="integrations-telegram" class="mxch-section">
960 <div class="mxch-content-header">
961 <h1 class="mxch-content-title"><?php esc_html_e('Telegram', 'mxchat'); ?></h1>
962 <p class="mxch-content-subtitle"><?php esc_html_e('Connect your chatbot to Telegram for live human support.', 'mxchat'); ?></p>
963 </div>
964
965 <div class="mxch-notice mxch-notice-info" style="margin-bottom: 24px;">
966 <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>
967 <div>
968 <?php esc_html_e('Telegram Live Agent requires a Telegram bot and a supergroup with forum topics enabled.', 'mxchat'); ?>
969 <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>
970 </div>
971 </div>
972
973 <div class="mxch-card">
974 <div class="mxch-card-body mxchat-autosave-section">
975 <table class="form-table">
976 <?php do_settings_fields('mxchat-embed', 'mxchat_telegram_section'); ?>
977 </table>
978 </div>
979 </div>
980
981 <div class="mxch-card" style="margin-top: 24px;">
982 <div class="mxch-card-header">
983 <h3 class="mxch-card-title">
984 <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>
985 <?php esc_html_e('Webhook Setup', 'mxchat'); ?>
986 </h3>
987 </div>
988 <div class="mxch-card-body">
989 <?php
990 $telegram_bot_token = $options['telegram_bot_token'] ?? '';
991 $telegram_webhook_secret = $options['telegram_webhook_secret'] ?? '';
992 $webhook_url = rest_url('mxchat/v1/telegram-webhook');
993 ?>
994
995 <p class="mxch-field-description" style="margin-bottom: 8px;">
996 <strong><?php esc_html_e('Your Webhook URL:', 'mxchat'); ?></strong>
997 </p>
998 <div class="mxch-webhook-url-display" style="margin-bottom: 20px;">
999 <code id="mxch-telegram-webhook-url"><?php echo esc_url($webhook_url); ?></code>
1000 <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);">
1001 <?php esc_html_e('Copy', 'mxchat'); ?>
1002 </button>
1003 </div>
1004
1005 <?php if (!empty($telegram_bot_token)) : ?>
1006 <p class="mxch-field-description" style="margin-bottom: 8px;">
1007 <strong><?php esc_html_e('Register Webhook URL:', 'mxchat'); ?></strong><br>
1008 <?php esc_html_e('Copy and paste this URL into your browser to register the webhook with Telegram:', 'mxchat'); ?>
1009 </p>
1010 <?php
1011 $registration_url = 'https://api.telegram.org/bot' . $telegram_bot_token . '/setWebhook?url=' . urlencode($webhook_url);
1012 if (!empty($telegram_webhook_secret)) {
1013 $registration_url .= '&secret_token=' . urlencode($telegram_webhook_secret);
1014 }
1015 ?>
1016 <div class="mxch-webhook-url-display" style="margin-bottom: 12px;">
1017 <code id="mxch-telegram-registration-url" style="word-break: break-all; font-size: 12px;"><?php echo esc_url($registration_url); ?></code>
1018 <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);">
1019 <?php esc_html_e('Copy', 'mxchat'); ?>
1020 </button>
1021 </div>
1022 <p class="mxch-field-description" style="color: #22c55e;">
1023 <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>
1024 <?php esc_html_e('You should see {"ok":true,"result":true,"description":"Webhook was set"} after visiting the URL.', 'mxchat'); ?>
1025 </p>
1026 <?php else : ?>
1027 <p class="mxch-field-description" style="color: #f59e0b;">
1028 <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>
1029 <?php esc_html_e('Enter your Bot Token above and save to generate the registration URL.', 'mxchat'); ?>
1030 </p>
1031 <?php endif; ?>
1032 </div>
1033 </div>
1034 </div>
1035
1036 <!-- ========================================
1037 TUTORIALS
1038 ======================================== -->
1039 <div id="tutorials" class="mxch-section">
1040 <div class="mxch-content-header">
1041 <h1 class="mxch-content-title"><?php esc_html_e('Video Tutorials', 'mxchat'); ?></h1>
1042 <p class="mxch-content-subtitle"><?php esc_html_e('Learn how to get the most out of MxChat with our video guides.', 'mxchat'); ?></p>
1043 </div>
1044
1045 <?php
1046 // Setup Guide — reopen the onboarding wizard (plan-347916, moved here from Display tab).
1047 // Only shows once the user has dismissed/graduated from the Onboarding page.
1048 if (function_exists('mxchat_onboarding_is_dismissed') && mxchat_onboarding_is_dismissed()):
1049 $auto_grad = function_exists('mxchat_onboarding_is_auto_graduated') && mxchat_onboarding_is_auto_graduated();
1050 ?>
1051 <div class="mxch-card mxch-onboarding-unhide-card" style="margin-bottom: 24px;">
1052 <div class="mxch-card-header">
1053 <h3 class="mxch-card-title">
1054 <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>
1055 <?php esc_html_e('Setup Guide', 'mxchat'); ?>
1056 </h3>
1057 </div>
1058 <div class="mxch-card-body">
1059 <p style="margin:0 0 12px;color:var(--mxch-text-secondary);font-size:13px;line-height:1.5;">
1060 <?php if ($auto_grad): ?>
1061 <?php esc_html_e('You finished the setup guide. Reopen it any time to revisit the steps or change a setup choice.', 'mxchat'); ?>
1062 <?php else: ?>
1063 <?php esc_html_e('You hid the setup guide from the MxChat menu. Reopen it any time to revisit the steps.', 'mxchat'); ?>
1064 <?php endif; ?>
1065 </p>
1066 <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>" style="margin:0;">
1067 <?php wp_nonce_field('mxchat_unhide_onboarding'); ?>
1068 <input type="hidden" name="action" value="mxchat_unhide_onboarding" />
1069 <button type="submit" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1070 <?php esc_html_e('Reopen setup guide', 'mxchat'); ?>
1071 </button>
1072 </form>
1073 </div>
1074 </div>
1075 <?php endif; ?>
1076
1077 <div class="mxch-card" style="margin-bottom: 24px;">
1078 <div class="mxch-card-body">
1079 <div style="display: flex; align-items: flex-start; gap: 16px;">
1080 <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>
1081 <div>
1082 <h3 style="margin: 0 0 8px 0; font-size: 16px; font-weight: 600;"><?php esc_html_e('Need Help?', 'mxchat'); ?></h3>
1083 <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>
1084 <a href="https://wordpress.org/support/plugin/mxchat-basic/" target="_blank" class="mxch-btn mxch-btn-secondary mxch-btn-sm">
1085 <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>
1086 <?php esc_html_e('Submit Support Ticket', 'mxchat'); ?>
1087 </a>
1088 </div>
1089 </div>
1090 </div>
1091 </div>
1092
1093 <div class="mxch-tutorials-grid">
1094 <?php
1095 $tutorials = array(
1096 array(
1097 'title' => __('Quick Setup with MxChat', 'mxchat'),
1098 'description' => __('Learn how to quickly setup and understand how your chatbot works.', 'mxchat'),
1099 'url' => 'https://www.youtube.com/watch?v=3BqoiyWaQiM&t'
1100 ),
1101 array(
1102 'title' => __('AI Content Generation', 'mxchat'),
1103 'description' => __('Generate full blog posts and landing pages with AI—from prompt to publish in minutes.', 'mxchat'),
1104 'url' => 'https://www.youtube.com/watch?v=n8TeEeHpxs4'
1105 ),
1106 array(
1107 'title' => __('Chat With Your GSC Data', 'mxchat'),
1108 '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'),
1109 'url' => 'https://www.youtube.com/watch?v=ytgMou_7SZA&t=2s'
1110 ),
1111 array(
1112 'title' => __('AI Theme Generator', 'mxchat'),
1113 'description' => __('Learn how to instantly restyle your chatbot using plain English prompts with real-time previews.', 'mxchat'),
1114 'url' => 'https://www.youtube.com/watch?v=rSQDW2qbtRU&t'
1115 ),
1116 array(
1117 'title' => __('MxChat Forms', 'mxchat'),
1118 'description' => __('Create and manage smart forms that automatically trigger during chat conversations.', 'mxchat'),
1119 'url' => 'https://www.youtube.com/watch?v=3MrWy5dRalA'
1120 ),
1121 array(
1122 'title' => __('Admin Assistant Add-on', 'mxchat'),
1123 'description' => __('Bring a ChatGPT-like experience directly inside your WordPress dashboard.', 'mxchat'),
1124 'url' => 'https://youtu.be/AdEA1k-UCFM'
1125 ),
1126 array(
1127 'title' => __('Chat Themes', 'mxchat'),
1128 'description' => __('Customize appearance with real-time previews to match your brand.', 'mxchat'),
1129 'url' => 'https://youtu.be/MfbB9mZi6ag'
1130 ),
1131 array(
1132 'title' => __('WooCommerce Integration', 'mxchat'),
1133 'description' => __('Provide product recommendations and shopping assistance to customers.', 'mxchat'),
1134 'url' => 'https://www.youtube.com/watch?v=WsqAppHRGdA'
1135 ),
1136 array(
1137 'title' => __('Knowledge Base Setup', 'mxchat'),
1138 'description' => __('Set up your knowledge base using PDFs, sitemaps, and manual entries.', 'mxchat'),
1139 'url' => 'https://www.youtube.com/watch?v=8Ztjs66-VTo'
1140 ),
1141 array(
1142 'title' => __('Document Chat', 'mxchat'),
1143 'description' => __('Chat with PDF and Word documents for enhanced document analysis.', 'mxchat'),
1144 'url' => 'https://www.youtube.com/watch?v=j_c45WWCTG0'
1145 ),
1146 array(
1147 'title' => __('Perplexity Integration', 'mxchat'),
1148 'description' => __('Enable real-time web search capabilities for your chatbot.', 'mxchat'),
1149 'url' => 'https://youtu.be/wpKkbt24-bo'
1150 ),
1151 array(
1152 'title' => __('Brave Search Intent', 'mxchat'),
1153 'description' => __('Leverage Brave Search for improved query understanding.', 'mxchat'),
1154 'url' => 'https://www.youtube.com/watch?v=7vDL5H7vToc'
1155 ),
1156 array(
1157 'title' => __('Loops Email Capture', 'mxchat'),
1158 'description' => __('Set up email capture with Loops to grow your mailing list.', 'mxchat'),
1159 'url' => 'https://www.youtube.com/watch?v=CNgm5TYDyTc'
1160 ),
1161 array(
1162 'title' => __('AI Agent Testing', 'mxchat'),
1163 'description' => __('Evaluate and improve your chatbot\'s performance and accuracy.', 'mxchat'),
1164 'url' => 'https://www.youtube.com/watch?v=A0jowbpyX54'
1165 ),
1166 );
1167
1168 foreach ($tutorials as $tutorial): ?>
1169 <div class="mxch-tutorial-card">
1170 <div class="mxch-tutorial-content">
1171 <h3 class="mxch-tutorial-title"><?php echo esc_html($tutorial['title']); ?></h3>
1172 <p class="mxch-tutorial-description"><?php echo esc_html($tutorial['description']); ?></p>
1173 <a href="<?php echo esc_url($tutorial['url']); ?>" target="_blank" rel="noopener" class="mxch-tutorial-link">
1174 <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>
1175 <?php esc_html_e('Watch Tutorial', 'mxchat'); ?>
1176 </a>
1177 </div>
1178 </div>
1179 <?php endforeach; ?>
1180 </div>
1181 </div>
1182
1183 <!-- =====================================================
1184 TESTING SECTION
1185 ===================================================== -->
1186 <div id="testing" class="mxch-section">
1187 <div class="mxch-content-header">
1188 <h1 class="mxch-content-title"><?php esc_html_e('Testing', 'mxchat'); ?></h1>
1189 <p class="mxch-content-subtitle"><?php esc_html_e('Test your chatbot and inspect debug data in real time.', 'mxchat'); ?></p>
1190 </div>
1191
1192 <div class="mxch-testing-layout">
1193 <!-- Left Column: Debug Panel -->
1194 <div class="mxch-testing-debug-panel">
1195 <!-- Quick Actions -->
1196 <div class="mxch-card">
1197 <div class="mxch-card-body">
1198 <h3 class="mxch-testing-section-title"><?php esc_html_e('Quick Actions', 'mxchat'); ?></h3>
1199 <div class="mxch-testing-actions-row">
1200 <button type="button" class="mxch-testing-btn mxch-testing-btn-danger" id="mxch-testing-clear-session">
1201 <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>
1202 <?php esc_html_e('Clear Chat Session', 'mxchat'); ?>
1203 </button>
1204 <button type="button" class="mxch-testing-btn mxch-testing-btn-secondary" id="mxch-testing-clear-debug">
1205 <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>
1206 <?php esc_html_e('Clear Debug Log', 'mxchat'); ?>
1207 </button>
1208 </div>
1209 </div>
1210 </div>
1211
1212 <!-- Last Query Analysis -->
1213 <div class="mxch-card">
1214 <div class="mxch-card-body">
1215 <h3 class="mxch-testing-section-title"><?php esc_html_e('Last Query Analysis', 'mxchat'); ?></h3>
1216
1217 <div class="mxch-testing-field">
1218 <label><?php esc_html_e('Similarity Threshold', 'mxchat'); ?></label>
1219 <span id="mxch-testing-threshold"><?php esc_html_e('Loading...', 'mxchat'); ?></span>
1220 </div>
1221
1222 <div class="mxch-testing-field">
1223 <label><?php esc_html_e('User Query', 'mxchat'); ?></label>
1224 <div id="mxch-testing-last-query" class="mxch-testing-query-display"><?php esc_html_e('Waiting for next query...', 'mxchat'); ?></div>
1225 </div>
1226
1227 <div class="mxch-testing-field">
1228 <label><?php esc_html_e('Approved URLs for Citations', 'mxchat'); ?></label>
1229 <div id="mxch-testing-approved-urls" class="mxch-testing-results">
1230 <div class="mxch-testing-no-data"><?php esc_html_e('No URL data yet', 'mxchat'); ?></div>
1231 </div>
1232 </div>
1233
1234 <div class="mxch-testing-field">
1235 <label><?php esc_html_e('Document Matches', 'mxchat'); ?></label>
1236 <div id="mxch-testing-similarity-scores" class="mxch-testing-results">
1237 <div class="mxch-testing-no-data"><?php esc_html_e('No query data yet', 'mxchat'); ?></div>
1238 </div>
1239 </div>
1240
1241 <div class="mxch-testing-field">
1242 <label><?php esc_html_e('Actions Triggered', 'mxchat'); ?></label>
1243 <div id="mxch-testing-action-scores" class="mxch-testing-results">
1244 <div class="mxch-testing-no-data"><?php esc_html_e('No action data yet', 'mxchat'); ?></div>
1245 </div>
1246 </div>
1247 </div>
1248 </div>
1249
1250 <!-- System Information -->
1251 <div class="mxch-card">
1252 <div class="mxch-card-body">
1253 <h3 class="mxch-testing-section-title"><?php esc_html_e('System Information', 'mxchat'); ?></h3>
1254
1255 <div class="mxch-testing-field">
1256 <label><?php esc_html_e('System Prompt', 'mxchat'); ?></label>
1257 <div id="mxch-testing-system-prompt" class="mxch-testing-system-prompt"><?php esc_html_e('Loading...', 'mxchat'); ?></div>
1258 </div>
1259
1260 <div class="mxch-testing-field">
1261 <label><?php esc_html_e('Knowledge Base', 'mxchat'); ?></label>
1262 <span id="mxch-testing-kb-status"><?php esc_html_e('Checking...', 'mxchat'); ?></span>
1263 </div>
1264 </div>
1265 </div>
1266
1267 <!-- Debug Log -->
1268 <div class="mxch-card">
1269 <div class="mxch-card-body">
1270 <h3 class="mxch-testing-section-title"><?php esc_html_e('Debug Log', 'mxchat'); ?></h3>
1271 <div id="mxch-testing-debug-console" class="mxch-testing-debug-console">
1272 <div class="mxch-testing-debug-entry"><?php esc_html_e('Debug panel ready - send a message to begin...', 'mxchat'); ?></div>
1273 </div>
1274 </div>
1275 </div>
1276 </div>
1277
1278 <!-- Right Column: Chatbot Replica -->
1279 <div class="mxch-testing-chatbot-column">
1280 <div class="mxch-testing-chatbot-scope">
1281 <?php
1282 // Render the chatbot inline for testing
1283 echo do_shortcode('[mxchat_chatbot floating="no" bot_id="testing"]');
1284 ?>
1285 </div>
1286 </div>
1287 </div>
1288 </div>
1289
1290 </main>
1291 </div>
1292
1293 <script>
1294 document.addEventListener('DOMContentLoaded', function() {
1295 // Sidebar navigation
1296 const navLinks = document.querySelectorAll('.mxch-nav-link, .mxch-nav-sub-link');
1297 const sections = document.querySelectorAll('.mxch-section');
1298 const navItems = document.querySelectorAll('.mxch-nav-item');
1299
1300 function showSection(target) {
1301 // Show target section
1302 sections.forEach(section => {
1303 section.classList.remove('active');
1304 if (section.id === target) {
1305 section.classList.add('active');
1306 }
1307 });
1308
1309 // Scroll content area to top
1310 const contentArea = document.querySelector('.mxch-content');
1311 if (contentArea) {
1312 contentArea.scrollTop = 0;
1313 }
1314 }
1315
1316 function setActiveNav(clickedLink) {
1317 // Remove active from all links
1318 navLinks.forEach(l => l.classList.remove('active'));
1319
1320 // Add active to clicked link
1321 clickedLink.classList.add('active');
1322
1323 // If clicking a sub-link, also highlight parent
1324 if (clickedLink.classList.contains('mxch-nav-sub-link')) {
1325 const parent = clickedLink.closest('.mxch-nav-item');
1326 if (parent) {
1327 parent.querySelector('.mxch-nav-link').classList.add('active');
1328 }
1329 }
1330 }
1331
1332 navLinks.forEach(link => {
1333 link.addEventListener('click', function(e) {
1334 e.preventDefault();
1335 e.stopPropagation();
1336 const target = this.dataset.target;
1337 const parentItem = this.closest('.mxch-nav-item');
1338 const hasSubmenu = parentItem && parentItem.querySelector('.mxch-nav-sub');
1339
1340 // If this is a parent nav link WITH children (expandable menu)
1341 if (this.classList.contains('mxch-nav-link') && hasSubmenu) {
1342 const wasExpanded = parentItem.classList.contains('expanded');
1343
1344 // Collapse all other expandable items
1345 navItems.forEach(item => {
1346 if (item !== parentItem && item.querySelector('.mxch-nav-sub')) {
1347 item.classList.remove('expanded');
1348 }
1349 });
1350
1351 // Toggle this item
1352 parentItem.classList.toggle('expanded');
1353
1354 // If expanding, show the first sub-item's content and mark it active
1355 if (!wasExpanded) {
1356 const firstSubLink = parentItem.querySelector('.mxch-nav-sub-link');
1357 if (firstSubLink) {
1358 const firstTarget = firstSubLink.dataset.target;
1359 showSection(firstTarget);
1360 setActiveNav(firstSubLink);
1361 // Also mark parent as active
1362 this.classList.add('active');
1363 history.replaceState(null, null, '#' + firstTarget);
1364 }
1365 }
1366 }
1367 // If this is a nav link WITHOUT children (like API Keys, Tutorials)
1368 else if (this.classList.contains('mxch-nav-link') && !hasSubmenu && target) {
1369 // Collapse all expandable items
1370 navItems.forEach(item => {
1371 if (item.querySelector('.mxch-nav-sub')) {
1372 item.classList.remove('expanded');
1373 }
1374 });
1375
1376 // Show the section
1377 showSection(target);
1378 setActiveNav(this);
1379 history.replaceState(null, null, '#' + target);
1380 }
1381 // If this is a sub-link
1382 else if (this.classList.contains('mxch-nav-sub-link') && target) {
1383 // Ensure parent stays expanded
1384 if (parentItem) {
1385 parentItem.classList.add('expanded');
1386 }
1387 showSection(target);
1388 setActiveNav(this);
1389 history.replaceState(null, null, '#' + target);
1390 }
1391 });
1392 });
1393
1394 // Handle initial deep-link (?tab=<slug> takes precedence over #hash so the
1395 // Onboarding setup-step CTAs land on the right sub-tab). Whitelist of valid
1396 // section ids must stay in sync with the .mxch-section[id] values above.
1397 const validTabs = [
1398 'chatbot-ai-models', 'chatbot-behavior', 'chatbot-display',
1399 'chatbot-lead-capture', 'chatbot-quick-questions', 'chatbot-rate-limits',
1400 'api-keys', 'optimization', 'testing',
1401 'integrations-toolbar', 'integrations-loops', 'integrations-brave',
1402 'integrations-slack', 'integrations-telegram',
1403 'tutorials'
1404 ];
1405 function activateTab(target) {
1406 if (!target) return false;
1407 if (validTabs.indexOf(target) === -1) return false;
1408 const targetLink = document.querySelector('[data-target="' + target + '"]');
1409 if (!targetLink) return false;
1410 const parentItem = targetLink.closest('.mxch-nav-item');
1411 if (parentItem && targetLink.classList.contains('mxch-nav-sub-link')) {
1412 parentItem.classList.add('expanded');
1413 }
1414 showSection(target);
1415 setActiveNav(targetLink);
1416 return true;
1417 }
1418 const urlParams = new URLSearchParams(window.location.search);
1419 const tabParam = urlParams.get('tab');
1420 let tabActivated = false;
1421 if (tabParam) {
1422 tabActivated = activateTab(tabParam);
1423 // Invalid ?tab=… silently falls through to default (#hash or AI Models).
1424 }
1425 if (!tabActivated) {
1426 const hash = window.location.hash.slice(1);
1427 if (hash) {
1428 activateTab(hash);
1429 }
1430 }
1431
1432 // Rate limit accordion
1433 const rateLimitHeaders = document.querySelectorAll('.mxch-rate-limit-header');
1434 rateLimitHeaders.forEach(header => {
1435 header.addEventListener('click', function(e) {
1436 e.preventDefault();
1437 e.stopPropagation();
1438 const item = this.closest('.mxch-rate-limit-item');
1439 item.classList.toggle('expanded');
1440 });
1441 });
1442
1443 // Rate-limit "Custom…" toggle: show/hide the integer input below each
1444 // limit <select> based on whether __custom__ is the active option.
1445 document.querySelectorAll('.mxch-rate-limit-limit-select').forEach(sel => {
1446 const targetId = sel.getAttribute('data-mxch-custom-target');
1447 if (!targetId) return;
1448 const field = document.querySelector('[data-mxch-custom-for="' + targetId + '"]');
1449 if (!field) return;
1450 const sync = () => {
1451 if (sel.value === '__custom__') {
1452 field.hidden = false;
1453 } else {
1454 field.hidden = true;
1455 }
1456 };
1457 sel.addEventListener('change', sync);
1458 sync();
1459 });
1460
1461 // =====================================================
1462 // Mobile Menu Functionality
1463 // =====================================================
1464 const mobileMenuBtn = document.querySelector('.mxch-mobile-menu-btn');
1465 const mobileMenuClose = document.querySelector('.mxch-mobile-menu-close');
1466 const mobileMenu = document.querySelector('.mxch-mobile-menu');
1467 const mobileOverlay = document.querySelector('.mxch-mobile-overlay');
1468 const mobileNavLinks = document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link');
1469
1470 function openMobileMenu() {
1471 mobileMenu.classList.add('open');
1472 mobileOverlay.classList.add('open');
1473 document.body.style.overflow = 'hidden';
1474 }
1475
1476 function closeMobileMenu() {
1477 mobileMenu.classList.remove('open');
1478 mobileOverlay.classList.remove('open');
1479 document.body.style.overflow = '';
1480 }
1481
1482 if (mobileMenuBtn) {
1483 mobileMenuBtn.addEventListener('click', openMobileMenu);
1484 }
1485
1486 if (mobileMenuClose) {
1487 mobileMenuClose.addEventListener('click', closeMobileMenu);
1488 }
1489
1490 if (mobileOverlay) {
1491 mobileOverlay.addEventListener('click', closeMobileMenu);
1492 }
1493
1494 // Mobile navigation links
1495 mobileNavLinks.forEach(link => {
1496 link.addEventListener('click', function(e) {
1497 e.preventDefault();
1498 e.stopPropagation();
1499
1500 const target = this.dataset.target;
1501 const parentId = this.dataset.parent;
1502
1503 // If this is an expandable parent link
1504 if (parentId && !target) {
1505 const subNav = document.querySelector('.mxch-mobile-nav-sub[data-parent="' + parentId + '"]');
1506 if (subNav) {
1507 const isExpanded = subNav.classList.contains('expanded');
1508 // Collapse all sub navs
1509 document.querySelectorAll('.mxch-mobile-nav-sub').forEach(nav => {
1510 nav.classList.remove('expanded');
1511 });
1512 document.querySelectorAll('.mxch-mobile-nav-link').forEach(l => {
1513 l.classList.remove('expanded');
1514 });
1515 // Toggle this one
1516 if (!isExpanded) {
1517 subNav.classList.add('expanded');
1518 this.classList.add('expanded');
1519 }
1520 }
1521 }
1522 // If this is a direct link or sub-link with a target
1523 else if (target) {
1524 // Update mobile nav active state
1525 document.querySelectorAll('.mxch-mobile-nav-link, .mxch-mobile-nav-sub-link').forEach(l => {
1526 l.classList.remove('active');
1527 });
1528 this.classList.add('active');
1529
1530 // Also update desktop sidebar nav
1531 const desktopLink = document.querySelector('.mxch-sidebar [data-target="' + target + '"]');
1532 if (desktopLink) {
1533 setActiveNav(desktopLink);
1534 const parentItem = desktopLink.closest('.mxch-nav-item');
1535 if (parentItem && desktopLink.classList.contains('mxch-nav-sub-link')) {
1536 parentItem.classList.add('expanded');
1537 }
1538 }
1539
1540 // Show section and close menu
1541 showSection(target);
1542 history.replaceState(null, null, '#' + target);
1543 closeMobileMenu();
1544 }
1545 });
1546 });
1547
1548 // Close mobile menu on escape key
1549 document.addEventListener('keydown', function(e) {
1550 if (e.key === 'Escape' && mobileMenu && mobileMenu.classList.contains('open')) {
1551 closeMobileMenu();
1552 }
1553 });
1554 });
1555 </script>
1556 <?php
1557 }
1558
1559 /**
1560 * Helper function to render a field with consistent wrapper
1561 */
1562 function mxchat_render_field_wrapper($id, $label, $callback, $description = '') {
1563 ?>
1564 <div class="mxch-field">
1565 <label class="mxch-field-label"><?php echo esc_html($label); ?></label>
1566 <div class="mxch-field-control">
1567 <?php $callback(); ?>
1568 </div>
1569 <?php if ($description): ?>
1570 <p class="mxch-field-description"><?php echo esc_html($description); ?></p>
1571 <?php endif; ?>
1572 </div>
1573 <?php
1574 }
1575
1576 /**
1577 * Render rate limits as collapsible accordion
1578 */
1579 function mxchat_render_rate_limits_accordion($admin_instance) {
1580 $all_options = get_option('mxchat_options', []);
1581 $rate_limits = array('1', '3', '5', '10', '15', '20', '50', '100', 'unlimited');
1582 $timeframes = array(
1583 'hourly' => __('Per Hour', 'mxchat'),
1584 'daily' => __('Per Day', 'mxchat'),
1585 'weekly' => __('Per Week', 'mxchat'),
1586 'monthly' => __('Per Month', 'mxchat')
1587 );
1588
1589 $roles = wp_roles()->get_names();
1590 $roles['logged_out'] = __('Logged Out Users', 'mxchat');
1591
1592 // Whole-chatbot global cap (sits above per-role; defaults to unlimited so
1593 // existing installs are unchanged). Stored under mxchat_options['rate_limits_global'].
1594 $global_cfg = isset($all_options['rate_limits_global']) && is_array($all_options['rate_limits_global'])
1595 ? $all_options['rate_limits_global']
1596 : array();
1597 $global_limit_raw = isset($global_cfg['limit']) ? (string) $global_cfg['limit'] : 'unlimited';
1598 $global_timeframe = isset($global_cfg['timeframe']) ? (string) $global_cfg['timeframe'] : 'daily';
1599 $global_is_unlimited = ($global_limit_raw === '' || $global_limit_raw === 'unlimited');
1600 $global_is_preset = !$global_is_unlimited && in_array($global_limit_raw, $rate_limits, true);
1601 $global_select_value = $global_is_unlimited ? 'unlimited' : ($global_is_preset ? $global_limit_raw : '__custom__');
1602 $global_custom_value = (!$global_is_unlimited && !$global_is_preset && ctype_digit($global_limit_raw))
1603 ? $global_limit_raw
1604 : '';
1605
1606 echo '<div class="mxch-rate-limits">';
1607
1608 // --- Global cap card -------------------------------------------------
1609 ?>
1610 <div class="mxch-rate-limit-item mxch-rate-limit-global mxchat-autosave-section">
1611 <div class="mxch-rate-limit-header">
1612 <span class="mxch-rate-limit-role"><?php esc_html_e('Total chatbot message limit', 'mxchat'); ?></span>
1613 <div class="mxch-rate-limit-summary">
1614 <span class="mxch-rate-limit-badge mxch-rate-limit-global-badge">
1615 <?php
1616 if ($global_is_unlimited) {
1617 esc_html_e('Unlimited', 'mxchat');
1618 } else {
1619 $tf_label = isset($timeframes[$global_timeframe]) ? $timeframes[$global_timeframe] : $global_timeframe;
1620 echo esc_html(($global_custom_value !== '' ? $global_custom_value : $global_limit_raw) . ' / ' . $tf_label);
1621 }
1622 ?>
1623 </span>
1624 <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>
1625 </div>
1626 </div>
1627 <div class="mxch-rate-limit-body">
1628 <p class="mxch-field-description" style="margin: 0 0 12px;">
1629 <?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'); ?>
1630 </p>
1631 <div class="mxch-rate-limit-controls">
1632 <div class="mxch-field">
1633 <label class="mxch-field-label" for="rate_limits_global_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1634 <select id="rate_limits_global_limit"
1635 name="mxchat_options[rate_limits_global][limit]"
1636 class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1637 data-mxch-custom-target="rate_limits_global_limit_custom">
1638 <?php foreach ($rate_limits as $limit): ?>
1639 <option value="<?php echo esc_attr($limit); ?>" <?php selected($global_select_value, $limit); ?>>
1640 <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1641 </option>
1642 <?php endforeach; ?>
1643 <option value="__custom__" <?php selected($global_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1644 </select>
1645 </div>
1646 <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'; ?>>
1647 <label class="mxch-field-label" for="rate_limits_global_limit_custom"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1648 <input type="number"
1649 min="1"
1650 step="1"
1651 id="rate_limits_global_limit_custom"
1652 name="mxchat_options[rate_limits_global][limit_custom]"
1653 class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1654 placeholder="e.g. 250"
1655 value="<?php echo esc_attr($global_custom_value); ?>" />
1656 </div>
1657 <div class="mxch-field">
1658 <label class="mxch-field-label" for="rate_limits_global_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1659 <select id="rate_limits_global_timeframe"
1660 name="mxchat_options[rate_limits_global][timeframe]"
1661 class="mxch-select mxchat-autosave-field">
1662 <?php foreach ($timeframes as $value => $label): ?>
1663 <option value="<?php echo esc_attr($value); ?>" <?php selected($global_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1664 <?php endforeach; ?>
1665 </select>
1666 </div>
1667 </div>
1668 <?php
1669 // --- Current usage readout (read-only; mirrors the integrator's
1670 // window-reset math at READ time — never writes the counter here).
1671 // v1 surfaces the DEFAULT bot's pool. TODO: per-bot selector if asked.
1672 $global_usage_limit_int = (!$global_is_unlimited && ctype_digit($global_limit_raw))
1673 ? (int) $global_limit_raw
1674 : 0;
1675 $usage_raw = get_option('mxchat_chat_limit_default_global', array('count' => 0, 'timestamp' => time()));
1676 $usage_count = isset($usage_raw['count']) ? (int) $usage_raw['count'] : 0;
1677 $usage_ts = isset($usage_raw['timestamp']) ? (int) $usage_raw['timestamp'] : time();
1678 $usage_windows = array('hourly' => 3600, 'daily' => 86400, 'weekly' => 604800, 'monthly' => 2592000);
1679 $usage_window = isset($usage_windows[$global_timeframe]) ? $usage_windows[$global_timeframe] : 86400;
1680 $usage_now = time();
1681 if (($usage_now - $usage_ts) >= $usage_window) {
1682 // Window elapsed since the stored timestamp → effective count is 0.
1683 $usage_count = 0;
1684 $usage_reset_at = $usage_now + $usage_window;
1685 } else {
1686 $usage_reset_at = $usage_ts + $usage_window;
1687 }
1688 $usage_left = max(0, $global_usage_limit_int - $usage_count);
1689 $usage_pct = ($global_usage_limit_int > 0)
1690 ? min(100, (int) round(($usage_count / $global_usage_limit_int) * 100))
1691 : 0;
1692 $usage_reset_nonce = wp_create_nonce('mxchat_reset_global_usage');
1693 ?>
1694 <div class="mxch-rate-limit-usage"
1695 id="mxch-global-usage"
1696 data-bot-id="default"
1697 data-reset-nonce="<?php echo esc_attr($usage_reset_nonce); ?>"
1698 <?php echo $global_is_unlimited ? 'hidden' : ''; ?>>
1699 <div class="mxch-rate-limit-usage-head">
1700 <span class="mxch-field-label" style="margin:0;"><?php esc_html_e('Current usage', 'mxchat'); ?></span>
1701 <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>
1702 </div>
1703 <div class="mxch-progress-bar">
1704 <div class="mxch-progress-bar-fill" id="mxch-global-usage-fill" style="width: <?php echo esc_attr($usage_pct); ?>%;"></div>
1705 </div>
1706 <p class="mxch-progress-label" id="mxch-global-usage-text" style="margin:0;">
1707 <?php
1708 printf(
1709 /* translators: 1: used count, 2: limit, 3: remaining, 4: human-readable time until reset */
1710 esc_html__('%1$s of %2$s used · %3$s left · resets in %4$s', 'mxchat'),
1711 esc_html(number_format_i18n($usage_count)),
1712 esc_html(number_format_i18n($global_usage_limit_int)),
1713 esc_html(number_format_i18n($usage_left)),
1714 esc_html(human_time_diff($usage_now, $usage_reset_at))
1715 );
1716 ?>
1717 </p>
1718 </div>
1719 <p class="mxch-field-description mxch-rate-limit-usage-unlimited"
1720 id="mxch-global-usage-unlimited"
1721 style="margin: 12px 0 0;"
1722 <?php echo $global_is_unlimited ? '' : 'hidden'; ?>>
1723 <?php esc_html_e('Unlimited — no cap. Usage tracking applies only when a numeric limit is set.', 'mxchat'); ?>
1724 </p>
1725 </div>
1726 </div>
1727 <?php
1728 // ---------------------------------------------------------------------
1729
1730 foreach ($roles as $role_id => $role_name) {
1731 $default_limit = ($role_id === 'logged_out') ? '10' : '100';
1732 $default_timeframe = 'daily';
1733 $default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
1734
1735 $selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
1736 ? (string) $all_options['rate_limits'][$role_id]['limit']
1737 : $default_limit;
1738
1739 $selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
1740 ? $all_options['rate_limits'][$role_id]['timeframe']
1741 : $default_timeframe;
1742
1743 $custom_message = isset($all_options['rate_limits'][$role_id]['message'])
1744 ? $all_options['rate_limits'][$role_id]['message']
1745 : $default_message;
1746
1747 $timeframe_label = isset($timeframes[$selected_timeframe]) ? $timeframes[$selected_timeframe] : $selected_timeframe;
1748
1749 // Custom-value handling: if the stored limit is not in the preset list
1750 // and not 'unlimited', it's a custom integer. The select shows __custom__
1751 // and the number input below carries the actual value.
1752 $is_preset_limit = in_array($selected_limit, $rate_limits, true);
1753 $role_select_value = $is_preset_limit ? $selected_limit : '__custom__';
1754 $role_custom_value = (!$is_preset_limit && ctype_digit($selected_limit)) ? $selected_limit : '';
1755 $custom_field_id = 'rate_limits_' . $role_id . '_limit_custom';
1756 ?>
1757 <div class="mxch-rate-limit-item">
1758 <div class="mxch-rate-limit-header">
1759 <span class="mxch-rate-limit-role"><?php echo esc_html($role_name); ?></span>
1760 <div class="mxch-rate-limit-summary">
1761 <span class="mxch-rate-limit-badge"><?php echo esc_html($selected_limit . ' / ' . $timeframe_label); ?></span>
1762 <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>
1763 </div>
1764 </div>
1765 <div class="mxch-rate-limit-body mxchat-autosave-section">
1766 <div class="mxch-rate-limit-controls">
1767 <div class="mxch-field">
1768 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_limit"><?php esc_html_e('Limit', 'mxchat'); ?></label>
1769 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_limit"
1770 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit]"
1771 class="mxch-select mxchat-autosave-field mxch-rate-limit-limit-select"
1772 data-mxch-custom-target="<?php echo esc_attr($custom_field_id); ?>">
1773 <?php foreach ($rate_limits as $limit): ?>
1774 <option value="<?php echo esc_attr($limit); ?>" <?php selected($role_select_value, $limit); ?>>
1775 <?php echo esc_html($limit === 'unlimited' ? __('Unlimited', 'mxchat') : $limit); ?>
1776 </option>
1777 <?php endforeach; ?>
1778 <option value="__custom__" <?php selected($role_select_value, '__custom__'); ?>><?php esc_html_e('Custom…', 'mxchat'); ?></option>
1779 </select>
1780 </div>
1781 <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'; ?>>
1782 <label class="mxch-field-label" for="<?php echo esc_attr($custom_field_id); ?>"><?php esc_html_e('Custom limit', 'mxchat'); ?></label>
1783 <input type="number"
1784 min="1"
1785 step="1"
1786 id="<?php echo esc_attr($custom_field_id); ?>"
1787 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][limit_custom]"
1788 class="mxch-input mxchat-autosave-field mxch-rate-limit-custom-input"
1789 placeholder="e.g. 250"
1790 value="<?php echo esc_attr($role_custom_value); ?>" />
1791 </div>
1792 <div class="mxch-field">
1793 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"><?php esc_html_e('Timeframe', 'mxchat'); ?></label>
1794 <select id="rate_limits_<?php echo esc_attr($role_id); ?>_timeframe"
1795 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][timeframe]"
1796 class="mxch-select mxchat-autosave-field">
1797 <?php foreach ($timeframes as $value => $label): ?>
1798 <option value="<?php echo esc_attr($value); ?>" <?php selected($selected_timeframe, $value); ?>><?php echo esc_html($label); ?></option>
1799 <?php endforeach; ?>
1800 </select>
1801 </div>
1802 </div>
1803 <div class="mxch-field">
1804 <label class="mxch-field-label" for="rate_limits_<?php echo esc_attr($role_id); ?>_message"><?php esc_html_e('Custom Message', 'mxchat'); ?></label>
1805 <textarea id="rate_limits_<?php echo esc_attr($role_id); ?>_message"
1806 name="mxchat_options[rate_limits][<?php echo esc_attr($role_id); ?>][message]"
1807 class="mxch-textarea mxchat-autosave-field"
1808 rows="2"
1809 placeholder="<?php esc_attr_e('Message shown when rate limit is reached', 'mxchat'); ?>"><?php echo esc_textarea($custom_message); ?></textarea>
1810 </div>
1811 </div>
1812 </div>
1813 <?php
1814 }
1815
1816 echo '</div>';
1817 }
1818