mxchat-basic / includes / class-mxchat-admin.php

class-mxchat-admin.php in MxChat – AI Chatbot & Content Generation for WordPress 3.2.8, at includes/class-mxchat-admin.php

10,253 lines 430.3 KB

Raw Download Zip

1	<?php
2	if (!defined('ABSPATH')) {
3	exit; // Exit if accessed directly
4	}
5
6	class MxChat_Admin {
7	private $options;
8	private $chat_count;
9	private $is_activated;
10	private $knowledge_manager;
11
12	/**
13	* Get whether the license is activated
14	* @return bool
15	*/
16	public function is_activated() {
17	return $this->is_activated;
18	}
19
20	/**
21	* Get plugin options
22	* @return array
23	*/
24	public function get_options() {
25	return $this->options;
26	}
27
28	public function __construct($knowledge_manager = null) {
29	$this->options = get_option('mxchat_options');
30	$this->chat_count = get_option('mxchat_chat_count', 0);
31	$this->is_activated = $this->is_license_active();
32	$this->knowledge_manager = $knowledge_manager;
33
34	// Initialize default options if they are not set
35	if (!$this->options) {
36	$this->initialize_default_options();
37	}
38
39	// Add admin menu and initialize settings
40	add_action('admin_menu', array($this, 'mxchat_add_plugin_page'));
41	// Pro & Extensions registers at priority 30 so it always lands last in
42	// the sidebar — below API Access (priority 20) and below any other
43	// submenu that hooks at default priority 10.
44	add_action('admin_menu', array($this, 'mxchat_add_pro_extensions_page'), 30);
45	// Onboarding visibility — runs LAST so it can remove the submenu after every
46	// other add_submenu_page() call. The page stays reachable by direct URL.
47	add_action('admin_menu', array($this, 'mxchat_apply_onboarding_visibility'), 999);
48	add_action('admin_init', array($this, 'mxchat_page_init'));
49	add_action('admin_init', array($this, 'mxchat_prompts_page_init'));
50	add_action('admin_enqueue_scripts', array($this, 'mxchat_enqueue_admin_assets'));
51	// Add body class for the Onboarding wizard (plan-905439) so the
52	// chrome-surgery CSS in admin-onboarding-wizard.css can scope its
53	// WP-sidebar collapse to this page only.
54	add_filter('admin_body_class', array($this, 'mxchat_add_onboarding_body_class'));
55	add_action('wp_ajax_mxchat_delete_chat_history', array($this, 'mxchat_delete_chat_history'));
56	add_action('admin_post_mxchat_delete_prompt', array($this, 'mxchat_handle_delete_prompt'));
57	add_action('wp_ajax_mxchat_fetch_chat_history', array($this, 'mxchat_fetch_chat_history'));
58	add_action('wp_ajax_nopriv_mxchat_fetch_chat_history', array($this, 'mxchat_fetch_chat_history'));
59	add_action('wp_ajax_mxchat_fetch_conversation', array($this, 'mxchat_fetch_conversation'));
60	add_action('wp_footer', array($this, 'mxchat_append_chatbot_to_body'));
61	add_action('admin_head-mxchat-prompts', array($this, 'mxchat_enqueue_admin_assets'));
62	add_action('admin_head-toplevel_page_mxchat-max', array($this, 'mxchat_enqueue_admin_assets'));
63	add_action('admin_notices', array($this, 'mxchat_display_admin_notice'));
64	add_action('admin_post_mxchat_delete_all_prompts', array($this, 'mxchat_handle_delete_all_prompts'));
65	add_action('admin_post_mxchat_add_intent', array($this, 'mxchat_handle_add_intent'));
66	add_action('admin_post_mxchat_delete_intent', array($this, 'mxchat_handle_delete_intent'));
67	add_action('admin_post_mxchat_edit_intent', array($this, 'mxchat_handle_edit_intent'));
68	add_action('wp_ajax_mxchat_export_transcripts', array($this, 'export_chat_transcripts'));
69
70	// Leads tab (inside Transcripts)
71	add_action('wp_ajax_mxchat_fetch_leads', array($this, 'mxchat_fetch_leads'));
72	add_action('wp_ajax_mxchat_delete_leads', array($this, 'mxchat_delete_leads'));
73	add_action('wp_ajax_mxchat_export_leads', array($this, 'mxchat_export_leads'));
74
75	add_action('admin_init', array($this, 'mxchat_transcripts_page_init'));
76	add_action('wp_ajax_dismiss_live_agent_notice', array($this, 'dismiss_live_agent_notice'));
77	add_action('wp_ajax_dismiss_theme_migration_notice', array($this, 'dismiss_theme_migration_notice'));
78	add_action('mxchat_cleanup_old_transcripts', array($this, 'cleanup_old_transcripts'));
79
80	add_action('admin_init', array($this, 'register_pinecone_settings'));
81	add_action('admin_init', array($this, 'register_openai_vectorstore_settings'));
82
83	add_action('admin_notices', array($this, 'display_admin_notices'));
84
85	add_action('wp_ajax_mxchat_test_streaming_actual', [$this, 'mxchat_handle_test_streaming_actual']);
86	add_action('wp_ajax_mxchat_test_streaming', [$this, 'mxchat_handle_test_streaming']); // Keep existing as fallback
87	add_action('wp_ajax_mxchat_test_vectorstore_connection', array($this, 'mxchat_test_vectorstore_connection'));
88
89	add_action('wp_ajax_mxchat_save_selected_bot', array($this, 'mxchat_save_selected_bot'));
90	add_action('wp_ajax_mxchat_fetch_openrouter_models', array($this, 'fetch_openrouter_models'));
91	add_action('wp_ajax_mxchat_get_rag_context', array($this, 'mxchat_get_rag_context'));
92
93	// Actions page AJAX handlers
94	add_action('wp_ajax_mxchat_fetch_actions_list', array($this, 'mxchat_fetch_actions_list'));
95	add_action('wp_ajax_mxchat_toggle_action_status', array($this, 'mxchat_toggle_action_status'));
96	add_action('wp_ajax_mxchat_bulk_delete_actions', array($this, 'mxchat_bulk_delete_actions'));
97	add_action('wp_ajax_mxchat_add_intent_ajax', array($this, 'mxchat_add_intent_ajax'));
98	add_action('wp_ajax_mxchat_edit_intent_ajax', array($this, 'mxchat_edit_intent_ajax'));
99	add_action('wp_ajax_mxchat_delete_intent_ajax', array($this, 'mxchat_delete_intent_ajax'));
100	add_action('wp_ajax_mxchat_add_phrase', array($this, 'mxchat_add_phrase_ajax'));
101	add_action('wp_ajax_mxchat_delete_phrase', array($this, 'mxchat_delete_phrase_ajax'));
102	add_action('wp_ajax_mxchat_get_phrases', array($this, 'mxchat_get_phrases_ajax'));
103	add_action('wp_ajax_mxchat_delete_legacy_phrases', array($this, 'mxchat_delete_legacy_phrases_ajax'));
104
105	// Slack test connection
106	add_action('wp_ajax_mxchat_test_slack_connection', array($this, 'mxchat_test_slack_connection'));
107
108	// Translation handlers
109	add_action('wp_ajax_mxchat_translate_messages', array($this, 'mxchat_translate_messages'));
110	add_action('wp_ajax_mxchat_get_transcript_translation', array($this, 'mxchat_get_transcript_translation'));
111
112	// 3.2.3: Embedding model switch protection
113	add_action('wp_ajax_mxchat_check_embedding_switch', array($this, 'mxchat_check_embedding_switch_ajax'));
114	add_action('wp_ajax_mxchat_dismiss_embedding_mismatch', array($this, 'mxchat_dismiss_embedding_mismatch_ajax'));
115	add_action('admin_notices', array($this, 'mxchat_embedding_mismatch_notice'));
116	}
117
118	/**
119	* 3.2.3: Preflight check before allowing the embedding model dropdown to
120	* switch. Pure option comparison — no counts, no DB queries beyond the
121	* cached options. The dialog is shown whenever the user has previously
122	* embedded with a different model than the one they're switching to.
123	*/
124	public function mxchat_check_embedding_switch_ajax() {
125	check_ajax_referer('mxchat_admin_nonce', 'security');
126	if (!current_user_can('manage_options')) {
127	wp_send_json_error(__('Unauthorized', 'mxchat'));
128	}
129
130	$new_model = isset($_POST['new_model']) ? sanitize_text_field(wp_unslash($_POST['new_model'])) : '';
131	$active_model = MxChat_Utils::get_active_embedding_model();
132
133	$is_mismatch = !empty($active_model) && !empty($new_model) && $active_model !== $new_model;
134
135	$active_dims = MxChat_Utils::embedding_model_dimensions($active_model);
136	$new_dims = MxChat_Utils::embedding_model_dimensions($new_model);
137
138	wp_send_json_success(array(
139	'is_mismatch' => $is_mismatch,
140	'active_model' => $active_model,
141	'active_label' => MxChat_Utils::embedding_model_label($active_model),
142	'new_model' => $new_model,
143	'new_label' => MxChat_Utils::embedding_model_label($new_model),
144	'dims_differ' => ($active_dims > 0 && $new_dims > 0 && $active_dims !== $new_dims),
145	'active_dims' => $active_dims,
146	'new_dims' => $new_dims,
147	));
148	}
149
150	/**
151	* 3.2.3: Dismiss the persistent mismatch banner. Tied to the active+selected
152	* pair so the banner reappears on the next switch event.
153	*/
154	public function mxchat_dismiss_embedding_mismatch_ajax() {
155	check_ajax_referer('mxchat_admin_nonce', 'security');
156	if (!current_user_can('manage_options')) {
157	wp_send_json_error(__('Unauthorized', 'mxchat'));
158	}
159
160	$options = get_option('mxchat_options', array());
161	$selected = $options['embedding_model'] ?? '';
162	$active = MxChat_Utils::get_active_embedding_model();
163	update_option('mxchat_dismissed_embedding_mismatch', $active . '\|' . $selected, false);
164	wp_send_json_success();
165	}
166
167	/**
168	* 3.2.3: Persistent admin banner shown whenever the active embedding model
169	* (last used to actually embed something) differs from the currently
170	* selected model. Pure option comparison — no DB queries on every page
171	* load. The banner auto-clears once both match again, i.e. after a delete
172	* + re-embed cycle.
173	*/
174	public function mxchat_embedding_mismatch_notice() {
175	if (!current_user_can('manage_options')) {
176	return;
177	}
178
179	$options = get_option('mxchat_options', array());
180	$selected = $options['embedding_model'] ?? '';
181	$active = MxChat_Utils::get_active_embedding_model();
182
183	if (empty($active) \|\| empty($selected) \|\| $active === $selected) {
184	return;
185	}
186
187	$dismissed = get_option('mxchat_dismissed_embedding_mismatch', '');
188	if ($dismissed === $active . '\|' . $selected) {
189	return;
190	}
191
192	$active_label = MxChat_Utils::embedding_model_label($active);
193	$selected_label = MxChat_Utils::embedding_model_label($selected);
194	$active_dims = MxChat_Utils::embedding_model_dimensions($active);
195	$selected_dims = MxChat_Utils::embedding_model_dimensions($selected);
196	$dims_differ = ($active_dims > 0 && $selected_dims > 0 && $active_dims !== $selected_dims);
197
198	$kb_url = admin_url('admin.php?page=mxchat-prompts');
199	$actions_url = admin_url('admin.php?page=mxchat-actions');
200
201	?>
202	<div class="notice notice-error is-dismissible mxchat-embedding-mismatch-notice"
203	data-active="<?php echo esc_attr($active); ?>"
204	data-selected="<?php echo esc_attr($selected); ?>">
205	<p><strong><?php esc_html_e('MxChat: Embedding model mismatch detected', 'mxchat'); ?></strong></p>
206	<p>
207	<?php
208	printf(
209	/* translators: 1: previously-used model name, 2: currently-selected model name */
210	esc_html__('Your knowledge base and actions were embedded with %1$s, but %2$s is now selected. Similarity matching will return inaccurate or empty results until you delete all existing embeddings and re-embed your content with the new model.', 'mxchat'),
211	'<code>' . esc_html($active_label) . '</code>',
212	'<code>' . esc_html($selected_label) . '</code>'
213	);
214	?>
215	</p>
216	<?php if ($dims_differ) : ?>
217	<p>
218	<strong><?php esc_html_e('Dimension mismatch:', 'mxchat'); ?></strong>
219	<?php
220	printf(
221	/* translators: 1: old dim count, 2: new dim count */
222	esc_html__('Existing vectors are %1$d-dimensional but the new model produces %2$d-dimensional vectors. If you use Pinecone, your index will reject queries entirely until re-embedded.', 'mxchat'),
223	(int) $active_dims,
224	(int) $selected_dims
225	);
226	?>
227	</p>
228	<?php endif; ?>
229	<p>
230	<?php esc_html_e('To fix this:', 'mxchat'); ?>
231	<a href="<?php echo esc_url($kb_url); ?>"><?php esc_html_e('Delete all knowledge base entries', 'mxchat'); ?></a> ·
232	<a href="<?php echo esc_url($actions_url); ?>"><?php esc_html_e('Delete all actions', 'mxchat'); ?></a> ·
233	<?php esc_html_e('then re-import / re-add them with the new model selected.', 'mxchat'); ?>
234	</p>
235	</div>
236	<script>
237	(function($){
238	$(document).on('click', '.mxchat-embedding-mismatch-notice .notice-dismiss', function(){
239	$.post(ajaxurl, {
240	action: 'mxchat_dismiss_embedding_mismatch',
241	security: '<?php echo esc_js(wp_create_nonce('mxchat_admin_nonce')); ?>'
242	});
243	});
244	})(jQuery);
245	</script>
246	<?php
247	}
248
249	private function is_license_active() {
250	$license_status = get_option('mxchat_license_status', 'inactive');
251	return ($license_status === 'active');
252	}
253
254	private function initialize_default_options() {
255	$default_options = array(
256	'api_key' => '',
257	'xai_api_key' => '',
258	'claude_api_key' => '',
259	'deepseek_api_key' => '',
260	'voyage_api_key' => '',
261	'gemini_api_key' => '',
262	'enable_streaming_toggle' => 'off',
263	'enable_web_search' => 'off',
264	'embedding_model' => 'text-embedding-ada-002',
265	'system_prompt_instructions' => 'You are an AI Chatbot assistant for this website. Your main goal is to assist visitors with questions and provide helpful information. Here are your key guidelines:
266
267	# Response Style - CRITICALLY IMPORTANT
268	- MAXIMUM LENGTH: 1-3 short sentences per response
269	- Ultra-concise: Get straight to the answer with no filler
270	- No introductions like "Sure!" or "I\'d be happy to help"
271	- No phrases like "based on my knowledge" or "according to information"
272	- No explanatory text before giving the answer
273	- No summaries or repetition
274	- Hyperlink all URLs
275	- Respond in user\'s language
276	- Minor chit chat or conversation is okay, but try to keep it focused on [insert topic]
277
278	# Knowledge Base Requirements - PREVENT HALLUCINATIONS
279	- ONLY answer questions using information explicitly provided in OFFICIAL KNOWLEDGE DATABASE CONTENT sections marked with ===== delimiters
280	- If required information is NOT in the knowledge database: "I don\'t have enough information in my knowledge base to answer that question accurately."
281	- NEVER invent or hallucinate URLs, links, product specs, procedures, dates, statistics, names, contacts, or company information
282	- When knowledge base information is unclear or contradictory, acknowledge the limitation rather than guessing
283	- Better to admit insufficient information than provide inaccurate answers',
284	'model' => esc_html__('gpt-5.1-chat-latest', 'mxchat'),
285	'rate_limit_logged_out' => esc_html__('100', 'mxchat'),
286	'role_rate_limits' => array(),
287	'rate_limit_message' => esc_html__('Rate limit exceeded. Please try again later.', 'mxchat'),
288	'enable_email_block' => '',
289	'email_blocker_header_content' => __("<h2>Welcome to Our Chat!</h2>\n<p>Let's get started. Enter your email to begin chatting with us.</p>", 'mxchat'),
290	'email_blocker_button_text' => esc_html__('Start Chat', 'mxchat'),
291	'enable_name_field' => 'off', // NEW
292	'name_field_placeholder' => esc_html__('Enter your name', 'mxchat'), // NEW
293	'top_bar_title' => esc_html__('MxChat', 'mxchat'),
294	'intro_message' => __('Hello! How can I assist you today?', 'mxchat'),
295	'ai_agent_text' => esc_html__('AI Agent', 'mxchat'),
296	'input_copy' => esc_html__('How can I assist?', 'mxchat'),
297	'append_to_body' => esc_html__('off', 'mxchat'),
298	'post_type_visibility_mode' => 'all', // 'all', 'include', 'exclude'
299	'post_type_visibility_list' => array(), // Array of post type slugs
300	'contextual_awareness_toggle' => 'off',
301	'citation_links_toggle' => 'on',
302	'satisfaction_rating_enabled' => 'off',
303	'satisfaction_rating_idle_seconds' => 60,
304	'satisfaction_rating_question' => '',
305	'satisfaction_rating_thanks' => '',
306	'satisfaction_rating_placeholder' => '',
307	'satisfaction_rating_saved' => '',
308	'close_button_color' => esc_html__('#fff', 'mxchat'),
309	'chatbot_bg_color' => esc_html__('#fff', 'mxchat'),
310	'user_message_bg_color' => esc_html__('#fff', 'mxchat'),
311	'user_message_font_color' => esc_html__('#212121', 'mxchat'),
312	'bot_message_bg_color' => esc_html__('#212121', 'mxchat'),
313	'bot_message_font_color' => esc_html__('#fff', 'mxchat'),
314	'top_bar_bg_color' => esc_html__('#212121', 'mxchat'),
315	'send_button_font_color' => esc_html__('#212121', 'mxchat'),
316	'chat_input_font_color' => esc_html__('#212121', 'mxchat'),
317	'chatbot_background_color' => esc_html__('#212121', 'mxchat'),
318	'icon_color' => esc_html__('#fff', 'mxchat'),
319	'enable_woocommerce_integration' => esc_html__('0', 'mxchat'),
320	'link_target_toggle' => esc_html__('off', 'mxchat'),
321	'pre_chat_message' => esc_html__('Hey there! Ask me anything!', 'mxchat'),
322
323	// New fields for Loops Integration
324	'loops_api_key' => '',
325	'loops_mailing_list' => '',
326	'triggered_phrase_response' => __('Would you like to join our mailing list? Please provide your email below.', 'mxchat'),
327	'email_capture_response' => __('Thank you for providing your email! You\'ve been added to our list.', 'mxchat'),
328	'popular_question_1' => '',
329	'popular_question_2' => '',
330	'popular_question_3' => '',
331	'pdf_intent_trigger_text' => __("Please provide the URL to the PDF you'd like to discuss.", 'mxchat'),
332	'pdf_intent_success_text' => __("I've processed the PDF. What questions do you have about it?", 'mxchat'),
333	'pdf_intent_error_text' => __("Sorry, I couldn't process the PDF. Please ensure it's a valid file.", 'mxchat'),
334	'pdf_max_pages' => 69,
335	'show_pdf_upload_button' => 'on',
336	'show_word_upload_button' => 'on',
337
338	// Live Agent Integration (Slack)
339	'live_agent_webhook_url' => '',
340	'live_agent_secret_key' => '',
341	'live_agent_bot_token' => '',
342	'live_agent_message_bg_color' => esc_html__('#ffffff', 'mxchat'),
343	'live_agent_message_font_color' => esc_html__('#333333', 'mxchat'),
344
345	// Telegram Integration
346	'telegram_status' => 'off',
347	'telegram_bot_token' => '',
348	'telegram_group_id' => '',
349	'telegram_webhook_secret' => '',
350	'telegram_notification_message' => __("I've notified a support agent. Please allow a moment for them to respond. If you'd like to continue with AI, just type \"Switch to AI\" at any time.", 'mxchat'),
351	'telegram_away_message' => __("I just checked, and it looks like our support team isn't personally available at the moment. If you'd like, you can leave your email address, and they'll get back to you as soon as possible. In the meantime, you can keep chatting with me — just let me know how I can help!", 'mxchat'),
352
353	'chat_toolbar_toggle' => esc_html__('off', 'mxchat'),
354	'mode_indicator_bg_color' => esc_html__('#767676', 'mxchat'),
355	'mode_indicator_font_color' => esc_html__('#ffffff', 'mxchat'),
356	'toolbar_icon_color' => esc_html__('#212121', 'mxchat'),
357
358	// Optimization settings
359	'script_loading_strategy' => 'default',
360
361	// Debug settings
362	'debug_mode' => 'off',
363	);
364
365
366	// Merge existing options with defaults
367	$existing_options = get_option('mxchat_options', array());
368	$merged_options = wp_parse_args($existing_options, $default_options);
369
370	// Update the options if they have changed
371	if ($existing_options !== $merged_options) {
372	update_option('mxchat_options', $merged_options);
373	}
374
375	// Add default limits for each role
376	$roles = wp_roles()->get_names();
377	foreach ($roles as $role_id => $role_name) {
378	$default_options['role_rate_limits'][$role_id] = esc_html__('100', 'mxchat');
379	}
380
381	return $default_options;
382
383	// Update the $this->options property
384	$this->options = $merged_options;
385	}
386
387	public function mxchat_add_plugin_page() {
388	// Onboarding lifecycle helpers (admin_init redirect + ajax handlers live in the file).
389	require_once plugin_dir_path(__FILE__) . 'admin-onboarding-page.php';
390
391	// Main menu page — `mxchat-max` remains the parent slug for every MxChat submenu
392	// (Settings, Knowledge, Transcripts, …). Hitting `?page=mxchat-max` directly now
393	// dispatches to the Onboarding page (or Settings if the user has dismissed onboarding).
394	add_menu_page(
395	esc_html__('MxChat', 'mxchat'),
396	esc_html__('MxChat', 'mxchat'),
397	'manage_options',
398	'mxchat-max',
399	array($this, 'mxchat_create_dashboard_page'),
400	'dashicons-testimonial',
401	6
402	);
403
404	// Onboarding submenu — first child under MxChat (plan-d14e89).
405	// First registration uses menu_slug === parent slug 'mxchat-max' →
406	// WP-canonical override of the auto-duplicate "MxChat" entry. Result: the
407	// first child shows as "Onboarding" instead of a redundant pair.
408	add_submenu_page(
409	'mxchat-max',
410	esc_html__('MxChat Onboarding', 'mxchat'),
411	esc_html__('Onboarding', 'mxchat'),
412	'manage_options',
413	'mxchat-max',
414	array($this, 'mxchat_create_dashboard_page')
415	);
416	// Hidden route for `?page=mxchat-onboarding` (Settings "Show again" link
417	// + legacy redirects still target this slug). Parent === null keeps it
418	// out of the menu while remaining accessible by URL.
419	add_submenu_page(
420	null,
421	esc_html__('MxChat Onboarding', 'mxchat'),
422	esc_html__('Onboarding', 'mxchat'),
423	'manage_options',
424	'mxchat-onboarding',
425	array($this, 'mxchat_create_dashboard_page')
426	);
427
428	// Settings submenu — same callback as before, just at a new slug.
429	add_submenu_page(
430	'mxchat-max',
431	esc_html__('MxChat Settings', 'mxchat'),
432	esc_html__('Settings', 'mxchat'),
433	'manage_options',
434	'mxchat-settings',
435	array($this, 'mxchat_create_admin_page')
436	);
437
438	// Submenu page for Knowledge
439	add_submenu_page(
440	'mxchat-max',
441	esc_html__('Prompts', 'mxchat'),
442	esc_html__('Knowledge', 'mxchat'),
443	'manage_options',
444	'mxchat-prompts',
445	array($this, 'mxchat_create_prompts_page')
446	);
447
448	add_submenu_page(
449	'mxchat-max',
450	esc_html__('Chat Transcripts', 'mxchat'),
451	esc_html__('Transcripts', 'mxchat'),
452	'manage_options',
453	'mxchat-transcripts',
454	array($this, 'mxchat_create_transcripts_page')
455	);
456
457	add_submenu_page(
458	'mxchat-max',
459	esc_html__('MxChat Actions', 'mxchat'),
460	esc_html__('Actions', 'mxchat'),
461	'manage_options',
462	'mxchat-actions',
463	array($this, 'mxchat_actions_page_html')
464	);
465
466	// Content Generator page
467	add_submenu_page(
468	'mxchat-max',
469	esc_html__('Content', 'mxchat'),
470	esc_html__('Content', 'mxchat'),
471	'manage_options',
472	'mxchat-content',
473	array($this, 'mxchat_create_content_page')
474	);
475
476	}
477
478	/**
479	* Register the Pro & Extensions submenu on a later admin_menu priority so it
480	* always renders as the bottom-most item in the MxChat sidebar — below
481	* configuration pages like API Access (priority 20).
482	*/
483	public function mxchat_add_pro_extensions_page() {
484	add_submenu_page(
485	'mxchat-max',
486	esc_html__('Pro & Extensions', 'mxchat'),
487	esc_html__('Pro & Extensions', 'mxchat'),
488	'manage_options',
489	'mxchat-activation',
490	array($this, 'mxchat_create_activation_page')
491	);
492	}
493
494	public function mxchat_create_addons_page() {
495	require_once plugin_dir_path(__FILE__) . 'class-mxchat-addons.php';
496	$addons_page = new MxChat_Addons();
497	$addons_page->render_page();
498	}
499
500	/**
501	* Render the Content Generator admin page
502	*/
503	public function mxchat_create_content_page() {
504	require_once plugin_dir_path(__FILE__) . 'admin-content-page.php';
505	mxchat_render_content_page($this);
506	}
507
508	/**
509	* Test actual streaming functionality in the WordPress environment
510	*/
511	public function mxchat_handle_test_streaming_actual() {
512	check_ajax_referer('mxchat_test_streaming_nonce', 'nonce');
513
514	// Check if headers have already been sent
515	if (headers_sent()) {
516	wp_send_json_error(['message' => 'Headers already sent - streaming not possible']);
517	return;
518	}
519
520	// Check for required functions
521	if (!function_exists('curl_init')) {
522	wp_send_json_error(['message' => 'cURL not available - streaming requires cURL']);
523	return;
524	}
525
526	// Get user's selected model and API key
527	$options = get_option('mxchat_options', []);
528	$selected_model = $options['model'] ?? 'gpt-5.1-chat-latest';
529
530	// Get the provider from the model
531	$model_parts = explode('-', $selected_model);
532	$provider = strtolower($model_parts[0]);
533
534	// Get the appropriate API key
535	$api_key = '';
536	switch ($provider) {
537	case 'gpt':
538	case 'o1':
539	$api_key = $options['api_key'] ?? '';
540	break;
541	case 'claude':
542	$api_key = $options['claude_api_key'] ?? '';
543	break;
544	case 'grok':
545	$api_key = $options['xai_api_key'] ?? '';
546	break;
547	case 'deepseek':
548	$api_key = $options['deepseek_api_key'] ?? '';
549	break;
550	case 'gemini':
551	$api_key = $options['gemini_api_key'] ?? '';
552	break;
553	default:
554	// Default to OpenAI for unknown models
555	$api_key = $options['api_key'] ?? '';
556	$provider = 'gpt';
557	break;
558	}
559
560	if (empty($api_key)) {
561	wp_send_json_error(['message' => "API key not configured for {$provider} provider"]);
562	return;
563	}
564
565	// Test streaming with the selected model and provider
566	try {
567	$this->perform_streaming_test($provider, $selected_model, $api_key);
568	} catch (Exception $e) {
569	wp_send_json_error(['message' => 'Streaming test exception: ' . $e->getMessage()]);
570	}
571	}
572
573	/**
574	* Perform the actual streaming test
575	*/
576	private function perform_streaming_test($provider, $model, $api_key) {
577	// Set streaming headers
578	header('Content-Type: text/event-stream');
579	header('Cache-Control: no-cache');
580	header('X-Accel-Buffering: no'); // Disable nginx buffering
581
582	// Prepare test message
583	$test_message = "Please respond with exactly: 'Streaming test successful!' - send this as a short response for testing.";
584
585	// Configure API request based on provider
586	$url = '';
587	$headers = [];
588	$body = [];
589
590	switch ($provider) {
591	case 'gpt':
592	case 'o1':
593	$url = 'https://api.openai.com/v1/chat/completions';
594	$headers = [
595	'Content-Type: application/json',
596	'Authorization: Bearer ' . $api_key
597	];
598	$body = [
599	'model' => $model,
600	'messages' => [['role' => 'user', 'content' => $test_message]],
601	'max_tokens' => 50,
602	'temperature' => 0.3,
603	'stream' => true
604	];
605	break;
606
607	case 'claude':
608	$url = 'https://api.anthropic.com/v1/messages';
609	$headers = [
610	'Content-Type: application/json',
611	'x-api-key: ' . $api_key,
612	'anthropic-version: 2023-06-01'
613	];
614	$body = [
615	'model' => $model,
616	'messages' => [['role' => 'user', 'content' => $test_message]],
617	'max_tokens' => 50,
618	'temperature' => 0.3,
619	'stream' => true
620	];
621	break;
622
623	case 'grok':
624	$url = 'https://api.x.ai/v1/chat/completions';
625	$headers = [
626	'Content-Type: application/json',
627	'Authorization: Bearer ' . $api_key
628	];
629	$body = [
630	'model' => $model,
631	'messages' => [['role' => 'user', 'content' => $test_message]],
632	'max_tokens' => 50,
633	'temperature' => 0.3,
634	'stream' => true
635	];
636	break;
637
638	case 'deepseek':
639	$url = 'https://api.deepseek.com/v1/chat/completions';
640	$headers = [
641	'Content-Type: application/json',
642	'Authorization: Bearer ' . $api_key
643	];
644	$body = [
645	'model' => $model,
646	'messages' => [['role' => 'user', 'content' => $test_message]],
647	'max_tokens' => 50,
648	'temperature' => 0.3,
649	'stream' => true
650	];
651	break;
652
653	default:
654	echo "data: " . json_encode(['error' => 'Unsupported provider for streaming test: ' . $provider]) . "\n\n";
655	flush();
656	return;
657	}
658
659	// Initialize cURL
660	$ch = curl_init();
661	curl_setopt($ch, CURLOPT_URL, $url);
662	curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
663	curl_setopt($ch, CURLOPT_POST, true);
664	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
665	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
666	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
667	curl_setopt($ch, CURLOPT_TIMEOUT, 30);
668	curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) use ($provider) {
669	return $this->process_streaming_test_data($data, $provider);
670	});
671
672	// Send initial test message
673	echo "data: " . json_encode(['content' => '[Starting streaming test...]']) . "\n\n";
674	flush();
675
676	$result = curl_exec($ch);
677	$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
678	$curl_error = curl_error($ch);
679	curl_close($ch);
680
681	if ($curl_error) {
682	echo "data: " . json_encode(['error' => 'cURL Error: ' . $curl_error]) . "\n\n";
683	flush();
684	return;
685	}
686
687	if ($http_code !== 200) {
688	echo "data: " . json_encode(['error' => 'API returned HTTP ' . $http_code]) . "\n\n";
689	flush();
690	return;
691	}
692
693	// Send completion signal
694	echo "data: [DONE]\n\n";
695	flush();
696	}
697
698	/**
699	* Process streaming data for the test
700	*/
701	private function process_streaming_test_data($data, $provider) {
702	static $chunk_count = 0;
703
704	$lines = explode("\n", $data);
705
706	foreach ($lines as $line) {
707	if (trim($line) === '') {
708	continue;
709	}
710
711	// Handle different provider formats
712	if ($provider === 'claude') {
713	// Claude uses event: and data: format
714	if (strpos($line, 'data: ') === 0) {
715	$json_str = substr($line, 6);
716	$json = json_decode($json_str, true);
717
718	if (isset($json['type']) && $json['type'] === 'content_block_delta') {
719	if (isset($json['delta']['text'])) {
720	$chunk_count++;
721	echo "data: " . json_encode([
722	'content' => $json['delta']['text'],
723	'test_chunk' => $chunk_count
724	]) . "\n\n";
725	flush();
726	}
727	}
728	}
729	} else {
730	// OpenAI, X.AI, DeepSeek format
731	if (strpos($line, 'data: ') === 0) {
732	$json_str = substr($line, 6);
733
734	if ($json_str === '[DONE]') {
735	// Don't echo [DONE] here, let the main function handle it
736	continue;
737	}
738
739	$json = json_decode($json_str, true);
740	if (isset($json['choices'][0]['delta']['content'])) {
741	$chunk_count++;
742	echo "data: " . json_encode([
743	'content' => $json['choices'][0]['delta']['content'],
744	'test_chunk' => $chunk_count
745	]) . "\n\n";
746	flush();
747	}
748	}
749	}
750	}
751
752	return strlen($data);
753	}
754
755	/**
756	* Updated version of your existing test method (keep this as a fallback)
757	*/
758	public function mxchat_handle_test_streaming() {
759	check_ajax_referer('mxchat_test_streaming_nonce', 'nonce');
760
761	// Use the actual streaming test instead
762	$this->mxchat_handle_test_streaming_actual();
763	}
764
765
766	public function register_pinecone_settings() {
767	register_setting(
768	'mxchat_pinecone_addon_options',
769	'mxchat_pinecone_addon_options',
770	array(
771	'type' => 'array',
772	'sanitize_callback' => array($this, 'sanitize_pinecone_settings'),
773	'default' => array(
774	'mxchat_use_pinecone' => '0',
775	'mxchat_pinecone_api_key' => '',
776	'mxchat_pinecone_host' => '',
777	'mxchat_pinecone_index' => '',
778	'mxchat_pinecone_environment' => ''
779	)
780	)
781	);
782	}
783
784	public function sanitize_pinecone_settings($input) {
785	$sanitized = array();
786
787	$sanitized['mxchat_use_pinecone'] = isset($input['mxchat_use_pinecone']) ? '1' : '0';
788	$sanitized['mxchat_pinecone_api_key'] = sanitize_text_field($input['mxchat_pinecone_api_key'] ?? '');
789	$sanitized['mxchat_pinecone_host'] = sanitize_text_field($input['mxchat_pinecone_host'] ?? '');
790	$sanitized['mxchat_pinecone_index'] = sanitize_text_field($input['mxchat_pinecone_index'] ?? '');
791	$sanitized['mxchat_pinecone_environment'] = sanitize_text_field($input['mxchat_pinecone_environment'] ?? '');
792
793	// Remove https:// from host if present
794	$sanitized['mxchat_pinecone_host'] = str_replace(['https://', 'http://'], '', $sanitized['mxchat_pinecone_host']);
795
796	return $sanitized;
797	}
798
799	public function register_openai_vectorstore_settings() {
800	register_setting(
801	'mxchat_openai_vectorstore_options',
802	'mxchat_openai_vectorstore_options',
803	array(
804	'type' => 'array',
805	'sanitize_callback' => array($this, 'sanitize_openai_vectorstore_settings'),
806	'default' => array(
807	'mxchat_use_openai_vectorstore' => '0',
808	'mxchat_vectorstore_ids' => '',
809	'mxchat_vectorstore_max_results' => 5
810	)
811	)
812	);
813	}
814
815	public function sanitize_openai_vectorstore_settings($input) {
816	$sanitized = array();
817
818	$sanitized['mxchat_use_openai_vectorstore'] = isset($input['mxchat_use_openai_vectorstore']) ? '1' : '0';
819	$sanitized['mxchat_vectorstore_ids'] = sanitize_text_field($input['mxchat_vectorstore_ids'] ?? '');
820	$sanitized['mxchat_vectorstore_max_results'] = absint($input['mxchat_vectorstore_max_results'] ?? 5);
821
822	// Ensure max results is within reasonable range
823	if ($sanitized['mxchat_vectorstore_max_results'] < 1) {
824	$sanitized['mxchat_vectorstore_max_results'] = 1;
825	}
826	if ($sanitized['mxchat_vectorstore_max_results'] > 20) {
827	$sanitized['mxchat_vectorstore_max_results'] = 20;
828	}
829
830	return $sanitized;
831	}
832
833	/**
834	* AJAX handler to test OpenAI Vector Store connection
835	*/
836	public function mxchat_test_vectorstore_connection() {
837	check_ajax_referer('mxchat_admin_nonce', 'nonce');
838
839	if (!current_user_can('manage_options')) {
840	wp_send_json_error(array('message' => __('Permission denied.', 'mxchat')));
841	return;
842	}
843
844	$vectorstore_options = get_option('mxchat_openai_vectorstore_options', array());
845	$vectorstore_ids = $vectorstore_options['mxchat_vectorstore_ids'] ?? '';
846	$mxchat_options = get_option('mxchat_options', array());
847	$api_key = $mxchat_options['api_key'] ?? '';
848
849	if (empty($api_key)) {
850	wp_send_json_error(array('message' => __('OpenAI API key is not configured.', 'mxchat')));
851	return;
852	}
853
854	if (empty($vectorstore_ids)) {
855	wp_send_json_error(array('message' => __('No Vector Store ID configured.', 'mxchat')));
856	return;
857	}
858
859	// Get the first Vector Store ID for testing
860	$ids_array = array_map('trim', explode(',', $vectorstore_ids));
861	$test_id = $ids_array[0];
862
863	// Test by retrieving the Vector Store info
864	$response = wp_remote_get(
865	'https://api.openai.com/v1/vector_stores/' . $test_id,
866	array(
867	'headers' => array(
868	'Authorization' => 'Bearer ' . $api_key,
869	'Content-Type' => 'application/json',
870	'OpenAI-Beta' => 'assistants=v2'
871	),
872	'timeout' => 30
873	)
874	);
875
876	if (is_wp_error($response)) {
877	wp_send_json_error(array('message' => __('Connection failed: ', 'mxchat') . $response->get_error_message()));
878	return;
879	}
880
881	$status_code = wp_remote_retrieve_response_code($response);
882	$body = json_decode(wp_remote_retrieve_body($response), true);
883
884	if ($status_code === 200 && isset($body['id'])) {
885	$file_count = $body['file_counts']['completed'] ?? 0;
886	$name = $body['name'] ?? $test_id;
887	wp_send_json_success(array(
888	'message' => sprintf(
889	__('Connected successfully! Vector Store: %s (%d files)', 'mxchat'),
890	esc_html($name),
891	$file_count
892	)
893	));
894	} elseif ($status_code === 404) {
895	wp_send_json_error(array('message' => __('Vector Store not found. Please check the ID.', 'mxchat')));
896	} elseif ($status_code === 401) {
897	wp_send_json_error(array('message' => __('Invalid API key.', 'mxchat')));
898	} else {
899	$error_message = $body['error']['message'] ?? __('Unknown error occurred.', 'mxchat');
900	wp_send_json_error(array('message' => $error_message));
901	}
902	}
903
904	/**
905	* AJAX handler to test Slack connection and validate scopes
906	*/
907	public function mxchat_test_slack_connection() {
908	check_ajax_referer('mxchat_admin_nonce', 'nonce');
909
910	if (!current_user_can('manage_options')) {
911	wp_send_json_error(array('message' => __('Permission denied.', 'mxchat')));
912	return;
913	}
914
915	$bot_token = $this->options['live_agent_bot_token'] ?? '';
916
917	if (empty($bot_token)) {
918	wp_send_json_error(array('message' => __('Slack Bot Token is not configured. Please enter your token and save settings first.', 'mxchat')));
919	return;
920	}
921
922	// Test 1: Validate bot token with auth.test
923	$auth_response = wp_remote_post('https://slack.com/api/auth.test', array(
924	'headers' => array(
925	'Authorization' => 'Bearer ' . $bot_token,
926	'Content-Type' => 'application/json'
927	),
928	'timeout' => 15
929	));
930
931	if (is_wp_error($auth_response)) {
932	wp_send_json_error(array('message' => __('Connection failed: ', 'mxchat') . $auth_response->get_error_message()));
933	return;
934	}
935
936	$auth_body = json_decode(wp_remote_retrieve_body($auth_response), true);
937
938	if (!isset($auth_body['ok']) \|\| !$auth_body['ok']) {
939	$error = $auth_body['error'] ?? 'unknown_error';
940	$error_messages = array(
941	'invalid_auth' => __('Invalid bot token. Please check your token starts with xoxb-', 'mxchat'),
942	'not_authed' => __('No authentication token provided.', 'mxchat'),
943	'account_inactive' => __('The Slack workspace has been deactivated.', 'mxchat'),
944	'token_revoked' => __('The bot token has been revoked. Please generate a new one.', 'mxchat'),
945	);
946	$message = $error_messages[$error] ?? sprintf(__('Authentication failed: %s', 'mxchat'), $error);
947	wp_send_json_error(array('message' => $message));
948	return;
949	}
950
951	$team_name = $auth_body['team'] ?? 'Unknown Workspace';
952	$bot_name = $auth_body['user'] ?? 'Unknown Bot';
953
954	// Test 2: Check if we can list channels (tests channels:read scope)
955	$channels_response = wp_remote_post('https://slack.com/api/conversations.list', array(
956	'headers' => array(
957	'Authorization' => 'Bearer ' . $bot_token,
958	'Content-Type' => 'application/json'
959	),
960	'body' => json_encode(array('limit' => 1)),
961	'timeout' => 15
962	));
963
964	$channels_body = json_decode(wp_remote_retrieve_body($channels_response), true);
965	$can_read_channels = isset($channels_body['ok']) && $channels_body['ok'];
966
967	// Test 3: Check if we can create channels (tests channels:manage scope)
968	// We'll just check the error message without actually creating
969	$create_response = wp_remote_post('https://slack.com/api/conversations.create', array(
970	'headers' => array(
971	'Authorization' => 'Bearer ' . $bot_token,
972	'Content-Type' => 'application/json'
973	),
974	'body' => json_encode(array('name' => 'mxchat-test-' . time(), 'is_private' => false)),
975	'timeout' => 15
976	));
977
978	$create_body = json_decode(wp_remote_retrieve_body($create_response), true);
979
980	// If channel was created, delete it immediately
981	if (isset($create_body['ok']) && $create_body['ok'] && isset($create_body['channel']['id'])) {
982	wp_remote_post('https://slack.com/api/conversations.archive', array(
983	'headers' => array(
984	'Authorization' => 'Bearer ' . $bot_token,
985	'Content-Type' => 'application/json'
986	),
987	'body' => json_encode(array('channel' => $create_body['channel']['id'])),
988	'timeout' => 15
989	));
990	$can_create_channels = true;
991	} else {
992	$create_error = $create_body['error'] ?? '';
993	// name_taken means we have permission but channel exists
994	$can_create_channels = ($create_error === 'name_taken' \|\| (isset($create_body['ok']) && $create_body['ok']));
995
996	// Check for missing scope errors
997	if ($create_error === 'missing_scope') {
998	$can_create_channels = false;
999	}
1000	}
1001
1002	// Build result message
1003	$results = array();
1004	$results[] = sprintf(__('Workspace: %s', 'mxchat'), esc_html($team_name));
1005	$results[] = sprintf(__('Bot: %s', 'mxchat'), esc_html($bot_name));
1006	$results[] = '';
1007	$results[] = ($can_read_channels ? '✓' : '✗') . ' ' . __('channels:read - List channels', 'mxchat');
1008	$results[] = ($can_create_channels ? '✓' : '✗') . ' ' . __('channels:manage - Create channels', 'mxchat');
1009
1010	$missing_scopes = array();
1011	if (!$can_read_channels) $missing_scopes[] = 'channels:read';
1012	if (!$can_create_channels) $missing_scopes[] = 'channels:manage';
1013
1014	if (!empty($missing_scopes)) {
1015	wp_send_json_error(array(
1016	'message' => implode("\n", $results),
1017	'missing_scopes' => $missing_scopes,
1018	'partial' => true
1019	));
1020	} else {
1021	wp_send_json_success(array(
1022	'message' => implode("\n", $results)
1023	));
1024	}
1025	}
1026
1027	public function mxchat_display_admin_notice() {
1028	// Success notice
1029	if ($message = get_transient('mxchat_admin_notice_success')) {
1030	?>
1031	<div class="notice notice-success is-dismissible">
1032	<p><?php echo esc_html($message); ?></p>
1033	<button type="button" class="notice-dismiss"><span class="screen-reader-text"><?php echo esc_html__('Dismiss this notice.', 'mxchat'); ?></span></button>
1034	</div>
1035	<?php
1036	delete_transient('mxchat_admin_notice_success'); // Clear the transient after displaying
1037	}
1038
1039	// Error notice
1040	if ($message = get_transient('mxchat_admin_notice_error')) {
1041	?>
1042	<div class="notice notice-error is-dismissible">
1043	<p><?php echo esc_html($message); ?></p>
1044	<button type="button" class="notice-dismiss"><span class="screen-reader-text"><?php echo esc_html__('Dismiss this notice.', 'mxchat'); ?></span></button>
1045	</div>
1046	<?php
1047	delete_transient('mxchat_admin_notice_error'); // Clear the transient after displaying
1048	}
1049	}
1050
1051	public function show_live_agent_disabled_banner() {
1052	$show_disabled_notice = get_option('mxchat_show_live_agent_disabled_notice', false);
1053
1054	if ($show_disabled_notice) {
1055	?>
1056	<div class="mxchat-live-agent-disabled-notice" id="mxchat-disabled-notice">
1057	<div class="mxchat-pro-notification">
1058	<button type="button" class="mxchat-dismiss-btn" onclick="dismissLiveAgentNotice()" aria-label="Dismiss notification">
1059	<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
1060	<line x1="18" y1="6" x2="6" y2="18"></line>
1061	<line x1="6" y1="6" x2="18" y2="18"></line>
1062	</svg>
1063	</button>
1064	<div class="mxchat-live-agent-content">
1065	<h3>🔧 Live Agent Integration Updated!</h3>
1066	<p>We've temporarily disabled your Live Agent integration due to recent enhancements that have made it much better! You can easily turn it back on by going to <strong>Toolbar & Components → Live Agent Settings</strong> and reviewing the new configuration options.</p>
1067	</div>
1068	</div>
1069	</div>
1070	<?php
1071	}
1072	}
1073	/**
1074	* Render the Onboarding page. Delegates to the procedural renderer in
1075	* includes/admin-onboarding-page.php. Wired to both `?page=mxchat-max`
1076	* (legacy top-level URL) and `?page=mxchat-onboarding` (the canonical
1077	* Onboarding submenu).
1078	*
1079	* When the user has dismissed onboarding and lands on `mxchat-max` (the
1080	* legacy URL, since the Onboarding submenu has been removed), redirect to
1081	* Settings instead — the page is "graduated" and we shouldn't dump them
1082	* back onto it. They can still navigate here directly via the unhide link.
1083	*/
1084	public function mxchat_create_dashboard_page() {
1085	require_once plugin_dir_path(__FILE__) . 'admin-onboarding-page.php';
1086
1087	$current = isset($_GET['page']) ? sanitize_key($_GET['page']) : '';
1088	if ($current === 'mxchat-max' && function_exists('mxchat_onboarding_is_dismissed') && mxchat_onboarding_is_dismissed()) {
1089	wp_safe_redirect(admin_url('admin.php?page=mxchat-settings'));
1090	exit;
1091	}
1092
1093	if (function_exists('mxchat_render_onboarding_page')) {
1094	mxchat_render_onboarding_page();
1095	return;
1096	}
1097	// Defensive: if the include failed to load, fall back to the old Settings page
1098	// so the top-level menu never lands on an empty screen.
1099	$this->mxchat_create_admin_page();
1100	}
1101
1102	/**
1103	* Hide the Onboarding submenu when the user has dismissed it (either
1104	* manually or via auto-graduation). The page itself remains routable so
1105	* the Settings "Show MxChat Onboarding again" link can navigate back to it.
1106	*/
1107	public function mxchat_apply_onboarding_visibility() {
1108	if (!function_exists('mxchat_onboarding_is_dismissed')) {
1109	return;
1110	}
1111	if (mxchat_onboarding_is_dismissed()) {
1112	// The first MxChat child is the same-slug-as-parent registration
1113	// (slug 'mxchat-max', labelled "Onboarding") added in plan-d14e89.
1114	// Remove it so the menu opens straight to Settings after dismiss.
1115	remove_submenu_page('mxchat-max', 'mxchat-max');
1116	}
1117	}
1118
1119	public function mxchat_create_admin_page() {
1120	$this->add_live_agent_nonce();
1121	$this->add_theme_migration_nonce();
1122
1123	// Include and render the new sidebar-based settings page
1124	require_once plugin_dir_path(__FILE__) . 'admin-settings-page.php';
1125	mxchat_render_settings_page($this);
1126	}
1127
1128	public function dismiss_live_agent_notice() {
1129	// Add debugging
1130	//error_log('dismiss_live_agent_notice called');
1131	//error_log('POST data: ' . print_r($_POST, true));
1132
1133	// Verify nonce
1134	if (!wp_verify_nonce($_POST['nonce'], 'dismiss_live_agent_notice')) {
1135	//error_log('Nonce verification failed');
1136	wp_die('Security check failed');
1137	}
1138
1139	// Remove the notice flag
1140	$deleted = delete_option('mxchat_show_live_agent_disabled_notice');
1141	//error_log('Option deleted: ' . ($deleted ? 'yes' : 'no'));
1142
1143	wp_send_json_success();
1144	}
1145	public function add_live_agent_nonce() {
1146	if (get_option('mxchat_show_live_agent_disabled_notice', false)) {
1147	// Make sure your admin script is enqueued and localize the data
1148	wp_localize_script('mxchat-admin-js', 'mxchatLiveAgent', array(
1149	'nonce' => wp_create_nonce('dismiss_live_agent_notice'),
1150	'ajaxurl' => admin_url('admin-ajax.php')
1151	));
1152	}
1153	}
1154
1155	/**
1156	* Show theme migration notice for Pro users with AI-generated themes
1157	* Only shown once - dismissible and stored in options
1158	*/
1159	public function show_theme_migration_banner() {
1160	// Only show if Pro is activated
1161	if (!$this->is_activated) {
1162	return;
1163	}
1164
1165	// Check if notice should be shown
1166	$show_notice = get_option('mxchat_show_theme_migration_notice', false);
1167
1168	if ($show_notice) {
1169	?>
1170	<div class="mxchat-theme-migration-notice" id="mxchat-theme-migration-notice">
1171	<div class="mxchat-pro-notification">
1172	<button type="button" class="mxchat-dismiss-btn" onclick="dismissThemeMigrationNotice()" aria-label="Dismiss notification">
1173	<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
1174	<line x1="18" y1="6" x2="6" y2="18"></line>
1175	<line x1="6" y1="6" x2="18" y2="18"></line>
1176	</svg>
1177	</button>
1178	<div class="mxchat-theme-migration-content">
1179	<h3>🎨 AI Theme Migration Required</h3>
1180	<p>If you're using an AI-generated chatbot theme, you'll need to migrate it to match the new CSS structure. Go to <strong>Theme Settings</strong>, select your theme from the sidebar, and click the <strong>Migrate</strong> button.</p>
1181	</div>
1182	</div>
1183	</div>
1184	<?php
1185	}
1186	}
1187
1188	/**
1189	* Dismiss theme migration notice via AJAX
1190	*/
1191	public function dismiss_theme_migration_notice() {
1192	// Verify nonce
1193	if (!wp_verify_nonce($_POST['nonce'], 'dismiss_theme_migration_notice')) {
1194	wp_die('Security check failed');
1195	}
1196
1197	// Remove the notice flag
1198	delete_option('mxchat_show_theme_migration_notice');
1199
1200	wp_send_json_success();
1201	}
1202
1203	/**
1204	* Add nonce for theme migration notice dismiss
1205	*/
1206	public function add_theme_migration_nonce() {
1207	if (get_option('mxchat_show_theme_migration_notice', false) && $this->is_activated) {
1208	wp_localize_script('mxchat-admin-js', 'mxchatThemeMigration', array(
1209	'nonce' => wp_create_nonce('dismiss_theme_migration_notice'),
1210	'ajaxurl' => admin_url('admin-ajax.php')
1211	));
1212	}
1213	}
1214
1215	public function mxchat_create_transcripts_page() {
1216	global $wpdb;
1217	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
1218
1219	// Get basic stats
1220	$total_chats = $wpdb->get_var("SELECT COUNT(DISTINCT session_id) FROM $table_name") ?: 0;
1221	$total_messages = $wpdb->get_var("SELECT COUNT(*) FROM $table_name") ?: 0;
1222
1223	// Count unique users with detailed breakdown
1224	$total_users = $wpdb->get_var("
1225	SELECT COUNT(DISTINCT
1226	CASE
1227	WHEN user_email != '' AND user_email IS NOT NULL THEN user_email
1228	WHEN user_id != 0 THEN CONCAT('user_', user_id)
1229	WHEN user_identifier NOT LIKE 'Tech-Savvy User'
1230	AND user_identifier NOT LIKE 'Detail-Oriented User'
1231	AND user_identifier NOT LIKE 'Language Learner'
1232	AND user_identifier NOT LIKE 'Casual Browser'
1233	AND user_identifier NOT LIKE 'Policy Enforcer'
1234	AND user_identifier NOT LIKE 'Researcher'
1235	AND user_identifier NOT LIKE 'Loyalty Member'
1236	AND user_identifier NOT LIKE 'Gift Buyer'
1237	AND user_identifier NOT LIKE 'Parent or Caregiver'
1238	THEN user_identifier
1239	ELSE session_id
1240	END
1241	)
1242	FROM $table_name
1243	WHERE role != 'assistant'
1244	");
1245
1246	// Get user type breakdown
1247	$registered_users = $wpdb->get_var("
1248	SELECT COUNT(DISTINCT user_email)
1249	FROM $table_name
1250	WHERE user_email != '' AND user_email IS NOT NULL
1251	");
1252
1253	$guest_users = $wpdb->get_var("
1254	SELECT COUNT(DISTINCT user_identifier)
1255	FROM $table_name
1256	WHERE (user_email = '' OR user_email IS NULL)
1257	AND role != 'assistant'
1258	AND user_identifier NOT LIKE 'Tech-Savvy User'
1259	AND user_identifier NOT LIKE 'Detail-Oriented User'
1260	AND user_identifier NOT LIKE 'Language Learner'
1261	AND user_identifier NOT LIKE 'Casual Browser'
1262	AND user_identifier NOT LIKE 'Policy Enforcer'
1263	AND user_identifier NOT LIKE 'Researcher'
1264	AND user_identifier NOT LIKE 'Loyalty Member'
1265	AND user_identifier NOT LIKE 'Gift Buyer'
1266	AND user_identifier NOT LIKE 'Parent or Caregiver'
1267	");
1268
1269	// Get agent test messages count
1270	$agent_tests = $wpdb->get_var("
1271	SELECT COUNT(DISTINCT session_id)
1272	FROM $table_name
1273	WHERE user_identifier IN (
1274	'Tech-Savvy User',
1275	'Detail-Oriented User',
1276	'Language Learner',
1277	'Casual Browser',
1278	'Policy Enforcer',
1279	'Researcher',
1280	'Loyalty Member',
1281	'Gift Buyer',
1282	'Parent or Caregiver'
1283	)
1284	");
1285	// Get activity metrics
1286	$today_chats = $wpdb->get_var("
1287	SELECT COUNT(DISTINCT session_id)
1288	FROM $table_name
1289	WHERE DATE(timestamp) = CURDATE()
1290	");
1291
1292	$week_chats = $wpdb->get_var("
1293	SELECT COUNT(DISTINCT session_id)
1294	FROM $table_name
1295	WHERE timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
1296	");
1297
1298	$month_chats = $wpdb->get_var("
1299	SELECT COUNT(DISTINCT session_id)
1300	FROM $table_name
1301	WHERE timestamp >= DATE_SUB(NOW(), INTERVAL 30 DAY)
1302	");
1303
1304	// Get daily chat data for last 7 days
1305	$daily_stats = $wpdb->get_results("
1306	SELECT
1307	DATE(timestamp) as date,
1308	COUNT(DISTINCT session_id) as chats,
1309	COUNT(*) as messages
1310	FROM $table_name
1311	WHERE timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
1312	GROUP BY DATE(timestamp)
1313	ORDER BY date ASC
1314	");
1315
1316	// Get average messages per chat
1317	$avg_messages = $wpdb->get_var("
1318	SELECT AVG(message_count)
1319	FROM (
1320	SELECT session_id, COUNT(*) as message_count
1321	FROM $table_name
1322	GROUP BY session_id
1323	) as chat_counts
1324	");
1325	$avg_messages = $avg_messages ? round($avg_messages, 1) : 0;
1326
1327	// Get busiest hour
1328	$busiest_hour = $wpdb->get_row("
1329	SELECT HOUR(timestamp) as hour, COUNT(DISTINCT session_id) as chat_count
1330	FROM $table_name
1331	GROUP BY HOUR(timestamp)
1332	ORDER BY chat_count DESC
1333	LIMIT 1
1334	");
1335
1336	// Prepare chart data
1337	$chart_labels = array();
1338	$chart_chats = array();
1339	$chart_messages = array();
1340
1341	// Fill last 7 days with data
1342	for ($i = 6; $i >= 0; $i--) {
1343	$date = date('Y-m-d', strtotime("-$i days"));
1344	$day_name = date('D', strtotime("-$i days"));
1345	$chart_labels[] = $day_name;
1346
1347	$found = false;
1348	foreach ($daily_stats as $stat) {
1349	if ($stat->date === $date) {
1350	$chart_chats[] = (int)$stat->chats;
1351	$chart_messages[] = (int)$stat->messages;
1352	$found = true;
1353	break;
1354	}
1355	}
1356	if (!$found) {
1357	$chart_chats[] = 0;
1358	$chart_messages[] = 0;
1359	}
1360	}
1361
1362	// Satisfaction rating rollup — last 30 days, grouped by bot (plan-a5b006).
1363	$satisfaction_stats = $this->get_satisfaction_rating_stats(30);
1364
1365	// Prepare page data for the template
1366	$page_data = array(
1367	'total_chats' => $total_chats,
1368	'total_messages' => $total_messages,
1369	'total_users' => $total_users,
1370	'registered_users' => $registered_users,
1371	'guest_users' => $guest_users,
1372	'agent_tests' => $agent_tests,
1373	'today_chats' => $today_chats,
1374	'week_chats' => $week_chats,
1375	'month_chats' => $month_chats,
1376	'avg_messages' => $avg_messages,
1377	'busiest_hour' => $busiest_hour,
1378	'chart_labels' => $chart_labels,
1379	'chart_chats' => $chart_chats,
1380	'chart_messages' => $chart_messages,
1381	'satisfaction_stats' => $satisfaction_stats,
1382	);
1383
1384	// Include and render the new template
1385	require_once plugin_dir_path(__FILE__) . 'admin-transcripts-page.php';
1386	mxchat_render_transcripts_page($this, $page_data);
1387	}
1388
1389	/**
1390	* Per-bot satisfaction rating rollup over the last $days days. Used by the
1391	* Satisfaction card on the Transcripts dashboard (plan-a5b006).
1392	*
1393	* @param int $days Window in days.
1394	* @return array Each entry: ['bot_id', 'total', 'positive', 'negative', 'positive_pct', 'negative_pct'].
1395	*/
1396	public function get_satisfaction_rating_stats($days = 30) {
1397	global $wpdb;
1398	$table = $wpdb->prefix . 'mxchat_session_ratings';
1399	if ($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $table)) !== $table) {
1400	return array();
1401	}
1402	$days = max(1, (int) $days);
1403	$rows = $wpdb->get_results($wpdb->prepare(
1404	"SELECT bot_id,
1405	COUNT(*) AS total,
1406	SUM(CASE WHEN rating_value = 1 THEN 1 ELSE 0 END) AS positive,
1407	SUM(CASE WHEN rating_value = -1 THEN 1 ELSE 0 END) AS negative
1408	FROM {$table}
1409	WHERE created_at >= DATE_SUB(NOW(), INTERVAL %d DAY)
1410	GROUP BY bot_id
1411	ORDER BY total DESC",
1412	$days
1413	));
1414	$out = array();
1415	foreach ((array) $rows as $row) {
1416	$total = (int) $row->total;
1417	$positive = (int) $row->positive;
1418	$negative = (int) $row->negative;
1419	$out[] = array(
1420	'bot_id' => $row->bot_id ?: 'default',
1421	'total' => $total,
1422	'positive' => $positive,
1423	'negative' => $negative,
1424	'positive_pct' => $total > 0 ? (int) round(($positive / $total) * 100) : 0,
1425	'negative_pct' => $total > 0 ? (int) round(($negative / $total) * 100) : 0,
1426	);
1427	}
1428	return $out;
1429	}
1430
1431	/**
1432	* Get chart data for transcripts page
1433	* Used by both page render and script localization
1434	*
1435	* @return array Chart data with labels, chats, and messages arrays
1436	*/
1437	private function get_transcripts_chart_data() {
1438	global $wpdb;
1439	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
1440
1441	// Get daily chat data for last 7 days - same query as mxchat_transcripts_page()
1442	$daily_stats = $wpdb->get_results("
1443	SELECT
1444	DATE(timestamp) as date,
1445	COUNT(DISTINCT session_id) as chats,
1446	COUNT(*) as messages
1447	FROM $table_name
1448	WHERE timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
1449	GROUP BY DATE(timestamp)
1450	ORDER BY date ASC
1451	");
1452
1453	// Prepare chart data
1454	$chart_labels = array();
1455	$chart_chats = array();
1456	$chart_messages = array();
1457
1458	// Fill last 7 days with data - same logic as mxchat_transcripts_page()
1459	for ($i = 6; $i >= 0; $i--) {
1460	$date = date('Y-m-d', strtotime("-$i days"));
1461	$day_name = date('D', strtotime("-$i days"));
1462	$chart_labels[] = $day_name;
1463
1464	$found = false;
1465	if ($daily_stats) {
1466	foreach ($daily_stats as $stat) {
1467	if ($stat->date === $date) {
1468	$chart_chats[] = (int)$stat->chats;
1469	$chart_messages[] = (int)$stat->messages;
1470	$found = true;
1471	break;
1472	}
1473	}
1474	}
1475	if (!$found) {
1476	$chart_chats[] = 0;
1477	$chart_messages[] = 0;
1478	}
1479	}
1480
1481	return array(
1482	'labels' => $chart_labels,
1483	'chats' => $chart_chats,
1484	'messages' => $chart_messages
1485	);
1486	}
1487
1488	public function mxchat_transcripts_notification_section_callback() {
1489	echo '<p>' . esc_html__('Configure email notifications for new chat transcripts. You will receive an email notification when a new chat session begins.', 'mxchat') . '</p>';
1490	}
1491	public function mxchat_enable_notifications_callback() {
1492	$options = get_option('mxchat_transcripts_options', array());
1493	$enabled = isset($options['mxchat_enable_notifications']) ? $options['mxchat_enable_notifications'] : 0;
1494	?>
1495	<label for="mxchat_enable_notifications">
1496	<input type="checkbox" id="mxchat_enable_notifications"
1497	name="mxchat_transcripts_options[mxchat_enable_notifications]"
1498	value="1" <?php checked(1, $enabled); ?>>
1499	<?php esc_html_e('Send email notification when a new chat session starts', 'mxchat'); ?>
1500	</label>
1501	<p class="description">
1502	<?php esc_html_e('Enable this option to receive email notifications for new chat sessions.', 'mxchat'); ?>
1503	</p>
1504	<?php
1505	}
1506	public function mxchat_notification_email_callback() {
1507	$options = get_option('mxchat_transcripts_options', array());
1508	$email = isset($options['mxchat_notification_email']) ? $options['mxchat_notification_email'] : get_option('admin_email');
1509	?>
1510	<input type="email" id="mxchat_notification_email"
1511	name="mxchat_transcripts_options[mxchat_notification_email]"
1512	value="<?php echo esc_attr($email); ?>"
1513	class="regular-text">
1514	<p class="description">
1515	<?php esc_html_e('Enter the email address where notifications should be sent. Defaults to the admin email address.', 'mxchat'); ?>
1516	</p>
1517	<?php
1518	}
1519
1520	public function mxchat_auto_delete_transcripts_callback() {
1521	$options = get_option('mxchat_transcripts_options', array());
1522	$interval = isset($options['mxchat_auto_delete_transcripts']) ? $options['mxchat_auto_delete_transcripts'] : 'never';
1523	?>
1524	<select id="mxchat_auto_delete_transcripts"
1525	name="mxchat_transcripts_options[mxchat_auto_delete_transcripts]">
1526	<option value="never" <?php selected($interval, 'never'); ?>>
1527	<?php esc_html_e('Never (Keep All Transcripts)', 'mxchat'); ?>
1528	</option>
1529	<option value="1week" <?php selected($interval, '1week'); ?>>
1530	<?php esc_html_e('After 1 Week', 'mxchat'); ?>
1531	</option>
1532	<option value="2weeks" <?php selected($interval, '2weeks'); ?>>
1533	<?php esc_html_e('After 2 Weeks', 'mxchat'); ?>
1534	</option>
1535	<option value="1month" <?php selected($interval, '1month'); ?>>
1536	<?php esc_html_e('After 1 Month', 'mxchat'); ?>
1537	</option>
1538	</select>
1539	<p class="description">
1540	<?php esc_html_e('Automatically delete old chat transcripts after the selected time period. This helps manage database size and privacy.', 'mxchat'); ?>
1541	</p>
1542	<?php
1543	}
1544
1545	/**
1546	* Custom retention-days input. When > 0 it overrides the bucket dropdown above
1547	* and deletes transcripts older than the given number of days. Set to 0 to fall
1548	* back to the dropdown (or "Never" if the dropdown is also Never).
1549	*
1550	* Devs can override the final day count via the `mxchat_transcript_retention_days`
1551	* filter — runs in `cleanup_old_transcripts()` after this option is read.
1552	*
1553	* (plan-mxchat-20260509-9b80b1)
1554	*/
1555	public function mxchat_retention_days_callback() {
1556	$options = get_option('mxchat_transcripts_options', array());
1557	$days = isset($options['mxchat_retention_days']) ? (int) $options['mxchat_retention_days'] : 0;
1558	?>
1559	<input type="number"
1560	id="mxchat_retention_days"
1561	name="mxchat_transcripts_options[mxchat_retention_days]"
1562	value="<?php echo esc_attr($days); ?>"
1563	min="0"
1564	max="3650"
1565	step="1"
1566	style="width: 90px;" />
1567	<p class="description">
1568	<?php esc_html_e('Number of days to retain transcripts. When set to a value greater than 0, this overrides the dropdown above. Set to 0 to use the dropdown. Maximum 3650 (10 years). A daily wp-cron task removes anything older, cascading to translations and click-tracking rows.', 'mxchat'); ?>
1569	<br>
1570	<code>apply_filters( 'mxchat_transcript_retention_days', $days )</code>
1571	<?php esc_html_e('lets developers override the final day count programmatically.', 'mxchat'); ?>
1572	</p>
1573	<?php
1574	}
1575
1576	public function mxchat_auto_email_transcript_callback() {
1577	$options = get_option('mxchat_transcripts_options', array());
1578	$enabled = isset($options['mxchat_auto_email_transcript_enabled']) ? $options['mxchat_auto_email_transcript_enabled'] : 0;
1579	$delay = isset($options['mxchat_auto_email_transcript_delay']) ? $options['mxchat_auto_email_transcript_delay'] : '30';
1580	$require_contact = isset($options['mxchat_auto_email_transcript_require_contact']) ? $options['mxchat_auto_email_transcript_require_contact'] : 0;
1581	?>
1582	<label>
1583	<input type="checkbox"
1584	id="mxchat_auto_email_transcript_enabled"
1585	name="mxchat_transcripts_options[mxchat_auto_email_transcript_enabled]"
1586	value="1"
1587	<?php checked($enabled, 1); ?>>
1588	<?php esc_html_e('Enable Auto-Email of Full Transcript', 'mxchat'); ?>
1589	</label>
1590	<br><br>
1591	<label for="mxchat_auto_email_transcript_delay">
1592	<?php esc_html_e('Send transcript after:', 'mxchat'); ?>
1593	</label>
1594	<select id="mxchat_auto_email_transcript_delay"
1595	name="mxchat_transcripts_options[mxchat_auto_email_transcript_delay]">
1596	<option value="15" <?php selected($delay, '15'); ?>>
1597	<?php esc_html_e('15 minutes', 'mxchat'); ?>
1598	</option>
1599	<option value="30" <?php selected($delay, '30'); ?>>
1600	<?php esc_html_e('30 minutes', 'mxchat'); ?>
1601	</option>
1602	<option value="60" <?php selected($delay, '60'); ?>>
1603	<?php esc_html_e('1 hour', 'mxchat'); ?>
1604	</option>
1605	</select>
1606	<br><br>
1607	<label>
1608	<input type="checkbox"
1609	id="mxchat_auto_email_transcript_require_contact"
1610	name="mxchat_transcripts_options[mxchat_auto_email_transcript_require_contact]"
1611	value="1"
1612	<?php checked($require_contact, 1); ?>>
1613	<?php esc_html_e('Only send if visitor provided contact info', 'mxchat'); ?>
1614	</label>
1615	<p class="description">
1616	<?php esc_html_e('Automatically email the full transcript as a .txt file after the specified time has passed since the last user message. The scheduled email will be cancelled if a new message is received.', 'mxchat'); ?>
1617	<br>
1618	<?php esc_html_e('When "Only send if visitor provided contact info" is enabled, transcripts will only be emailed if the visitor shared an email address or phone number (including WhatsApp) in the chat.', 'mxchat'); ?>
1619	</p>
1620	<?php
1621	}
1622
1623
1624
1625	public function sanitize_transcripts_options($input) {
1626	$sanitized = array();
1627
1628	$sanitized['mxchat_enable_notifications'] = isset($input['mxchat_enable_notifications']) ? 1 : 0;
1629
1630	if (isset($input['mxchat_notification_email'])) {
1631	$sanitized['mxchat_notification_email'] = sanitize_email($input['mxchat_notification_email']);
1632	if (!is_email($sanitized['mxchat_notification_email'])) {
1633	add_settings_error(
1634	'mxchat_transcripts_options',
1635	'invalid_email',
1636	__('Please enter a valid email address for notifications.', 'mxchat'),
1637	'error'
1638	);
1639	$sanitized['mxchat_notification_email'] = get_option('admin_email');
1640	}
1641	}
1642
1643	// Sanitize auto-delete setting
1644	$valid_intervals = array('never', '1week', '2weeks', '1month');
1645	if (isset($input['mxchat_auto_delete_transcripts'])) {
1646	$sanitized['mxchat_auto_delete_transcripts'] = in_array($input['mxchat_auto_delete_transcripts'], $valid_intervals)
1647	? $input['mxchat_auto_delete_transcripts']
1648	: 'never';
1649	} else {
1650	$sanitized['mxchat_auto_delete_transcripts'] = 'never';
1651	}
1652
1653	// Sanitize custom retention-days override (plan-9b80b1).
1654	if (isset($input['mxchat_retention_days'])) {
1655	$days = (int) $input['mxchat_retention_days'];
1656	$sanitized['mxchat_retention_days'] = max(0, min(3650, $days));
1657	} else {
1658	$sanitized['mxchat_retention_days'] = 0;
1659	}
1660
1661	// Get old values to check if auto-delete or retention-days changed.
1662	$old_options = get_option('mxchat_transcripts_options');
1663	$old_interval = isset($old_options['mxchat_auto_delete_transcripts']) ? $old_options['mxchat_auto_delete_transcripts'] : 'never';
1664	$old_retention = isset($old_options['mxchat_retention_days']) ? (int) $old_options['mxchat_retention_days'] : 0;
1665
1666	// If either setting changed, reschedule the cron job. The schedule_transcript_cleanup
1667	// helper now treats "any active retention" (dropdown != never OR custom days > 0) as a
1668	// reason to keep the daily cron registered.
1669	$interval_changed = ($old_interval !== $sanitized['mxchat_auto_delete_transcripts']);
1670	$retention_changed = ($old_retention !== $sanitized['mxchat_retention_days']);
1671	if ($interval_changed \|\| $retention_changed) {
1672	$any_active = ($sanitized['mxchat_auto_delete_transcripts'] !== 'never') \|\| ($sanitized['mxchat_retention_days'] > 0);
1673	$this->schedule_transcript_cleanup($any_active ? 'active' : 'never');
1674	}
1675
1676	// Sanitize auto-email transcript settings
1677	$sanitized['mxchat_auto_email_transcript_enabled'] = isset($input['mxchat_auto_email_transcript_enabled']) ? 1 : 0;
1678
1679	$valid_delays = array('15', '30', '60');
1680	if (isset($input['mxchat_auto_email_transcript_delay'])) {
1681	$sanitized['mxchat_auto_email_transcript_delay'] = in_array($input['mxchat_auto_email_transcript_delay'], $valid_delays)
1682	? $input['mxchat_auto_email_transcript_delay']
1683	: '30';
1684	} else {
1685	$sanitized['mxchat_auto_email_transcript_delay'] = '30';
1686	}
1687
1688	// Sanitize require contact info setting
1689	$sanitized['mxchat_auto_email_transcript_require_contact'] = isset($input['mxchat_auto_email_transcript_require_contact']) ? 1 : 0;
1690
1691	return $sanitized;
1692	}
1693
1694	/**
1695	* Schedule or unschedule the transcript cleanup cron job
1696	*/
1697	public function schedule_transcript_cleanup($interval) {
1698	// Clear any existing scheduled event
1699	$timestamp = wp_next_scheduled('mxchat_cleanup_old_transcripts');
1700	if ($timestamp) {
1701	wp_unschedule_event($timestamp, 'mxchat_cleanup_old_transcripts');
1702	}
1703
1704	// Schedule new event whenever retention is active. "active" is the canonical
1705	// value passed by sanitize_transcripts_options when either the dropdown != never
1706	// OR the custom retention-days > 0; "never" turns the cron off. Any other value
1707	// (the legacy "1week" / "2weeks" / "1month" strings) is also treated as active.
1708	if ($interval !== 'never') {
1709	// Schedule to run daily at 3 AM
1710	$next_run = strtotime('tomorrow 3:00 AM');
1711	wp_schedule_event($next_run, 'daily', 'mxchat_cleanup_old_transcripts');
1712	}
1713	}
1714
1715	/**
1716	* Delete old transcripts based on the configured interval
1717	*/
1718	public function cleanup_old_transcripts() {
1719	$options = get_option('mxchat_transcripts_options', array());
1720	$interval = isset($options['mxchat_auto_delete_transcripts']) ? $options['mxchat_auto_delete_transcripts'] : 'never';
1721	$custom_days = isset($options['mxchat_retention_days']) ? (int) $options['mxchat_retention_days'] : 0;
1722
1723	// Custom retention-days (plan-9b80b1) takes precedence over the bucket dropdown.
1724	$days = 0;
1725	if ($custom_days > 0) {
1726	$days = $custom_days;
1727	} else {
1728	switch ($interval) {
1729	case '1week': $days = 7; break;
1730	case '2weeks': $days = 14; break;
1731	case '1month': $days = 30; break;
1732	case 'never':
1733	default:
1734	$days = 0;
1735	}
1736	}
1737
1738	// Devs can override the final day count programmatically.
1739	$days = (int) apply_filters('mxchat_transcript_retention_days', $days);
1740
1741	if ($days <= 0) {
1742	return; // Retention disabled — bail.
1743	}
1744
1745	global $wpdb;
1746	$transcripts_table = $wpdb->prefix . 'mxchat_chat_transcripts';
1747	$translations_table = $wpdb->prefix . 'mxchat_transcript_translations';
1748	$url_clicks_table = $wpdb->prefix . 'mxchat_url_clicks';
1749
1750	// Defensive: if the main table doesn't exist (fresh-ish install), bail.
1751	if ($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $transcripts_table)) !== $transcripts_table) {
1752	return;
1753	}
1754
1755	$cutoff_date = gmdate('Y-m-d H:i:s', time() - ($days * DAY_IN_SECONDS));
1756
1757	// Cap at 5000 session_ids per run so a large unattended site doesn't OOM —
1758	// the cron will pick up where it left off on the next tick (within hours).
1759	$batch_cap = (int) apply_filters('mxchat_transcript_retention_batch_cap', 5000);
1760
1761	$sessions_to_delete = $wpdb->get_col(
1762	$wpdb->prepare(
1763	"SELECT DISTINCT session_id FROM {$transcripts_table} WHERE timestamp IS NOT NULL AND timestamp < %s LIMIT %d",
1764	$cutoff_date,
1765	$batch_cap
1766	)
1767	);
1768
1769	if (empty($sessions_to_delete)) {
1770	return;
1771	}
1772
1773	$placeholders = implode(',', array_fill(0, count($sessions_to_delete), '%s'));
1774
1775	// phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared
1776	// $placeholders is a server-built list of literal "%s" tokens.
1777	$deleted_transcripts = (int) $wpdb->query(
1778	$wpdb->prepare(
1779	"DELETE FROM {$transcripts_table} WHERE session_id IN ($placeholders)",
1780	$sessions_to_delete
1781	)
1782	);
1783
1784	if ($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $translations_table)) === $translations_table) {
1785	$wpdb->query(
1786	$wpdb->prepare(
1787	"DELETE FROM {$translations_table} WHERE session_id IN ($placeholders)",
1788	$sessions_to_delete
1789	)
1790	);
1791	}
1792
1793	if ($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $url_clicks_table)) === $url_clicks_table) {
1794	$wpdb->query(
1795	$wpdb->prepare(
1796	"DELETE FROM {$url_clicks_table} WHERE session_id IN ($placeholders)",
1797	$sessions_to_delete
1798	)
1799	);
1800	}
1801	// phpcs:enable
1802
1803	update_option('mxchat_retention_last_swept_at', time(), false);
1804	update_option('mxchat_retention_rows_last_deleted', $deleted_transcripts, false);
1805	}
1806
1807	public function export_chat_transcripts() {
1808	if (!current_user_can('manage_options')) {
1809	wp_die(esc_html__('You do not have sufficient permissions to access this page.', 'mxchat'));
1810	}
1811
1812	check_ajax_referer('mxchat_export_transcripts', 'security');
1813
1814	global $wpdb;
1815	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
1816
1817	// Get all transcripts ordered by session and timestamp
1818	$results = $wpdb->get_results(
1819	"SELECT session_id, user_email, user_identifier, role, message, timestamp
1820	FROM {$table_name}
1821	ORDER BY session_id, timestamp ASC"
1822	);
1823
1824	if (empty($results)) {
1825	wp_send_json_error(array('message' => 'No transcripts found.'));
1826	wp_die();
1827	}
1828
1829	// Set headers for CSV download
1830	header('Content-Type: text/csv');
1831	header('Content-Disposition: attachment; filename="chat-transcripts-' . date('Y-m-d') . '.csv"');
1832	header('Pragma: no-cache');
1833	header('Expires: 0');
1834
1835	// Create output stream
1836	$output = fopen('php://output', 'w');
1837
1838	// Add UTF-8 BOM for proper Excel encoding
1839	fputs($output, "\xEF\xBB\xBF");
1840
1841	// Add CSV headers
1842	fputcsv($output, array(
1843	'Session ID',
1844	'Email',
1845	'User Identifier',
1846	'Role',
1847	'Message',
1848	'Timestamp'
1849	));
1850
1851	// Add data rows
1852	foreach ($results as $row) {
1853	fputcsv($output, array(
1854	$row->session_id,
1855	$row->user_email,
1856	$row->user_identifier,
1857	$row->role,
1858	$row->message,
1859	$row->timestamp
1860	));
1861	}
1862
1863	fclose($output);
1864	wp_die();
1865	}
1866
1867	// ============================================================================
1868	// Leads tab (inside Transcripts)
1869	//
1870	// Leads are derived from existing data — no dedicated table. Primary source:
1871	// wp_mxchat_chat_transcripts rows where user_email is populated. Secondary
1872	// source: wp_options entries `mxchat_email_{session_id}` / `mxchat_name_{sid}`
1873	// for "orphan" leads who submitted the pre-chat form but never chatted.
1874	// ============================================================================
1875
1876	/**
1877	* Fetch leads: dedup-by-email rows, stats strip, and top pages in one call.
1878	*/
1879	public function mxchat_fetch_leads() {
1880	if (!current_user_can('manage_options')) {
1881	wp_send_json_error(['message' => 'Insufficient permissions']);
1882	wp_die();
1883	}
1884
1885	global $wpdb;
1886	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
1887
1888	$page = isset($_POST['page']) ? max(1, absint($_POST['page'])) : 1;
1889	$per_page = isset($_POST['per_page']) ? min(100, max(10, absint($_POST['per_page']))) : 25;
1890	$offset = ($page - 1) * $per_page;
1891	$search = isset($_POST['search']) ? sanitize_text_field(wp_unslash($_POST['search'])) : '';
1892	$date_range = isset($_POST['date_range']) ? sanitize_key($_POST['date_range']) : 'all';
1893	$status = isset($_POST['status']) ? sanitize_key($_POST['status']) : 'all';
1894	$page_filter = isset($_POST['page_url']) ? esc_url_raw(wp_unslash($_POST['page_url'])) : '';
1895	$sort = isset($_POST['sort']) ? sanitize_key($_POST['sort']) : 'last_seen';
1896	$sort_dir = (isset($_POST['sort_dir']) && $_POST['sort_dir'] === 'asc') ? 'ASC' : 'DESC';
1897
1898	$date_cutoff = self::mxchat_leads_date_cutoff($date_range);
1899	$has_page_url_column = !empty($wpdb->get_results("SHOW COLUMNS FROM $table LIKE 'originating_page_url'"));
1900
1901	// Base WHERE for transcripts leads.
1902	$where_clauses = ["user_email IS NOT NULL", "user_email != ''"];
1903	$where_params = [];
1904
1905	if ($date_cutoff) {
1906	$where_clauses[] = 'timestamp >= %s';
1907	$where_params[] = $date_cutoff;
1908	}
1909	if ($page_filter && $has_page_url_column) {
1910	$where_clauses[] = 'originating_page_url = %s';
1911	$where_params[] = $page_filter;
1912	}
1913	if ($search !== '') {
1914	$like = '%' . $wpdb->esc_like($search) . '%';
1915	$where_clauses[] = '(user_email LIKE %s OR user_name LIKE %s)';
1916	$where_params[] = $like;
1917	$where_params[] = $like;
1918	}
1919	$where_sql = 'WHERE ' . implode(' AND ', $where_clauses);
1920
1921	// Aggregate query grouped by email.
1922	$select_sql = $has_page_url_column
1923	? "SELECT user_email, MAX(timestamp) AS last_seen, MIN(timestamp) AS first_seen,
1924	COUNT(DISTINCT session_id) AS conversation_count"
1925	: "SELECT user_email, MAX(timestamp) AS last_seen, MIN(timestamp) AS first_seen,
1926	COUNT(DISTINCT session_id) AS conversation_count";
1927
1928	$order_column = in_array($sort, ['last_seen', 'conversation_count', 'first_seen'], true) ? $sort : 'last_seen';
1929	$group_order_limit = " GROUP BY user_email ORDER BY {$order_column} {$sort_dir} LIMIT %d OFFSET %d";
1930
1931	$transcripts_sql = $wpdb->prepare(
1932	"{$select_sql} FROM {$table} {$where_sql}{$group_order_limit}",
1933	array_merge($where_params, [$per_page, $offset])
1934	);
1935	$transcript_rows = $wpdb->get_results($transcripts_sql);
1936
1937	// Count of unique transcript-based leads under the same filters.
1938	$count_sql = $wpdb->prepare(
1939	"SELECT COUNT(DISTINCT user_email) FROM {$table} {$where_sql}",
1940	$where_params
1941	);
1942	$transcripts_lead_count = (int) $wpdb->get_var($count_sql);
1943
1944	// Hydrate each row: name, latest_session_id, top page.
1945	$leads = [];
1946	foreach ($transcript_rows as $row) {
1947	$detail = $has_page_url_column
1948	? $wpdb->get_row($wpdb->prepare(
1949	"SELECT session_id, user_name, originating_page_url, originating_page_title
1950	FROM {$table} WHERE user_email = %s ORDER BY timestamp DESC LIMIT 1",
1951	$row->user_email
1952	))
1953	: $wpdb->get_row($wpdb->prepare(
1954	"SELECT session_id, user_name FROM {$table}
1955	WHERE user_email = %s ORDER BY timestamp DESC LIMIT 1",
1956	$row->user_email
1957	));
1958
1959	$leads[] = [
1960	'email' => $row->user_email,
1961	'name' => isset($detail->user_name) ? (string) $detail->user_name : '',
1962	'conversation_count' => (int) $row->conversation_count,
1963	'last_seen' => $row->last_seen,
1964	'last_seen_display' => self::mxchat_leads_format_relative($row->last_seen),
1965	'first_seen' => $row->first_seen,
1966	'latest_session_id' => isset($detail->session_id) ? $detail->session_id : '',
1967	'top_page_url' => isset($detail->originating_page_url) ? $detail->originating_page_url : '',
1968	'top_page_title' => isset($detail->originating_page_title) ? $detail->originating_page_title : '',
1969	'is_orphan' => false,
1970	'status' => 'active',
1971	];
1972	}
1973
1974	// Non-transcript lead sources. Built once here, then filtered/merged based on the
1975	// status filter below. Deduplication priority when the same email appears in multiple
1976	// sources: transcripts > chat_deleted > orphan.
1977	$transcripts_emails_seen = array_flip(array_map(
1978	function ($r) { return strtolower($r['email']); },
1979	$leads
1980	));
1981
1982	// Chat-deleted leads: had a conversation that an admin removed. Preserved via
1983	// mxchat_lead_del_* options, with timestamps so they respect date filters.
1984	$chat_deleted_leads_all = [];
1985	if ($status === 'all' \|\| $status === 'chat_deleted') {
1986	$chat_deleted_leads_all = self::mxchat_collect_chat_deleted_leads($search, $date_cutoff);
1987	// Dedup: drop any chat_deleted row whose email is already in the transcripts set.
1988	$chat_deleted_leads_all = array_values(array_filter(
1989	$chat_deleted_leads_all,
1990	function ($row) use ($transcripts_emails_seen) {
1991	return !isset($transcripts_emails_seen[strtolower($row['email'])]);
1992	}
1993	));
1994	foreach ($chat_deleted_leads_all as $row) {
1995	$transcripts_emails_seen[strtolower($row['email'])] = true;
1996	}
1997	}
1998
1999	// Orphans: pre-chat form captures with no conversation. No timestamp, so skipped
2000	// when a date filter is active.
2001	$orphan_leads_all = [];
2002	if (($status === 'all' \|\| $status === 'orphan') && !$date_cutoff && !$page_filter) {
2003	$orphan_leads_all = self::mxchat_collect_orphan_leads($search);
2004	$orphan_leads_all = array_values(array_filter(
2005	$orphan_leads_all,
2006	function ($row) use ($transcripts_emails_seen) {
2007	return !isset($transcripts_emails_seen[strtolower($row['email'])]);
2008	}
2009	));
2010	}
2011
2012	// Apply status filter to the transcripts-derived list.
2013	if ($status === 'orphan' \|\| $status === 'chat_deleted') {
2014	$leads = [];
2015	$transcripts_lead_count = 0;
2016	}
2017
2018	// Stitch the current page from the three buckets in priority order.
2019	$total_count = $transcripts_lead_count + count($chat_deleted_leads_all) + count($orphan_leads_all);
2020	$remaining_slots = $per_page - count($leads);
2021
2022	if ($remaining_slots > 0 && !empty($chat_deleted_leads_all)) {
2023	$start = max(0, ($page - 1) * $per_page - $transcripts_lead_count);
2024	if ($start < count($chat_deleted_leads_all)) {
2025	$leads = array_merge($leads, array_slice($chat_deleted_leads_all, $start, $remaining_slots));
2026	$remaining_slots = $per_page - count($leads);
2027	}
2028	}
2029
2030	if ($remaining_slots > 0 && !empty($orphan_leads_all)) {
2031	$before = $transcripts_lead_count + count($chat_deleted_leads_all);
2032	$start = max(0, ($page - 1) * $per_page - $before);
2033	if ($start < count($orphan_leads_all)) {
2034	$leads = array_merge($leads, array_slice($orphan_leads_all, $start, $remaining_slots));
2035	}
2036	}
2037
2038	$total_pages = $per_page > 0 ? (int) ceil($total_count / $per_page) : 1;
2039
2040	// Stats strip: always computed over full dataset, unaffected by filters.
2041	$stats = self::mxchat_leads_stats($table, $has_page_url_column);
2042
2043	// Top pages: top 5 by distinct emails captured.
2044	$top_pages = [];
2045	if ($has_page_url_column) {
2046	$top_pages_rows = $wpdb->get_results(
2047	"SELECT originating_page_url AS url,
2048	MAX(originating_page_title) AS title,
2049	COUNT(DISTINCT user_email) AS lead_count
2050	FROM {$table}
2051	WHERE user_email IS NOT NULL AND user_email != ''
2052	AND originating_page_url IS NOT NULL AND originating_page_url != ''
2053	GROUP BY originating_page_url
2054	ORDER BY lead_count DESC, url ASC
2055	LIMIT 5"
2056	);
2057	foreach ($top_pages_rows as $p) {
2058	$top_pages[] = [
2059	'url' => $p->url,
2060	'title' => $p->title ?: $p->url,
2061	'lead_count' => (int) $p->lead_count,
2062	];
2063	}
2064	}
2065
2066	wp_send_json([
2067	'success' => true,
2068	'leads' => $leads,
2069	'page' => $page,
2070	'per_page' => $per_page,
2071	'total_count' => $total_count,
2072	'total_pages' => $total_pages,
2073	'showing_start' => $total_count === 0 ? 0 : ($offset + 1),
2074	'showing_end' => min($offset + $per_page, $total_count),
2075	'stats' => $stats,
2076	'top_pages' => $top_pages,
2077	]);
2078	wp_die();
2079	}
2080
2081	/**
2082	* Delete one or more leads by email. Removes every transcripts row for that
2083	* email and cleans up related wp_options (mxchat_email_{sid}, mxchat_name_{sid},
2084	* mxchat_history_{sid}) and any orphan option entries matching the email.
2085	*/
2086	public function mxchat_delete_leads() {
2087	if (!current_user_can('manage_options')) {
2088	wp_send_json_error(['message' => 'Insufficient permissions']);
2089	wp_die();
2090	}
2091	check_ajax_referer('mxchat_delete_leads', 'security');
2092
2093	$emails_raw = isset($_POST['emails']) ? (array) wp_unslash($_POST['emails']) : [];
2094	$emails = [];
2095	foreach ($emails_raw as $e) {
2096	$clean = sanitize_email((string) $e);
2097	if ($clean) {
2098	$emails[] = $clean;
2099	}
2100	}
2101	if (empty($emails)) {
2102	wp_send_json_error(['message' => 'No emails provided']);
2103	wp_die();
2104	}
2105
2106	$summary = self::mxchat_wipe_leads_by_email($emails);
2107
2108	wp_send_json([
2109	'success' => true,
2110	'deleted_leads' => count($emails),
2111	'deleted_sessions' => $summary['deleted_sessions'],
2112	'deleted_rows' => $summary['deleted_rows'],
2113	]);
2114	wp_die();
2115	}
2116
2117	/**
2118	* Fully wipe one or more leads by email: every transcripts row, every related wp_options
2119	* entry (history, pre-chat capture, chat_deleted preservation, agent name, translations).
2120	*
2121	* Shared between the Leads-tab Delete button and the transcript-delete opt-in checkbox.
2122	* Input emails must already be sanitized with sanitize_email().
2123	*/
2124	private static function mxchat_wipe_leads_by_email(array $emails) {
2125	global $wpdb;
2126	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
2127	$translations_table = $wpdb->prefix . 'mxchat_transcript_translations';
2128	$has_translations = $wpdb->get_var("SHOW TABLES LIKE '$translations_table'") === $translations_table;
2129
2130	$deleted_sessions = 0;
2131	$deleted_rows = 0;
2132	$emails_lc = array_map('strtolower', $emails);
2133
2134	foreach ($emails as $email) {
2135	$session_ids = $wpdb->get_col($wpdb->prepare(
2136	"SELECT DISTINCT session_id FROM {$table} WHERE user_email = %s",
2137	$email
2138	));
2139
2140	$rows_removed = $wpdb->delete($table, ['user_email' => $email], ['%s']);
2141	if ($rows_removed !== false) {
2142	$deleted_rows += (int) $rows_removed;
2143	}
2144
2145	foreach ($session_ids as $sid) {
2146	$deleted_sessions++;
2147	wp_cache_delete('chat_session_' . $sid, 'mxchat_chat_sessions');
2148	delete_option('mxchat_history_' . $sid);
2149	delete_option('mxchat_email_' . $sid);
2150	delete_option('mxchat_name_' . $sid);
2151	delete_option('mxchat_agent_name_' . $sid);
2152	delete_option('mxchat_lead_del_email_' . $sid);
2153	delete_option('mxchat_lead_del_name_' . $sid);
2154	delete_option('mxchat_lead_del_ts_' . $sid);
2155	if ($has_translations) {
2156	$wpdb->delete($translations_table, ['session_id' => $sid], ['%s']);
2157	}
2158	}
2159	}
2160
2161	// Clean up any lingering option entries (orphan pre-chat captures + chat_deleted
2162	// preservations) whose stored value matches one of the emails being wiped.
2163	$lingering = $wpdb->get_results(
2164	"SELECT option_name, option_value FROM {$wpdb->options}
2165	WHERE option_name LIKE 'mxchat_email_%' OR option_name LIKE 'mxchat_lead_del_email_%'"
2166	);
2167	foreach ($lingering as $opt) {
2168	if (!in_array(strtolower(trim($opt->option_value)), $emails_lc, true)) {
2169	continue;
2170	}
2171	if (strpos($opt->option_name, 'mxchat_lead_del_email_') === 0) {
2172	$sid = substr($opt->option_name, strlen('mxchat_lead_del_email_'));
2173	delete_option('mxchat_lead_del_email_' . $sid);
2174	delete_option('mxchat_lead_del_name_' . $sid);
2175	delete_option('mxchat_lead_del_ts_' . $sid);
2176	} else {
2177	$sid = substr($opt->option_name, strlen('mxchat_email_'));
2178	delete_option('mxchat_email_' . $sid);
2179	delete_option('mxchat_name_' . $sid);
2180	}
2181	}
2182
2183	wp_cache_delete('all_chat_sessions', 'mxchat_chat_sessions');
2184
2185	return [
2186	'deleted_sessions' => $deleted_sessions,
2187	'deleted_rows' => $deleted_rows,
2188	];
2189	}
2190
2191	/**
2192	* Stream a leads CSV. scope=all exports every lead under current filters is not
2193	* supported to keep semantics simple; caller either exports all leads or a
2194	* specific set of selected emails.
2195	*/
2196	public function mxchat_export_leads() {
2197	if (!current_user_can('manage_options')) {
2198	wp_die(esc_html__('You do not have sufficient permissions to access this page.', 'mxchat'));
2199	}
2200	check_ajax_referer('mxchat_export_leads', 'security');
2201
2202	$scope = isset($_POST['scope']) ? sanitize_key($_POST['scope']) : 'all';
2203	$fields_mode = isset($_POST['fields']) ? sanitize_key($_POST['fields']) : 'email_and_name';
2204	$emails_in = isset($_POST['emails']) ? (array) wp_unslash($_POST['emails']) : [];
2205
2206	$emails_in_clean = [];
2207	foreach ($emails_in as $e) {
2208	$clean = sanitize_email((string) $e);
2209	if ($clean) {
2210	$emails_in_clean[] = $clean;
2211	}
2212	}
2213
2214	global $wpdb;
2215	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
2216	$has_page_url_column = !empty($wpdb->get_results("SHOW COLUMNS FROM $table LIKE 'originating_page_url'"));
2217
2218	// Collect leads from transcripts.
2219	$transcripts_sql = "SELECT user_email AS email,
2220	MAX(timestamp) AS last_seen,
2221	COUNT(DISTINCT session_id) AS conversation_count
2222	FROM {$table}
2223	WHERE user_email IS NOT NULL AND user_email != ''";
2224	$params = [];
2225	if ($scope === 'selected' && !empty($emails_in_clean)) {
2226	$placeholders = implode(',', array_fill(0, count($emails_in_clean), '%s'));
2227	$transcripts_sql .= " AND user_email IN ({$placeholders})";
2228	$params = $emails_in_clean;
2229	}
2230	$transcripts_sql .= " GROUP BY user_email ORDER BY last_seen DESC";
2231
2232	$rows = !empty($params)
2233	? $wpdb->get_results($wpdb->prepare($transcripts_sql, $params))
2234	: $wpdb->get_results($transcripts_sql);
2235
2236	// Hydrate each row with name + top page.
2237	$export_rows = [];
2238	foreach ($rows as $row) {
2239	$detail = $has_page_url_column
2240	? $wpdb->get_row($wpdb->prepare(
2241	"SELECT user_name, originating_page_url FROM {$table}
2242	WHERE user_email = %s ORDER BY timestamp DESC LIMIT 1",
2243	$row->email
2244	))
2245	: $wpdb->get_row($wpdb->prepare(
2246	"SELECT user_name FROM {$table}
2247	WHERE user_email = %s ORDER BY timestamp DESC LIMIT 1",
2248	$row->email
2249	));
2250	$export_rows[] = [
2251	'email' => $row->email,
2252	'name' => isset($detail->user_name) ? (string) $detail->user_name : '',
2253	'conversation_count' => (int) $row->conversation_count,
2254	'last_seen' => $row->last_seen,
2255	'top_page_url' => isset($detail->originating_page_url) ? $detail->originating_page_url : '',
2256	];
2257	}
2258
2259	// Include orphan + chat_deleted leads when exporting all.
2260	if ($scope === 'all') {
2261	$transcripts_emails_lc = array_flip(array_map(
2262	function ($r) { return strtolower($r['email']); },
2263	$export_rows
2264	));
2265	foreach (self::mxchat_collect_chat_deleted_leads('') as $cd) {
2266	if (isset($transcripts_emails_lc[strtolower($cd['email'])])) continue;
2267	$transcripts_emails_lc[strtolower($cd['email'])] = true;
2268	$export_rows[] = [
2269	'email' => $cd['email'],
2270	'name' => $cd['name'],
2271	'conversation_count' => 0,
2272	'last_seen' => $cd['last_seen'],
2273	'top_page_url' => '',
2274	];
2275	}
2276	foreach (self::mxchat_collect_orphan_leads('') as $orphan) {
2277	if (isset($transcripts_emails_lc[strtolower($orphan['email'])])) continue;
2278	$transcripts_emails_lc[strtolower($orphan['email'])] = true;
2279	$export_rows[] = [
2280	'email' => $orphan['email'],
2281	'name' => $orphan['name'],
2282	'conversation_count' => 0,
2283	'last_seen' => '',
2284	'top_page_url' => '',
2285	];
2286	}
2287	}
2288
2289	if (empty($export_rows)) {
2290	wp_send_json_error(['message' => 'No leads to export.']);
2291	wp_die();
2292	}
2293
2294	$filename = 'mxchat-leads-' . date('Y-m-d') . '.csv';
2295	header('Content-Type: text/csv');
2296	header('Content-Disposition: attachment; filename="' . $filename . '"');
2297	header('Pragma: no-cache');
2298	header('Expires: 0');
2299
2300	$output = fopen('php://output', 'w');
2301	fputs($output, "\xEF\xBB\xBF"); // UTF-8 BOM for Excel
2302
2303	if ($fields_mode === 'email_only') {
2304	fputcsv($output, ['Email']);
2305	foreach ($export_rows as $r) {
2306	fputcsv($output, [$r['email']]);
2307	}
2308	} else {
2309	fputcsv($output, ['Email', 'Name', 'Conversations', 'Last seen', 'Top page']);
2310	foreach ($export_rows as $r) {
2311	fputcsv($output, [
2312	$r['email'],
2313	$r['name'],
2314	$r['conversation_count'],
2315	$r['last_seen'],
2316	$r['top_page_url'],
2317	]);
2318	}
2319	}
2320
2321	fclose($output);
2322	wp_die();
2323	}
2324
2325	/**
2326	* Stats strip payload (independent of filters).
2327	*/
2328	private static function mxchat_leads_stats($table, $has_page_url_column) {
2329	global $wpdb;
2330
2331	$total_transcripts_emails = (int) $wpdb->get_var(
2332	"SELECT COUNT(DISTINCT user_email) FROM {$table}
2333	WHERE user_email IS NOT NULL AND user_email != ''"
2334	);
2335
2336	$new_this_week = (int) $wpdb->get_var($wpdb->prepare(
2337	"SELECT COUNT(*) FROM (
2338	SELECT user_email FROM {$table}
2339	WHERE user_email IS NOT NULL AND user_email != ''
2340	GROUP BY user_email
2341	HAVING MIN(timestamp) >= %s
2342	) AS new_leads",
2343	gmdate('Y-m-d H:i:s', strtotime('-7 days'))
2344	));
2345
2346	$total_convos = (int) $wpdb->get_var(
2347	"SELECT COUNT(DISTINCT session_id) FROM {$table}
2348	WHERE user_email IS NOT NULL AND user_email != ''"
2349	);
2350
2351	$orphan_count = count(self::mxchat_collect_orphan_leads(''));
2352	$chat_deleted_count = self::mxchat_count_chat_deleted_leads();
2353
2354	// Total leads = unique emails across all three sources (dedup priority: transcripts > chat_deleted > orphan
2355	// is already enforced at collection time in mxchat_fetch_leads; stats re-apply it here).
2356	$total_leads = $total_transcripts_emails + $chat_deleted_count + $orphan_count;
2357
2358	$avg = $total_transcripts_emails > 0
2359	? round($total_convos / $total_transcripts_emails, 1)
2360	: 0;
2361
2362	// Orphan % reflects true orphans only (pre-chat dropoffs). Chat-deleted leads are
2363	// excluded so the metric stays meaningful — admins shouldn't see their cleanups
2364	// inflate this number.
2365	$orphan_pct = $total_leads > 0
2366	? (int) round(($orphan_count / $total_leads) * 100)
2367	: 0;
2368
2369	return [
2370	'total_leads' => $total_leads,
2371	'new_this_week' => $new_this_week,
2372	'avg_convos' => $avg,
2373	'orphan_pct' => $orphan_pct,
2374	'orphan_count' => $orphan_count,
2375	'chat_deleted_count' => $chat_deleted_count,
2376	];
2377	}
2378
2379	/**
2380	* Collect leads who had a conversation that an admin later deleted (preserved via
2381	* mxchat_lead_del_* options). Returns rows tagged status='chat_deleted' with the
2382	* original last-seen timestamp so they still sort and filter sensibly.
2383	*
2384	* @param string $search Optional email/name substring filter.
2385	* @param string $date_cutoff Optional 'Y-m-d H:i:s' cutoff — only rows with last_ts >= cutoff.
2386	* @return array
2387	*/
2388	private static function mxchat_collect_chat_deleted_leads($search = '', $date_cutoff = '') {
2389	global $wpdb;
2390	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
2391
2392	$rows = $wpdb->get_results(
2393	"SELECT option_name, option_value FROM {$wpdb->options}
2394	WHERE option_name LIKE 'mxchat_lead_del_email_%'"
2395	);
2396	if (empty($rows)) {
2397	return [];
2398	}
2399
2400	// Emails that currently have transcripts rows should not appear as chat_deleted —
2401	// they've come back and chatted, so they're active leads again.
2402	$emails_in_transcripts = array_map(
2403	'strtolower',
2404	(array) $wpdb->get_col(
2405	"SELECT DISTINCT user_email FROM {$table}
2406	WHERE user_email IS NOT NULL AND user_email != ''"
2407	)
2408	);
2409	$emails_in_transcripts = array_flip($emails_in_transcripts);
2410
2411	$needle = strtolower(trim((string) $search));
2412	$by_email = [];
2413
2414	foreach ($rows as $opt) {
2415	$email = sanitize_email(trim((string) $opt->option_value));
2416	if (!$email) {
2417	continue;
2418	}
2419	if (isset($emails_in_transcripts[strtolower($email)])) {
2420	continue;
2421	}
2422	$sid = substr($opt->option_name, strlen('mxchat_lead_del_email_'));
2423	if (!$sid) {
2424	continue;
2425	}
2426	$name = (string) get_option('mxchat_lead_del_name_' . $sid, '');
2427	$ts = (string) get_option('mxchat_lead_del_ts_' . $sid, '');
2428
2429	if ($date_cutoff !== '' && ($ts === '' \|\| $ts < $date_cutoff)) {
2430	continue;
2431	}
2432	if ($needle !== '') {
2433	$hay = strtolower($email . ' ' . $name);
2434	if (strpos($hay, $needle) === false) {
2435	continue;
2436	}
2437	}
2438
2439	$key = strtolower($email);
2440	if (!isset($by_email[$key]) \|\| (isset($by_email[$key]['last_seen']) && $ts > $by_email[$key]['last_seen'])) {
2441	$by_email[$key] = [
2442	'email' => $email,
2443	'name' => $name,
2444	'conversation_count' => 0,
2445	'last_seen' => $ts,
2446	'last_seen_display' => $ts ? self::mxchat_leads_format_relative($ts) : __('Chat deleted', 'mxchat'),
2447	'first_seen' => $ts,
2448	'latest_session_id' => '',
2449	'top_page_url' => '',
2450	'top_page_title' => '',
2451	'is_orphan' => false,
2452	'status' => 'chat_deleted',
2453	];
2454	}
2455	}
2456
2457	// Newest chat_deleted first.
2458	usort($by_email, function ($a, $b) {
2459	return strcmp((string) $b['last_seen'], (string) $a['last_seen']);
2460	});
2461	return array_values($by_email);
2462	}
2463
2464	/**
2465	* Count unique emails preserved as "chat deleted" (for the stats strip).
2466	*/
2467	private static function mxchat_count_chat_deleted_leads() {
2468	global $wpdb;
2469	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
2470
2471	$emails = $wpdb->get_col(
2472	"SELECT DISTINCT option_value FROM {$wpdb->options}
2473	WHERE option_name LIKE 'mxchat_lead_del_email_%'"
2474	);
2475	if (empty($emails)) {
2476	return 0;
2477	}
2478
2479	$transcripts_emails = array_map(
2480	'strtolower',
2481	(array) $wpdb->get_col(
2482	"SELECT DISTINCT user_email FROM {$table}
2483	WHERE user_email IS NOT NULL AND user_email != ''"
2484	)
2485	);
2486	$transcripts_emails = array_flip($transcripts_emails);
2487
2488	$count = 0;
2489	$seen = [];
2490	foreach ($emails as $raw) {
2491	$email = strtolower(trim((string) $raw));
2492	if (!$email \|\| isset($seen[$email]) \|\| isset($transcripts_emails[$email])) {
2493	continue;
2494	}
2495	$seen[$email] = true;
2496	$count++;
2497	}
2498	return $count;
2499	}
2500
2501	/**
2502	* Find leads who submitted the pre-chat form but never produced a transcripts row.
2503	* Returned rows have no conversation_count, no timestamp.
2504	*
2505	* @param string $search Optional email/name substring filter.
2506	* @return array
2507	*/
2508	private static function mxchat_collect_orphan_leads($search = '') {
2509	global $wpdb;
2510	$table = $wpdb->prefix . 'mxchat_chat_transcripts';
2511
2512	$option_rows = $wpdb->get_results(
2513	"SELECT option_name, option_value FROM {$wpdb->options}
2514	WHERE option_name LIKE 'mxchat_email_%'"
2515	);
2516	if (empty($option_rows)) {
2517	return [];
2518	}
2519
2520	// Collect all session_ids that have real transcripts rows so we can exclude them.
2521	$session_ids_with_rows = $wpdb->get_col(
2522	"SELECT DISTINCT session_id FROM {$table}
2523	WHERE user_email IS NOT NULL AND user_email != ''"
2524	);
2525	$session_ids_with_rows = array_flip($session_ids_with_rows);
2526
2527	// Seen emails in transcripts (so orphans only include truly never-chatted leads).
2528	$emails_in_transcripts = array_map(
2529	'strtolower',
2530	(array) $wpdb->get_col(
2531	"SELECT DISTINCT user_email FROM {$table}
2532	WHERE user_email IS NOT NULL AND user_email != ''"
2533	)
2534	);
2535	$emails_in_transcripts = array_flip($emails_in_transcripts);
2536
2537	$orphans_by_email = [];
2538	$needle = strtolower(trim((string) $search));
2539
2540	foreach ($option_rows as $opt) {
2541	$email = sanitize_email(trim((string) $opt->option_value));
2542	if (!$email) {
2543	continue;
2544	}
2545	$sid = substr($opt->option_name, strlen('mxchat_email_'));
2546	if (!$sid) {
2547	continue;
2548	}
2549	// Exclude leads who have any transcripts rows (they appear in the main list).
2550	if (isset($emails_in_transcripts[strtolower($email)])) {
2551	continue;
2552	}
2553	if (isset($session_ids_with_rows[$sid])) {
2554	continue;
2555	}
2556
2557	$name_option = get_option('mxchat_name_' . $sid, '');
2558	$name = is_string($name_option) ? trim($name_option) : '';
2559
2560	if ($needle !== '') {
2561	$hay = strtolower($email . ' ' . $name);
2562	if (strpos($hay, $needle) === false) {
2563	continue;
2564	}
2565	}
2566
2567	$key = strtolower($email);
2568	if (!isset($orphans_by_email[$key])) {
2569	$orphans_by_email[$key] = [
2570	'email' => $email,
2571	'name' => $name,
2572	'conversation_count' => 0,
2573	'last_seen' => '',
2574	'last_seen_display' => __('No conversation yet', 'mxchat'),
2575	'first_seen' => '',
2576	'latest_session_id' => '',
2577	'top_page_url' => '',
2578	'top_page_title' => '',
2579	'is_orphan' => true,
2580	'status' => 'orphan',
2581	];
2582	}
2583	}
2584
2585	return array_values($orphans_by_email);
2586	}
2587
2588	/**
2589	* Map a date_range key to a SQL-comparable cutoff string, or '' for all-time.
2590	*/
2591	private static function mxchat_leads_date_cutoff($date_range) {
2592	switch ($date_range) {
2593	case 'today': return gmdate('Y-m-d H:i:s', strtotime('-24 hours'));
2594	case '7d': return gmdate('Y-m-d H:i:s', strtotime('-7 days'));
2595	case '30d': return gmdate('Y-m-d H:i:s', strtotime('-30 days'));
2596	case '90d': return gmdate('Y-m-d H:i:s', strtotime('-90 days'));
2597	case 'all':
2598	default: return '';
2599	}
2600	}
2601
2602	/**
2603	* Turn a UTC timestamp into a short relative display like "2h ago" or "Apr 12".
2604	*/
2605	private static function mxchat_leads_format_relative($timestamp) {
2606	if (!$timestamp) {
2607	return '';
2608	}
2609	$ts = strtotime($timestamp . ' UTC');
2610	if (!$ts) {
2611	return '';
2612	}
2613	$diff = time() - $ts;
2614	if ($diff < 60) return __('just now', 'mxchat');
2615	if ($diff < 3600) return floor($diff / 60) . __('m ago', 'mxchat');
2616	if ($diff < 86400) return floor($diff / 3600) . __('h ago', 'mxchat');
2617	if ($diff < 604800) return floor($diff / 86400) . __('d ago', 'mxchat');
2618	return wp_date('M j', $ts);
2619	}
2620
2621	/**
2622	* Handle translation of chat messages via AJAX
2623	*/
2624	public function mxchat_translate_messages() {
2625	if (!current_user_can('manage_options')) {
2626	wp_send_json_error(['error' => 'Insufficient permissions']);
2627	wp_die();
2628	}
2629
2630	$session_id = isset($_POST['session_id']) ? sanitize_text_field($_POST['session_id']) : '';
2631	$target_lang = isset($_POST['target_lang']) ? sanitize_text_field($_POST['target_lang']) : 'en';
2632	$messages_json = isset($_POST['messages']) ? wp_unslash($_POST['messages']) : '[]';
2633	$messages = json_decode($messages_json, true);
2634
2635	if (empty($session_id)) {
2636	wp_send_json_error(['error' => 'No session ID provided']);
2637	wp_die();
2638	}
2639
2640	if (empty($messages) \|\| !is_array($messages)) {
2641	wp_send_json_error(['error' => 'No messages to translate']);
2642	wp_die();
2643	}
2644
2645	// Language names for prompting
2646	$languages = [
2647	'en' => 'English',
2648	'es' => 'Spanish',
2649	'fr' => 'French',
2650	'de' => 'German',
2651	'it' => 'Italian',
2652	'pt' => 'Portuguese',
2653	'nl' => 'Dutch',
2654	'ru' => 'Russian',
2655	'zh' => 'Chinese',
2656	'ja' => 'Japanese',
2657	'ko' => 'Korean',
2658	'ar' => 'Arabic',
2659	'hi' => 'Hindi',
2660	'tr' => 'Turkish',
2661	'pl' => 'Polish',
2662	'vi' => 'Vietnamese',
2663	'th' => 'Thai',
2664	'id' => 'Indonesian',
2665	'sv' => 'Swedish',
2666	'da' => 'Danish'
2667	];
2668
2669	$target_lang_name = isset($languages[$target_lang]) ? $languages[$target_lang] : 'English';
2670
2671	// Build combined text for translation (numbered for parsing)
2672	$numbered_messages = [];
2673	foreach ($messages as $i => $msg) {
2674	$content = isset($msg['content']) ? trim($msg['content']) : '';
2675	if (!empty($content)) {
2676	$numbered_messages[] = "[MSG" . $i . "]" . $content . "[/MSG" . $i . "]";
2677	}
2678	}
2679
2680	if (empty($numbered_messages)) {
2681	wp_send_json_error(['error' => 'No valid messages to translate']);
2682	wp_die();
2683	}
2684
2685	$combined_text = implode("\n\n", $numbered_messages);
2686
2687	// Prepare the translation prompt
2688	$system_prompt = "You are a translator. Translate the following messages to {$target_lang_name}. Keep the [MSG#] and [/MSG#] tags exactly as they are - only translate the content between them. Maintain the original formatting, line breaks, and any HTML tags. Return ONLY the translated messages with the tags, no explanations.";
2689
2690	// Get user's selected model and determine provider
2691	$options = get_option('mxchat_options', []);
2692	$selected_model = $options['model'] ?? 'gpt-5.1-chat-latest';
2693
2694	// Check if using OpenRouter
2695	if ($selected_model === 'openrouter') {
2696	$provider = 'openrouter';
2697	$selected_model = $options['openrouter_selected_model'] ?? '';
2698	$api_key = $options['openrouter_api_key'] ?? '';
2699
2700	if (empty($selected_model)) {
2701	wp_send_json_error(['error' => 'No OpenRouter model selected']);
2702	wp_die();
2703	}
2704	} else {
2705	// Determine provider from model name
2706	$model_parts = explode('-', $selected_model);
2707	$provider = strtolower($model_parts[0]);
2708
2709	// Get the appropriate API key based on provider
2710	$api_key = '';
2711	switch ($provider) {
2712	case 'gpt':
2713	case 'o1':
2714	$api_key = $options['api_key'] ?? '';
2715	break;
2716	case 'claude':
2717	$api_key = $options['claude_api_key'] ?? '';
2718	break;
2719	case 'grok':
2720	$api_key = $options['xai_api_key'] ?? '';
2721	break;
2722	case 'deepseek':
2723	$api_key = $options['deepseek_api_key'] ?? '';
2724	break;
2725	case 'gemini':
2726	$api_key = $options['gemini_api_key'] ?? '';
2727	break;
2728	default:
2729	// Default to OpenAI
2730	$api_key = $options['api_key'] ?? '';
2731	$provider = 'gpt';
2732	break;
2733	}
2734	}
2735
2736	if (empty($api_key)) {
2737	wp_send_json_error(['error' => 'No API key configured for ' . $provider]);
2738	wp_die();
2739	}
2740
2741	// Make API request based on provider
2742	$response = $this->translate_with_provider($provider, $selected_model, $api_key, $system_prompt, $combined_text);
2743
2744	if (is_wp_error($response)) {
2745	wp_send_json_error(['error' => $response->get_error_message()]);
2746	wp_die();
2747	}
2748
2749	// Parse the response to extract translated messages
2750	$translations = [];
2751	foreach ($messages as $msg) {
2752	$index = $msg['index'];
2753	$pattern = '/\[MSG' . $index . '\](.*?)\[\/MSG' . $index . '\]/s';
2754	if (preg_match($pattern, $response, $matches)) {
2755	$translations[] = [
2756	'index' => $index,
2757	'translated' => trim($matches[1])
2758	];
2759	}
2760	}
2761
2762	// Save translations to database
2763	if (!empty($translations)) {
2764	$this->save_transcript_translation($session_id, $target_lang, $translations);
2765	}
2766
2767	wp_send_json(['success' => true, 'translations' => $translations, 'language' => $target_lang]);
2768	wp_die();
2769	}
2770
2771	/**
2772	* Save transcript translation to database
2773	*/
2774	private function save_transcript_translation($session_id, $language_code, $translations) {
2775	global $wpdb;
2776	$table_name = $wpdb->prefix . 'mxchat_transcript_translations';
2777
2778	// Check if table exists, create if not
2779	if ($wpdb->get_var("SHOW TABLES LIKE '$table_name'") !== $table_name) {
2780	mxchat_create_translations_table();
2781	}
2782
2783	$now = current_time('mysql');
2784	$translations_json = wp_json_encode($translations);
2785
2786	// Use REPLACE to insert or update
2787	$wpdb->query($wpdb->prepare(
2788	"REPLACE INTO $table_name (session_id, language_code, translations, created_at, updated_at)
2789	VALUES (%s, %s, %s, %s, %s)",
2790	$session_id,
2791	$language_code,
2792	$translations_json,
2793	$now,
2794	$now
2795	));
2796	}
2797
2798	/**
2799	* Get saved translation for a session
2800	*/
2801	public function mxchat_get_transcript_translation() {
2802	if (!current_user_can('manage_options')) {
2803	wp_send_json_error(['error' => 'Insufficient permissions']);
2804	wp_die();
2805	}
2806
2807	$session_id = isset($_POST['session_id']) ? sanitize_text_field($_POST['session_id']) : '';
2808
2809	if (empty($session_id)) {
2810	wp_send_json_error(['error' => 'No session ID provided']);
2811	wp_die();
2812	}
2813
2814	global $wpdb;
2815	$table_name = $wpdb->prefix . 'mxchat_transcript_translations';
2816
2817	// Check if table exists
2818	if ($wpdb->get_var("SHOW TABLES LIKE '$table_name'") !== $table_name) {
2819	wp_send_json(['success' => true, 'has_translation' => false]);
2820	wp_die();
2821	}
2822
2823	// Get the most recent translation for this session
2824	$result = $wpdb->get_row($wpdb->prepare(
2825	"SELECT language_code, translations FROM $table_name WHERE session_id = %s ORDER BY updated_at DESC LIMIT 1",
2826	$session_id
2827	));
2828
2829	if ($result) {
2830	$translations = json_decode($result->translations, true);
2831	wp_send_json([
2832	'success' => true,
2833	'has_translation' => true,
2834	'language' => $result->language_code,
2835	'translations' => $translations
2836	]);
2837	} else {
2838	wp_send_json(['success' => true, 'has_translation' => false]);
2839	}
2840	wp_die();
2841	}
2842
2843	/**
2844	* Translate text using the user's selected provider and model
2845	*/
2846	private function translate_with_provider($provider, $model, $api_key, $system_prompt, $text) {
2847	switch ($provider) {
2848	case 'claude':
2849	return $this->translate_with_claude($api_key, $model, $system_prompt, $text);
2850	case 'grok':
2851	return $this->translate_with_xai($api_key, $model, $system_prompt, $text);
2852	case 'deepseek':
2853	return $this->translate_with_deepseek($api_key, $model, $system_prompt, $text);
2854	case 'gemini':
2855	return $this->translate_with_gemini($api_key, $model, $system_prompt, $text);
2856	case 'openrouter':
2857	return $this->translate_with_openrouter($api_key, $model, $system_prompt, $text);
2858	case 'gpt':
2859	case 'o1':
2860	default:
2861	return $this->translate_with_openai($api_key, $model, $system_prompt, $text);
2862	}
2863	}
2864
2865	/**
2866	* Translate text using OpenAI API
2867	*/
2868	private function translate_with_openai($api_key, $model, $system_prompt, $text) {
2869	$response = wp_remote_post('https://api.openai.com/v1/chat/completions', [
2870	'timeout' => 60,
2871	'headers' => [
2872	'Authorization' => 'Bearer ' . $api_key,
2873	'Content-Type' => 'application/json'
2874	],
2875	'body' => wp_json_encode([
2876	'model' => $model,
2877	'messages' => [
2878	['role' => 'system', 'content' => $system_prompt],
2879	['role' => 'user', 'content' => $text]
2880	],
2881	'temperature' => 0.3
2882	])
2883	]);
2884
2885	if (is_wp_error($response)) {
2886	return $response;
2887	}
2888
2889	$body = json_decode(wp_remote_retrieve_body($response), true);
2890
2891	if (isset($body['error'])) {
2892	return new WP_Error('api_error', $body['error']['message']);
2893	}
2894
2895	if (isset($body['choices'][0]['message']['content'])) {
2896	return $body['choices'][0]['message']['content'];
2897	}
2898
2899	return new WP_Error('api_error', 'Invalid API response');
2900	}
2901
2902	/**
2903	* Translate text using Claude API
2904	*/
2905	private function translate_with_claude($api_key, $model, $system_prompt, $text) {
2906	$response = wp_remote_post('https://api.anthropic.com/v1/messages', [
2907	'timeout' => 60,
2908	'headers' => [
2909	'x-api-key' => $api_key,
2910	'anthropic-version' => '2023-06-01',
2911	'Content-Type' => 'application/json'
2912	],
2913	'body' => wp_json_encode([
2914	'model' => $model,
2915	'max_tokens' => 4096,
2916	'system' => $system_prompt,
2917	'messages' => [
2918	['role' => 'user', 'content' => $text]
2919	]
2920	])
2921	]);
2922
2923	if (is_wp_error($response)) {
2924	return $response;
2925	}
2926
2927	$body = json_decode(wp_remote_retrieve_body($response), true);
2928
2929	if (isset($body['error'])) {
2930	return new WP_Error('api_error', $body['error']['message']);
2931	}
2932
2933	if (isset($body['content'][0]['text'])) {
2934	return $body['content'][0]['text'];
2935	}
2936
2937	return new WP_Error('api_error', 'Invalid API response');
2938	}
2939
2940	/**
2941	* Translate text using xAI (Grok) API
2942	*/
2943	private function translate_with_xai($api_key, $model, $system_prompt, $text) {
2944	$response = wp_remote_post('https://api.x.ai/v1/chat/completions', [
2945	'timeout' => 60,
2946	'headers' => [
2947	'Authorization' => 'Bearer ' . $api_key,
2948	'Content-Type' => 'application/json'
2949	],
2950	'body' => wp_json_encode([
2951	'model' => $model,
2952	'messages' => [
2953	['role' => 'system', 'content' => $system_prompt],
2954	['role' => 'user', 'content' => $text]
2955	],
2956	'temperature' => 0.3
2957	])
2958	]);
2959
2960	if (is_wp_error($response)) {
2961	return $response;
2962	}
2963
2964	$body = json_decode(wp_remote_retrieve_body($response), true);
2965
2966	if (isset($body['error'])) {
2967	return new WP_Error('api_error', $body['error']['message']);
2968	}
2969
2970	if (isset($body['choices'][0]['message']['content'])) {
2971	return $body['choices'][0]['message']['content'];
2972	}
2973
2974	return new WP_Error('api_error', 'Invalid API response');
2975	}
2976
2977	/**
2978	* Translate text using DeepSeek API
2979	*/
2980	private function translate_with_deepseek($api_key, $model, $system_prompt, $text) {
2981	$response = wp_remote_post('https://api.deepseek.com/v1/chat/completions', [
2982	'timeout' => 60,
2983	'headers' => [
2984	'Authorization' => 'Bearer ' . $api_key,
2985	'Content-Type' => 'application/json'
2986	],
2987	'body' => wp_json_encode([
2988	'model' => $model,
2989	'messages' => [
2990	['role' => 'system', 'content' => $system_prompt],
2991	['role' => 'user', 'content' => $text]
2992	],
2993	'temperature' => 0.3
2994	])
2995	]);
2996
2997	if (is_wp_error($response)) {
2998	return $response;
2999	}
3000
3001	$body = json_decode(wp_remote_retrieve_body($response), true);
3002
3003	if (isset($body['error'])) {
3004	return new WP_Error('api_error', $body['error']['message']);
3005	}
3006
3007	if (isset($body['choices'][0]['message']['content'])) {
3008	return $body['choices'][0]['message']['content'];
3009	}
3010
3011	return new WP_Error('api_error', 'Invalid API response');
3012	}
3013
3014	/**
3015	* Translate text using Google Gemini API
3016	*/
3017	private function translate_with_gemini($api_key, $model, $system_prompt, $text) {
3018	if ($model === 'gemini-3-pro-preview') {
3019	$model = 'gemini-3.1-pro-preview';
3020	}
3021	$url = 'https://generativelanguage.googleapis.com/v1beta/models/' . $model . ':generateContent?key=' . $api_key;
3022
3023	$response = wp_remote_post($url, [
3024	'timeout' => 60,
3025	'headers' => [
3026	'Content-Type' => 'application/json'
3027	],
3028	'body' => wp_json_encode([
3029	'contents' => [
3030	[
3031	'parts' => [
3032	['text' => $system_prompt . "\n\n" . $text]
3033	]
3034	]
3035	],
3036	'generationConfig' => [
3037	'temperature' => 0.3
3038	]
3039	])
3040	]);
3041
3042	if (is_wp_error($response)) {
3043	return $response;
3044	}
3045
3046	$body = json_decode(wp_remote_retrieve_body($response), true);
3047
3048	if (isset($body['error'])) {
3049	return new WP_Error('api_error', $body['error']['message']);
3050	}
3051
3052	if (isset($body['candidates'][0]['content']['parts'][0]['text'])) {
3053	return $body['candidates'][0]['content']['parts'][0]['text'];
3054	}
3055
3056	return new WP_Error('api_error', 'Invalid API response');
3057	}
3058
3059	/**
3060	* Translate text using OpenRouter API
3061	*/
3062	private function translate_with_openrouter($api_key, $model, $system_prompt, $text) {
3063	$response = wp_remote_post('https://openrouter.ai/api/v1/chat/completions', [
3064	'timeout' => 60,
3065	'headers' => [
3066	'Authorization' => 'Bearer ' . $api_key,
3067	'Content-Type' => 'application/json',
3068	'HTTP-Referer' => home_url(),
3069	'X-Title' => 'MxChat Translation'
3070	],
3071	'body' => wp_json_encode([
3072	'model' => $model,
3073	'messages' => [
3074	['role' => 'system', 'content' => $system_prompt],
3075	['role' => 'user', 'content' => $text]
3076	],
3077	'temperature' => 0.3
3078	])
3079	]);
3080
3081	if (is_wp_error($response)) {
3082	return $response;
3083	}
3084
3085	$body = json_decode(wp_remote_retrieve_body($response), true);
3086
3087	if (isset($body['error'])) {
3088	return new WP_Error('api_error', $body['error']['message']);
3089	}
3090
3091	if (isset($body['choices'][0]['message']['content'])) {
3092	return $body['choices'][0]['message']['content'];
3093	}
3094
3095	return new WP_Error('api_error', 'Invalid API response');
3096	}
3097
3098	public function mxchat_fetch_chat_history() {
3099	global $wpdb;
3100	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
3101	$url_clicks_table = $wpdb->prefix . 'mxchat_url_clicks';
3102
3103	if (!current_user_can('manage_options')) {
3104	wp_send_json_error(['message' => 'Insufficient permissions']);
3105	wp_die();
3106	}
3107
3108	$page = isset($_POST['page']) ? absint($_POST['page']) : 1;
3109	$per_page = isset($_POST['per_page']) ? absint($_POST['per_page']) : 50;
3110	$offset = ($page - 1) * $per_page;
3111	$search = isset($_POST['search']) ? sanitize_text_field($_POST['search']) : '';
3112	$sort_raw = isset($_POST['sort_order']) ? sanitize_key($_POST['sort_order']) : 'desc';
3113	$allowed_sorts = array('asc', 'desc', 'rating_positive', 'rating_negative');
3114	if (!in_array($sort_raw, $allowed_sorts, true)) { $sort_raw = 'desc'; }
3115	$sort_order = ($sort_raw === 'asc') ? 'ASC' : 'DESC';
3116	$ratings_table = $wpdb->prefix . 'mxchat_session_ratings';
3117	$ratings_join = '';
3118	$rating_table_exists = ($wpdb->get_var($wpdb->prepare("SHOW TABLES LIKE %s", $ratings_table)) === $ratings_table);
3119	if ($rating_table_exists && ($sort_raw === 'rating_positive' \|\| $sort_raw === 'rating_negative')) {
3120	// We sort by rating then recency. Wrap rating_value so NULL sorts last.
3121	$rating_dir = ($sort_raw === 'rating_positive') ? 'DESC' : 'ASC';
3122	$ratings_join = " LEFT JOIN {$ratings_table} r ON r.session_id = t.session_id ";
3123	}
3124
3125	// Build search condition
3126	$search_condition = '';
3127	$search_params = [];
3128	if (!empty($search)) {
3129	$search_condition = "WHERE (
3130	session_id LIKE %s
3131	OR user_email LIKE %s
3132	OR user_name LIKE %s
3133	OR user_identifier LIKE %s
3134	OR message LIKE %s
3135	)";
3136	$search_params = array_fill(0, 5, '%' . $wpdb->esc_like($search) . '%');
3137	}
3138
3139	// Get total count
3140	$count_query = !empty($search)
3141	? $wpdb->prepare("SELECT COUNT(DISTINCT session_id) FROM {$table_name} {$search_condition}", $search_params)
3142	: "SELECT COUNT(DISTINCT session_id) FROM {$table_name}";
3143	$total_sessions = (int) $wpdb->get_var($count_query);
3144
3145	// Get session IDs for current page. Default sort is recency; rating sorts join the ratings table
3146	// and order by rating value (NULLs last) with recency as tiebreaker.
3147	if ($ratings_join) {
3148	$order_by = "ORDER BY (r.rating_value IS NULL), r.rating_value {$rating_dir}, MAX(t.timestamp) DESC";
3149	} else {
3150	$order_by = "ORDER BY MAX(t.timestamp) {$sort_order}";
3151	}
3152	$session_query = !empty($search)
3153	? $wpdb->prepare(
3154	"SELECT DISTINCT t.session_id FROM {$table_name} t {$ratings_join} {$search_condition}
3155	GROUP BY t.session_id {$order_by} LIMIT %d OFFSET %d",
3156	array_merge($search_params, [$per_page, $offset])
3157	)
3158	: $wpdb->prepare(
3159	"SELECT DISTINCT t.session_id FROM {$table_name} t {$ratings_join}
3160	GROUP BY t.session_id {$order_by} LIMIT %d OFFSET %d",
3161	$per_page, $offset
3162	);
3163	$session_ids = $wpdb->get_col($session_query);
3164
3165	$total_pages = ceil($total_sessions / $per_page);
3166
3167	if (empty($session_ids)) {
3168	wp_send_json([
3169	'success' => true,
3170	'sessions' => [],
3171	'page' => $page,
3172	'total_pages' => 0,
3173	'total_sessions' => 0,
3174	'showing_start' => 0,
3175	'showing_end' => 0
3176	]);
3177	wp_die();
3178	}
3179
3180	// Check for optional columns/tables
3181	$url_table_exists = $wpdb->get_var("SHOW TABLES LIKE '$url_clicks_table'") === $url_clicks_table;
3182	$originating_columns_exist = !empty($wpdb->get_results("SHOW COLUMNS FROM $table_name LIKE 'originating_page_url'"));
3183
3184	// Batch-fetch session ratings for this page (plan-a5b006).
3185	$ratings_map = array();
3186	if ($rating_table_exists && !empty($session_ids)) {
3187	$placeholders = implode(',', array_fill(0, count($session_ids), '%s'));
3188	$rating_rows = $wpdb->get_results($wpdb->prepare(
3189	"SELECT session_id, rating_value, rating_feedback FROM {$ratings_table} WHERE session_id IN ($placeholders)",
3190	$session_ids
3191	));
3192	foreach ($rating_rows as $row) {
3193	$ratings_map[$row->session_id] = array(
3194	'value' => (int) $row->rating_value,
3195	'feedback' => (string) $row->rating_feedback,
3196	);
3197	}
3198	}
3199
3200	// Build session list data
3201	$sessions = [];
3202	foreach ($session_ids as $session_id) {
3203	// Get session metadata
3204	$session_data = $originating_columns_exist
3205	? $wpdb->get_row($wpdb->prepare(
3206	"SELECT user_email, user_name, user_identifier, originating_page_url, originating_page_title, timestamp
3207	FROM {$table_name} WHERE session_id = %s ORDER BY timestamp ASC LIMIT 1",
3208	$session_id
3209	))
3210	: $wpdb->get_row($wpdb->prepare(
3211	"SELECT user_email, user_name, user_identifier, timestamp FROM {$table_name}
3212	WHERE session_id = %s LIMIT 1",
3213	$session_id
3214	));
3215
3216	// Get message count and latest timestamp
3217	$message_stats = $wpdb->get_row($wpdb->prepare(
3218	"SELECT COUNT(*) as count, MAX(timestamp) as latest FROM {$table_name} WHERE session_id = %s",
3219	$session_id
3220	));
3221
3222	// Get first user message as preview
3223	$first_user_msg = $wpdb->get_var($wpdb->prepare(
3224	"SELECT message FROM {$table_name} WHERE session_id = %s AND role = 'user' ORDER BY timestamp ASC LIMIT 1",
3225	$session_id
3226	));
3227	$preview = $first_user_msg ? wp_trim_words(wp_strip_all_tags(stripslashes($first_user_msg)), 12, '...') : 'No messages';
3228
3229	// Build display name
3230	$user_email = !empty($session_data->user_email) ? $session_data->user_email : '';
3231	$user_name = !empty($session_data->user_name) ? $session_data->user_name : '';
3232	$user_identifier = !empty($session_data->user_identifier) ? $session_data->user_identifier : 'Guest';
3233
3234	$display_name = $user_name ?: ($user_email ? explode('@', $user_email)[0] : $user_identifier);
3235	$display_sub = $user_email ?: ('ID: ' . $user_identifier);
3236
3237	// Format time - show relative for recent, date for older
3238	$timestamp = strtotime($message_stats->latest . ' UTC');
3239	$now = time();
3240	$diff = $now - $timestamp;
3241	if ($diff < 3600) {
3242	$time_display = floor($diff / 60) . 'm ago';
3243	} elseif ($diff < 86400) {
3244	$time_display = floor($diff / 3600) . 'h ago';
3245	} elseif ($diff < 604800) {
3246	$time_display = floor($diff / 86400) . 'd ago';
3247	} else {
3248	$time_display = wp_date('M j', $timestamp);
3249	}
3250
3251	// Get initials for avatar
3252	$initials = strtoupper(substr($display_name, 0, 2));
3253	if (strlen($display_name) > 2 && strpos($display_name, ' ') !== false) {
3254	$parts = explode(' ', $display_name);
3255	$initials = strtoupper(substr($parts[0], 0, 1) . substr(end($parts), 0, 1));
3256	}
3257
3258	$rating_entry = isset($ratings_map[$session_id]) ? $ratings_map[$session_id] : null;
3259	$rating_value = $rating_entry ? $rating_entry['value'] : null;
3260	$rating_feedback = $rating_entry ? $rating_entry['feedback'] : '';
3261
3262	$sessions[] = [
3263	'session_id' => $session_id,
3264	'display_name' => $display_name,
3265	'display_sub' => $display_sub,
3266	'initials' => $initials,
3267	'preview' => $preview,
3268	'message_count' => (int) $message_stats->count,
3269	'time_display' => $time_display,
3270	'timestamp' => $message_stats->latest,
3271	'rating_value' => $rating_value,
3272	'rating_feedback' => $rating_feedback,
3273	];
3274	}
3275
3276	wp_send_json([
3277	'success' => true,
3278	'sessions' => $sessions,
3279	'page' => $page,
3280	'total_pages' => $total_pages,
3281	'total_sessions' => $total_sessions,
3282	'showing_start' => $offset + 1,
3283	'showing_end' => min($offset + $per_page, $total_sessions)
3284	]);
3285	wp_die();
3286	}
3287
3288	/**
3289	* Fetch single conversation details for split-panel view
3290	*/
3291	public function mxchat_fetch_conversation() {
3292	global $wpdb;
3293	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
3294	$url_clicks_table = $wpdb->prefix . 'mxchat_url_clicks';
3295
3296	if (!current_user_can('manage_options')) {
3297	wp_send_json_error(['message' => 'Insufficient permissions']);
3298	wp_die();
3299	}
3300
3301	$session_id = isset($_POST['session_id']) ? sanitize_text_field($_POST['session_id']) : '';
3302	if (empty($session_id)) {
3303	wp_send_json_error(['message' => 'No session ID provided']);
3304	wp_die();
3305	}
3306
3307	// Check for optional columns/tables
3308	$url_table_exists = $wpdb->get_var("SHOW TABLES LIKE '$url_clicks_table'") === $url_clicks_table;
3309	$originating_columns_exist = !empty($wpdb->get_results("SHOW COLUMNS FROM $table_name LIKE 'originating_page_url'"));
3310
3311	// Get session metadata
3312	$session_data = $originating_columns_exist
3313	? $wpdb->get_row($wpdb->prepare(
3314	"SELECT user_email, user_name, user_identifier, originating_page_url, originating_page_title, timestamp
3315	FROM {$table_name} WHERE session_id = %s ORDER BY timestamp ASC LIMIT 1",
3316	$session_id
3317	))
3318	: $wpdb->get_row($wpdb->prepare(
3319	"SELECT user_email, user_name, user_identifier, timestamp FROM {$table_name}
3320	WHERE session_id = %s LIMIT 1",
3321	$session_id
3322	));
3323
3324	if (!$session_data) {
3325	wp_send_json_error(['message' => 'Session not found']);
3326	wp_die();
3327	}
3328
3329	// Get clicked URLs
3330	$clicked_urls = [];
3331	if ($url_table_exists) {
3332	$url_clicks = $wpdb->get_results($wpdb->prepare(
3333	"SELECT DISTINCT clicked_url FROM {$url_clicks_table}
3334	WHERE session_id = %s ORDER BY click_timestamp ASC",
3335	$session_id
3336	));
3337	foreach ($url_clicks as $click) {
3338	$clicked_urls[] = $click->clicked_url;
3339	}
3340	}
3341
3342	// Get all messages
3343	$messages = $wpdb->get_results($wpdb->prepare(
3344	"SELECT * FROM {$table_name} WHERE session_id = %s ORDER BY timestamp ASC",
3345	$session_id
3346	));
3347
3348	// Build user info
3349	$user_email = !empty($session_data->user_email) ? $session_data->user_email : '';
3350	$user_name = !empty($session_data->user_name) ? $session_data->user_name : '';
3351	$user_identifier = !empty($session_data->user_identifier) ? $session_data->user_identifier : 'Guest';
3352
3353	$display_name = $user_name ?: ($user_email ? explode('@', $user_email)[0] : $user_identifier);
3354	$display_sub = $user_email ?: ('ID: ' . $user_identifier);
3355
3356	// Get initials
3357	$initials = strtoupper(substr($display_name, 0, 2));
3358	if (strlen($display_name) > 2 && strpos($display_name, ' ') !== false) {
3359	$parts = explode(' ', $display_name);
3360	$initials = strtoupper(substr($parts[0], 0, 1) . substr(end($parts), 0, 1));
3361	}
3362
3363	// Page info
3364	$page_url = $originating_columns_exist && !empty($session_data->originating_page_url) ? $session_data->originating_page_url : '';
3365	$page_title = '';
3366	if ($page_url) {
3367	$page_title = !empty($session_data->originating_page_title) ? $session_data->originating_page_title : parse_url($page_url, PHP_URL_PATH);
3368	}
3369
3370	// Format messages for output
3371	$formatted_messages = [];
3372	foreach ($messages as $msg) {
3373	$is_user = ($msg->role === 'user');
3374	$is_bot = ($msg->role === 'bot' \|\| $msg->role === 'assistant');
3375
3376	$content = wp_kses(
3377	stripslashes($msg->message),
3378	[
3379	'b' => [], 'strong' => [], 'i' => [], 'em' => [], 'u' => [],
3380	'br' => [], 'p' => [], 'ul' => [], 'ol' => [], 'li' => [],
3381	'a' => ['href' => [], 'title' => [], 'target' => [], 'class' => []],
3382	'div' => ['class' => [], 'id' => [], 'data-nonce' => []],
3383	'img' => ['src' => [], 'alt' => [], 'class' => []],
3384	'h3' => ['class' => []],
3385	'h4' => ['class' => []],
3386	'button' => ['type' => [], 'class' => [], 'data-product-id' => [], 'data-nonce' => [], 'data-product-type' => [], 'data-original-text' => [], 'data-mxchat-action' => []],
3387	'select' => ['class' => [], 'data-attribute' => []],
3388	'option' => ['value' => []],
3389	'span' => ['class' => []],
3390	'del' => [], 'ins' => [],
3391	]
3392	);
3393	$formatted_content = $this->format_transcript_message($content);
3394
3395	$has_rag = $is_bot && !empty($msg->rag_context);
3396
3397	$formatted_messages[] = [
3398	'id' => $msg->id,
3399	'role' => $msg->role,
3400	'is_user' => $is_user,
3401	'is_bot' => $is_bot,
3402	'content' => $formatted_content,
3403	'timestamp' => wp_date('g:i A', strtotime($msg->timestamp . ' UTC')),
3404	'full_timestamp' => wp_date('F j, Y g:i A', strtotime($msg->timestamp . ' UTC')),
3405	'has_rag' => $has_rag
3406	];
3407	}
3408
3409	// First message timestamp for "started" display
3410	$started = !empty($messages) ? wp_date('M j, Y g:i A', strtotime($messages[0]->timestamp . ' UTC')) : '-';
3411
3412	// Pull rating_feedback for this session (if any) so the details drawer can show it.
3413	$rating_feedback = '';
3414	$ratings_table_det = $wpdb->prefix . 'mxchat_session_ratings';
3415	if ($wpdb->get_var("SHOW TABLES LIKE '$ratings_table_det'") === $ratings_table_det) {
3416	$rating_feedback = (string) $wpdb->get_var($wpdb->prepare(
3417	"SELECT rating_feedback FROM {$ratings_table_det} WHERE session_id = %s LIMIT 1",
3418	$session_id
3419	));
3420	}
3421
3422	wp_send_json([
3423	'success' => true,
3424	'session_id' => $session_id,
3425	'user' => [
3426	'name' => $display_name,
3427	'sub' => $display_sub,
3428	'initials' => $initials,
3429	'email' => $user_email,
3430	'identifier' => $user_identifier
3431	],
3432	'page' => [
3433	'url' => $page_url,
3434	'title' => $page_title
3435	],
3436	'clicked_urls' => $clicked_urls,
3437	'messages' => $formatted_messages,
3438	'message_count' => count($messages),
3439	'started' => $started,
3440	'rating_feedback' => $rating_feedback
3441	]);
3442	wp_die();
3443	}
3444
3445
3446	/**
3447	* ALTERNATIVE: Simpler helper method using string replacement
3448	*/
3449	private function highlight_clicked_links($message_content, $clicked_urls) {
3450	if (empty($clicked_urls)) {
3451	return wp_kses(
3452	$message_content,
3453	[
3454	'b' => [], 'strong' => [], 'i' => [], 'em' => [], 'u' => [],
3455	'br' => [], 'p' => [], 'ul' => [], 'ol' => [], 'li' => [],
3456	'a' => ['href' => [], 'title' => [], 'target' => [], 'class' => []]
3457	]
3458	);
3459	}
3460
3461	// First apply standard sanitization
3462	$message_content = wp_kses(
3463	$message_content,
3464	[
3465	'b' => [], 'strong' => [], 'i' => [], 'em' => [], 'u' => [],
3466	'br' => [], 'p' => [], 'ul' => [], 'ol' => [], 'li' => [],
3467	'a' => ['href' => [], 'title' => [], 'target' => [], 'class' => []]
3468	]
3469	);
3470
3471	// Process each clicked URL
3472	foreach ($clicked_urls as $clicked_url) {
3473	// Try multiple patterns to catch different link formats
3474	$patterns = [
3475	// Standard link format
3476	'/<a([^>]href=["\']' . preg_quote($clicked_url, '/') . '["\'][^>])>/i',
3477	// Link with trailing slash
3478	'/<a([^>]href=["\']' . preg_quote(rtrim($clicked_url, '/'), '/') . '\/?["\'][^>])>/i',
3479	// Encoded entities version
3480	'/<a([^>]href=["\']' . preg_quote(htmlentities($clicked_url), '/') . '["\'][^>])>/i',
3481	];
3482
3483	foreach ($patterns as $pattern) {
3484	if (preg_match($pattern, $message_content)) {
3485	$message_content = preg_replace_callback(
3486	$pattern,
3487	function($matches) {
3488	$full_match = $matches[0];
3489	$attributes = $matches[1];
3490
3491	// Check if it already has the class
3492	if (strpos($full_match, 'mxchat-clicked-link') !== false) {
3493	return $full_match;
3494	}
3495
3496	// Check if class attribute exists
3497	if (preg_match('/class=["\']([^"\']*)["\']/', $attributes, $class_matches)) {
3498	// Add to existing class
3499	$new_attributes = preg_replace(
3500	'/class=["\']([^"\']*)["\']/',
3501	'class="$1 mxchat-clicked-link"',
3502	$attributes
3503	);
3504	} else {
3505	// Add new class attribute
3506	$new_attributes = $attributes . ' class="mxchat-clicked-link"';
3507	}
3508
3509	// Add title if not present
3510	if (strpos($new_attributes, 'title=') === false) {
3511	$new_attributes .= ' title="User clicked this link"';
3512	}
3513
3514	return '<a' . $new_attributes . '>';
3515	},
3516	$message_content
3517	);
3518
3519	// If we found and replaced, break out of the patterns loop
3520	break;
3521	}
3522	}
3523	}
3524
3525	return $message_content;
3526	}
3527
3528	public function mxchat_create_prompts_page() {
3529	//error_log('=== DEBUG: mxchat_create_prompts_page started ===');
3530
3531	global $wpdb;
3532	$table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
3533
3534	$knowledge_manager = MxChat_Knowledge_Manager::get_instance();
3535	$pinecone_manager = MxChat_Pinecone_Manager::get_instance();
3536
3537	// Display success message if all prompts were deleted
3538	if (isset($_GET['all_deleted']) && $_GET['all_deleted'] === 'true') {
3539	echo '<div class="notice notice-success is-dismissible"><p>' . esc_html__('All knowledge has been deleted successfully.', 'mxchat') . '</p><button type="button" class="notice-dismiss"><span class="screen-reader-text">' . esc_html__('Dismiss this notice.', 'mxchat') . '</span></button></div>';
3540	}
3541
3542	// Set up pagination, search query, and content type filter
3543	$nonce = isset($_GET['_wpnonce']) ? sanitize_text_field($_GET['_wpnonce']) : '';
3544	$search_query = (!empty($nonce) && wp_verify_nonce($nonce, 'mxchat_prompts_search_nonce') && isset($_GET['search'])) ? sanitize_text_field($_GET['search']) : '';
3545	$content_type_filter = isset($_GET['content_type']) ? sanitize_key($_GET['content_type']) : ''; // ADDED 2.5.6
3546	$current_page = isset($_GET['paged']) ? absint($_GET['paged']) : 1;
3547	$per_page = 25;
3548
3549	//error_log('DEBUG: Search query: ' . $search_query);
3550	//error_log('DEBUG: Content type filter: ' . $content_type_filter);
3551	//error_log('DEBUG: Current page: ' . $current_page);
3552	//error_log('DEBUG: Per page: ' . $per_page);
3553
3554	// ================================
3555	// MULTI-BOT CONFIGURATION
3556	// ================================
3557
3558	// Check for multi-bot and set up bot selection
3559	if (class_exists('MxChat_Multi_Bot_Manager')) {
3560	$multi_bot_manager = MxChat_Multi_Bot_Core_Manager::get_instance();
3561	$available_bots = $multi_bot_manager->get_available_bots();
3562
3563	// Get saved bot selection (user-specific first, then site-wide default)
3564	$user_id = get_current_user_id();
3565	$saved_bot_id = get_user_meta($user_id, 'mxchat_selected_knowledge_bot', true);
3566	if (empty($saved_bot_id)) {
3567	$saved_bot_id = get_option('mxchat_current_knowledge_bot', 'default');
3568	}
3569
3570	// Allow URL override but default to saved selection
3571	$current_bot_id = isset($_GET['bot_id']) ? sanitize_key($_GET['bot_id']) : $saved_bot_id;
3572	$multibot_active = true;
3573	} else {
3574	$current_bot_id = 'default';
3575	$multibot_active = false;
3576	}
3577
3578	// ================================
3579	// DATA SOURCE CONFIGURATION
3580	// ================================
3581
3582	// Get bot-specific Pinecone settings
3583	$pinecone_options = $pinecone_manager->mxchat_get_bot_pinecone_options($current_bot_id);
3584	$use_pinecone = ($pinecone_options['mxchat_use_pinecone'] ?? '0') === '1';
3585	$pinecone_api_key = $pinecone_options['mxchat_pinecone_api_key'] ?? '';
3586
3587	// Get OpenAI Vector Store settings
3588	$vectorstore_options = get_option('mxchat_openai_vectorstore_options', array());
3589	$use_vectorstore = ($vectorstore_options['mxchat_use_openai_vectorstore'] ?? '0') === '1';
3590
3591	//error_log('DEBUG: Bot ' . $current_bot_id . ' - Use Pinecone: ' . ($use_pinecone ? 'YES' : 'NO'));
3592	//error_log('DEBUG: Bot ' . $current_bot_id . ' - Has API Key: ' . (!empty($pinecone_api_key) ? 'YES' : 'NO'));
3593	//error_log('DEBUG: Bot ' . $current_bot_id . ' - Host: ' . ($pinecone_options['mxchat_pinecone_host'] ?? 'NOT SET'));
3594	//error_log('DEBUG: Bot ' . $current_bot_id . ' - Namespace: ' . ($pinecone_options['mxchat_pinecone_namespace'] ?? 'NOT SET'));
3595
3596	if ($use_pinecone && !empty($pinecone_api_key)) {
3597	//error_log('DEBUG: Using PINECONE data source with bot-specific config');
3598	// PINECONE DATA SOURCE
3599	$data_source = 'pinecone';
3600
3601	// IMPORTANT: Pass the bot-specific $pinecone_options, not default options!
3602	// UPDATED 2.5.6: Added content_type_filter parameter
3603	$records = $pinecone_manager->mxchat_fetch_pinecone_records($pinecone_options, $search_query, $current_page, $per_page, $current_bot_id, $content_type_filter);
3604
3605	// TEMPORARY DEBUG - Add this right after the fetch call
3606	//error_log('=== DEBUG: Bot switching issue ===');
3607	//error_log('Current bot ID: ' . $current_bot_id);
3608	//error_log('Use Pinecone: ' . ($use_pinecone ? 'YES' : 'NO'));
3609	//error_log('Records returned: ' . count($records['data'] ?? []));
3610	//error_log('Total records: ' . ($records['total'] ?? 0));
3611
3612	// Check first few records to see their bot_id
3613	if (!empty($records['data'])) {
3614	foreach (array_slice($records['data'], 0, 3) as $i => $record) {
3615	$record_bot_id = $record->bot_id ?? 'NOT_SET';
3616	//error_log('Record ' . ($i+1) . ' bot_id: ' . $record_bot_id . ', content preview: ' . substr($record->article_content ?? '', 0, 30) . '...');
3617	}
3618	}
3619	//error_log('=== END DEBUG ===');
3620
3621	$total_records = $records['total'] ?? 0;
3622	$prompts = $records['data'] ?? array();
3623	$total_in_database = $records['total_in_database'] ?? 0;
3624	$showing_recent_only = $records['showing_recent_only'] ?? false;
3625
3626	$total_pages = ceil($total_records / $per_page);
3627
3628	} else {
3629	//error_log('DEBUG: Using WORDPRESS DB data source');
3630	// WORDPRESS DB DATA SOURCE (your existing logic)
3631	$data_source = 'wordpress';
3632
3633	// Initialize these variables for WordPress DB
3634	$total_in_database = 0;
3635	$showing_recent_only = false;
3636
3637	$offset = ($current_page - 1) * $per_page;
3638
3639	// UPDATED 2.5.6: Build WHERE clause for search and content type filtering
3640	$where_clauses = array();
3641	$where_values = array();
3642
3643	if ($search_query) {
3644	$where_clauses[] = "article_content LIKE %s";
3645	$where_values[] = '%' . $wpdb->esc_like($search_query) . '%';
3646	}
3647
3648	if ($content_type_filter) {
3649	$where_clauses[] = "content_type = %s";
3650	$where_values[] = $content_type_filter;
3651	}
3652
3653	$sql_where = "";
3654	if (!empty($where_clauses)) {
3655	$sql_where = "WHERE " . implode(" AND ", $where_clauses);
3656	}
3657
3658	// UPDATED 2.6.3: Count unique entries (by source_url) instead of individual rows
3659	// This ensures pagination shows X entries per page, not X chunks
3660	// Entries with empty source_url are counted individually
3661	if (!empty($where_values)) {
3662	// Count unique source_urls + count of rows with empty source_url
3663	$count_query = $wpdb->prepare(
3664	"SELECT (SELECT COUNT(DISTINCT source_url) FROM {$table_name} {$sql_where} AND source_url != '') +
3665	(SELECT COUNT(*) FROM {$table_name} {$sql_where} AND (source_url = '' OR source_url IS NULL))",
3666	array_merge($where_values, $where_values)
3667	);
3668	} else {
3669	$count_query = "SELECT (SELECT COUNT(DISTINCT source_url) FROM {$table_name} WHERE source_url != '') +
3670	(SELECT COUNT(*) FROM {$table_name} WHERE source_url = '' OR source_url IS NULL)";
3671	}
3672	$total_records = $wpdb->get_var($count_query);
3673	$total_pages = ceil($total_records / $per_page);
3674
3675	// UPDATED 2.6.3: Get unique source_urls for pagination, then fetch all their rows
3676	// Step 1: Get the source_urls for this page (distinct URLs ordered by latest timestamp)
3677	if (!empty($where_values)) {
3678	$urls_query = $wpdb->prepare(
3679	"SELECT source_url, MAX(timestamp) as latest_ts FROM {$table_name} {$sql_where}
3680	GROUP BY source_url ORDER BY latest_ts DESC LIMIT %d OFFSET %d",
3681	array_merge($where_values, array($per_page, $offset))
3682	);
3683	} else {
3684	$urls_query = $wpdb->prepare(
3685	"SELECT source_url, MAX(timestamp) as latest_ts FROM {$table_name}
3686	GROUP BY source_url ORDER BY latest_ts DESC LIMIT %d OFFSET %d",
3687	$per_page, $offset
3688	);
3689	}
3690	$page_urls = $wpdb->get_results($urls_query);
3691
3692	// Step 2: Fetch all rows for these source_urls
3693	$prompts = array();
3694	if (!empty($page_urls)) {
3695	// Build URL order map to preserve newest-first ordering from step 1
3696	$url_order_map = array();
3697	$url_list = array();
3698	$has_empty_url = false;
3699	$order_index = 0;
3700	foreach ($page_urls as $url_row) {
3701	if (empty($url_row->source_url)) {
3702	$has_empty_url = true;
3703	$url_order_map['__empty__'] = $order_index++;
3704	} else {
3705	$url_list[] = $url_row->source_url;
3706	$url_order_map[$url_row->source_url] = $order_index++;
3707	}
3708	}
3709
3710	// Build query to fetch all rows for these URLs
3711	$url_conditions = array();
3712	$url_values = array();
3713
3714	if (!empty($url_list)) {
3715	$placeholders = implode(',', array_fill(0, count($url_list), '%s'));
3716	$url_conditions[] = "source_url IN ($placeholders)";
3717	$url_values = array_merge($url_values, $url_list);
3718	}
3719
3720	if ($has_empty_url) {
3721	$url_conditions[] = "(source_url = '' OR source_url IS NULL)";
3722	}
3723
3724	if (!empty($url_conditions)) {
3725	$url_where = "WHERE (" . implode(" OR ", $url_conditions) . ")";
3726
3727	// Add original filters back
3728	if (!empty($where_clauses)) {
3729	$url_where .= " AND " . implode(" AND ", $where_clauses);
3730	$url_values = array_merge($url_values, $where_values);
3731	}
3732
3733	if (!empty($url_values)) {
3734	$prompts_query = $wpdb->prepare(
3735	"SELECT * FROM {$table_name} {$url_where} ORDER BY timestamp DESC",
3736	$url_values
3737	);
3738	} else {
3739	$prompts_query = "SELECT * FROM {$table_name} {$url_where} ORDER BY timestamp DESC";
3740	}
3741
3742	$prompts = $wpdb->get_results($prompts_query);
3743
3744	// Sort prompts by the original URL order (newest first), then by timestamp within each URL group
3745	usort($prompts, function($a, $b) use ($url_order_map) {
3746	$url_a = empty($a->source_url) ? '__empty__' : $a->source_url;
3747	$url_b = empty($b->source_url) ? '__empty__' : $b->source_url;
3748	$order_a = $url_order_map[$url_a] ?? PHP_INT_MAX;
3749	$order_b = $url_order_map[$url_b] ?? PHP_INT_MAX;
3750
3751	// First sort by URL order (newest URLs first)
3752	if ($order_a !== $order_b) {
3753	return $order_a - $order_b;
3754	}
3755
3756	// Within same URL, sort by timestamp DESC (newest chunks first)
3757	return strtotime($b->timestamp) - strtotime($a->timestamp);
3758	});
3759	}
3760	}
3761	}
3762
3763	// ================================
3764	// PAGINATION GENERATION
3765	// ================================
3766
3767	// Generate pagination links
3768	if ($total_pages > 1) {
3769	// Build a clean base URL with only necessary parameters
3770	$pagination_args = array('page' => 'mxchat-prompts');
3771
3772	// Preserve bot_id parameter if multi-bot is active
3773	if ($multibot_active && !empty($current_bot_id) && $current_bot_id !== 'default') {
3774	$pagination_args['bot_id'] = $current_bot_id;
3775	}
3776
3777	// Preserve search query and nonce if present
3778	if ($search_query) {
3779	$pagination_args['search'] = $search_query;
3780	if (!empty($nonce)) {
3781	$pagination_args['_wpnonce'] = $nonce;
3782	}
3783	}
3784
3785	// Preserve content type filter if present
3786	if ($content_type_filter) {
3787	$pagination_args['content_type'] = $content_type_filter;
3788	}
3789
3790	// Build clean base URL
3791	$base_url = add_query_arg($pagination_args, admin_url('admin.php'));
3792
3793	$page_links = paginate_links(array(
3794	'base' => $base_url . '%_%',
3795	'format' => '&paged=%#%',
3796	'prev_text' => __('« Previous', 'mxchat'),
3797	'next_text' => __('Next »', 'mxchat'),
3798	'total' => $total_pages,
3799	'current' => $current_page,
3800	'type' => 'plain',
3801	));
3802	} else {
3803	$page_links = '';
3804	}
3805
3806	// ================================
3807	// PROCESSING STATUS RETRIEVAL
3808	// ================================
3809
3810	// Retrieve processing statuses using queue-based method
3811	$processing_statuses = $knowledge_manager->mxchat_get_processing_statuses();
3812	$pdf_status = $processing_statuses['pdf_status'];
3813	$sitemap_status = $processing_statuses['sitemap_status'];
3814	$is_processing = $processing_statuses['is_processing'];
3815
3816	//error_log('=== DEBUG: mxchat_create_prompts_page data preparation completed ===');
3817
3818	// ================================
3819	// RENDER PAGE WITH NEW SIDEBAR LAYOUT
3820	// ================================
3821
3822	// Include the new knowledge page template
3823	require_once plugin_dir_path(__FILE__) . 'admin-knowledge-page.php';
3824
3825	// Package all page data for the render function
3826	$page_data = array(
3827	'prompts' => $prompts,
3828	'total_records' => $total_records,
3829	'total_pages' => $total_pages,
3830	'current_page' => $current_page,
3831	'per_page' => $per_page,
3832	'page_links' => $page_links,
3833	'search_query' => $search_query,
3834	'content_type_filter' => $content_type_filter,
3835	'data_source' => $data_source,
3836	'use_pinecone' => $use_pinecone,
3837	'use_vectorstore' => $use_vectorstore,
3838	'multibot_active' => $multibot_active,
3839	'current_bot_id' => $current_bot_id,
3840	'pdf_status' => $pdf_status,
3841	'sitemap_status' => $sitemap_status,
3842	'is_processing' => $is_processing,
3843	'total_in_database' => $total_in_database ?? 0,
3844	'showing_recent_only' => $showing_recent_only ?? false,
3845	);
3846
3847	// Render the new sidebar-based page
3848	mxchat_render_knowledge_page($this, $knowledge_manager, $page_data);
3849	}
3850
3851	/**
3852	* Get bot-specific Pinecone configuration
3853	* Used in the knowledge retrieval functions
3854	*/
3855	private function get_bot_pinecone_config($bot_id = 'default') {
3856	//error_log("MXCHAT DEBUG: get_bot_pinecone_config called for bot: " . $bot_id);
3857
3858	// If default bot or multi-bot add-on not active, use default Pinecone config
3859	if ($bot_id === 'default' \|\| !class_exists('MxChat_Multi_Bot_Manager')) {
3860	//error_log("MXCHAT DEBUG: Using default Pinecone config (no multi-bot or bot is 'default')");
3861	$addon_options = get_option('mxchat_pinecone_addon_options', array());
3862	$config = array(
3863	'use_pinecone' => (isset($addon_options['mxchat_use_pinecone']) && $addon_options['mxchat_use_pinecone'] === '1'),
3864	'api_key' => $addon_options['mxchat_pinecone_api_key'] ?? '',
3865	'host' => $addon_options['mxchat_pinecone_host'] ?? '',
3866	'namespace' => $addon_options['mxchat_pinecone_namespace'] ?? ''
3867	);
3868	//error_log("MXCHAT DEBUG: Default config - use_pinecone: " . ($config['use_pinecone'] ? 'true' : 'false'));
3869	return $config;
3870	}
3871
3872	//error_log("MXCHAT DEBUG: Calling filter 'mxchat_get_bot_pinecone_config' for bot: " . $bot_id);
3873
3874	// Hook for multi-bot add-on to provide bot-specific Pinecone config
3875	$bot_pinecone_config = apply_filters('mxchat_get_bot_pinecone_config', array(), $bot_id);
3876
3877	if (!empty($bot_pinecone_config)) {
3878	//error_log("MXCHAT DEBUG: Got bot-specific config from filter");
3879	//error_log(" - use_pinecone: " . (isset($bot_pinecone_config['use_pinecone']) ? ($bot_pinecone_config['use_pinecone'] ? 'true' : 'false') : 'not set'));
3880	//error_log(" - host: " . ($bot_pinecone_config['host'] ?? 'not set'));
3881	//error_log(" - namespace: " . ($bot_pinecone_config['namespace'] ?? 'not set'));
3882	} else {
3883	//error_log("MXCHAT DEBUG: Filter returned empty config!");
3884	}
3885
3886	return is_array($bot_pinecone_config) ? $bot_pinecone_config : array();
3887	}
3888
3889	public function mxchat_delete_chat_history() {
3890	if (!current_user_can('manage_options')) {
3891	echo wp_json_encode(['error' => esc_html__('You do not have sufficient permissions.', 'mxchat')]);
3892	wp_die();
3893	}
3894	check_ajax_referer('mxchat_delete_chat_history', 'security');
3895
3896	if (!isset($_POST['delete_session_ids']) \|\| !is_array($_POST['delete_session_ids'])) {
3897	echo wp_json_encode(['error' => esc_html__('No chat sessions selected for deletion.', 'mxchat')]);
3898	wp_die();
3899	}
3900
3901	global $wpdb;
3902	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
3903	$translations_table = $wpdb->prefix . 'mxchat_transcript_translations';
3904	$has_translations = $wpdb->get_var("SHOW TABLES LIKE '$translations_table'") === $translations_table;
3905
3906	// When true, any lead attached to these sessions is fully wiped (all their sessions,
3907	// across the whole table). Default false: the chat rows go away but the lead is
3908	// preserved as a separate "chat deleted" lead in the Leads tab.
3909	$also_delete_lead = !empty($_POST['also_delete_lead']) && $_POST['also_delete_lead'] !== 'false';
3910
3911	$deleted_count = 0;
3912	$preserved_as_deleted_leads = 0;
3913	$emails_to_fully_wipe = [];
3914
3915	foreach ((array) $_POST['delete_session_ids'] as $session_id) {
3916	$session_id_sanitized = sanitize_text_field($session_id);
3917	if ($session_id_sanitized === '') {
3918	continue;
3919	}
3920
3921	// Capture the lead info attached to this session before we delete the rows.
3922	$lead_row = $wpdb->get_row($wpdb->prepare(
3923	"SELECT user_email, user_name, MAX(timestamp) AS last_ts
3924	FROM {$table_name}
3925	WHERE session_id = %s AND user_email IS NOT NULL AND user_email != ''
3926	GROUP BY user_email, user_name
3927	ORDER BY last_ts DESC LIMIT 1",
3928	$session_id_sanitized
3929	));
3930
3931	wp_cache_delete('chat_session_' . $session_id_sanitized, 'mxchat_chat_sessions');
3932	$wpdb->delete($table_name, ['session_id' => $session_id_sanitized]);
3933
3934	if ($has_translations) {
3935	$wpdb->delete($translations_table, ['session_id' => $session_id_sanitized]);
3936	}
3937
3938	delete_option('mxchat_history_' . $session_id_sanitized);
3939	delete_option('mxchat_agent_name_' . $session_id_sanitized);
3940
3941	if ($lead_row && !empty($lead_row->user_email)) {
3942	if ($also_delete_lead) {
3943	// Full-wipe requested — queue the email so that all their sessions and
3944	// related options get swept below. Also clear this session's pre-chat
3945	// capture options (they're no longer meaningful).
3946	$emails_to_fully_wipe[strtolower($lead_row->user_email)] = $lead_row->user_email;
3947	delete_option('mxchat_email_' . $session_id_sanitized);
3948	delete_option('mxchat_name_' . $session_id_sanitized);
3949	} else {
3950	// Preserve the lead in a "Chat deleted" state via distinct option keys so
3951	// they stay out of the orphan bucket (orphan = pre-chat form dropoff).
3952	update_option('mxchat_lead_del_email_' . $session_id_sanitized, $lead_row->user_email, false);
3953	if (!empty($lead_row->user_name)) {
3954	update_option('mxchat_lead_del_name_' . $session_id_sanitized, $lead_row->user_name, false);
3955	}
3956	if (!empty($lead_row->last_ts)) {
3957	update_option('mxchat_lead_del_ts_' . $session_id_sanitized, $lead_row->last_ts, false);
3958	}
3959	// Clean up pre-chat capture options for this session — chat_deleted supersedes.
3960	delete_option('mxchat_email_' . $session_id_sanitized);
3961	delete_option('mxchat_name_' . $session_id_sanitized);
3962	$preserved_as_deleted_leads++;
3963	}
3964	} else {
3965	// No lead attached — nothing to preserve. Clean up any orphan options anyway.
3966	delete_option('mxchat_email_' . $session_id_sanitized);
3967	delete_option('mxchat_name_' . $session_id_sanitized);
3968	}
3969
3970	$deleted_count++;
3971	}
3972
3973	// Opt-in full-lead wipe: sweep every remaining row + every option key (including
3974	// chat_deleted preservation) for each affected email. Reuses the same internal
3975	// helper as the Leads-tab Delete button for consistency.
3976	if (!empty($emails_to_fully_wipe)) {
3977	self::mxchat_wipe_leads_by_email(array_values($emails_to_fully_wipe));
3978	}
3979
3980	wp_cache_delete('all_chat_sessions', 'mxchat_chat_sessions');
3981
3982	echo wp_json_encode([
3983	'success' => sprintf(
3984	esc_html__('%d chat session(s) have been deleted.', 'mxchat'),
3985	$deleted_count
3986	),
3987	'preserved_as_deleted_leads' => $preserved_as_deleted_leads,
3988	'leads_fully_wiped' => count($emails_to_fully_wipe),
3989	]);
3990	wp_die();
3991	}
3992
3993	/**
3994	* Format transcript message content with markdown processing
3995	* Converts markdown links, bold, italic, code blocks, and plain URLs to HTML
3996	*/
3997	private function format_transcript_message($text) {
3998	if (empty($text)) {
3999	return '';
4000	}
4001
4002	// Normalize line endings and clean up excessive whitespace
4003	$text = str_replace("\r\n", "\n", $text);
4004	$text = str_replace("\r", "\n", $text);
4005
4006	// Clean up existing <br> tags that may have been saved (legacy data)
4007	// Convert <br>, <br/>, <br /> back to newlines for consistent processing
4008	$text = preg_replace('/<br\s\/?>\s/i', "\n", $text);
4009
4010	// Collapse 3+ consecutive newlines to just 2 (paragraph break)
4011	$text = preg_replace('/\n{3,}/', "\n\n", $text);
4012
4013	// Process markdown headers (# Header)
4014	$text = preg_replace_callback('/^(#{1,6})\s+(.+)$/m', function($matches) {
4015	$level = strlen($matches[1]);
4016	$content = esc_html(trim($matches[2]));
4017	return "<h{$level}>{$content}</h{$level}>";
4018	}, $text);
4019
4020	// Process code blocks with triple backticks
4021	$text = preg_replace_callback('/```(\w+)?\n?([\s\S]*?)```/', function($matches) {
4022	$language = !empty($matches[1]) ? ' class="language-' . esc_attr($matches[1]) . '"' : '';
4023	$code = esc_html($matches[2]);
4024	return "<pre><code{$language}>{$code}</code></pre>";
4025	}, $text);
4026
4027	// Process inline code with single backticks
4028	$text = preg_replace('/`([^`]+)`/', '<code>$1</code>', $text);
4029
4030	// Process bold text text or __text__
4031	$text = preg_replace('/\\(.+?)\\/', '<strong>$1</strong>', $text);
4032	$text = preg_replace('/__(.+?)__/', '<strong>$1</strong>', $text);
4033
4034	// Process italic text text or _text_ (but not if part of URL)
4035	$text = preg_replace('/(?<![_\w])\([^]+)\(?![*\w])/', '<em>$1</em>', $text);
4036	$text = preg_replace('/(?<![_\w])_([^_]+)_(?![\w])/', '<em>$1</em>', $text);
4037
4038	// Process markdown links [text](url)
4039	$text = preg_replace_callback('/\[([^\]]+)\]$(https?:\/\/[^\s)]+)$/', function($matches) {
4040	$link_text = esc_html($matches[1]);
4041	$url = esc_url($matches[2]);
4042	return "<a href=\"{$url}\" target=\"_blank\" rel=\"noopener\">{$link_text}</a>";
4043	}, $text);
4044
4045	// Process citation-style brackets [URL]
4046	$text = preg_replace_callback('/\[(https?:\/\/[^\]]+)\]/', function($matches) {
4047	$url = esc_url($matches[1]);
4048	return "<a href=\"{$url}\" target=\"_blank\" rel=\"noopener\">{$url}</a>";
4049	}, $text);
4050
4051	// Process standalone URLs (not already in links or img src)
4052	$text = preg_replace_callback(
4053	'/(?<!href="\|src="\|">)(https?:\/\/[^\s<>"]+)(?![^<]*<\/a>)/',
4054	function($matches) {
4055	$url = esc_url($matches[1]);
4056	// Truncate display URL if too long
4057	$display = strlen($matches[1]) > 50 ? substr($matches[1], 0, 47) . '...' : $matches[1];
4058	return "<a href=\"{$url}\" target=\"_blank\" rel=\"noopener\">{$display}</a>";
4059	},
4060	$text
4061	);
4062
4063	// Process mailto links
4064	$text = preg_replace_callback('/\[([^\]]+)\]$(mailto:[^)]+)$/', function($matches) {
4065	$link_text = esc_html($matches[1]);
4066	$mailto = esc_url($matches[2]);
4067	return "<a href=\"{$mailto}\">{$link_text}</a>";
4068	}, $text);
4069
4070	// Convert paragraphs: split by double newlines, wrap in <p> tags
4071	// This creates proper paragraph structure instead of excessive <br> tags
4072	$paragraphs = preg_split('/\n\n+/', $text);
4073
4074	// Filter out empty paragraphs but preserve content like "0"
4075	$paragraphs = array_values(array_filter(array_map('trim', $paragraphs), function($p) {
4076	return $p !== '';
4077	}));
4078
4079	if (empty($paragraphs)) {
4080	// No content after filtering
4081	return '';
4082	} elseif (count($paragraphs) > 1) {
4083	// Multiple paragraphs - wrap each in <p> tags, convert single newlines to <br>
4084	$formatted_paragraphs = array_map(function($p) {
4085	return nl2br($p);
4086	}, $paragraphs);
4087	$text = '<p>' . implode('</p><p>', $formatted_paragraphs) . '</p>';
4088	} else {
4089	// Single paragraph - just convert newlines to <br>
4090	$text = nl2br($paragraphs[0]);
4091	}
4092
4093	return $text;
4094	}
4095
4096	/**
4097	* AJAX handler to fetch RAG context for a specific message
4098	* Used by the transcript viewer to show retrieved documents
4099	*/
4100	public function mxchat_get_rag_context() {
4101	// Check permissions
4102	if (!current_user_can('manage_options')) {
4103	wp_send_json_error(['message' => esc_html__('You do not have sufficient permissions.', 'mxchat')]);
4104	wp_die();
4105	}
4106
4107	// Validate message ID
4108	if (!isset($_POST['message_id']) \|\| empty($_POST['message_id'])) {
4109	wp_send_json_error(['message' => esc_html__('Message ID is required.', 'mxchat')]);
4110	wp_die();
4111	}
4112
4113	$message_id = absint($_POST['message_id']);
4114
4115	global $wpdb;
4116	$table_name = $wpdb->prefix . 'mxchat_chat_transcripts';
4117
4118	// Fetch the RAG context for this message
4119	$result = $wpdb->get_row($wpdb->prepare(
4120	"SELECT rag_context FROM {$table_name} WHERE id = %d",
4121	$message_id
4122	));
4123
4124	if (!$result \|\| empty($result->rag_context)) {
4125	wp_send_json_error(['message' => esc_html__('No RAG context found for this message.', 'mxchat')]);
4126	wp_die();
4127	}
4128
4129	// Decode the JSON data
4130	$rag_context = json_decode($result->rag_context, true);
4131
4132	if (json_last_error() !== JSON_ERROR_NONE) {
4133	wp_send_json_error(['message' => esc_html__('Invalid RAG context data.', 'mxchat')]);
4134	wp_die();
4135	}
4136
4137	wp_send_json_success($rag_context);
4138	wp_die();
4139	}
4140
4141	public function display_admin_notices() {
4142	// Check if we're on a MXChat admin page
4143	$screen = get_current_screen();
4144	if (!$screen \|\| strpos($screen->base, 'mxchat') === false) {
4145	return;
4146	}
4147
4148	$dismiss_button = '<button type="button" class="notice-dismiss"><span class="screen-reader-text">' . esc_html__('Dismiss this notice.', 'mxchat') . '</span></button>';
4149
4150	// Check for error notices
4151	$error_notice = get_transient('mxchat_admin_notice_error');
4152	if ($error_notice) {
4153	echo '<div class="notice notice-error is-dismissible"><p>' . wp_kses_post($error_notice) . '</p>' . $dismiss_button . '</div>';
4154	delete_transient('mxchat_admin_notice_error');
4155	}
4156
4157	// Check for success notices
4158	$success_notice = get_transient('mxchat_admin_notice_success');
4159	if ($success_notice) {
4160	echo '<div class="notice notice-success is-dismissible"><p>' . wp_kses_post($success_notice) . '</p>' . $dismiss_button . '</div>';
4161	delete_transient('mxchat_admin_notice_success');
4162	}
4163
4164	// Check for info notices
4165	$info_notice = get_transient('mxchat_admin_notice_info');
4166	if ($info_notice) {
4167	echo '<div class="notice notice-info is-dismissible"><p>' . wp_kses_post($info_notice) . '</p>' . $dismiss_button . '</div>';
4168	delete_transient('mxchat_admin_notice_info');
4169	}
4170	}
4171
4172
4173	public function mxchat_create_activation_page() {
4174	// Include the new Pro & Extensions page template
4175	require_once plugin_dir_path(__FILE__) . 'admin-pro-page.php';
4176
4177	// Get addons configuration from the MxChat_Addons class
4178	require_once plugin_dir_path(__FILE__) . 'class-mxchat-addons.php';
4179	$addons_instance = new MxChat_Addons();
4180	$addons_config = $addons_instance->get_addons_config();
4181
4182	// Render the consolidated Pro & Extensions page
4183	mxchat_render_pro_page($this, $addons_config);
4184	}
4185
4186	/**
4187	* Check if current activation is linked to a domain
4188	* This checks YOUR website's database, not the user's local database
4189	*/
4190	public function is_current_activation_linked($domain) {
4191	$license_key = get_option('mxchat_activation_key');
4192	$email = get_option('mxchat_pro_email');
4193
4194	if (empty($license_key) \|\| empty($email)) {
4195	return false;
4196	}
4197
4198	// Check with YOUR website's API
4199	$response = wp_remote_post('https://mxchat.ai/mxchat-api/check-domain', array(
4200	'body' => array(
4201	'license_key' => $license_key,
4202	'email' => $email,
4203	'domain' => $domain
4204	),
4205	'timeout' => 10,
4206	'sslverify' => false
4207	));
4208
4209	if (is_wp_error($response)) {
4210	return false;
4211	}
4212
4213	$body = json_decode(wp_remote_retrieve_body($response), true);
4214	return isset($body['success']) && $body['success'] && isset($body['data']['linked']) && $body['data']['linked'];
4215	}
4216
4217
4218	public function mxchat_actions_page_html() {
4219	if (!current_user_can('manage_options')) {
4220	return;
4221	}
4222
4223	global $wpdb;
4224	$table_name = $wpdb->prefix . 'mxchat_intents';
4225
4226	// Get stats for dashboard
4227	$total_actions = $wpdb->get_var("SELECT COUNT(*) FROM $table_name");
4228	$enabled_actions = $wpdb->get_var("SELECT COUNT(*) FROM $table_name WHERE enabled = 1");
4229	$disabled_actions = $total_actions - $enabled_actions;
4230
4231	// Get unique action types count
4232	$action_types_count = $wpdb->get_var("SELECT COUNT(DISTINCT callback_function) FROM $table_name");
4233
4234	// Get action type distribution
4235	$type_distribution_raw = $wpdb->get_results("SELECT callback_function, COUNT(*) as count FROM $table_name GROUP BY callback_function ORDER BY count DESC LIMIT 10");
4236	$available_callbacks = $this->mxchat_get_available_callbacks();
4237	$callback_groups = $this->mxchat_get_available_callbacks(true, true);
4238
4239	$action_type_distribution = array();
4240	foreach ($type_distribution_raw as $row) {
4241	$label = isset($available_callbacks[$row->callback_function]['label'])
4242	? $available_callbacks[$row->callback_function]['label']
4243	: $row->callback_function;
4244	$action_type_distribution[$label] = $row->count;
4245	}
4246
4247	// Prepare page data
4248	$page_data = array(
4249	'total_actions' => $total_actions,
4250	'enabled_actions' => $enabled_actions,
4251	'disabled_actions' => $disabled_actions,
4252	'action_types_count' => $action_types_count,
4253	'action_type_distribution' => $action_type_distribution,
4254	'available_callbacks' => $available_callbacks,
4255	'callback_groups' => $callback_groups,
4256	);
4257
4258	// Include and render the new template
4259	require_once plugin_dir_path(__FILE__) . 'admin-actions-page.php';
4260	mxchat_render_actions_page($this, $page_data);
4261	}
4262
4263	/**
4264	* LEGACY HTML - Preserved below for reference, to be removed in future update
4265	*/
4266	function mxchat_actions_page_legacy_html() {
4267	// This function is deprecated and no longer used
4268	// The new template is in includes/admin-actions-page.php
4269	?>
4270	<div class="wrap mxchat-wrapper">
4271	<!-- Hero Section -->
4272	<div class="mxchat-hero">
4273	<h1 class="mxchat-main-title">
4274	<span class="mxchat-gradient-text">Actions</span> Manager
4275	</h1>
4276	<p class="mxchat-hero-subtitle">
4277	<?php esc_html_e('Create and manage custom actions to enhance your chatbot\'s capabilities.', 'mxchat'); ?>
4278	</p>
4279	</div>
4280
4281	<!-- Actions Header with Search and Filter -->
4282	<div class="mxchat-actions-header">
4283	<div class="mxchat-actions-filters">
4284	<form method="get" class="mxchat-search-form">
4285	<input type="hidden" name="page" value="mxchat-actions">
4286	<div class="mxchat-search-group">
4287	<span class="dashicons dashicons-search"></span>
4288	<input type="text" name="s" class="mxchat-search-input"
4289	placeholder="<?php esc_attr_e('Search Actions', 'mxchat'); ?>"
4290	value="<?php echo esc_attr($search_term); ?>">
4291	</div>
4292	<select name="callback_filter" class="mxchat-action-filter">
4293	<option value=""><?php esc_html_e('All Action Types', 'mxchat'); ?></option>
4294	<?php foreach ($available_callbacks as $function => $callback_data) :
4295	$label = $callback_data['label']; ?>
4296	<option value="<?php echo esc_attr($function); ?>"
4297	<?php selected($callback_filter, $function); ?>>
4298	<?php echo esc_html($label); ?>
4299	</option>
4300	<?php endforeach; ?>
4301	</select>
4302	<button type="submit" class="mxchat-button-secondary">
4303	<?php esc_html_e('Filter', 'mxchat'); ?>
4304	</button>
4305	</form>
4306	</div>
4307	<div class="mxchat-actions-controls">
4308	<button type="button" id="mxchat-add-action-btn" class="mxchat-button-primary">
4309	<span class="dashicons dashicons-plus-alt"></span>
4310	<?php esc_html_e('Add New Action', 'mxchat'); ?>
4311	</button>
4312	</div>
4313	</div>
4314
4315	<!-- Actions Grid Layout - All actions in a single grid -->
4316	<div class="mxchat-actions-grid">
4317	<div class="mxchat-cards-container">
4318	<?php if (!empty($actions)) : ?>
4319	<?php foreach ($actions as $action) :
4320	$callback_function = $action->callback_function;
4321	$callback_label = isset($available_callbacks[$callback_function]['label'])
4322	? $available_callbacks[$callback_function]['label']
4323	: $callback_function;
4324	$threshold_value = isset($action->similarity_threshold)
4325	? round($action->similarity_threshold * 100)
4326	: 85;
4327
4328	// Check if this is a form action
4329	$is_form_action = strpos($action->intent_label, 'Form ') === 0;
4330
4331	// Get action status (enabled/disabled) - default to true if column doesn't exist
4332	$is_enabled = isset($action->enabled) ? (bool)$action->enabled : true;
4333
4334	// Get enabled bots for display
4335	$enabled_bots = [];
4336	if (isset($action->enabled_bots) && !empty($action->enabled_bots)) {
4337	$enabled_bots = json_decode($action->enabled_bots, true);
4338	if (!is_array($enabled_bots)) {
4339	$enabled_bots = ['default'];
4340	}
4341	} else {
4342	$enabled_bots = ['default']; // Backward compatibility
4343	}
4344	?>
4345	<div class="mxchat-action-card <?php echo $is_form_action ? 'mxchat-form-action' : ''; ?>">
4346	<div class="mxchat-card-header">
4347	<div class="mxchat-card-title"><?php echo esc_html($action->intent_label); ?></div>
4348	<div class="mxchat-card-toggle">
4349	<label class="mxchat-switch">
4350	<input type="checkbox" class="mxchat-action-toggle"
4351	data-action-id="<?php echo esc_attr($action->id); ?>"
4352	<?php checked($is_enabled); ?>>
4353	<span class="mxchat-slider round"></span>
4354	</label>
4355	</div>
4356	</div>
4357
4358	<div class="mxchat-card-body">
4359	<div class="mxchat-card-description">
4360	<strong><?php esc_html_e('Type:', 'mxchat'); ?></strong>
4361	<?php echo esc_html($callback_label); ?>
4362	</div>
4363
4364	<div class="mxchat-card-phrases">
4365	<strong><?php esc_html_e('Trigger phrases:', 'mxchat'); ?></strong>
4366	<div class="mxchat-phrases-preview">
4367	<?php
4368	// Check if the helper function exists, otherwise use a simple substring
4369	if (method_exists($this, 'get_trimmed_phrases')) {
4370	echo esc_html($this->get_trimmed_phrases($action->phrases));
4371	} else {
4372	echo esc_html(strlen($action->phrases) > 100 ?
4373	substr($action->phrases, 0, 97) . '...' :
4374	$action->phrases);
4375	}
4376	?>
4377	</div>
4378	</div>
4379
4380	<div class="mxchat-threshold-control">
4381	<div class="mxchat-threshold-label">
4382	<?php esc_html_e('Similarity Threshold:', 'mxchat'); ?>
4383	<span class="mxchat-threshold-value"><?php echo esc_html($threshold_value); ?>%</span>
4384	</div>
4385	</div>
4386
4387	<!-- Bot Availability Display (Read-only) -->
4388	<div class="mxchat-card-bots">
4389	<strong><?php esc_html_e('Assigned bots:', 'mxchat'); ?></strong>
4390	<div class="mxchat-bot-badges">
4391	<?php
4392	foreach ($enabled_bots as $bot_id) {
4393	if ($bot_id === 'default') {
4394	echo '<span class="mxchat-bot-badge">' . esc_html__('Default Bot', 'mxchat') . '</span>';
4395	} else {
4396	// Try to get bot name from multi-bot manager
4397	if (class_exists('MxChat_Multi_Bot_Core_Manager')) {
4398	$multi_bot_manager = MxChat_Multi_Bot_Core_Manager::get_instance();
4399	$available_bots = $multi_bot_manager->get_available_bots();
4400	$bot_name = isset($available_bots[$bot_id]) ? $available_bots[$bot_id] : $bot_id;
4401	echo '<span class="mxchat-bot-badge">' . esc_html($bot_name) . '</span>';
4402	} else {
4403	echo '<span class="mxchat-bot-badge">' . esc_html($bot_id) . '</span>';
4404	}
4405	}
4406	}
4407	?>
4408	</div>
4409	</div>
4410	</div>
4411
4412	<div class="mxchat-card-footer">
4413	<?php
4414	// Check if it's a form action
4415	$is_form_action = preg_match('/Form (\d+)/', $action->intent_label, $form_matches);
4416
4417	// Check if it's a recommendation flow action
4418	$is_flow_action = preg_match('/Recommendation Flow (\d+)/', $action->intent_label, $flow_matches);
4419
4420	if ($is_form_action) {
4421	$form_id = isset($form_matches[1]) ? $form_matches[1] : '';
4422	?>
4423	<a href="<?php echo esc_url(admin_url('admin.php?page=mxchat-forms&action=edit&form_id=' . $form_id)); ?>"
4424	class="mxchat-button-primary">
4425	<span class="dashicons dashicons-feedback"></span>
4426	<?php esc_html_e('Edit Form', 'mxchat'); ?>
4427	</a>
4428	<?php } elseif ($is_flow_action) {
4429	?>
4430	<a href="<?php echo esc_url(admin_url('admin.php?page=mxchat-smart-recommender')); ?>"
4431	class="mxchat-button-primary">
4432	<span class="dashicons dashicons-list-view"></span>
4433	<?php esc_html_e('Manage Flows', 'mxchat'); ?>
4434	</a>
4435	<?php } else { ?>
4436	<button type="button"
4437	class="mxchat-button-secondary mxchat-edit-button"
4438	data-action-id="<?php echo esc_attr($action->id); ?>"
4439	data-phrases="<?php echo esc_attr($action->phrases); ?>"
4440	data-label="<?php echo esc_attr($action->intent_label); ?>"
4441	data-threshold="<?php echo esc_attr(round($action->similarity_threshold * 100)); ?>"
4442	data-callback-function="<?php echo esc_attr($action->callback_function); ?>"
4443	data-enabled-bots="<?php echo esc_attr(json_encode($enabled_bots)); ?>">
4444	<span class="dashicons dashicons-edit"></span>
4445	<?php esc_html_e('Edit', 'mxchat'); ?>
4446	</button>
4447	<form method="post"
4448	action="<?php echo esc_url(admin_url('admin-post.php')); ?>"
4449	class="mxchat-delete-form"
4450	onsubmit="return confirm('<?php esc_attr_e('Are you sure you want to delete this action?', 'mxchat'); ?>');">
4451	<?php wp_nonce_field('mxchat_delete_intent_nonce'); ?>
4452	<input type="hidden" name="action" value="mxchat_delete_intent">
4453	<input type="hidden" name="intent_id" value="<?php echo esc_attr($action->id); ?>">
4454	<button type="submit" class="mxchat-button-text mxchat-delete-button">
4455	<span class="dashicons dashicons-trash"></span>
4456	<?php esc_html_e('Delete', 'mxchat'); ?>
4457	</button>
4458	</form>
4459	<?php } ?>
4460	</div>
4461	</div>
4462	<?php endforeach; ?>
4463	<?php else : ?>
4464	<!-- If no actions found -->
4465	<div class="mxchat-no-actions">
4466	<div class="mxchat-empty-state">
4467	<span class="dashicons dashicons-format-chat"></span>
4468	<h2><?php esc_html_e('No actions found', 'mxchat'); ?></h2>
4469	<p><?php esc_html_e('Get started by creating your first action to enhance your chatbot.', 'mxchat'); ?></p>
4470	<button type="button" id="mxchat-create-first-action" class="mxchat-button-primary">
4471	<?php esc_html_e('Create Your First Action', 'mxchat'); ?>
4472	</button>
4473	</div>
4474	</div>
4475	<?php endif; ?>
4476	</div>
4477	</div>
4478
4479	<?php if ($total_pages > 1) : ?>
4480	<div class="mxchat-pagination">
4481	<?php
4482	echo paginate_links(array(
4483	'base' => add_query_arg('paged', '%#%'),
4484	'format' => '',
4485	'prev_text' => __('« Previous', 'mxchat'),
4486	'next_text' => __('Next »', 'mxchat'),
4487	'total' => $total_pages,
4488	'current' => $page
4489	));
4490	?>
4491	</div>
4492	<?php endif; ?>
4493
4494	<!-- Add/Edit Action Modal with Step-Based Approach -->
4495	<!-- Complete Modal HTML with Defined Groups Variable -->
4496	<div id="mxchat-action-modal" class="mxchat-modal" style="display: none;">
4497	<div class="mxchat-modal-content">
4498	<span class="mxchat-modal-close">×</span>
4499
4500	<form id="mxchat-action-form" method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
4501	<!-- Dynamic nonce field -->
4502	<div id="action-nonce-container">
4503	<?php wp_nonce_field('mxchat_add_intent_nonce', 'add_intent_nonce'); ?>
4504	</div>
4505	<input type="hidden" name="action" id="form_action_type" value="mxchat_add_intent">
4506	<input type="hidden" name="intent_id" id="edit_action_id" value="">
4507	<input type="hidden" name="callback_function" id="callback_function" value="">
4508
4509	<!-- Step 1: Action Type Selection -->
4510	<div id="mxchat-action-step-1" class="mxchat-action-step active">
4511	<div class="mxchat-step-indicator">
4512	<div class="mxchat-step-number">1</div>
4513	<div class="mxchat-step-title"><?php esc_html_e('Select Action Type', 'mxchat'); ?></div>
4514	</div>
4515
4516	<div id="mxchat-action-type-selector" class="mxchat-action-type-selector">
4517	<div class="mxchat-action-type-search">
4518	<span class="dashicons dashicons-search"></span>
4519	<input type="text" id="action-type-search" placeholder="<?php esc_attr_e('Search action types...', 'mxchat'); ?>" class="mxchat-action-type-search-input">
4520	</div>
4521
4522	<?php
4523	// Get the callbacks - IMPORTANT: Define the $groups variable here
4524	$groups = $this->mxchat_get_available_callbacks(true, true);
4525	?>
4526
4527	<div class="mxchat-action-type-categories">
4528	<button type="button" class="mxchat-category-button active" data-category="all"><?php esc_html_e('All', 'mxchat'); ?></button>
4529	<?php
4530	// Get unique categories from the defined groups
4531	foreach ($groups as $group_label => $group_callbacks) :
4532	$category_slug = sanitize_title($group_label);
4533	?>
4534	<button type="button" class="mxchat-category-button" data-category="<?php echo esc_attr($category_slug); ?>"><?php echo esc_html($group_label); ?></button>
4535	<?php endforeach; ?>
4536	</div>
4537
4538	<div class="mxchat-action-types-grid">
4539	<?php
4540	// Generate action cards from available callbacks
4541	foreach ($groups as $group_label => $group_callbacks) :
4542	$category_slug = sanitize_title($group_label);
4543
4544	foreach ($group_callbacks as $function => $data) :
4545	$label = $data['label'];
4546	$icon = isset($data['icon']) ? $data['icon'] : 'admin-generic';
4547	$description = isset($data['description']) ? $data['description'] : '';
4548	$is_addon = isset($data['addon']) && $data['addon'] !== false;
4549	$addon_name = isset($data['addon_name']) ? $data['addon_name'] : '';
4550	$is_installed = isset($data['installed']) ? $data['installed'] : true;
4551	$is_promo = !empty($data['addon_promo']) && !$is_installed;
4552
4553	// Determine card status and styling
4554	$card_class = 'mxchat-action-type-card';
4555	$icon_class = 'mxchat-action-type-icon';
4556	$status_badge = '';
4557
4558	if ($is_promo) {
4559	// Promotional card — not selectable, just informational
4560	$card_class .= ' not-installed mxchat-promo-card';
4561	$status_badge = '<span class="mxchat-addon-badge">' . esc_html__('Add-on Required', 'mxchat') . '</span>';
4562	} elseif ($is_addon && !$is_installed) {
4563	// Add-on not installed
4564	$card_class .= ' not-installed';
4565	$status_badge .= '<span class="mxchat-addon-badge">' . esc_html__('Add-on Required', 'mxchat') . '</span>';
4566	}
4567
4568	// Default description if none provided
4569	if (empty($description)) {
4570	$description = sprintf(
4571	esc_html__('Use the %s action in your chatbot', 'mxchat'),
4572	$label
4573	);
4574	}
4575	?>
4576	<div class="<?php echo esc_attr($card_class); ?>"
4577	data-category="<?php echo esc_attr($category_slug); ?>"
4578	<?php if (!$is_promo) : ?>
4579	data-value="<?php echo esc_attr($function); ?>"
4580	data-label="<?php echo esc_attr($label); ?>"
4581	<?php endif; ?>
4582	data-pro="false"
4583	data-addon="<?php echo esc_attr($is_addon ? $data['addon'] : ''); ?>"
4584	data-installed="<?php echo $is_installed ? 'true' : 'false'; ?>"
4585	<?php if ($is_promo) : ?>data-promo="true"<?php endif; ?>>
4586	<div class="<?php echo esc_attr($icon_class); ?>">
4587	<span class="dashicons dashicons-<?php echo esc_attr($icon); ?>"></span>
4588	</div>
4589	<div class="mxchat-action-type-info">
4590	<h4><?php echo esc_html($label); ?></h4>
4591	<p><?php echo esc_html($description); ?></p>
4592	<?php if (!empty($status_badge)) : ?>
4593	<?php echo $status_badge; ?>
4594	<?php endif; ?>
4595
4596	<?php if ($is_promo \|\| ($is_addon && !$is_installed)) : ?>
4597	<div class="mxchat-addon-info">
4598	<?php echo esc_html(sprintf(
4599	__('Requires %s', 'mxchat'),
4600	$addon_name
4601	)); ?>
4602	— <a href="https://mxchat.ai/" target="_blank"><?php esc_html_e('Get Add-on', 'mxchat'); ?></a>
4603	</div>
4604	<?php endif; ?>
4605	</div>
4606	</div>
4607	<?php endforeach;
4608	endforeach; ?>
4609	</div>
4610	</div>
4611
4612	<div class="mxchat-modal-actions">
4613	<button type="button" class="mxchat-button-secondary mxchat-modal-cancel">
4614	<?php esc_html_e('Cancel', 'mxchat'); ?>
4615	</button>
4616	</div>
4617	</div>
4618
4619	<!-- Step 2: Action Configuration -->
4620	<div id="mxchat-action-step-2" class="mxchat-action-step">
4621	<div class="mxchat-step-indicator">
4622	<div class="mxchat-step-number">2</div>
4623	<div class="mxchat-step-title"><?php esc_html_e('Configure Action', 'mxchat'); ?></div>
4624	</div>
4625
4626	<div class="mxchat-selected-action">
4627	<button type="button" class="mxchat-back-button" id="mxchat-back-to-step-1">
4628	<span class="dashicons dashicons-arrow-left-alt"></span>
4629	<?php esc_html_e('Back to Action Types', 'mxchat'); ?>
4630	</button>
4631	<div class="mxchat-selected-action-info">
4632	<div id="selected-action-icon" class="mxchat-action-type-icon">
4633	<span class="dashicons dashicons-admin-generic"></span>
4634	</div>
4635	<div class="mxchat-selected-action-details">
4636	<h3 id="selected-action-title"><?php esc_html_e('Selected Action', 'mxchat'); ?></h3>
4637	<p id="selected-action-description"><?php esc_html_e('Configure this action for your chatbot', 'mxchat'); ?></p>
4638	</div>
4639	</div>
4640	</div>
4641
4642	<div class="mxchat-form-group">
4643	<label for="intent_label">
4644	<?php esc_html_e('Action Label (For your reference only)', 'mxchat'); ?>
4645	</label>
4646	<input name="intent_label" type="text" id="intent_label" required
4647	class="mxchat-intent-input"
4648	placeholder="<?php esc_attr_e('Example: Newsletter Signup', 'mxchat'); ?>">
4649	</div>
4650
4651	<div class="mxchat-form-group">
4652	<label for="phrases">
4653	<?php esc_html_e('Trigger Phrases (comma-separated)', 'mxchat'); ?>
4654	</label>
4655	<textarea name="phrases" id="action_phrases" rows="5" required
4656	class="mxchat-intent-textarea"
4657	placeholder="<?php esc_attr_e('Example: sign me up, subscribe me, I want to join, add me to the newsletter', 'mxchat'); ?>"></textarea>
4658	</div>
4659
4660	<div class="mxchat-form-group">
4661	<label for="similarity_threshold">
4662	<?php esc_html_e('Similarity Threshold', 'mxchat'); ?>
4663	<span class="mxchat-threshold-value-display">85%</span>
4664	</label>
4665	<div class="mxchat-slider-group modal-slider">
4666	<input type="range"
4667	name="similarity_threshold"
4668	id="similarity_threshold"
4669	min="10"
4670	max="95"
4671	value="85"
4672	class="mxchat-intent-slider"
4673	oninput="document.querySelector('.mxchat-threshold-value-display').textContent = this.value + '%'">
4674	</div>
4675	<div class="mxchat-threshold-hint">
4676	<?php esc_html_e('Lower values (10-30) make the action trigger more easily. Higher values (70-95) require more exact matches.', 'mxchat'); ?>
4677	</div>
4678	</div>
4679
4680	<!-- Bot Selection Section -->
4681	<div class="mxchat-form-group">
4682	<label for="enabled_bots">
4683	<?php esc_html_e('Which bots should we enable this action for?', 'mxchat'); ?>
4684	</label>
4685	<div class="mxchat-bot-selector">
4686	<div class="mxchat-bot-option">
4687	<label class="mxchat-checkbox-label">
4688	<input type="checkbox"
4689	name="enabled_bots[]"
4690	value="default"
4691	id="bot_default"
4692	checked="checked">
4693	<span class="mxchat-checkmark"></span>
4694	<?php esc_html_e('Default Bot', 'mxchat'); ?>
4695	</label>
4696	</div>
4697
4698	<?php if (class_exists('MxChat_Multi_Bot_Core_Manager')) :
4699	$multi_bot_manager = MxChat_Multi_Bot_Core_Manager::get_instance();
4700	$available_bots = $multi_bot_manager->get_available_bots();
4701
4702	foreach ($available_bots as $bot_id => $bot_name) :
4703	if ($bot_id === 'default') continue; // Skip default, already shown above
4704	?>
4705	<div class="mxchat-bot-option">
4706	<label class="mxchat-checkbox-label">
4707	<input type="checkbox"
4708	name="enabled_bots[]"
4709	value="<?php echo esc_attr($bot_id); ?>"
4710	id="bot_<?php echo esc_attr($bot_id); ?>">
4711	<span class="mxchat-checkmark"></span>
4712	<?php echo esc_html($bot_name); ?>
4713	</label>
4714	</div>
4715	<?php
4716	endforeach;
4717	endif; ?>
4718	</div>
4719	</div>
4720
4721	<div class="mxchat-modal-actions">
4722	<button type="button" class="mxchat-button-secondary mxchat-modal-cancel">
4723	<?php esc_html_e('Cancel', 'mxchat'); ?>
4724	</button>
4725	<button type="submit" class="mxchat-button-primary" id="mxchat-save-action-btn">
4726	<?php esc_html_e('Save Action', 'mxchat'); ?>
4727	</button>
4728	</div>
4729	</div>
4730	</form>
4731	</div>
4732	</div>
4733
4734	<div id="mxchat-action-loading" class="mxchat-action-loading" style="display: none;">
4735	<div class="mxchat-action-loading-spinner"></div>
4736	<div class="mxchat-action-loading-text">
4737	<?php esc_html_e('Saving action, please wait...', 'mxchat'); ?>
4738	</div>
4739	</div>
4740	</div><!-- .mxchat-wrapper -->
4741	<?php
4742	}
4743	private function get_trimmed_phrases($phrases, $max_length = 100) {
4744	if (strlen($phrases) <= $max_length) {
4745	return $phrases;
4746	}
4747
4748	$trimmed = substr($phrases, 0, $max_length);
4749	$last_comma = strrpos($trimmed, ',');
4750
4751	if ($last_comma !== false) {
4752	$trimmed = substr($trimmed, 0, $last_comma);
4753	}
4754
4755	return $trimmed . '...';
4756	}
4757	public function mxchat_add_enabled_column_to_intents() {
4758	global $wpdb;
4759	$table_name = $wpdb->prefix . 'mxchat_intents';
4760
4761	// Check if the column already exists
4762	$columns = $wpdb->get_results("SHOW COLUMNS FROM $table_name LIKE 'enabled'");
4763
4764	if (empty($columns)) {
4765	// Add the column with default value of 1 (enabled)
4766	$wpdb->query("ALTER TABLE $table_name ADD COLUMN enabled TINYINT(1) NOT NULL DEFAULT 1");
4767	}
4768	}
4769
4770	public function mxchat_handle_delete_intent() {
4771	if ( ! current_user_can( 'manage_options' ) ) {
4772	wp_die( esc_html__('Unauthorized user', 'mxchat') );
4773	}
4774
4775	check_admin_referer('mxchat_delete_intent_nonce');
4776
4777	if (isset($_POST['intent_id'])) {
4778	global $wpdb;
4779	$table_name = $wpdb->prefix . 'mxchat_intents';
4780	$intent_id = intval($_POST['intent_id']);
4781
4782	$wpdb->delete($table_name, ['id' => $intent_id], ['%d']);
4783	}
4784
4785	wp_safe_redirect(admin_url('admin.php?page=mxchat-actions'));
4786	exit;
4787	}
4788	public function mxchat_handle_edit_intent() {
4789	// Security checks (nonce and permissions)
4790	if (!current_user_can('manage_options')) {
4791	wp_die(esc_html__('Unauthorized user', 'mxchat'));
4792	}
4793	check_admin_referer('mxchat_edit_intent');
4794
4795	// Get POST data
4796	$intent_id = isset($_POST['intent_id']) ? absint($_POST['intent_id']) : 0;
4797	$intent_label = isset($_POST['intent_label']) ? sanitize_text_field($_POST['intent_label']) : '';
4798	$phrases_input = isset($_POST['phrases']) ? sanitize_textarea_field($_POST['phrases']) : '';
4799	$threshold_percentage = isset($_POST['similarity_threshold']) ? intval($_POST['similarity_threshold']) : 85;
4800	$similarity_threshold = min(95, max(10, $threshold_percentage)) / 100; // Convert to 0.10–0.95
4801
4802	// Handle enabled_bots
4803	$enabled_bots = isset($_POST['enabled_bots']) ? $_POST['enabled_bots'] : array('default');
4804	$enabled_bots = array_map('sanitize_text_field', $enabled_bots);
4805
4806	// Ensure default is always included for backward compatibility
4807	if (!in_array('default', $enabled_bots)) {
4808	$enabled_bots[] = 'default';
4809	}
4810
4811	$enabled_bots_json = json_encode($enabled_bots);
4812
4813	// Validate inputs
4814	if (!$intent_id \|\| empty($intent_label) \|\| empty($phrases_input)) {
4815	$this->handle_embedding_error(__('Invalid input. Please ensure all fields are filled out.', 'mxchat'));
4816	return;
4817	}
4818
4819	$phrases_array = array_map('sanitize_text_field', array_filter(array_map('trim', explode(',', $phrases_input))));
4820	if (empty($phrases_array)) {
4821	$this->handle_embedding_error(__('Please enter at least one valid phrase.', 'mxchat'));
4822	return;
4823	}
4824
4825	// Generate embeddings with improved error handling
4826	$vectors = [];
4827	$failed_phrases = [];
4828
4829	foreach ($phrases_array as $phrase) {
4830	$embedding_vector = $this->mxchat_generate_embedding($phrase, $this->options['api_key']);
4831	if (is_array($embedding_vector)) {
4832	$vectors[] = $embedding_vector;
4833	} else {
4834	$failed_phrases[] = $phrase;
4835	}
4836	}
4837
4838	if (!empty($failed_phrases)) {
4839	$this->handle_embedding_error(
4840	sprintf(
4841	__('Error generating embeddings for phrases: %s. Check your embedding API.', 'mxchat'),
4842	implode(', ', $failed_phrases)
4843	)
4844	);
4845	return;
4846	}
4847
4848	if (empty($vectors)) {
4849	$this->handle_embedding_error(__('No valid embeddings generated. Please check your phrases.', 'mxchat'));
4850	return;
4851	}
4852
4853	$combined_vector = $this->mxchat_average_vectors($vectors);
4854	$serialized_vector = maybe_serialize($combined_vector);
4855
4856	// Update the database
4857	global $wpdb;
4858	$table_name = $wpdb->prefix . 'mxchat_intents';
4859
4860	$result = $wpdb->update(
4861	$table_name,
4862	array(
4863	'intent_label' => $intent_label,
4864	'phrases' => implode(', ', $phrases_array),
4865	'embedding_vector' => $serialized_vector,
4866	'similarity_threshold' => $similarity_threshold,
4867	'enabled_bots' => $enabled_bots_json, // Include enabled_bots in update
4868	),
4869	array('id' => $intent_id),
4870	array('%s', '%s', '%s', '%f', '%s'), // Format: string, string, string, float, string
4871	array('%d') // Where format: integer
4872	);
4873
4874	if (false === $result) {
4875	$this->handle_embedding_error(__('Failed to update action in database.', 'mxchat'));
4876	return;
4877	}
4878
4879	// Set success message and redirect
4880	set_transient('mxchat_admin_notice_success', __('Intent updated successfully!', 'mxchat'), 60);
4881
4882	$redirect_url = add_query_arg(
4883	array(
4884	'page' => 'mxchat-actions'
4885	),
4886	admin_url('admin.php')
4887	);
4888	wp_safe_redirect($redirect_url);
4889	exit;
4890	}
4891	public function mxchat_handle_add_intent() {
4892	if (!current_user_can('manage_options')) {
4893	wp_die(esc_html__('Unauthorized user', 'mxchat'));
4894	}
4895	check_admin_referer('mxchat_add_intent_nonce');
4896	global $wpdb;
4897	$table_name = $wpdb->prefix . 'mxchat_intents';
4898
4899	// Sanitize and get form data
4900	$intent_label = isset($_POST['intent_label']) ? sanitize_text_field($_POST['intent_label']) : '';
4901	$phrases_input = isset($_POST['phrases']) ? sanitize_textarea_field($_POST['phrases']) : '';
4902	$callback_function = isset($_POST['callback_function']) ? sanitize_text_field($_POST['callback_function']) : '';
4903
4904	// Get similarity threshold from form (convert percentage to decimal)
4905	$similarity_threshold = isset($_POST['similarity_threshold']) ? floatval($_POST['similarity_threshold']) / 100 : 0.85;
4906
4907	// Handle enabled_bots
4908	$enabled_bots = isset($_POST['enabled_bots']) ? $_POST['enabled_bots'] : array('default');
4909	$enabled_bots = array_map('sanitize_text_field', $enabled_bots);
4910
4911	// Ensure default is always included for backward compatibility with existing actions
4912	if (!in_array('default', $enabled_bots)) {
4913	$enabled_bots[] = 'default';
4914	}
4915
4916	$enabled_bots_json = json_encode($enabled_bots);
4917
4918	// Validate required fields
4919	if (empty($intent_label) \|\| empty($callback_function) \|\| empty($phrases_input)) {
4920	$this->handle_embedding_error(__('Invalid input. Please ensure all fields are filled out.', 'mxchat'));
4921	return;
4922	}
4923
4924	// Validate callback function
4925	$available_callbacks = $this->mxchat_get_available_callbacks();
4926	if (!array_key_exists($callback_function, $available_callbacks)) {
4927	$this->handle_embedding_error(__('Invalid callback function selected.', 'mxchat'));
4928	return;
4929	}
4930
4931	// Check if this is an add-on promotional placeholder (not a real action)
4932	if (!empty($available_callbacks[$callback_function]['addon_promo'])) {
4933	$addon_name = isset($available_callbacks[$callback_function]['addon_name']) ? $available_callbacks[$callback_function]['addon_name'] : __('an add-on', 'mxchat');
4934	$this->handle_embedding_error(sprintf(
4935	__('This action requires the %s to be installed and activated.', 'mxchat'),
4936	$addon_name
4937	));
4938	return;
4939	}
4940
4941	// Process phrases
4942	$phrases_array = array_map('sanitize_text_field', array_filter(array_map('trim', explode(',', $phrases_input))));
4943	if (empty($phrases_array)) {
4944	$this->handle_embedding_error(__('Please enter at least one valid phrase.', 'mxchat'));
4945	return;
4946	}
4947
4948	// Generate embeddings with improved error handling
4949	$vectors = [];
4950	$failed_phrases = [];
4951	foreach ($phrases_array as $phrase) {
4952	$embedding_vector = $this->mxchat_generate_embedding($phrase, $this->options['api_key']);
4953	if (is_array($embedding_vector)) {
4954	$vectors[] = $embedding_vector;
4955	} else {
4956	$failed_phrases[] = $phrase;
4957	}
4958	}
4959
4960	// Check for embedding failures
4961	if (!empty($failed_phrases)) {
4962	$this->handle_embedding_error(
4963	sprintf(
4964	__('Error generating embeddings for phrases: %s. Check your embedding API.', 'mxchat'),
4965	implode(', ', $failed_phrases)
4966	)
4967	);
4968	return;
4969	}
4970
4971	if (empty($vectors)) {
4972	$this->handle_embedding_error(__('No valid embeddings generated. Please check your phrases.', 'mxchat'));
4973	return;
4974	}
4975
4976	// Create combined vector and insert into database
4977	$combined_vector = $this->mxchat_average_vectors($vectors);
4978	$serialized_vector = maybe_serialize($combined_vector);
4979
4980	$result = $wpdb->insert($table_name, [
4981	'intent_label' => $intent_label,
4982	'phrases' => implode(', ', $phrases_array),
4983	'embedding_vector' => $serialized_vector,
4984	'callback_function' => $callback_function,
4985	'similarity_threshold' => $similarity_threshold,
4986	'enabled_bots' => $enabled_bots_json, // NEW field
4987	]);
4988
4989	if ($result === false) {
4990	$this->handle_embedding_error(__('Database error: ', 'mxchat') . $wpdb->last_error);
4991	return;
4992	}
4993
4994	// Set success message and redirect
4995	set_transient('mxchat_admin_notice_success', __('New intent added successfully!', 'mxchat'), 60);
4996	wp_safe_redirect(admin_url('admin.php?page=mxchat-actions'));
4997	exit;
4998	}
4999
5000
5001
5002
5003	private function handle_embedding_error($message, $redirect = true) {
5004	// Store the error message in the existing transient
5005	set_transient('mxchat_admin_notice_error', $message, 60);
5006
5007	if ($redirect) {
5008	// Redirect back to the actions page
5009	$redirect_url = add_query_arg(
5010	array(
5011	'page' => 'mxchat-actions'
5012	),
5013	admin_url('admin.php')
5014	);
5015	wp_safe_redirect($redirect_url);
5016	exit;
5017	}
5018	}
5019
5020	/**
5021	* AJAX handler to fetch actions list for the new split-panel UI
5022	*/
5023	public function mxchat_fetch_actions_list() {
5024	check_ajax_referer('mxchat_actions_nonce', 'security');
5025
5026	if (!current_user_can('manage_options')) {
5027	wp_send_json_error(__('Unauthorized', 'mxchat'));
5028	}
5029
5030	global $wpdb;
5031	$table_name = $wpdb->prefix . 'mxchat_intents';
5032
5033	$page = isset($_POST['page']) ? max(1, intval($_POST['page'])) : 1;
5034	$per_page = isset($_POST['per_page']) ? min(100, max(1, intval($_POST['per_page']))) : 50;
5035	$offset = ($page - 1) * $per_page;
5036	$search = isset($_POST['search']) ? sanitize_text_field($_POST['search']) : '';
5037	$callback_filter = isset($_POST['callback_filter']) ? sanitize_text_field($_POST['callback_filter']) : '';
5038	$sort_order = isset($_POST['sort_order']) && $_POST['sort_order'] === 'asc' ? 'ASC' : 'DESC';
5039
5040	// Build WHERE clause
5041	$where = '1=1';
5042	$params = array();
5043
5044	if ($search) {
5045	$search_like = '%' . $wpdb->esc_like($search) . '%';
5046	$where .= ' AND (intent_label LIKE %s OR phrases LIKE %s)';
5047	$params[] = $search_like;
5048	$params[] = $search_like;
5049	}
5050
5051	if ($callback_filter) {
5052	$where .= ' AND callback_function = %s';
5053	$params[] = $callback_filter;
5054	}
5055
5056	// Get total count
5057	$count_query = "SELECT COUNT(*) FROM $table_name WHERE $where";
5058	if (!empty($params)) {
5059	$count_query = $wpdb->prepare($count_query, $params);
5060	}
5061	$total_actions = $wpdb->get_var($count_query);
5062
5063	// Get actions
5064	$query = "SELECT * FROM $table_name WHERE $where ORDER BY id $sort_order LIMIT %d OFFSET %d";
5065	$all_params = array_merge($params, array($per_page, $offset));
5066	$actions = $wpdb->get_results($wpdb->prepare($query, $all_params));
5067
5068	// Get available callbacks for labels/icons
5069	$available_callbacks = $this->mxchat_get_available_callbacks();
5070
5071	// Prefetch individual phrase counts for all fetched actions
5072	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5073	$phrase_counts = array();
5074	if ($wpdb->get_var("SHOW TABLES LIKE '$phrases_table'") === $phrases_table) {
5075	$action_ids = wp_list_pluck($actions, 'id');
5076	if (!empty($action_ids)) {
5077	$id_placeholders = implode(',', array_fill(0, count($action_ids), '%d'));
5078	$count_results = $wpdb->get_results($wpdb->prepare(
5079	"SELECT intent_id, COUNT(*) as cnt FROM $phrases_table WHERE intent_id IN ($id_placeholders) GROUP BY intent_id",
5080	$action_ids
5081	));
5082	foreach ($count_results as $row) {
5083	$phrase_counts[$row->intent_id] = intval($row->cnt);
5084	}
5085	}
5086	}
5087
5088	// Format actions for response
5089	$formatted_actions = array();
5090	foreach ($actions as $action) {
5091	$callback_data = isset($available_callbacks[$action->callback_function])
5092	? $available_callbacks[$action->callback_function]
5093	: array('label' => $action->callback_function, 'icon' => 'admin-generic');
5094
5095	$enabled_bots = json_decode($action->enabled_bots, true);
5096	if (!is_array($enabled_bots)) {
5097	$enabled_bots = array('default');
5098	}
5099
5100	$formatted_actions[] = array(
5101	'id' => intval($action->id),
5102	'label' => $action->intent_label,
5103	'phrases' => $action->phrases,
5104	'callback_function' => $action->callback_function,
5105	'callback_label' => $callback_data['label'],
5106	'icon' => isset($callback_data['icon']) ? $callback_data['icon'] : 'admin-generic',
5107	'threshold' => round($action->similarity_threshold * 100),
5108	'enabled' => (bool) $action->enabled,
5109	'enabled_bots' => $enabled_bots,
5110	'has_legacy_vector' => !empty($action->embedding_vector),
5111	'individual_phrase_count' => isset($phrase_counts[$action->id]) ? $phrase_counts[$action->id] : 0,
5112	);
5113	}
5114
5115	$total_pages = ceil($total_actions / $per_page);
5116	$showing_start = $total_actions > 0 ? $offset + 1 : 0;
5117	$showing_end = min($offset + $per_page, $total_actions);
5118
5119	wp_send_json_success(array(
5120	'actions' => $formatted_actions,
5121	'page' => $page,
5122	'per_page' => $per_page,
5123	'total_actions' => intval($total_actions),
5124	'total_pages' => $total_pages,
5125	'showing_start' => $showing_start,
5126	'showing_end' => $showing_end,
5127	));
5128	}
5129
5130	/**
5131	* AJAX handler to toggle action enabled status
5132	*/
5133	public function mxchat_toggle_action_status() {
5134	check_ajax_referer('mxchat_actions_nonce', 'security');
5135
5136	if (!current_user_can('manage_options')) {
5137	wp_send_json_error(__('Unauthorized', 'mxchat'));
5138	}
5139
5140	$action_id = isset($_POST['action_id']) ? intval($_POST['action_id']) : 0;
5141	$enabled = isset($_POST['enabled']) ? intval($_POST['enabled']) : 0;
5142
5143	if (!$action_id) {
5144	wp_send_json_error(__('Invalid action ID', 'mxchat'));
5145	}
5146
5147	global $wpdb;
5148	$table_name = $wpdb->prefix . 'mxchat_intents';
5149
5150	$result = $wpdb->update(
5151	$table_name,
5152	array('enabled' => $enabled ? 1 : 0),
5153	array('id' => $action_id),
5154	array('%d'),
5155	array('%d')
5156	);
5157
5158	if ($result === false) {
5159	wp_send_json_error(__('Failed to update action status', 'mxchat'));
5160	}
5161
5162	wp_send_json_success(array('enabled' => (bool) $enabled));
5163	}
5164
5165	/**
5166	* AJAX handler to bulk delete actions
5167	*/
5168	public function mxchat_bulk_delete_actions() {
5169	check_ajax_referer('mxchat_delete_intent_nonce', 'security');
5170
5171	if (!current_user_can('manage_options')) {
5172	wp_send_json_error(__('Unauthorized', 'mxchat'));
5173	}
5174
5175	$action_ids = isset($_POST['action_ids']) ? array_map('intval', (array) $_POST['action_ids']) : array();
5176
5177	if (empty($action_ids)) {
5178	wp_send_json_error(__('No actions selected', 'mxchat'));
5179	}
5180
5181	global $wpdb;
5182	$table_name = $wpdb->prefix . 'mxchat_intents';
5183
5184	$placeholders = implode(',', array_fill(0, count($action_ids), '%d'));
5185	$query = $wpdb->prepare("DELETE FROM $table_name WHERE id IN ($placeholders)", $action_ids);
5186	$result = $wpdb->query($query);
5187
5188	if ($result === false) {
5189	wp_send_json_error(__('Failed to delete actions', 'mxchat'));
5190	}
5191
5192	// Also delete individual phrases for these intents
5193	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5194	if ($wpdb->get_var("SHOW TABLES LIKE '$phrases_table'") === $phrases_table) {
5195	$wpdb->query($wpdb->prepare("DELETE FROM $phrases_table WHERE intent_id IN ($placeholders)", $action_ids));
5196	}
5197
5198	wp_send_json_success(array('deleted' => $result));
5199	}
5200
5201	/**
5202	* AJAX handler to add a new intent/action
5203	*/
5204	public function mxchat_add_intent_ajax() {
5205	check_ajax_referer('mxchat_add_intent_nonce', 'security');
5206
5207	if (!current_user_can('manage_options')) {
5208	wp_send_json_error(__('Unauthorized', 'mxchat'));
5209	}
5210
5211	global $wpdb;
5212	$table_name = $wpdb->prefix . 'mxchat_intents';
5213
5214	// Sanitize input
5215	$intent_label = isset($_POST['intent_label']) ? sanitize_text_field($_POST['intent_label']) : '';
5216	$phrases_input = isset($_POST['phrases']) ? sanitize_textarea_field($_POST['phrases']) : '';
5217	$callback_function = isset($_POST['callback_function']) ? sanitize_text_field($_POST['callback_function']) : '';
5218	$similarity_threshold = isset($_POST['similarity_threshold']) ? floatval($_POST['similarity_threshold']) / 100 : 0.85;
5219	$enabled_bots = isset($_POST['enabled_bots']) ? array_map('sanitize_text_field', (array) $_POST['enabled_bots']) : array('default');
5220
5221	// Validate
5222	// Check if using new individual phrases mode or legacy mode
5223	$individual_phrases = isset($_POST['individual_phrases']) ? array_filter(array_map('sanitize_text_field', (array) $_POST['individual_phrases'])) : array();
5224	$use_individual = !empty($individual_phrases);
5225
5226	// Validate required fields (phrases not required when using individual mode)
5227	if (empty($intent_label) \|\| empty($callback_function)) {
5228	wp_send_json_error(__('Please fill in all required fields.', 'mxchat'));
5229	}
5230	if (!$use_individual && empty($phrases_input)) {
5231	wp_send_json_error(__('Please fill in all required fields.', 'mxchat'));
5232	}
5233
5234	// Ensure default bot is included
5235	if (!in_array('default', $enabled_bots)) {
5236	$enabled_bots[] = 'default';
5237	}
5238	$enabled_bots_json = json_encode($enabled_bots);
5239
5240	if ($use_individual) {
5241	// New mode: individual phrases each get their own vector
5242	// Insert the intent row with empty legacy fields
5243	$result = $wpdb->insert(
5244	$table_name,
5245	array(
5246	'intent_label' => $intent_label,
5247	'phrases' => '',
5248	'embedding_vector' => '',
5249	'similarity_threshold' => $similarity_threshold,
5250	'callback_function' => $callback_function,
5251	'enabled' => 1,
5252	'enabled_bots' => $enabled_bots_json,
5253	)
5254	);
5255
5256	if ($result === false) {
5257	wp_send_json_error(__('Failed to add action to database.', 'mxchat'));
5258	}
5259
5260	$intent_id = $wpdb->insert_id;
5261
5262	// Insert each phrase individually with its own embedding
5263	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5264	$failed_phrases = array();
5265	foreach ($individual_phrases as $phrase) {
5266	$phrase = trim($phrase);
5267	if (empty($phrase)) continue;
5268
5269	$embedding_vector = $this->mxchat_generate_embedding($phrase);
5270	if (is_wp_error($embedding_vector)) {
5271	$failed_phrases[] = $phrase;
5272	continue;
5273	}
5274
5275	$wpdb->insert(
5276	$phrases_table,
5277	array(
5278	'intent_id' => $intent_id,
5279	'phrase' => $phrase,
5280	'embedding_vector' => maybe_serialize($embedding_vector),
5281	)
5282	);
5283	}
5284
5285	$response = array('id' => $intent_id);
5286	if (!empty($failed_phrases)) {
5287	$response['failed_phrases'] = $failed_phrases;
5288	}
5289	wp_send_json_success($response);
5290
5291	} else {
5292	// Legacy mode: combine all phrases into one embedding (backwards compatible)
5293	$phrases_array = array_filter(array_map('trim', preg_split('/[\n,]+/', $phrases_input)));
5294	if (empty($phrases_array)) {
5295	wp_send_json_error(__('Please provide at least one trigger phrase.', 'mxchat'));
5296	}
5297
5298	// Generate embedding (combine phrases into single string for embedding)
5299	$embedding_vector = $this->mxchat_generate_embedding(implode(' ', $phrases_array));
5300	if (is_wp_error($embedding_vector)) {
5301	// Fallback: store without embedding
5302	$serialized_vector = null;
5303	} else {
5304	$serialized_vector = maybe_serialize($embedding_vector);
5305	}
5306
5307	// Insert
5308	$result = $wpdb->insert(
5309	$table_name,
5310	array(
5311	'intent_label' => $intent_label,
5312	'phrases' => implode(', ', $phrases_array),
5313	'embedding_vector' => $serialized_vector,
5314	'similarity_threshold' => $similarity_threshold,
5315	'callback_function' => $callback_function,
5316	'enabled' => 1,
5317	'enabled_bots' => $enabled_bots_json,
5318	)
5319	);
5320
5321	if ($result === false) {
5322	wp_send_json_error(__('Failed to add action to database.', 'mxchat'));
5323	}
5324
5325	wp_send_json_success(array('id' => $wpdb->insert_id));
5326	}
5327	}
5328
5329	/**
5330	* AJAX handler to edit an existing intent/action
5331	*/
5332	public function mxchat_edit_intent_ajax() {
5333	check_ajax_referer('mxchat_edit_intent', 'security');
5334
5335	if (!current_user_can('manage_options')) {
5336	wp_send_json_error(__('Unauthorized', 'mxchat'));
5337	}
5338
5339	global $wpdb;
5340	$table_name = $wpdb->prefix . 'mxchat_intents';
5341
5342	// Sanitize input
5343	$intent_id = isset($_POST['intent_id']) ? intval($_POST['intent_id']) : 0;
5344	$intent_label = isset($_POST['intent_label']) ? sanitize_text_field($_POST['intent_label']) : '';
5345	$phrases_input = isset($_POST['phrases']) ? sanitize_textarea_field($_POST['phrases']) : '';
5346	$callback_function = isset($_POST['callback_function']) ? sanitize_text_field($_POST['callback_function']) : '';
5347	$similarity_threshold = isset($_POST['similarity_threshold']) ? floatval($_POST['similarity_threshold']) / 100 : 0.85;
5348	$enabled_bots = isset($_POST['enabled_bots']) ? array_map('sanitize_text_field', (array) $_POST['enabled_bots']) : array('default');
5349
5350	// Validate
5351	if (!$intent_id \|\| empty($intent_label)) {
5352	wp_send_json_error(__('Please fill in all required fields.', 'mxchat'));
5353	}
5354
5355	// Check if phrases are managed individually (empty phrases_input means individual mode)
5356	$uses_individual_phrases = empty($phrases_input);
5357
5358	if ($uses_individual_phrases) {
5359	// Individual phrase mode: only update non-phrase fields, skip embedding regeneration
5360	$update_data = array(
5361	'intent_label' => $intent_label,
5362	'similarity_threshold' => $similarity_threshold,
5363	'callback_function' => $callback_function,
5364	'enabled_bots' => json_encode($enabled_bots),
5365	);
5366	} else {
5367	// Legacy mode: process phrases and regenerate embedding (backwards compatible for add-ons)
5368	$phrases_array = array_filter(array_map('trim', preg_split('/[\n,]+/', $phrases_input)));
5369	if (empty($phrases_array)) {
5370	wp_send_json_error(__('Please provide at least one trigger phrase.', 'mxchat'));
5371	}
5372
5373	// Generate new embedding (combine phrases into single string for embedding)
5374	$embedding_vector = $this->mxchat_generate_embedding(implode(' ', $phrases_array));
5375	if (is_wp_error($embedding_vector)) {
5376	// Keep existing embedding
5377	$update_data = array(
5378	'intent_label' => $intent_label,
5379	'phrases' => implode(', ', $phrases_array),
5380	'similarity_threshold' => $similarity_threshold,
5381	'callback_function' => $callback_function,
5382	'enabled_bots' => json_encode($enabled_bots),
5383	);
5384	} else {
5385	$serialized_vector = maybe_serialize($embedding_vector);
5386	$update_data = array(
5387	'intent_label' => $intent_label,
5388	'phrases' => implode(', ', $phrases_array),
5389	'embedding_vector' => $serialized_vector,
5390	'similarity_threshold' => $similarity_threshold,
5391	'callback_function' => $callback_function,
5392	'enabled_bots' => json_encode($enabled_bots),
5393	);
5394	}
5395	}
5396
5397	// Ensure default bot is included
5398	if (!in_array('default', $enabled_bots)) {
5399	$enabled_bots[] = 'default';
5400	}
5401	$update_data['enabled_bots'] = json_encode($enabled_bots);
5402
5403	$result = $wpdb->update(
5404	$table_name,
5405	$update_data,
5406	array('id' => $intent_id),
5407	null,
5408	array('%d')
5409	);
5410
5411	if ($result === false) {
5412	wp_send_json_error(__('Failed to update action.', 'mxchat'));
5413	}
5414
5415	wp_send_json_success(array('updated' => true));
5416	}
5417
5418	/**
5419	* AJAX handler to delete a single intent/action
5420	*/
5421	public function mxchat_delete_intent_ajax() {
5422	check_ajax_referer('mxchat_delete_intent_nonce', 'security');
5423
5424	if (!current_user_can('manage_options')) {
5425	wp_send_json_error(__('Unauthorized', 'mxchat'));
5426	}
5427
5428	$intent_id = isset($_POST['intent_id']) ? intval($_POST['intent_id']) : 0;
5429
5430	if (!$intent_id) {
5431	wp_send_json_error(__('Invalid action ID', 'mxchat'));
5432	}
5433
5434	global $wpdb;
5435	$table_name = $wpdb->prefix . 'mxchat_intents';
5436
5437	$result = $wpdb->delete($table_name, array('id' => $intent_id), array('%d'));
5438
5439	if ($result === false) {
5440	wp_send_json_error(__('Failed to delete action', 'mxchat'));
5441	}
5442
5443	// Also delete individual phrases for this intent
5444	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5445	if ($wpdb->get_var("SHOW TABLES LIKE '$phrases_table'") === $phrases_table) {
5446	$wpdb->delete($phrases_table, array('intent_id' => $intent_id), array('%d'));
5447	}
5448
5449	wp_send_json_success(array('deleted' => true));
5450	}
5451
5452	/**
5453	* AJAX handler to add a single phrase with its own embedding to an intent
5454	*/
5455	public function mxchat_add_phrase_ajax() {
5456	check_ajax_referer('mxchat_add_phrase_nonce', 'security');
5457
5458	if (!current_user_can('manage_options')) {
5459	wp_send_json_error(__('Unauthorized', 'mxchat'));
5460	}
5461
5462	$intent_id = isset($_POST['intent_id']) ? intval($_POST['intent_id']) : 0;
5463	$phrase = isset($_POST['phrase']) ? sanitize_text_field($_POST['phrase']) : '';
5464
5465	if (!$intent_id \|\| empty($phrase)) {
5466	wp_send_json_error(__('Please provide an intent ID and phrase.', 'mxchat'));
5467	}
5468
5469	// Verify the intent exists
5470	global $wpdb;
5471	$intents_table = $wpdb->prefix . 'mxchat_intents';
5472	$intent = $wpdb->get_row($wpdb->prepare("SELECT id FROM $intents_table WHERE id = %d", $intent_id));
5473	if (!$intent) {
5474	wp_send_json_error(__('Action not found.', 'mxchat'));
5475	}
5476
5477	// Generate embedding for this single phrase
5478	$embedding_vector = $this->mxchat_generate_embedding($phrase);
5479	if (is_wp_error($embedding_vector)) {
5480	wp_send_json_error(__('Failed to generate embedding: ', 'mxchat') . $embedding_vector->get_error_message());
5481	}
5482
5483	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5484	$result = $wpdb->insert(
5485	$phrases_table,
5486	array(
5487	'intent_id' => $intent_id,
5488	'phrase' => $phrase,
5489	'embedding_vector' => maybe_serialize($embedding_vector),
5490	)
5491	);
5492
5493	if ($result === false) {
5494	wp_send_json_error(__('Failed to add phrase.', 'mxchat'));
5495	}
5496
5497	wp_send_json_success(array('id' => $wpdb->insert_id, 'phrase' => $phrase));
5498	}
5499
5500	/**
5501	* AJAX handler to delete a single phrase from wp_mxchat_intent_phrases
5502	*/
5503	public function mxchat_delete_phrase_ajax() {
5504	check_ajax_referer('mxchat_delete_phrase_nonce', 'security');
5505
5506	if (!current_user_can('manage_options')) {
5507	wp_send_json_error(__('Unauthorized', 'mxchat'));
5508	}
5509
5510	$phrase_id = isset($_POST['phrase_id']) ? intval($_POST['phrase_id']) : 0;
5511	if (!$phrase_id) {
5512	wp_send_json_error(__('Invalid phrase ID.', 'mxchat'));
5513	}
5514
5515	global $wpdb;
5516	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5517	$result = $wpdb->delete($phrases_table, array('id' => $phrase_id), array('%d'));
5518
5519	if ($result === false) {
5520	wp_send_json_error(__('Failed to delete phrase.', 'mxchat'));
5521	}
5522
5523	wp_send_json_success(array('deleted' => true));
5524	}
5525
5526	/**
5527	* AJAX handler to fetch individual phrases for an intent
5528	*/
5529	public function mxchat_get_phrases_ajax() {
5530	check_ajax_referer('mxchat_get_phrases_nonce', 'security');
5531
5532	if (!current_user_can('manage_options')) {
5533	wp_send_json_error(__('Unauthorized', 'mxchat'));
5534	}
5535
5536	$intent_id = isset($_POST['intent_id']) ? intval($_POST['intent_id']) : 0;
5537	if (!$intent_id) {
5538	wp_send_json_error(__('Invalid intent ID.', 'mxchat'));
5539	}
5540
5541	global $wpdb;
5542	$phrases_table = $wpdb->prefix . 'mxchat_intent_phrases';
5543
5544	$phrases = array();
5545	if ($wpdb->get_var("SHOW TABLES LIKE '$phrases_table'") === $phrases_table) {
5546	$phrases = $wpdb->get_results($wpdb->prepare(
5547	"SELECT id, phrase, created_at FROM $phrases_table WHERE intent_id = %d ORDER BY created_at ASC",
5548	$intent_id
5549	));
5550	}
5551
5552	wp_send_json_success(array('phrases' => $phrases));
5553	}
5554
5555	/**
5556	* AJAX handler to clear legacy phrases and embedding from the main intents table
5557	*/
5558	public function mxchat_delete_legacy_phrases_ajax() {
5559	check_ajax_referer('mxchat_delete_legacy_nonce', 'security');
5560
5561	if (!current_user_can('manage_options')) {
5562	wp_send_json_error(__('Unauthorized', 'mxchat'));
5563	}
5564
5565	$intent_id = isset($_POST['intent_id']) ? intval($_POST['intent_id']) : 0;
5566	if (!$intent_id) {
5567	wp_send_json_error(__('Invalid intent ID.', 'mxchat'));
5568	}
5569
5570	global $wpdb;
5571	$table_name = $wpdb->prefix . 'mxchat_intents';
5572
5573	$result = $wpdb->update(
5574	$table_name,
5575	array('phrases' => '', 'embedding_vector' => ''),
5576	array('id' => $intent_id),
5577	array('%s', '%s'),
5578	array('%d')
5579	);
5580
5581	if ($result === false) {
5582	wp_send_json_error(__('Failed to clear legacy phrases.', 'mxchat'));
5583	}
5584
5585	wp_send_json_success(array('cleared' => true));
5586	}
5587
5588	/**
5589	* Enhanced get_available_callbacks function with form action exclusion
5590	*
5591	* @param bool $grouped Whether to return callbacks grouped by category
5592	* @param bool $include_all Whether to include all potential actions (even if add-on not installed)
5593	* @return array Callbacks data with icons, descriptions and availability status
5594	*/
5595	private function mxchat_get_available_callbacks($grouped = false, $include_all = true) {
5596	// Load WordPress plugin functions if needed
5597	if (!function_exists('get_plugins')) {
5598	require_once ABSPATH . 'wp-admin/includes/plugin.php';
5599	}
5600
5601	// Get active plugins
5602	$active_plugins = get_option('active_plugins', array());
5603
5604	// Functions to exclude from the action selector only if Pro is activated
5605	// If user doesn't have Pro, show these so they can see what they're missing
5606	$excluded_when_pro_active_functions = array(
5607	'mxchat_handle_form_collection' // Forms add-on action
5608	);
5609
5610	// Always excluded functions (regardless of Pro status)
5611	$always_excluded_functions = array();
5612
5613	// Combine exclusion lists based on Pro activation status
5614	$excluded_functions = $always_excluded_functions;
5615	if ($this->is_activated) {
5616	// Only exclude add-on managed functions if Pro is active
5617	$excluded_functions = array_merge($excluded_functions, $excluded_when_pro_active_functions);
5618	}
5619
5620	// Define add-on plugin files and their corresponding action functions
5621	$addon_plugins = array(
5622	'mxchat-woo/mxchat-woo.php' => array(
5623	'functions' => array(
5624	'mxchat_handle_product_recommendations',
5625	'mxchat_handle_order_history',
5626	'mxchat_show_product_card',
5627	'mxchat_add_to_cart',
5628	'mxchat_checkout_redirect',
5629	'mxchat_handle_featured_products'
5630	),
5631	'name' => __('WooCommerce Add-on', 'mxchat'),
5632	'pro_required' => true
5633	),
5634	'mxchat-perplexity/mxchat-perplexity.php' => array(
5635	'functions' => array('mxchat_perplexity_research'),
5636	'name' => __('Perplexity Add-on', 'mxchat'),
5637	'pro_required' => true
5638	),
5639	'mxchat-forms/mxchat-forms.php' => array(
5640	'functions' => array('mxchat_handle_form_collection'),
5641	'name' => __('Forms Add-on', 'mxchat'),
5642	'pro_required' => true
5643	),
5644	// Add other add-ons and their functions here
5645	);
5646
5647	// Get the functions that are provided by active add-ons
5648	$addon_provided_functions = array();
5649	$addon_function_mapping = array(); // Maps functions to their add-on info
5650
5651	// Check which add-ons are active
5652	foreach ($addon_plugins as $plugin_file => $addon_info) {
5653	$is_active = in_array($plugin_file, $active_plugins);
5654
5655	// For each function in this addon
5656	foreach ($addon_info['functions'] as $function) {
5657	// Consider a function installed only if:
5658	// 1. The add-on is active AND
5659	// 2. Either it doesn't require Pro OR Pro is activated
5660	$is_installed = $is_active && (!$addon_info['pro_required'] \|\| $this->is_activated);
5661
5662	// If the add-on is installed, mark this function as provided by an add-on
5663	if ($is_installed) {
5664	$addon_provided_functions[] = $function;
5665	}
5666
5667	// Store addon info for this function regardless of installation status
5668	$addon_function_mapping[$function] = array(
5669	'addon' => basename(dirname($plugin_file)),
5670	'addon_name' => $addon_info['name'],
5671	'pro_required' => $addon_info['pro_required'],
5672	'is_active' => $is_active,
5673	'is_installed' => $is_installed
5674	);
5675	}
5676	}
5677
5678	// Core callbacks - always available in the base plugin
5679	$core_callbacks = array(
5680	'mxchat_handle_email_capture' => array(
5681	'label' => __('Loops Email Capture', 'mxchat'),
5682	'pro_only' => false,
5683	'group' => __('Customer Engagement', 'mxchat'),
5684	'icon' => 'email-alt',
5685	'description' => __('Collect visitor emails for your mailing list in Loops', 'mxchat'),
5686	'addon' => false, // Not from an add-on
5687	'installed' => true // Always installed with base plugin
5688	),
5689	'mxchat_handle_search_request' => array(
5690	'label' => __('Brave Web Search', 'mxchat'),
5691	'pro_only' => false,
5692	'group' => __('Search Features', 'mxchat'),
5693	'icon' => 'search',
5694	'description' => __('Let users search the web directly from the chat', 'mxchat'),
5695	'addon' => false,
5696	'installed' => true
5697	),
5698	'mxchat_handle_image_search_request' => array(
5699	'label' => __('Brave Image Search', 'mxchat'),
5700	'pro_only' => false,
5701	'group' => __('Search Features', 'mxchat'),
5702	'icon' => 'format-image',
5703	'description' => __('Search and display images in the chat conversation', 'mxchat'),
5704	'addon' => false,
5705	'installed' => true
5706	),
5707	// Pro core features - check is_activated property
5708	'mxchat_generate_image' => array(
5709	'label' => __('Generate Image (OpenAI)', 'mxchat'),
5710	'pro_only' => false,
5711	'group' => __('Other Features', 'mxchat'),
5712	'icon' => 'art',
5713	'description' => __('Create images with GPT Image from OpenAI (requires OpenAI API key)', 'mxchat'),
5714	'addon' => false,
5715	'installed' => true
5716	),
5717	'mxchat_generate_gemini_image' => array(
5718	'label' => __('Generate Image (Gemini)', 'mxchat'),
5719	'pro_only' => false,
5720	'group' => __('Other Features', 'mxchat'),
5721	'icon' => 'art',
5722	'description' => __('Create images with Imagen from Google (requires Gemini API key)', 'mxchat'),
5723	'addon' => false,
5724	'installed' => true
5725	),
5726	'mxchat_handle_pdf_discussion' => array(
5727	'label' => __('Chat with PDF', 'mxchat'),
5728	'pro_only' => false,
5729	'group' => __('Other Features', 'mxchat'),
5730	'icon' => 'media-document',
5731	'description' => __('Answer questions about uploaded PDF documents', 'mxchat'),
5732	'addon' => false,
5733	'installed' => true
5734	),
5735	'mxchat_live_agent_handover' => array(
5736	'label' => __('Slack Live Agent', 'mxchat'),
5737	'pro_only' => false,
5738	'group' => __('Customer Engagement', 'mxchat'),
5739	'icon' => 'admin-users',
5740	'description' => __('Transfer conversation to a human support agent on Slack', 'mxchat'),
5741	'addon' => false,
5742	'installed' => true
5743	),
5744	'mxchat_telegram_live_agent_handover' => array(
5745	'label' => __('Telegram Live Agent', 'mxchat'),
5746	'pro_only' => false,
5747	'group' => __('Customer Engagement', 'mxchat'),
5748	'icon' => 'format-chat',
5749	'description' => __('Transfer conversation to a human support agent on Telegram', 'mxchat'),
5750	'addon' => false,
5751	'installed' => true
5752	),
5753	'mxchat_handle_switch_to_chatbot_intent' => array(
5754	'label' => __('Back to Chatbot', 'mxchat'),
5755	'pro_only' => false,
5756	'group' => __('Customer Engagement', 'mxchat'),
5757	'icon' => 'backup',
5758	'description' => __('Return from live agent mode to AI chatbot', 'mxchat'),
5759	'addon' => false,
5760	'installed' => true
5761	),
5762	);
5763
5764	// Add-on callbacks with placeholders - only include if the add-on is NOT active
5765	// These are promotional/informational only — not selectable as real actions
5766	$addon_callbacks = array(
5767	// WooCommerce Add-on
5768	'mxchat_handle_product_recommendations' => array(
5769	'label' => __('Product Recommendations', 'mxchat'),
5770	'pro_only' => false,
5771	'addon_promo' => true,
5772	'group' => __('WooCommerce Features', 'mxchat'),
5773	'icon' => 'cart',
5774	'description' => __('Suggest products based on customer preferences', 'mxchat'),
5775	),
5776	'mxchat_handle_order_history' => array(
5777	'label' => __('Order History', 'mxchat'),
5778	'pro_only' => false,
5779	'addon_promo' => true,
5780	'group' => __('WooCommerce Features', 'mxchat'),
5781	'icon' => 'clipboard',
5782	'description' => __('Allow customers to check their order status', 'mxchat'),
5783	),
5784	'mxchat_show_product_card' => array(
5785	'label' => __('Show Product Card', 'mxchat'),
5786	'pro_only' => false,
5787	'addon_promo' => true,
5788	'group' => __('WooCommerce Features', 'mxchat'),
5789	'icon' => 'products',
5790	'description' => __('Display product information in the chat', 'mxchat'),
5791	),
5792	'mxchat_add_to_cart' => array(
5793	'label' => __('Add to Cart', 'mxchat'),
5794	'pro_only' => false,
5795	'addon_promo' => true,
5796	'group' => __('WooCommerce Features', 'mxchat'),
5797	'icon' => 'plus-alt',
5798	'description' => __('Add products to cart directly from chat', 'mxchat'),
5799	),
5800	'mxchat_checkout_redirect' => array(
5801	'label' => __('Proceed to Checkout', 'mxchat'),
5802	'pro_only' => false,
5803	'addon_promo' => true,
5804	'group' => __('WooCommerce Features', 'mxchat'),
5805	'icon' => 'arrow-right-alt',
5806	'description' => __('Redirect customer to checkout page', 'mxchat'),
5807	),
5808	'mxchat_handle_featured_products' => array(
5809	'label' => __('Featured Products Showcase', 'mxchat'),
5810	'pro_only' => false,
5811	'addon_promo' => true,
5812	'group' => __('WooCommerce Features', 'mxchat'),
5813	'icon' => 'star-filled',
5814	'description' => __('Display a curated selection of products with an AI-generated message', 'mxchat'),
5815	),
5816
5817	// Perplexity Add-on
5818	'mxchat_perplexity_research' => array(
5819	'label' => __('Perplexity Research', 'mxchat'),
5820	'pro_only' => false,
5821	'addon_promo' => true,
5822	'group' => __('Search Features', 'mxchat'),
5823	'icon' => 'book-alt',
5824	'description' => __('Allows the chatbot to search the web for accurate, up-to-date answers', 'mxchat'),
5825	),
5826
5827	// Forms Add-on
5828	'mxchat_handle_form_collection' => array(
5829	'label' => __('Form Collection', 'mxchat'),
5830	'pro_only' => false,
5831	'addon_promo' => true,
5832	'group' => __('Form Features', 'mxchat'),
5833	'icon' => 'feedback',
5834	'description' => __('Collect user information through custom forms in chat', 'mxchat'),
5835	),
5836	);
5837
5838	// Enhance add-on callbacks with installation status and addon info
5839	foreach ($addon_callbacks as $function => $data) {
5840	if (isset($addon_function_mapping[$function])) {
5841	$addon_info = $addon_function_mapping[$function];
5842
5843	$addon_callbacks[$function]['addon'] = $addon_info['addon'];
5844	$addon_callbacks[$function]['addon_name'] = $addon_info['addon_name'];
5845	$addon_callbacks[$function]['installed'] = $addon_info['is_installed'];
5846
5847	// Set pro_only based on add-on configuration
5848	$addon_callbacks[$function]['pro_only'] = $addon_info['pro_required'];
5849	} else {
5850	$addon_callbacks[$function]['addon'] = 'unknown';
5851	$addon_callbacks[$function]['addon_name'] = __('Unknown Add-on', 'mxchat');
5852	$addon_callbacks[$function]['installed'] = false;
5853	}
5854	}
5855
5856	// Initialize callbacks with core features
5857	$callbacks = $core_callbacks;
5858
5859	// Get callbacks from active add-ons
5860	$active_addon_callbacks = apply_filters('mxchat_available_callbacks', array());
5861
5862	// Add placeholder callbacks only for add-ons that aren't active
5863	if ($include_all) {
5864	foreach ($addon_callbacks as $function => $data) {
5865	// Skip placeholders for functions provided by active add-ons
5866	if (in_array($function, $addon_provided_functions)) {
5867	continue;
5868	}
5869
5870	// Skip excluded functions
5871	if (in_array($function, $excluded_functions)) {
5872	continue;
5873	}
5874
5875	// Add the placeholder
5876	$callbacks[$function] = $data;
5877	}
5878	}
5879
5880	// Add callbacks from active add-ons (will override placeholders)
5881	foreach ($active_addon_callbacks as $function => $data) {
5882	// Skip excluded functions
5883	if (in_array($function, $excluded_functions)) {
5884	continue;
5885	}
5886
5887	// Always include callbacks from add-ons
5888	$callbacks[$function] = $data;
5889
5890	// Ensure they have the proper add-on info
5891	if (isset($addon_function_mapping[$function])) {
5892	$addon_info = $addon_function_mapping[$function];
5893	$callbacks[$function]['addon'] = $addon_info['addon'];
5894	$callbacks[$function]['addon_name'] = $addon_info['addon_name'];
5895	$callbacks[$function]['installed'] = $addon_info['is_installed'];
5896	$callbacks[$function]['pro_only'] = $addon_info['pro_required'];
5897	}
5898	}
5899
5900	// Just before returning callbacks, sort them to prioritize free features
5901	if (!$grouped) {
5902	// Create temporary arrays for sorting
5903	$free_callbacks = array();
5904	$pro_callbacks = array();
5905
5906	// Split callbacks into free and pro
5907	foreach ($callbacks as $key => $data) {
5908	if (isset($data['pro_only']) && $data['pro_only']) {
5909	$pro_callbacks[$key] = $data;
5910	} else {
5911	$free_callbacks[$key] = $data;
5912	}
5913	}
5914
5915	// Merge with free callbacks first
5916	$callbacks = array_merge($free_callbacks, $pro_callbacks);
5917	}
5918
5919	// Return grouped structure if requested
5920	if ($grouped) {
5921	$grouped_callbacks = array();
5922	foreach ($callbacks as $key => $data) {
5923	$group_label = isset($data['group']) ? $data['group'] : __('Other Features', 'mxchat');
5924
5925	// Ensure we carry forward all the new fields in grouped mode
5926	$callback_data = array(
5927	'label' => $data['label'],
5928	'pro_only' => isset($data['pro_only']) ? $data['pro_only'] : false,
5929	'icon' => isset($data['icon']) ? $data['icon'] : 'admin-generic',
5930	'description' => isset($data['description']) ? $data['description'] : __('Custom action for your chatbot', 'mxchat'),
5931	'addon' => isset($data['addon']) ? $data['addon'] : false,
5932	'addon_name' => isset($data['addon_name']) ? $data['addon_name'] : '',
5933	'installed' => isset($data['installed']) ? $data['installed'] : true
5934	);
5935
5936	$grouped_callbacks[$group_label][$key] = $callback_data;
5937	}
5938
5939	// Sort within each group to prioritize free features
5940	foreach ($grouped_callbacks as $group => $items) {
5941	$free_items = array();
5942	$pro_items = array();
5943
5944	foreach ($items as $key => $data) {
5945	if (isset($data['pro_only']) && $data['pro_only']) {
5946	$pro_items[$key] = $data;
5947	} else {
5948	$free_items[$key] = $data;
5949	}
5950	}
5951
5952	$grouped_callbacks[$group] = array_merge($free_items, $pro_items);
5953	}
5954
5955	return $grouped_callbacks;
5956	}
5957
5958	return $callbacks;
5959	}
5960
5961	public function mxchat_page_init() {
5962	register_setting(
5963	'mxchat_option_group',
5964	'mxchat_options',
5965	array($this, 'mxchat_sanitize')
5966	);
5967
5968	register_setting(
5969	'mxchat_option_group',
5970	'mxchat_similarity_threshold',
5971	array(
5972	'type' => 'number',
5973	'sanitize_callback' => function($value) {
5974	$value = absint($value);
5975	return min(max($value, 20), 95);
5976	},
5977	'default' => 80,
5978	)
5979	);
5980
5981	// Chatbot Settings Section
5982	add_settings_section(
5983	'mxchat_chatbot_section',
5984	esc_html__('Chatbot Settings', 'mxchat'),
5985	null,
5986	'mxchat-chatbot'
5987	);
5988
5989	// API Keys Settings Section
5990	add_settings_section(
5991	'mxchat_api_keys_section',
5992	esc_html__('API Keys', 'mxchat'),
5993	array($this, 'mxchat_api_keys_section_callback'),
5994	'mxchat-api-keys'
5995	);
5996
5997	// OpenAI API Key
5998	add_settings_field(
5999	'api_key',
6000	esc_html__('OpenAI API Key', 'mxchat'),
6001	array($this, 'api_key_callback'),
6002	'mxchat-api-keys',
6003	'mxchat_api_keys_section'
6004	);
6005
6006	// X.AI API Key
6007	add_settings_field(
6008	'xai_api_key',
6009	esc_html__('X.AI API Key', 'mxchat'),
6010	array($this, 'xai_api_key_callback'),
6011	'mxchat-api-keys',
6012	'mxchat_api_keys_section'
6013	);
6014
6015	// Claude API Key
6016	add_settings_field(
6017	'claude_api_key',
6018	esc_html__('Claude API Key', 'mxchat'),
6019	array($this, 'claude_api_key_callback'),
6020	'mxchat-api-keys',
6021	'mxchat_api_keys_section'
6022	);
6023
6024	// DeepSeek API Key
6025	add_settings_field(
6026	'deepseek_api_key',
6027	esc_html__('DeepSeek API Key', 'mxchat'),
6028	array($this, 'deepseek_api_key_callback'),
6029	'mxchat-api-keys',
6030	'mxchat_api_keys_section'
6031	);
6032
6033	// Google Gemini API Key
6034	add_settings_field(
6035	'gemini_api_key',
6036	esc_html__('Google Gemini API Key', 'mxchat'),
6037	array($this, 'gemini_api_key_callback'),
6038	'mxchat-api-keys',
6039	'mxchat_api_keys_section'
6040	);
6041
6042	// Voyage AI API Key
6043	add_settings_field(
6044	'voyage_api_key',
6045	esc_html__('Voyage AI API Key', 'mxchat'),
6046	array($this, 'voyage_api_key_callback'),
6047	'mxchat-api-keys',
6048	'mxchat_api_keys_section'
6049	);
6050
6051	// OpenRouter API Key
6052	add_settings_field(
6053	'openrouter_api_key',
6054	esc_html__('OpenRouter API Key', 'mxchat'),
6055	array($this, 'openrouter_api_key_callback'),
6056	'mxchat-api-keys',
6057	'mxchat_api_keys_section'
6058	);
6059
6060	// Custom (OpenAI-compatible) Provider — for Ollama, LM Studio, vLLM, llama.cpp, Azure OpenAI, etc.
6061	add_settings_field(
6062	'custom_provider',
6063	esc_html__('Custom Provider (OpenAI-compatible)', 'mxchat'),
6064	array($this, 'custom_provider_callback'),
6065	'mxchat-api-keys',
6066	'mxchat_api_keys_section'
6067	);
6068
6069	// Loops API Key
6070	add_settings_field(
6071	'loops_api_key',
6072	esc_html__('Loops API Key', 'mxchat'),
6073	array($this, 'mxchat_loops_api_key_callback'),
6074	'mxchat-api-keys',
6075	'mxchat_api_keys_section'
6076	);
6077
6078	// Brave Search API Key
6079	add_settings_field(
6080	'brave_api_key',
6081	__('Brave API Key', 'mxchat'),
6082	array($this, 'mxchat_brave_api_key_callback'),
6083	'mxchat-api-keys',
6084	'mxchat_api_keys_section'
6085	);
6086
6087	// Similarity Threshold Slider
6088	add_settings_field(
6089	'similarity_threshold', // Field ID
6090	esc_html__('Similarity Threshold', 'mxchat'), // Field title
6091	array($this, 'mxchat_similarity_threshold_callback'), // Callback function
6092	'mxchat-chatbot', // Page
6093	'mxchat_chatbot_section' // Section
6094	);
6095
6096	// RAG Sources Limit Slider
6097	add_settings_field(
6098	'rag_sources_limit', // Field ID
6099	esc_html__('RAG Sources Limit', 'mxchat'), // Field title
6100	array($this, 'mxchat_rag_sources_limit_callback'), // Callback function
6101	'mxchat-chatbot', // Page
6102	'mxchat_chatbot_section' // Section
6103	);
6104
6105	// RAG Chunks Limit Slider
6106	add_settings_field(
6107	'rag_chunks_limit', // Field ID
6108	esc_html__('RAG Chunks Limit', 'mxchat'), // Field title
6109	array($this, 'mxchat_rag_chunks_limit_callback'), // Callback function
6110	'mxchat-chatbot', // Page
6111	'mxchat_chatbot_section' // Section
6112	);
6113
6114	add_settings_field(
6115	'append_to_body',
6116	esc_html__('Auto-Display Chatbot', 'mxchat'),
6117	array($this, 'mxchat_append_to_body_callback'),
6118	'mxchat-chatbot',
6119	'mxchat_chatbot_section'
6120	);
6121
6122	add_settings_field(
6123	'contextual_awareness_toggle',
6124	esc_html__('Contextual Awareness', 'mxchat'),
6125	array($this, 'mxchat_contextual_awareness_callback'),
6126	'mxchat-chatbot',
6127	'mxchat_chatbot_section'
6128	);
6129
6130	add_settings_field(
6131	'citation_links_toggle',
6132	esc_html__('Citation Links', 'mxchat'),
6133	array($this, 'mxchat_citation_links_toggle_callback'),
6134	'mxchat-chatbot',
6135	'mxchat_chatbot_section'
6136	);
6137
6138	// Satisfaction rating toggle (plan-a5b006).
6139	add_settings_field(
6140	'satisfaction_rating_enabled',
6141	esc_html__('Satisfaction Rating Prompt', 'mxchat'),
6142	array($this, 'mxchat_satisfaction_rating_toggle_callback'),
6143	'mxchat-chatbot',
6144	'mxchat_chatbot_section'
6145	);
6146
6147	// Satisfaction rating customization (plan-141a12, plan-29caac):
6148	// the 5 customization fields are now inline-rendered inside
6149	// mxchat_satisfaction_rating_toggle_callback's sub-options wrapper.
6150
6151	add_settings_field(
6152	'enable_streaming_toggle',
6153	esc_html__('Enable Streaming', 'mxchat'),
6154	array($this, 'enable_streaming_toggle_callback'),
6155	'mxchat-chatbot',
6156	'mxchat_chatbot_section', // Same section as your working toggle
6157	array(
6158	'class' => 'mxchat-setting-row streaming-setting',
6159	'style' => 'display: none;' // Hidden by default, shown when OpenAI/Claude selected
6160	)
6161	);
6162
6163
6164	add_settings_field(
6165	'model',
6166	esc_html__('Chat Model', 'mxchat'),
6167	array($this, 'mxchat_model_callback'),
6168	'mxchat-chatbot',
6169	'mxchat_chatbot_section'
6170	);
6171
6172	add_settings_field(
6173	'embedding_model',
6174	esc_html__('Embedding Model', 'mxchat'),
6175	array($this, 'embedding_model_callback'),
6176	'mxchat-chatbot',
6177	'mxchat_chatbot_section'
6178	);
6179
6180	add_settings_field(
6181	'system_prompt_instructions',
6182	esc_html__('AI Instructions (Behavior)', 'mxchat'),
6183	array($this, 'system_prompt_instructions_callback'),
6184	'mxchat-chatbot',
6185	'mxchat_chatbot_section'
6186	);
6187
6188
6189	add_settings_field(
6190	'top_bar_title',
6191	esc_html__('Top Bar Title', 'mxchat'),
6192	array($this, 'mxchat_top_bar_title_callback'),
6193	'mxchat-chatbot',
6194	'mxchat_chatbot_section'
6195	);
6196
6197	add_settings_field(
6198	'ai_agent_text',
6199	esc_html__('AI Agent Text', 'mxchat'),
6200	array($this, 'mxchat_ai_agent_text_callback'),
6201	'mxchat-chatbot',
6202	'mxchat_chatbot_section'
6203	);
6204
6205	add_settings_field(
6206	'enable_email_block',
6207	esc_html__('Require Email To Chat', 'mxchat'),
6208	array($this, 'enable_email_block_callback'),
6209	'mxchat-chatbot',
6210	'mxchat_chatbot_section'
6211	);
6212
6213	add_settings_field(
6214	'email_blocker_header_content',
6215	esc_html__('Require Email Chat Content', 'mxchat'),
6216	array($this, 'email_blocker_header_content_callback'),
6217	'mxchat-chatbot',
6218	'mxchat_chatbot_section'
6219	);
6220
6221	add_settings_field(
6222	'email_blocker_button_text',
6223	esc_html__('Require Email Chat Button Text', 'mxchat'),
6224	[$this, 'email_blocker_button_text_callback'],
6225	'mxchat-chatbot',
6226	'mxchat_chatbot_section'
6227	);
6228
6229	add_settings_field(
6230	'enable_name_field',
6231	esc_html__('Require Name Field', 'mxchat'),
6232	array($this, 'enable_name_field_callback'),
6233	'mxchat-chatbot',
6234	'mxchat_chatbot_section'
6235	);
6236
6237	add_settings_field(
6238	'name_field_placeholder',
6239	esc_html__('Name Field Placeholder', 'mxchat'),
6240	array($this, 'name_field_placeholder_callback'),
6241	'mxchat-chatbot',
6242	'mxchat_chatbot_section'
6243	);
6244
6245	add_settings_field(
6246	'intro_message',
6247	esc_html__('Introductory Message', 'mxchat'),
6248	array($this, 'mxchat_intro_message_callback'),
6249	'mxchat-chatbot',
6250	'mxchat_chatbot_section'
6251	);
6252
6253	add_settings_field(
6254	'input_copy',
6255	esc_html__('Input Copy', 'mxchat'),
6256	array($this, 'mxchat_input_copy_callback'),
6257	'mxchat-chatbot',
6258	'mxchat_chatbot_section'
6259	);
6260
6261	add_settings_field(
6262	'pre_chat_message',
6263	esc_html__('Chat Teaser Pop-up', 'mxchat'),
6264	array($this, 'mxchat_pre_chat_message_callback'),
6265	'mxchat-chatbot',
6266	'mxchat_chatbot_section'
6267	);
6268
6269	add_settings_field(
6270	'privacy_toggle',
6271	esc_html__('Toggle Privacy Notice', 'mxchat'),
6272	array($this, 'mxchat_privacy_toggle_callback'),
6273	'mxchat-chatbot',
6274	'mxchat_chatbot_section'
6275	);
6276
6277	add_settings_field(
6278	'complianz_toggle',
6279	esc_html__('Enable Complianz', 'mxchat'),
6280	array($this, 'mxchat_complianz_toggle_callback'),
6281	'mxchat-chatbot',
6282	'mxchat_chatbot_section'
6283	);
6284
6285	add_settings_field(
6286	'link_target_toggle',
6287	esc_html__('Open Links in a New Tab', 'mxchat'),
6288	array($this, 'mxchat_link_target_toggle_callback'),
6289	'mxchat-chatbot',
6290	'mxchat_chatbot_section'
6291	);
6292
6293	add_settings_field(
6294	'chat_persistence_toggle',
6295	esc_html__('Enable Chat Persistence', 'mxchat'),
6296	array($this, 'mxchat_chat_persistence_toggle_callback'),
6297	'mxchat-chatbot',
6298	'mxchat_chatbot_section'
6299	);
6300
6301	add_settings_field(
6302	'popular_question_1',
6303	esc_html__('Quick Question 1', 'mxchat'),
6304	array($this, 'mxchat_popular_question_1_callback'),
6305	'mxchat-chatbot',
6306	'mxchat_chatbot_section'
6307	);
6308
6309	add_settings_field(
6310	'popular_question_2',
6311	esc_html__('Quick Question 2', 'mxchat'),
6312	array($this, 'mxchat_popular_question_2_callback'),
6313	'mxchat-chatbot',
6314	'mxchat_chatbot_section'
6315	);
6316
6317	add_settings_field(
6318	'popular_question_3',
6319	esc_html__('Quick Question 3', 'mxchat'),
6320	array($this, 'mxchat_popular_question_3_callback'),
6321	'mxchat-chatbot',
6322	'mxchat_chatbot_section'
6323	);
6324
6325	add_settings_field(
6326	'additional_popular_questions',
6327	esc_html__('Additional Quick Questions', 'mxchat'),
6328	array($this, 'mxchat_additional_popular_questions_callback'),
6329	'mxchat-chatbot',
6330	'mxchat_chatbot_section'
6331	);
6332
6333
6334	add_settings_field(
6335	'rate_limits',
6336	__('Rate Limits Settings', 'mxchat'),
6337	array($this, 'mxchat_rate_limits_callback'),
6338	'mxchat-chatbot',
6339	'mxchat_chatbot_section'
6340	);
6341
6342	// Loops Settings Section
6343	add_settings_section(
6344	'mxchat_loops_section',
6345	esc_html__('Loops Settings', 'mxchat'),
6346	null,
6347	'mxchat-embed'
6348	);
6349
6350	// Loops Settings Fields (API Key moved to API Keys tab)
6351	add_settings_field(
6352	'loops_mailing_list',
6353	esc_html__('Loops Mailing List', 'mxchat'),
6354	array($this, 'mxchat_loops_mailing_list_callback'),
6355	'mxchat-embed',
6356	'mxchat_loops_section'
6357	);
6358
6359	add_settings_field(
6360	'triggered_phrase_response',
6361	esc_html__('Triggered Phrase Response', 'mxchat'),
6362	array($this, 'mxchat_triggered_phrase_response_callback'),
6363	'mxchat-embed',
6364	'mxchat_loops_section'
6365	);
6366
6367	add_settings_field(
6368	'email_capture_response',
6369	esc_html__('Email Capture Response', 'mxchat'),
6370	array($this, 'mxchat_email_capture_response_callback'),
6371	'mxchat-embed',
6372	'mxchat_loops_section'
6373	);
6374
6375	// Brave Search Settings Fields
6376	add_settings_section(
6377	'mxchat_brave_section',
6378	__('Brave Search Settings', 'mxchat'),
6379	array($this, 'mxchat_brave_section_callback'),
6380	'mxchat-embed'
6381	);
6382
6383	// Brave API Key moved to API Keys tab
6384	add_settings_field(
6385	'brave_image_count',
6386	__('Number of Images to Return', 'mxchat'),
6387	array($this, 'mxchat_brave_image_count_callback'),
6388	'mxchat-embed',
6389	'mxchat_brave_section'
6390	);
6391
6392	add_settings_field(
6393	'brave_safe_search',
6394	__('Safe Search', 'mxchat'),
6395	array($this, 'mxchat_brave_safe_search_callback'),
6396	'mxchat-embed',
6397	'mxchat_brave_section'
6398	);
6399
6400	add_settings_field(
6401	'brave_news_count',
6402	__('Number of News Articles', 'mxchat'),
6403	array($this, 'mxchat_brave_news_count_callback'),
6404	'mxchat-embed',
6405	'mxchat_brave_section'
6406	);
6407
6408	add_settings_field(
6409	'brave_country',
6410	__('Country', 'mxchat'),
6411	array($this, 'mxchat_brave_country_callback'),
6412	'mxchat-embed',
6413	'mxchat_brave_section'
6414	);
6415
6416	add_settings_field(
6417	'brave_language',
6418	__('Language', 'mxchat'),
6419	array($this, 'mxchat_brave_language_callback'),
6420	'mxchat-embed',
6421	'mxchat_brave_section'
6422	);
6423
6424	// Chat with PDF Intent Settings Fields
6425	add_settings_section(
6426	'mxchat_pdf_intent_section',
6427	__('Toolbar Settings & Intents', 'mxchat'),
6428	array($this, 'mxchat_pdf_intent_section_callback'),
6429	'mxchat-embed'
6430	);
6431
6432	add_settings_field(
6433	'chat_toolbar_toggle',
6434	__('Show Chat Toolbar', 'mxchat'),
6435	array($this, 'mxchat_chat_toolbar_toggle_callback'),
6436	'mxchat-embed',
6437	'mxchat_pdf_intent_section'
6438	);
6439
6440	// PDF Upload Button Toggle
6441	add_settings_field(
6442	'show_pdf_upload_button',
6443	__('Show PDF Upload Button', 'mxchat'),
6444	array($this, 'mxchat_show_pdf_upload_button_callback'),
6445	'mxchat-embed',
6446	'mxchat_pdf_intent_section'
6447	);
6448
6449	// Word Upload Button Toggle
6450	add_settings_field(
6451	'show_word_upload_button',
6452	__('Show Word Upload Button', 'mxchat'),
6453	array($this, 'mxchat_show_word_upload_button_callback'),
6454	'mxchat-embed',
6455	'mxchat_pdf_intent_section'
6456	);
6457
6458	add_settings_field(
6459	'pdf_intent_trigger_text',
6460	__('Intent Trigger Text', 'mxchat'),
6461	array($this, 'mxchat_pdf_intent_trigger_text_callback'),
6462	'mxchat-embed',
6463	'mxchat_pdf_intent_section'
6464	);
6465
6466	add_settings_field(
6467	'pdf_intent_success_text',
6468	__('Success Text', 'mxchat'),
6469	array($this, 'mxchat_pdf_intent_success_text_callback'),
6470	'mxchat-embed',
6471	'mxchat_pdf_intent_section'
6472	);
6473
6474	add_settings_field(
6475	'pdf_intent_error_text',
6476	__('Error Text', 'mxchat'),
6477	array($this, 'mxchat_pdf_intent_error_text_callback'),
6478	'mxchat-embed',
6479	'mxchat_pdf_intent_section'
6480	);
6481
6482	// Add PDF Maximum Pages Field
6483	add_settings_field(
6484	'pdf_max_pages',
6485	__('Maximum Document Pages', 'mxchat'),
6486	array($this, 'mxchat_pdf_max_pages_callback'),
6487	'mxchat-embed',
6488	'mxchat_pdf_intent_section'
6489	);
6490
6491	// Live Agent Settings Fields
6492	add_settings_section(
6493	'mxchat_live_agent_section',
6494	__('Live Agent Settings', 'mxchat'),
6495	array($this, 'mxchat_live_agent_section_callback'),
6496	'mxchat-embed'
6497	);
6498
6499	// Live Agent Status Fields (add at top of live agent settings)
6500	add_settings_field(
6501	'live_agent_status',
6502	__('Live Agent Status', 'mxchat'),
6503	array($this, 'mxchat_live_agent_status_callback'),
6504	'mxchat-embed',
6505	'mxchat_live_agent_section'
6506	);
6507
6508	add_settings_field(
6509	'live_agent_notification_message',
6510	__('Notification Message', 'mxchat'),
6511	array($this, 'mxchat_live_agent_notification_message_callback'),
6512	'mxchat-embed',
6513	'mxchat_live_agent_section'
6514	);
6515
6516	add_settings_field(
6517	'live_agent_away_message',
6518	__('Away Message', 'mxchat'),
6519	array($this, 'mxchat_live_agent_away_message_callback'),
6520	'mxchat-embed',
6521	'mxchat_live_agent_section'
6522	);
6523
6524	add_settings_field(
6525	'live_agent_user_ids',
6526	__('Slack Agent User IDs', 'mxchat'),
6527	array($this, 'mxchat_live_agent_user_ids_callback'),
6528	'mxchat-embed',
6529	'mxchat_live_agent_section'
6530	);
6531
6532	add_settings_field(
6533	'live_agent_webhook_url',
6534	__('Slack Webhook URL', 'mxchat'),
6535	array($this, 'mxchat_live_agent_webhook_url_callback'),
6536	'mxchat-embed',
6537	'mxchat_live_agent_section'
6538	);
6539
6540	add_settings_field(
6541	'live_agent_secret_key',
6542	__('Slack Secret Key', 'mxchat'),
6543	array($this, 'mxchat_live_agent_secret_key_callback'),
6544	'mxchat-embed',
6545	'mxchat_live_agent_section'
6546	);
6547
6548	// Live Agent Integration Fields
6549	add_settings_field(
6550	'live_agent_bot_token',
6551	__('Slack Bot OAuth Token', 'mxchat'),
6552	array($this, 'mxchat_live_agent_bot_token_callback'),
6553	'mxchat-embed',
6554	'mxchat_live_agent_section'
6555	);
6556
6557	// Telegram Integration Section
6558	add_settings_section(
6559	'mxchat_telegram_section',
6560	__('Telegram Settings', 'mxchat'),
6561	array($this, 'mxchat_telegram_section_callback'),
6562	'mxchat-embed'
6563	);
6564
6565	add_settings_field(
6566	'telegram_status',
6567	__('Live Agent Status', 'mxchat'),
6568	array($this, 'mxchat_telegram_status_callback'),
6569	'mxchat-embed',
6570	'mxchat_telegram_section'
6571	);
6572
6573	add_settings_field(
6574	'telegram_notification_message',
6575	__('Notification Message', 'mxchat'),
6576	array($this, 'mxchat_telegram_notification_message_callback'),
6577	'mxchat-embed',
6578	'mxchat_telegram_section'
6579	);
6580
6581	add_settings_field(
6582	'telegram_away_message',
6583	__('Away Message', 'mxchat'),
6584	array($this, 'mxchat_telegram_away_message_callback'),
6585	'mxchat-embed',
6586	'mxchat_telegram_section'
6587	);
6588
6589	add_settings_field(
6590	'telegram_bot_token',
6591	__('Telegram Bot Token', 'mxchat'),
6592	array($this, 'mxchat_telegram_bot_token_callback'),
6593	'mxchat-embed',
6594	'mxchat_telegram_section'
6595	);
6596
6597	add_settings_field(
6598	'telegram_group_id',
6599	__('Telegram Group ID', 'mxchat'),
6600	array($this, 'mxchat_telegram_group_id_callback'),
6601	'mxchat-embed',
6602	'mxchat_telegram_section'
6603	);
6604
6605	add_settings_field(
6606	'telegram_webhook_secret',
6607	__('Webhook Secret Token', 'mxchat'),
6608	array($this, 'mxchat_telegram_webhook_secret_callback'),
6609	'mxchat-embed',
6610	'mxchat_telegram_section'
6611	);
6612
6613	// General Settings Section
6614	add_settings_section(
6615	'mxchat_general_section',
6616	esc_html__('YouTube Tutorials', 'mxchat'),
6617	null,
6618	'mxchat-general'
6619	);
6620	}
6621
6622	public function mxchat_prompts_page_init() {
6623	register_setting(
6624	'mxchat_prompts_options',
6625	'mxchat_prompts_options',
6626	array(
6627	'type' => 'array',
6628	'description' => __('MXChat Knowledge Base Settings', 'mxchat'),
6629	'default' => array(
6630	'mxchat_auto_sync_posts' => 0,
6631	'mxchat_auto_sync_pages' => 0,
6632	'mxchat_use_pinecone' => 0,
6633	'mxchat_pinecone_api_key' => '',
6634	'mxchat_pinecone_environment' => '',
6635	'mxchat_pinecone_index' => '',
6636	'mxchat_pinecone_host' => '',
6637	),
6638	'sanitize_callback' => array($this, 'sanitize_prompts_options'),
6639	)
6640	);
6641
6642	add_action('admin_notices', array($this, 'sync_settings_notice'));
6643	}
6644
6645	public function mxchat_transcripts_page_init() {
6646	register_setting(
6647	'mxchat_transcripts_options',
6648	'mxchat_transcripts_options',
6649	array(
6650	'type' => 'array',
6651	'description' => __('MXChat Transcripts Notification Settings', 'mxchat'),
6652	'default' => array(
6653	'mxchat_enable_notifications' => 0,
6654	'mxchat_notification_email' => get_option('admin_email'),
6655	'mxchat_auto_delete_transcripts' => 'never',
6656	),
6657	'sanitize_callback' => array($this, 'sanitize_transcripts_options'),
6658	)
6659	);
6660
6661	add_settings_section(
6662	'mxchat_transcripts_notification_section',
6663	esc_html__('Chat Notification Settings', 'mxchat'),
6664	array($this, 'mxchat_transcripts_notification_section_callback'),
6665	'mxchat-transcripts'
6666	);
6667
6668	add_settings_field(
6669	'mxchat_enable_notifications',
6670	esc_html__('Enable Chat Notifications', 'mxchat'),
6671	array($this, 'mxchat_enable_notifications_callback'),
6672	'mxchat-transcripts',
6673	'mxchat_transcripts_notification_section'
6674	);
6675
6676	add_settings_field(
6677	'mxchat_notification_email',
6678	esc_html__('Notification Email Address', 'mxchat'),
6679	array($this, 'mxchat_notification_email_callback'),
6680	'mxchat-transcripts',
6681	'mxchat_transcripts_notification_section'
6682	);
6683
6684	add_settings_field(
6685	'mxchat_auto_delete_transcripts',
6686	esc_html__('Auto-Delete Old Transcripts', 'mxchat'),
6687	array($this, 'mxchat_auto_delete_transcripts_callback'),
6688	'mxchat-transcripts',
6689	'mxchat_transcripts_notification_section'
6690	);
6691
6692	add_settings_field(
6693	'mxchat_retention_days',
6694	esc_html__('Custom Retention (Days)', 'mxchat'),
6695	array($this, 'mxchat_retention_days_callback'),
6696	'mxchat-transcripts',
6697	'mxchat_transcripts_notification_section'
6698	);
6699
6700	add_settings_field(
6701	'mxchat_auto_email_transcript',
6702	esc_html__('Auto-Email Full Transcript', 'mxchat'),
6703	array($this, 'mxchat_auto_email_transcript_callback'),
6704	'mxchat-transcripts',
6705	'mxchat_transcripts_notification_section'
6706	);
6707	}
6708
6709
6710	/**
6711	* Sanitize all prompts options
6712	*
6713	* @param array $input The unsanitized options array
6714	* @return array The sanitized options array
6715	*/
6716	public function sanitize_prompts_options($input) {
6717	// Log the incoming input.
6718	//error_log('Sanitizing inputs: ' . print_r($input, true));
6719
6720	$sanitized = array();
6721
6722	// Boolean options
6723	$sanitized['mxchat_auto_sync_posts'] = isset($input['mxchat_auto_sync_posts']) ? 1 : 0;
6724	$sanitized['mxchat_auto_sync_pages'] = isset($input['mxchat_auto_sync_pages']) ? 1 : 0;
6725	$sanitized['mxchat_use_pinecone'] = !empty($input['mxchat_use_pinecone']) ? 1 : 0;
6726
6727	// API Key: if less than 32 characters, flag as invalid.
6728	$api_key = sanitize_text_field($input['mxchat_pinecone_api_key'] ?? '');
6729	if (!empty($api_key) && strlen($api_key) < 32) {
6730	add_settings_error(
6731	'mxchat_prompts_options',
6732	'invalid_api_key',
6733	__('The Pinecone API key appears to be invalid. Please check your API key.', 'mxchat')
6734	);
6735	$existing_options = get_option('mxchat_prompts_options', array());
6736	$sanitized['mxchat_pinecone_api_key'] = $existing_options['mxchat_pinecone_api_key'] ?? '';
6737	} else {
6738	$sanitized['mxchat_pinecone_api_key'] = $api_key;
6739	}
6740
6741	// Environment and Index Name
6742	$sanitized['mxchat_pinecone_environment'] = sanitize_text_field($input['mxchat_pinecone_environment'] ?? '');
6743	$sanitized['mxchat_pinecone_index'] = sanitize_text_field($input['mxchat_pinecone_index'] ?? '');
6744
6745	// Host: Remove protocol and validate format.
6746	$host = sanitize_text_field($input['mxchat_pinecone_host'] ?? '');
6747	$host = preg_replace('#^https?://#', '', $host);
6748	//error_log('Host after removing protocol: ' . $host);
6749	if (!empty($host)) {
6750	if (!preg_match('/^[\w-]+\.svc\.[\w-]+\.pinecone\.io$/', $host)) {
6751	add_settings_error(
6752	'mxchat_prompts_options',
6753	'invalid_host',
6754	__('The Pinecone host appears to be invalid. It should look like "mxchat-vectors-zrmsquq.svc.aped-4627-b74a.pinecone.io"', 'mxchat')
6755	);
6756	$existing_options = get_option('mxchat_prompts_options', array());
6757	$sanitized['mxchat_pinecone_host'] = $existing_options['mxchat_pinecone_host'] ?? '';
6758	} else {
6759	$sanitized['mxchat_pinecone_host'] = $host;
6760	}
6761	} else {
6762	$sanitized['mxchat_pinecone_host'] = '';
6763	}
6764
6765	//error_log('Final sanitized array: ' . print_r($sanitized, true));
6766
6767	return $sanitized;
6768	}
6769
6770	public function sync_settings_notice() {
6771	// Only show notice on our plugin page
6772	if (!isset($_GET['page']) \|\| $_GET['page'] !== 'mxchat-prompts') {
6773	return;
6774	}
6775
6776	// Check if settings were updated
6777	if (isset($_GET['settings-updated'])) {
6778
6779	?>
6780	<div class="notice notice-success is-dismissible">
6781	<p><?php esc_html_e('Sync settings updated successfully.', 'mxchat'); ?></p>
6782	<button type="button" class="notice-dismiss"><span class="screen-reader-text"><?php esc_html_e('Dismiss this notice.', 'mxchat'); ?></span></button>
6783	</div>
6784	<?php
6785
6786	}
6787	}
6788	// Add this sanitization function to your class
6789	public function sanitize_sync_setting($input) {
6790	return (bool)$input ? __('1', 'mxchat') : __('', 'mxchat');
6791	}
6792
6793	public function mxchat_rate_limits_callback() {
6794	$all_options = get_option('mxchat_options', []);
6795
6796	// Define available rate limits
6797	$rate_limits = array('1', '3', '5', '10', '15', '20', '50', '100', 'unlimited');
6798
6799	// Define available timeframes
6800	$timeframes = array(
6801	'hourly' => __('Per Hour', 'mxchat'),
6802	'daily' => __('Per Day', 'mxchat'),
6803	'weekly' => __('Per Week', 'mxchat'),
6804	'monthly' => __('Per Month', 'mxchat')
6805	);
6806
6807	// Get all roles plus a "logged_out" pseudo-role
6808	$roles = wp_roles()->get_names();
6809	$roles['logged_out'] = __('Logged Out Users', 'mxchat');
6810
6811	// Start the wrapper
6812	echo '<div class="pro-feature-wrapper active">';
6813	echo '<div class="mxchat-rate-limits-container">';
6814
6815	echo '<p class="description" style="margin-bottom: 20px;">' .
6816	esc_html__('Set message limits for each user role and customize the experience when users reach those limits. You can use {limit}, {timeframe}, {count}, and {remaining} as placeholders.', 'mxchat') .
6817	'</p>';
6818
6819	// Add markdown link documentation
6820	echo '<div class="notice notice-info inline" style="margin-bottom: 20px; padding: 10px;">';
6821	echo '<p><strong>' . esc_html__('Markdown Links Supported:', 'mxchat') . '</strong></p>';
6822	echo '<p>' . esc_html__('You can include clickable links in your custom messages using markdown syntax:', 'mxchat') . '</p>';
6823	echo '<ul style="margin-left: 20px;">';
6824	echo '<li><code>[Link text](https://example.com)</code> - Creates a clickable link</li>';
6825	echo '<li><code>[Visit our pricing](https://example.com/pricing)</code> - Link with custom text</li>';
6826	echo '<li><code>Plain URLs like https://example.com will also become clickable</code></li>';
6827	echo '</ul>';
6828	echo '</div>';
6829
6830	// Output the controls for each role
6831	foreach ($roles as $role_id => $role_name) {
6832	// Get saved options or defaults
6833	$default_limit = ($role_id === 'logged_out') ? '10' : '100';
6834	$default_timeframe = 'daily';
6835	$default_message = __('Rate limit exceeded. Please try again later.', 'mxchat');
6836
6837	$selected_limit = isset($all_options['rate_limits'][$role_id]['limit'])
6838	? $all_options['rate_limits'][$role_id]['limit']
6839	: $default_limit;
6840
6841	$selected_timeframe = isset($all_options['rate_limits'][$role_id]['timeframe'])
6842	? $all_options['rate_limits'][$role_id]['timeframe']
6843	: $default_timeframe;
6844
6845	$custom_message = isset($all_options['rate_limits'][$role_id]['message'])
6846	? $all_options['rate_limits'][$role_id]['message']
6847	: $default_message;
6848
6849	// Output the row
6850	echo '<div class="mxchat-rate-limit-row mxchat-autosave-section">';
6851
6852	// Role label
6853	echo '<div class="mxchat-rate-limit-role">' . esc_html($role_name) . '</div>';
6854
6855	// Controls section
6856	echo '<div class="mxchat-rate-limit-controls-wrapper">';
6857
6858	// Rate limit and timeframe controls
6859	echo '<div class="mxchat-rate-limit-controls">';
6860
6861	// Limit dropdown
6862	echo '<div>';
6863	echo '<label for="rate_limits_' . esc_attr($role_id) . '_limit">' . esc_html__('Limit:', 'mxchat') . '</label>';
6864	echo '<select
6865	id="rate_limits_' . esc_attr($role_id) . '_limit"
6866	name="mxchat_options[rate_limits][' . esc_attr($role_id) . '][limit]"
6867	class="mxchat-autosave-field">';
6868	foreach ($rate_limits as $limit) {
6869	echo '<option value="' . esc_attr($limit) . '" ' . selected($selected_limit, $limit, false) . '>' . esc_html($limit) . '</option>';
6870	}
6871	echo '</select>';
6872	echo '</div>';
6873
6874	// Timeframe dropdown
6875	echo '<div>';
6876	echo '<label for="rate_limits_' . esc_attr($role_id) . '_timeframe">' . esc_html__('Timeframe:', 'mxchat') . '</label>';
6877	echo '<select
6878	id="rate_limits_' . esc_attr($role_id) . '_timeframe"
6879	name="mxchat_options[rate_limits][' . esc_attr($role_id) . '][timeframe]"
6880	class="mxchat-autosave-field">';
6881	foreach ($timeframes as $value => $label) {
6882	echo '<option value="' . esc_attr($value) . '" ' . selected($selected_timeframe, $value, false) . '>' . esc_html($label) . '</option>';
6883	}
6884	echo '</select>';
6885	echo '</div>';
6886
6887	echo '</div>'; // End controls
6888
6889	// Custom message textarea
6890	echo '<div class="mxchat-rate-limit-message">';
6891	echo '<label for="rate_limits_' . esc_attr($role_id) . '_message">' . esc_html__('Custom Message:', 'mxchat') . '</label>';
6892	echo '<textarea
6893	id="rate_limits_' . esc_attr($role_id) . '_message"
6894	name="mxchat_options[rate_limits][' . esc_attr($role_id) . '][message]"
6895	class="mxchat-autosave-field"
6896	placeholder="' . esc_attr__('Enter custom message when rate limit is exceeded', 'mxchat') . '">' .
6897	esc_textarea($custom_message) .
6898	'</textarea>';
6899	echo '<p class="description">' .
6900	esc_html__('Example: Rate limit reached! [Visit our pricing page](https://example.com/pricing) to upgrade.', 'mxchat') .
6901	'</p>';
6902	echo '</div>'; // End message
6903
6904	echo '</div>'; // End controls wrapper
6905
6906	echo '</div>'; // End row
6907	}
6908
6909	echo '</div>'; // End container
6910
6911	echo '</div>'; // End pro-feature-wrapper
6912	}
6913
6914	private function mxchat_add_option_field($id, $title, $callback = '') {
6915	add_settings_field(
6916	$id,
6917	__($title, 'mxchat'),
6918	$callback ? array($this, $callback) : array($this, $id . '_callback'),
6919	'mxchat-max',
6920	'mxchat_setting_section_id',
6921	$id === 'model' ? ['label_for' => 'model'] : []
6922	);
6923	}
6924
6925	// API Keys Section Callback
6926	public function mxchat_api_keys_section_callback() {
6927	echo '<p>' . esc_html__('Manage all your API keys in one place. Add the API keys for the services you want to use with your chatbot.', 'mxchat') . '</p>';
6928	}
6929
6930	// OpenAI API Key
6931	public function api_key_callback() {
6932	$apiKey = isset($this->options['api_key']) ? esc_attr($this->options['api_key']) : '';
6933	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6934
6935	echo '<div class="api-key-wrapper">';
6936	echo '<input type="text" id="api_key" name="api_key" value="' . $apiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6937	echo '<button type="button" id="toggleApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6938	echo '<p class="description">' . esc_html__('Required for OpenAI GPT models and OpenAI embeddings. Get your API key from OpenAI Platform.', 'mxchat') . '</p>';
6939	echo '</div>';
6940	}
6941
6942	// X.AI API Key
6943	public function xai_api_key_callback() {
6944	$xaiApiKey = isset($this->options['xai_api_key']) ? esc_attr($this->options['xai_api_key']) : '';
6945	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6946
6947	echo '<div class="api-key-wrapper">';
6948	echo '<input type="text" id="xai_api_key" name="xai_api_key" value="' . $xaiApiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6949	echo '<button type="button" id="toggleXaiApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6950	echo '<p class="description">' . esc_html__('Required for X.AI Grok models. Get your API key from X.AI Console.', 'mxchat') . '</p>';
6951	echo '</div>';
6952	}
6953	// Claude API Key
6954	public function claude_api_key_callback() {
6955	$claudeApiKey = isset($this->options['claude_api_key']) ? esc_attr($this->options['claude_api_key']) : '';
6956	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6957
6958	echo '<div class="api-key-wrapper">';
6959	echo '<input type="text" id="claude_api_key" name="claude_api_key" value="' . $claudeApiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6960	echo '<button type="button" id="toggleClaudeApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6961	echo '<p class="description">' . esc_html__('Required for Anthropic Claude models. Get your API key from Anthropic Console.', 'mxchat') . '</p>';
6962	echo '</div>';
6963	}
6964
6965	// DeepSeek API Key
6966	public function deepseek_api_key_callback() {
6967	$apiKey = isset($this->options['deepseek_api_key']) ? esc_attr($this->options['deepseek_api_key']) : '';
6968	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6969
6970	echo '<div class="api-key-wrapper">';
6971	echo '<input type="text" id="deepseek_api_key" name="deepseek_api_key" value="' . $apiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6972	echo '<button type="button" id="toggleDeepSeekApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6973	echo '<p class="description">' . esc_html__('Required for DeepSeek models. Get your API key from DeepSeek Platform.', 'mxchat') . '</p>';
6974	echo '</div>';
6975	}
6976
6977	// Gemini API Key
6978	public function gemini_api_key_callback() {
6979	$geminiApiKey = isset($this->options['gemini_api_key']) ? esc_attr($this->options['gemini_api_key']) : '';
6980	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6981
6982	echo '<div class="api-key-wrapper">';
6983	echo '<input type="text" id="gemini_api_key" name="gemini_api_key" value="' . $geminiApiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6984	echo '<button type="button" id="toggleGeminiApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6985	echo '<p class="description">' . esc_html__('Required for Google Gemini models and embeddings. Get your API key from Google AI Studio.', 'mxchat') . '</p>';
6986	echo '</div>';
6987	}
6988
6989
6990	// OpenRouter API Key
6991	public function openrouter_api_key_callback() {
6992	$openrouterApiKey = isset($this->options['openrouter_api_key']) ? esc_attr($this->options['openrouter_api_key']) : '';
6993	$nonce = wp_create_nonce('mxchat_autosave_nonce');
6994
6995	echo '<div class="api-key-wrapper">';
6996	echo '<input type="text" id="openrouter_api_key" name="openrouter_api_key" value="' . $openrouterApiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
6997	echo '<button type="button" id="toggleOpenRouterApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
6998	echo '<p class="description">' . esc_html__('Required for OpenRouter models. Get your API key from OpenRouter.ai', 'mxchat') . '</p>';
6999	echo '</div>';
7000	}
7001
7002	// Custom (OpenAI-compatible) Provider — Ollama, LM Studio, vLLM, llama.cpp, Azure OpenAI, etc.
7003	public function custom_provider_callback() {
7004	$base_url = isset($this->options['custom_provider_base_url']) ? esc_attr($this->options['custom_provider_base_url']) : '';
7005	$api_key = isset($this->options['custom_provider_api_key']) ? esc_attr($this->options['custom_provider_api_key']) : '';
7006	$model_name = isset($this->options['custom_provider_model']) ? esc_attr($this->options['custom_provider_model']) : '';
7007	$auth_scheme = isset($this->options['custom_provider_auth_scheme']) ? esc_attr($this->options['custom_provider_auth_scheme']) : 'bearer';
7008	$api_version = isset($this->options['custom_provider_api_version']) ? esc_attr($this->options['custom_provider_api_version']) : '';
7009	$use_embed = !empty($this->options['custom_provider_for_embeddings']) && $this->options['custom_provider_for_embeddings'] === 'on';
7010	$use_images = !empty($this->options['custom_provider_for_images']) && $this->options['custom_provider_for_images'] === 'on';
7011	$embed_model = isset($this->options['custom_provider_embedding_model']) ? esc_attr($this->options['custom_provider_embedding_model']) : '';
7012	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7013	$test_nonce = wp_create_nonce('mxchat_test_custom_provider');
7014
7015	echo '<style>
7016	.mxchat-cp { max-width: 680px; }
7017	.mxchat-cp .mxchat-cp-intro { margin: 0 0 16px; color: #50575e; font-size: 13px; line-height: 1.5; }
7018	.mxchat-cp .mxchat-cp-row { display: block; margin: 0 0 18px; }
7019	.mxchat-cp .mxchat-cp-row > label { display: block; font-weight: 600; margin: 0 0 6px; color: #1d2327; font-size: 13px; }
7020	.mxchat-cp .mxchat-cp-row > input[type="text"],
7021	.mxchat-cp .mxchat-cp-row > input[type="password"],
7022	.mxchat-cp .mxchat-cp-row > select { display: block; width: 100%; max-width: 480px; margin: 0; }
7023	.mxchat-cp .mxchat-cp-row > .description { display: block; margin: 6px 0 0; color: #646970; font-size: 12px; line-height: 1.5; max-width: 480px; }
7024	.mxchat-cp .mxchat-cp-test { margin-top: 4px; padding-top: 14px; border-top: 1px solid #e5e7eb; }
7025	.mxchat-cp .mxchat-cp-test .mxchat-cp-test-status { display: inline-block; margin-left: 10px; vertical-align: middle; font-size: 13px; }
7026	.mxchat-cp .mxchat-cp-azure { margin: 0 0 18px; padding: 12px 14px; background: #f6f7ff; border: 1px solid #dfe1f5; border-left: 3px solid #7873f5; border-radius: 6px; max-width: 480px; }
7027	.mxchat-cp .mxchat-cp-azure > .mxchat-cp-azure-title { display: block; font-weight: 600; color: #1d2327; font-size: 12px; text-transform: uppercase; letter-spacing: 0.4px; margin: 0 0 8px; }
7028	.mxchat-cp .mxchat-cp-azure ol { margin: 0; padding: 0 0 0 18px; color: #50575e; font-size: 12px; line-height: 1.7; }
7029	.mxchat-cp .mxchat-cp-azure code { background: #eceefb; padding: 1px 5px; border-radius: 3px; font-size: 11px; }
7030	</style>';
7031
7032	echo '<div class="api-key-wrapper mxchat-cp">';
7033	echo '<p class="mxchat-cp-intro">' . esc_html__('Point MxChat at any OpenAI-compatible /v1/chat/completions endpoint: Ollama, LM Studio, vLLM, llama.cpp, LocalAI, Azure OpenAI, etc. Then select "Custom (OpenAI-compatible)" in the model picker.', 'mxchat') . '</p>';
7034
7035	// Azure OpenAI quick start — consolidates the 4-field Azure recipe in one scannable callout
7036	// so admins can configure Azure without piecing it together from each field's hint.
7037	echo '<div class="mxchat-cp-azure">';
7038	echo '<span class="mxchat-cp-azure-title">' . esc_html__('Azure OpenAI quick start', 'mxchat') . '</span>';
7039	echo '<ol>';
7040	echo '<li>' . wp_kses(__('<strong>Base URL</strong> → <code>https://<resource>.openai.azure.com/openai/deployments/<deployment></code>', 'mxchat'), array('strong' => array(), 'code' => array())) . '</li>';
7041	echo '<li>' . wp_kses(__('<strong>API Key</strong> → your Azure OpenAI key (required)', 'mxchat'), array('strong' => array(), 'code' => array())) . '</li>';
7042	echo '<li>' . wp_kses(__('<strong>Auth Scheme</strong> → <code>api-key header (Azure OpenAI)</code>', 'mxchat'), array('strong' => array(), 'code' => array())) . '</li>';
7043	echo '<li>' . wp_kses(__('<strong>API Version</strong> → required for Azure, e.g. <code>2024-08-01-preview</code>', 'mxchat'), array('strong' => array(), 'code' => array())) . '</li>';
7044	echo '</ol>';
7045	echo '</div>';
7046
7047	echo '<div class="mxchat-cp-row">';
7048	echo '<label for="custom_provider_base_url">' . esc_html__('Base URL', 'mxchat') . '</label>';
7049	echo '<input type="text" id="custom_provider_base_url" name="custom_provider_base_url" value="' . $base_url . '" class="regular-text mxchat-autosave-field" placeholder="http://localhost:11434/v1" autocomplete="off" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
7050	echo '<p class="description">' . esc_html__('Examples: Ollama http://localhost:11434/v1 · LM Studio http://localhost:1234/v1 · vLLM http://gpu:8000/v1 · Azure https://<resource>.openai.azure.com/openai/deployments/<deployment>', 'mxchat') . '</p>';
7051	echo '</div>';
7052
7053	echo '<div class="mxchat-cp-row">';
7054	echo '<label for="custom_provider_api_key">' . esc_html__('API Key (optional)', 'mxchat') . '</label>';
7055	echo '<input type="password" id="custom_provider_api_key" name="custom_provider_api_key" value="' . $api_key . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
7056	echo '<p class="description">' . esc_html__('Leave empty for unauthenticated local servers. Required for Azure / vLLM / hosted endpoints.', 'mxchat') . '</p>';
7057	echo '</div>';
7058
7059	echo '<div class="mxchat-cp-row">';
7060	echo '<label for="custom_provider_model">' . esc_html__('Model Name', 'mxchat') . '</label>';
7061	echo '<input type="text" id="custom_provider_model" name="custom_provider_model" value="' . $model_name . '" class="regular-text mxchat-autosave-field" placeholder="llama3.2" autocomplete="off" data-lpignore="true" data-nonce="' . $nonce . '" />';
7062	echo '<p class="description">' . esc_html__('The model identifier the upstream server expects (e.g. llama3.2, mistral, gpt-oss). For Azure this is the deployment ID — leave empty if the Base URL already includes /deployments/<deployment>.', 'mxchat') . '</p>';
7063	echo '</div>';
7064
7065	echo '<div class="mxchat-cp-row">';
7066	echo '<label for="custom_provider_auth_scheme">' . esc_html__('Auth Scheme', 'mxchat') . '</label>';
7067	echo '<select id="custom_provider_auth_scheme" name="custom_provider_auth_scheme" class="mxchat-autosave-field" data-nonce="' . $nonce . '">';
7068	echo '<option value="bearer"' . selected($auth_scheme, 'bearer', false) . '>' . esc_html__('Authorization: Bearer (OpenAI / Ollama / vLLM / LM Studio)', 'mxchat') . '</option>';
7069	echo '<option value="api-key"' . selected($auth_scheme, 'api-key', false) . '>' . esc_html__('api-key header (Azure OpenAI)', 'mxchat') . '</option>';
7070	echo '</select>';
7071	echo '<p class="description">' . esc_html__('Most OpenAI-compatible servers use Bearer. Azure OpenAI uses the api-key header.', 'mxchat') . '</p>';
7072	echo '</div>';
7073
7074	echo '<div class="mxchat-cp-row">';
7075	echo '<label for="custom_provider_api_version">' . esc_html__('API Version (Azure only)', 'mxchat') . '</label>';
7076	echo '<input type="text" id="custom_provider_api_version" name="custom_provider_api_version" value="' . $api_version . '" class="regular-text mxchat-autosave-field" placeholder="2024-08-01-preview" autocomplete="off" data-lpignore="true" data-nonce="' . $nonce . '" />';
7077	echo '<p class="description">' . esc_html__('Appended as ?api-version=... on the request URL. Required for Azure OpenAI; leave empty for non-Azure providers.', 'mxchat') . '</p>';
7078	echo '</div>';
7079
7080	// Extended-use checkboxes — opt-in routing of other dispatcher paths through the custom provider.
7081	echo '<div class="mxchat-cp-row">';
7082	echo '<label style="font-weight:600; display:block; margin:0 0 6px; color:#1d2327; font-size:13px;">' . esc_html__('Extended routing (opt-in)', 'mxchat') . '</label>';
7083	echo '<label style="display:block; margin:0 0 6px; font-weight:400;"><input type="checkbox" id="custom_provider_for_embeddings" name="custom_provider_for_embeddings" value="on"' . checked($use_embed, true, false) . ' class="mxchat-autosave-field" data-nonce="' . $nonce . '" /> ' . esc_html__('Use custom provider for embeddings', 'mxchat') . '</label>';
7084	echo '<label style="display:block; margin:0 0 0; font-weight:400;"><input type="checkbox" id="custom_provider_for_images" name="custom_provider_for_images" value="on"' . checked($use_images, true, false) . ' class="mxchat-autosave-field" data-nonce="' . $nonce . '" /> ' . esc_html__('Use custom provider for image generation', 'mxchat') . '</label>';
7085	echo '<p class="description">' . esc_html__('When off, embeddings and image generation continue to use OpenAI (current behavior). Turn on only if your endpoint exposes OpenAI-compatible /embeddings or /images/generations routes (e.g. Ollama, vLLM, LocalAI).', 'mxchat') . '</p>';
7086	echo '</div>';
7087
7088	echo '<div class="mxchat-cp-row">';
7089	echo '<label for="custom_provider_embedding_model">' . esc_html__('Custom Embedding Model', 'mxchat') . '</label>';
7090	echo '<input type="text" id="custom_provider_embedding_model" name="custom_provider_embedding_model" value="' . $embed_model . '" class="regular-text mxchat-autosave-field" placeholder="nomic-embed-text" autocomplete="off" data-lpignore="true" data-nonce="' . $nonce . '" />';
7091	echo '<p class="description">' . esc_html__('Only used when "Use custom provider for embeddings" is on. The embedding model name is separate from the chat model name above (e.g. Ollama embedding models: nomic-embed-text, mxbai-embed-large). Leave blank to fall back to the chat model name.', 'mxchat') . '</p>';
7092	echo '</div>';
7093
7094	echo '<div class="mxchat-cp-test">';
7095	echo '<button type="button" class="button" id="mxchat-test-custom-provider" data-nonce="' . $test_nonce . '">' . esc_html__('Test Connection', 'mxchat') . '</button>';
7096	echo '<span id="mxchat-test-custom-provider-result" class="mxchat-cp-test-status"></span>';
7097	echo '</div>';
7098
7099	echo '<script>(function(){
7100	var btn = document.getElementById("mxchat-test-custom-provider");
7101	if (!btn \|\| btn._wired) { return; } btn._wired = true;
7102	btn.addEventListener("click", function(){
7103	var out = document.getElementById("mxchat-test-custom-provider-result");
7104	out.textContent = "' . esc_js(__('Testing...', 'mxchat')) . '";
7105	out.style.color = "#646970";
7106	var fd = new FormData();
7107	fd.append("action", "mxchat_test_custom_provider");
7108	fd.append("_wpnonce", btn.getAttribute("data-nonce"));
7109	fetch(ajaxurl, { method:"POST", credentials:"same-origin", body: fd })
7110	.then(function(r){ return r.json(); })
7111	.then(function(j){
7112	if (j && j.success) {
7113	out.textContent = "✓ " + (j.data && j.data.message ? j.data.message : "' . esc_js(__('OK', 'mxchat')) . '");
7114	out.style.color = "#00a32a";
7115	} else {
7116	out.textContent = "⚠ " + (j && j.data && j.data.message ? j.data.message : "' . esc_js(__('Failed', 'mxchat')) . '");
7117	out.style.color = "#d63638";
7118	}
7119	})
7120	.catch(function(){
7121	out.textContent = "⚠ ' . esc_js(__('Request failed', 'mxchat')) . '";
7122	out.style.color = "#d63638";
7123	});
7124	});
7125	})();</script>';
7126
7127	echo '</div>';
7128	}
7129
7130	// Voyage API Key
7131	public function voyage_api_key_callback() {
7132	$apiKey = isset($this->options['voyage_api_key']) ? esc_attr($this->options['voyage_api_key']) : '';
7133	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7134
7135	echo '<div class="api-key-wrapper">';
7136	echo '<input type="text" id="voyage_api_key" name="voyage_api_key" value="' . $apiKey . '" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="' . $nonce . '" />';
7137	echo '<button type="button" id="toggleVoyageAPIKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
7138	echo '<p class="description">' . esc_html__('Required for Voyage AI embedding models. Get your API key from Voyage AI.', 'mxchat') . '</p>';
7139	echo '</div>';
7140	}
7141
7142	public function mxchat_loops_api_key_callback() {
7143	$loops_api_key = isset($this->options['loops_api_key']) ? esc_attr($this->options['loops_api_key']) : '';
7144	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7145
7146	echo '<div class="api-key-wrapper">';
7147	echo sprintf(
7148	'<input type="text" id="loops_api_key" name="loops_api_key" value="%s" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="%s" />',
7149	$loops_api_key,
7150	$nonce
7151	);
7152	echo '<button type="button" id="toggleLoopsApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
7153	echo '</div>';
7154	echo '<p class="description">' . esc_html__('Required for Loops email integration. Get your API key from Loops.so', 'mxchat') . '</p>';
7155	}
7156	public function mxchat_loops_mailing_list_callback() {
7157	// Add error handling and type checking
7158	$loops_api_key = '';
7159	$selected_list = '';
7160	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7161
7162	// Safely get the API key
7163	if (isset($this->options['loops_api_key']) && is_string($this->options['loops_api_key'])) {
7164	$loops_api_key = $this->options['loops_api_key'];
7165	}
7166
7167	// Safely get the selected list
7168	if (isset($this->options['loops_mailing_list']) && is_string($this->options['loops_mailing_list'])) {
7169	$selected_list = $this->options['loops_mailing_list'];
7170	}
7171
7172	if (!empty($loops_api_key)) {
7173	$lists = $this->mxchat_fetch_loops_mailing_lists($loops_api_key);
7174	if (is_array($lists) && !empty($lists)) {
7175	echo '<div class="mxchat-field-wrapper">';
7176	echo '<select id="loops_mailing_list" name="loops_mailing_list" class="mxchat-autosave-field" data-nonce="' . $nonce . '">';
7177
7178	// Add a default "Select a list" option
7179	echo '<option value="" ' . selected($selected_list, '', false) . '>' . esc_html__('Select a list', 'mxchat') . '</option>';
7180
7181	foreach ($lists as $list) {
7182	if (is_array($list) && isset($list['id']) && isset($list['name'])) {
7183	echo sprintf(
7184	'<option value="%s" %s>%s</option>',
7185	esc_attr($list['id']),
7186	selected($selected_list, $list['id'], false),
7187	esc_html($list['name'])
7188	);
7189	}
7190	}
7191	echo '</select>';
7192	echo '</div>';
7193	echo '<p class="description">' . esc_html__('Please select a mailing list to use with Loops.', 'mxchat') . '</p>';
7194	} else {
7195	echo '<p class="description">' . esc_html__('No lists found. Please verify your API Key.', 'mxchat') . '</p>';
7196	}
7197	} else {
7198	echo '<p class="description">' . esc_html__('Enter a valid Loops API Key to load mailing lists.', 'mxchat') . '</p>';
7199	}
7200	}
7201	public function mxchat_triggered_phrase_response_callback() {
7202	$default_response = __('Would you like to join our mailing list? Please provide your email below.', 'mxchat');
7203	$triggered_response = isset($this->options['triggered_phrase_response'])
7204	? $this->options['triggered_phrase_response']
7205	: $default_response;
7206	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7207
7208	echo '<div class="mxchat-field-wrapper">';
7209	echo sprintf(
7210	'<textarea id="triggered_phrase_response" name="triggered_phrase_response" rows="3" cols="50" class="mxchat-autosave-field" data-nonce="%s">%s</textarea>',
7211	$nonce,
7212	esc_textarea($triggered_response)
7213	);
7214	echo '</div>';
7215	echo '<p class="description">' . esc_html__('Enter the instruction for the AI when a trigger keyword is detected. The AI will use this as guidance to naturally ask for the user\'s email in a conversational way.', 'mxchat') . '</p>';
7216	}
7217
7218	public function mxchat_email_capture_response_callback() {
7219	$default_response = __('Thank you for providing your email! You\'ve been added to our list.', 'mxchat');
7220	$email_capture_response = isset($this->options['email_capture_response'])
7221	? $this->options['email_capture_response']
7222	: $default_response;
7223	$nonce = wp_create_nonce('mxchat_autosave_nonce');
7224
7225	echo '<div class="mxchat-field-wrapper">';
7226	echo sprintf(
7227	'<textarea id="email_capture_response" name="email_capture_response" rows="3" cols="50" class="mxchat-autosave-field" data-nonce="%s">%s</textarea>',
7228	$nonce,
7229	esc_textarea($email_capture_response)
7230	);
7231	echo '</div>';
7232	echo '<p class="description">' . esc_html__('Enter the instruction for the AI when a user provides their email. The AI will use this as guidance to naturally confirm the email capture in a conversational way.', 'mxchat') . '</p>';
7233	}
7234	public function mxchat_pre_chat_message_callback() {
7235	// Load the entire 'mxchat_options' array
7236	$all_options = get_option('mxchat_options', []);
7237
7238	// Retrieve the saved message or use the default value
7239	$default_message = __('Hey there! Ask me anything!', 'mxchat');
7240	$pre_chat_message = isset($all_options['pre_chat_message']) ? $all_options['pre_chat_message'] : $default_message;
7241
7242	// Output the textarea
7243	printf(
7244	'<textarea id="pre_chat_message" name="pre_chat_message" rows="5" cols="50">%s</textarea>',
7245	esc_textarea($pre_chat_message)
7246	);
7247	}
7248
7249	// Callback for AI Instructions textarea
7250	public function system_prompt_instructions_callback() {
7251	// Retrieve the current value of the system prompt instructions
7252	$instructions = isset($this->options['system_prompt_instructions']) ? esc_textarea($this->options['system_prompt_instructions']) : '';
7253	// Render the textarea field
7254	printf(
7255	'<textarea id="system_prompt_instructions" name="system_prompt_instructions" rows="5" cols="50">%s</textarea>',
7256	$instructions
7257	);
7258	// Personalization hint
7259	echo '<p class="description" style="margin-top: 8px;">';
7260	echo esc_html__('Use {visitor_name} to personalize AI responses when lead capture is enabled.', 'mxchat') . '<br>';
7261	echo '<code style="font-size: 12px;">' . esc_html__('Example: The visitor\'s name is {visitor_name}. Address them by name.', 'mxchat') . '</code>';
7262	echo '</p>';
7263	// Sample instructions button
7264	echo '<div class="mxchat-instructions-container">';
7265	echo '<button type="button" class="mxchat-instructions-btn" id="mxchatViewSampleBtn">';
7266	echo '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">';
7267	echo '<path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/>';
7268	echo '<path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/>';
7269	echo '</svg>';
7270	echo esc_html__('View Sample Instructions', 'mxchat');
7271	echo '</button>';
7272	echo '</div>';
7273
7274	// Add modal to WordPress admin footer instead of inline
7275	add_action('admin_footer', array($this, 'render_sample_instructions_modal'));
7276	}
7277
7278	// New method to render modal in admin footer
7279	public function render_sample_instructions_modal() {
7280	static $modal_rendered = false;
7281	if ($modal_rendered) return; // Prevent duplicate modals
7282	$modal_rendered = true;
7283
7284	echo '<div class="mxchat-instructions-modal-overlay" id="mxchatSampleModal">';
7285	echo '<div class="mxchat-instructions-modal-content">';
7286	echo '<div class="mxchat-instructions-modal-header">';
7287	echo '<h3 class="mxchat-instructions-modal-title">';
7288	echo '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">';
7289	echo '<path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/>';
7290	echo '<path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/>';
7291	echo '</svg>';
7292	echo esc_html__('Sample AI Instructions', 'mxchat');
7293	echo '</h3>';
7294	echo '<button type="button" class="mxchat-instructions-modal-close" id="mxchatModalClose">';
7295	echo '<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">';
7296	echo '<line x1="18" y1="6" x2="6" y2="18"/>';
7297	echo '<line x1="6" y1="6" x2="18" y2="18"/>';
7298	echo '</svg>';
7299	echo '</button>';
7300	echo '</div>';
7301	echo '<div class="mxchat-instructions-modal-body">';
7302	echo '<div class="mxchat-instructions-content">';
7303	echo esc_html('You are an AI Chatbot assistant for this website. Your main goal is to assist visitors with questions and provide helpful information. Here are your key guidelines:
7304
7305	# Response Style - CRITICALLY IMPORTANT
7306	- MAXIMUM LENGTH: 1-3 short sentences per response
7307	- Ultra-concise: Get straight to the answer with no filler
7308	- No introductions like "Sure!" or "I\'d be happy to help"
7309	- No phrases like "based on my knowledge" or "according to information"
7310	- No explanatory text before giving the answer
7311	- No summaries or repetition
7312	- Hyperlink all URLs
7313	- Respond in user\'s language
7314	- Minor chit chat or conversation is okay, but try to keep it focused on [insert topic]
7315
7316	# Knowledge Base Requirements - PREVENT HALLUCINATIONS
7317	- ONLY answer using information explicitly provided in OFFICIAL KNOWLEDGE DATABASE CONTENT sections marked with ===== delimiters
7318	- If required information is NOT in the knowledge database: "I don\'t have enough information in my knowledge base to answer that question accurately."
7319	- NEVER invent or hallucinate URLs, links, product specs, procedures, dates, statistics, names, contacts, or company information
7320	- When knowledge base information is unclear or contradictory, acknowledge the limitation rather than guessing
7321	- Better to admit insufficient information than provide inaccurate answers');
7322	echo '</div>';
7323	echo '<button type="button" class="mxchat-instructions-copy-btn" id="mxchatCopyBtn">';
7324	echo '<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">';
7325	echo '<rect x="9" y="9" width="13" height="13" rx="2" ry="2"/>';
7326	echo '<path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/>';
7327	echo '</svg>';
7328	echo esc_html__('Copy Instructions', 'mxchat');
7329	echo '</button>';
7330	echo '</div>';
7331	echo '<div class="mxchat-instructions-modal-footer">';
7332	echo '<button type="button" class="mxchat-instructions-btn-secondary" id="mxchatCloseBtn">' . esc_html__('Close', 'mxchat') . '</button>';
7333	echo '</div>';
7334	echo '</div>';
7335	echo '</div>';
7336	}
7337
7338
7339	public function mxchat_model_callback() {
7340	// Catalog refactor (plan-d14e89): single source of truth lives in
7341	// includes/class-mxchat-model-catalog.php. Dropdown groups are the
7342	// provider labels; each group maps model_id => "Label" strings.
7343	if (!class_exists('MxChat_Model_Catalog')) {
7344	require_once plugin_dir_path(__FILE__) . 'class-mxchat-model-catalog.php';
7345	}
7346	$models = MxChat_Model_Catalog::settings_dropdown_groups();
7347
7348	// Retrieve the currently selected model from saved options
7349	$selected_model = isset($this->options['model']) ? esc_attr($this->options['model']) : 'gpt-5.1-chat-latest';
7350
7351	// Begin the select dropdown
7352	echo '<select id="model" name="model">';
7353
7354	// Iterate over groups of models
7355	foreach ($models as $group_label => $group_models) {
7356	echo '<optgroup label="' . esc_attr($group_label) . '">';
7357
7358	foreach ($group_models as $model_value => $model_label) {
7359	echo '<option value="' . esc_attr($model_value) . '" ' . selected($selected_model, $model_value, false) . '>' . esc_html($model_label) . '</option>';
7360	}
7361
7362	echo '</optgroup>';
7363	}
7364
7365	echo '</select>';
7366
7367	// Add a note for OpenRouter
7368	echo '<p class="description" id="openrouter-model-note" style="display:none; color: #d63638; font-weight: 500;">';
7369	echo '<span class="dashicons dashicons-info" style="font-size: 16px; vertical-align: middle;"></span> ';
7370	echo esc_html__('After entering your OpenRouter API key above, click the button below to load available models.', 'mxchat');
7371	echo '</p>';
7372
7373	// API Key Status Messages (hidden by default, shown by JS based on selected model)
7374	$has_openai_key = !empty($this->options['api_key']);
7375	$has_claude_key = !empty($this->options['claude_api_key']);
7376	$has_xai_key = !empty($this->options['xai_api_key']);
7377	$has_deepseek_key = !empty($this->options['deepseek_api_key']);
7378	$has_gemini_key = !empty($this->options['gemini_api_key']);
7379	$has_openrouter_key = !empty($this->options['openrouter_api_key']);
7380
7381	// OpenAI/GPT models
7382	echo '<p class="mxchat-api-status" data-provider="openai" style="display:none;">';
7383	if ($has_openai_key) {
7384	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for OpenAI detected', 'mxchat') . '</span>';
7385	} else {
7386	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for OpenAI detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7387	}
7388	echo '</p>';
7389
7390	// Claude models
7391	echo '<p class="mxchat-api-status" data-provider="claude" style="display:none;">';
7392	if ($has_claude_key) {
7393	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for Anthropic (Claude) detected', 'mxchat') . '</span>';
7394	} else {
7395	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for Anthropic (Claude) detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7396	}
7397	echo '</p>';
7398
7399	// X.AI models
7400	echo '<p class="mxchat-api-status" data-provider="xai" style="display:none;">';
7401	if ($has_xai_key) {
7402	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for X.AI (Grok) detected', 'mxchat') . '</span>';
7403	} else {
7404	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for X.AI (Grok) detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7405	}
7406	echo '</p>';
7407
7408	// DeepSeek models
7409	echo '<p class="mxchat-api-status" data-provider="deepseek" style="display:none;">';
7410	if ($has_deepseek_key) {
7411	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for DeepSeek detected', 'mxchat') . '</span>';
7412	} else {
7413	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for DeepSeek detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7414	}
7415	echo '</p>';
7416
7417	// Gemini models
7418	echo '<p class="mxchat-api-status" data-provider="gemini" style="display:none;">';
7419	if ($has_gemini_key) {
7420	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for Google Gemini detected', 'mxchat') . '</span>';
7421	} else {
7422	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for Google Gemini detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7423	}
7424	echo '</p>';
7425
7426	// OpenRouter models
7427	echo '<p class="mxchat-api-status" data-provider="openrouter" style="display:none;">';
7428	if ($has_openrouter_key) {
7429	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for OpenRouter detected', 'mxchat') . '</span>';
7430	} else {
7431	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for OpenRouter detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7432	}
7433	echo '</p>';
7434
7435	// ADD THESE HIDDEN FIELDS RIGHT HERE:
7436	$openrouter_model = isset($this->options['openrouter_selected_model']) ? esc_attr($this->options['openrouter_selected_model']) : '';
7437	$openrouter_model_name = isset($this->options['openrouter_selected_model_name']) ? esc_attr($this->options['openrouter_selected_model_name']) : '';
7438
7439	echo '<input type="hidden" id="openrouter_selected_model" name="openrouter_selected_model" value="' . $openrouter_model . '" />';
7440	echo '<input type="hidden" id="openrouter_selected_model_name" name="openrouter_selected_model_name" value="' . $openrouter_model_name . '" />';
7441	}
7442
7443	// Update your existing callback method
7444	public function enable_streaming_toggle_callback() {
7445	// Get value from options array, default to 'on'
7446	$enabled = isset($this->options['enable_streaming_toggle']) ? $this->options['enable_streaming_toggle'] : 'on';
7447	$checked = ($enabled === 'on') ? 'checked' : '';
7448
7449	echo '<label class="toggle-switch">';
7450	echo sprintf(
7451	'<input type="checkbox" id="enable_streaming_toggle" name="enable_streaming_toggle" value="on" %s />',
7452	esc_attr($checked)
7453	);
7454	echo '<span class="slider"></span>';
7455	echo '</label>';
7456
7457	// Test button — branded .mxch-btn with inline SVG (IDs preserved for AJAX binding)
7458	echo '<div class="mxch-streaming-test-row">';
7459	echo '<button type="button" id="mxchat-test-streaming-btn" class="mxch-btn mxch-btn-secondary">';
7460	echo '<svg class="mxch-streaming-test-icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="22 12 18 12 15 21 9 3 6 12 2 12"/></svg>';
7461	echo esc_html__('Test Streaming Compatibility', 'mxchat');
7462	echo '</button>';
7463	echo '<p id="mxchat-test-streaming-result" class="mxch-streaming-test-result"></p>';
7464	echo '</div>';
7465	}
7466
7467	// Web Search toggle callback
7468	public function enable_web_search_toggle_callback() {
7469	// Get value from options array, default to 'off'
7470	$enabled = isset($this->options['enable_web_search']) ? $this->options['enable_web_search'] : 'off';
7471	$checked = ($enabled === 'on') ? 'checked' : '';
7472
7473	// Get current model to determine if we should show/enable the toggle
7474	$current_model = isset($this->options['model']) ? $this->options['model'] : 'gpt-5.1-chat-latest';
7475
7476	// Models that DON'T support web search — OpenAI-docs-driven exception list.
7477	// Keep hardcoded; the catalog can't infer "supports web search" per-model, so any
7478	// future OpenAI model that lacks Responses-API web_search support is added here.
7479	$unsupported_models = array('gpt-4.1-nano');
7480
7481	// OpenAI chat-model allowlist for the Web Search toggle, derived from the central
7482	// model catalog (class-mxchat-model-catalog.php). When a new OpenAI chat model is
7483	// added there, the Web Search toggle picks it up automatically — no edit here.
7484	if (!class_exists('MxChat_Model_Catalog')) {
7485	require_once plugin_dir_path(__FILE__) . 'class-mxchat-model-catalog.php';
7486	}
7487	$chat_catalog = MxChat_Model_Catalog::chat_models();
7488	$openai_models = (isset($chat_catalog['openai']['models']) && is_array($chat_catalog['openai']['models']))
7489	? array_keys($chat_catalog['openai']['models'])
7490	: array();
7491
7492	$is_openai = in_array($current_model, $openai_models);
7493	$is_supported = $is_openai && !in_array($current_model, $unsupported_models);
7494
7495	// Wrapper div with data attributes for JS to show/hide
7496	echo '<div id="web-search-toggle-wrapper" data-openai-models="' . esc_attr(implode(',', $openai_models)) . '" data-unsupported-models="' . esc_attr(implode(',', $unsupported_models)) . '"' . (!$is_supported ? ' style="display:none;"' : '') . '>';
7497
7498	echo '<label class="toggle-switch">';
7499	echo sprintf(
7500	'<input type="checkbox" id="enable_web_search" name="enable_web_search" value="on" %s />',
7501	esc_attr($checked)
7502	);
7503	echo '<span class="slider"></span>';
7504	echo '</label>';
7505
7506	echo '</div>';
7507
7508	// Message shown when non-OpenAI model is selected
7509	echo '<p id="web-search-unavailable-message" class="description" style="color: #666;' . ($is_supported ? ' display:none;' : '') . '">';
7510	echo '<span class="dashicons dashicons-info" style="font-size: 16px; vertical-align: middle; margin-right: 4px;"></span>';
7511	echo esc_html__('Web search is only available for OpenAI models.', 'mxchat');
7512	echo '</p>';
7513	}
7514
7515	// AJAX handler to fetch OpenRouter models
7516	public function fetch_openrouter_models() {
7517	check_ajax_referer('mxchat_fetch_openrouter_models', 'nonce');
7518
7519	$api_key = isset($_POST['api_key']) ? sanitize_text_field($_POST['api_key']) : '';
7520
7521	if (empty($api_key)) {
7522	wp_send_json_error(array('message' => 'API key is required'));
7523	}
7524
7525	$response = wp_remote_get('https://openrouter.ai/api/v1/models', array(
7526	'headers' => array(
7527	'Authorization' => 'Bearer ' . $api_key,
7528	'Content-Type' => 'application/json',
7529	),
7530	'timeout' => 15,
7531	));
7532
7533	if (is_wp_error($response)) {
7534	wp_send_json_error(array('message' => $response->get_error_message()));
7535	}
7536
7537	$body = wp_remote_retrieve_body($response);
7538	$data = json_decode($body, true);
7539
7540	if (isset($data['data']) && is_array($data['data'])) {
7541	// Format the models for the frontend
7542	$models = array_map(function($model) {
7543	return array(
7544	'id' => $model['id'],
7545	'name' => $model['name'] ?? $model['id'],
7546	'description' => $model['description'] ?? '',
7547	'context_length' => $model['context_length'] ?? 0,
7548	'pricing' => array(
7549	'prompt' => $model['pricing']['prompt'] ?? 0,
7550	'completion' => $model['pricing']['completion'] ?? 0,
7551	),
7552	);
7553	}, $data['data']);
7554
7555	wp_send_json_success(array('models' => $models));
7556	} else {
7557	wp_send_json_error(array('message' => 'Invalid response from OpenRouter'));
7558	}
7559	}
7560
7561	// Callback function for embedding model selection
7562	public function embedding_model_callback() {
7563	$models = array(
7564	esc_html__('OpenAI Embeddings', 'mxchat') => array(
7565	'text-embedding-3-small' => esc_html__('TE3 Small (1536, Efficient)', 'mxchat'),
7566	'text-embedding-ada-002' => esc_html__('Ada 2 (1536, Recommended)', 'mxchat'),
7567	'text-embedding-3-large' => esc_html__('TE3 Large (3072, Powerful)', 'mxchat'),
7568	),
7569	esc_html__('Voyage AI Embeddings', 'mxchat') => array(
7570	'voyage-3-large' => esc_html__('Voyage-3 Large (2048, Most Capable)', 'mxchat'),
7571	),
7572	esc_html__('Google Gemini Embeddings', 'mxchat') => array(
7573	'gemini-embedding-001' => esc_html__('Gemini Embedding (1536, Stable)', 'mxchat'),
7574	)
7575	);
7576	$selected_model = isset($this->options['embedding_model']) ? esc_attr($this->options['embedding_model']) : 'text-embedding-ada-002';
7577	echo '<select id="embedding_model" name="embedding_model">';
7578	foreach ($models as $group_label => $group_models) {
7579	echo '<optgroup label="' . esc_attr($group_label) . '">';
7580	foreach ($group_models as $model_value => $model_label) {
7581	echo '<option value="' . esc_attr($model_value) . '" ' . selected($selected_model, $model_value, false) . '>' . esc_html($model_label) . '</option>';
7582	}
7583	echo '</optgroup>';
7584	}
7585	echo '</select>';
7586
7587	// API Key Status Messages for Embedding Models
7588	$has_openai_key = !empty($this->options['api_key']);
7589	$has_voyage_key = !empty($this->options['voyage_api_key']);
7590	$has_gemini_key = !empty($this->options['gemini_api_key']);
7591
7592	// OpenAI Embeddings
7593	echo '<p class="mxchat-embedding-api-status" data-provider="openai" style="display:none;">';
7594	if ($has_openai_key) {
7595	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for OpenAI detected', 'mxchat') . '</span>';
7596	} else {
7597	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for OpenAI detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7598	}
7599	echo '</p>';
7600
7601	// Voyage AI Embeddings
7602	echo '<p class="mxchat-embedding-api-status" data-provider="voyage" style="display:none;">';
7603	if ($has_voyage_key) {
7604	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for Voyage AI detected', 'mxchat') . '</span>';
7605	} else {
7606	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for Voyage AI detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7607	}
7608	echo '</p>';
7609
7610	// Gemini Embeddings
7611	echo '<p class="mxchat-embedding-api-status" data-provider="gemini" style="display:none;">';
7612	if ($has_gemini_key) {
7613	echo '<span style="color: #00a32a;">✓ ' . esc_html__('API key for Google Gemini detected', 'mxchat') . '</span>';
7614	} else {
7615	echo '<span style="color: #d63638;">⚠ ' . esc_html__('No API key for Google Gemini detected. Please enter API key in API Keys tab.', 'mxchat') . '</span>';
7616	}
7617	echo '</p>';
7618
7619	}
7620
7621
7622	public function mxchat_top_bar_title_callback() {
7623	// Retrieve the current value of the top bar title from saved options
7624	$top_bar_title = isset($this->options['top_bar_title']) ? esc_attr($this->options['top_bar_title']) : '';
7625
7626	// Render the input field
7627	echo '<input type="text" id="top_bar_title" name="top_bar_title" value="' . $top_bar_title . '" />';
7628	}
7629	public function mxchat_ai_agent_text_callback() {
7630	// Retrieve the current value of the AI agent text from saved options
7631	$ai_agent_text = isset($this->options['ai_agent_text']) ? esc_attr($this->options['ai_agent_text']) : '';
7632	// Render the input field
7633	echo '<input type="text" id="ai_agent_text" name="ai_agent_text" value="' . $ai_agent_text . '" />';
7634	}
7635
7636
7637	public function enable_email_block_callback() {
7638	// Load full plugin options array
7639	$all_options = get_option('mxchat_options', []);
7640
7641	// Get the value, default to 'off'
7642	$enable_email_block = isset($all_options['enable_email_block']) ? $all_options['enable_email_block'] : 'off';
7643
7644	// Check if it's 'on'
7645	$checked = ($enable_email_block === 'on') ? 'checked' : '';
7646
7647	echo '<label class="toggle-switch">';
7648	echo sprintf(
7649	'<input type="checkbox" id="enable_email_block" name="enable_email_block" value="on" %s />',
7650	esc_attr($checked)
7651	);
7652	echo '<span class="slider"></span>';
7653	echo '</label>';
7654	}
7655
7656	public function email_blocker_header_content_callback() {
7657	// Load the entire 'mxchat_options' array
7658	$all_options = get_option('mxchat_options', []);
7659
7660	// Retrieve the saved content or default to empty
7661	$content = isset($all_options['email_blocker_header_content'])
7662	? $all_options['email_blocker_header_content']
7663	: '';
7664
7665	// Render the textarea - IMPORTANT: name should be just "email_blocker_header_content"
7666	echo '<textarea
7667	id="email_blocker_header_content"
7668	name="email_blocker_header_content"
7669	rows="5"
7670	cols="70"
7671	data-setting="email_blocker_header_content"
7672	>' . esc_textarea($content) . '</textarea>';
7673	}
7674
7675	public function email_blocker_button_text_callback() {
7676	// Load the entire 'mxchat_options' array
7677	$all_options = get_option('mxchat_options', []);
7678
7679	// Retrieve the saved button text or default to empty
7680	$button_text = isset($all_options['email_blocker_button_text'])
7681	? $all_options['email_blocker_button_text']
7682	: '';
7683
7684	// Use esc_attr to safely render the existing text
7685	echo '<input type="text" id="email_blocker_button_text" name="email_blocker_button_text" value="' . esc_attr($button_text) . '" style="width: 300px;" />';
7686	}
7687
7688	//Enable name field callback
7689	public function enable_name_field_callback() {
7690	// Load full plugin options array
7691	$all_options = get_option('mxchat_options', []);
7692	// Get the value, default to 'off'
7693	$enable_name_field = isset($all_options['enable_name_field']) ? $all_options['enable_name_field'] : 'off';
7694	// Check if it's 'on'
7695	$checked = ($enable_name_field === 'on') ? 'checked' : '';
7696	echo '<label class="toggle-switch">';
7697	echo sprintf(
7698	'<input type="checkbox" id="enable_name_field" name="enable_name_field" value="on" %s />',
7699	esc_attr($checked)
7700	);
7701	echo '<span class="slider"></span>';
7702	echo '</label>';
7703	}
7704	//Name field placeholder callback
7705	public function name_field_placeholder_callback() {
7706	$all_options = get_option('mxchat_options', []);
7707	$placeholder = isset($all_options['name_field_placeholder'])
7708	? $all_options['name_field_placeholder']
7709	: esc_html__('Enter your name', 'mxchat');
7710
7711	echo '<input type="text" id="name_field_placeholder" name="name_field_placeholder" value="' . esc_attr($placeholder) . '" style="width: 300px;" />';
7712	}
7713
7714
7715
7716	public function mxchat_intro_message_callback() {
7717	// Load the entire 'mxchat_options' array
7718	$all_options = get_option('mxchat_options', []);
7719	// Retrieve the saved intro message or use the default
7720	$default_message = __('Hello! How can I assist you today?', 'mxchat');
7721	$saved_message = isset($all_options['intro_message']) ? $all_options['intro_message'] : $default_message;
7722	// Output the textarea with the saved value without escaping HTML
7723	?>
7724	<textarea id="intro_message" name="intro_message" rows="5" cols="50"><?php echo $saved_message; ?></textarea>
7725	<p class="description" style="margin-top: 8px;">
7726	<?php esc_html_e('Use {visitor_name} to personalize greetings when lead capture is enabled.', 'mxchat'); ?><br>
7727	<code style="font-size: 12px;"><?php esc_html_e('Example: Hello {visitor_name}! How can I help you today?', 'mxchat'); ?></code>
7728	</p>
7729	<?php
7730	}
7731
7732	public function mxchat_input_copy_callback() {
7733	// Load the entire 'mxchat_options' array
7734	$all_options = get_option('mxchat_options', []);
7735
7736	// Retrieve the saved input copy or use the default value
7737	$default_copy = __('How can I assist?', 'mxchat');
7738	$input_copy = isset($all_options['input_copy']) ? $all_options['input_copy'] : $default_copy;
7739
7740	// Output the input field with the saved value
7741	printf(
7742	'<input type="text" id="input_copy" name="input_copy" value="%s" placeholder="%s" />',
7743	esc_attr($input_copy),
7744	esc_attr__('How can I assist?', 'mxchat')
7745	);
7746	}
7747
7748
7749	public function mxchat_append_to_body_callback() {
7750	// Fetch fresh options to ensure we have the latest saved values
7751	$options = get_option('mxchat_options', array());
7752
7753	// Get value from options array, default to 'off'
7754	$append_to_body = isset($options['append_to_body']) ? $options['append_to_body'] : 'off';
7755	$checked = ($append_to_body === 'on') ? 'checked' : '';
7756
7757	// Get post type visibility settings
7758	$visibility_mode = isset($options['post_type_visibility_mode']) ? $options['post_type_visibility_mode'] : 'all';
7759	$visibility_list = isset($options['post_type_visibility_list']) ? $options['post_type_visibility_list'] : array();
7760	if (!is_array($visibility_list)) {
7761	$visibility_list = array();
7762	}
7763
7764	echo '<div class="mxchat-autosave-section">';
7765
7766	// Main toggle
7767	echo '<label class="toggle-switch">';
7768	echo sprintf(
7769	'<input type="checkbox" id="append_to_body" name="append_to_body" value="on" %s />',
7770	esc_attr($checked)
7771	);
7772	echo '<span class="slider"></span>';
7773	echo '</label>';
7774
7775	// Post Type Visibility Options (only visible when auto-display is ON)
7776	$display_style = ($append_to_body === 'on') ? '' : 'display: none;';
7777	echo '<div id="post-type-visibility-options" class="mxchat-sub-options" style="' . esc_attr($display_style) . '">';
7778
7779	echo '<div class="mxchat-post-type-visibility-header">';
7780	echo '<h4>' . esc_html__('Post Type Visibility', 'mxchat') . '</h4>';
7781	echo '</div>';
7782
7783	// Mode selector (radio buttons)
7784	echo '<div class="mxchat-visibility-mode">';
7785
7786	echo '<label class="mxchat-radio-label">';
7787	echo '<input type="radio" name="post_type_visibility_mode" value="all" ' . checked($visibility_mode, 'all', false) . ' />';
7788	echo '<span>' . esc_html__('Show on all post types', 'mxchat') . '</span>';
7789	echo '</label>';
7790
7791	echo '<label class="mxchat-radio-label">';
7792	echo '<input type="radio" name="post_type_visibility_mode" value="include" ' . checked($visibility_mode, 'include', false) . ' />';
7793	echo '<span>' . esc_html__('Only show on selected post types', 'mxchat') . '</span>';
7794	echo '</label>';
7795
7796	echo '<label class="mxchat-radio-label">';
7797	echo '<input type="radio" name="post_type_visibility_mode" value="exclude" ' . checked($visibility_mode, 'exclude', false) . ' />';
7798	echo '<span>' . esc_html__('Hide on selected post types', 'mxchat') . '</span>';
7799	echo '</label>';
7800
7801	echo '</div>';
7802
7803	// Post type checkboxes (only visible when mode is include or exclude)
7804	$list_display = ($visibility_mode !== 'all') ? '' : 'display: none;';
7805	echo '<div id="post-type-list" class="mxchat-post-type-list" style="' . esc_attr($list_display) . '">';
7806
7807	// Get all public post types
7808	$post_types = get_post_types(array('public' => true), 'objects');
7809
7810	foreach ($post_types as $post_type) {
7811	// Skip attachments
7812	if ($post_type->name === 'attachment') {
7813	continue;
7814	}
7815
7816	$is_checked = in_array($post_type->name, $visibility_list) ? 'checked' : '';
7817
7818	echo '<label class="mxchat-checkbox-label">';
7819	echo '<input type="checkbox" name="post_type_visibility_list[]" value="' . esc_attr($post_type->name) . '" ' . $is_checked . ' />';
7820	echo '<span>' . esc_html($post_type->label) . '</span>';
7821	echo '</label>';
7822	}
7823
7824	echo '</div>'; // End post-type-list
7825	echo '</div>'; // End post-type-visibility-options
7826	echo '</div>'; // End mxchat-autosave-section
7827	}
7828
7829	public function mxchat_contextual_awareness_callback() {
7830	// Get value from options array, default to 'off'
7831	$contextual_awareness = isset($this->options['contextual_awareness_toggle']) ? $this->options['contextual_awareness_toggle'] : 'off';
7832	$checked = ($contextual_awareness === 'on') ? 'checked' : '';
7833	echo '<label class="toggle-switch">';
7834	echo sprintf(
7835	'<input type="checkbox" id="contextual_awareness_toggle" name="contextual_awareness_toggle" value="on" %s />',
7836	esc_attr($checked)
7837	);
7838	echo '<span class="slider"></span>';
7839	echo '</label>';
7840	}
7841
7842	public function mxchat_citation_links_toggle_callback() {
7843	// Get value from options array, default to 'on' (enabled by default)
7844	$citation_links = isset($this->options['citation_links_toggle']) ? $this->options['citation_links_toggle'] : 'on';
7845	$checked = ($citation_links === 'on') ? 'checked' : '';
7846	echo '<label class="toggle-switch">';
7847	echo sprintf(
7848	'<input type="checkbox" id="citation_links_toggle" name="citation_links_toggle" value="on" %s />',
7849	esc_attr($checked)
7850	);
7851	echo '<span class="slider"></span>';
7852	echo '</label>';
7853	}
7854
7855	/**
7856	* Toggle for the end-of-session satisfaction rating prompt (plan-a5b006).
7857	* Default ON. The widget reads this through the localized object; the
7858	* mxchat_satisfaction_rating_enabled filter still lets developers force
7859	* the value site-wide.
7860	*
7861	* The 5 customization fields (idle/question/thanks/placeholder/saved) are
7862	* rendered inline here inside a single wrapper div whose initial display
7863	* is set server-side from the toggle value (plan-29caac). Mirrors the
7864	* auto-display chatbot pattern at mxchat_append_to_body_callback — no
7865	* DOMContentLoaded race because rows exist as direct children of this
7866	* callback's output, and the wrapper's display: none is inline at render
7867	* time so refresh shows the correct state with no flash.
7868	*/
7869	public function mxchat_satisfaction_rating_toggle_callback() {
7870	$options = $this->options;
7871	$value = isset($options['satisfaction_rating_enabled']) ? $options['satisfaction_rating_enabled'] : 'off';
7872	$checked = ($value === 'on') ? 'checked' : '';
7873
7874	$idle = isset($options['satisfaction_rating_idle_seconds']) ? intval($options['satisfaction_rating_idle_seconds']) : 60;
7875	$idle = max(5, min(600, $idle));
7876	$question = isset($options['satisfaction_rating_question']) ? $options['satisfaction_rating_question'] : '';
7877	$thanks = isset($options['satisfaction_rating_thanks']) ? $options['satisfaction_rating_thanks'] : '';
7878	$placeholder = isset($options['satisfaction_rating_placeholder']) ? $options['satisfaction_rating_placeholder'] : '';
7879	$saved = isset($options['satisfaction_rating_saved']) ? $options['satisfaction_rating_saved'] : '';
7880
7881	echo '<div class="mxchat-autosave-section">';
7882
7883	echo '<label class="toggle-switch">';
7884	echo sprintf(
7885	'<input type="checkbox" id="satisfaction_rating_enabled" name="satisfaction_rating_enabled" value="on" %s />',
7886	esc_attr($checked)
7887	);
7888	echo '<span class="slider"></span>';
7889	echo '</label>';
7890
7891	?>
7892	<style>
7893	.mxchat-sub-options-field { margin: 12px 0; }
7894	.mxchat-sub-options-field label { display: inline-block; margin-bottom: 4px; }
7895	#satisfaction-rating-sub-options h4 { margin: 16px 0 8px; }
7896	</style>
7897	<?php
7898
7899	$display_style = ($value === 'on') ? '' : 'display: none;';
7900	echo '<div id="satisfaction-rating-sub-options" class="mxchat-sub-options" style="' . esc_attr($display_style) . '">';
7901
7902	echo '<h4>' . esc_html__('Customize the prompt (optional)', 'mxchat') . '</h4>';
7903
7904	echo '<div class="mxchat-sub-options-field">';
7905	echo '<label for="satisfaction_rating_idle_seconds"><strong>' . esc_html__('Idle Timeout', 'mxchat') . '</strong></label><br />';
7906	printf(
7907	'<input type="number" id="satisfaction_rating_idle_seconds" name="satisfaction_rating_idle_seconds" value="%d" min="5" max="600" step="1" class="small-text" /> <span class="description">%s</span>',
7908	(int) $idle,
7909	esc_html__('seconds of user inactivity before the prompt appears (5-600)', 'mxchat')
7910	);
7911	echo '</div>';
7912
7913	echo '<div class="mxchat-sub-options-field">';
7914	echo '<label for="satisfaction_rating_question"><strong>' . esc_html__('Prompt Question', 'mxchat') . '</strong></label><br />';
7915	printf(
7916	'<input type="text" id="satisfaction_rating_question" name="satisfaction_rating_question" value="%s" maxlength="200" class="regular-text" placeholder="%s" />',
7917	esc_attr($question),
7918	esc_attr__('Was this helpful?', 'mxchat')
7919	);
7920	echo '<p class="description">' . esc_html__('Leave blank for the default. Shown above the thumbs up/down.', 'mxchat') . '</p>';
7921	echo '</div>';
7922
7923	echo '<div class="mxchat-sub-options-field">';
7924	echo '<label for="satisfaction_rating_thanks"><strong>' . esc_html__('Thank-You Message', 'mxchat') . '</strong></label><br />';
7925	printf(
7926	'<input type="text" id="satisfaction_rating_thanks" name="satisfaction_rating_thanks" value="%s" maxlength="300" class="regular-text" placeholder="%s" />',
7927	esc_attr($thanks),
7928	esc_attr__('Thanks! Anything we should improve? (optional)', 'mxchat')
7929	);
7930	echo '<p class="description">' . esc_html__('Leave blank for the default. Shown after the user clicks a thumb.', 'mxchat') . '</p>';
7931	echo '</div>';
7932
7933	echo '<div class="mxchat-sub-options-field">';
7934	echo '<label for="satisfaction_rating_placeholder"><strong>' . esc_html__('Feedback Placeholder', 'mxchat') . '</strong></label><br />';
7935	printf(
7936	'<input type="text" id="satisfaction_rating_placeholder" name="satisfaction_rating_placeholder" value="%s" maxlength="200" class="regular-text" placeholder="%s" />',
7937	esc_attr($placeholder),
7938	esc_attr__('Tell us what could be better…', 'mxchat')
7939	);
7940	echo '<p class="description">' . esc_html__('Leave blank for the default. Placeholder text inside the feedback textarea.', 'mxchat') . '</p>';
7941	echo '</div>';
7942
7943	echo '<div class="mxchat-sub-options-field">';
7944	echo '<label for="satisfaction_rating_saved"><strong>' . esc_html__('Saved Confirmation', 'mxchat') . '</strong></label><br />';
7945	printf(
7946	'<input type="text" id="satisfaction_rating_saved" name="satisfaction_rating_saved" value="%s" maxlength="200" class="regular-text" placeholder="%s" />',
7947	esc_attr($saved),
7948	esc_attr__('Thanks for the feedback.', 'mxchat')
7949	);
7950	echo '<p class="description">' . esc_html__('Leave blank for the default. Shown after the feedback is sent.', 'mxchat') . '</p>';
7951	echo '</div>';
7952
7953	echo '</div>'; // #satisfaction-rating-sub-options
7954	echo '</div>'; // .mxchat-autosave-section
7955
7956	?>
7957	<script>
7958	(function() {
7959	document.addEventListener('DOMContentLoaded', function() {
7960	var toggle = document.getElementById('satisfaction_rating_enabled');
7961	var subOptions = document.getElementById('satisfaction-rating-sub-options');
7962	if (!toggle \|\| !subOptions) return;
7963	toggle.addEventListener('change', function() {
7964	subOptions.style.display = toggle.checked ? '' : 'none';
7965	});
7966	});
7967	})();
7968	</script>
7969	<?php
7970	}
7971
7972	public function mxchat_privacy_toggle_callback() {
7973	// Load from mxchat_options array
7974	$options = get_option('mxchat_options', []);
7975
7976	// Get privacy toggle value with fallback
7977	$privacy_toggle = isset($options['privacy_toggle']) ? $options['privacy_toggle'] : 'off';
7978	$checked = ($privacy_toggle === 'on') ? 'checked' : '';
7979
7980	// Get privacy text with fallback
7981	$privacy_text = isset($options['privacy_text'])
7982	? $options['privacy_text']
7983	: __('By chatting, you agree to our <a href="https://example.com/privacy-policy" target="_blank">privacy policy</a>.', 'mxchat');
7984
7985	// Output the toggle switch
7986	echo '<label class="toggle-switch">';
7987	echo sprintf(
7988	'<input type="checkbox" id="privacy_toggle" name="privacy_toggle" value="on" %s />',
7989	esc_attr($checked)
7990	);
7991	echo '<span class="slider"></span>';
7992	echo '</label>';
7993
7994	// Output the custom text input field
7995	echo sprintf(
7996	'<textarea id="privacy_text" name="privacy_text" rows="5" cols="50" class="regular-text">%s</textarea>',
7997	esc_textarea($privacy_text)
7998	);
7999	}
8000
8001
8002	public function mxchat_complianz_toggle_callback() {
8003	// Load from mxchat_options array
8004	$options = get_option('mxchat_options', []);
8005
8006	// Get complianz toggle value with fallback
8007	$complianz_toggle = isset($options['complianz_toggle']) ? $options['complianz_toggle'] : 'off';
8008	$checked = ($complianz_toggle === 'on') ? 'checked' : '';
8009
8010	// Output the toggle switch
8011	echo '<label class="toggle-switch">';
8012	echo sprintf(
8013	'<input type="checkbox" id="complianz_toggle" name="complianz_toggle" value="on" %s />',
8014	esc_attr($checked)
8015	);
8016	echo '<span class="slider"></span>';
8017	echo '</label>';
8018	}
8019
8020	public function mxchat_link_target_toggle_callback() {
8021	// Load from mxchat_options array
8022	$options = get_option('mxchat_options', []);
8023
8024	// Get link target toggle value with fallback
8025	$link_target_toggle = isset($options['link_target_toggle']) ? $options['link_target_toggle'] : 'off';
8026	$checked = ($link_target_toggle === 'on') ? 'checked' : '';
8027
8028	// Output the toggle switch
8029	echo '<label class="toggle-switch">';
8030	echo sprintf(
8031	'<input type="checkbox" id="link_target_toggle" name="link_target_toggle" value="on" %s />',
8032	esc_attr($checked)
8033	);
8034	echo '<span class="slider"></span>';
8035	echo '</label>';
8036	}
8037
8038	public function mxchat_chat_persistence_toggle_callback() {
8039	// Load from mxchat_options array
8040	$options = get_option('mxchat_options', []);
8041
8042	// Get chat persistence toggle value with fallback
8043	$chat_persistence_toggle = isset($options['chat_persistence_toggle']) ? $options['chat_persistence_toggle'] : 'off';
8044	$checked = ($chat_persistence_toggle === 'on') ? 'checked' : '';
8045
8046	// Output the toggle switch
8047	echo '<label class="toggle-switch">';
8048	echo sprintf(
8049	'<input type="checkbox" id="chat_persistence_toggle" name="chat_persistence_toggle" value="on" %s />',
8050	esc_attr($checked)
8051	);
8052	echo '<span class="slider"></span>';
8053	echo '</label>';
8054	}
8055
8056	public function mxchat_popular_question_1_callback() {
8057	// Load the full plugin options array
8058	$all_options = get_option('mxchat_options', []);
8059
8060	// Retrieve the specific option for popular_question_1
8061	$popular_question_1 = isset($all_options['popular_question_1']) ? $all_options['popular_question_1'] : '';
8062
8063	// Render the input field
8064	printf(
8065	'<input type="text" id="popular_question_1" name="popular_question_1" value="%s" placeholder="%s" class="regular-text" />',
8066	esc_attr($popular_question_1),
8067	esc_attr__('Enter Quick Question 1', 'mxchat')
8068	);
8069	}
8070
8071
8072	public function mxchat_popular_question_2_callback() {
8073	// Load the full plugin options array
8074	$all_options = get_option('mxchat_options', []);
8075
8076	// Retrieve the specific option for popular_question_2
8077	$popular_question_2 = isset($all_options['popular_question_2']) ? $all_options['popular_question_2'] : '';
8078
8079	// Render the input field
8080	printf(
8081	'<input type="text" id="popular_question_2" name="popular_question_2" value="%s" placeholder="%s" class="regular-text" />',
8082	esc_attr($popular_question_2),
8083	esc_attr__('Enter Quick Question 2', 'mxchat')
8084	);
8085	}
8086
8087
8088	public function mxchat_popular_question_3_callback() {
8089	// Load the full plugin options array
8090	$all_options = get_option('mxchat_options', []);
8091
8092	// Retrieve the specific option for popular_question_3
8093	$popular_question_3 = isset($all_options['popular_question_3']) ? $all_options['popular_question_3'] : '';
8094
8095	// Render the input field
8096	printf(
8097	'<input type="text" id="popular_question_3" name="popular_question_3" value="%s" placeholder="%s" class="regular-text" />',
8098	esc_attr($popular_question_3),
8099	esc_attr(__('Enter Quick Question 3', 'mxchat'))
8100	);
8101	}
8102
8103	public function mxchat_additional_popular_questions_callback() {
8104	$options = get_option('mxchat_options', []);
8105	$additional_questions = isset($options['additional_popular_questions'])
8106	? $options['additional_popular_questions']
8107	: get_option('additional_popular_questions', array());
8108
8109	echo '<div id="mxchat-additional-questions-container">';
8110	if (!empty($additional_questions)) {
8111	foreach ($additional_questions as $index => $question) {
8112	printf(
8113	'<div class="mxchat-question-row">
8114	<input type="text" name="additional_popular_questions[]"
8115	value="%s"
8116	placeholder="%s"
8117	class="regular-text mxchat-question-input"
8118	data-question-index="%d" />
8119	<button type="button" class="button mxchat-remove-question"
8120	aria-label="%s">%s</button>
8121	</div>',
8122	esc_attr($question),
8123	esc_attr(sprintf(__('Enter Additional Quick Question %d', 'mxchat'), $index + 4)),
8124	$index,
8125	esc_attr(__('Remove question', 'mxchat')),
8126	esc_html__('Remove', 'mxchat')
8127	);
8128	}
8129	} else {
8130	printf(
8131	'<div class="mxchat-question-row">
8132	<input type="text" name="additional_popular_questions[]"
8133	value=""
8134	placeholder="%s"
8135	class="regular-text mxchat-question-input"
8136	data-question-index="0" />
8137	<button type="button" class="button mxchat-remove-question"
8138	aria-label="%s">%s</button>
8139	</div>',
8140	esc_attr(__('Enter Additional Quick Question 4', 'mxchat')),
8141	esc_attr(__('Remove question', 'mxchat')),
8142	esc_html__('Remove', 'mxchat')
8143	);
8144	}
8145	echo '</div>';
8146	printf(
8147	'<button type="button" class="button mxchat-add-question" aria-label="%s">%s</button>',
8148	esc_attr(__('Add question', 'mxchat')),
8149	esc_html__('Add Question', 'mxchat')
8150	);
8151	}
8152
8153	public function mxchat_brave_api_key_callback() {
8154	$brave_api_key = isset($this->options['brave_api_key']) ? esc_attr($this->options['brave_api_key']) : '';
8155	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8156
8157	echo '<div class="api-key-wrapper">';
8158	echo sprintf(
8159	'<input type="text" id="brave_api_key" name="brave_api_key" value="%s" class="regular-text mxchat-autosave-field mxchat-api-key-field" autocomplete="new-password" data-lpignore="true" data-form-type="other" data-nonce="%s" />',
8160	$brave_api_key,
8161	$nonce
8162	);
8163	echo '<button type="button" id="toggleBraveApiKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
8164	echo '</div>';
8165	echo '<p class="description">' . __('Required for Brave Search integration. Get your API key from Brave Search API.', 'mxchat') . '</p>';
8166	}
8167
8168	public function mxchat_brave_image_count_callback() {
8169	$brave_image_count = isset($this->options['brave_image_count'])
8170	? intval($this->options['brave_image_count'])
8171	: 4;
8172	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8173
8174	echo '<div class="mxchat-field-wrapper">';
8175	echo sprintf(
8176	'<input type="number" id="brave_image_count" name="brave_image_count"
8177	value="%d" min="1" max="6" class="small-text mxchat-autosave-field" data-nonce="%s" />',
8178	$brave_image_count,
8179	$nonce
8180	);
8181	echo '</div>';
8182	echo '<p class="description">' . __('Select the number of images to return (1-6).', 'mxchat') . '</p>';
8183	}
8184
8185	public function mxchat_brave_safe_search_callback() {
8186	$brave_safe_search = isset($this->options['brave_safe_search'])
8187	? esc_attr($this->options['brave_safe_search'])
8188	: 'strict';
8189	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8190
8191	echo '<div class="mxchat-field-wrapper">';
8192	echo '<select id="brave_safe_search" name="brave_safe_search" class="mxchat-autosave-field" data-nonce="' . $nonce . '">';
8193	echo sprintf(
8194	'<option value="strict" %s>%s</option>',
8195	selected($brave_safe_search, 'strict', false),
8196	__('Strict', 'mxchat')
8197	);
8198	echo sprintf(
8199	'<option value="off" %s>%s</option>',
8200	selected($brave_safe_search, 'off', false),
8201	__('Off', 'mxchat')
8202	);
8203	echo '</select>';
8204	echo '</div>';
8205	echo '<p class="description">' .
8206	esc_html__('Set the Safe Search level for image searches. Brave Search only supports "Strict" and "Off" options.', 'mxchat') .
8207	'</p>';
8208	}
8209
8210	public function mxchat_brave_news_count_callback() {
8211	$brave_news_count = isset($this->options['brave_news_count'])
8212	? intval($this->options['brave_news_count'])
8213	: 3;
8214	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8215
8216	echo '<div class="mxchat-field-wrapper">';
8217	echo sprintf(
8218	'<input type="number" id="brave_news_count" name="brave_news_count"
8219	value="%d" min="1" max="10" class="small-text mxchat-autosave-field" data-nonce="%s" />',
8220	$brave_news_count,
8221	$nonce
8222	);
8223	echo '</div>';
8224	echo '<p class="description">' . esc_html__('Select the number of news articles to retrieve (1-10).', 'mxchat') . '</p>';
8225	}
8226
8227	public function mxchat_brave_country_callback() {
8228	$brave_country = isset($this->options['brave_country'])
8229	? esc_attr($this->options['brave_country'])
8230	: 'us';
8231	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8232
8233	echo '<div class="mxchat-field-wrapper">';
8234	echo sprintf(
8235	'<input type="text" id="brave_country" name="brave_country"
8236	value="%s" maxlength="2" class="small-text mxchat-autosave-field" data-nonce="%s" />',
8237	$brave_country,
8238	$nonce
8239	);
8240	echo '</div>';
8241	echo '<p class="description">' . esc_html__('Enter the country code (e.g., "us" for United States).', 'mxchat') . '</p>';
8242	}
8243
8244	public function mxchat_brave_language_callback() {
8245	$brave_language = isset($this->options['brave_language'])
8246	? esc_attr($this->options['brave_language'])
8247	: 'en';
8248	$nonce = wp_create_nonce('mxchat_autosave_nonce');
8249
8250	echo '<div class="mxchat-field-wrapper">';
8251	echo sprintf(
8252	'<input type="text" id="brave_language" name="brave_language"
8253	value="%s" maxlength="2" class="small-text mxchat-autosave-field" data-nonce="%s" />',
8254	$brave_language,
8255	$nonce
8256	);
8257	echo '</div>';
8258	echo '<p class="description">' . esc_html__('Enter the language code (e.g., "en" for English).', 'mxchat') . '</p>';
8259	}
8260
8261
8262
8263
8264
8265	// Section Callback
8266	public function mxchat_pdf_intent_section_callback() {
8267	echo '<p>' . esc_html__('Configure the intent settings for the Chat with PDF feature.', 'mxchat') . '</p>';
8268	}
8269
8270	public function mxchat_chat_toolbar_toggle_callback() {
8271	// Get chat toolbar toggle value with fallback
8272	$chat_toolbar_toggle = isset($this->options['chat_toolbar_toggle']) ? $this->options['chat_toolbar_toggle'] : 'off';
8273	$checked = ($chat_toolbar_toggle === 'on') ? 'checked' : '';
8274
8275	// Output the toggle switch
8276	echo '<label class="toggle-switch">';
8277	echo sprintf(
8278	'<input type="checkbox" id="chat_toolbar_toggle" name="chat_toolbar_toggle" value="on" %s />',
8279	esc_attr($checked)
8280	);
8281	echo '<span class="slider"></span>';
8282	echo '</label>';
8283
8284	echo '<p class="description">' . esc_html__('Enable to display the chat toolbar, adding two icons below the chatbot input field for uploading PDF and Word documents (default is hidden).', 'mxchat') . '</p>';
8285	}
8286
8287	/**
8288	* Callback for PDF upload button toggle setting
8289	*/
8290	public function mxchat_show_pdf_upload_button_callback() {
8291	// Get toggle value with fallback
8292	$show_pdf_button = isset($this->options['show_pdf_upload_button']) ? $this->options['show_pdf_upload_button'] : 'on';
8293	$checked = ($show_pdf_button === 'on') ? 'checked' : '';
8294
8295	// Output the toggle switch
8296	echo '<label class="toggle-switch">';
8297	echo sprintf(
8298	'<input type="checkbox" id="show_pdf_upload_button" name="show_pdf_upload_button" value="on" %s />',
8299	esc_attr($checked)
8300	);
8301	echo '<span class="slider"></span>';
8302	echo '</label>';
8303
8304	echo '<p class="description">' . esc_html__('Enable to show the PDF upload button in the chatbot toolbar. Disable to hide it.', 'mxchat') . '</p>';
8305	}
8306
8307	/**
8308	* Callback for Word upload button toggle setting
8309	*/
8310	public function mxchat_show_word_upload_button_callback() {
8311	// Get toggle value with fallback
8312	$show_word_button = isset($this->options['show_word_upload_button']) ? $this->options['show_word_upload_button'] : 'on';
8313	$checked = ($show_word_button === 'on') ? 'checked' : '';
8314
8315	// Output the toggle switch
8316	echo '<label class="toggle-switch">';
8317	echo sprintf(
8318	'<input type="checkbox" id="show_word_upload_button" name="show_word_upload_button" value="on" %s />',
8319	esc_attr($checked)
8320	);
8321	echo '<span class="slider"></span>';
8322	echo '</label>';
8323
8324	echo '<p class="description">' . esc_html__('Enable to show the Word document upload button in the chatbot toolbar. Disable to hide it.', 'mxchat') . '</p>';
8325	}
8326
8327	public function mxchat_pdf_intent_trigger_text_callback() {
8328	$default_text = __("Please provide the URL to the PDF you'd like to discuss.", 'mxchat');
8329
8330	echo sprintf(
8331	'<textarea id="pdf_intent_trigger_text"
8332	name="pdf_intent_trigger_text"
8333	rows="3"
8334	cols="50"
8335	placeholder="%s">%s</textarea>',
8336	esc_attr__('Enter trigger text', 'mxchat'),
8337	isset($this->options['pdf_intent_trigger_text'])
8338	? esc_textarea($this->options['pdf_intent_trigger_text'])
8339	: esc_textarea($default_text)
8340	);
8341	echo '<p class="description">' . esc_html__('Text displayed when the intent is triggered.', 'mxchat') . '</p>';
8342	}
8343
8344	public function mxchat_pdf_intent_success_text_callback() {
8345	$default_text = __("I've processed the PDF. What questions do you have about it?", 'mxchat');
8346
8347	echo sprintf(
8348	'<textarea id="pdf_intent_success_text"
8349	name="pdf_intent_success_text"
8350	rows="3"
8351	cols="50"
8352	placeholder="%s">%s</textarea>',
8353	esc_attr__('Enter success text', 'mxchat'),
8354	isset($this->options['pdf_intent_success_text'])
8355	? esc_textarea($this->options['pdf_intent_success_text'])
8356	: esc_textarea($default_text)
8357	);
8358	echo '<p class="description">' . esc_html__('Text displayed when the intent is successful.', 'mxchat') . '</p>';
8359	}
8360
8361	public function mxchat_pdf_intent_error_text_callback() {
8362	$default_text = __("Sorry, I couldn't process the PDF. Please ensure it's a valid file.", 'mxchat');
8363
8364	echo sprintf(
8365	'<textarea id="pdf_intent_error_text"
8366	name="pdf_intent_error_text"
8367	rows="3"
8368	cols="50"
8369	placeholder="%s">%s</textarea>',
8370	esc_attr__('Enter error text', 'mxchat'),
8371	isset($this->options['pdf_intent_error_text'])
8372	? esc_textarea($this->options['pdf_intent_error_text'])
8373	: esc_textarea($default_text)
8374	);
8375	echo '<p class="description">' . esc_html__('Text displayed when an error occurs during the intent.', 'mxchat') . '</p>';
8376	}
8377
8378	public function mxchat_pdf_max_pages_callback() {
8379	$max_pages = isset($this->options['pdf_max_pages']) ? intval($this->options['pdf_max_pages']) : 69;
8380
8381	echo sprintf(
8382	'<input type="range"
8383	id="pdf_max_pages"
8384	name="pdf_max_pages"
8385	min="1"
8386	max="69"
8387	value="%d"
8388	class="range-slider" />',
8389	esc_attr($max_pages)
8390	);
8391	echo '<span id="pdf_max_pages_output">' . esc_html($max_pages) . '</span>';
8392	echo '<p class="description">' . esc_html__('Set the maximum number of document pages users can upload for processing. (1-69 pages)', 'mxchat') . '</p>';
8393	}
8394
8395	public function mxchat_live_agent_status_callback() {
8396	// Always get fresh options instead of using cached $this->options
8397	$fresh_options = get_option('mxchat_options');
8398	$status = isset($fresh_options['live_agent_status']) ? $fresh_options['live_agent_status'] : 'off';
8399
8400	echo '<label class="toggle-switch">';
8401	echo sprintf(
8402	'<input type="checkbox" id="live_agent_status" name="live_agent_status" value="on" %s />',
8403	checked($status, 'on', false)
8404	);
8405	echo '<span class="slider"></span>';
8406	echo '</label>';
8407	echo '<label for="live_agent_status" class="mxchat-status-label">';
8408	echo '<span class="status-text">' . ($status === 'on' ? esc_html__('Online', 'mxchat') : esc_html__('Offline', 'mxchat')) . '</span>';
8409	echo '</label>';
8410	}
8411
8412	public function mxchat_live_agent_away_message_callback() {
8413	$message = isset($this->options['live_agent_away_message'])
8414	? $this->options['live_agent_away_message']
8415	: __('Sorry, live agents are currently unavailable. I can continue helping you as an AI assistant.', 'mxchat');
8416
8417	printf(
8418	'<textarea id="live_agent_away_message" name="live_agent_away_message" rows="3" cols="50">%s</textarea>',
8419	esc_textarea($message)
8420	);
8421	echo '<p class="description">' . esc_html__('Message shown when live agents are offline.', 'mxchat') . '</p>';
8422	}
8423
8424	public function mxchat_live_agent_notification_message_callback() {
8425	$message = isset($this->options['live_agent_notification_message'])
8426	? $this->options['live_agent_notification_message']
8427	: __('Live agent has been notified.', 'mxchat');
8428
8429	printf(
8430	'<textarea id="live_agent_notification_message" name="live_agent_notification_message" rows="3" cols="50">%s</textarea>',
8431	esc_textarea($message)
8432	);
8433	echo '<p class="description">' . esc_html__('Message shown when live transfer activated.', 'mxchat') . '</p>';
8434	}
8435
8436	public function mxchat_live_agent_webhook_url_callback() {
8437	$webhook_url = isset($this->options['live_agent_webhook_url'])
8438	? esc_url($this->options['live_agent_webhook_url'])
8439	: esc_url(get_option('live_agent_webhook_url', ''));
8440
8441	printf(
8442	'<input type="password" id="live_agent_webhook_url" name="live_agent_webhook_url" value="%s" class="regular-text" />',
8443	$webhook_url
8444	);
8445	echo '<button type="button" id="toggleWebhookUrlVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
8446	echo '<p class="description">' . esc_html__('Enter your Slack webhook URL for live agent notifications.', 'mxchat') . '</p>';
8447	}
8448
8449	public function mxchat_live_agent_secret_key_callback() {
8450	printf(
8451	'<input type="password" id="live_agent_secret_key" name="live_agent_secret_key" value="%s" class="regular-text" />',
8452	isset($this->options['live_agent_secret_key']) ? esc_attr($this->options['live_agent_secret_key']) : ''
8453	);
8454	echo '<button type="button" id="toggleSecretKeyVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
8455	echo '<p class="description">' . esc_html__('Secret key for validating Slack requests. Keep this secure.', 'mxchat') . '</p>';
8456	}
8457
8458	public function mxchat_live_agent_bot_token_callback() {
8459	printf(
8460	'<input type="password" id="live_agent_bot_token" name="live_agent_bot_token" value="%s" class="regular-text" />',
8461	isset($this->options['live_agent_bot_token']) ? esc_attr($this->options['live_agent_bot_token']) : ''
8462	);
8463	echo '<button type="button" id="toggleBotTokenVisibility">' . esc_html__('Show', 'mxchat') . '</button>';
8464	echo '<p class="description">' . esc_html__('Your Slack Bot OAuth Token (starts with xoxb-). Keep this secure.', 'mxchat') . '</p>';
8465	}
8466
8467	public function mxchat_live_agent_user_ids_callback() {
8468	$user_ids = isset($this->options['live_agent_user_ids'])
8469	? esc_textarea($this->options['live_agent_user_ids'])
8470	: '';
8471
8472	printf(
8473	'<textarea id="live_agent_user_ids" name="live_agent_user_ids" rows="4" class="large-text">%s</textarea>',
8474	$user_ids
8475	);
8476	echo '<p class="description">' . esc_html__('Enter Slack User IDs of agents who should be automatically invited to chat channels (one per line). Find user IDs in Slack profiles under "More" → "Copy member ID". Example: U1234567890', 'mxchat') . '</p>';
8477	}
8478
8479	/**
8480	* Telegram Integration Callbacks
8481	*/
8482	public function mxchat_telegram_section_callback() {
8483	echo '<p>' . esc_html__('Configure Telegram integration for live agent support.', 'mxchat') . '</p>';
8484	}
8485
8486	public function mxchat_telegram_status_callback() {
8487	$fresh_options = get_option('mxchat_options');
8488	$status = isset($fresh_options['telegram_status']) ? $fresh_options['telegram_status'] : 'off';
8489
8490	echo '<label class="toggle-switch">';
8491	echo sprintf(
8492	'<input type="checkbox" id="telegram_status" name="telegram_status" value="on" %s />',
8493	checked($status, 'on', false)
8494	);
8495	echo '<span class="slider"></span>';
8496	echo '</label>';
8497	echo '<label for="telegram_status" class="mxchat-status-label">';
8498	echo '<span class="status-text">' . ($status === 'on' ? esc_html__('Online', 'mxchat') : esc_html__('Offline', 'mxchat')) . '</span>';
8499	echo '</label>';
8500	}
8501
8502	public function mxchat_telegram_notification_message_callback() {
8503	$message = isset($this->options['telegram_notification_message'])
8504	? $this->options['telegram_notification_message']
8505	: __("I've notified a support agent. Please allow a moment for them to respond.", 'mxchat');
8506
8507	printf(
8508	'<textarea id="telegram_notification_message" name="telegram_notification_message" rows="3" cols="50">%s</textarea>',
8509	esc_textarea($message)
8510	);
8511	echo '<p class="description">' . esc_html__('Message shown when live transfer activated.', 'mxchat') . '</p>';
8512	}
8513
8514	public function mxchat_telegram_away_message_callback() {
8515	$message = isset($this->options['telegram_away_message'])
8516	? $this->options['telegram_away_message']
8517	: __('Sorry, live agents are currently unavailable. I can continue helping you as an AI assistant.', 'mxchat');
8518
8519	printf(
8520	'<textarea id="telegram_away_message" name="telegram_away_message" rows="3" cols="50">%s</textarea>',
8521	esc_textarea($message)
8522	);
8523	echo '<p class="description">' . esc_html__('Message shown when live agents are offline.', 'mxchat') . '</p>';
8524	}
8525
8526	public function mxchat_telegram_bot_token_callback() {
8527	printf(
8528	'<input type="password" id="telegram_bot_token" name="telegram_bot_token" value="%s" class="regular-text" />',
8529	isset($this->options['telegram_bot_token']) ? esc_attr($this->options['telegram_bot_token']) : ''
8530	);
8531	echo '<button type="button" class="button button-secondary" onclick="var f=document.getElementById(\'telegram_bot_token\'); if(f.type===\'password\'){f.type=\'text\';this.textContent=\'' . esc_js(__('Hide', 'mxchat')) . '\';}else{f.type=\'password\';this.textContent=\'' . esc_js(__('Show', 'mxchat')) . '\';}">' . esc_html__('Show', 'mxchat') . '</button>';
8532	echo '<p class="description">' . esc_html__('Your Telegram Bot Token from @BotFather (e.g., 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).', 'mxchat') . '</p>';
8533	}
8534
8535	public function mxchat_telegram_group_id_callback() {
8536	printf(
8537	'<input type="text" id="telegram_group_id" name="telegram_group_id" value="%s" class="regular-text" />',
8538	isset($this->options['telegram_group_id']) ? esc_attr($this->options['telegram_group_id']) : ''
8539	);
8540	echo '<p class="description">' . esc_html__('Your Telegram supergroup ID (starts with -100). The group must have forum topics enabled.', 'mxchat') . '</p>';
8541	}
8542
8543	public function mxchat_telegram_webhook_secret_callback() {
8544	$secret = isset($this->options['telegram_webhook_secret']) ? $this->options['telegram_webhook_secret'] : '';
8545
8546	// Auto-generate secret if empty
8547	if (empty($secret)) {
8548	$secret = wp_generate_password(64, false, false);
8549	$options = get_option('mxchat_options', []);
8550	$options['telegram_webhook_secret'] = $secret;
8551	update_option('mxchat_options', $options);
8552	$this->options['telegram_webhook_secret'] = $secret;
8553	}
8554
8555	printf(
8556	'<input type="password" id="telegram_webhook_secret" name="telegram_webhook_secret" value="%s" class="regular-text" />',
8557	esc_attr($secret)
8558	);
8559	echo '<button type="button" class="button button-secondary" onclick="var f=document.getElementById(\'telegram_webhook_secret\'); if(f.type===\'password\'){f.type=\'text\';this.textContent=\'' . esc_js(__('Hide', 'mxchat')) . '\';}else{f.type=\'password\';this.textContent=\'' . esc_js(__('Show', 'mxchat')) . '\';}">' . esc_html__('Show', 'mxchat') . '</button>';
8560	echo '<p class="description">' . esc_html__('Secret token for webhook verification. Use this when setting up your Telegram webhook with the secret_token parameter.', 'mxchat') . '</p>';
8561	}
8562
8563	public function mxchat_similarity_threshold_callback() {
8564	// Load from mxchat_options array
8565	$options = get_option('mxchat_options', []);
8566
8567	// Get value from options array with default of 35
8568	$threshold = isset($options['similarity_threshold']) ? $options['similarity_threshold'] : 35;
8569
8570	echo '<div class="slider-container">';
8571	echo sprintf(
8572	'<input type="range"
8573	id="similarity_threshold"
8574	name="similarity_threshold"
8575	min="20"
8576	max="85"
8577	step="1"
8578	value="%s"
8579	class="range-slider" />',
8580	esc_attr($threshold)
8581	);
8582	echo sprintf(
8583	'<span id="threshold_value" class="range-value">%s</span>',
8584	esc_html($threshold)
8585	);
8586	echo '</div>';
8587	}
8588
8589	public function mxchat_rag_sources_limit_callback() {
8590	// Load from mxchat_options array
8591	$options = get_option('mxchat_options', []);
8592
8593	// Get value from options array with default of 3
8594	$rag_sources_limit = isset($options['rag_sources_limit']) ? intval($options['rag_sources_limit']) : 3;
8595
8596	echo '<div class="slider-container">';
8597	echo sprintf(
8598	'<input type="range"
8599	id="rag_sources_limit"
8600	name="rag_sources_limit"
8601	min="3"
8602	max="10"
8603	step="1"
8604	value="%s"
8605	class="range-slider" />',
8606	esc_attr($rag_sources_limit)
8607	);
8608	echo sprintf(
8609	'<span id="rag_sources_limit_value" class="range-value">%s</span>',
8610	esc_html($rag_sources_limit)
8611	);
8612	echo '</div>';
8613	}
8614
8615	public function mxchat_rag_chunks_limit_callback() {
8616	// Load from mxchat_options array
8617	$options = get_option('mxchat_options', []);
8618
8619	// Get value from options array with default of 15
8620	$rag_chunks_limit = isset($options['rag_chunks_limit']) ? intval($options['rag_chunks_limit']) : 15;
8621
8622	echo '<div class="slider-container">';
8623	echo sprintf(
8624	'<input type="range"
8625	id="rag_chunks_limit"
8626	name="rag_chunks_limit"
8627	min="8"
8628	max="20"
8629	step="1"
8630	value="%s"
8631	class="range-slider" />',
8632	esc_attr($rag_chunks_limit)
8633	);
8634	echo sprintf(
8635	'<span id="rag_chunks_limit_value" class="range-value">%s</span>',
8636	esc_html($rag_chunks_limit)
8637	);
8638	echo '</div>';
8639	}
8640
8641	/**
8642	* Add body class on the Onboarding wizard page so CSS-only chrome surgery
8643	* (collapsing the WP admin sidebar) only applies on this page.
8644	* Plan: plan-mxchat-20260527-905439.
8645	*/
8646	public function mxchat_add_onboarding_body_class($classes) {
8647	if (isset($_GET['page']) && $_GET['page'] === 'mxchat-onboarding') {
8648	$classes .= ' mxchat-onboarding-focused';
8649	}
8650	return $classes;
8651	}
8652
8653	public function mxchat_enqueue_admin_assets() {
8654	// Get plugin version
8655	$version = MXCHAT_VERSION;
8656
8657	// Use file modification time for development (remove in production)
8658	if (defined('WP_DEBUG') && WP_DEBUG) {
8659	$version = filemtime(plugin_dir_path(__FILE__) . '../mxchat-basic.php');
8660	}
8661
8662	$current_page = isset($_GET['page']) ? $_GET['page'] : '';
8663	$plugin_url = plugin_dir_url(__FILE__) . '../';
8664
8665	// Only load on MxChat pages
8666	if (strpos($current_page, 'mxchat') === false) {
8667	return;
8668	}
8669
8670	// Always load these on all MxChat pages
8671	$this->enqueue_core_admin_assets($plugin_url, $version);
8672	$this->enqueue_page_specific_assets($current_page, $plugin_url, $version);
8673	$this->localize_admin_scripts($current_page);
8674	}
8675	private function enqueue_core_admin_assets($plugin_url, $version) {
8676	// Core admin styles
8677	wp_enqueue_style('mxchat-admin-css', $plugin_url . 'css/admin-style.css', array(), $version);
8678	wp_enqueue_style('mxchat-knowledge-css', $plugin_url . 'css/knowledge-style.css', array(), $version);
8679
8680	// New sidebar navigation styles (for main settings page)
8681	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8682
8683	// Core admin scripts
8684	wp_enqueue_script('mxchat-admin-js', $plugin_url . 'js/mxchat-admin.js', array('jquery'), $version, true);
8685	}
8686	private function enqueue_page_specific_assets($current_page, $plugin_url, $version) {
8687	switch ($current_page) {
8688	case 'mxchat-prompts':
8689	// Knowledge processing page assets
8690	wp_enqueue_style('mxchat-content-selector-css', $plugin_url . 'css/content-selector.css', array(), $version);
8691	wp_enqueue_script('mxchat-content-selector-js', $plugin_url . 'js/content-selector.js', array('jquery'), $version, true);
8692	// Add the knowledge processing script (common script needed for WordPress dismiss functionality)
8693	wp_enqueue_script('mxchat-knowledge-processing', $plugin_url . 'js/knowledge-processing.js', array('jquery', 'common'), $version, true);
8694	break;
8695
8696	case 'mxchat-transcripts':
8697	// Load admin sidebar CSS first (shared styles for sidebar navigation)
8698	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8699	// Load transcripts-specific styles
8700	wp_enqueue_style('mxchat-chat-transcripts-css', $plugin_url . 'css/chat-transcripts.css', array('mxchat-admin-sidebar-css'), $version);
8701	wp_enqueue_script('mxchat-transcripts-js', $plugin_url . 'js/mxchat_transcripts.js', array('jquery'), $version, true);
8702	break;
8703
8704	case 'mxchat-actions':
8705	// Load admin sidebar CSS first (shared styles for sidebar navigation)
8706	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8707	// Load actions-specific styles
8708	wp_enqueue_style('mxchat-actions-css', $plugin_url . 'css/actions.css', array('mxchat-admin-sidebar-css'), $version);
8709	wp_enqueue_script('mxchat-actions-js', $plugin_url . 'js/mxchat_actions.js', array('jquery'), $version, true);
8710
8711	// Localize script data for actions page
8712	$is_activated = get_option('mxchat_pro_license_status') === 'active';
8713	wp_localize_script('mxchat-actions-js', 'mxchActionsData', array(
8714	'ajaxUrl' => admin_url('admin-ajax.php'),
8715	'nonce' => wp_create_nonce('mxchat_actions_nonce'),
8716	'addNonce' => wp_create_nonce('mxchat_add_intent_nonce'),
8717	'editNonce' => wp_create_nonce('mxchat_edit_intent'),
8718	'deleteNonce' => wp_create_nonce('mxchat_delete_intent_nonce'),
8719	'toggleNonce' => wp_create_nonce('mxchat_actions_nonce'),
8720	'addPhraseNonce' => wp_create_nonce('mxchat_add_phrase_nonce'),
8721	'deletePhraseNonce' => wp_create_nonce('mxchat_delete_phrase_nonce'),
8722	'getPhrasesNonce' => wp_create_nonce('mxchat_get_phrases_nonce'),
8723	'deleteLegacyNonce' => wp_create_nonce('mxchat_delete_legacy_nonce'),
8724	'isActivated' => $is_activated,
8725	'i18n' => array(
8726	'confirmDelete' => __('Are you sure you want to delete this action?', 'mxchat'),
8727	'confirmBulkDelete' => __('Are you sure you want to delete the selected actions?', 'mxchat'),
8728	'saving' => __('Saving...', 'mxchat'),
8729	'saved' => __('Saved successfully!', 'mxchat'),
8730	'error' => __('An error occurred. Please try again.', 'mxchat'),
8731	'proRequired' => __('This feature requires MxChat Pro.', 'mxchat'),
8732	'addonRequired' => __('This feature requires an add-on.', 'mxchat')
8733	)
8734	));
8735	break;
8736
8737	case 'mxchat-activation':
8738	// Load admin sidebar CSS first (shared styles for sidebar navigation)
8739	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8740	// Load pro page-specific styles
8741	wp_enqueue_style('mxchat-pro-css', $plugin_url . 'css/admin-pro.css', array('mxchat-admin-sidebar-css'), $version);
8742	// Load pro page JavaScript
8743	wp_enqueue_script('mxchat-pro-js', $plugin_url . 'js/mxchat_pro.js', array('jquery'), $version, true);
8744	// Load activation script for license activation/deactivation
8745	wp_enqueue_script('mxchat-activation-js', $plugin_url . 'js/activation-script.js', array('jquery'), $version, true);
8746	break;
8747
8748	case 'mxchat-content':
8749	// Load admin sidebar CSS (shared styles for sidebar navigation)
8750	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8751	// Load content page-specific styles
8752	wp_enqueue_style('mxchat-content-css', $plugin_url . 'css/admin-content.css', array('mxchat-admin-sidebar-css'), $version);
8753	// Load content page JavaScript
8754	wp_enqueue_script('mxchat-content-js', $plugin_url . 'js/mxchat-content.js', array('jquery'), $version, true);
8755	break;
8756
8757	case 'mxchat-api-access':
8758	// Shared sidebar shell (CSS + JS for tab switching / mobile menu / copy buttons).
8759	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8760	wp_enqueue_script('mxchat-admin-sidebar-js', $plugin_url . 'js/admin-sidebar.js', array(), $version, true);
8761	wp_localize_script('mxchat-admin-sidebar-js', 'MxChatAdminSidebarI18n', array(
8762	'copied' => __('Copied', 'mxchat'),
8763	));
8764	break;
8765
8766	case 'mxchat-max':
8767	case 'mxchat-onboarding':
8768	// Onboarding page — uses the shared admin shell PLUS the wizard
8769	// overlay (plan-905439). admin-onboarding-wizard.css scopes the
8770	// WP-chrome surgery to body.mxchat-onboarding-focused so it only
8771	// applies on THIS page. The body class is added below via the
8772	// admin_body_class filter.
8773	wp_enqueue_style('mxchat-admin-sidebar-css', $plugin_url . 'css/admin-sidebar.css', array(), $version);
8774	wp_enqueue_script('mxchat-admin-sidebar-js', $plugin_url . 'js/admin-sidebar.js', array(), $version, true);
8775	wp_localize_script('mxchat-admin-sidebar-js', 'MxChatAdminSidebarI18n', array(
8776	'copied' => __('Copied', 'mxchat'),
8777	));
8778	// admin-style.css provides the .mxchat-instructions-modal-* classes
8779	// the new Behavior step's "View Sample Instructions" modal needs.
8780	// Enqueued AFTER admin-sidebar.css but BEFORE the wizard overlay
8781	// so the wizard's own rules win where they collide. plan-a2e4d6.
8782	wp_enqueue_style('mxchat-admin-style-css', $plugin_url . 'css/admin-style.css', array('mxchat-admin-sidebar-css'), $version);
8783	wp_enqueue_style('mxchat-admin-onboarding-wizard-css', $plugin_url . 'css/admin-onboarding-wizard.css', array('mxchat-admin-sidebar-css', 'mxchat-admin-style-css'), $version);
8784	wp_enqueue_script('mxchat-admin-onboarding-wizard-js', $plugin_url . 'js/admin-onboarding-wizard.js', array(), $version, true);
8785	break;
8786	default:
8787	wp_enqueue_script(
8788	'mxchat-test-streaming-js',
8789	$plugin_url . 'js/mxchat-test-streaming.js',
8790	['jquery'],
8791	$version,
8792	true
8793	);
8794
8795	wp_localize_script('mxchat-test-streaming-js', 'mxchatTestStreamingAjax', [
8796	'ajax_url' => admin_url('admin-ajax.php'),
8797	'nonce' => wp_create_nonce('mxchat_test_streaming_nonce'),
8798	'settings_nonce' => wp_create_nonce('mxchat_save_setting_nonce')
8799	]);
8800
8801	// Testing Tab: Load chatbot assets for the embedded testing chatbot
8802	wp_enqueue_style('mxchat-chat-css', $plugin_url . 'css/chat-style.css', array(), $version);
8803	wp_enqueue_style('mxchat-admin-testing-css', $plugin_url . 'css/admin-testing-tab.css', array('mxchat-admin-sidebar-css', 'mxchat-chat-css'), $version);
8804
8805	wp_enqueue_script('mxchat-chat-js', $plugin_url . 'js/chat-script.js', array('jquery'), $version, true);
8806	wp_enqueue_script('mxchat-admin-testing-js', $plugin_url . 'js/admin-testing-tab.js', array('jquery', 'mxchat-chat-js'), $version, true);
8807
8808	// Allow add-ons to enqueue their public CSS/JS for the testing chatbot
8809	do_action('mxchat_enqueue_testing_tab_assets');
8810
8811	// Localize mxchatChat for the chatbot JS (same settings as frontend)
8812	$options = get_option('mxchat_options', array());
8813	$prompts_options = get_option('mxchat_prompts_options', array());
8814	$theme_options = get_option('mxchat_theme_options', array());
8815	$ai_theme_active = !empty($theme_options['active_ai_theme_css']);
8816	$has_bot_theme_assignments = !empty($theme_options['bot_theme_assignments']);
8817	$skip_inline_colors = $ai_theme_active \|\| $has_bot_theme_assignments;
8818
8819	wp_localize_script('mxchat-chat-js', 'mxchatChat', array(
8820	'ajax_url' => admin_url('admin-ajax.php'),
8821	'nonce' => wp_create_nonce('mxchat_chat_nonce'),
8822	'model' => isset($options['model']) ? $options['model'] : 'gpt-5.1-chat-latest',
8823	'enable_streaming_toggle' => isset($options['enable_streaming_toggle']) ? $options['enable_streaming_toggle'] : 'on',
8824	'contextual_awareness_toggle' => isset($options['contextual_awareness_toggle']) ? $options['contextual_awareness_toggle'] : 'off',
8825	'link_target_toggle' => $options['link_target_toggle'] ?? 'off',
8826	'rate_limit_message' => $options['rate_limit_message'] ?? 'Rate limit exceeded. Please try again later.',
8827	'complianz_toggle' => isset($options['complianz_toggle']) && $options['complianz_toggle'] === 'on',
8828	'user_message_bg_color' => $options['user_message_bg_color'] ?? '#fff',
8829	'user_message_font_color' => $options['user_message_font_color'] ?? '#212121',
8830	'bot_message_bg_color' => $options['bot_message_bg_color'] ?? '#212121',
8831	'bot_message_font_color' => $options['bot_message_font_color'] ?? '#fff',
8832	'top_bar_bg_color' => $options['top_bar_bg_color'] ?? '#212121',
8833	'send_button_font_color' => $options['send_button_font_color'] ?? '#212121',
8834	'close_button_color' => $options['close_button_color'] ?? '#fff',
8835	'chatbot_background_color' => $options['chatbot_background_color'] ?? '#212121',
8836	'chatbot_bg_color' => $options['chatbot_bg_color'] ?? '#fff',
8837	'icon_color' => $options['icon_color'] ?? '#fff',
8838	'chat_input_font_color' => $options['chat_input_font_color'] ?? '#212121',
8839	'chat_persistence_toggle' => 'off', // Always off for testing chatbot
8840	'appendWidgetToBody' => 'off',
8841	'live_agent_message_bg_color' => $options['live_agent_message_bg_color'] ?? '#ffffff',
8842	'live_agent_message_font_color' => $options['live_agent_message_font_color'] ?? '#333333',
8843	'chat_toolbar_toggle' => $options['chat_toolbar_toggle'] ?? 'off',
8844	'mode_indicator_bg_color' => $options['mode_indicator_bg_color'] ?? '#767676',
8845	'mode_indicator_font_color' => $options['mode_indicator_font_color'] ?? '#ffffff',
8846	'toolbar_icon_color' => $options['toolbar_icon_color'] ?? '#212121',
8847	'use_pinecone' => $prompts_options['mxchat_use_pinecone'] ?? '0',
8848	'email_collection_enabled' => 'off', // No email collection in testing
8849	'initial_email_state' => null,
8850	'skip_email_check' => true,
8851	'pinecone_enabled' => isset($prompts_options['mxchat_use_pinecone']) && $prompts_options['mxchat_use_pinecone'] === '1',
8852	'skip_inline_colors' => $skip_inline_colors,
8853	'bot_theme_assignments' => $theme_options['bot_theme_assignments'] ?? array()
8854	));
8855
8856	// Localize testing tab script data
8857	wp_localize_script('mxchat-admin-testing-js', 'mxchatAdminTestData', array(
8858	'ajaxUrl' => admin_url('admin-ajax.php'),
8859	'nonce' => wp_create_nonce('mxchat_test_nonce'),
8860	'isAdmin' => true,
8861	'testingEnabled' => true
8862	));
8863
8864	// Add testing enabled flag for the chatbot to return debug data
8865	add_action('admin_footer', function() {
8866	echo '<script>window.mxchatTestingEnabled = true;</script>';
8867	});
8868
8869	break;
8870	}
8871	}
8872	private function localize_admin_scripts($current_page) {
8873	// Base localization data for main admin script
8874	$base_data = array(
8875	'ajax_url' => admin_url('admin-ajax.php'),
8876	'nonce' => wp_create_nonce('mxchat_admin_nonce'),
8877	'admin_url' => admin_url(),
8878	'license_nonce' => wp_create_nonce('mxchat_activate_license_nonce'),
8879	'inline_edit_nonce' => wp_create_nonce('mxchat_save_inline_nonce'),
8880	'setting_nonce' => wp_create_nonce('mxchat_save_setting_nonce'),
8881	'export_nonce' => wp_create_nonce('mxchat_export_transcripts'),
8882	'actions_nonce' => wp_create_nonce('mxchat_actions_nonce'),
8883	'add_intent_nonce' => wp_create_nonce('mxchat_add_intent_nonce'),
8884	'edit_intent_nonce' => wp_create_nonce('mxchat_edit_intent'),
8885	'add_phrase_nonce' => wp_create_nonce('mxchat_add_phrase_nonce'),
8886	'delete_phrase_nonce' => wp_create_nonce('mxchat_delete_phrase_nonce'),
8887	'get_phrases_nonce' => wp_create_nonce('mxchat_get_phrases_nonce'),
8888	'delete_legacy_nonce' => wp_create_nonce('mxchat_delete_legacy_nonce'),
8889	'toggle_action_nonce' => wp_create_nonce('mxchat_actions_nonce'),
8890	'fetch_openrouter_models_nonce' => wp_create_nonce('mxchat_fetch_openrouter_models'),
8891	'is_activated' => $this->is_activated ? '1' : '0',
8892	'status_refresh_interval' => 5000,
8893	'prompts_setting_nonce' => wp_create_nonce('mxchat_prompts_setting_nonce'),
8894	'ajaxurl' => admin_url('admin-ajax.php')
8895	);
8896
8897	// Localize main admin script with base data
8898	wp_localize_script('mxchat-admin-js', 'mxchatAdmin', $base_data);
8899
8900	// Canonical chat-model catalog for the modal picker grid
8901	// (plan-d14e89). Adding a model in class-mxchat-model-catalog.php
8902	// automatically appears here.
8903	if (!class_exists('MxChat_Model_Catalog')) {
8904	require_once plugin_dir_path(__FILE__) . 'class-mxchat-model-catalog.php';
8905	}
8906	wp_localize_script('mxchat-admin-js', 'mxchatChatModelCatalog', MxChat_Model_Catalog::js_picker_shape());
8907
8908	// Page-specific localizations
8909	$this->localize_page_specific_scripts($current_page);
8910	}
8911	private function localize_page_specific_scripts($current_page) {
8912	switch ($current_page) {
8913	case 'mxchat-prompts':
8914	// Status updater localization
8915	wp_localize_script('mxchat-status-updater', 'mxchat_status_data', array(
8916	'ajax_url' => admin_url('admin-ajax.php'),
8917	'nonce' => wp_create_nonce('mxchat_status_nonce')
8918	));
8919
8920	// Content selector localization
8921	$mxchat_options_for_selector = get_option('mxchat_options', array());
8922	$acf_pdf_extract_default = !empty($mxchat_options_for_selector['acf_pdf_extract_default']);
8923	wp_localize_script('mxchat-content-selector-js', 'mxchatSelector', array(
8924	'ajaxurl' => admin_url('admin-ajax.php'),
8925	'nonce' => wp_create_nonce('mxchat_content_selector_nonce'),
8926	'acfPdfExtractDefault' => $acf_pdf_extract_default ? 1 : 0,
8927	'i18n' => array(
8928	'searchPlaceholder' => __('Search posts and pages...', 'mxchat'),
8929	'selectAll' => __('Select All', 'mxchat'),
8930	'process' => __('Process Selected', 'mxchat'),
8931	'cancel' => __('Cancel', 'mxchat'),
8932	'noResults' => __('No content found.', 'mxchat'),
8933	'extractingPdfs' => __('extracting %d PDF(s)...', 'mxchat'),
8934	'pdfExtractedSuffix' => __(' (%d PDF(s) extracted)', 'mxchat')
8935	)
8936	));
8937
8938	wp_localize_script('mxchat-knowledge-processing', 'mxchatAdmin', array(
8939	'ajax_url' => admin_url('admin-ajax.php'),
8940	'status_nonce' => wp_create_nonce('mxchat_status_nonce'),
8941	'queue_nonce' => wp_create_nonce('mxchat_queue_nonce'),
8942	'stop_nonce' => wp_create_nonce('mxchat_stop_processing_action'),
8943	'settings_nonce' => wp_create_nonce('mxchat_prompts_setting_nonce'),
8944	'setting_nonce' => wp_create_nonce('mxchat_save_setting_nonce'),
8945	'entries_nonce' => wp_create_nonce('mxchat_entries_nonce'),
8946	'admin_url' => admin_url(),
8947	'ajaxurl' => admin_url('admin-ajax.php'),
8948	'status_refresh_interval' => 2000,
8949	'bot_id' => isset($_GET['bot_id']) ? sanitize_text_field($_GET['bot_id']) : 'default'
8950	));
8951	break;
8952
8953	case 'mxchat-activation':
8954	wp_localize_script('mxchat-activation-js', 'mxchatAdmin', array(
8955	'ajax_url' => admin_url('admin-ajax.php'),
8956	'license_nonce' => wp_create_nonce('mxchat_activate_license_nonce')
8957	));
8958	break;
8959
8960	case 'mxchat-content':
8961	wp_localize_script('mxchat-content-js', 'mxchatContent', array(
8962	'ajaxUrl' => admin_url('admin-ajax.php'),
8963	'nonce' => wp_create_nonce('mxchat_content_nonce'),
8964	'settingNonce' => wp_create_nonce('mxchat_save_setting_nonce'),
8965	'previewUrl' => home_url('/?p='),
8966	'isActivated' => $this->is_activated(),
8967	'hasAdvancedContent' => apply_filters('mxchat_content_pro_feature', false, 'seo_readability'),
8968	'hasGSC' => apply_filters('mxchat_content_pro_feature', false, 'gsc_integration'),
8969	'seoOptimize' => array(
8970	'meta_description' => ($options['seo_optimize_meta_desc'] ?? 'on') === 'on',
8971	'seo_title' => ($options['seo_optimize_seo_title'] ?? 'on') === 'on',
8972	'slug' => ($options['seo_optimize_slug'] ?? 'on') === 'on',
8973	'readability' => ($options['seo_optimize_readability'] ?? 'on') === 'on',
8974	'internal_links' => ($options['seo_optimize_internal_links'] ?? 'on') === 'on',
8975	'img_alt' => ($options['seo_optimize_img_alt'] ?? 'on') === 'on',
8976	'featured_img' => ($options['seo_optimize_featured_img'] ?? 'on') === 'on',
8977	),
8978	'i18n' => array(
8979	'generating' => __('Generating...', 'mxchat'),
8980	'planning' => __('Planning content structure...', 'mxchat'),
8981	'images' => __('Generating images...', 'mxchat'),
8982	'writing' => __('Writing full content...', 'mxchat'),
8983	'creating' => __('Creating WordPress post...', 'mxchat'),
8984	'done' => __('Content generated successfully!', 'mxchat'),
8985	'error' => __('An error occurred. Please try again.', 'mxchat'),
8986	'editSuccess' => __('Content updated successfully.', 'mxchat'),
8987	'promptEmpty' => __('Please enter a prompt.', 'mxchat'),
8988	)
8989	));
8990	break;
8991
8992	case 'mxchat-transcripts':
8993	// Get chart data for localization
8994	$chart_data = $this->get_transcripts_chart_data();
8995
8996	wp_localize_script('mxchat-transcripts-js', 'mxchatAdmin', array(
8997	'ajax_url' => admin_url('admin-ajax.php'),
8998	'export_nonce' => wp_create_nonce('mxchat_export_transcripts'),
8999	'delete_nonce' => wp_create_nonce('mxchat_delete_chat_history'),
9000	'setting_nonce' => wp_create_nonce('mxchat_save_setting_nonce'),
9001	'translate_nonce' => wp_create_nonce('mxchat_translate_messages')
9002	));
9003
9004	// Localize chart data separately - use array_values to ensure proper JSON array encoding
9005	wp_localize_script('mxchat-transcripts-js', 'mxchatChartData', array(
9006	'labels' => array_values($chart_data['labels']),
9007	'chats' => array_values($chart_data['chats']),
9008	'messages' => array_values($chart_data['messages'])
9009	));
9010	break;
9011
9012	case 'mxchat-settings':
9013	default:
9014	// Color picker and settings localization
9015	wp_localize_script('mxchat-color-picker', 'mxchatStyleSettings', array(
9016	'ajax_url' => admin_url('admin-ajax.php'),
9017	'link_target_toggle' => $this->options['link_target_toggle'] ?? 'off',
9018	'user_message_bg_color' => $this->options['user_message_bg_color'] ?? '#fff',
9019	'user_message_font_color' => $this->options['user_message_font_color'] ?? '#212121',
9020	'bot_message_bg_color' => $this->options['bot_message_bg_color'] ?? '#212121',
9021	'bot_message_font_color' => $this->options['bot_message_font_color'] ?? '#fff',
9022	'top_bar_bg_color' => $this->options['top_bar_bg_color'] ?? '#212121',
9023	'send_button_font_color' => $this->options['send_button_font_color'] ?? '#212121',
9024	'close_button_color' => $this->options['close_button_color'] ?? '#fff',
9025	'chatbot_background_color' => $this->options['chatbot_background_color'] ?? '#212121',
9026	'icon_color' => $this->options['icon_color'] ?? '#fff',
9027	'chat_input_font_color' => $this->options['chat_input_font_color'] ?? '#212121',
9028	'pre_chat_message' => $this->options['pre_chat_message'] ?? esc_html__('Hey there! Ask me anything!', 'mxchat'),
9029	'rate_limit_message' => $this->options['rate_limit_message'] ?? esc_html__('Rate limit exceeded. Please try again later.', 'mxchat'),
9030	'loops_api_key' => $this->options['loops_api_key'] ?? '',
9031	'loops_mailing_list' => $this->options['loops_mailing_list'] ?? '',
9032	'triggered_phrase_response' => $this->options['triggered_phrase_response'] ?? esc_html__('Would you like to join our mailing list? Please provide your email below.', 'mxchat'),
9033	'email_capture_response' => $this->options['email_capture_response'] ?? esc_html__('Thank you for providing your email! You\'ve been added to our list.', 'mxchat'),
9034	'pdf_intent_trigger_text' => $this->options['pdf_intent_trigger_text'] ?? esc_html__("Please provide the URL to the PDF you'd like to discuss.", 'mxchat'),
9035	'pdf_intent_success_text' => $this->options['pdf_intent_success_text'] ?? esc_html__("I've processed the PDF. What questions do you have about it?", 'mxchat'),
9036	'pdf_intent_error_text' => $this->options['pdf_intent_error_text'] ?? esc_html__("Sorry, I couldn't process the PDF. Please ensure it's a valid file.", 'mxchat'),
9037	'pdf_max_pages' => $this->options['pdf_max_pages'] ?? 69,
9038	'live_agent_webhook_url' => $this->options['live_agent_webhook_url'] ?? '',
9039	'live_agent_secret_key' => $this->options['live_agent_secret_key'] ?? '',
9040	'live_agent_bot_token' => $this->options['live_agent_bot_token'] ?? '',
9041	'live_agent_message_bg_color' => $this->options['live_agent_message_bg_color'] ?? '#ffffff',
9042	'live_agent_message_font_color' => $this->options['live_agent_message_font_color'] ?? '#333333',
9043	'chat_toolbar_toggle' => $this->options['chat_toolbar_toggle'] ?? 'off',
9044	'show_pdf_upload_button' => $this->options['show_pdf_upload_button'] ?? 'on',
9045	'show_word_upload_button' => $this->options['show_word_upload_button'] ?? 'on',
9046	'mode_indicator_bg_color' => $this->options['mode_indicator_bg_color'] ?? '#767676',
9047	'mode_indicator_font_color' => $this->options['mode_indicator_font_color'] ?? '#ffffff',
9048	'toolbar_icon_color' => $this->options['toolbar_icon_color'] ?? '#212121',
9049	));
9050	break;
9051	}
9052
9053	// Additional localization that was in the original code
9054	wp_localize_script('mxchat-admin-js', 'mxchatPromptsAdmin', array(
9055	'ajax_url' => admin_url('admin-ajax.php'),
9056	'prompts_setting_nonce' => wp_create_nonce('mxchat_prompts_setting_nonce'),
9057	));
9058	}
9059
9060	public function mxchat_sanitize($input) {
9061	$new_input = array();
9062
9063	if (isset($input['api_key'])) {
9064	$new_input['api_key'] = sanitize_text_field($input['api_key']);
9065	}
9066
9067	if (isset($input['similarity_threshold'])) {
9068	$new_input['similarity_threshold'] = absint($input['similarity_threshold']); // Ensure it's an integer
9069	$new_input['similarity_threshold'] = min(max($new_input['similarity_threshold'], 20), 85); // Enforce range
9070	}
9071
9072	if (isset($input['rag_sources_limit'])) {
9073	$new_input['rag_sources_limit'] = absint($input['rag_sources_limit']); // Ensure it's an integer
9074	$new_input['rag_sources_limit'] = min(max($new_input['rag_sources_limit'], 3), 10); // Enforce range 3-10
9075	}
9076
9077	if (isset($input['rag_chunks_limit'])) {
9078	$new_input['rag_chunks_limit'] = absint($input['rag_chunks_limit']); // Ensure it's an integer
9079	$new_input['rag_chunks_limit'] = min(max($new_input['rag_chunks_limit'], 8), 20); // Enforce range 8-20
9080	}
9081
9082	if (isset($input['xai_api_key'])) {
9083	$new_input['xai_api_key'] = sanitize_text_field($input['xai_api_key']);
9084	}
9085
9086	if (isset($input['claude_api_key'])) {
9087	$new_input['claude_api_key'] = sanitize_text_field($input['claude_api_key']);
9088	}
9089
9090	if (isset($input['enable_streaming_toggle'])) {
9091	$new_input['enable_streaming_toggle'] = ($input['enable_streaming_toggle'] === 'on') ? 'on' : 'off';
9092	} else {
9093	// If checkbox not checked, it won't be in $input, so set to 'off'
9094	$new_input['enable_streaming_toggle'] = 'off';
9095	}
9096
9097	if (isset($input['enable_web_search'])) {
9098	$new_input['enable_web_search'] = ($input['enable_web_search'] === 'on') ? 'on' : 'off';
9099	} else {
9100	// If checkbox not checked, it won't be in $input, so set to 'off'
9101	$new_input['enable_web_search'] = 'off';
9102	}
9103
9104	if (isset($input['deepseek_api_key'])) {
9105	$new_input['deepseek_api_key'] = sanitize_text_field($input['deepseek_api_key']);
9106	}
9107
9108	if (isset($input['gemini_api_key'])) {
9109	$new_input['gemini_api_key'] = sanitize_text_field($input['gemini_api_key']);
9110	}
9111
9112	if (isset($input['enable_woocommerce_integration'])) {
9113	$new_input['enable_woocommerce_integration'] = $input['enable_woocommerce_integration'] === 'on' ? 'on' : 'off';
9114	}
9115
9116	if (isset($input['privacy_toggle'])) {
9117	$new_input['privacy_toggle'] = $input['privacy_toggle'];
9118	}
9119
9120	if (isset($input['complianz_toggle'])) {
9121	$new_input['complianz_toggle'] = $input['complianz_toggle'];
9122	}
9123
9124	// Handle custom privacy text input
9125	if (isset($input['privacy_text'])) {
9126	// Allow basic HTML for links
9127	$new_input['privacy_text'] = wp_kses_post($input['privacy_text']);
9128	}
9129
9130	if (isset($input['system_prompt_instructions'])) {
9131	$new_input['system_prompt_instructions'] = sanitize_textarea_field($input['system_prompt_instructions']);
9132	}
9133
9134	if (isset($input['mxchat_pro_email'])) {
9135	$new_input['mxchat_pro_email'] = sanitize_email($input['mxchat_pro_email']);
9136	}
9137
9138	if (isset($input['mxchat_activation_key'])) {
9139	$new_input['mxchat_activation_key'] = sanitize_text_field($input['mxchat_activation_key']);
9140	}
9141
9142	if (isset($input['append_to_body'])) {
9143	$new_input['append_to_body'] = $input['append_to_body'] === 'on' ? 'on' : 'off';
9144	}
9145
9146	// Post type visibility settings
9147	if (isset($input['post_type_visibility_mode'])) {
9148	$allowed_modes = array('all', 'include', 'exclude');
9149	$new_input['post_type_visibility_mode'] = in_array($input['post_type_visibility_mode'], $allowed_modes)
9150	? $input['post_type_visibility_mode']
9151	: 'all';
9152	}
9153
9154	if (isset($input['post_type_visibility_list'])) {
9155	if (is_array($input['post_type_visibility_list'])) {
9156	$new_input['post_type_visibility_list'] = array_map('sanitize_key', $input['post_type_visibility_list']);
9157	} else {
9158	$new_input['post_type_visibility_list'] = array();
9159	}
9160	}
9161
9162	if (isset($input['contextual_awareness_toggle'])) {
9163	$new_input['contextual_awareness_toggle'] = $input['contextual_awareness_toggle'] === 'on' ? 'on' : 'off';
9164	}
9165
9166	if (isset($input['citation_links_toggle'])) {
9167	$new_input['citation_links_toggle'] = $input['citation_links_toggle'] === 'on' ? 'on' : 'off';
9168	}
9169
9170	// Satisfaction rating prompt — defaults ON when unchecked (so first save
9171	// doesn't accidentally disable it). The form posts 'on' when checked;
9172	// unchecked checkboxes don't post a value at all, so we infer 'off' only
9173	// when the autosave/PHP request explicitly clears it via empty string.
9174	if (array_key_exists('satisfaction_rating_enabled', $input)) {
9175	$new_input['satisfaction_rating_enabled'] = $input['satisfaction_rating_enabled'] === 'on' ? 'on' : 'off';
9176	}
9177
9178	// Satisfaction rating customization (plan-141a12). Idle is clamped 5-600;
9179	// the 4 text strings are sanitized + capped server-side. Blank values are
9180	// preserved so the integrator falls back to translated defaults.
9181	if (array_key_exists('satisfaction_rating_idle_seconds', $input)) {
9182	$new_input['satisfaction_rating_idle_seconds'] = max(5, min(600, intval($input['satisfaction_rating_idle_seconds'])));
9183	}
9184	if (array_key_exists('satisfaction_rating_question', $input)) {
9185	$new_input['satisfaction_rating_question'] = mb_substr(sanitize_text_field($input['satisfaction_rating_question']), 0, 200);
9186	}
9187	if (array_key_exists('satisfaction_rating_thanks', $input)) {
9188	$new_input['satisfaction_rating_thanks'] = mb_substr(sanitize_text_field($input['satisfaction_rating_thanks']), 0, 300);
9189	}
9190	if (array_key_exists('satisfaction_rating_placeholder', $input)) {
9191	$new_input['satisfaction_rating_placeholder'] = mb_substr(sanitize_text_field($input['satisfaction_rating_placeholder']), 0, 200);
9192	}
9193	if (array_key_exists('satisfaction_rating_saved', $input)) {
9194	$new_input['satisfaction_rating_saved'] = mb_substr(sanitize_text_field($input['satisfaction_rating_saved']), 0, 200);
9195	}
9196
9197	if (isset($input['top_bar_title'])) {
9198	$new_input['top_bar_title'] = sanitize_text_field($input['top_bar_title']);
9199	}
9200
9201	if (isset($input['ai_agent_text'])) {
9202	$new_input['ai_agent_text'] = sanitize_text_field($input['ai_agent_text']);
9203	}
9204
9205	if (isset($input['enable_email_block'])) {
9206	$new_input['enable_email_block'] = sanitize_text_field($input['enable_email_block']);
9207	}
9208
9209	if (isset($input['email_blocker_header_content'])) {
9210	// wp_kses_post() allows standard HTML tags permitted by WordPress
9211	$new_input['email_blocker_header_content'] = wp_kses_post($input['email_blocker_header_content']);
9212	}
9213	if (isset($input['email_blocker_button_text'])) {
9214	$new_input['email_blocker_button_text'] = sanitize_text_field($input['email_blocker_button_text']);
9215	}
9216	// Sanitize name field toggle
9217	if (isset($input['enable_name_field'])) {
9218	$new_input['enable_name_field'] = ($input['enable_name_field'] === 'on') ? 'on' : 'off';
9219	} else {
9220	$new_input['enable_name_field'] = 'off';
9221	}
9222	// Sanitize name field placeholder
9223	if (isset($input['name_field_placeholder'])) {
9224	$new_input['name_field_placeholder'] = sanitize_text_field($input['name_field_placeholder']);
9225	}
9226	if (isset($input['intro_message'])) {
9227	$new_input['intro_message'] = wp_kses_post($input['intro_message']); // Use wp_kses_post instead
9228	}
9229
9230	if (isset($input['input_copy'])) {
9231	$new_input['input_copy'] = sanitize_text_field($input['input_copy']);
9232	}
9233
9234	if (isset($input['rate_limit_message'])) {
9235	$new_input['rate_limit_message'] = sanitize_text_field($input['rate_limit_message']);
9236	}
9237
9238	// Handle the new rate limits format
9239	if (isset($input['rate_limits']) && is_array($input['rate_limits'])) {
9240	$new_input['rate_limits'] = array();
9241	$allowed_limits = array('1', '3', '5', '10', '15', '20', '50', '100', 'unlimited');
9242	$allowed_timeframes = array('hourly', 'daily', 'weekly', 'monthly');
9243
9244	foreach ($input['rate_limits'] as $role_id => $settings) {
9245	$new_input['rate_limits'][$role_id] = array();
9246
9247	// Sanitize limit
9248	if (isset($settings['limit'])) {
9249	$limit = sanitize_text_field($settings['limit']);
9250	// Accept presets, 'unlimited', the '__custom__' sentinel, OR any positive
9251	// integer (custom value) — mirrors the global branch (plan-2c02ea). Without
9252	// the custom path the per-role custom input was dropped and reset to the role
9253	// default on every save (plan-7e23e7).
9254	if (in_array($limit, $allowed_limits, true) \|\| $limit === '__custom__' \|\| (ctype_digit($limit) && (int) $limit >= 1)) {
9255	$new_input['rate_limits'][$role_id]['limit'] = $limit;
9256	} else {
9257	$new_input['rate_limits'][$role_id]['limit'] = ($role_id === 'logged_out') ? '10' : '100'; // Default
9258	}
9259	}
9260
9261	// Preserve the per-role custom value (mirrors the global branch's limit_custom).
9262	if (isset($settings['limit_custom'])) {
9263	$new_input['rate_limits'][$role_id]['limit_custom'] = preg_replace('/[^0-9]/', '', (string) $settings['limit_custom']);
9264	}
9265
9266	// Sanitize timeframe
9267	if (isset($settings['timeframe'])) {
9268	$timeframe = sanitize_text_field($settings['timeframe']);
9269	if (in_array($timeframe, $allowed_timeframes, true)) {
9270	$new_input['rate_limits'][$role_id]['timeframe'] = $timeframe;
9271	} else {
9272	$new_input['rate_limits'][$role_id]['timeframe'] = 'daily'; // Default
9273	}
9274	}
9275
9276	// Sanitize message
9277	if (isset($settings['message'])) {
9278	$new_input['rate_limits'][$role_id]['message'] = sanitize_textarea_field($settings['message']);
9279	}
9280	}
9281	}
9282
9283	// Handle the whole-chatbot global rate limit (plan-mxchat-20260603-2c02ea).
9284	// Mirrors the per-role block above, adapted to the single global shape. Without
9285	// this branch the whitelist-rebuild dropped rate_limits_global entirely on every
9286	// save, so the global cap silently fell back to its 'unlimited' default.
9287	// MUST accept arbitrary positive integers so the custom-value path (d55f65) is not regressed.
9288	if (isset($input['rate_limits_global']) && is_array($input['rate_limits_global'])) {
9289	$g = $input['rate_limits_global'];
9290	$allowed_limits = array('1', '3', '5', '10', '15', '20', '50', '100', 'unlimited');
9291	$allowed_timeframes = array('hourly', 'daily', 'weekly', 'monthly');
9292	$global_out = array();
9293
9294	if (isset($g['limit'])) {
9295	$limit = sanitize_text_field($g['limit']);
9296	// Accept presets, 'unlimited', the '__custom__' sentinel (resolved by the
9297	// autosave handler / renderer), OR any positive integer (custom value).
9298	if (in_array($limit, $allowed_limits, true) \|\| $limit === '__custom__' \|\| (ctype_digit($limit) && (int) $limit >= 1)) {
9299	$global_out['limit'] = $limit;
9300	} else {
9301	$global_out['limit'] = 'unlimited';
9302	}
9303	}
9304
9305	if (isset($g['limit_custom'])) {
9306	$global_out['limit_custom'] = preg_replace('/[^0-9]/', '', (string) $g['limit_custom']);
9307	}
9308
9309	if (isset($g['timeframe'])) {
9310	$timeframe = sanitize_text_field($g['timeframe']);
9311	$global_out['timeframe'] = in_array($timeframe, $allowed_timeframes, true) ? $timeframe : 'daily';
9312	}
9313
9314	if (isset($g['message'])) {
9315	$global_out['message'] = sanitize_textarea_field($g['message']);
9316	}
9317
9318	$new_input['rate_limits_global'] = $global_out;
9319	}
9320
9321	if (isset($input['pre_chat_message'])) {
9322	$new_input['pre_chat_message'] = sanitize_textarea_field($input['pre_chat_message']);
9323	}
9324
9325	if (isset($input['voyage_api_key'])) {
9326	$new_input['voyage_api_key'] = sanitize_text_field($input['voyage_api_key']);
9327	}
9328
9329	// Add to your sanitize function
9330	if (isset($input['embedding_model'])) {
9331	// Catalog refactor (plan-d14e89): allowlist derived from the canonical
9332	// catalog in includes/class-mxchat-model-catalog.php.
9333	if (!class_exists('MxChat_Model_Catalog')) {
9334	require_once plugin_dir_path(__FILE__) . 'class-mxchat-model-catalog.php';
9335	}
9336	$allowed_models = MxChat_Model_Catalog::embedding_model_ids();
9337	if (in_array($input['embedding_model'], $allowed_models)) {
9338	$new_input['embedding_model'] = sanitize_text_field($input['embedding_model']);
9339	}
9340	}
9341
9342	if (isset($input['model'])) {
9343	if ($input['model'] === 'openrouter') {
9344	$new_input['model'] = 'openrouter';
9345	} else {
9346	if (!class_exists('MxChat_Model_Catalog')) {
9347	require_once plugin_dir_path(__FILE__) . 'class-mxchat-model-catalog.php';
9348	}
9349	$allowed_models = MxChat_Model_Catalog::chat_model_ids();
9350
9351	if (in_array($input['model'], $allowed_models)) {
9352	$new_input['model'] = sanitize_text_field($input['model']);
9353	} else {
9354	// Fallback for any deprecated model
9355	$new_input['model'] = 'gpt-5.1-chat-latest';
9356	}
9357	}
9358	}
9359
9360	if (isset($input['openrouter_selected_model'])) {
9361	// Just sanitize it, don't validate against a whitelist
9362	$new_input['openrouter_selected_model'] = sanitize_text_field($input['openrouter_selected_model']);
9363	}
9364
9365	// ADD THIS:
9366	if (isset($input['openrouter_selected_model_name'])) {
9367	$new_input['openrouter_selected_model_name'] = sanitize_text_field($input['openrouter_selected_model_name']);
9368	}
9369
9370	if (isset($input['openrouter_api_key'])) {
9371	$new_input['openrouter_api_key'] = sanitize_text_field($input['openrouter_api_key']);
9372	}
9373
9374	// Custom (OpenAI-compatible) Provider — Ollama, LM Studio, vLLM, Azure OpenAI, etc.
9375	if (isset($input['custom_provider_base_url'])) {
9376	$new_input['custom_provider_base_url'] = esc_url_raw(rtrim(trim((string) $input['custom_provider_base_url']), '/'));
9377	}
9378	if (isset($input['custom_provider_api_key'])) {
9379	$new_input['custom_provider_api_key'] = sanitize_text_field($input['custom_provider_api_key']);
9380	}
9381	if (isset($input['custom_provider_model'])) {
9382	$new_input['custom_provider_model'] = sanitize_text_field($input['custom_provider_model']);
9383	}
9384	if (isset($input['custom_provider_auth_scheme'])) {
9385	$scheme = sanitize_text_field($input['custom_provider_auth_scheme']);
9386	$new_input['custom_provider_auth_scheme'] = in_array($scheme, array('bearer', 'api-key'), true) ? $scheme : 'bearer';
9387	}
9388	if (isset($input['custom_provider_for_embeddings'])) {
9389	$new_input['custom_provider_for_embeddings'] = ($input['custom_provider_for_embeddings'] === 'on') ? 'on' : 'off';
9390	}
9391	if (isset($input['custom_provider_for_images'])) {
9392	$new_input['custom_provider_for_images'] = ($input['custom_provider_for_images'] === 'on') ? 'on' : 'off';
9393	}
9394	if (isset($input['custom_provider_embedding_model'])) {
9395	$new_input['custom_provider_embedding_model'] = sanitize_text_field($input['custom_provider_embedding_model']);
9396	}
9397	if (isset($input['custom_provider_api_version'])) {
9398	$new_input['custom_provider_api_version'] = sanitize_text_field($input['custom_provider_api_version']);
9399	}
9400
9401
9402
9403	if (isset($input['woocommerce_consumer_key'])) {
9404	$new_input['woocommerce_consumer_key'] = sanitize_text_field($input['woocommerce_consumer_key']);
9405	}
9406
9407	if (isset($input['woocommerce_consumer_secret'])) {
9408	$new_input['woocommerce_consumer_secret'] = sanitize_text_field($input['woocommerce_consumer_secret']);
9409	}
9410
9411
9412	// Sanitize link_target_toggle
9413	if (isset($input['link_target_toggle'])) {
9414	$new_input['link_target_toggle'] = $input['link_target_toggle'] === 'on' ? 'on' : 'off';
9415	}
9416
9417	// Sanitize Loops API Key
9418	if (isset($input['loops_api_key'])) {
9419	$new_input['loops_api_key'] = sanitize_text_field($input['loops_api_key']);
9420	}
9421
9422	if (isset($input['chat_persistence_toggle'])) {
9423	$new_input['chat_persistence_toggle'] = $input['chat_persistence_toggle'] === 'on' ? 'on' : 'off';
9424	}
9425
9426	if (isset($input['popular_question_1'])) {
9427	$new_input['popular_question_1'] = sanitize_text_field($input['popular_question_1']);
9428	}
9429
9430	if (isset($input['popular_question_2'])) {
9431	$new_input['popular_question_2'] = sanitize_text_field($input['popular_question_2']);
9432	}
9433
9434	if (isset($input['popular_question_3'])) {
9435	$new_input['popular_question_3'] = sanitize_text_field($input['popular_question_3']);
9436	}
9437
9438	if (isset($input['additional_popular_questions']) && is_array($input['additional_popular_questions'])) {
9439	$new_input['additional_popular_questions'] = array_map('sanitize_text_field', $input['additional_popular_questions']);
9440	}
9441
9442	// Sanitize Loops Mailing List
9443	if (isset($input['loops_mailing_list'])) {
9444	$new_input['loops_mailing_list'] = sanitize_text_field($input['loops_mailing_list']);
9445	}
9446
9447	// Sanitize Triggered Phrase Response
9448	if (isset($input['triggered_phrase_response'])) {
9449	$new_input['triggered_phrase_response'] = wp_kses_post($input['triggered_phrase_response']);
9450	}
9451	if (isset($input['email_capture_response'])) {
9452	$new_input['email_capture_response'] = wp_kses_post($input['email_capture_response']);
9453	}
9454
9455	// Sanitize Brave Search Settings
9456	if (isset($input['brave_api_key'])) {
9457	$new_input['brave_api_key'] = sanitize_text_field($input['brave_api_key']);
9458	}
9459
9460	if (isset($input['brave_image_count'])) {
9461	$image_count = intval($input['brave_image_count']);
9462	$new_input['brave_image_count'] = ($image_count >=1 && $image_count <=6) ? $image_count : 4;
9463	}
9464
9465	if (isset($input['brave_safe_search'])) {
9466	$allowed = array('strict', 'off');
9467	$new_input['brave_safe_search'] = in_array($input['brave_safe_search'], $allowed, true) ? $input['brave_safe_search'] : 'strict';
9468	}
9469
9470	if (isset($input['brave_news_count'])) {
9471	$news_count = intval($input['brave_news_count']);
9472	$new_input['brave_news_count'] = ($news_count >=1 && $news_count <=10) ? $news_count : 3;
9473	}
9474
9475	if (isset($input['brave_country'])) {
9476	$new_input['brave_country'] = sanitize_text_field($input['brave_country']);
9477	}
9478
9479	if (isset($input['brave_language'])) {
9480	$new_input['brave_language'] = sanitize_text_field($input['brave_language']);
9481	}
9482
9483	if (isset($input['chat_toolbar_toggle'])) {
9484	$new_input['chat_toolbar_toggle'] = $input['chat_toolbar_toggle'] === 'on' ? 'on' : 'off';
9485	}
9486
9487	// Sanitize PDF upload button toggle
9488	if (isset($input['show_pdf_upload_button'])) {
9489	$new_input['show_pdf_upload_button'] = $input['show_pdf_upload_button'] === 'on' ? 'on' : 'off';
9490	} else {
9491	$new_input['show_pdf_upload_button'] = 'off'; // If checkbox is unchecked
9492	}
9493
9494	// Sanitize Word upload button toggle
9495	if (isset($input['show_word_upload_button'])) {
9496	$new_input['show_word_upload_button'] = $input['show_word_upload_button'] === 'on' ? 'on' : 'off';
9497	} else {
9498	$new_input['show_word_upload_button'] = 'off'; // If checkbox is unchecked
9499	}
9500
9501	if (isset($input['pdf_intent_trigger_text'])) {
9502	$new_input['pdf_intent_trigger_text'] = sanitize_text_field($input['pdf_intent_trigger_text']);
9503	}
9504
9505	if (isset($input['pdf_intent_success_text'])) {
9506	$new_input['pdf_intent_success_text'] = sanitize_text_field($input['pdf_intent_success_text']);
9507	}
9508
9509	if (isset($input['pdf_intent_error_text'])) {
9510	$new_input['pdf_intent_error_text'] = sanitize_text_field($input['pdf_intent_error_text']);
9511	}
9512
9513	if (isset($input['pdf_max_pages'])) {
9514	$new_input['pdf_max_pages'] = intval($input['pdf_max_pages']);
9515	if ($new_input['pdf_max_pages'] < 1 \|\| $new_input['pdf_max_pages'] > 69) {
9516	$new_input['pdf_max_pages'] = 69; // Default to 69 if out of range
9517	}
9518	}
9519
9520	if (isset($input['live_agent_webhook_url'])) {
9521	$new_input['live_agent_webhook_url'] = esc_url_raw($input['live_agent_webhook_url']);
9522	}
9523	if (isset($input['live_agent_secret_key'])) {
9524	$new_input['live_agent_secret_key'] = sanitize_text_field($input['live_agent_secret_key']);
9525	}
9526
9527	// Live Agent Integration
9528	if (isset($input['live_agent_bot_token'])) {
9529	$new_input['live_agent_bot_token'] = sanitize_text_field($input['live_agent_bot_token']);
9530	}
9531
9532	if (isset($input['live_agent_user_ids'])) {
9533	$new_input['live_agent_user_ids'] = sanitize_textarea_field($input['live_agent_user_ids']);
9534	}
9535
9536	if (isset($input['live_agent_status'])) {
9537	$new_input['live_agent_status'] = ($input['live_agent_status'] === 'on') ? 'on' : 'off';
9538	}
9539	if (isset($input['live_agent_away_message'])) {
9540	$new_input['live_agent_away_message'] = sanitize_textarea_field($input['live_agent_away_message']);
9541	}
9542	if (isset($input['live_agent_notification_message'])) {
9543	$new_input['live_agent_notification_message'] = sanitize_textarea_field($input['live_agent_notification_message']);
9544	}
9545
9546	// Telegram Integration
9547	if (isset($input['telegram_status'])) {
9548	$new_input['telegram_status'] = ($input['telegram_status'] === 'on') ? 'on' : 'off';
9549	}
9550	if (isset($input['telegram_bot_token'])) {
9551	$new_input['telegram_bot_token'] = sanitize_text_field($input['telegram_bot_token']);
9552	}
9553	if (isset($input['telegram_group_id'])) {
9554	$new_input['telegram_group_id'] = sanitize_text_field($input['telegram_group_id']);
9555	}
9556	if (isset($input['telegram_webhook_secret'])) {
9557	$new_input['telegram_webhook_secret'] = sanitize_text_field($input['telegram_webhook_secret']);
9558	}
9559	if (isset($input['telegram_notification_message'])) {
9560	$new_input['telegram_notification_message'] = sanitize_textarea_field($input['telegram_notification_message']);
9561	}
9562	if (isset($input['telegram_away_message'])) {
9563	$new_input['telegram_away_message'] = sanitize_textarea_field($input['telegram_away_message']);
9564	}
9565
9566	// Sanitize script loading strategy
9567	if (isset($input['script_loading_strategy'])) {
9568	$allowed_strategies = array('default', 'defer', 'delay_1s', 'delay_3s', 'delay_5s', 'on_interaction');
9569	$new_input['script_loading_strategy'] = in_array($input['script_loading_strategy'], $allowed_strategies)
9570	? $input['script_loading_strategy']
9571	: 'default';
9572	}
9573
9574	// Sanitize debug mode
9575	if (isset($input['debug_mode'])) {
9576	$new_input['debug_mode'] = ($input['debug_mode'] === 'on') ? 'on' : 'off';
9577	}
9578
9579	// Content Generator Settings
9580	if (isset($input['content_model'])) {
9581	$new_input['content_model'] = sanitize_text_field($input['content_model']);
9582	}
9583	if (isset($input['content_image_model'])) {
9584	$new_input['content_image_model'] = sanitize_text_field($input['content_image_model']);
9585	}
9586	if (isset($input['content_image_quality'])) {
9587	$q = sanitize_text_field($input['content_image_quality']);
9588	$new_input['content_image_quality'] = in_array($q, array('auto', 'low', 'medium', 'high'), true) ? $q : 'auto';
9589	}
9590	if (isset($input['content_enable_images'])) {
9591	$new_input['content_enable_images'] = ($input['content_enable_images'] === 'on') ? 'on' : 'off';
9592	}
9593	if (isset($input['content_use_placeholders'])) {
9594	$new_input['content_use_placeholders'] = ($input['content_use_placeholders'] === 'on') ? 'on' : 'off';
9595	}
9596	if (isset($input['content_internal_linking'])) {
9597	$new_input['content_internal_linking'] = ($input['content_internal_linking'] === 'on') ? 'on' : 'off';
9598	}
9599	if (isset($input['content_tool_use'])) {
9600	$new_input['content_tool_use'] = ($input['content_tool_use'] === 'on') ? 'on' : 'off';
9601	}
9602
9603	// SEO Optimize toggle fields
9604	foreach (array('seo_optimize_meta_desc', 'seo_optimize_seo_title', 'seo_optimize_slug', 'seo_optimize_readability', 'seo_optimize_internal_links', 'seo_optimize_img_alt', 'seo_optimize_featured_img') as $seo_key) {
9605	if (isset($input[$seo_key])) {
9606	$new_input[$seo_key] = ($input[$seo_key] === 'on') ? 'on' : 'off';
9607	}
9608	}
9609
9610	// Preserve content generator settings when saving from main settings page
9611	// (where content fields are not in the form submission)
9612	$existing = get_option('mxchat_options', array());
9613	foreach (array('content_model', 'content_image_model', 'content_image_quality', 'content_enable_images', 'content_use_placeholders', 'content_internal_linking', 'content_tool_use', 'seo_optimize_meta_desc', 'seo_optimize_seo_title', 'seo_optimize_slug', 'seo_optimize_readability', 'seo_optimize_internal_links', 'seo_optimize_img_alt', 'seo_optimize_featured_img') as $key) {
9614	if (!isset($new_input[$key]) && isset($existing[$key])) {
9615	$new_input[$key] = $existing[$key];
9616	}
9617	}
9618
9619	return $new_input;
9620	}
9621
9622	/**
9623	* Log a debug message if debug mode is enabled
9624	*
9625	* @param string $type The type of log entry (settings_save, api_error, activation, etc.)
9626	* @param string $message The log message
9627	* @param array $data Optional additional data to log
9628	* @return bool Whether the message was logged
9629	*/
9630	public static function mxchat_log_debug( $type, $message, $data = array() ) {
9631	$options = get_option( 'mxchat_options', array() );
9632
9633	// Check if debug mode is enabled
9634	if ( ! isset( $options['debug_mode'] ) \|\| $options['debug_mode'] !== 'on' ) {
9635	return false;
9636	}
9637
9638	// Get current log
9639	$log = get_option( 'mxchat_debug_log', array() );
9640	if ( ! is_array( $log ) ) {
9641	$log = array();
9642	}
9643
9644	// Add new entry
9645	$entry = array(
9646	'time' => current_time( 'Y-m-d H:i:s' ),
9647	'type' => sanitize_key( $type ),
9648	'message' => sanitize_text_field( $message ),
9649	);
9650
9651	if ( ! empty( $data ) ) {
9652	$entry['data'] = $data;
9653	}
9654
9655	// Add to beginning of array (newest first)
9656	array_unshift( $log, $entry );
9657
9658	// Keep only last 100 entries
9659	if ( count( $log ) > 100 ) {
9660	$log = array_slice( $log, 0, 100 );
9661	}
9662
9663	// Save log
9664	update_option( 'mxchat_debug_log', $log, false );
9665
9666	return true;
9667	}
9668
9669	/**
9670	* Get the debug log entries
9671	*
9672	* @return array The debug log entries
9673	*/
9674	public static function mxchat_get_debug_log() {
9675	$log = get_option( 'mxchat_debug_log', array() );
9676	return is_array( $log ) ? $log : array();
9677	}
9678
9679	/**
9680	* Clear the debug log
9681	*
9682	* @return bool Whether the log was cleared
9683	*/
9684	public static function mxchat_clear_debug_log() {
9685	return delete_option( 'mxchat_debug_log' );
9686	}
9687
9688	/**
9689	* Export settings as JSON with masked API keys
9690	*
9691	* @return array The sanitized settings array
9692	*/
9693	public static function mxchat_export_settings() {
9694	$options = get_option( 'mxchat_options', array() );
9695
9696	if ( ! is_array( $options ) ) {
9697	return array();
9698	}
9699
9700	// List of API key fields to mask
9701	$api_key_fields = array(
9702	'api_key',
9703	'xai_api_key',
9704	'claude_api_key',
9705	'deepseek_api_key',
9706	'voyage_api_key',
9707	'gemini_api_key',
9708	'openrouter_api_key',
9709	'loops_api_key',
9710	'brave_api_key',
9711	'live_agent_secret_key',
9712	'live_agent_bot_token',
9713	'telegram_bot_token',
9714	'telegram_webhook_secret',
9715	'woocommerce_consumer_key',
9716	'woocommerce_consumer_secret',
9717	);
9718
9719	// Mask API keys (show only last 4 characters)
9720	foreach ( $api_key_fields as $field ) {
9721	if ( isset( $options[ $field ] ) && ! empty( $options[ $field ] ) ) {
9722	$value = $options[ $field ];
9723	if ( strlen( $value ) > 4 ) {
9724	$options[ $field ] = str_repeat( '*', strlen( $value ) - 4 ) . substr( $value, -4 );
9725	} else {
9726	$options[ $field ] = '****';
9727	}
9728	}
9729	}
9730
9731	// Add metadata
9732	$export = array(
9733	'plugin_version' => defined( 'MXCHAT_VERSION' ) ? MXCHAT_VERSION : 'unknown',
9734	'export_date' => current_time( 'Y-m-d H:i:s' ),
9735	'wordpress_version' => get_bloginfo( 'version' ),
9736	'php_version' => phpversion(),
9737	'settings' => $options,
9738	);
9739
9740	return $export;
9741	}
9742
9743	/**
9744	* Reset all settings to defaults
9745	*
9746	* @return bool Whether the reset was successful
9747	*/
9748	public static function mxchat_reset_all_settings() {
9749	// Delete main options
9750	$deleted = delete_option( 'mxchat_options' );
9751
9752	// Also clear the debug log
9753	delete_option( 'mxchat_debug_log' );
9754
9755	// Log the reset (will create new log since we just cleared it)
9756	// We need to temporarily enable debug mode to log this
9757	$temp_options = array( 'debug_mode' => 'on' );
9758	update_option( 'mxchat_options', $temp_options );
9759
9760	self::mxchat_log_debug( 'reset', 'All settings have been reset to defaults' );
9761
9762	// Now delete again to trigger re-initialization
9763	delete_option( 'mxchat_options' );
9764
9765	return $deleted;
9766	}
9767
9768	// Method to append the chatbot to the body
9769	public function mxchat_append_chatbot_to_body() {
9770	$options = get_option('mxchat_options');
9771	if (isset($options['append_to_body']) && $options['append_to_body'] === 'on') {
9772	echo do_shortcode('[mxchat_chatbot floating="yes"]');
9773	}
9774	}
9775
9776
9777
9778
9779
9780	private function mxchat_fetch_loops_mailing_lists($api_key) {
9781	$url = 'https://app.loops.so/api/v1/lists';
9782	$response = wp_remote_get($url, array(
9783	'headers' => array(
9784	'Authorization' => 'Bearer ' . $api_key,
9785	'Content-Type' => 'application/json'
9786	)
9787	));
9788
9789	if (is_wp_error($response)) {
9790	return array();
9791	}
9792
9793	$body = wp_remote_retrieve_body($response);
9794	$lists = json_decode($body, true);
9795
9796	return isset($lists) && is_array($lists) ? $lists : array();
9797	}
9798
9799	function mxchat_calculate_cosine_similarity($vec1, $vec2) {
9800	if (empty($vec1) \|\| empty($vec2)) {
9801	return 0.0;
9802	}
9803
9804	$dot_product = 0.0;
9805	$norm_a = 0.0;
9806	$norm_b = 0.0;
9807
9808	for ($i = 0; $i < count($vec1); $i++) {
9809	$dot_product += $vec1[$i] * $vec2[$i];
9810	$norm_a += pow($vec1[$i], 2);
9811	$norm_b += pow($vec2[$i], 2);
9812	}
9813
9814	if ($norm_a == 0.0 \|\| $norm_b == 0.0) {
9815	return 0.0;
9816	} else {
9817	return $dot_product / (sqrt($norm_a) * sqrt($norm_b));
9818	}
9819	}
9820
9821	/**
9822	* Validates nonce and deletes all chat prompts
9823	*/
9824	public function mxchat_handle_delete_all_prompts() {
9825	//error_log('=== DELETE ALL DEBUG START ===');
9826
9827	// Verify nonce
9828	if (!isset($_POST['mxchat_delete_all_prompts_nonce']) \|\| !wp_verify_nonce($_POST['mxchat_delete_all_prompts_nonce'], 'mxchat_delete_all_prompts_action')) {
9829	//error_log('DEBUG: Nonce verification failed');
9830	wp_die(__('Nonce verification failed.', 'mxchat'));
9831	}
9832
9833	// Check permissions
9834	if (!current_user_can('manage_options')) {
9835	//error_log('DEBUG: Permission check failed');
9836	wp_die(__('You do not have sufficient permissions to delete all prompts.', 'mxchat'));
9837	}
9838
9839	// Get bot_id and content type filter from POST data
9840	$bot_id = isset($_POST['bot_id']) ? sanitize_text_field($_POST['bot_id']) : 'default';
9841	$content_type_filter = isset($_POST['content_type_filter']) ? sanitize_text_field($_POST['content_type_filter']) : '';
9842
9843	$success = true;
9844	$error_messages = array();
9845
9846	// Get bot-specific Pinecone configuration
9847	$pinecone_manager = MxChat_Pinecone_Manager::get_instance();
9848	$pinecone_options = $pinecone_manager->mxchat_get_bot_pinecone_options($bot_id);
9849
9850	$use_pinecone = ($pinecone_options['mxchat_use_pinecone'] ?? '0') === '1';
9851
9852	if ($use_pinecone && !empty($pinecone_options['mxchat_pinecone_api_key'])) {
9853	// Delete from Pinecone (with optional content type filter)
9854	$result = $pinecone_manager->mxchat_delete_all_from_pinecone($pinecone_options, $content_type_filter);
9855
9856	if (!$result['success']) {
9857	$success = false;
9858	$error_messages[] = $result['message'];
9859	}
9860
9861	} else {
9862	// Delete from WordPress database
9863	global $wpdb;
9864	$table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
9865
9866	// Build WHERE conditions
9867	$where_clauses = array();
9868	$where_values = array();
9869
9870	// Bot filter
9871	if ($bot_id !== 'default' && class_exists('MxChat_Multi_Bot_Manager')) {
9872	$where_clauses[] = 'bot_id = %s';
9873	$where_values[] = $bot_id;
9874	}
9875
9876	// Content type filter
9877	if (!empty($content_type_filter)) {
9878	$where_clauses[] = 'content_type = %s';
9879	$where_values[] = $content_type_filter;
9880	}
9881
9882	if (!empty($where_clauses)) {
9883	$where_sql = implode(' AND ', $where_clauses);
9884	$result = $wpdb->query($wpdb->prepare("DELETE FROM {$table_name} WHERE {$where_sql}", $where_values));
9885	} else {
9886	// No filters — delete all
9887	$result = $wpdb->query("DELETE FROM {$table_name}");
9888	}
9889
9890	if ($result === false) {
9891	$success = false;
9892	$error_messages[] = 'Failed to delete from WordPress database';
9893	}
9894	}
9895
9896	// Redirect back with a success message and bot_id
9897	$redirect_url = add_query_arg(array(
9898	'page' => 'mxchat-prompts',
9899	'bot_id' => $bot_id,
9900	'all_deleted' => $success ? 'true' : 'false'
9901	), admin_url('admin.php'));
9902
9903	wp_safe_redirect($redirect_url);
9904	exit;
9905	}
9906
9907
9908
9909	/**
9910	* Handles deletion prompt with nonce validation
9911	*/
9912	public function mxchat_handle_delete_prompt() {
9913	// Sanitize and validate nonce
9914	$nonce = isset($_GET['_wpnonce']) ? sanitize_text_field(wp_unslash($_GET['_wpnonce'])) : '';
9915	if (empty($nonce) \|\| !wp_verify_nonce($nonce, 'mxchat_delete_prompt_nonce')) {
9916	wp_die(esc_html__('Nonce verification failed.', 'mxchat'));
9917	}
9918
9919	// Check permissions
9920	if (!current_user_can('manage_options')) {
9921	wp_die(esc_html__('You do not have sufficient permissions to delete prompts.', 'mxchat'));
9922	}
9923
9924	// Get ID and source parameters
9925	$id = isset($_GET['id']) ? sanitize_text_field($_GET['id']) : '';
9926	$source = isset($_GET['source']) ? sanitize_text_field($_GET['source']) : '';
9927
9928	if (empty($id)) {
9929	wp_die(esc_html__('Invalid prompt ID.', 'mxchat'));
9930	}
9931
9932	$success = false;
9933	$error_message = '';
9934
9935	// Check if Pinecone is enabled and determine source automatically if not specified
9936	$pinecone_options = get_option('mxchat_pinecone_addon_options', array());
9937	$use_pinecone = ($pinecone_options['mxchat_use_pinecone'] ?? '0') === '1';
9938
9939	// If source is not specified, determine based on Pinecone configuration
9940	if (empty($source)) {
9941	$source = $use_pinecone ? 'pinecone' : 'wordpress';
9942	}
9943
9944	if ($source === 'pinecone' \|\| $use_pinecone) {
9945	//error_log('[MXCHAT-DELETE] Deleting from Pinecone, ID: ' . $id);
9946
9947	// Handle Pinecone deletion
9948	if (empty($pinecone_options['mxchat_pinecone_host']) \|\|
9949	empty($pinecone_options['mxchat_pinecone_api_key'])) {
9950	wp_die(esc_html__('Pinecone configuration is missing.', 'mxchat'));
9951	}
9952
9953	// Delete from Pinecone using the vector ID directly
9954	$pinecone_manager = MxChat_Pinecone_Manager::get_instance();
9955	$result = $pinecone_manager->mxchat_delete_from_pinecone_by_vector_id(
9956	$id,
9957	$pinecone_options['mxchat_pinecone_api_key'],
9958	$pinecone_options['mxchat_pinecone_host']
9959	);
9960	if ($result['success']) {
9961	$success = true;
9962
9963	// Remove from vector cache
9964	$pinecone_manager->mxchat_remove_from_pinecone_vector_cache($id);
9965	$pinecone_manager->mxchat_remove_from_processed_content_caches($id);
9966
9967	set_transient('mxchat_admin_notice_success',
9968	esc_html__('Vector deleted successfully from Pinecone.', 'mxchat'), 30);
9969	} else {
9970	$error_message = $result['message'];
9971	set_transient('mxchat_admin_notice_error',
9972	esc_html__('Failed to delete from Pinecone: ', 'mxchat') . esc_html($error_message), 30);
9973	}
9974	} else {
9975	//error_log('[MXCHAT-DELETE] Deleting from WordPress database, ID: ' . $id);
9976
9977	// Handle WordPress database deletion
9978	global $wpdb;
9979	$table_name = $wpdb->prefix . 'mxchat_system_prompt_content';
9980
9981	// Clear cache and delete prompt
9982	wp_cache_delete('prompt_' . $id, 'mxchat_prompts');
9983
9984	$result = $wpdb->delete(
9985	$table_name,
9986	array('id' => intval($id)),
9987	array('%d')
9988	);
9989
9990	if ($result !== false) {
9991	$success = true;
9992	set_transient('mxchat_admin_notice_success',
9993	esc_html__('Entry deleted successfully.', 'mxchat'), 30);
9994	} else {
9995	set_transient('mxchat_admin_notice_error',
9996	esc_html__('Failed to delete entry from database.', 'mxchat'), 30);
9997	}
9998	}
9999
10000	// Redirect back to the prompts page
10001	wp_safe_redirect(add_query_arg(
10002	array(
10003	'page' => 'mxchat-prompts',
10004	'deleted' => $success ? 'true' : 'false'
10005	),
10006	admin_url('admin.php')
10007	));
10008	exit;
10009	}
10010
10011
10012
10013
10014	/**
10015	* Averages multiple vectors into a single vector
10016	*/
10017	private function mxchat_average_vectors($vectors) {
10018	$vector_length = count($vectors[0]);
10019	$sum_vector = array_fill(0, $vector_length, 0);
10020
10021	foreach ($vectors as $vector) {
10022	for ($i = 0; $i < $vector_length; $i++) {
10023	$sum_vector[$i] += $vector[$i];
10024	}
10025	}
10026
10027	// Divide each component by the number of vectors to get the average
10028	$num_vectors = count($vectors);
10029	for ($i = 0; $i < $vector_length; $i++) {
10030	$sum_vector[$i] /= $num_vectors;
10031	}
10032
10033	return $sum_vector;
10034	}
10035
10036
10037
10038
10039	/**
10040	* Generates embeddings from input text for MXChat
10041	*/
10042	public function mxchat_generate_embedding($text) {
10043	// Enable detailed logging for debugging
10044	//error_log('[MXCHAT-EMBED] Starting embedding generation. Text length: ' . strlen($text) . ' bytes');
10045	//error_log('[MXCHAT-EMBED] Text preview: ' . substr($text, 0, 100) . '...');
10046
10047	$options = get_option('mxchat_options');
10048	$selected_model = $options['embedding_model'] ?? 'text-embedding-ada-002';
10049	//error_log('[MXCHAT-EMBED] Selected embedding model: ' . $selected_model);
10050
10051	// Determine provider and endpoint
10052	if (strpos($selected_model, 'voyage') === 0) {
10053	$api_key = $options['voyage_api_key'] ?? '';
10054	$endpoint = 'https://api.voyageai.com/v1/embeddings';
10055	$provider_name = 'Voyage AI';
10056	//error_log('[MXCHAT-EMBED] Using Voyage AI API');
10057	} elseif (strpos($selected_model, 'gemini-embedding') === 0) {
10058	$api_key = $options['gemini_api_key'] ?? '';
10059	$endpoint = 'https://generativelanguage.googleapis.com/v1beta/models/' . $selected_model . ':embedContent';
10060	$provider_name = 'Google Gemini';
10061	//error_log('[MXCHAT-EMBED] Using Google Gemini API');
10062	} else {
10063	$api_key = $options['api_key'] ?? '';
10064	$endpoint = 'https://api.openai.com/v1/embeddings';
10065	$provider_name = 'OpenAI';
10066	//error_log('[MXCHAT-EMBED] Using OpenAI API');
10067	}
10068
10069	//error_log('[MXCHAT-EMBED] Using endpoint: ' . $endpoint);
10070
10071	if (empty($api_key)) {
10072	$error_message = sprintf('Missing %s API key. Please configure your API key in the MxChat settings.', $provider_name);
10073	//error_log('[MXCHAT-EMBED] Error: ' . $error_message);
10074	return $error_message;
10075	}
10076
10077	// Check if text is too long (for OpenAI, roughly estimate tokens as words/0.75)
10078	$estimated_tokens = ceil(str_word_count($text) / 0.75);
10079	//error_log('[MXCHAT-EMBED] Estimated token count: ~' . $estimated_tokens);
10080
10081	if ($estimated_tokens > 8000 && strpos($selected_model, 'voyage') === false && strpos($selected_model, 'gemini-embedding') === false) {
10082	//error_log('[MXCHAT-EMBED] Warning: Text may exceed OpenAI token limits (8K for most models)');
10083	// Consider truncating text here
10084	}
10085
10086	// Prepare request body based on provider
10087	if (strpos($selected_model, 'gemini-embedding') === 0) {
10088	// Gemini API format
10089	$request_body = array(
10090	'model' => 'models/' . $selected_model,
10091	'content' => array(
10092	'parts' => array(
10093	array('text' => $text)
10094	)
10095	)
10096	);
10097
10098	// Set output dimensionality to 1536 for consistency with other models
10099	$request_body['outputDimensionality'] = 1536;
10100	} else {
10101	// OpenAI/Voyage API format
10102	$request_body = array(
10103	'model' => $selected_model,
10104	'input' => $text
10105	);
10106
10107	// Add output_dimension for voyage-3-large model
10108	if ($selected_model === 'voyage-3-large') {
10109	$request_body['output_dimension'] = 2048;
10110	}
10111	}
10112
10113	//error_log('[MXCHAT-EMBED] Request prepared with model: ' . $selected_model);
10114
10115	// Prepare headers based on provider
10116	if (strpos($selected_model, 'gemini-embedding') === 0) {
10117	// Gemini uses API key as query parameter
10118	$endpoint .= '?key=' . $api_key;
10119	$headers = array(
10120	'Content-Type' => 'application/json'
10121	);
10122	} else {
10123	// OpenAI/Voyage use Bearer token
10124	$headers = array(
10125	'Authorization' => 'Bearer ' . $api_key,
10126	'Content-Type' => 'application/json'
10127	);
10128	}
10129
10130	// Make API request
10131	//error_log('[MXCHAT-EMBED] Sending API request to: ' . $endpoint);
10132	$response = wp_remote_post($endpoint, array(
10133	'body' => wp_json_encode($request_body),
10134	'headers' => $headers,
10135	'timeout' => 60 // Increased timeout for large inputs
10136	));
10137
10138	// Handle wp_remote_post errors
10139	if (is_wp_error($response)) {
10140	$error_message = $response->get_error_message();
10141	//error_log('[MXCHAT-EMBED] WP Remote Post Error: ' . $error_message);
10142	return 'Connection error: ' . $error_message;
10143	}
10144
10145	// Get and check HTTP response code
10146	$http_code = wp_remote_retrieve_response_code($response);
10147	//error_log('[MXCHAT-EMBED] API Response Code: ' . $http_code);
10148
10149	if ($http_code !== 200) {
10150	$error_body = wp_remote_retrieve_body($response);
10151	//error_log('[MXCHAT-EMBED] API Error Response Body: ' . $error_body);
10152
10153	// Try to parse error for more details
10154	$error_json = json_decode($error_body, true);
10155	if (json_last_error() === JSON_ERROR_NONE && isset($error_json['error'])) {
10156	$error_type = $error_json['error']['type'] ?? 'unknown';
10157	$error_message = $error_json['error']['message'] ?? 'No message';
10158	//error_log('[MXCHAT-EMBED] API Error Type: ' . $error_type);
10159	//error_log('[MXCHAT-EMBED] API Error Message: ' . $error_message);
10160
10161	// Customize error message for common API errors
10162	if ($error_type === 'invalid_request_error' && strpos($error_message, 'API key') !== false) {
10163	$error_message = sprintf('Invalid %s API key. Please check your API key in the MxChat settings.', $provider_name);
10164	} elseif ($error_type === 'authentication_error') {
10165	$error_message = sprintf('%s authentication failed. Please verify your API key in the MxChat settings.', $provider_name);
10166	}
10167
10168	//error_log('[MXCHAT-EMBED] Returning error: ' . $error_message);
10169	return $error_message;
10170	}
10171
10172	$error_message = sprintf("API Error (HTTP %d): Unable to generate embedding", $http_code);
10173	//error_log('[MXCHAT-EMBED] Returning error: ' . $error_message);
10174	return $error_message;
10175	}
10176
10177	// Parse response body
10178	$response_body = wp_remote_retrieve_body($response);
10179	//error_log('[MXCHAT-EMBED] Received response length: ' . strlen($response_body) . ' bytes');
10180
10181	$response_data = json_decode($response_body, true);
10182
10183	if (json_last_error() !== JSON_ERROR_NONE) {
10184	$error = json_last_error_msg();
10185	//error_log('[MXCHAT-EMBED] JSON Parse Error: ' . $error);
10186	//error_log('[MXCHAT-EMBED] Response preview: ' . substr($response_body, 0, 200));
10187	return "Failed to parse API response: $error";
10188	}
10189
10190	// Handle different response formats based on provider
10191	if (strpos($selected_model, 'gemini-embedding') === 0) {
10192	// Gemini API response format
10193	if (isset($response_data['embedding']['values'])) {
10194	$embedding_dimensions = count($response_data['embedding']['values']);
10195	//error_log('[MXCHAT-EMBED] Successfully extracted Gemini embedding with ' . $embedding_dimensions . ' dimensions');
10196
10197	// Check if embedding dimensions are as expected (should be 1536)
10198	if ($embedding_dimensions !== 1536) {
10199	//error_log('[MXCHAT-EMBED] Warning: Unexpected Gemini embedding dimensions: ' . $embedding_dimensions);
10200	}
10201
10202	MxChat_Utils::stamp_active_embedding_model($selected_model);
10203	return $response_data['embedding']['values'];
10204	} else {
10205	//error_log('[MXCHAT-EMBED] Error: No embedding found in Gemini response');
10206	//error_log('[MXCHAT-EMBED] Response structure: ' . wp_json_encode(array_keys($response_data)));
10207
10208	if (isset($response_data['error'])) {
10209	$error_message = "Gemini API Error in response: " . wp_json_encode($response_data['error']);
10210	//error_log('[MXCHAT-EMBED] ' . $error_message);
10211	return $error_message;
10212	}
10213
10214	$error_message = "Invalid Gemini API response format: No embedding found";
10215	//error_log('[MXCHAT-EMBED] ' . $error_message);
10216	return $error_message;
10217	}
10218	} else {
10219	// OpenAI/Voyage API response format
10220	if (isset($response_data['data'][0]['embedding'])) {
10221	$embedding_dimensions = count($response_data['data'][0]['embedding']);
10222	//error_log('[MXCHAT-EMBED] Successfully extracted embedding with ' . $embedding_dimensions . ' dimensions');
10223
10224	// Check if embedding dimensions are as expected
10225	if (($selected_model === 'text-embedding-ada-002' && $embedding_dimensions !== 1536) \|\|
10226	($selected_model === 'voyage-3-large' && $embedding_dimensions !== 2048)) {
10227	//error_log('[MXCHAT-EMBED] Warning: Unexpected embedding dimensions');
10228	}
10229
10230	MxChat_Utils::stamp_active_embedding_model($selected_model);
10231	return $response_data['data'][0]['embedding'];
10232	} else {
10233	//error_log('[MXCHAT-EMBED] Error: No embedding found in response');
10234	//error_log('[MXCHAT-EMBED] Response structure: ' . wp_json_encode(array_keys($response_data)));
10235
10236	if (isset($response_data['error'])) {
10237	$error_message = "API Error in response: " . wp_json_encode($response_data['error']);
10238	//error_log('[MXCHAT-EMBED] ' . $error_message);
10239	return $error_message;
10240	}
10241
10242	$error_message = "Invalid API response format: No embedding found";
10243	//error_log('[MXCHAT-EMBED] ' . $error_message);
10244	return $error_message;
10245	}
10246	}
10247	}
10248
10249
10250
10251	}
10252	?>
10253