| @@ -2,9 +2,9 @@ | ||
| 2 | 2 | /** |
| 3 | 3 | * Plugin Name: MxChat |
| 4 | 4 | * Plugin URI: https://mxchat.ai/ |
| 5 | 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.18 | |
| 6 | + * Version: 3.2.21 | |
| 7 | 7 | * Author: MxChat |
| 8 | 8 | * Author URI: https://mxchat.ai |
| 9 | 9 | * License: GPLv2 or later |
| 10 | 10 | * License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| @@ -38,8 +38,65 @@ | ||
| 38 | 38 | define('MXCHAT_VERSION', $version); |
| 39 | 39 | } |
| 40 | 40 | |
| 41 | 41 | /** |
| 42 | + * Default confidence floor for the in-chat YouTube card, as a percentage | |
| 43 | + * (plan-mxchat-20260813-f52492). Higher than the site-wide Similarity | |
| 44 | + * Threshold default of 35 by design — see MxChat_Utils::video_embed_threshold(). | |
| 45 | + * Declared here so the gate, the admin field and the tests all read ONE number. | |
| 46 | + */ | |
| 47 | +if (!defined('MXCHAT_VIDEO_EMBED_THRESHOLD_DEFAULT')) { | |
| 48 | + define('MXCHAT_VIDEO_EMBED_THRESHOLD_DEFAULT', 55); | |
| 49 | +} | |
| 50 | + | |
| 51 | +/** | |
| 52 | + * One-time install stamp: records the plain version this site first ran, so | |
| 53 | + * behavior defaults can differ between fresh installs and upgrades without | |
| 54 | + * touching anyone's stored settings. Mirrors mxchat-mcp's 1.0.7 stamp shape | |
| 55 | + * (plan 7b578e); first consumer is the "Strip unapproved links" default | |
| 56 | + * (plan 58f8b4). Runs at init priority 1 — BEFORE initialize_default_options | |
| 57 | + * (init 20) writes mxchat_options on a fresh site's first request, because | |
| 58 | + * that option's pre-existing presence is how an upgrade is recognized. | |
| 59 | + */ | |
| 60 | +function mxchat_stamp_install_version() { | |
| 61 | + if (get_option('mxchat_installed_at_version', '') !== '') { | |
| 62 | + return; | |
| 63 | + } | |
| 64 | + $existing = get_option('mxchat_options', false) !== false; | |
| 65 | + $version = defined('MXCHAT_BASE_VERSION') ? MXCHAT_BASE_VERSION : '0.0.0'; | |
| 66 | + update_option('mxchat_installed_at_version', $existing ? 'legacy' : $version, false); | |
| 67 | +} | |
| 68 | +add_action('init', 'mxchat_stamp_install_version', 1); | |
| 69 | + | |
| 70 | +/** | |
| 71 | + * Stamp-derived default for the "Strip unapproved links" toggle (plan 58f8b4, | |
| 72 | + * option-c split of the old Citation Links conflation): 'on' only for installs | |
| 73 | + * born at 3.2.20+. A missing or 'legacy' stamp means the site predates the | |
| 74 | + * setting — keep 'off' so no existing site's links start vanishing on update. | |
| 75 | + */ | |
| 76 | +function mxchat_strip_unapproved_links_default() { | |
| 77 | + $stamp = get_option('mxchat_installed_at_version', ''); | |
| 78 | + if ($stamp === '' || $stamp === 'legacy') { | |
| 79 | + return 'off'; | |
| 80 | + } | |
| 81 | + return version_compare($stamp, '3.2.20', '>=') ? 'on' : 'off'; | |
| 82 | +} | |
| 83 | + | |
| 84 | +/** | |
| 85 | + * Effective state of "Strip unapproved links": an explicitly saved option | |
| 86 | + * always wins; until one exists the install-stamp default governs. Read via | |
| 87 | + * a fresh get_option on purpose — the response URL guard runs late in the | |
| 88 | + * request and must see a value saved moments earlier. | |
| 89 | + */ | |
| 90 | +function mxchat_strip_unapproved_links_enabled() { | |
| 91 | + $opts = get_option('mxchat_options', array()); | |
| 92 | + if (is_array($opts) && isset($opts['strip_unapproved_links_toggle'])) { | |
| 93 | + return $opts['strip_unapproved_links_toggle'] === 'on'; | |
| 94 | + } | |
| 95 | + return mxchat_strip_unapproved_links_default() === 'on'; | |
| 96 | +} | |
| 97 | + | |
| 98 | +/** | |
| 42 | 99 | * Honest, versioned User-Agent for MXChat remote-content ingestion fetches |
| 43 | 100 | * (Knowledge Base PDF import, URL import, sitemap / website crawl). |
| 44 | 101 | * |
| 45 | 102 | * WAF rulesets (SiteGround/ModSecurity, Wordfence, Cloudflare managed rules) |
| @@ -410,8 +467,9 @@ | ||
| 410 | 467 | // Include classes with error handling |
| 411 | 468 | function mxchat_include_classes() { |
| 412 | 469 | $class_files = array( |
| 413 | 470 | 'includes/class-mxchat-model-catalog.php', |
| 471 | + 'includes/class-mxchat-model-liveness.php', | |
| 414 | 472 | 'includes/class-mxchat-session-store.php', |
| 415 | 473 | 'includes/class-mxchat-live-agent-schedule.php', |
| 416 | 474 | 'includes/class-mxchat-tool-registry.php', |
| 417 | 475 | 'includes/class-mxchat-integrator.php', |
| @@ -416,8 +474,10 @@ | ||
| 416 | 474 | 'includes/class-mxchat-tool-registry.php', |
| 417 | 475 | 'includes/class-mxchat-integrator.php', |
| 418 | 476 | 'includes/class-mxchat-admin.php', |
| 419 | 477 | 'includes/class-mxchat-public.php', |
| 478 | + 'includes/class-mxchat-block.php', | |
| 479 | + 'includes/class-mxchat-elementor.php', | |
| 420 | 480 | 'includes/class-mxchat-utils.php', |
| 421 | 481 | 'includes/class-mxchat-user.php', |
| 422 | 482 | 'includes/class-mxchat-privacy.php', |
| 423 | 483 | 'includes/class-mxchat-meta-box.php', |
| @@ -428,9 +488,10 @@ | ||
| 428 | 488 | 'includes/class-mxchat-editor-assistant.php', |
| 429 | 489 | 'includes/class-rest-api.php', |
| 430 | 490 | 'admin/class-ajax-handler.php', |
| 431 | 491 | 'admin/class-pinecone-manager.php', |
| 432 | - 'admin/class-knowledge-manager.php' | |
| 492 | + 'admin/class-knowledge-manager.php', | |
| 493 | + 'admin/class-vectorstore-manager.php' | |
| 433 | 494 | ); |
| 434 | 495 | |
| 435 | 496 | foreach ($class_files as $file) { |
| 436 | 497 | $file_path = plugin_dir_path(__FILE__) . $file; |
| @@ -456,8 +517,28 @@ | ||
| 456 | 517 | if (class_exists('MxChat_Session_Store')) { |
| 457 | 518 | MxChat_Session_Store::init(); |
| 458 | 519 | } |
| 459 | 520 | |
| 521 | + // Daily model-liveness check + its warning notice (b65e8d). Read-only and | |
| 522 | + // fail-open: one listing request per in-use provider per day, none at all | |
| 523 | + // when no key is stored. | |
| 524 | + if (class_exists('MxChat_Model_Liveness')) { | |
| 525 | + MxChat_Model_Liveness::init(); | |
| 526 | + } | |
| 527 | + | |
| 528 | + // Gutenberg chatbot block (plan-95dd1e): a click-to-place wrapper over the | |
| 529 | + // [mxchat_chatbot] shortcode. Registers on init; no-op below WP 5.0. | |
| 530 | + if (class_exists('MxChat_Block')) { | |
| 531 | + MxChat_Block::init(); | |
| 532 | + } | |
| 533 | + | |
| 534 | + // Elementor chatbot widget (plan-95dd1e part 2): registered ONLY inside | |
| 535 | + // elementor/widgets/register (Elementor >= 3.5) — with Elementor absent or | |
| 536 | + // older, the hook never fires and nothing further loads. | |
| 537 | + if (class_exists('MxChat_Elementor')) { | |
| 538 | + MxChat_Elementor::init(); | |
| 539 | + } | |
| 540 | + | |
| 460 | 541 | // Editor Assistant — free, OFF-by-default block-editor AI actions (plan-8cb0cb). |
| 461 | 542 | // init() wires REST + streaming AJAX + sidebar enqueue ONLY when the |
| 462 | 543 | // mxchat_editor_assistant_enabled option is 'on'; otherwise zero footprint. |
| 463 | 544 | if (class_exists('MxChat_Editor_Assistant')) { |
| @@ -463,8 +544,16 @@ | ||
| 463 | 544 | if (class_exists('MxChat_Editor_Assistant')) { |
| 464 | 545 | MxChat_Editor_Assistant::init(); |
| 465 | 546 | } |
| 466 | 547 | |
| 548 | + // OpenAI Vector Store write path (plan-15b5c6): import/sync AJAX, the | |
| 549 | + // import cron tick, the pending-delete sweeper, and the WP-CLI command | |
| 550 | + // all register in the constructor. The sync itself only runs when the | |
| 551 | + // sync toggle + store ID + OpenAI key are all present. | |
| 552 | + if (class_exists('MxChat_Vectorstore_Manager')) { | |
| 553 | + MxChat_Vectorstore_Manager::get_instance(); | |
| 554 | + } | |
| 555 | + | |
| 467 | 556 | // Admin pages that aren't classes (procedural include). |
| 468 | 557 | if (is_admin()) { |
| 469 | 558 | $admin_api_page = plugin_dir_path(__FILE__) . 'includes/admin-api-page.php'; |
| 470 | 559 | if (file_exists($admin_api_page)) { |
| @@ -856,8 +945,66 @@ | ||
| 856 | 945 | } |
| 857 | 946 | } |
| 858 | 947 | |
| 859 | 948 | /** |
| 949 | + * 3.2.20: One-time backfill of the caee10 catalog usage-hint defaults | |
| 950 | + * (plan 64c1ad). persist() writes usage_hint for EVERY shown tool on every | |
| 951 | + * autosave — as '' when the box is untouched — and resolve_tool_setting() | |
| 952 | + * seeds a catalog default_hint ONLY onto an ABSENT key. So any install that | |
| 953 | + * saved the AI Tools screen before 3.2.20 holds '' everywhere and the shipped | |
| 954 | + * defaults can never reach it. On an upgrade from < 3.2.20 an empty stored | |
| 955 | + * hint cannot be a deliberate clear of a rendered default (those builds never | |
| 956 | + * rendered one), so seeding is safe. From 3.2.20 on, empty means the owner | |
| 957 | + * cleared a visible default and is respected — this never runs again (version | |
| 958 | + * gate + its own marker, deliberately not caee10's flag). | |
| 959 | + * | |
| 960 | + * Never touched: entries with owner text, legacy bare-bool entries and | |
| 961 | + * absent-key entries (both already resolve to the default at read time), and | |
| 962 | + * tools whose catalog entry ships no default_hint. | |
| 963 | + */ | |
| 964 | +function mxchat_backfill_tool_hint_defaults() { | |
| 965 | + if (get_option('mxchat_tool_hint_backfill_64c1ad') === '1') { | |
| 966 | + return; | |
| 967 | + } | |
| 968 | + | |
| 969 | + if (class_exists('MxChat_Tool_Registry')) { | |
| 970 | + $map = get_option('mxchat_function_calling_tools', array()); | |
| 971 | + if (is_array($map) && !empty($map)) { | |
| 972 | + $defaults = array(); | |
| 973 | + foreach (MxChat_Tool_Registry::core_tool_catalog() as $fn => $meta) { | |
| 974 | + if (!empty($meta['default_hint'])) { | |
| 975 | + $defaults[$fn] = (string) $meta['default_hint']; | |
| 976 | + } | |
| 977 | + } | |
| 978 | + | |
| 979 | + $changed = false; | |
| 980 | + foreach ($map as $fn => $entry) { | |
| 981 | + if (!isset($defaults[$fn])) { | |
| 982 | + continue; // no catalog default — nothing to seed | |
| 983 | + } | |
| 984 | + if (!is_array($entry)) { | |
| 985 | + continue; // legacy bare bool: key absent, resolves to the default already | |
| 986 | + } | |
| 987 | + if (!array_key_exists('usage_hint', $entry)) { | |
| 988 | + continue; // absent key gets the default at read time — must stay absent | |
| 989 | + } | |
| 990 | + if (trim((string) $entry['usage_hint']) !== '') { | |
| 991 | + continue; // owner text — never touch | |
| 992 | + } | |
| 993 | + $map[$fn]['usage_hint'] = $defaults[$fn]; | |
| 994 | + $changed = true; | |
| 995 | + } | |
| 996 | + | |
| 997 | + if ($changed) { | |
| 998 | + update_option('mxchat_function_calling_tools', $map); | |
| 999 | + } | |
| 1000 | + } | |
| 1001 | + } | |
| 1002 | + | |
| 1003 | + update_option('mxchat_tool_hint_backfill_64c1ad', '1', false); | |
| 1004 | +} | |
| 1005 | + | |
| 1006 | +/** | |
| 860 | 1007 | * 2.5.2: Create queue processing tables for reliable background processing |
| 861 | 1008 | */ |
| 862 | 1009 | function mxchat_create_queue_tables() { |
| 863 | 1010 | global $wpdb; |
| @@ -955,8 +1102,41 @@ | ||
| 955 | 1102 | dbDelta($sql); |
| 956 | 1103 | } |
| 957 | 1104 | |
| 958 | 1105 | /** |
| 1106 | + * Create the OpenAI Vector Store file-mapping table (v3.2.20, plan 15b5c6). | |
| 1107 | + * One row per mirrored KB entry: which store, which bot, which OpenAI file id, | |
| 1108 | + * and a hash of the uploaded body for change detection. Vector store files are | |
| 1109 | + * not patchable in place — without this mapping an update cannot find its | |
| 1110 | + * predecessor, and the store silently accumulates stale duplicates. | |
| 1111 | + * status: 'live' (serving) or 'pending_delete' (condemned, swept later). | |
| 1112 | + */ | |
| 1113 | +function mxchat_create_vectorstore_files_table() { | |
| 1114 | + global $wpdb; | |
| 1115 | + $charset_collate = $wpdb->get_charset_collate(); | |
| 1116 | + | |
| 1117 | + $table_name = $wpdb->prefix . 'mxchat_vectorstore_files'; | |
| 1118 | + $sql = "CREATE TABLE $table_name ( | |
| 1119 | + id bigint(20) unsigned NOT NULL AUTO_INCREMENT, | |
| 1120 | + store_id varchar(64) NOT NULL, | |
| 1121 | + bot_id varchar(64) NOT NULL DEFAULT 'default', | |
| 1122 | + entry_key char(32) NOT NULL, | |
| 1123 | + source_url text, | |
| 1124 | + file_id varchar(64) NOT NULL, | |
| 1125 | + content_hash char(32) NOT NULL DEFAULT '', | |
| 1126 | + status varchar(20) NOT NULL DEFAULT 'live', | |
| 1127 | + last_error text, | |
| 1128 | + updated_at datetime DEFAULT NULL, | |
| 1129 | + PRIMARY KEY (id), | |
| 1130 | + KEY store_entry (store_id, bot_id, entry_key, status), | |
| 1131 | + KEY status (status) | |
| 1132 | + ) $charset_collate;"; | |
| 1133 | + | |
| 1134 | + require_once(ABSPATH . 'wp-admin/includes/upgrade.php'); | |
| 1135 | + dbDelta($sql); | |
| 1136 | +} | |
| 1137 | + | |
| 1138 | +/** | |
| 959 | 1139 | * 2.5.2: Fix URL column size to support long URLs (especially with UTF-8 encoding) |
| 960 | 1140 | * This fixes "url, source_url. The supplied values may be too long" errors |
| 961 | 1141 | */ |
| 962 | 1142 | function mxchat_fix_url_column_size() { |
| @@ -1000,93 +1180,47 @@ | ||
| 1000 | 1180 | if (!isset($options['model'])) { |
| 1001 | 1181 | return; |
| 1002 | 1182 | } |
| 1003 | 1183 | |
| 1004 | - $current_model = $options['model']; | |
| 1005 | - | |
| 1006 | - // Migrate deprecated Claude models to Claude Opus 4.6 (recommended replacement per Anthropic) | |
| 1007 | - $deprecated_claude_models = array( | |
| 1008 | - 'claude-3-5-sonnet-20240620', // Retired Oct 28, 2025 | |
| 1009 | - 'claude-3-5-sonnet-20241022', // Retired Oct 28, 2025 | |
| 1010 | - 'claude-3-7-sonnet-20250219', // Retiring Feb 19, 2026 | |
| 1011 | - 'claude-3-opus-20240229', // Retired Jan 5, 2026 | |
| 1012 | - 'claude-3-sonnet-20240229', // Legacy | |
| 1013 | - 'claude-3-haiku-20240307', // Legacy | |
| 1014 | - ); | |
| 1015 | - if (in_array($current_model, $deprecated_claude_models, true)) { | |
| 1016 | - $options['model'] = 'claude-opus-4-6'; | |
| 1017 | - $migrated = true; | |
| 1018 | - $migration_message = sprintf( | |
| 1019 | - 'Your chatbot model has been automatically updated from %s to Claude Opus 4.6 due to Anthropic deprecating older Claude models.', | |
| 1020 | - $current_model | |
| 1021 | - ); | |
| 1184 | + // The retired-id → replacement mapping lives in ONE place: | |
| 1185 | + // MxChat_Model_Catalog::retired_model_map() (plan 202df5). This function | |
| 1186 | + // and every add-on that stores model ids consume that map — do not add a | |
| 1187 | + // deprecation list here again. | |
| 1188 | + if (!class_exists('MxChat_Model_Catalog') || !method_exists('MxChat_Model_Catalog', 'retired_model_map')) { | |
| 1189 | + return; // catalog not loaded (defensive) — the next admin load retries | |
| 1022 | 1190 | } |
| 1191 | + $map = MxChat_Model_Catalog::retired_model_map(); | |
| 1023 | 1192 | |
| 1024 | - // Migrate deprecated Claude Haiku 3.5 to Claude Haiku 4.5 | |
| 1025 | - if ($current_model === 'claude-3-5-haiku-20241022') { | |
| 1026 | - $options['model'] = 'claude-haiku-4-5-20251001'; | |
| 1193 | + $current_model = $options['model']; | |
| 1194 | + if (isset($map[$current_model])) { | |
| 1195 | + $entry = $map[$current_model]; | |
| 1196 | + $options['model'] = $entry['to']; | |
| 1027 | 1197 | $migrated = true; |
| 1028 | - $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.'; | |
| 1029 | - } | |
| 1030 | - | |
| 1031 | - // Migrate deprecated GPT-4 series and GPT-3.5 Turbo to GPT-5.6 Sol. | |
| 1032 | - // (Previous target gpt-5.1-chat-latest itself retires 2026-08-10 — never | |
| 1033 | - // migrate onto a model that is already on a deprecation list.) | |
| 1034 | - if (in_array($current_model, array('gpt-4o', 'gpt-4.1-2025-04-14', 'gpt-4-turbo', 'gpt-4', 'gpt-3.5-turbo'), true)) { | |
| 1035 | - $options['model'] = 'gpt-5.6-sol'; | |
| 1036 | - $migrated = true; | |
| 1037 | 1198 | $migration_message = sprintf( |
| 1038 | - 'Your chatbot model has been automatically updated from %s to GPT-5.6 Sol due to OpenAI deprecating older models.', | |
| 1039 | - $current_model | |
| 1199 | + 'Your chatbot model has been automatically updated from %s to %s %s.', | |
| 1200 | + $current_model, | |
| 1201 | + $entry['label'], | |
| 1202 | + $entry['reason'] | |
| 1040 | 1203 | ); |
| 1041 | 1204 | } |
| 1042 | 1205 | |
| 1043 | - // Migrate the gpt-5.x-chat-latest aliases OpenAI retires on August 10, 2026. | |
| 1044 | - // Replacement per OpenAI's deprecations page: gpt-5.6-sol (plan e46b8f). | |
| 1045 | - if (in_array($current_model, array('gpt-5.1-chat-latest', 'gpt-5.3-chat-latest'), true)) { | |
| 1046 | - $options['model'] = 'gpt-5.6-sol'; | |
| 1047 | - $migrated = true; | |
| 1048 | - $migration_message = sprintf( | |
| 1049 | - '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.', | |
| 1050 | - $current_model | |
| 1051 | - ); | |
| 1052 | - } | |
| 1053 | - | |
| 1054 | - // The content generator has its own model option — same retirement applies. | |
| 1055 | - if (isset($options['content_model']) | |
| 1056 | - && in_array($options['content_model'], array('gpt-5.1-chat-latest', 'gpt-5.3-chat-latest'), true)) { | |
| 1206 | + // The content generator has its own model option — the same map applies. | |
| 1207 | + // (Pre-202df5 this branch covered only the two gpt-5.x-chat-latest aliases; | |
| 1208 | + // it now covers every retired id, so e.g. a content model stranded on a | |
| 1209 | + // retired Claude id is rescued the same way the chat model is.) | |
| 1210 | + if (isset($options['content_model']) && isset($map[$options['content_model']])) { | |
| 1057 | 1211 | $old_content_model = $options['content_model']; |
| 1058 | - $options['content_model'] = 'gpt-5.6-sol'; | |
| 1212 | + $entry = $map[$old_content_model]; | |
| 1213 | + $options['content_model'] = $entry['to']; | |
| 1059 | 1214 | $migrated = true; |
| 1060 | 1215 | $migration_message = trim($migration_message . ' ' . sprintf( |
| 1061 | - 'Your content generation model has also been updated from %s to GPT-5.6 Sol for the same OpenAI retirement.', | |
| 1062 | - $old_content_model | |
| 1216 | + 'Your content generation model has also been automatically updated from %s to %s %s.', | |
| 1217 | + $old_content_model, | |
| 1218 | + $entry['label'], | |
| 1219 | + $entry['reason'] | |
| 1063 | 1220 | )); |
| 1064 | 1221 | } |
| 1065 | 1222 | |
| 1066 | - // Migrate deprecated GPT-4o Mini and GPT-4.1 Mini to GPT-5 Mini | |
| 1067 | - if (in_array($current_model, array('gpt-4o-mini', 'gpt-4.1-mini'), true)) { | |
| 1068 | - $options['model'] = 'gpt-5-mini'; | |
| 1069 | - $migrated = true; | |
| 1070 | - $migration_message = sprintf( | |
| 1071 | - 'Your chatbot model has been automatically updated from %s to GPT-5 Mini due to OpenAI deprecating GPT-4 series models.', | |
| 1072 | - $current_model | |
| 1073 | - ); | |
| 1074 | - } | |
| 1075 | - | |
| 1076 | - // Migrate retired DeepSeek ids to DeepSeek V4 Flash — the vendor removed | |
| 1077 | - // deepseek-chat and deepseek-reasoner on 2026-07-24 (hard cutoff, every | |
| 1078 | - // request 400s). V4 Flash is DeepSeek's designated successor for the | |
| 1079 | - // legacy deepseek-chat alias. | |
| 1080 | - if (in_array($current_model, array('deepseek-chat', 'deepseek-reasoner'), true)) { | |
| 1081 | - $options['model'] = 'deepseek-v4-flash'; | |
| 1082 | - $migrated = true; | |
| 1083 | - $migration_message = sprintf( | |
| 1084 | - 'Your chatbot model has been automatically updated from %s to DeepSeek V4 Flash because DeepSeek retired its older API models on July 24, 2026.', | |
| 1085 | - $current_model | |
| 1086 | - ); | |
| 1087 | - } | |
| 1088 | - | |
| 1089 | 1223 | if ($migrated) { |
| 1090 | 1224 | update_option('mxchat_options', $options); |
| 1091 | 1225 | update_option('mxchat_model_migrated_notice', true); |
| 1092 | 1226 | update_option('mxchat_model_migration_message', $migration_message); |
| @@ -1112,8 +1246,62 @@ | ||
| 1112 | 1246 | } |
| 1113 | 1247 | } |
| 1114 | 1248 | |
| 1115 | 1249 | /** |
| 1250 | + * One-time recommendation on EXISTING installs (stamp 'legacy') that the new | |
| 1251 | + * "Strip unapproved links" guard exists and is worth turning on (plan 58f8b4). | |
| 1252 | + * Fresh 3.2.20+ installs default it on and never see this. Shown only on | |
| 1253 | + * MxChat admin pages, gone for good once dismissed or once the site saves an | |
| 1254 | + * explicit value for the toggle either way. | |
| 1255 | + */ | |
| 1256 | +function mxchat_show_strip_links_notice() { | |
| 1257 | + if (!current_user_can('manage_options')) { | |
| 1258 | + return; | |
| 1259 | + } | |
| 1260 | + $page = isset($_GET['page']) ? sanitize_key($_GET['page']) : ''; | |
| 1261 | + if (strpos($page, 'mxchat') !== 0) { | |
| 1262 | + return; | |
| 1263 | + } | |
| 1264 | + if (get_option('mxchat_strip_links_notice_dismissed', '') === '1') { | |
| 1265 | + return; | |
| 1266 | + } | |
| 1267 | + if (get_option('mxchat_installed_at_version', '') !== 'legacy') { | |
| 1268 | + return; | |
| 1269 | + } | |
| 1270 | + $opts = get_option('mxchat_options', array()); | |
| 1271 | + if (is_array($opts) && isset($opts['strip_unapproved_links_toggle'])) { | |
| 1272 | + return; // The site already made its choice — stop recommending. | |
| 1273 | + } | |
| 1274 | + $dismiss_url = wp_nonce_url( | |
| 1275 | + admin_url('admin-post.php?action=mxchat_dismiss_strip_links_notice'), | |
| 1276 | + 'mxchat_dismiss_strip_links_notice' | |
| 1277 | + ); | |
| 1278 | + ?> | |
| 1279 | + <div class="notice notice-info"> | |
| 1280 | + <p> | |
| 1281 | + <strong><?php esc_html_e('MxChat: new link protection available', 'mxchat'); ?></strong><br> | |
| 1282 | + <?php esc_html_e('The new "Strip Unapproved Links" setting removes links the AI invents from its answers even when Citation Links is off — links to real pages on your site and links your integrations return are always kept. It is off on existing sites so nothing changes without you; we recommend turning it on under MxChat → Settings → Chatbot Behavior.', 'mxchat'); ?> | |
| 1283 | + <a href="<?php echo esc_url($dismiss_url); ?>"><?php esc_html_e('Dismiss', 'mxchat'); ?></a> | |
| 1284 | + </p> | |
| 1285 | + </div> | |
| 1286 | + <?php | |
| 1287 | +} | |
| 1288 | +add_action('admin_notices', 'mxchat_show_strip_links_notice'); | |
| 1289 | + | |
| 1290 | +/** Dismiss handler for the strip-links recommendation notice (plan 58f8b4). */ | |
| 1291 | +function mxchat_dismiss_strip_links_notice() { | |
| 1292 | + if (!current_user_can('manage_options')) { | |
| 1293 | + wp_die(esc_html__('Insufficient permissions.', 'mxchat'), '', array('response' => 403)); | |
| 1294 | + } | |
| 1295 | + check_admin_referer('mxchat_dismiss_strip_links_notice'); | |
| 1296 | + update_option('mxchat_strip_links_notice_dismissed', '1', false); | |
| 1297 | + $referer = wp_get_referer(); | |
| 1298 | + wp_safe_redirect($referer ? $referer : admin_url('admin.php?page=mxchat-max')); | |
| 1299 | + exit; | |
| 1300 | +} | |
| 1301 | +add_action('admin_post_mxchat_dismiss_strip_links_notice', 'mxchat_dismiss_strip_links_notice'); | |
| 1302 | + | |
| 1303 | +/** | |
| 1116 | 1304 | * Persistent admin notice when the provider rejected the configured model |
| 1117 | 1305 | * (model_not_found / no access). Set by mxchat_friendly_chat_error() in the |
| 1118 | 1306 | * integrator whenever a chat request fails on a model-access error — including |
| 1119 | 1307 | * requests from anonymous visitors, which is the case that otherwise stays |
| @@ -1225,8 +1413,11 @@ | ||
| 1225 | 1413 | |
| 1226 | 1414 | // Create per-session satisfaction ratings table (v3.2.6) |
| 1227 | 1415 | mxchat_create_session_ratings_table(); |
| 1228 | 1416 | |
| 1417 | + // Create Vector Store file-mapping table (v3.2.20, plan 15b5c6) | |
| 1418 | + mxchat_create_vectorstore_files_table(); | |
| 1419 | + | |
| 1229 | 1420 | // Ensure additional columns in system prompt table |
| 1230 | 1421 | $existing_system_columns = $wpdb->get_results("SHOW COLUMNS FROM $system_prompt_table"); |
| 1231 | 1422 | if (!empty($existing_system_columns)) { |
| 1232 | 1423 | $existing_system_column_names = array_column($existing_system_columns, 'Field'); |
| @@ -1338,8 +1529,9 @@ | ||
| 1338 | 1529 | // Clear scheduled cron jobs |
| 1339 | 1530 | wp_clear_scheduled_hook('mxchat_reset_rate_limits'); |
| 1340 | 1531 | wp_clear_scheduled_hook('mxchat_cleanup_old_transcripts'); |
| 1341 | 1532 | wp_clear_scheduled_hook('mxchat_send_delayed_transcript'); |
| 1533 | + wp_clear_scheduled_hook('mxchat_model_liveness_check'); | |
| 1342 | 1534 | |
| 1343 | 1535 | // Clear fallback options |
| 1344 | 1536 | delete_option('mxchat_use_fallback_rate_limits'); |
| 1345 | 1537 | delete_option('mxchat_next_rate_limit_check'); |
| @@ -1498,8 +1690,31 @@ | ||
| 1498 | 1690 | mxchat_fix_credential_option_autoload(); |
| 1499 | 1691 | mxchat_migrate_acf_pdf_extraction_option(); |
| 1500 | 1692 | } |
| 1501 | 1693 | |
| 1694 | + // 3.2.19: Claude Opus 4.1 retired Aug 5, 2026 — auto-move stranded | |
| 1695 | + // sites (and the older tiers on the migration's lists) per the | |
| 1696 | + // changelog's promise. Idempotent — only rewrites models on the | |
| 1697 | + // deprecation lists. Without a gate at this release's version, | |
| 1698 | + // nothing calls the migration for 3.2.18 upgraders (plan a5a598; | |
| 1699 | + // the gate value must equal the version this block ships in). | |
| 1700 | + if (version_compare($current_version, '3.2.19', '<')) { | |
| 1701 | + mxchat_migrate_deprecated_models(); | |
| 1702 | + } | |
| 1703 | + | |
| 1704 | + // 3.2.20: Seed the caee10 usage-hint defaults onto tool entries a | |
| 1705 | + // pre-3.2.20 autosave stamped with '' (plan 64c1ad). The gate value | |
| 1706 | + // equals the version this block ships in (a5a598 rule); the | |
| 1707 | + // function carries its own one-time marker on top. | |
| 1708 | + // Also re-run the deprecated-models migration: 202df5 widened it to | |
| 1709 | + // rescue a content_model stranded on ANY retired id (previously | |
| 1710 | + // only the two gpt-5.x-chat-latest aliases). Idempotent — only | |
| 1711 | + // rewrites models on the catalog's retired_model_map(). | |
| 1712 | + if (version_compare($current_version, '3.2.20', '<')) { | |
| 1713 | + mxchat_backfill_tool_hint_defaults(); | |
| 1714 | + mxchat_migrate_deprecated_models(); | |
| 1715 | + } | |
| 1716 | + | |
| 1502 | 1717 | // Run full activation to ensure everything is up to date |
| 1503 | 1718 | mxchat_activate(); |
| 1504 | 1719 | |
| 1505 | 1720 | // Run migration functions |
| @@ -1504,12 +1719,11 @@ | ||
| 1504 | 1719 | |
| 1505 | 1720 | // Run migration functions |
| 1506 | 1721 | mxchat_migrate_live_agent_status(); |
| 1507 | 1722 | |
| 1508 | - // Add the cleanup function for version 2.1.8 | |
| 1509 | - if (version_compare($current_version, '2.1.8', '<')) { | |
| 1510 | - $deleted = mxchat_cleanup_orphaned_chat_history(); | |
| 1511 | - } | |
| 1723 | + // (The 2.1.8 orphaned-history reconciliation sweep is gone — | |
| 1724 | + // 3.2.19's mxchat_history_backlog_* drain supersedes it, and it | |
| 1725 | + // self-arms without a version gate: plan 839c4c.) | |
| 1512 | 1726 | |
| 1513 | 1727 | // Update version LAST |
| 1514 | 1728 | update_option('mxchat_plugin_version', $plugin_version); |
| 1515 | 1729 | |
| @@ -1581,8 +1795,111 @@ | ||
| 1581 | 1795 | } |
| 1582 | 1796 | } |
| 1583 | 1797 | |
| 1584 | 1798 | /** |
| 1799 | + * One-time migration of mxchat_acf_excluded_fields from field NAMES to field | |
| 1800 | + * KEYS (plan 30e81f). Names are not unique across ACF groups, so two fields | |
| 1801 | + * named the same in different groups shared one toggle, one saved state, and | |
| 1802 | + * one exclusion — and the save-on-exit beacon could revert a save through the | |
| 1803 | + * twin. Keys are unique; everything now runs on them. | |
| 1804 | + * | |
| 1805 | + * MIGRATION DIRECTION IS DELIBERATE: one stored name can match several keys — | |
| 1806 | + * exclude EVERY one of them. The UI describes these as "sensitive or | |
| 1807 | + * irrelevant fields"; an under-migration would silently start feeding a | |
| 1808 | + * previously-excluded sensitive field into embeddings sent to a third-party | |
| 1809 | + * provider. Over-excluding is visible in the UI and costs some retrieval | |
| 1810 | + * quality; under-excluding is a silent privacy regression. | |
| 1811 | + * | |
| 1812 | + * Self-arming on acf/init (NOT the version-gated upgrade block): resolving | |
| 1813 | + * names needs ACF fully booted with local JSON/PHP groups registered, and if | |
| 1814 | + * ACF is deactivated at upgrade time the migration simply waits for the next | |
| 1815 | + * load with ACF active. Until it runs, stored names keep working — every | |
| 1816 | + * exclusion read site honors legacy name entries alongside keys. A name that | |
| 1817 | + * matches no current key is KEPT (its group may be temporarily inactive), and | |
| 1818 | + * the per-field include path lazily converts it if it ever resolves again. | |
| 1819 | + */ | |
| 1820 | +function mxchat_migrate_acf_exclusions_to_keys() { | |
| 1821 | + if (get_option('mxchat_acf_exclusions_migrated', '') === '1') { | |
| 1822 | + return; | |
| 1823 | + } | |
| 1824 | + $stored = get_option('mxchat_acf_excluded_fields', array()); | |
| 1825 | + if (!is_array($stored) || empty($stored)) { | |
| 1826 | + update_option('mxchat_acf_exclusions_migrated', '1', false); | |
| 1827 | + return; | |
| 1828 | + } | |
| 1829 | + if (!function_exists('acf_get_field_groups') || !function_exists('acf_get_fields')) { | |
| 1830 | + return; // acf/init fired without the API? Bail; retry next load. | |
| 1831 | + } | |
| 1832 | + | |
| 1833 | + // Map every current top-level field: name => [keys], and the set of keys. | |
| 1834 | + $name_to_keys = array(); | |
| 1835 | + $current_keys = array(); | |
| 1836 | + foreach (acf_get_field_groups() as $group) { | |
| 1837 | + $group_fields = acf_get_fields($group['key']); | |
| 1838 | + if (empty($group_fields)) { | |
| 1839 | + continue; | |
| 1840 | + } | |
| 1841 | + foreach ($group_fields as $field) { | |
| 1842 | + if (empty($field['key']) || !isset($field['name'])) { | |
| 1843 | + continue; | |
| 1844 | + } | |
| 1845 | + $current_keys[$field['key']] = true; | |
| 1846 | + $name_to_keys[$field['name']][] = $field['key']; | |
| 1847 | + } | |
| 1848 | + } | |
| 1849 | + | |
| 1850 | + $migrated = array(); | |
| 1851 | + $converted = 0; | |
| 1852 | + foreach ($stored as $entry) { | |
| 1853 | + if (!is_string($entry) || $entry === '') { | |
| 1854 | + continue; | |
| 1855 | + } | |
| 1856 | + if (isset($current_keys[$entry])) { | |
| 1857 | + $migrated[] = $entry; // already a live key | |
| 1858 | + } elseif (isset($name_to_keys[$entry])) { | |
| 1859 | + foreach ($name_to_keys[$entry] as $key) { | |
| 1860 | + $migrated[] = $key; // every key wearing this name — fail toward more exclusion | |
| 1861 | + } | |
| 1862 | + $converted++; | |
| 1863 | + } else { | |
| 1864 | + $migrated[] = $entry; // unresolved — keep; still honored by name everywhere | |
| 1865 | + } | |
| 1866 | + } | |
| 1867 | + $migrated = array_values(array_unique($migrated)); | |
| 1868 | + | |
| 1869 | + update_option('mxchat_acf_excluded_fields', $migrated); | |
| 1870 | + update_option('mxchat_acf_exclusions_migrated', '1', false); | |
| 1871 | + if ($converted > 0) { | |
| 1872 | + update_option('mxchat_acf_exclusions_migrated_notice', '1', false); | |
| 1873 | + } | |
| 1874 | +} | |
| 1875 | +add_action('acf/init', 'mxchat_migrate_acf_exclusions_to_keys', 20); | |
| 1876 | + | |
| 1877 | +/** | |
| 1878 | + * One-time notice after the ACF exclusion migration actually converted | |
| 1879 | + * name entries — the settings are worth a review, especially where one name | |
| 1880 | + * fanned out to several fields (every match is now excluded, on purpose). | |
| 1881 | + */ | |
| 1882 | +function mxchat_show_acf_exclusions_migrated_notice() { | |
| 1883 | + if (!current_user_can('manage_options')) { | |
| 1884 | + return; | |
| 1885 | + } | |
| 1886 | + if (get_option('mxchat_acf_exclusions_migrated_notice', '') !== '1') { | |
| 1887 | + return; | |
| 1888 | + } | |
| 1889 | + ?> | |
| 1890 | + <div class="notice notice-info is-dismissible"> | |
| 1891 | + <p> | |
| 1892 | + <strong><?php esc_html_e('MxChat: ACF field exclusions updated', 'mxchat'); ?></strong><br> | |
| 1893 | + <?php esc_html_e('Your ACF field exclusion settings were migrated to identify fields precisely, so same-named fields in different groups no longer share one toggle. Where a saved exclusion matched several fields, all of them are now excluded — please review the toggles under MxChat → Knowledge → ACF Field Settings.', 'mxchat'); ?> | |
| 1894 | + </p> | |
| 1895 | + </div> | |
| 1896 | + <?php | |
| 1897 | + delete_option('mxchat_acf_exclusions_migrated_notice'); | |
| 1898 | +} | |
| 1899 | +add_action('admin_notices', 'mxchat_show_acf_exclusions_migrated_notice'); | |
| 1900 | + | |
| 1901 | +/** | |
| 1585 | 1902 | * Ensure tables exist on every admin load for fresh installations |
| 1586 | 1903 | * This is a safety net for cases where activation hook doesn't fire |
| 1587 | 1904 | */ |
| 1588 | 1905 | function mxchat_ensure_tables_exist() { |
| @@ -1606,9 +1923,9 @@ | ||
| 1606 | 1923 | $sessions_table = $wpdb->prefix . 'mxchat_sessions'; |
| 1607 | 1924 | |
| 1608 | 1925 | $chat_exists = $wpdb->get_var("SHOW TABLES LIKE '$table_name'") === $table_name; |
| 1609 | 1926 | $queue_exists = $wpdb->get_var("SHOW TABLES LIKE '$queue_table'") === $queue_table; |
| 1610 | - $sessions_exists = get_option('mxchat_session_store_ready') === '1' | |
| 1927 | + $sessions_exists = get_option('mxchat_session_store_ready') !== false | |
| 1611 | 1928 | || $wpdb->get_var("SHOW TABLES LIKE '$sessions_table'") === $sessions_table; |
| 1612 | 1929 | |
| 1613 | 1930 | if (!$chat_exists || !$queue_exists || !$sessions_exists) { |
| 1614 | 1931 | //error_log("MxChat: Tables missing on admin load, running activation"); |
| @@ -1616,49 +1933,116 @@ | ||
| 1616 | 1933 | } |
| 1617 | 1934 | } |
| 1618 | 1935 | |
| 1619 | 1936 | /** |
| 1620 | - * Clean up orphaned chat history options from the wp_options table | |
| 1621 | - * @return int Number of options deleted | |
| 1937 | + * One-shot cleanup of legacy mxchat_history_<sid> option rows (plan 839c4c). | |
| 1938 | + * | |
| 1939 | + * 3.2.19 deduplicated per-session chat history into the transcripts table | |
| 1940 | + * (which already held a superset of every option copy measured), so nothing | |
| 1941 | + * writes these options any more — but an upgraded install still carries one | |
| 1942 | + * per session, at up to 64 KB a row (462 rows measured on one production | |
| 1943 | + * install). This drain replaces the old mxchat_cleanup_orphaned_chat_history() | |
| 1944 | + * reconciliation sweep, which existed only because there were two copies to | |
| 1945 | + * reconcile. | |
| 1946 | + * | |
| 1947 | + * b64b77 pattern throughout: an option_id bookmark that only moves forward | |
| 1948 | + * (a crash mid-batch re-processes at most one batch), delete_option() per row | |
| 1949 | + * so the object + notoptions caches stay coherent, batches drained off | |
| 1950 | + * non-AJAX admin_init plus the session-store maintenance cron. Once the | |
| 1951 | + * backlog is gone the state marks done and every later call is one cached | |
| 1952 | + * option read. | |
| 1622 | 1953 | */ |
| 1623 | -function mxchat_cleanup_orphaned_chat_history() { | |
| 1954 | +function mxchat_history_backlog_state() { | |
| 1955 | + // The state option name MUST NOT start with 'mxchat_history_' — the drain | |
| 1956 | + // deletes everything matching that prefix, and a state option inside the | |
| 1957 | + // pattern gets eaten by its own drain (caught by the 839c4c rig: batches | |
| 1958 | + // ran 2,2,2,1 instead of 2,2,1 because the bookmark row was being deleted | |
| 1959 | + // and re-created every pass). | |
| 1960 | + $state = get_option('mxchat_legacy_history_cleanup', array()); | |
| 1961 | + if (!is_array($state)) { | |
| 1962 | + $state = array(); | |
| 1963 | + } | |
| 1964 | + | |
| 1965 | + return wp_parse_args($state, array( | |
| 1966 | + 'done' => false, | |
| 1967 | + 'last_option_id' => 0, | |
| 1968 | + 'deleted' => 0, | |
| 1969 | + )); | |
| 1970 | +} | |
| 1971 | + | |
| 1972 | +/** | |
| 1973 | + * Delete one batch of legacy history options. | |
| 1974 | + * | |
| 1975 | + * @param int $batch Rows per pass — capped small; these can be 64 KB rows. | |
| 1976 | + * @return int Option rows deleted in this pass. | |
| 1977 | + */ | |
| 1978 | +function mxchat_history_backlog_batch($batch = 200) { | |
| 1624 | 1979 | global $wpdb; |
| 1625 | - $count = 0; | |
| 1626 | 1980 | |
| 1627 | - // Get all option keys that match our pattern | |
| 1628 | - $history_options = $wpdb->get_results( | |
| 1629 | - "SELECT option_name FROM {$wpdb->options} | |
| 1630 | - WHERE option_name LIKE 'mxchat_history_%'" | |
| 1981 | + $state = mxchat_history_backlog_state(); | |
| 1982 | + if (!empty($state['done'])) { | |
| 1983 | + return 0; | |
| 1984 | + } | |
| 1985 | + | |
| 1986 | + $batch = max(1, (int) $batch); | |
| 1987 | + | |
| 1988 | + $rows = $wpdb->get_results( | |
| 1989 | + $wpdb->prepare( | |
| 1990 | + "SELECT option_id, option_name FROM {$wpdb->options} | |
| 1991 | + WHERE option_id > %d AND option_name LIKE %s | |
| 1992 | + ORDER BY option_id ASC LIMIT %d", | |
| 1993 | + (int) $state['last_option_id'], | |
| 1994 | + $wpdb->esc_like('mxchat_history_') . '%', | |
| 1995 | + $batch | |
| 1996 | + ), | |
| 1997 | + ARRAY_A | |
| 1631 | 1998 | ); |
| 1632 | 1999 | |
| 1633 | - if (!empty($history_options)) { | |
| 1634 | - foreach ($history_options as $option) { | |
| 1635 | - // Extract the session ID from the option name | |
| 1636 | - $session_id = str_replace('mxchat_history_', '', $option->option_name); | |
| 2000 | + if (empty($rows)) { | |
| 2001 | + $state['done'] = true; | |
| 2002 | + update_option('mxchat_legacy_history_cleanup', $state, 'no'); | |
| 2003 | + return 0; | |
| 2004 | + } | |
| 1637 | 2005 | |
| 1638 | - // Check if this session still exists in the custom table | |
| 1639 | - $table_name = $wpdb->prefix . 'mxchat_chat_transcripts'; | |
| 1640 | - $exists = $wpdb->get_var( | |
| 1641 | - $wpdb->prepare( | |
| 1642 | - "SELECT COUNT(*) FROM {$table_name} WHERE session_id = %s", | |
| 1643 | - $session_id | |
| 1644 | - ) | |
| 1645 | - ); | |
| 2006 | + foreach ($rows as $row) { | |
| 2007 | + $state['last_option_id'] = max((int) $state['last_option_id'], (int) $row['option_id']); | |
| 2008 | + delete_option($row['option_name']); | |
| 2009 | + $state['deleted'] = (int) $state['deleted'] + 1; | |
| 2010 | + } | |
| 1646 | 2011 | |
| 1647 | - // If session doesn't exist in the main table, delete the option | |
| 1648 | - if ($exists == 0) { | |
| 1649 | - delete_option($option->option_name); | |
| 1650 | - // Also delete related metadata | |
| 1651 | - delete_option("mxchat_email_{$session_id}"); | |
| 1652 | - delete_option("mxchat_name_{$session_id}"); | |
| 1653 | - delete_option("mxchat_agent_name_{$session_id}"); | |
| 1654 | - $count++; | |
| 1655 | - } | |
| 2012 | + if (count($rows) < $batch) { | |
| 2013 | + $state['done'] = true; | |
| 2014 | + } | |
| 2015 | + | |
| 2016 | + update_option('mxchat_legacy_history_cleanup', $state, 'no'); | |
| 2017 | + | |
| 2018 | + return count($rows); | |
| 2019 | +} | |
| 2020 | + | |
| 2021 | +/** One batch per admin page load until drained. */ | |
| 2022 | +function mxchat_history_backlog_drain() { | |
| 2023 | + mxchat_history_backlog_batch(); | |
| 2024 | +} | |
| 2025 | + | |
| 2026 | +/** Cron leg: drain faster, same cap per batch. */ | |
| 2027 | +function mxchat_history_backlog_drain_cron() { | |
| 2028 | + for ($i = 0; $i < 10; $i++) { | |
| 2029 | + if (mxchat_history_backlog_batch() === 0) { | |
| 2030 | + break; | |
| 1656 | 2031 | } |
| 1657 | 2032 | } |
| 2033 | +} | |
| 1658 | 2034 | |
| 1659 | - return $count; | |
| 2035 | +// wp_doing_ajax() guard is load-bearing, not defensive (b64b77's shipped-and- | |
| 2036 | +// caught defect): admin-ajax.php fires admin_init too, and the chat widget's | |
| 2037 | +// message endpoint is an admin-ajax action — without the guard an anonymous | |
| 2038 | +// visitor would pay for a delete batch inside their own chat request. | |
| 2039 | +if (!wp_doing_ajax()) { | |
| 2040 | + add_action('admin_init', 'mxchat_history_backlog_drain', 21); | |
| 1660 | 2041 | } |
| 2042 | +// Belt for installs whose admin is rarely visited: ride the session store's | |
| 2043 | +// existing daily maintenance event rather than scheduling another. | |
| 2044 | +add_action('mxchat_session_store_maintenance', 'mxchat_history_backlog_drain_cron'); | |
| 1661 | 2045 | |
| 1662 | 2046 | function mxchat_migrate_live_agent_status() { |
| 1663 | 2047 | $options = get_option('mxchat_options', []); |
| 1664 | 2048 | |
