PluginProbe
MxChat – AI Chatbot & Content Generation for WordPress / 3.0.7
MxChat – AI Chatbot & Content Generation for WordPress v3.0.7
3.2.21 3.2.20 3.2.19 3.2.18 3.2.17 3.2.16 3.2.15 3.2.14 3.2.12 3.2.13 3.2.11 3.2.10 3.2.9 3.2.8 3.2.7 3.2.6 3.2.5 3.2.4 3.2.3 3.2.2 3.2.1 2.0.3 2.0.4 2.0.5 2.0.6 All 152 releases
← All changes | mxchat-basic.php +1142 -1939 3.2.17 → 3.0.7 View file →
@@ -1,1939 +1,1142 @@
1 -<?php
2 -/**
3 - * Plugin Name: MxChat
4 - * Plugin URI: https://mxchat.ai/
5 - * Description: AI chatbot for WordPress with OpenAI, Claude, xAI, DeepSeek, live agent, PDF uploads, WooCommerce, and training on website data.
6 - * Version: 3.2.17
7 - * Author: MxChat
8 - * Author URI: https://mxchat.ai
9 - * License: GPLv2 or later
10 - * License URI: https://www.gnu.org/licenses/gpl-2.0.html
11 - * Text Domain: mxchat
12 - * Domain Path: /languages
13 - */
14 -
15 -if (!defined('ABSPATH')) {
16 - exit; // Exit if accessed directly.
17 -}
18 -
19 -
20 -if (!defined('MXCHAT_DEV_MODE')) {
21 - define('MXCHAT_DEV_MODE', false);
22 -}
23 -
24 -if (!defined('MXCHAT_VERSION')) {
25 - $plugin_data = get_file_data(__FILE__, array('Version' => 'Version'), 'plugin');
26 - $version = $plugin_data['Version'];
27 - // MXCHAT_BASE_VERSION: the plain header version, stable across requests even in
28 - // dev mode. Use it for anything PERSISTED or COMPARED (the stored
29 - // mxchat_plugin_version option and the migration gate in
30 - // mxchat_check_for_update). MXCHAT_VERSION keeps the time() suffix in dev for
31 - // ASSET cache-busting only — persisting the suffixed value made the version
32 - // comparison churn every request, re-running the full activation/migration
33 - // suite per page load on dev installs.
34 - define('MXCHAT_BASE_VERSION', $version);
35 - if (MXCHAT_DEV_MODE) {
36 - $version .= '.' . time();
37 - }
38 - define('MXCHAT_VERSION', $version);
39 -}
40 -
41 -/**
42 - * Honest, versioned User-Agent for MXChat remote-content ingestion fetches
43 - * (Knowledge Base PDF import, URL import, sitemap / website crawl).
44 - *
45 - * WAF rulesets (SiteGround/ModSecurity, Wordfence, Cloudflare managed rules)
46 - * flag stale spoofed-browser UAs as scrapers and return 403 — which silently
47 - * broke the single most common KB source: self-hosted media on the site's own
48 - * domain. A truthful crawler identifier is the industry norm for well-behaved
49 - * bots and lets a site owner allowlist "MXChatBot" in their WAF. Filterable so
50 - * a locked-down host can supply a different string without a code change.
51 - */
52 -if (!function_exists('mxchat_ingest_user_agent')) {
53 - function mxchat_ingest_user_agent() {
54 - $version = defined('MXCHAT_VERSION') ? MXCHAT_VERSION : '1.0';
55 - $ua = 'MXChatBot/' . $version . ' (+https://mxchat.ai/bot)';
56 - return apply_filters('mxchat_ingest_user_agent', $ua);
57 - }
58 -}
59 -
60 -function mxchat_load_textdomain() {
61 - $domain = 'mxchat';
62 - $locale = determine_locale();
63 -
64 - // First, try to load from /wp-content/languages/plugins/ (preserved during updates)
65 - $mo_file = WP_LANG_DIR . '/plugins/' . $domain . '-' . $locale . '.mo';
66 - if (file_exists($mo_file)) {
67 - load_textdomain($domain, $mo_file);
68 - return;
69 - }
70 -
71 - // Fallback to plugin's /languages directory
72 - load_plugin_textdomain($domain, false, dirname(plugin_basename(__FILE__)) . '/languages');
73 -}
74 -add_action('init', 'mxchat_load_textdomain');
75 -
76 -/**
77 - * One-time migration: gemini-3-pro-preview was shut down by Google on March 9, 2026.
78 - * Existing installs with the dead ID get auto-remapped to gemini-3.1-pro-preview
79 - * (Google's official migration target) the first time admin_init fires after update.
80 - */
81 -add_action('admin_init', function () {
82 - if (get_option('mxchat_gemini_3_remap_done')) {
83 - return;
84 - }
85 - $opts = get_option('mxchat_options');
86 - if (is_array($opts) && isset($opts['model']) && $opts['model'] === 'gemini-3-pro-preview') {
87 - $opts['model'] = 'gemini-3.1-pro-preview';
88 - update_option('mxchat_options', $opts);
89 - }
90 - if (is_array($opts) && isset($opts['content_model']) && $opts['content_model'] === 'gemini-3-pro-preview') {
91 - $opts['content_model'] = 'gemini-3.1-pro-preview';
92 - update_option('mxchat_options', $opts);
93 - }
94 - update_option('mxchat_gemini_3_remap_done', 1);
95 -});
96 -
97 -/**
98 - * One-time migration: the Grok 2 family was retired by xAI (grok-2, grok-2-1212,
99 - * grok-2-latest, grok-2-vision-1212 all return 400 "Model not found"). Existing
100 - * installs with the dead ID get auto-remapped to grok-4-1-fast-non-reasoning
101 - * (modern, fast, broadly available) the first time admin_init fires after update.
102 - */
103 -add_action('admin_init', function () {
104 - if (get_option('mxchat_grok_2_remap_done')) {
105 - return;
106 - }
107 - $opts = get_option('mxchat_options');
108 - if (is_array($opts) && isset($opts['model']) && $opts['model'] === 'grok-2') {
109 - $opts['model'] = 'grok-4-1-fast-non-reasoning';
110 - update_option('mxchat_options', $opts);
111 - }
112 - if (is_array($opts) && isset($opts['content_model']) && $opts['content_model'] === 'grok-2') {
113 - $opts['content_model'] = 'grok-4-1-fast-non-reasoning';
114 - update_option('mxchat_options', $opts);
115 - }
116 - update_option('mxchat_grok_2_remap_done', 1);
117 -});
118 -
119 -/**
120 - * One-time migration: Anthropic retired the Claude 4 (2025-05-14) snapshots on
121 - * June 15, 2026 — claude-opus-4-20250514 and claude-sonnet-4-20250514 now return
122 - * an API error. Existing installs with a dead ID get auto-remapped to the current
123 - * equivalents Anthropic recommends (Opus 4.8 / Sonnet 4.6) the first time admin_init
124 - * fires after update. Mirrors the gemini-3-pro-preview / grok-2 rescues above.
125 - */
126 -add_action('admin_init', function () {
127 - if (get_option('mxchat_claude_4_retire_remap_done')) {
128 - return;
129 - }
130 - $map = array(
131 - 'claude-opus-4-20250514' => 'claude-opus-4-8',
132 - 'claude-sonnet-4-20250514' => 'claude-sonnet-4-6',
133 - );
134 - $opts = get_option('mxchat_options');
135 - if (is_array($opts)) {
136 - $changed = false;
137 - if (isset($opts['model']) && isset($map[$opts['model']])) {
138 - $opts['model'] = $map[$opts['model']];
139 - $changed = true;
140 - }
141 - if (isset($opts['content_model']) && isset($map[$opts['content_model']])) {
142 - $opts['content_model'] = $map[$opts['content_model']];
143 - $changed = true;
144 - }
145 - if ($changed) {
146 - update_option('mxchat_options', $opts);
147 - }
148 - }
149 - update_option('mxchat_claude_4_retire_remap_done', 1);
150 -});
151 -
152 -/**
153 - * Exclude MxChat assets from caching plugin optimizations
154 - *
155 - * This prevents issues with WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache,
156 - * W3 Total Cache, SG Optimizer, and similar plugins that may break the chatbot by
157 - * removing "unused" CSS, minifying/combining JS, or deferring/delaying jQuery.
158 - *
159 - * Both chat-script.js and floating-script.js depend on jQuery, so jQuery must also
160 - * be excluded from any optimization that changes load order or timing.
161 - */
162 -
163 -// ── WP Rocket ────────────────────────────────────────────────────────────────
164 -
165 -// Exclude from Remove Unused CSS (RUCSS)
166 -add_filter('rocket_rucss_inline_atts_exclusions', function($exclusions) {
167 - if (!is_array($exclusions)) $exclusions = array();
168 - $exclusions[] = 'mxchat';
169 - return $exclusions;
170 -});
171 -
172 -// Exclude CSS from minification/combination
173 -add_filter('rocket_exclude_css', function($excluded) {
174 - if (!is_array($excluded)) $excluded = array();
175 - $excluded[] = '/plugins/mxchat-basic/css/chat-style.css';
176 - return $excluded;
177 -});
178 -
179 -// Exclude JS from minification/combination
180 -add_filter('rocket_exclude_js', function($excluded) {
181 - if (!is_array($excluded)) $excluded = array();
182 - $excluded[] = '/plugins/mxchat-basic/js/chat-script.js';
183 - $excluded[] = '/plugins/mxchat-basic/js/floating-script.js';
184 - $excluded[] = '/jquery-core';
185 - $excluded[] = '/jquery.min.js';
186 - $excluded[] = '/jquery.js';
187 - $excluded[] = '/jquery-migrate';
188 - return $excluded;
189 -});
190 -
191 -// Exclude JS from defer
192 -add_filter('rocket_exclude_defer_js', function($excluded) {
193 - if (!is_array($excluded)) $excluded = array();
194 - $excluded[] = '/plugins/mxchat-basic/js/chat-script.js';
195 - $excluded[] = '/plugins/mxchat-basic/js/floating-script.js';
196 - $excluded[] = '/jquery-core';
197 - $excluded[] = '/jquery.min.js';
198 - $excluded[] = '/jquery.js';
199 - $excluded[] = '/jquery-migrate';
200 - return $excluded;
201 -});
202 -
203 -// Exclude from delay JS execution
204 -add_filter('rocket_delay_js_exclusions', function($excluded) {
205 - if (!is_array($excluded)) $excluded = array();
206 - $excluded[] = 'mxchat';
207 - $excluded[] = 'chat-script';
208 - $excluded[] = 'floating-script';
209 - $excluded[] = '/jquery-core';
210 - $excluded[] = '/jquery.min.js';
211 - $excluded[] = '/jquery.js';
212 - $excluded[] = '/jquery-migrate';
213 - return $excluded;
214 -});
215 -
216 -// ── LiteSpeed Cache ──────────────────────────────────────────────────────────
217 -
218 -// Exclude CSS from optimization
219 -add_filter('litespeed_optimize_css_excludes', function($excluded) {
220 - if (!is_array($excluded)) $excluded = array();
221 - $excluded[] = 'chat-style.css';
222 - $excluded[] = 'mxchat';
223 - return $excluded;
224 -});
225 -
226 -// Exclude from UCSS (Unique CSS) - prevents LiteSpeed from stripping "unused" MxChat CSS
227 -add_filter('litespeed_ucss_whitelist', function($whitelist) {
228 - if (!is_array($whitelist)) $whitelist = array();
229 - $whitelist[] = '.mxchat-chatbot-wrapper';
230 - $whitelist[] = '.floating-chatbot';
231 - $whitelist[] = '.floating-chatbot-button';
232 - $whitelist[] = '.chatbot-top-bar';
233 - $whitelist[] = '.mxchat-chatbot';
234 - $whitelist[] = '.chat-container';
235 - $whitelist[] = '.chat-box';
236 - $whitelist[] = '.bot-message';
237 - $whitelist[] = '.input-container';
238 - $whitelist[] = '.chat-input';
239 - $whitelist[] = '.send-button';
240 - $whitelist[] = '.pre-chat-message';
241 - $whitelist[] = '.mxchat-popular-questions';
242 - $whitelist[] = '.chat-toolbar';
243 - $whitelist[] = '.exit-chat';
244 - $whitelist[] = '.email-blocker';
245 - return $whitelist;
246 -});
247 -
248 -// Exclude CSS from CCSS (Critical CSS) generation
249 -add_filter('litespeed_optm_ccss_exc', function($excluded) {
250 - if (!is_array($excluded)) $excluded = array();
251 - $excluded[] = 'chat-style.css';
252 - $excluded[] = 'mxchat';
253 - return $excluded;
254 -});
255 -
256 -// Exclude JS from defer
257 -add_filter('litespeed_optm_js_defer_exc', function($excluded) {
258 - if (!is_array($excluded)) $excluded = array();
259 - $excluded[] = 'chat-script.js';
260 - $excluded[] = 'floating-script.js';
261 - $excluded[] = 'mxchat';
262 - $excluded[] = 'jquery.min.js';
263 - $excluded[] = 'jquery.js';
264 - return $excluded;
265 -});
266 -
267 -// Exclude JS from combining
268 -add_filter('litespeed_optm_js_exc', function($excluded) {
269 - if (!is_array($excluded)) $excluded = array();
270 - $excluded[] = 'chat-script.js';
271 - $excluded[] = 'floating-script.js';
272 - $excluded[] = 'mxchat';
273 - $excluded[] = 'jquery.min.js';
274 - $excluded[] = 'jquery.js';
275 - return $excluded;
276 -});
277 -
278 -// Exclude JS from delayed execution
279 -add_filter('litespeed_optm_js_delay_exc', function($excluded) {
280 - if (!is_array($excluded)) $excluded = array();
281 - $excluded[] = 'chat-script.js';
282 - $excluded[] = 'floating-script.js';
283 - $excluded[] = 'mxchat';
284 - return $excluded;
285 -});
286 -
287 -// Exclude from Guest Mode optimization
288 -add_filter('litespeed_guest_optm_exc', function($excluded) {
289 - if (!is_array($excluded)) $excluded = array();
290 - $excluded[] = 'mxchat';
291 - $excluded[] = 'chat-style';
292 - $excluded[] = 'chat-script';
293 - $excluded[] = 'floating-script';
294 - return $excluded;
295 -});
296 -
297 -// ── Autoptimize ──────────────────────────────────────────────────────────────
298 -
299 -// Exclude CSS from optimization (comma-separated strings)
300 -add_filter('autoptimize_filter_css_exclude', function($excluded) {
301 - if (!is_string($excluded)) $excluded = '';
302 - return $excluded . ', mxchat, chat-style.css';
303 -});
304 -
305 -// Exclude JS from optimization (comma-separated strings)
306 -add_filter('autoptimize_filter_js_exclude', function($excluded) {
307 - if (!is_string($excluded)) $excluded = '';
308 - return $excluded . ', mxchat, chat-script.js, floating-script.js, jquery.min.js, jquery.js';
309 -});
310 -
311 -// ── SG Optimizer (SiteGround) ────────────────────────────────────────────────
312 -
313 -add_filter('sgo_js_minify_exclude', function($excluded) {
314 - if (!is_array($excluded)) $excluded = array();
315 - $excluded[] = 'chat-script.js';
316 - $excluded[] = 'floating-script.js';
317 - $excluded[] = 'jquery.min.js';
318 - return $excluded;
319 -});
320 -
321 -add_filter('sgo_javascript_combine_exclude', function($excluded) {
322 - if (!is_array($excluded)) $excluded = array();
323 - $excluded[] = 'chat-script.js';
324 - $excluded[] = 'floating-script.js';
325 - $excluded[] = 'jquery.min.js';
326 - return $excluded;
327 -});
328 -
329 -add_filter('sgo_js_async_exclude', function($excluded) {
330 - if (!is_array($excluded)) $excluded = array();
331 - $excluded[] = 'chat-script.js';
332 - $excluded[] = 'floating-script.js';
333 - $excluded[] = 'jquery.min.js';
334 - return $excluded;
335 -});
336 -
337 -// ── W3 Total Cache ───────────────────────────────────────────────────────────
338 -
339 -add_filter('w3tc_minify_js_do_tag_minification', function($do_minify, $script_tag, $file) {
340 - if (strpos($file, 'chat-script.js') !== false ||
341 - strpos($file, 'floating-script.js') !== false ||
342 - strpos($file, 'jquery.min.js') !== false ||
343 - strpos($file, 'jquery.js') !== false) {
344 - return false;
345 - }
346 - return $do_minify;
347 -}, 10, 3);
348 -
349 -// ── WP Super Cache ──────────────────────────────────────────────────────────
350 -
351 -add_filter('wpsc_rejected_uri', function($rejected) {
352 - if (!is_array($rejected)) $rejected = array();
353 - $rejected[] = 'wp-admin/admin-ajax.php';
354 - return $rejected;
355 -});
356 -
357 -// ── Page-cache bypass for chat AJAX (companion to the 3.2.6 nonce-race hotfix)
358 -// Each cache plugin gets its own filter export so that visitors hitting an
359 -// edge-cached page never receive cached chat-AJAX responses. The chat send /
360 -// stream send / file upload all POST to /wp-admin/admin-ajax.php with
361 -// `action=mxchat_*`. Without these exports, a cache plugin can stale a response
362 -// and break the per-session nonce flow on the first message.
363 -
364 -// WP Rocket — `rocket_cache_reject_uri` takes a flat array of regex strings.
365 -add_filter('rocket_cache_reject_uri', function($uris) {
366 - if (!is_array($uris)) $uris = array();
367 - $uris[] = '/wp-admin/admin-ajax\.php\?action=mxchat_.*';
368 - return $uris;
369 -});
370 -
371 -// LiteSpeed Cache — `litespeed_cache_no_cache_for_request` short-circuits
372 -// caching when the request matches our chat-AJAX pattern.
373 -add_filter('litespeed_cache_no_cache_for_request', function($no_cache) {
374 - if ($no_cache) return $no_cache;
375 - if (!empty($_SERVER['REQUEST_URI']) &&
376 - strpos($_SERVER['REQUEST_URI'], '/wp-admin/admin-ajax.php') !== false &&
377 - !empty($_REQUEST['action']) &&
378 - strpos((string) $_REQUEST['action'], 'mxchat_') === 0) {
379 - return true;
380 - }
381 - return $no_cache;
382 -});
383 -
384 -// W3 Total Cache — `w3tc_pgcache_request_skip_uri` flips page-cache off when
385 -// the URI matches.
386 -add_filter('w3tc_pgcache_request_skip_uri', function($skip) {
387 - if ($skip) return $skip;
388 - if (!empty($_SERVER['REQUEST_URI']) &&
389 - strpos($_SERVER['REQUEST_URI'], '/wp-admin/admin-ajax.php') !== false &&
390 - !empty($_REQUEST['action']) &&
391 - strpos((string) $_REQUEST['action'], 'mxchat_') === 0) {
392 - return true;
393 - }
394 - return $skip;
395 -});
396 -
397 -// FlyingPress — `flying_press_cacheable` takes a boolean and is run per
398 -// request. Same pattern as LiteSpeed / W3TC.
399 -add_filter('flying_press_cacheable', function($cacheable) {
400 - if (!$cacheable) return $cacheable;
401 - if (!empty($_SERVER['REQUEST_URI']) &&
402 - strpos($_SERVER['REQUEST_URI'], '/wp-admin/admin-ajax.php') !== false &&
403 - !empty($_REQUEST['action']) &&
404 - strpos((string) $_REQUEST['action'], 'mxchat_') === 0) {
405 - return false;
406 - }
407 - return $cacheable;
408 -});
409 -
410 -// Include classes with error handling
411 -function mxchat_include_classes() {
412 - $class_files = array(
413 - 'includes/class-mxchat-model-catalog.php',
414 - 'includes/class-mxchat-live-agent-schedule.php',
415 - 'includes/class-mxchat-tool-registry.php',
416 - 'includes/class-mxchat-integrator.php',
417 - 'includes/class-mxchat-admin.php',
418 - 'includes/class-mxchat-public.php',
419 - 'includes/class-mxchat-utils.php',
420 - 'includes/class-mxchat-user.php',
421 - 'includes/class-mxchat-privacy.php',
422 - 'includes/class-mxchat-meta-box.php',
423 - 'includes/class-mxchat-chunker.php',
424 - 'includes/class-mxchat-word-handler.php',
425 - 'includes/class-mxchat-content-generator.php',
426 - 'includes/class-mxchat-cache-purge.php',
427 - 'includes/class-mxchat-editor-assistant.php',
428 - 'includes/class-rest-api.php',
429 - 'admin/class-ajax-handler.php',
430 - 'admin/class-pinecone-manager.php',
431 - 'admin/class-knowledge-manager.php'
432 - );
433 -
434 - foreach ($class_files as $file) {
435 - $file_path = plugin_dir_path(__FILE__) . $file;
436 - if (file_exists($file_path)) {
437 - require_once $file_path;
438 - } else {
439 - //error_log('MxChat: Missing class file - ' . $file);
440 - }
441 - }
442 -
443 - // Register the native function-calling admin-post save handler (a41dee).
444 - if (class_exists('MxChat_Tool_Registry')) {
445 - MxChat_Tool_Registry::init();
446 - }
447 -
448 - // GDPR: register with WP's personal-data export/erase tools (b81e42).
449 - if (class_exists('MxChat_Privacy')) {
450 - MxChat_Privacy::init();
451 - }
452 -
453 - // Editor Assistant — free, OFF-by-default block-editor AI actions (plan-8cb0cb).
454 - // init() wires REST + streaming AJAX + sidebar enqueue ONLY when the
455 - // mxchat_editor_assistant_enabled option is 'on'; otherwise zero footprint.
456 - if (class_exists('MxChat_Editor_Assistant')) {
457 - MxChat_Editor_Assistant::init();
458 - }
459 -
460 - // Admin pages that aren't classes (procedural include).
461 - if (is_admin()) {
462 - $admin_api_page = plugin_dir_path(__FILE__) . 'includes/admin-api-page.php';
463 - if (file_exists($admin_api_page)) {
464 - require_once $admin_api_page;
465 - }
466 - // f7c7d4 renamed this file admin-dashboard-page.php → admin-onboarding-page.php.
467 - // The require MUST live here (admin bootstrap) and not just inside
468 - // mxchat_add_plugin_page() on the admin_menu hook — admin_menu does NOT
469 - // fire on admin-ajax.php requests, so the wizard's AJAX handlers
470 - // (plan-905439: mxchat_onboarding_kb_status / save_step / mark_step /
471 - // auto_graduate + the f7c7d4 dismiss handler) would never register.
472 - $admin_onboarding_page = plugin_dir_path(__FILE__) . 'includes/admin-onboarding-page.php';
473 - if (file_exists($admin_onboarding_page)) {
474 - require_once $admin_onboarding_page;
475 - }
476 - }
477 -}
478 -
479 -/**
480 - * Lazy-load the PDF parser library only when needed.
481 - * Avoids loading 44 files on every page request.
482 - */
483 -function mxchat_load_pdf_parser() {
484 - if (class_exists('\Smalot\PdfParser\Parser')) {
485 - return true;
486 - }
487 - $autoload_path = plugin_dir_path(__FILE__) . 'includes/pdf-parser/alt_autoload.php';
488 - if (file_exists($autoload_path)) {
489 - require_once $autoload_path;
490 - return true;
491 - }
492 - return false;
493 -}
494 -
495 -/**
496 - * Create URL click tracking table
497 - */
498 -function mxchat_create_url_clicks_table() {
499 - global $wpdb;
500 -
501 - $table_name = $wpdb->prefix . 'mxchat_url_clicks';
502 -
503 - $charset_collate = $wpdb->get_charset_collate();
504 -
505 - $sql = "CREATE TABLE $table_name (
506 - id mediumint(9) NOT NULL AUTO_INCREMENT,
507 - session_id varchar(100) NOT NULL,
508 - clicked_url text NOT NULL,
509 - message_context text,
510 - click_timestamp datetime DEFAULT CURRENT_TIMESTAMP,
511 - user_ip varchar(45),
512 - user_agent text,
513 - PRIMARY KEY (id),
514 - KEY session_id (session_id),
515 - KEY click_timestamp (click_timestamp)
516 - ) $charset_collate;";
517 -
518 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
519 - dbDelta($sql);
520 -}
521 -
522 -/**
523 - * FIXED: Robust table creation and column management
524 - */
525 -function mxchat_create_chat_transcripts_table() {
526 - global $wpdb;
527 -
528 - $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
529 - $charset_collate = $wpdb->get_charset_collate();
530 -
531 - // Create table with ALL columns including user_name from the start
532 - $sql = "CREATE TABLE $table_name (
533 - id MEDIUMINT(9) NOT NULL AUTO_INCREMENT,
534 - user_id MEDIUMINT(9) DEFAULT 0,
535 - session_id VARCHAR(255) NOT NULL,
536 - role VARCHAR(255) NOT NULL,
537 - message TEXT NOT NULL,
538 - user_email VARCHAR(255) DEFAULT NULL,
539 - user_name VARCHAR(100) DEFAULT NULL,
540 - user_identifier VARCHAR(255) DEFAULT NULL,
541 - originating_page_url TEXT DEFAULT NULL,
542 - originating_page_title VARCHAR(500) DEFAULT NULL,
543 - timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
544 - PRIMARY KEY (id),
545 - KEY session_id (session_id),
546 - KEY user_email (user_email),
547 - KEY timestamp (timestamp)
548 - ) $charset_collate;";
549 -
550 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
551 - $result = dbDelta($sql);
552 -
553 - // Log the result for debugging
554 - if (empty($result)) {
555 - //error_log("MxChat: dbDelta returned empty result for chat transcripts table");
556 - } else {
557 - //error_log("MxChat: dbDelta result: " . print_r($result, true));
558 - }
559 -
560 - // IMPORTANT: Ensure all columns exist for existing installations
561 - mxchat_ensure_all_columns($table_name);
562 -}
563 -
564 -/**
565 - * Ensure all required columns exist (for upgrades)
566 - */
567 -function mxchat_ensure_all_columns($table_name) {
568 - global $wpdb;
569 -
570 - // First check if table exists
571 - $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
572 - if (!$table_exists) {
573 - //error_log("MxChat: Table $table_name does not exist, cannot add columns");
574 - return;
575 - }
576 -
577 - // Define all required columns and their types
578 - $required_columns = [
579 - 'user_identifier' => 'VARCHAR(255) DEFAULT NULL',
580 - 'user_email' => 'VARCHAR(255) DEFAULT NULL',
581 - 'user_name' => 'VARCHAR(100) DEFAULT NULL',
582 - 'originating_page_url' => 'TEXT DEFAULT NULL',
583 - 'originating_page_title' => 'VARCHAR(500) DEFAULT NULL',
584 - 'rag_context' => 'LONGTEXT DEFAULT NULL'
585 - ];
586 -
587 - // Get existing columns
588 - $existing_columns = $wpdb->get_results("SHOW COLUMNS FROM $table_name");
589 - if (empty($existing_columns)) {
590 - //error_log("MxChat: Could not get columns for table $table_name");
591 - return;
592 - }
593 -
594 - $existing_column_names = array_column($existing_columns, 'Field');
595 -
596 - // Add missing columns
597 - foreach ($required_columns as $column_name => $column_definition) {
598 - if (!in_array($column_name, $existing_column_names)) {
599 - $alter_sql = "ALTER TABLE $table_name ADD COLUMN $column_name $column_definition";
600 - $result = $wpdb->query($alter_sql);
601 -
602 - if ($result === false) {
603 - //error_log("MxChat: Failed to add column $column_name to $table_name. Error: " . $wpdb->last_error);
604 - } else {
605 - //error_log("MxChat: Successfully added column $column_name to $table_name");
606 - }
607 - }
608 - }
609 -}
610 -
611 -/**
612 - * Add role restriction column to knowledge base table
613 - */
614 -function mxchat_add_role_restriction_column() {
615 - global $wpdb;
616 - $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
617 -
618 - // Check if table exists first
619 - $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
620 - if (!$table_exists) {
621 - //error_log("MxChat: System prompt content table does not exist, cannot add role_restriction column");
622 - return;
623 - }
624 -
625 - // Check if column already exists
626 - $column_exists = $wpdb->get_results(
627 - $wpdb->prepare(
628 - "SHOW COLUMNS FROM {$table_name} LIKE %s",
629 - 'role_restriction'
630 - )
631 - );
632 -
633 - if (empty($column_exists)) {
634 - $alter_sql = "ALTER TABLE {$table_name} ADD COLUMN role_restriction VARCHAR(50) DEFAULT 'public' AFTER source_url";
635 - $result = $wpdb->query($alter_sql);
636 -
637 - if ($result === false) {
638 - //error_log("MxChat: Failed to add role_restriction column. Error: " . $wpdb->last_error);
639 - } else {
640 - //error_log("MxChat: Successfully added role_restriction column");
641 -
642 - // Set all existing records to 'public' (everyone can access)
643 - $update_result = $wpdb->query(
644 - "UPDATE {$table_name}
645 - SET role_restriction = 'public'
646 - WHERE role_restriction IS NULL OR role_restriction = ''"
647 - );
648 -
649 - if ($update_result !== false) {
650 - //error_log("MxChat: Updated {$update_result} existing records to public access");
651 - }
652 - }
653 - }
654 -}
655 -
656 -/**
657 - * Add enabled_bots column to intents table for multi-bot action filtering
658 - */
659 -function mxchat_add_enabled_bots_column() {
660 - global $wpdb;
661 - $table_name = $wpdb->prefix . 'mxchat_intents';
662 -
663 - // Check if table exists first
664 - $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
665 - if (!$table_exists) {
666 - //error_log("MxChat: Intents table does not exist, cannot add enabled_bots column");
667 - return;
668 - }
669 -
670 - // Check if column already exists
671 - $column_exists = $wpdb->get_results(
672 - $wpdb->prepare(
673 - "SHOW COLUMNS FROM {$table_name} LIKE %s",
674 - 'enabled_bots'
675 - )
676 - );
677 -
678 - if (empty($column_exists)) {
679 - $alter_sql = "ALTER TABLE {$table_name} ADD COLUMN enabled_bots LONGTEXT DEFAULT NULL AFTER enabled";
680 - $result = $wpdb->query($alter_sql);
681 -
682 - if ($result === false) {
683 - //error_log("MxChat: Failed to add enabled_bots column. Error: " . $wpdb->last_error);
684 - } else {
685 - //error_log("MxChat: Successfully added enabled_bots column");
686 -
687 - // Set all existing actions to work with 'default' bot for backward compatibility
688 - $default_bots = json_encode(['default']);
689 - $update_result = $wpdb->query(
690 - $wpdb->prepare(
691 - "UPDATE {$table_name}
692 - SET enabled_bots = %s
693 - WHERE enabled_bots IS NULL OR enabled_bots = ''",
694 - $default_bots
695 - )
696 - );
697 -
698 - if ($update_result !== false) {
699 - //error_log("MxChat: Updated {$update_result} existing actions to work with default bot");
700 - }
701 - }
702 - }
703 -}
704 -
705 -/**
706 - * Create Pinecone role restrictions table with multi-bot support
707 - */
708 -function mxchat_create_pinecone_roles_table() {
709 - global $wpdb;
710 -
711 - $table_name = $wpdb->prefix . 'mxchat_pinecone_roles';
712 - $charset_collate = $wpdb->get_charset_collate();
713 -
714 - $sql = "CREATE TABLE $table_name (
715 - id mediumint(9) NOT NULL AUTO_INCREMENT,
716 - vector_id varchar(255) NOT NULL,
717 - bot_id varchar(50) NOT NULL DEFAULT 'default',
718 - source_url text,
719 - role_restriction varchar(50) DEFAULT 'public',
720 - updated_at timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
721 - PRIMARY KEY (id),
722 - UNIQUE KEY vector_bot (vector_id, bot_id),
723 - KEY role_restriction (role_restriction),
724 - KEY bot_id (bot_id)
725 - ) $charset_collate;";
726 -
727 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
728 - dbDelta($sql);
729 -}
730 -
731 -/**
732 - * Add bot_id column to mxchat_pinecone_roles table for multi-bot support
733 - * This migration runs once to update existing installations
734 - */
735 -function mxchat_migrate_pinecone_roles_add_bot_id() {
736 - global $wpdb;
737 -
738 - // Check if migration already ran
739 - $migration_version = get_option('mxchat_pinecone_roles_migration_version', '0');
740 - if (version_compare($migration_version, '2.5.2', '>=')) {
741 - return; // Already migrated
742 - }
743 -
744 - $table_name = $wpdb->prefix . 'mxchat_pinecone_roles';
745 -
746 - // Check if table exists
747 - if ($wpdb->get_var("SHOW TABLES LIKE '{$table_name}'") != $table_name) {
748 - return; // Table doesn't exist yet
749 - }
750 -
751 - // Check if bot_id column already exists
752 - $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$table_name} LIKE 'bot_id'");
753 -
754 - if (empty($column_exists)) {
755 - // Add bot_id column
756 - $wpdb->query("ALTER TABLE {$table_name} ADD COLUMN bot_id VARCHAR(50) NOT NULL DEFAULT 'default' AFTER vector_id");
757 -
758 - // Update the unique key to include bot_id
759 - $wpdb->query("ALTER TABLE {$table_name} DROP INDEX vector_id");
760 - $wpdb->query("ALTER TABLE {$table_name} ADD UNIQUE KEY vector_bot (vector_id, bot_id)");
761 -
762 - // Add index for bot_id
763 - $wpdb->query("ALTER TABLE {$table_name} ADD KEY bot_id (bot_id)");
764 -
765 - //error_log('MxChat: Successfully added bot_id column to mxchat_pinecone_roles table');
766 - }
767 -
768 - // Mark migration as complete
769 - update_option('mxchat_pinecone_roles_migration_version', '2.5.2');
770 -}
771 -
772 -/**
773 - * 2.5.6: Add content_type column to mxchat_system_prompt_content table
774 - * Enables filtering knowledge base by content type (posts, pages, PDFs, etc.)
775 - */
776 -function mxchat_migrate_add_content_type_column() {
777 - global $wpdb;
778 -
779 - // Check if migration already ran
780 - $migration_version = get_option('mxchat_content_type_migration_version', '0');
781 - if (version_compare($migration_version, '2.5.6', '>=')) {
782 - return;
783 - }
784 -
785 - $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
786 -
787 - // Check if table exists
788 - if ($wpdb->get_var("SHOW TABLES LIKE '{$table_name}'") != $table_name) {
789 - return;
790 - }
791 -
792 - // Check if content_type column already exists
793 - $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$table_name} LIKE 'content_type'");
794 -
795 - if (empty($column_exists)) {
796 - // Add content_type column with default value 'content' for backwards compatibility
797 - $wpdb->query("ALTER TABLE {$table_name} ADD COLUMN content_type VARCHAR(50) DEFAULT 'content' AFTER role_restriction");
798 -
799 - // Add index for better query performance
800 - $wpdb->query("ALTER TABLE {$table_name} ADD KEY content_type (content_type)");
801 -
802 - //error_log('MxChat: Successfully added content_type column to mxchat_system_prompt_content table');
803 - }
804 -
805 - // Mark migration as complete
806 - update_option('mxchat_content_type_migration_version', '2.5.6');
807 -}
808 -
809 -/**
810 - * 3.2.4: Backfill the active embedding model option for installs that already
811 - * have KB content but no stamped model. The mismatch warning compares this
812 - * against the user's currently selected model — no per-row column needed.
813 - */
814 -function mxchat_backfill_active_embedding_model() {
815 - global $wpdb;
816 -
817 - if (get_option('mxchat_active_embedding_model', '') !== '') {
818 - return;
819 - }
820 -
821 - $kb_table = $wpdb->prefix . 'mxchat_system_prompt_content';
822 - if ($wpdb->get_var("SHOW TABLES LIKE '{$kb_table}'") !== $kb_table) {
823 - return;
824 - }
825 -
826 - $kb_count = (int) $wpdb->get_var("SELECT COUNT(*) FROM {$kb_table}");
827 - if ($kb_count > 0) {
828 - $options = get_option('mxchat_options', array());
829 - $current_model = $options['embedding_model'] ?? 'text-embedding-ada-002';
830 - update_option('mxchat_active_embedding_model', $current_model, false);
831 - }
832 -}
833 -
834 -/**
835 - * 2.5.2: Create queue processing tables for reliable background processing
836 - */
837 -function mxchat_create_queue_tables() {
838 - global $wpdb;
839 - $charset_collate = $wpdb->get_charset_collate();
840 -
841 - // Main queue table
842 - $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
843 - $sql_queue = "CREATE TABLE $queue_table (
844 - id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
845 - queue_id varchar(64) NOT NULL,
846 - item_type varchar(20) NOT NULL,
847 - item_data longtext NOT NULL,
848 - status varchar(20) NOT NULL DEFAULT 'pending',
849 - bot_id varchar(50) NOT NULL DEFAULT 'default',
850 - priority int(11) NOT NULL DEFAULT 0,
851 - attempts int(11) NOT NULL DEFAULT 0,
852 - max_attempts int(11) NOT NULL DEFAULT 3,
853 - error_message text DEFAULT NULL,
854 - created_at datetime NOT NULL,
855 - started_at datetime DEFAULT NULL,
856 - completed_at datetime DEFAULT NULL,
857 - PRIMARY KEY (id),
858 - KEY queue_id (queue_id),
859 - KEY status (status),
860 - KEY item_type (item_type),
861 - KEY priority (priority)
862 - ) $charset_collate;";
863 -
864 - // Queue metadata table
865 - $meta_table = $wpdb->prefix . 'mxchat_queue_meta';
866 - $sql_meta = "CREATE TABLE $meta_table (
867 - id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
868 - queue_id varchar(64) NOT NULL,
869 - meta_key varchar(255) NOT NULL,
870 - meta_value longtext,
871 - PRIMARY KEY (id),
872 - KEY queue_id (queue_id),
873 - KEY meta_key (meta_key)
874 - ) $charset_collate;";
875 -
876 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
877 - dbDelta($sql_queue);
878 - dbDelta($sql_meta);
879 -
880 - //error_log("MxChat: Queue tables created/updated successfully");
881 -}
882 -
883 -/**
884 - * Create transcript translations table for persisting translations
885 - */
886 -function mxchat_create_translations_table() {
887 - global $wpdb;
888 - $charset_collate = $wpdb->get_charset_collate();
889 -
890 - $table_name = $wpdb->prefix . 'mxchat_transcript_translations';
891 - $sql = "CREATE TABLE $table_name (
892 - id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
893 - session_id varchar(255) NOT NULL,
894 - language_code varchar(10) NOT NULL,
895 - translations longtext NOT NULL,
896 - created_at datetime NOT NULL,
897 - updated_at datetime NOT NULL,
898 - PRIMARY KEY (id),
899 - UNIQUE KEY session_lang (session_id, language_code),
900 - KEY session_id (session_id)
901 - ) $charset_collate;";
902 -
903 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
904 - dbDelta($sql);
905 -}
906 -
907 -/**
908 - * Create per-session satisfaction ratings table (v3.2.6)
909 - * Stores one 👍/👎 rating + optional feedback per chat session.
910 - */
911 -function mxchat_create_session_ratings_table() {
912 - global $wpdb;
913 - $charset_collate = $wpdb->get_charset_collate();
914 -
915 - $table_name = $wpdb->prefix . 'mxchat_session_ratings';
916 - $sql = "CREATE TABLE $table_name (
917 - id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
918 - session_id varchar(255) NOT NULL,
919 - bot_id varchar(50) NOT NULL DEFAULT 'default',
920 - rating_value tinyint(1) NOT NULL,
921 - rating_feedback text DEFAULT NULL,
922 - created_at datetime NOT NULL,
923 - PRIMARY KEY (id),
924 - UNIQUE KEY session_id (session_id),
925 - KEY bot_id (bot_id),
926 - KEY created_at (created_at)
927 - ) $charset_collate;";
928 -
929 - require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
930 - dbDelta($sql);
931 -}
932 -
933 -/**
934 - * 2.5.2: Fix URL column size to support long URLs (especially with UTF-8 encoding)
935 - * This fixes "url, source_url. The supplied values may be too long" errors
936 - */
937 -function mxchat_fix_url_column_size() {
938 - global $wpdb;
939 - $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
940 -
941 - // Check if table exists
942 - $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
943 - if (!$table_exists) {
944 - return;
945 - }
946 -
947 - // Change url and source_url from VARCHAR to TEXT to handle long URLs
948 - // This is especially important for URLs with UTF-8 encoded characters (Hebrew, Arabic, etc.)
949 - $wpdb->query("ALTER TABLE {$table_name} MODIFY COLUMN url TEXT");
950 - $wpdb->query("ALTER TABLE {$table_name} MODIFY COLUMN source_url TEXT");
951 -
952 - //error_log("MxChat: Successfully updated url and source_url columns to TEXT type for long URL support");
953 -}
954 -
955 -/**
956 - * Migrate deprecated AI models to their replacements
957 - * Version 2.5.1: Migrate Claude 3.5 Sonnet (deprecated) to Claude 3.7 Sonnet
958 - * Version 3.1.2: Convert chat transcripts table to utf8mb4 for emoji support
959 - * Without utf8mb4, any bot response containing emojis silently fails to insert.
960 - */
961 -function mxchat_migrate_transcripts_charset() {
962 - global $wpdb;
963 - $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
964 - $wpdb->query("ALTER TABLE $table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
965 -}
966 -
967 -/**
968 - * Version 3.0.55: Migrate GPT-4 series models (deprecated 2026-02-17) to GPT-5 series
969 - */
970 -function mxchat_migrate_deprecated_models() {
971 - $options = get_option('mxchat_options', array());
972 - $migrated = false;
973 - $migration_message = '';
974 -
975 - if (!isset($options['model'])) {
976 - return;
977 - }
978 -
979 - $current_model = $options['model'];
980 -
981 - // Migrate deprecated Claude models to Claude Opus 4.6 (recommended replacement per Anthropic)
982 - $deprecated_claude_models = array(
983 - 'claude-3-5-sonnet-20240620', // Retired Oct 28, 2025
984 - 'claude-3-5-sonnet-20241022', // Retired Oct 28, 2025
985 - 'claude-3-7-sonnet-20250219', // Retiring Feb 19, 2026
986 - 'claude-3-opus-20240229', // Retired Jan 5, 2026
987 - 'claude-3-sonnet-20240229', // Legacy
988 - 'claude-3-haiku-20240307', // Legacy
989 - );
990 - if (in_array($current_model, $deprecated_claude_models, true)) {
991 - $options['model'] = 'claude-opus-4-6';
992 - $migrated = true;
993 - $migration_message = sprintf(
994 - 'Your chatbot model has been automatically updated from %s to Claude Opus 4.6 due to Anthropic deprecating older Claude models.',
995 - $current_model
996 - );
997 - }
998 -
999 - // Migrate deprecated Claude Haiku 3.5 to Claude Haiku 4.5
1000 - if ($current_model === 'claude-3-5-haiku-20241022') {
1001 - $options['model'] = 'claude-haiku-4-5-20251001';
1002 - $migrated = true;
1003 - $migration_message = 'Your chatbot model has been automatically updated from Claude Haiku 3.5 to Claude Haiku 4.5 due to Anthropic deprecating the older model.';
1004 - }
1005 -
1006 - // Migrate deprecated GPT-4 series and GPT-3.5 Turbo to GPT-5.6 Sol.
1007 - // (Previous target gpt-5.1-chat-latest itself retires 2026-08-10 — never
1008 - // migrate onto a model that is already on a deprecation list.)
1009 - if (in_array($current_model, array('gpt-4o', 'gpt-4.1-2025-04-14', 'gpt-4-turbo', 'gpt-4', 'gpt-3.5-turbo'), true)) {
1010 - $options['model'] = 'gpt-5.6-sol';
1011 - $migrated = true;
1012 - $migration_message = sprintf(
1013 - 'Your chatbot model has been automatically updated from %s to GPT-5.6 Sol due to OpenAI deprecating older models.',
1014 - $current_model
1015 - );
1016 - }
1017 -
1018 - // Migrate the gpt-5.x-chat-latest aliases OpenAI retires on August 10, 2026.
1019 - // Replacement per OpenAI's deprecations page: gpt-5.6-sol (plan e46b8f).
1020 - if (in_array($current_model, array('gpt-5.1-chat-latest', 'gpt-5.3-chat-latest'), true)) {
1021 - $options['model'] = 'gpt-5.6-sol';
1022 - $migrated = true;
1023 - $migration_message = sprintf(
1024 - 'Your chatbot model has been automatically updated from %s to GPT-5.6 Sol because OpenAI retires the GPT-5.x Chat Latest models on August 10, 2026.',
1025 - $current_model
1026 - );
1027 - }
1028 -
1029 - // The content generator has its own model option — same retirement applies.
1030 - if (isset($options['content_model'])
1031 - && in_array($options['content_model'], array('gpt-5.1-chat-latest', 'gpt-5.3-chat-latest'), true)) {
1032 - $old_content_model = $options['content_model'];
1033 - $options['content_model'] = 'gpt-5.6-sol';
1034 - $migrated = true;
1035 - $migration_message = trim($migration_message . ' ' . sprintf(
1036 - 'Your content generation model has also been updated from %s to GPT-5.6 Sol for the same OpenAI retirement.',
1037 - $old_content_model
1038 - ));
1039 - }
1040 -
1041 - // Migrate deprecated GPT-4o Mini and GPT-4.1 Mini to GPT-5 Mini
1042 - if (in_array($current_model, array('gpt-4o-mini', 'gpt-4.1-mini'), true)) {
1043 - $options['model'] = 'gpt-5-mini';
1044 - $migrated = true;
1045 - $migration_message = sprintf(
1046 - 'Your chatbot model has been automatically updated from %s to GPT-5 Mini due to OpenAI deprecating GPT-4 series models.',
1047 - $current_model
1048 - );
1049 - }
1050 -
1051 - // Migrate retired DeepSeek ids to DeepSeek V4 Flash — the vendor removed
1052 - // deepseek-chat and deepseek-reasoner on 2026-07-24 (hard cutoff, every
1053 - // request 400s). V4 Flash is DeepSeek's designated successor for the
1054 - // legacy deepseek-chat alias.
1055 - if (in_array($current_model, array('deepseek-chat', 'deepseek-reasoner'), true)) {
1056 - $options['model'] = 'deepseek-v4-flash';
1057 - $migrated = true;
1058 - $migration_message = sprintf(
1059 - 'Your chatbot model has been automatically updated from %s to DeepSeek V4 Flash because DeepSeek retired its older API models on July 24, 2026.',
1060 - $current_model
1061 - );
1062 - }
1063 -
1064 - if ($migrated) {
1065 - update_option('mxchat_options', $options);
1066 - update_option('mxchat_model_migrated_notice', true);
1067 - update_option('mxchat_model_migration_message', $migration_message);
1068 - }
1069 -}
1070 -
1071 -/**
1072 - * Show admin notice after model migration
1073 - */
1074 -function mxchat_show_migration_notice() {
1075 - if (get_option('mxchat_model_migrated_notice')) {
1076 - $migration_message = get_option('mxchat_model_migration_message', __('Your chatbot model has been automatically updated due to a model deprecation.', 'mxchat'));
1077 - ?>
1078 - <div class="notice notice-info is-dismissible">
1079 - <p>
1080 - <strong><?php esc_html_e('MxChat Model Updated', 'mxchat'); ?></strong><br>
1081 - <?php echo esc_html($migration_message); ?>
1082 - </p>
1083 - </div>
1084 - <?php
1085 - delete_option('mxchat_model_migrated_notice');
1086 - delete_option('mxchat_model_migration_message');
1087 - }
1088 -}
1089 -
1090 -/**
1091 - * Persistent admin notice when the provider rejected the configured model
1092 - * (model_not_found / no access). Set by mxchat_friendly_chat_error() in the
1093 - * integrator whenever a chat request fails on a model-access error — including
1094 - * requests from anonymous visitors, which is the case that otherwise stays
1095 - * invisible to the site owner for weeks (plan e46b8f).
1096 - *
1097 - * Deleted after render so it re-arms on the next failed chat: the notice keeps
1098 - * reappearing until the model is fixed, then stops on its own.
1099 - */
1100 -function mxchat_show_model_access_notice() {
1101 - if (!current_user_can('manage_options')) {
1102 - return;
1103 - }
1104 - $notice = get_option('mxchat_model_access_notice');
1105 - if (!is_array($notice) || empty($notice['model'])) {
1106 - return;
1107 - }
1108 - $settings_url = admin_url('admin.php?page=mxchat-max');
1109 - ?>
1110 - <div class="notice notice-error is-dismissible">
1111 - <p>
1112 - <strong><?php esc_html_e('MxChat: your AI model is being rejected by the provider', 'mxchat'); ?></strong><br>
1113 - <?php
1114 - printf(
1115 - /* translators: 1: model id, 2: provider name */
1116 - esc_html__('Chat requests using the model "%1$s" are failing because %2$s reports it as unavailable on your API key (it may have been retired). Visitors may be seeing errors instead of replies.', 'mxchat'),
1117 - esc_html($notice['model']),
1118 - esc_html(!empty($notice['provider']) ? $notice['provider'] : __('the AI provider', 'mxchat'))
1119 - );
1120 - ?>
1121 - <a href="<?php echo esc_url($settings_url); ?>"><?php esc_html_e('Choose a different model in MxChat Settings', 'mxchat'); ?></a>
1122 - </p>
1123 - </div>
1124 - <?php
1125 - delete_option('mxchat_model_access_notice');
1126 -}
1127 -
1128 -function mxchat_activate() {
1129 - global $wpdb;
1130 - $charset_collate = $wpdb->get_charset_collate();
1131 -
1132 - //error_log("MxChat: Running activation function");
1133 -
1134 - // Create chat transcripts table with improved function
1135 - mxchat_create_chat_transcripts_table();
1136 -
1137 - // System Prompt Content Table - UPDATED: Use TEXT for url and source_url columns
1138 - $system_prompt_table = $wpdb->prefix . 'mxchat_system_prompt_content';
1139 - $sql_system_prompt = "CREATE TABLE $system_prompt_table (
1140 - id MEDIUMINT(9) NOT NULL AUTO_INCREMENT,
1141 - url TEXT NOT NULL,
1142 - article_content LONGTEXT NOT NULL,
1143 - embedding_vector LONGTEXT,
1144 - source_url TEXT DEFAULT NULL,
1145 - role_restriction VARCHAR(50) DEFAULT 'public',
1146 - content_type VARCHAR(50) DEFAULT 'content',
1147 - timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
1148 - PRIMARY KEY (id),
1149 - KEY content_type (content_type)
1150 - ) $charset_collate;";
1151 -
1152 - // Intents Table - NOW INCLUDES enabled_bots column from the start
1153 - $intents_table = $wpdb->prefix . 'mxchat_intents';
1154 - $sql_intents_table = "CREATE TABLE $intents_table (
1155 - id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
1156 - intent_label VARCHAR(255) NOT NULL,
1157 - phrases TEXT NOT NULL,
1158 - embedding_vector LONGTEXT NOT NULL,
1159 - callback_function VARCHAR(255) NOT NULL,
1160 - similarity_threshold FLOAT DEFAULT 0.85,
1161 - enabled TINYINT(1) NOT NULL DEFAULT 1,
1162 - enabled_bots LONGTEXT DEFAULT NULL,
1163 - PRIMARY KEY (id)
1164 - ) $charset_collate;";
1165 -
1166 - // Individual Intent Phrases Table - each phrase gets its own embedding vector
1167 - $intent_phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
1168 - $sql_intent_phrases_table = "CREATE TABLE $intent_phrases_table (
1169 - id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
1170 - intent_id BIGINT(20) UNSIGNED NOT NULL,
1171 - phrase TEXT NOT NULL,
1172 - embedding_vector LONGTEXT NOT NULL,
1173 - created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
1174 - PRIMARY KEY (id),
1175 - KEY intent_id (intent_id)
1176 - ) $charset_collate;";
1177 -
1178 - require_once ABSPATH . 'wp-admin/includes/upgrade.php';
1179 -
1180 - // Create other tables
1181 - dbDelta($sql_system_prompt);
1182 - dbDelta($sql_intents_table);
1183 - dbDelta($sql_intent_phrases_table);
1184 -
1185 - // Create URL click tracking table
1186 - mxchat_create_url_clicks_table();
1187 -
1188 - // Create Pinecone roles table
1189 - mxchat_create_pinecone_roles_table();
1190 -
1191 - // NEW 2.5.2: Create queue processing tables
1192 - mxchat_create_queue_tables();
1193 -
1194 - // Create transcript translations table
1195 - mxchat_create_translations_table();
1196 -
1197 - // Create per-session satisfaction ratings table (v3.2.6)
1198 - mxchat_create_session_ratings_table();
1199 -
1200 - // Ensure additional columns in system prompt table
1201 - $existing_system_columns = $wpdb->get_results("SHOW COLUMNS FROM $system_prompt_table");
1202 - if (!empty($existing_system_columns)) {
1203 - $existing_system_column_names = array_column($existing_system_columns, 'Field');
1204 -
1205 - if (!in_array('embedding_vector', $existing_system_column_names)) {
1206 - $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN embedding_vector LONGTEXT");
1207 - }
1208 - if (!in_array('source_url', $existing_system_column_names)) {
1209 - $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN source_url TEXT DEFAULT NULL");
1210 - }
1211 - if (!in_array('role_restriction', $existing_system_column_names)) {
1212 - $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN role_restriction VARCHAR(50) DEFAULT 'public' AFTER source_url");
1213 - }
1214 - }
1215 -
1216 - // Set default thresholds for existing intents
1217 - $wpdb->query("UPDATE {$intents_table} SET similarity_threshold = 0.85 WHERE similarity_threshold IS NULL");
1218 -
1219 - // Ensure enabled column exists in intents table
1220 - $existing_intent_columns = $wpdb->get_results("SHOW COLUMNS FROM $intents_table");
1221 - if (!empty($existing_intent_columns)) {
1222 - $existing_intent_column_names = array_column($existing_intent_columns, 'Field');
1223 -
1224 - if (!in_array('enabled', $existing_intent_column_names)) {
1225 - $wpdb->query("ALTER TABLE $intents_table ADD COLUMN enabled TINYINT(1) NOT NULL DEFAULT 1");
1226 - }
1227 -
1228 - // Ensure enabled_bots column exists for existing installations
1229 - if (!in_array('enabled_bots', $existing_intent_column_names)) {
1230 - $wpdb->query("ALTER TABLE $intents_table ADD COLUMN enabled_bots LONGTEXT DEFAULT NULL AFTER enabled");
1231 -
1232 - // Set existing actions to work with default bot
1233 - $default_bots = json_encode(['default']);
1234 - $wpdb->query($wpdb->prepare(
1235 - "UPDATE {$intents_table} SET enabled_bots = %s WHERE enabled_bots IS NULL",
1236 - $default_bots
1237 - ));
1238 - }
1239 - }
1240 -
1241 - // Run migration for existing installations
1242 - mxchat_migrate_pinecone_roles_add_bot_id();
1243 -
1244 - // 3.2.4: Backfill active embedding model option (replaces 3.2.3 column-based tracking)
1245 - mxchat_backfill_active_embedding_model();
1246 -
1247 - // Setup cron jobs
1248 - mxchat_setup_cron_jobs();
1249 -
1250 - // Update version (stable base version — never the dev time()-suffixed one,
1251 - // or the check_for_update comparison would churn every request)
1252 - update_option('mxchat_plugin_version', MXCHAT_BASE_VERSION);
1253 -
1254 - //error_log("MxChat: Activation function completed");
1255 -}
1256 -
1257 -/**
1258 - * Setup cron jobs on plugin activation
1259 - */
1260 -function mxchat_setup_cron_jobs() {
1261 - // Clear any existing cron jobs first
1262 - wp_clear_scheduled_hook('mxchat_reset_rate_limits');
1263 -
1264 - // Check if WordPress cron is disabled
1265 - if (defined('DISABLE_WP_CRON') && DISABLE_WP_CRON) {
1266 - // Set flag to use fallback system
1267 - update_option('mxchat_use_fallback_rate_limits', true);
1268 - update_option('mxchat_next_rate_limit_check', time() + 3600);
1269 - // Deliberately NO early return (plan-bc08a6): transcript cleanup below
1270 - // must still be scheduled. DISABLE_WP_CRON only changes HOW cron events
1271 - // execute (a server-side runner hitting wp-cron.php instead of loopback
1272 - // spawns) — scheduling still just writes the cron option. The old early
1273 - // return here meant a deactivate/reactivate cycle on a DISABLE_WP_CRON
1274 - // site permanently lost the transcript cleanup event while the retention
1275 - // setting still claimed to be active.
1276 - } else {
1277 - // Schedule the rate limit reset cron job
1278 - $result = wp_schedule_event(time() + 300, 'hourly', 'mxchat_reset_rate_limits');
1279 -
1280 - if ($result === false) {
1281 - // Fallback if scheduling fails
1282 - update_option('mxchat_use_fallback_rate_limits', true);
1283 - update_option('mxchat_next_rate_limit_check', time() + 3600);
1284 - } else {
1285 - // Clear fallback flags if cron scheduling succeeded
1286 - delete_option('mxchat_use_fallback_rate_limits');
1287 - }
1288 - }
1289 -
1290 - // Schedule transcript cleanup if configured (bucket dropdown OR custom retention-days > 0)
1291 - $transcript_options = get_option('mxchat_transcripts_options', array());
1292 - $cleanup_interval = isset($transcript_options['mxchat_auto_delete_transcripts']) ? $transcript_options['mxchat_auto_delete_transcripts'] : 'never';
1293 - $custom_retention = isset($transcript_options['mxchat_retention_days']) ? (int) $transcript_options['mxchat_retention_days'] : 0;
1294 -
1295 - if ($cleanup_interval !== 'never' || $custom_retention > 0) {
1296 - // Check if not already scheduled
1297 - if (!wp_next_scheduled('mxchat_cleanup_old_transcripts')) {
1298 - // Schedule to run daily at 3 AM
1299 - $next_run = strtotime('tomorrow 3:00 AM');
1300 - wp_schedule_event($next_run, 'daily', 'mxchat_cleanup_old_transcripts');
1301 - }
1302 - }
1303 -}
1304 -
1305 -/**
1306 - * Clean up on plugin deactivation
1307 - */
1308 -function mxchat_deactivate() {
1309 - // Clear scheduled cron jobs
1310 - wp_clear_scheduled_hook('mxchat_reset_rate_limits');
1311 - wp_clear_scheduled_hook('mxchat_cleanup_old_transcripts');
1312 - wp_clear_scheduled_hook('mxchat_send_delayed_transcript');
1313 -
1314 - // Clear fallback options
1315 - delete_option('mxchat_use_fallback_rate_limits');
1316 - delete_option('mxchat_next_rate_limit_check');
1317 - delete_option('mxchat_fallback_check_interval');
1318 -
1319 - // NOTE: We do NOT delete queue tables on deactivation
1320 - // This preserves data if user accidentally deactivates the plugin
1321 -}
1322 -
1323 -/**
1324 - * Check if fallback rate limit cleanup is needed
1325 - */
1326 -function mxchat_check_fallback_rate_limits() {
1327 - $use_fallback = get_option('mxchat_use_fallback_rate_limits', false);
1328 -
1329 - if (!$use_fallback) {
1330 - return;
1331 - }
1332 -
1333 - $next_check = get_option('mxchat_next_rate_limit_check', 0);
1334 -
1335 - if (time() >= $next_check) {
1336 - // Reuse the bootstrap's integrator — mxchat_init() creates the global on
1337 - // plugins_loaded (before this init-priority-5 callback), so it's always set
1338 - // here. Constructing a second MxChat_Integrator just to call one method
1339 - // re-registers every hook the plugin has (ajax pairs, wp_footer loader,
1340 - // rest_api_init, admin_init guard) on a duplicate instance for the rest of
1341 - // the request. Defensive construction only if the global is somehow unset.
1342 - // NOTE: MxChat_Integrator::check_fallback_rate_limits() is a second
1343 - // implementation of this same check — if either changes, change both.
1344 - global $mxchat_integrator;
1345 - $integrator = ($mxchat_integrator instanceof MxChat_Integrator)
1346 - ? $mxchat_integrator
1347 - : (class_exists('MxChat_Integrator') ? new MxChat_Integrator() : null);
1348 - if ($integrator && method_exists($integrator, 'mxchat_reset_rate_limits')) {
1349 - $integrator->mxchat_reset_rate_limits();
1350 - update_option('mxchat_next_rate_limit_check', time() + 3600);
1351 - }
1352 - }
1353 -}
1354 -
1355 -/**
1356 - * Robust update checking with role restriction migration, model deprecation, and queue tables
1357 - * CRITICAL: This runs on EVERY page load to ensure tables exist
1358 - */
1359 -function mxchat_check_for_update() {
1360 - global $wpdb;
1361 -
1362 - try {
1363 - $current_version = get_option('mxchat_plugin_version', '0.0.0');
1364 - $plugin_version = MXCHAT_BASE_VERSION;
1365 -
1366 - // Always ensure critical tables exist (even if version matches)
1367 - // This handles manual table deletion or fresh installs
1368 - $chat_table = $wpdb->prefix . 'mxchat_chat_transcripts';
1369 - $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
1370 -
1371 - $chat_exists = $wpdb->get_var("SHOW TABLES LIKE '$chat_table'") === $chat_table;
1372 - $queue_exists = $wpdb->get_var("SHOW TABLES LIKE '$queue_table'") === $queue_table;
1373 -
1374 - if (!$chat_exists || !$queue_exists) {
1375 - //error_log("MxChat: Critical tables missing, running activation");
1376 - mxchat_activate();
1377 - }
1378 -
1379 - // Version-specific migrations
1380 - if ($current_version !== $plugin_version) {
1381 - //error_log("MxChat: Version change detected: $current_version -> $plugin_version");
1382 -
1383 - // Run live agent update BEFORE updating the stored version
1384 - mxchat_handle_live_agent_update();
1385 -
1386 - // Run theme migration notice for 3.0.1 (AI theme CSS structure changes)
1387 - mxchat_handle_theme_migration_notice();
1388 -
1389 - // Run role restriction migration for 2.4.1
1390 - if (version_compare($current_version, '2.4.1', '<')) {
1391 - mxchat_add_role_restriction_column();
1392 - }
1393 -
1394 - // Run enabled_bots column migration for 2.4.4
1395 - if (version_compare($current_version, '2.4.4', '<')) {
1396 - mxchat_add_enabled_bots_column();
1397 - }
1398 -
1399 - // Run model migration for 2.5.1 (Claude deprecation)
1400 - if (version_compare($current_version, '2.5.1', '<')) {
1401 - mxchat_migrate_deprecated_models();
1402 - }
1403 -
1404 - // 2.5.2: Ensure queue tables exist and fix URL column sizes for all users upgrading to 2.5.2
1405 - if (version_compare($current_version, '2.5.2', '<')) {
1406 - mxchat_create_queue_tables();
1407 - mxchat_fix_url_column_size(); // NEW: Fix URL column size for long URLs
1408 - //error_log("MxChat: Queue tables created and URL columns updated for upgrade to 2.5.2");
1409 - }
1410 -
1411 - // 2.6.0: Ensure rag_context column exists for retrieved documents feature
1412 - if (version_compare($current_version, '2.6.0', '<')) {
1413 - $chat_table = $wpdb->prefix . 'mxchat_chat_transcripts';
1414 - mxchat_ensure_all_columns($chat_table);
1415 - //error_log("MxChat: rag_context column migration for 2.6.0");
1416 - }
1417 -
1418 - // 3.0.5: Migrate deprecated Gemini embedding model
1419 - if (version_compare($current_version, '3.0.5', '<')) {
1420 - mxchat_migrate_gemini_embedding_model();
1421 - }
1422 -
1423 - // 3.0.6: Migrate deprecated OpenAI and Claude models
1424 - if (version_compare($current_version, '3.0.6', '<')) {
1425 - mxchat_migrate_deprecated_models();
1426 - }
1427 -
1428 - // 3.1.2: Convert chat transcripts table to utf8mb4 for emoji support
1429 - if (version_compare($current_version, '3.1.2', '<')) {
1430 - mxchat_migrate_transcripts_charset();
1431 - }
1432 -
1433 - // 3.1.7: Clean up stale shared session email/name entries
1434 - if (version_compare($current_version, '3.1.7', '<')) {
1435 - delete_option('mxchat_email_null');
1436 - delete_option('mxchat_name_null');
1437 - }
1438 -
1439 - // 3.2.4: Backfill active embedding model option for the warning UI
1440 - // (replaces the per-row column tracking from 3.2.3, which was reverted)
1441 - if (version_compare($current_version, '3.2.4', '<')) {
1442 - mxchat_backfill_active_embedding_model();
1443 - }
1444 -
1445 - // 3.2.15: Migrate retired DeepSeek ids (deepseek-chat / deepseek-reasoner
1446 - // were shut off at the vendor on 2026-07-24). The function is idempotent —
1447 - // it only rewrites models on its deprecation lists.
1448 - if (version_compare($current_version, '3.2.15', '<')) {
1449 - mxchat_migrate_deprecated_models();
1450 - }
1451 -
1452 - // 3.2.16: Migrate OpenAI ids retiring 2026-08-10 (gpt-5.1-chat-latest /
1453 - // gpt-5.3-chat-latest → gpt-5.6-sol per OpenAI's deprecations page).
1454 - // Idempotent — only rewrites models on the deprecation lists (e46b8f).
1455 - if (version_compare($current_version, '3.2.16', '<')) {
1456 - mxchat_migrate_deprecated_models();
1457 - }
1458 -
1459 - // 3.2.17: Credential options must not autoload (af2400) — the two
1460 - // Pinecone-secret-holding rows were in alloptions, i.e. read into
1461 - // memory on every request including anonymous page views. Idempotent.
1462 - // Also carry the import modal's remembered ACF→PDF checkbox state
1463 - // into the new install-level option (11720c).
1464 - if (version_compare($current_version, '3.2.17', '<')) {
1465 - mxchat_fix_credential_option_autoload();
1466 - mxchat_migrate_acf_pdf_extraction_option();
1467 - }
1468 -
1469 - // Run full activation to ensure everything is up to date
1470 - mxchat_activate();
1471 -
1472 - // Run migration functions
1473 - mxchat_migrate_live_agent_status();
1474 -
1475 - // Add the cleanup function for version 2.1.8
1476 - if (version_compare($current_version, '2.1.8', '<')) {
1477 - $deleted = mxchat_cleanup_orphaned_chat_history();
1478 - }
1479 -
1480 - // Update version LAST
1481 - update_option('mxchat_plugin_version', $plugin_version);
1482 -
1483 - //error_log("MxChat: Updated from version $current_version to $plugin_version");
1484 - }
1485 -
1486 - } catch (Exception $e) {
1487 - //error_log('MxChat update error: ' . $e->getMessage());
1488 - // Don't update version if there was an error
1489 - }
1490 -}
1491 -
1492 -/**
1493 - * Credential options must never enter the autoloaded alloptions set.
1494 - * mxchat_prompts_options and mxchat_pinecone_addon_options can hold the
1495 - * Pinecone API secret; mxchat_options already stores its keys with autoload
1496 - * off and these two must match it. The filter covers every future
1497 - * add_option()/update_option() that creates the row — Settings API saves
1498 - * through options.php and WP-CLI included — on WP 6.6+; older cores are
1499 - * covered by the explicit autoload arguments at the plugin's own write
1500 - * sites plus the one-time migration below.
1501 - */
1502 -add_filter('wp_default_autoload_value', 'mxchat_credential_option_autoload_value', 10, 2);
1503 -function mxchat_credential_option_autoload_value($autoload, $option) {
1504 - if (in_array($option, array('mxchat_prompts_options', 'mxchat_pinecone_addon_options'), true)) {
1505 - return false;
1506 - }
1507 - return $autoload;
1508 -}
1509 -
1510 -/**
1511 - * One-time upgrade migration: flip the autoload flag on credential option
1512 - * rows that existing installs are already carrying autoloaded. Includes
1513 - * mxchat_adv_api_token (Advanced Content bearer token) — harmless no-op
1514 - * when that add-on is not installed, since missing rows simply don't match.
1515 - */
1516 -function mxchat_fix_credential_option_autoload() {
1517 - $keys = array('mxchat_prompts_options', 'mxchat_pinecone_addon_options', 'mxchat_adv_api_token');
1518 - if (function_exists('wp_set_option_autoload_values')) {
1519 - wp_set_option_autoload_values(array_fill_keys($keys, false));
1520 - return;
1521 - }
1522 - // Pre-WP-6.4 fallback: direct flip + cache invalidation.
1523 - global $wpdb;
1524 - $placeholders = implode(',', array_fill(0, count($keys), '%s'));
1525 - $wpdb->query($wpdb->prepare("UPDATE {$wpdb->options} SET autoload = 'no' WHERE option_name IN ($placeholders)", $keys));
1526 - wp_cache_delete('alloptions', 'options');
1527 - foreach ($keys as $key) {
1528 - wp_cache_delete($key, 'options');
1529 - }
1530 -}
1531 -
1532 -/**
1533 - * One-time carry of the import modal's remembered ACF→PDF checkbox state
1534 - * (mxchat_options['acf_pdf_extract_default'], written per-import until 3.2.16)
1535 - * into the new install-level option mxchat_acf_pdf_extraction (plan 11720c).
1536 - * Fresh installs and installs that never touched the checkbox default OFF,
1537 - * matching the setting's own "recommended only if…" guidance.
1538 - */
1539 -function mxchat_migrate_acf_pdf_extraction_option() {
1540 - if (get_option('mxchat_acf_pdf_extraction', null) !== null) {
1541 - return; // already set — never overwrite an owner's choice
1542 - }
1543 - $mxchat_options = get_option('mxchat_options', array());
1544 - if (is_array($mxchat_options) && array_key_exists('acf_pdf_extract_default', $mxchat_options)) {
1545 - update_option('mxchat_acf_pdf_extraction', !empty($mxchat_options['acf_pdf_extract_default']) ? '1' : '0', false);
1546 - unset($mxchat_options['acf_pdf_extract_default']);
1547 - update_option('mxchat_options', $mxchat_options);
1548 - }
1549 -}
1550 -
1551 -/**
1552 - * Ensure tables exist on every admin load for fresh installations
1553 - * This is a safety net for cases where activation hook doesn't fire
1554 - */
1555 -function mxchat_ensure_tables_exist() {
1556 - global $wpdb;
1557 -
1558 - // Only run for admin users to avoid performance impact
1559 - if (!current_user_can('administrator')) {
1560 - return;
1561 - }
1562 -
1563 - // Check if we've already verified tables in this session
1564 - static $tables_checked = false;
1565 - if ($tables_checked) {
1566 - return;
1567 - }
1568 - $tables_checked = true;
1569 -
1570 - $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
1571 - $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
1572 -
1573 - $chat_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
1574 - $queue_exists = $wpdb->get_var("SHOW TABLES LIKE '$queue_table'") === $queue_table;
1575 -
1576 - if (!$chat_exists || !$queue_exists) {
1577 - //error_log("MxChat: Tables missing on admin load, running activation");
1578 - mxchat_activate();
1579 - }
1580 -}
1581 -
1582 -/**
1583 - * Clean up orphaned chat history options from the wp_options table
1584 - * @return int Number of options deleted
1585 - */
1586 -function mxchat_cleanup_orphaned_chat_history() {
1587 - global $wpdb;
1588 - $count = 0;
1589 -
1590 - // Get all option keys that match our pattern
1591 - $history_options = $wpdb->get_results(
1592 - "SELECT option_name FROM {$wpdb->options}
1593 - WHERE option_name LIKE 'mxchat_history_%'"
1594 - );
1595 -
1596 - if (!empty($history_options)) {
1597 - foreach ($history_options as $option) {
1598 - // Extract the session ID from the option name
1599 - $session_id = str_replace('mxchat_history_', '', $option->option_name);
1600 -
1601 - // Check if this session still exists in the custom table
1602 - $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
1603 - $exists = $wpdb->get_var(
1604 - $wpdb->prepare(
1605 - "SELECT COUNT(*) FROM {$table_name} WHERE session_id = %s",
1606 - $session_id
1607 - )
1608 - );
1609 -
1610 - // If session doesn't exist in the main table, delete the option
1611 - if ($exists == 0) {
1612 - delete_option($option->option_name);
1613 - // Also delete related metadata
1614 - delete_option("mxchat_email_{$session_id}");
1615 - delete_option("mxchat_name_{$session_id}");
1616 - delete_option("mxchat_agent_name_{$session_id}");
1617 - $count++;
1618 - }
1619 - }
1620 - }
1621 -
1622 - return $count;
1623 -}
1624 -
1625 -function mxchat_migrate_live_agent_status() {
1626 - $options = get_option('mxchat_options', []);
1627 -
1628 - // Check if live_agent_status exists
1629 - if (isset($options['live_agent_status'])) {
1630 - $current_status = $options['live_agent_status'];
1631 - $needs_update = false;
1632 -
1633 - // Convert to new format if needed
1634 - if ($current_status === 'online') {
1635 - $options['live_agent_status'] = 'on';
1636 - $needs_update = true;
1637 - } else if ($current_status === 'offline') {
1638 - $options['live_agent_status'] = 'off';
1639 - $needs_update = true;
1640 - } else if (!in_array($current_status, ['on', 'off'])) {
1641 - // Default to off for any unexpected values
1642 - $options['live_agent_status'] = 'off';
1643 - $needs_update = true;
1644 - }
1645 -
1646 - // Only update if needed
1647 - if ($needs_update) {
1648 - update_option('mxchat_options', $options);
1649 - }
1650 - } else {
1651 - // If status doesn't exist, set default to off
1652 - $options['live_agent_status'] = 'off';
1653 - update_option('mxchat_options', $options);
1654 - }
1655 -}
1656 -
1657 -function mxchat_handle_live_agent_update() {
1658 - // Get the CURRENT stored version (before it gets updated)
1659 - $current_version = get_option('mxchat_plugin_version', '0.0.0');
1660 - $new_version = '2.2.2';
1661 -
1662 - // Only run this once for the update to 2.2.2
1663 - $update_handled = get_option('mxchat_live_agent_update_2_2_2_handled', false);
1664 -
1665 - // Check if we're upgrading TO 2.2.2 and haven't handled this yet
1666 - if (version_compare($current_version, $new_version, '<') && !$update_handled) {
1667 - $options = get_option('mxchat_options', array());
1668 -
1669 - // Check if live agent was previously enabled
1670 - if (isset($options['live_agent_status']) && $options['live_agent_status'] === 'on') {
1671 - // Disable live agent
1672 - $options['live_agent_status'] = 'off';
1673 - update_option('mxchat_options', $options);
1674 -
1675 - // Set flag to show the notification banner
1676 - update_option('mxchat_show_live_agent_disabled_notice', true);
1677 - }
1678 -
1679 - // Mark this update as handled
1680 - update_option('mxchat_live_agent_update_2_2_2_handled', true);
1681 - }
1682 -}
1683 -
1684 -/**
1685 - * Handle theme migration notice for version 3.0.1
1686 - * Shows a dismissible notice to Pro users about migrating AI-generated themes
1687 - */
1688 -function mxchat_handle_theme_migration_notice() {
1689 - // Get the CURRENT stored version (before it gets updated)
1690 - $current_version = get_option('mxchat_plugin_version', '0.0.0');
1691 - $target_version = '3.0.1';
1692 -
1693 - // Only run this once for the update to 3.0.1
1694 - $update_handled = get_option('mxchat_theme_migration_update_3_0_1_handled', false);
1695 -
1696 - // Check if we're upgrading TO 3.0.1 and haven't handled this yet
1697 - if (version_compare($current_version, $target_version, '<') && !$update_handled) {
1698 - // Check if Pro is activated - only show to Pro users
1699 - $license_status = get_option('mxchat_license_status', 'inactive');
1700 - $is_pro = ($license_status === 'active');
1701 -
1702 - if ($is_pro) {
1703 - // Set flag to show the theme migration notification banner
1704 - update_option('mxchat_show_theme_migration_notice', true);
1705 - }
1706 -
1707 - // Mark this update as handled (whether Pro or not)
1708 - update_option('mxchat_theme_migration_update_3_0_1_handled', true);
1709 - }
1710 -}
1711 -
1712 -// Initialize plugin safely
1713 -function mxchat_init() {
1714 - // Include all class files first
1715 - mxchat_include_classes();
1716 -
1717 - // Run update check (this also ensures tables exist)
1718 - mxchat_check_for_update();
1719 -
1720 - // CRITICAL: Ensure tables exist on admin pages (safety net)
1721 - add_action('admin_init', 'mxchat_ensure_tables_exist', 1);
1722 -
1723 - // Add fallback rate limit check
1724 - add_action('init', 'mxchat_check_fallback_rate_limits', 5);
1725 -
1726 - // Add migration notice hook
1727 - add_action('admin_notices', 'mxchat_show_migration_notice');
1728 - add_action('admin_notices', 'mxchat_show_model_access_notice');
1729 -
1730 - // Initialize classes with error handling
1731 - try {
1732 - // Initialize admin classes
1733 - if (is_admin()) {
1734 - if (class_exists('MxChat_Knowledge_Manager')) {
1735 - $mxchat_knowledge_manager = new MxChat_Knowledge_Manager();
1736 -
1737 - if (class_exists('MxChat_Admin')) {
1738 - $mxchat_admin = new MxChat_Admin($mxchat_knowledge_manager);
1739 - }
1740 - }
1741 -
1742 - // Initialize meta box class
1743 - if (class_exists('MxChat_Meta_Box')) {
1744 - new MxChat_Meta_Box();
1745 - }
1746 -
1747 - }
1748 -
1749 - // Initialize content generator globally — it registers wp_head hook
1750 - // for frontend CSS injection, plus wp_ajax_ hooks for admin.
1751 - if (class_exists('MxChat_Content_Generator')) {
1752 - new MxChat_Content_Generator();
1753 - }
1754 -
1755 - // Initialize cache purge globally — settings writes can happen on any
1756 - // request type (admin screens, admin-ajax autosave, wp-cli), and the
1757 - // deferred-purge cron event fires on front-end requests.
1758 - if (class_exists('MxChat_Cache_Purge')) {
1759 - MxChat_Cache_Purge::init();
1760 - }
1761 -
1762 - // Initialize REST API globally — endpoints must be registered on
1763 - // every request (admin and frontend) so they're reachable via /wp-json/.
1764 - // Endpoints are auth-gated and locked until the site owner generates
1765 - // a token in MxChat → API Access.
1766 - if (class_exists('MxChat_Rest_Api')) {
1767 - new MxChat_Rest_Api();
1768 - }
1769 -
1770 - // Initialize public classes
1771 - if (class_exists('MxChat_Public')) {
1772 - $mxchat_public = new MxChat_Public();
1773 - }
1774 -
1775 - if (class_exists('MxChat_Integrator')) {
1776 - global $mxchat_integrator;
1777 - $mxchat_integrator = new MxChat_Integrator();
1778 - }
1779 -
1780 - } catch (Exception $e) {
1781 - //error_log('MxChat initialization error: ' . $e->getMessage());
1782 -
1783 - // Show admin notice if there's an error
1784 - if (is_admin()) {
1785 - add_action('admin_notices', function() use ($e) {
1786 - echo '<div class="notice notice-error"><p>';
1787 - echo '<strong>MxChat Error:</strong> Plugin initialization failed. ';
1788 - echo 'Please check error logs or contact support. Error: ' . esc_html($e->getMessage());
1789 - echo '</p></div>';
1790 - });
1791 - }
1792 - }
1793 -}
1794 -
1795 -// Run initialization on plugins_loaded
1796 -add_action('plugins_loaded', 'mxchat_init');
1797 -
1798 -// Run migration check on admin init (for auto-updates without reactivation)
1799 -add_action('admin_init', 'mxchat_check_and_run_migrations');
1800 -
1801 -/**
1802 - * Check and run migrations on admin init
1803 - * This ensures migrations run even when plugin is auto-updated
1804 - */
1805 -function mxchat_check_and_run_migrations() {
1806 - // Only run in admin and not on every request
1807 - static $checked = false;
1808 - if ($checked) {
1809 - return;
1810 - }
1811 - $checked = true;
1812 -
1813 - mxchat_migrate_pinecone_roles_add_bot_id();
1814 - mxchat_migrate_add_content_type_column();
1815 - mxchat_migrate_add_translations_table();
1816 - mxchat_migrate_add_session_ratings_table();
1817 -}
1818 -
1819 -/**
1820 - * Migration: Create per-session satisfaction ratings table (v3.2.6)
1821 - * For users upgrading from versions before 3.2.6
1822 - */
1823 -function mxchat_migrate_add_session_ratings_table() {
1824 - $migration_key = 'mxchat_session_ratings_table_created';
1825 - if (get_option($migration_key)) {
1826 - return;
1827 - }
1828 - mxchat_create_session_ratings_table();
1829 - update_option($migration_key, '3.2.6');
1830 -}
1831 -
1832 -/**
1833 - * Migration: Create transcript translations table (v3.0.4)
1834 - * For users upgrading from versions before 3.0.4
1835 - */
1836 -function mxchat_migrate_add_translations_table() {
1837 - $migration_key = 'mxchat_translations_table_created';
1838 -
1839 - // Check if migration already ran
1840 - if (get_option($migration_key)) {
1841 - return;
1842 - }
1843 -
1844 - // Create the translations table
1845 - mxchat_create_translations_table();
1846 -
1847 - // Mark migration as complete
1848 - update_option($migration_key, '3.0.4');
1849 -}
1850 -
1851 -/**
1852 - * Migration: Update deprecated Gemini embedding model (v3.0.5)
1853 - * Updates gemini-embedding-exp-03-07 to gemini-embedding-001 for users who had it selected
1854 - */
1855 -function mxchat_migrate_gemini_embedding_model() {
1856 - $options = get_option('mxchat_options', array());
1857 -
1858 - if (isset($options['embedding_model']) && $options['embedding_model'] === 'gemini-embedding-exp-03-07') {
1859 - $options['embedding_model'] = 'gemini-embedding-001';
1860 - update_option('mxchat_options', $options);
1861 - }
1862 -}
1863 -
1864 -// Register activation hook
1865 -register_activation_hook(__FILE__, 'mxchat_activate');
1866 -
1867 -// Add cron schedule
1868 -add_filter('cron_schedules', function($schedules) {
1869 - $schedules['one_minute'] = array(
1870 - 'interval' => 60,
1871 - 'display' => 'Every Minute'
1872 - );
1873 - return $schedules;
1874 -});
1875 -
1876 -// Register deactivation hook
1877 -register_deactivation_hook(__FILE__, 'mxchat_deactivate');
1878 -
1879 -/**
1880 - * Per-session satisfaction rating: AJAX save handler (v3.2.6).
1881 - * Records one 👍/👎 + optional feedback per chat session. The UNIQUE KEY on
1882 - * session_id makes this naturally idempotent — only the first rating per
1883 - * session is stored; duplicate POSTs are silent no-ops.
1884 - */
1885 -function mxchat_save_session_rating() {
1886 - global $wpdb;
1887 -
1888 - $session_id = isset($_POST['session_id']) ? MxChat_Utils::sanitize_session_id(wp_unslash($_POST['session_id'])) : '';
1889 - $bot_id = isset($_POST['bot_id']) ? sanitize_text_field(wp_unslash($_POST['bot_id'])) : 'default';
1890 - $rating_raw = isset($_POST['rating']) ? (int) $_POST['rating'] : 0;
1891 - $feedback = isset($_POST['feedback']) ? sanitize_textarea_field(wp_unslash($_POST['feedback'])) : '';
1892 -
1893 - if ($session_id === '' || ($rating_raw !== 1 && $rating_raw !== -1)) {
1894 - wp_send_json_error(array('message' => 'invalid_input'), 400);
1895 - }
1896 -
1897 - if (strlen($feedback) > 1000) {
1898 - $feedback = substr($feedback, 0, 1000);
1899 - }
1900 -
1901 - $table_name = $wpdb->prefix . 'mxchat_session_ratings';
1902 - $existing = $wpdb->get_var($wpdb->prepare(
1903 - "SELECT id FROM $table_name WHERE session_id = %s LIMIT 1",
1904 - $session_id
1905 - ));
1906 -
1907 - if ($existing) {
1908 - if ($feedback !== '') {
1909 - $wpdb->update(
1910 - $table_name,
1911 - array('rating_feedback' => $feedback),
1912 - array('id' => (int) $existing),
1913 - array('%s'),
1914 - array('%d')
1915 - );
1916 - }
1917 - wp_send_json_success(array('updated' => true));
1918 - }
1919 -
1920 - $inserted = $wpdb->insert(
1921 - $table_name,
1922 - array(
1923 - 'session_id' => $session_id,
1924 - 'bot_id' => $bot_id !== '' ? $bot_id : 'default',
1925 - 'rating_value' => $rating_raw,
1926 - 'rating_feedback' => $feedback !== '' ? $feedback : null,
1927 - 'created_at' => current_time('mysql'),
1928 - ),
1929 - array('%s', '%s', '%d', '%s', '%s')
1930 - );
1931 -
1932 - if ($inserted === false) {
1933 - wp_send_json_error(array('message' => 'db_insert_failed'), 500);
1934 - }
1935 -
1936 - wp_send_json_success(array('saved' => true));
1937 -}
1938 -add_action('wp_ajax_mxchat_save_rating', 'mxchat_save_session_rating');
1939 -add_action('wp_ajax_nopriv_mxchat_save_rating', 'mxchat_save_session_rating');
1 +<?php
2 +/**
3 + * Plugin Name: MxChat
4 + * Plugin URI: https://mxchat.ai/
5 + * Description: AI chatbot for WordPress with OpenAI, Claude, xAI, DeepSeek, live agent, PDF uploads, WooCommerce, and training on website data.
6 + * Version: 3.0.7
7 + * Author: MxChat
8 + * Author URI: https://mxchat.ai
9 + * License: GPLv2 or later
10 + * License URI: https://www.gnu.org/licenses/gpl-2.0.html
11 + * Text Domain: mxchat
12 + * Domain Path: /languages
13 + */
14 +
15 +if (!defined('ABSPATH')) {
16 + exit; // Exit if accessed directly.
17 +}
18 +
19 +// Define plugin version constant for asset versioning
20 +// Reads version from plugin header automatically
21 +if (!defined('MXCHAT_VERSION')) {
22 + $plugin_data = get_file_data(__FILE__, array('Version' => 'Version'), 'plugin');
23 + define('MXCHAT_VERSION', $plugin_data['Version']);
24 +}
25 +
26 +function mxchat_load_textdomain() {
27 + $domain = 'mxchat';
28 + $locale = determine_locale();
29 +
30 + // First, try to load from /wp-content/languages/plugins/ (preserved during updates)
31 + $mo_file = WP_LANG_DIR . '/plugins/' . $domain . '-' . $locale . '.mo';
32 + if (file_exists($mo_file)) {
33 + load_textdomain($domain, $mo_file);
34 + return;
35 + }
36 +
37 + // Fallback to plugin's /languages directory
38 + load_plugin_textdomain($domain, false, dirname(plugin_basename(__FILE__)) . '/languages');
39 +}
40 +add_action('init', 'mxchat_load_textdomain');
41 +
42 +// Include classes with error handling
43 +function mxchat_include_classes() {
44 + $class_files = array(
45 + 'includes/class-mxchat-integrator.php',
46 + 'includes/class-mxchat-admin.php',
47 + 'includes/class-mxchat-public.php',
48 + 'includes/class-mxchat-utils.php',
49 + 'includes/class-mxchat-user.php',
50 + 'includes/class-mxchat-meta-box.php',
51 + 'includes/class-mxchat-chunker.php',
52 + 'includes/pdf-parser/alt_autoload.php',
53 + 'includes/class-mxchat-word-handler.php',
54 + 'admin/class-ajax-handler.php',
55 + 'admin/class-pinecone-manager.php',
56 + 'admin/class-knowledge-manager.php'
57 + );
58 +
59 + foreach ($class_files as $file) {
60 + $file_path = plugin_dir_path(__FILE__) . $file;
61 + if (file_exists($file_path)) {
62 + require_once $file_path;
63 + } else {
64 + //error_log('MxChat: Missing class file - ' . $file);
65 + }
66 + }
67 +}
68 +
69 +/**
70 + * Create URL click tracking table
71 + */
72 +function mxchat_create_url_clicks_table() {
73 + global $wpdb;
74 +
75 + $table_name = $wpdb->prefix . 'mxchat_url_clicks';
76 +
77 + $charset_collate = $wpdb->get_charset_collate();
78 +
79 + $sql = "CREATE TABLE $table_name (
80 + id mediumint(9) NOT NULL AUTO_INCREMENT,
81 + session_id varchar(100) NOT NULL,
82 + clicked_url text NOT NULL,
83 + message_context text,
84 + click_timestamp datetime DEFAULT CURRENT_TIMESTAMP,
85 + user_ip varchar(45),
86 + user_agent text,
87 + PRIMARY KEY (id),
88 + KEY session_id (session_id),
89 + KEY click_timestamp (click_timestamp)
90 + ) $charset_collate;";
91 +
92 + require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
93 + dbDelta($sql);
94 +}
95 +
96 +/**
97 + * FIXED: Robust table creation and column management
98 + */
99 +function mxchat_create_chat_transcripts_table() {
100 + global $wpdb;
101 +
102 + $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
103 + $charset_collate = $wpdb->get_charset_collate();
104 +
105 + // Create table with ALL columns including user_name from the start
106 + $sql = "CREATE TABLE $table_name (
107 + id MEDIUMINT(9) NOT NULL AUTO_INCREMENT,
108 + user_id MEDIUMINT(9) DEFAULT 0,
109 + session_id VARCHAR(255) NOT NULL,
110 + role VARCHAR(255) NOT NULL,
111 + message TEXT NOT NULL,
112 + user_email VARCHAR(255) DEFAULT NULL,
113 + user_name VARCHAR(100) DEFAULT NULL,
114 + user_identifier VARCHAR(255) DEFAULT NULL,
115 + originating_page_url TEXT DEFAULT NULL,
116 + originating_page_title VARCHAR(500) DEFAULT NULL,
117 + timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
118 + PRIMARY KEY (id),
119 + KEY session_id (session_id),
120 + KEY user_email (user_email),
121 + KEY timestamp (timestamp)
122 + ) $charset_collate;";
123 +
124 + require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
125 + $result = dbDelta($sql);
126 +
127 + // Log the result for debugging
128 + if (empty($result)) {
129 + //error_log("MxChat: dbDelta returned empty result for chat transcripts table");
130 + } else {
131 + //error_log("MxChat: dbDelta result: " . print_r($result, true));
132 + }
133 +
134 + // IMPORTANT: Ensure all columns exist for existing installations
135 + mxchat_ensure_all_columns($table_name);
136 +}
137 +
138 +/**
139 + * Ensure all required columns exist (for upgrades)
140 + */
141 +function mxchat_ensure_all_columns($table_name) {
142 + global $wpdb;
143 +
144 + // First check if table exists
145 + $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
146 + if (!$table_exists) {
147 + //error_log("MxChat: Table $table_name does not exist, cannot add columns");
148 + return;
149 + }
150 +
151 + // Define all required columns and their types
152 + $required_columns = [
153 + 'user_identifier' => 'VARCHAR(255) DEFAULT NULL',
154 + 'user_email' => 'VARCHAR(255) DEFAULT NULL',
155 + 'user_name' => 'VARCHAR(100) DEFAULT NULL',
156 + 'originating_page_url' => 'TEXT DEFAULT NULL',
157 + 'originating_page_title' => 'VARCHAR(500) DEFAULT NULL',
158 + 'rag_context' => 'LONGTEXT DEFAULT NULL'
159 + ];
160 +
161 + // Get existing columns
162 + $existing_columns = $wpdb->get_results("SHOW COLUMNS FROM $table_name");
163 + if (empty($existing_columns)) {
164 + //error_log("MxChat: Could not get columns for table $table_name");
165 + return;
166 + }
167 +
168 + $existing_column_names = array_column($existing_columns, 'Field');
169 +
170 + // Add missing columns
171 + foreach ($required_columns as $column_name => $column_definition) {
172 + if (!in_array($column_name, $existing_column_names)) {
173 + $alter_sql = "ALTER TABLE $table_name ADD COLUMN $column_name $column_definition";
174 + $result = $wpdb->query($alter_sql);
175 +
176 + if ($result === false) {
177 + //error_log("MxChat: Failed to add column $column_name to $table_name. Error: " . $wpdb->last_error);
178 + } else {
179 + //error_log("MxChat: Successfully added column $column_name to $table_name");
180 + }
181 + }
182 + }
183 +}
184 +
185 +/**
186 + * Add role restriction column to knowledge base table
187 + */
188 +function mxchat_add_role_restriction_column() {
189 + global $wpdb;
190 + $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
191 +
192 + // Check if table exists first
193 + $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
194 + if (!$table_exists) {
195 + //error_log("MxChat: System prompt content table does not exist, cannot add role_restriction column");
196 + return;
197 + }
198 +
199 + // Check if column already exists
200 + $column_exists = $wpdb->get_results(
201 + $wpdb->prepare(
202 + "SHOW COLUMNS FROM {$table_name} LIKE %s",
203 + 'role_restriction'
204 + )
205 + );
206 +
207 + if (empty($column_exists)) {
208 + $alter_sql = "ALTER TABLE {$table_name} ADD COLUMN role_restriction VARCHAR(50) DEFAULT 'public' AFTER source_url";
209 + $result = $wpdb->query($alter_sql);
210 +
211 + if ($result === false) {
212 + //error_log("MxChat: Failed to add role_restriction column. Error: " . $wpdb->last_error);
213 + } else {
214 + //error_log("MxChat: Successfully added role_restriction column");
215 +
216 + // Set all existing records to 'public' (everyone can access)
217 + $update_result = $wpdb->query(
218 + "UPDATE {$table_name}
219 + SET role_restriction = 'public'
220 + WHERE role_restriction IS NULL OR role_restriction = ''"
221 + );
222 +
223 + if ($update_result !== false) {
224 + //error_log("MxChat: Updated {$update_result} existing records to public access");
225 + }
226 + }
227 + }
228 +}
229 +
230 +/**
231 + * Add enabled_bots column to intents table for multi-bot action filtering
232 + */
233 +function mxchat_add_enabled_bots_column() {
234 + global $wpdb;
235 + $table_name = $wpdb->prefix . 'mxchat_intents';
236 +
237 + // Check if table exists first
238 + $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
239 + if (!$table_exists) {
240 + //error_log("MxChat: Intents table does not exist, cannot add enabled_bots column");
241 + return;
242 + }
243 +
244 + // Check if column already exists
245 + $column_exists = $wpdb->get_results(
246 + $wpdb->prepare(
247 + "SHOW COLUMNS FROM {$table_name} LIKE %s",
248 + 'enabled_bots'
249 + )
250 + );
251 +
252 + if (empty($column_exists)) {
253 + $alter_sql = "ALTER TABLE {$table_name} ADD COLUMN enabled_bots LONGTEXT DEFAULT NULL AFTER enabled";
254 + $result = $wpdb->query($alter_sql);
255 +
256 + if ($result === false) {
257 + //error_log("MxChat: Failed to add enabled_bots column. Error: " . $wpdb->last_error);
258 + } else {
259 + //error_log("MxChat: Successfully added enabled_bots column");
260 +
261 + // Set all existing actions to work with 'default' bot for backward compatibility
262 + $default_bots = json_encode(['default']);
263 + $update_result = $wpdb->query(
264 + $wpdb->prepare(
265 + "UPDATE {$table_name}
266 + SET enabled_bots = %s
267 + WHERE enabled_bots IS NULL OR enabled_bots = ''",
268 + $default_bots
269 + )
270 + );
271 +
272 + if ($update_result !== false) {
273 + //error_log("MxChat: Updated {$update_result} existing actions to work with default bot");
274 + }
275 + }
276 + }
277 +}
278 +
279 +/**
280 + * Create Pinecone role restrictions table with multi-bot support
281 + */
282 +function mxchat_create_pinecone_roles_table() {
283 + global $wpdb;
284 +
285 + $table_name = $wpdb->prefix . 'mxchat_pinecone_roles';
286 + $charset_collate = $wpdb->get_charset_collate();
287 +
288 + $sql = "CREATE TABLE $table_name (
289 + id mediumint(9) NOT NULL AUTO_INCREMENT,
290 + vector_id varchar(255) NOT NULL,
291 + bot_id varchar(50) NOT NULL DEFAULT 'default',
292 + source_url text,
293 + role_restriction varchar(50) DEFAULT 'public',
294 + updated_at timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
295 + PRIMARY KEY (id),
296 + UNIQUE KEY vector_bot (vector_id, bot_id),
297 + KEY role_restriction (role_restriction),
298 + KEY bot_id (bot_id)
299 + ) $charset_collate;";
300 +
301 + require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
302 + dbDelta($sql);
303 +}
304 +
305 +/**
306 + * Add bot_id column to mxchat_pinecone_roles table for multi-bot support
307 + * This migration runs once to update existing installations
308 + */
309 +function mxchat_migrate_pinecone_roles_add_bot_id() {
310 + global $wpdb;
311 +
312 + // Check if migration already ran
313 + $migration_version = get_option('mxchat_pinecone_roles_migration_version', '0');
314 + if (version_compare($migration_version, '2.5.2', '>=')) {
315 + return; // Already migrated
316 + }
317 +
318 + $table_name = $wpdb->prefix . 'mxchat_pinecone_roles';
319 +
320 + // Check if table exists
321 + if ($wpdb->get_var("SHOW TABLES LIKE '{$table_name}'") != $table_name) {
322 + return; // Table doesn't exist yet
323 + }
324 +
325 + // Check if bot_id column already exists
326 + $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$table_name} LIKE 'bot_id'");
327 +
328 + if (empty($column_exists)) {
329 + // Add bot_id column
330 + $wpdb->query("ALTER TABLE {$table_name} ADD COLUMN bot_id VARCHAR(50) NOT NULL DEFAULT 'default' AFTER vector_id");
331 +
332 + // Update the unique key to include bot_id
333 + $wpdb->query("ALTER TABLE {$table_name} DROP INDEX vector_id");
334 + $wpdb->query("ALTER TABLE {$table_name} ADD UNIQUE KEY vector_bot (vector_id, bot_id)");
335 +
336 + // Add index for bot_id
337 + $wpdb->query("ALTER TABLE {$table_name} ADD KEY bot_id (bot_id)");
338 +
339 + error_log('MxChat: Successfully added bot_id column to mxchat_pinecone_roles table');
340 + }
341 +
342 + // Mark migration as complete
343 + update_option('mxchat_pinecone_roles_migration_version', '2.5.2');
344 +}
345 +
346 +/**
347 + * 2.5.6: Add content_type column to mxchat_system_prompt_content table
348 + * Enables filtering knowledge base by content type (posts, pages, PDFs, etc.)
349 + */
350 +function mxchat_migrate_add_content_type_column() {
351 + global $wpdb;
352 +
353 + // Check if migration already ran
354 + $migration_version = get_option('mxchat_content_type_migration_version', '0');
355 + if (version_compare($migration_version, '2.5.6', '>=')) {
356 + return;
357 + }
358 +
359 + $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
360 +
361 + // Check if table exists
362 + if ($wpdb->get_var("SHOW TABLES LIKE '{$table_name}'") != $table_name) {
363 + return;
364 + }
365 +
366 + // Check if content_type column already exists
367 + $column_exists = $wpdb->get_results("SHOW COLUMNS FROM {$table_name} LIKE 'content_type'");
368 +
369 + if (empty($column_exists)) {
370 + // Add content_type column with default value 'content' for backwards compatibility
371 + $wpdb->query("ALTER TABLE {$table_name} ADD COLUMN content_type VARCHAR(50) DEFAULT 'content' AFTER role_restriction");
372 +
373 + // Add index for better query performance
374 + $wpdb->query("ALTER TABLE {$table_name} ADD KEY content_type (content_type)");
375 +
376 + error_log('MxChat: Successfully added content_type column to mxchat_system_prompt_content table');
377 + }
378 +
379 + // Mark migration as complete
380 + update_option('mxchat_content_type_migration_version', '2.5.6');
381 +}
382 +
383 +/**
384 + * 2.5.2: Create queue processing tables for reliable background processing
385 + */
386 +function mxchat_create_queue_tables() {
387 + global $wpdb;
388 + $charset_collate = $wpdb->get_charset_collate();
389 +
390 + // Main queue table
391 + $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
392 + $sql_queue = "CREATE TABLE $queue_table (
393 + id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
394 + queue_id varchar(64) NOT NULL,
395 + item_type varchar(20) NOT NULL,
396 + item_data longtext NOT NULL,
397 + status varchar(20) NOT NULL DEFAULT 'pending',
398 + bot_id varchar(50) NOT NULL DEFAULT 'default',
399 + priority int(11) NOT NULL DEFAULT 0,
400 + attempts int(11) NOT NULL DEFAULT 0,
401 + max_attempts int(11) NOT NULL DEFAULT 3,
402 + error_message text DEFAULT NULL,
403 + created_at datetime NOT NULL,
404 + started_at datetime DEFAULT NULL,
405 + completed_at datetime DEFAULT NULL,
406 + PRIMARY KEY (id),
407 + KEY queue_id (queue_id),
408 + KEY status (status),
409 + KEY item_type (item_type),
410 + KEY priority (priority)
411 + ) $charset_collate;";
412 +
413 + // Queue metadata table
414 + $meta_table = $wpdb->prefix . 'mxchat_queue_meta';
415 + $sql_meta = "CREATE TABLE $meta_table (
416 + id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
417 + queue_id varchar(64) NOT NULL,
418 + meta_key varchar(255) NOT NULL,
419 + meta_value longtext,
420 + PRIMARY KEY (id),
421 + KEY queue_id (queue_id),
422 + KEY meta_key (meta_key)
423 + ) $charset_collate;";
424 +
425 + require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
426 + dbDelta($sql_queue);
427 + dbDelta($sql_meta);
428 +
429 + //error_log("MxChat: Queue tables created/updated successfully");
430 +}
431 +
432 +/**
433 + * Create transcript translations table for persisting translations
434 + */
435 +function mxchat_create_translations_table() {
436 + global $wpdb;
437 + $charset_collate = $wpdb->get_charset_collate();
438 +
439 + $table_name = $wpdb->prefix . 'mxchat_transcript_translations';
440 + $sql = "CREATE TABLE $table_name (
441 + id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
442 + session_id varchar(255) NOT NULL,
443 + language_code varchar(10) NOT NULL,
444 + translations longtext NOT NULL,
445 + created_at datetime NOT NULL,
446 + updated_at datetime NOT NULL,
447 + PRIMARY KEY (id),
448 + UNIQUE KEY session_lang (session_id, language_code),
449 + KEY session_id (session_id)
450 + ) $charset_collate;";
451 +
452 + require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
453 + dbDelta($sql);
454 +}
455 +
456 +/**
457 + * 2.5.2: Fix URL column size to support long URLs (especially with UTF-8 encoding)
458 + * This fixes "url, source_url. The supplied values may be too long" errors
459 + */
460 +function mxchat_fix_url_column_size() {
461 + global $wpdb;
462 + $table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
463 +
464 + // Check if table exists
465 + $table_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
466 + if (!$table_exists) {
467 + return;
468 + }
469 +
470 + // Change url and source_url from VARCHAR to TEXT to handle long URLs
471 + // This is especially important for URLs with UTF-8 encoded characters (Hebrew, Arabic, etc.)
472 + $wpdb->query("ALTER TABLE {$table_name} MODIFY COLUMN url TEXT");
473 + $wpdb->query("ALTER TABLE {$table_name} MODIFY COLUMN source_url TEXT");
474 +
475 + //error_log("MxChat: Successfully updated url and source_url columns to TEXT type for long URL support");
476 +}
477 +
478 +/**
479 + * Migrate deprecated AI models to their replacements
480 + * Version 2.5.1: Migrate Claude 3.5 Sonnet (deprecated) to Claude 3.7 Sonnet
481 + * Version 3.0.55: Migrate GPT-4 series models (deprecated 2026-02-17) to GPT-5 series
482 + */
483 +function mxchat_migrate_deprecated_models() {
484 + $options = get_option('mxchat_options', array());
485 + $migrated = false;
486 + $migration_message = '';
487 +
488 + if (!isset($options['model'])) {
489 + return;
490 + }
491 +
492 + $current_model = $options['model'];
493 +
494 + // Migrate deprecated Claude models to Claude Opus 4.6 (recommended replacement per Anthropic)
495 + $deprecated_claude_models = array(
496 + 'claude-3-5-sonnet-20240620', // Retired Oct 28, 2025
497 + 'claude-3-5-sonnet-20241022', // Retired Oct 28, 2025
498 + 'claude-3-7-sonnet-20250219', // Retiring Feb 19, 2026
499 + 'claude-3-opus-20240229', // Retired Jan 5, 2026
500 + 'claude-3-sonnet-20240229', // Legacy
501 + 'claude-3-haiku-20240307', // Legacy
502 + );
503 + if (in_array($current_model, $deprecated_claude_models, true)) {
504 + $options['model'] = 'claude-opus-4-6';
505 + $migrated = true;
506 + $migration_message = sprintf(
507 + __('Your chatbot model has been automatically updated from %s to Claude Opus 4.6 due to Anthropic deprecating older Claude models.', 'mxchat'),
508 + $current_model
509 + );
510 + }
511 +
512 + // Migrate deprecated Claude Haiku 3.5 to Claude Haiku 4.5
513 + if ($current_model === 'claude-3-5-haiku-20241022') {
514 + $options['model'] = 'claude-haiku-4-5-20251001';
515 + $migrated = true;
516 + $migration_message = __('Your chatbot model has been automatically updated from Claude Haiku 3.5 to Claude Haiku 4.5 due to Anthropic deprecating the older model.', 'mxchat');
517 + }
518 +
519 + // Migrate deprecated GPT-4 series and GPT-3.5 Turbo to GPT-5.1 Chat Latest
520 + if (in_array($current_model, array('gpt-4o', 'gpt-4.1-2025-04-14', 'gpt-4-turbo', 'gpt-4', 'gpt-3.5-turbo'), true)) {
521 + $options['model'] = 'gpt-5.1-chat-latest';
522 + $migrated = true;
523 + $migration_message = sprintf(
524 + __('Your chatbot model has been automatically updated from %s to GPT-5.1 Chat Latest due to OpenAI deprecating older models.', 'mxchat'),
525 + $current_model
526 + );
527 + }
528 +
529 + // Migrate deprecated GPT-4o Mini and GPT-4.1 Mini to GPT-5 Mini
530 + if (in_array($current_model, array('gpt-4o-mini', 'gpt-4.1-mini'), true)) {
531 + $options['model'] = 'gpt-5-mini';
532 + $migrated = true;
533 + $migration_message = sprintf(
534 + __('Your chatbot model has been automatically updated from %s to GPT-5 Mini due to OpenAI deprecating GPT-4 series models.', 'mxchat'),
535 + $current_model
536 + );
537 + }
538 +
539 + if ($migrated) {
540 + update_option('mxchat_options', $options);
541 + update_option('mxchat_model_migrated_notice', true);
542 + update_option('mxchat_model_migration_message', $migration_message);
543 + }
544 +}
545 +
546 +/**
547 + * Show admin notice after model migration
548 + */
549 +function mxchat_show_migration_notice() {
550 + if (get_option('mxchat_model_migrated_notice')) {
551 + $migration_message = get_option('mxchat_model_migration_message', __('Your chatbot model has been automatically updated due to a model deprecation.', 'mxchat'));
552 + ?>
553 + <div class="notice notice-info is-dismissible">
554 + <p>
555 + <strong><?php esc_html_e('MxChat Model Updated', 'mxchat'); ?></strong><br>
556 + <?php echo esc_html($migration_message); ?>
557 + </p>
558 + </div>
559 + <?php
560 + delete_option('mxchat_model_migrated_notice');
561 + delete_option('mxchat_model_migration_message');
562 + }
563 +}
564 +
565 +function mxchat_activate() {
566 + global $wpdb;
567 + $charset_collate = $wpdb->get_charset_collate();
568 +
569 + //error_log("MxChat: Running activation function");
570 +
571 + // Create chat transcripts table with improved function
572 + mxchat_create_chat_transcripts_table();
573 +
574 + // System Prompt Content Table - UPDATED: Use TEXT for url and source_url columns
575 + $system_prompt_table = $wpdb->prefix . 'mxchat_system_prompt_content';
576 + $sql_system_prompt = "CREATE TABLE $system_prompt_table (
577 + id MEDIUMINT(9) NOT NULL AUTO_INCREMENT,
578 + url TEXT NOT NULL,
579 + article_content LONGTEXT NOT NULL,
580 + embedding_vector LONGTEXT,
581 + source_url TEXT DEFAULT NULL,
582 + role_restriction VARCHAR(50) DEFAULT 'public',
583 + content_type VARCHAR(50) DEFAULT 'content',
584 + timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
585 + PRIMARY KEY (id),
586 + KEY content_type (content_type)
587 + ) $charset_collate;";
588 +
589 + // Intents Table - NOW INCLUDES enabled_bots column from the start
590 + $intents_table = $wpdb->prefix . 'mxchat_intents';
591 + $sql_intents_table = "CREATE TABLE $intents_table (
592 + id BIGINT(20) UNSIGNED NOT NULL AUTO_INCREMENT,
593 + intent_label VARCHAR(255) NOT NULL,
594 + phrases TEXT NOT NULL,
595 + embedding_vector LONGTEXT NOT NULL,
596 + callback_function VARCHAR(255) NOT NULL,
597 + similarity_threshold FLOAT DEFAULT 0.85,
598 + enabled TINYINT(1) NOT NULL DEFAULT 1,
599 + enabled_bots LONGTEXT DEFAULT NULL,
600 + PRIMARY KEY (id)
601 + ) $charset_collate;";
602 +
603 + require_once ABSPATH . 'wp-admin/includes/upgrade.php';
604 +
605 + // Create other tables
606 + dbDelta($sql_system_prompt);
607 + dbDelta($sql_intents_table);
608 +
609 + // Create URL click tracking table
610 + mxchat_create_url_clicks_table();
611 +
612 + // Create Pinecone roles table
613 + mxchat_create_pinecone_roles_table();
614 +
615 + // NEW 2.5.2: Create queue processing tables
616 + mxchat_create_queue_tables();
617 +
618 + // Create transcript translations table
619 + mxchat_create_translations_table();
620 +
621 + // Ensure additional columns in system prompt table
622 + $existing_system_columns = $wpdb->get_results("SHOW COLUMNS FROM $system_prompt_table");
623 + if (!empty($existing_system_columns)) {
624 + $existing_system_column_names = array_column($existing_system_columns, 'Field');
625 +
626 + if (!in_array('embedding_vector', $existing_system_column_names)) {
627 + $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN embedding_vector LONGTEXT");
628 + }
629 + if (!in_array('source_url', $existing_system_column_names)) {
630 + $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN source_url TEXT DEFAULT NULL");
631 + }
632 + if (!in_array('role_restriction', $existing_system_column_names)) {
633 + $wpdb->query("ALTER TABLE $system_prompt_table ADD COLUMN role_restriction VARCHAR(50) DEFAULT 'public' AFTER source_url");
634 + }
635 + }
636 +
637 + // Set default thresholds for existing intents
638 + $wpdb->query("UPDATE {$intents_table} SET similarity_threshold = 0.85 WHERE similarity_threshold IS NULL");
639 +
640 + // Ensure enabled column exists in intents table
641 + $existing_intent_columns = $wpdb->get_results("SHOW COLUMNS FROM $intents_table");
642 + if (!empty($existing_intent_columns)) {
643 + $existing_intent_column_names = array_column($existing_intent_columns, 'Field');
644 +
645 + if (!in_array('enabled', $existing_intent_column_names)) {
646 + $wpdb->query("ALTER TABLE $intents_table ADD COLUMN enabled TINYINT(1) NOT NULL DEFAULT 1");
647 + }
648 +
649 + // Ensure enabled_bots column exists for existing installations
650 + if (!in_array('enabled_bots', $existing_intent_column_names)) {
651 + $wpdb->query("ALTER TABLE $intents_table ADD COLUMN enabled_bots LONGTEXT DEFAULT NULL AFTER enabled");
652 +
653 + // Set existing actions to work with default bot
654 + $default_bots = json_encode(['default']);
655 + $wpdb->query($wpdb->prepare(
656 + "UPDATE {$intents_table} SET enabled_bots = %s WHERE enabled_bots IS NULL",
657 + $default_bots
658 + ));
659 + }
660 + }
661 +
662 + // Run migration for existing installations
663 + mxchat_migrate_pinecone_roles_add_bot_id();
664 +
665 + // Setup cron jobs
666 + mxchat_setup_cron_jobs();
667 +
668 + // Update version
669 + update_option('mxchat_plugin_version', MXCHAT_VERSION);
670 +
671 + //error_log("MxChat: Activation function completed");
672 +}
673 +
674 +/**
675 + * Setup cron jobs on plugin activation
676 + */
677 +function mxchat_setup_cron_jobs() {
678 + // Clear any existing cron jobs first
679 + wp_clear_scheduled_hook('mxchat_reset_rate_limits');
680 +
681 + // Check if WordPress cron is disabled
682 + if (defined('DISABLE_WP_CRON') && DISABLE_WP_CRON) {
683 + // Set flag to use fallback system
684 + update_option('mxchat_use_fallback_rate_limits', true);
685 + update_option('mxchat_next_rate_limit_check', time() + 3600);
686 + return;
687 + }
688 +
689 + // Schedule the rate limit reset cron job
690 + $result = wp_schedule_event(time() + 300, 'hourly', 'mxchat_reset_rate_limits');
691 +
692 + if ($result === false) {
693 + // Fallback if scheduling fails
694 + update_option('mxchat_use_fallback_rate_limits', true);
695 + update_option('mxchat_next_rate_limit_check', time() + 3600);
696 + } else {
697 + // Clear fallback flags if cron scheduling succeeded
698 + delete_option('mxchat_use_fallback_rate_limits');
699 + }
700 +
701 + // Schedule transcript cleanup if configured
702 + $transcript_options = get_option('mxchat_transcripts_options', array());
703 + $cleanup_interval = isset($transcript_options['mxchat_auto_delete_transcripts']) ? $transcript_options['mxchat_auto_delete_transcripts'] : 'never';
704 +
705 + if ($cleanup_interval !== 'never') {
706 + // Check if not already scheduled
707 + if (!wp_next_scheduled('mxchat_cleanup_old_transcripts')) {
708 + // Schedule to run daily at 3 AM
709 + $next_run = strtotime('tomorrow 3:00 AM');
710 + wp_schedule_event($next_run, 'daily', 'mxchat_cleanup_old_transcripts');
711 + }
712 + }
713 +}
714 +
715 +/**
716 + * Clean up on plugin deactivation
717 + */
718 +function mxchat_deactivate() {
719 + // Clear scheduled cron jobs
720 + wp_clear_scheduled_hook('mxchat_reset_rate_limits');
721 + wp_clear_scheduled_hook('mxchat_cleanup_old_transcripts');
722 + wp_clear_scheduled_hook('mxchat_send_delayed_transcript');
723 +
724 + // Clear fallback options
725 + delete_option('mxchat_use_fallback_rate_limits');
726 + delete_option('mxchat_next_rate_limit_check');
727 + delete_option('mxchat_fallback_check_interval');
728 +
729 + // NOTE: We do NOT delete queue tables on deactivation
730 + // This preserves data if user accidentally deactivates the plugin
731 +}
732 +
733 +/**
734 + * Check if fallback rate limit cleanup is needed
735 + */
736 +function mxchat_check_fallback_rate_limits() {
737 + $use_fallback = get_option('mxchat_use_fallback_rate_limits', false);
738 +
739 + if (!$use_fallback) {
740 + return;
741 + }
742 +
743 + $next_check = get_option('mxchat_next_rate_limit_check', 0);
744 +
745 + if (time() >= $next_check) {
746 + // Only run reset if the MxChat_Integrator class exists
747 + if (class_exists('MxChat_Integrator')) {
748 + $integrator = new MxChat_Integrator();
749 + if (method_exists($integrator, 'mxchat_reset_rate_limits')) {
750 + $integrator->mxchat_reset_rate_limits();
751 + update_option('mxchat_next_rate_limit_check', time() + 3600);
752 + }
753 + }
754 + }
755 +}
756 +
757 +/**
758 + * Robust update checking with role restriction migration, model deprecation, and queue tables
759 + * CRITICAL: This runs on EVERY page load to ensure tables exist
760 + */
761 +function mxchat_check_for_update() {
762 + global $wpdb;
763 +
764 + try {
765 + $current_version = get_option('mxchat_plugin_version', '0.0.0');
766 + $plugin_version = MXCHAT_VERSION;
767 +
768 + // Always ensure critical tables exist (even if version matches)
769 + // This handles manual table deletion or fresh installs
770 + $chat_table = $wpdb->prefix . 'mxchat_chat_transcripts';
771 + $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
772 +
773 + $chat_exists = $wpdb->get_var("SHOW TABLES LIKE '$chat_table'") === $chat_table;
774 + $queue_exists = $wpdb->get_var("SHOW TABLES LIKE '$queue_table'") === $queue_table;
775 +
776 + if (!$chat_exists || !$queue_exists) {
777 + //error_log("MxChat: Critical tables missing, running activation");
778 + mxchat_activate();
779 + }
780 +
781 + // Version-specific migrations
782 + if ($current_version !== $plugin_version) {
783 + //error_log("MxChat: Version change detected: $current_version -> $plugin_version");
784 +
785 + // Run live agent update BEFORE updating the stored version
786 + mxchat_handle_live_agent_update();
787 +
788 + // Run theme migration notice for 3.0.1 (AI theme CSS structure changes)
789 + mxchat_handle_theme_migration_notice();
790 +
791 + // Run role restriction migration for 2.4.1
792 + if (version_compare($current_version, '2.4.1', '<')) {
793 + mxchat_add_role_restriction_column();
794 + }
795 +
796 + // Run enabled_bots column migration for 2.4.4
797 + if (version_compare($current_version, '2.4.4', '<')) {
798 + mxchat_add_enabled_bots_column();
799 + }
800 +
801 + // Run model migration for 2.5.1 (Claude deprecation)
802 + if (version_compare($current_version, '2.5.1', '<')) {
803 + mxchat_migrate_deprecated_models();
804 + }
805 +
806 + // 2.5.2: Ensure queue tables exist and fix URL column sizes for all users upgrading to 2.5.2
807 + if (version_compare($current_version, '2.5.2', '<')) {
808 + mxchat_create_queue_tables();
809 + mxchat_fix_url_column_size(); // NEW: Fix URL column size for long URLs
810 + //error_log("MxChat: Queue tables created and URL columns updated for upgrade to 2.5.2");
811 + }
812 +
813 + // 2.6.0: Ensure rag_context column exists for retrieved documents feature
814 + if (version_compare($current_version, '2.6.0', '<')) {
815 + $chat_table = $wpdb->prefix . 'mxchat_chat_transcripts';
816 + mxchat_ensure_all_columns($chat_table);
817 + //error_log("MxChat: rag_context column migration for 2.6.0");
818 + }
819 +
820 + // 3.0.5: Migrate deprecated Gemini embedding model
821 + if (version_compare($current_version, '3.0.5', '<')) {
822 + mxchat_migrate_gemini_embedding_model();
823 + }
824 +
825 + // 3.0.6: Migrate deprecated OpenAI and Claude models
826 + if (version_compare($current_version, '3.0.6', '<')) {
827 + mxchat_migrate_deprecated_models();
828 + }
829 +
830 + // Run full activation to ensure everything is up to date
831 + mxchat_activate();
832 +
833 + // Run migration functions
834 + mxchat_migrate_live_agent_status();
835 +
836 + // Add the cleanup function for version 2.1.8
837 + if (version_compare($current_version, '2.1.8', '<')) {
838 + $deleted = mxchat_cleanup_orphaned_chat_history();
839 + }
840 +
841 + // Update version LAST
842 + update_option('mxchat_plugin_version', $plugin_version);
843 +
844 + //error_log("MxChat: Updated from version $current_version to $plugin_version");
845 + }
846 +
847 + } catch (Exception $e) {
848 + //error_log('MxChat update error: ' . $e->getMessage());
849 + // Don't update version if there was an error
850 + }
851 +}
852 +
853 +/**
854 + * Ensure tables exist on every admin load for fresh installations
855 + * This is a safety net for cases where activation hook doesn't fire
856 + */
857 +function mxchat_ensure_tables_exist() {
858 + global $wpdb;
859 +
860 + // Only run for admin users to avoid performance impact
861 + if (!current_user_can('administrator')) {
862 + return;
863 + }
864 +
865 + // Check if we've already verified tables in this session
866 + static $tables_checked = false;
867 + if ($tables_checked) {
868 + return;
869 + }
870 + $tables_checked = true;
871 +
872 + $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
873 + $queue_table = $wpdb->prefix . 'mxchat_processing_queue';
874 +
875 + $chat_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name;
876 + $queue_exists = $wpdb->get_var("SHOW TABLES LIKE '$queue_table'") === $queue_table;
877 +
878 + if (!$chat_exists || !$queue_exists) {
879 + //error_log("MxChat: Tables missing on admin load, running activation");
880 + mxchat_activate();
881 + }
882 +}
883 +
884 +/**
885 + * Clean up orphaned chat history options from the wp_options table
886 + * @return int Number of options deleted
887 + */
888 +function mxchat_cleanup_orphaned_chat_history() {
889 + global $wpdb;
890 + $count = 0;
891 +
892 + // Get all option keys that match our pattern
893 + $history_options = $wpdb->get_results(
894 + "SELECT option_name FROM {$wpdb->options}
895 + WHERE option_name LIKE 'mxchat_history_%'"
896 + );
897 +
898 + if (!empty($history_options)) {
899 + foreach ($history_options as $option) {
900 + // Extract the session ID from the option name
901 + $session_id = str_replace('mxchat_history_', '', $option->option_name);
902 +
903 + // Check if this session still exists in the custom table
904 + $table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
905 + $exists = $wpdb->get_var(
906 + $wpdb->prepare(
907 + "SELECT COUNT(*) FROM {$table_name} WHERE session_id = %s",
908 + $session_id
909 + )
910 + );
911 +
912 + // If session doesn't exist in the main table, delete the option
913 + if ($exists == 0) {
914 + delete_option($option->option_name);
915 + // Also delete related metadata
916 + delete_option("mxchat_email_{$session_id}");
917 + delete_option("mxchat_name_{$session_id}");
918 + delete_option("mxchat_agent_name_{$session_id}");
919 + $count++;
920 + }
921 + }
922 + }
923 +
924 + return $count;
925 +}
926 +
927 +function mxchat_migrate_live_agent_status() {
928 + $options = get_option('mxchat_options', []);
929 +
930 + // Check if live_agent_status exists
931 + if (isset($options['live_agent_status'])) {
932 + $current_status = $options['live_agent_status'];
933 + $needs_update = false;
934 +
935 + // Convert to new format if needed
936 + if ($current_status === 'online') {
937 + $options['live_agent_status'] = 'on';
938 + $needs_update = true;
939 + } else if ($current_status === 'offline') {
940 + $options['live_agent_status'] = 'off';
941 + $needs_update = true;
942 + } else if (!in_array($current_status, ['on', 'off'])) {
943 + // Default to off for any unexpected values
944 + $options['live_agent_status'] = 'off';
945 + $needs_update = true;
946 + }
947 +
948 + // Only update if needed
949 + if ($needs_update) {
950 + update_option('mxchat_options', $options);
951 + }
952 + } else {
953 + // If status doesn't exist, set default to off
954 + $options['live_agent_status'] = 'off';
955 + update_option('mxchat_options', $options);
956 + }
957 +}
958 +
959 +function mxchat_handle_live_agent_update() {
960 + // Get the CURRENT stored version (before it gets updated)
961 + $current_version = get_option('mxchat_plugin_version', '0.0.0');
962 + $new_version = '2.2.2';
963 +
964 + // Only run this once for the update to 2.2.2
965 + $update_handled = get_option('mxchat_live_agent_update_2_2_2_handled', false);
966 +
967 + // Check if we're upgrading TO 2.2.2 and haven't handled this yet
968 + if (version_compare($current_version, $new_version, '<') && !$update_handled) {
969 + $options = get_option('mxchat_options', array());
970 +
971 + // Check if live agent was previously enabled
972 + if (isset($options['live_agent_status']) && $options['live_agent_status'] === 'on') {
973 + // Disable live agent
974 + $options['live_agent_status'] = 'off';
975 + update_option('mxchat_options', $options);
976 +
977 + // Set flag to show the notification banner
978 + update_option('mxchat_show_live_agent_disabled_notice', true);
979 + }
980 +
981 + // Mark this update as handled
982 + update_option('mxchat_live_agent_update_2_2_2_handled', true);
983 + }
984 +}
985 +
986 +/**
987 + * Handle theme migration notice for version 3.0.1
988 + * Shows a dismissible notice to Pro users about migrating AI-generated themes
989 + */
990 +function mxchat_handle_theme_migration_notice() {
991 + // Get the CURRENT stored version (before it gets updated)
992 + $current_version = get_option('mxchat_plugin_version', '0.0.0');
993 + $target_version = '3.0.1';
994 +
995 + // Only run this once for the update to 3.0.1
996 + $update_handled = get_option('mxchat_theme_migration_update_3_0_1_handled', false);
997 +
998 + // Check if we're upgrading TO 3.0.1 and haven't handled this yet
999 + if (version_compare($current_version, $target_version, '<') && !$update_handled) {
1000 + // Check if Pro is activated - only show to Pro users
1001 + $license_status = get_option('mxchat_license_status', 'inactive');
1002 + $is_pro = ($license_status === 'active' || $license_status === esc_html__('active', 'mxchat'));
1003 +
1004 + if ($is_pro) {
1005 + // Set flag to show the theme migration notification banner
1006 + update_option('mxchat_show_theme_migration_notice', true);
1007 + }
1008 +
1009 + // Mark this update as handled (whether Pro or not)
1010 + update_option('mxchat_theme_migration_update_3_0_1_handled', true);
1011 + }
1012 +}
1013 +
1014 +// Initialize plugin safely
1015 +function mxchat_init() {
1016 + // Include all class files first
1017 + mxchat_include_classes();
1018 +
1019 + // Run update check (this also ensures tables exist)
1020 + mxchat_check_for_update();
1021 +
1022 + // CRITICAL: Ensure tables exist on admin pages (safety net)
1023 + add_action('admin_init', 'mxchat_ensure_tables_exist', 1);
1024 +
1025 + // Add fallback rate limit check
1026 + add_action('init', 'mxchat_check_fallback_rate_limits', 5);
1027 +
1028 + // Add migration notice hook
1029 + add_action('admin_notices', 'mxchat_show_migration_notice');
1030 +
1031 + // Initialize classes with error handling
1032 + try {
1033 + // Initialize admin classes
1034 + if (is_admin()) {
1035 + if (class_exists('MxChat_Knowledge_Manager')) {
1036 + $mxchat_knowledge_manager = new MxChat_Knowledge_Manager();
1037 +
1038 + if (class_exists('MxChat_Admin')) {
1039 + $mxchat_admin = new MxChat_Admin($mxchat_knowledge_manager);
1040 + }
1041 + }
1042 +
1043 + // Initialize meta box class
1044 + if (class_exists('MxChat_Meta_Box')) {
1045 + new MxChat_Meta_Box();
1046 + }
1047 + }
1048 +
1049 + // Initialize public classes
1050 + if (class_exists('MxChat_Public')) {
1051 + $mxchat_public = new MxChat_Public();
1052 + }
1053 +
1054 + if (class_exists('MxChat_Integrator')) {
1055 + global $mxchat_integrator;
1056 + $mxchat_integrator = new MxChat_Integrator();
1057 + }
1058 +
1059 + } catch (Exception $e) {
1060 + //error_log('MxChat initialization error: ' . $e->getMessage());
1061 +
1062 + // Show admin notice if there's an error
1063 + if (is_admin()) {
1064 + add_action('admin_notices', function() use ($e) {
1065 + echo '<div class="notice notice-error"><p>';
1066 + echo '<strong>MxChat Error:</strong> Plugin initialization failed. ';
1067 + echo 'Please check error logs or contact support. Error: ' . esc_html($e->getMessage());
1068 + echo '</p></div>';
1069 + });
1070 + }
1071 + }
1072 +}
1073 +
1074 +// Run initialization on plugins_loaded
1075 +add_action('plugins_loaded', 'mxchat_init');
1076 +
1077 +// Run migration check on admin init (for auto-updates without reactivation)
1078 +add_action('admin_init', 'mxchat_check_and_run_migrations');
1079 +
1080 +/**
1081 + * Check and run migrations on admin init
1082 + * This ensures migrations run even when plugin is auto-updated
1083 + */
1084 +function mxchat_check_and_run_migrations() {
1085 + // Only run in admin and not on every request
1086 + static $checked = false;
1087 + if ($checked) {
1088 + return;
1089 + }
1090 + $checked = true;
1091 +
1092 + mxchat_migrate_pinecone_roles_add_bot_id();
1093 + mxchat_migrate_add_content_type_column();
1094 + mxchat_migrate_add_translations_table();
1095 +}
1096 +
1097 +/**
1098 + * Migration: Create transcript translations table (v3.0.4)
1099 + * For users upgrading from versions before 3.0.4
1100 + */
1101 +function mxchat_migrate_add_translations_table() {
1102 + $migration_key = 'mxchat_translations_table_created';
1103 +
1104 + // Check if migration already ran
1105 + if (get_option($migration_key)) {
1106 + return;
1107 + }
1108 +
1109 + // Create the translations table
1110 + mxchat_create_translations_table();
1111 +
1112 + // Mark migration as complete
1113 + update_option($migration_key, '3.0.4');
1114 +}
1115 +
1116 +/**
1117 + * Migration: Update deprecated Gemini embedding model (v3.0.5)
1118 + * Updates gemini-embedding-exp-03-07 to gemini-embedding-001 for users who had it selected
1119 + */
1120 +function mxchat_migrate_gemini_embedding_model() {
1121 + $options = get_option('mxchat_options', array());
1122 +
1123 + if (isset($options['embedding_model']) && $options['embedding_model'] === 'gemini-embedding-exp-03-07') {
1124 + $options['embedding_model'] = 'gemini-embedding-001';
1125 + update_option('mxchat_options', $options);
1126 + }
1127 +}
1128 +
1129 +// Register activation hook
1130 +register_activation_hook(__FILE__, 'mxchat_activate');
1131 +
1132 +// Add cron schedule
1133 +add_filter('cron_schedules', function($schedules) {
1134 + $schedules['one_minute'] = array(
1135 + 'interval' => 60,
1136 + 'display' => 'Every Minute'
1137 + );
1138 + return $schedules;
1139 +});
1140 +
1141 +// Register deactivation hook
1142 +register_deactivation_hook(__FILE__, 'mxchat_deactivate');