__('AI Chat Analytics', 'ai-eshop-optimizer'),
'description' => __('See exactly what your shoppers asked the AI assistant and how it answered, how happy they were, which pages drive chats, where the catalogue had gaps, and whether those chats led to orders.', 'ai-eshop-optimizer'),
'bullets' => array(
__('Full, searchable conversation log with happiness ratings', 'ai-eshop-optimizer'),
__('Volume + happiness trends, logged-in vs guest', 'ai-eshop-optimizer'),
__('Which pages shoppers start chats from (via the Session Tracker)', 'ai-eshop-optimizer'),
__('Catalogue gaps — questions that surfaced no products', 'ai-eshop-optimizer'),
__('Chat-assisted conversions + revenue', 'ai-eshop-optimizer'),
),
);
}
public function register_hooks() {
if (!class_exists('AIEO_Chat_Analytics') && defined('AIEO_DIR') && file_exists(AIEO_DIR . 'includes/dmm/chat-analytics/class-aieo-chat-analytics.php')) {
require_once AIEO_DIR . 'includes/dmm/chat-analytics/class-aieo-chat-analytics.php';
}
if (class_exists('AIEO_Chat_Analytics')) {
add_action(AIEO_Chat_Analytics::STATS_REFRESH_HOOK, array('AIEO_Chat_Analytics', 'refresh_stats_cache'));
}
add_action('wp_ajax_aieo_chat_analytics_refresh_stats', array($this, 'ajax_refresh_stats'));
add_action('wp_ajax_aieo_chat_analytics_stats_cadence', array($this, 'ajax_save_stats_cadence'));
add_action('wp_ajax_aieo_chat_analytics_save_retention', array($this, 'ajax_save_retention'));
add_filter('cron_schedules', array($this, 'ensure_cron_schedules'));
add_action('admin_init', array($this, 'maybe_schedule_stats'));
add_action('admin_init', array($this, 'ensure_chat_schema'));
}
public function ensure_chat_schema() {
if (class_exists('AI_eShop_Chat_Database_Manager') && method_exists('AI_eShop_Chat_Database_Manager', 'ensure_chat_history_columns')) {
AI_eShop_Chat_Database_Manager::ensure_chat_history_columns();
}
}
public function enqueue_admin_assets() {
$nonce = wp_create_nonce(self::NONCE);
wp_register_script('aieo-cac-admin', false, array('jquery'), defined('AIEO_VERSION') ? AIEO_VERSION : '1', true);
wp_enqueue_script('aieo-cac-admin');
$js = 'jQuery(function($){var n="' . esc_js($nonce) . '",u=window.ajaxurl,job=document.getElementById("aieo-cac-refresh-job");'
. 'function st(o){var s=window.roosterAdmin&&window.roosterAdmin.states;if(s&&job){s.job(job,o);}}'
. 'function refresh(){st({state:"running",value:0});$.post(u,{action:"aieo_chat_analytics_refresh_stats",nonce:n},function(r){if(r&&r.success){location.reload();}else{st({state:"failed",error:(r&&r.data&&r.data.message)||""});}}).fail(function(){st({state:"failed",error:""});});}'
. '$("#aieo-cac-refresh").on("click",refresh);'
. 'document.addEventListener("rooster-admin:save",function(e){var c=e.target;if(!c||"aieo-cac-cadence"!==c.id||!e.detail||"function"!==typeof e.detail.respondWith){return;}'
. 'e.detail.respondWith(function(){return fetch(u,{method:"POST",credentials:"same-origin",headers:{"Content-Type":"application/x-www-form-urlencoded; charset=UTF-8"},body:e.detail.body.toString()}).then(function(r){return r.json();}).then(function(j){if(!j||!j.success){throw new Error((j&&j.data&&j.data.message)||"");}return {saved:true};});});});'
. 'if(job&&"running"===job.getAttribute("data-ra-job")){refresh();}'
. '});';
wp_add_inline_script('aieo-cac-admin', $js);
}
private static function get_settings() {
$s = get_option(self::SETTINGS_OPTION, array());
return is_array($s) ? $s : array();
}
public static function get_stats_cadence() {
$s = self::get_settings();
$c = isset($s['stats_refresh']) ? (string) $s['stats_refresh'] : 'daily';
return in_array($c, self::STATS_CADENCES, true) ? $c : 'daily';
}
public function ensure_cron_schedules($schedules) {
if (!is_array($schedules)) { $schedules = array(); }
if (!isset($schedules['weekly'])) {
$schedules['weekly'] = array('interval' => 7 * DAY_IN_SECONDS, 'display' => __('Once Weekly', 'ai-eshop-optimizer'));
}
if (!isset($schedules['monthly'])) {
$schedules['monthly'] = array('interval' => 30 * DAY_IN_SECONDS, 'display' => __('Once Monthly', 'ai-eshop-optimizer'));
}
return $schedules;
}
public function maybe_schedule_stats() {
if (!class_exists('AIEO_Chat_Analytics')) { return; }
$hook = AIEO_Chat_Analytics::STATS_REFRESH_HOOK;
$current = wp_get_schedule($hook);
$cadence = self::get_stats_cadence();
if ('off' === $cadence || !$this->table_exists($this->chat_table())) {
if (false !== $current) { wp_clear_scheduled_hook($hook); }
return;
}
if ($current === $cadence) { return; }
if (false !== $current) { wp_clear_scheduled_hook($hook); }
wp_schedule_event(time() + 300, $cadence, $hook);
}
public function ajax_refresh_stats() {
if (!check_ajax_referer(self::NONCE, 'nonce', false)) { wp_send_json_error(array('message' => __('Security check failed.', 'ai-eshop-optimizer'))); }
if (!current_user_can('edit_posts') || !class_exists('AIEO_Chat_Analytics')) { wp_send_json_error(array('message' => __('Not allowed.', 'ai-eshop-optimizer'))); }
$payload = AIEO_Chat_Analytics::refresh_stats_cache();
wp_send_json_success(array('generated_at' => $payload['generated_at']));
}
public function ajax_save_stats_cadence() {
if (!check_ajax_referer(self::NONCE, 'nonce', false)) { wp_send_json_error(array('message' => __('Security check failed.', 'ai-eshop-optimizer'))); }
if (!current_user_can('edit_posts')) { wp_send_json_error(array('message' => __('Not allowed.', 'ai-eshop-optimizer'))); }
$cadence = isset($_POST['cadence']) ? sanitize_key(wp_unslash($_POST['cadence'])) : 'daily';
if (!in_array($cadence, self::STATS_CADENCES, true)) { $cadence = 'daily'; }
$s = self::get_settings();
$s['stats_refresh'] = $cadence;
update_option(self::SETTINGS_OPTION, $s, false);
$this->maybe_schedule_stats();
wp_send_json_success(array('cadence' => $cadence));
}
public function ajax_save_retention() {
if (!check_ajax_referer(self::NONCE, 'nonce', false)) { wp_send_json_error(array('message' => __('Security check failed.', 'ai-eshop-optimizer'))); }
if (!current_user_can('edit_posts')) { wp_send_json_error(array('message' => __('Not allowed.', 'ai-eshop-optimizer'))); }
$days = isset($_POST['days']) ? (int) wp_unslash($_POST['days']) : 0;
$days = max(1, min(3650, $days));
update_option('aieo_chat_retention_days', $days, false);
wp_send_json_success(array('days' => $days));
}
public function get_tab_arg() { return 'cac_section'; }
public function get_tabs() {
return array(
'overview' => array('label' => __('Overview', 'ai-eshop-optimizer'), 'icon' => 'layout-dashboard'),
'conversations' => array('label' => __('Conversations', 'ai-eshop-optimizer'), 'icon' => 'messages-square'),
'happiness' => array('label' => __('Happiness', 'ai-eshop-optimizer'), 'icon' => 'star'),
'origins' => array('label' => __('Page origins', 'ai-eshop-optimizer'), 'icon' => 'door-open'),
'products' => array('label' => __('Products and gaps', 'ai-eshop-optimizer'), 'icon' => 'package'),
'conversions' => array('label' => __('Conversions', 'ai-eshop-optimizer'), 'icon' => 'target'),
);
}
public function render_subtab() {
$h = $this->chat_table();
if (!$this->table_exists($h)) {
$close = $this->card_open(array(
'anchor' => 'ai-chat-analytics-conversations',
'icon' => 'messages-square',
'title' => __('Conversations', 'ai-eshop-optimizer'),
'description' => __('Every chat a shopper had with the AI assistant, with filters to find one and open its full transcript.', 'ai-eshop-optimizer'),
));
$this->state_of('not-set-up', array(
'feature' => $this->get_label(),
'text' => __('No chat history yet — the table installs when the AI chat is set up. Once shoppers start chatting, their conversations appear here.', 'ai-eshop-optimizer'),
));
echo $close;
return;
}
$base = add_query_arg(array('page' => AIEO_DMM::MENU_SLUG, 'dmm_tab' => $this->get_id()), admin_url('admin.php'));
$sections = $this->get_tabs();
$section = isset($_GET['cac_section']) ? sanitize_key(wp_unslash($_GET['cac_section'])) : 'overview';
if (!isset($sections[$section])) { $section = 'overview'; }
AIEO_DMM_UI::tab_strip($this->get_id(), $sections, $section, array(
'arg' => $this->get_tab_arg(), 'base' => $base,
));
$logging = get_option('aieo_chat_history_enabled', '1');
if ($logging !== '1' && $logging !== 1) {
if (class_exists('\Rooster\Admin\States')) {
echo \Rooster\Admin\States::off_notice(
__('Chat history logging', 'ai-eshop-optimizer'),
__('Chat history logging is currently OFF, so new conversations are not being recorded. Existing data is shown below.', 'ai-eshop-optimizer')
);
} else {
echo '
' . esc_html__('Chat history logging is currently OFF, so new conversations are not being recorded. Existing data is shown below.', 'ai-eshop-optimizer') . '
';
}
}
$this->band_open(array('cols' => 'overview' === $section ? 2 : 1));
switch ($section) {
case 'conversations': $this->render_conversations($base, $h); break;
case 'happiness': $this->render_happiness($base, $h); break;
case 'origins': $this->render_origins($base, $h); break;
case 'products': $this->render_products($base, $h); break;
case 'conversions': $this->render_conversions($base, $h); break;
case 'overview':
default: $this->render_overview($base, $h); break;
}
$this->band_close();
}
private function render_overview($base, $h) {
$cache = class_exists('AIEO_Chat_Analytics') ? AIEO_Chat_Analytics::get_cached_stats() : null;
$ov = ($cache && isset($cache['overview'])) ? (array) $cache['overview'] : null;
$gen = ($cache && !empty($cache['generated_at'])) ? (string) $cache['generated_at'] : '';
if (!$ov) {
$close = $this->card_open(array(
'anchor' => 'ai-chat-analytics-overview-3',
'icon' => 'hash',
'title' => __('Key chat figures', 'ai-eshop-optimizer'),
'col' => 1,
));
$this->render_cache_controls($gen, __('Preparing analytics… this runs in the background and can take a few seconds the first time. The panel refreshes automatically when it’s ready.', 'ai-eshop-optimizer'));
echo $close;
$this->render_retention_card();
return;
}
$close = $this->card_open(array(
'anchor' => 'ai-chat-analytics-overview-3',
'icon' => 'hash',
'title' => __('Key chat figures', 'ai-eshop-optimizer'),
'description' => __('Reads the cached stats build: messages, conversations and sessions, average happiness out of 100, answers that returned no products, and tokens in and out per message.', 'ai-eshop-optimizer'),
'col' => 1,
));
$this->render_cache_controls($gen);
if ((int) $ov['turns'] <= 0) {
$this->no_chats();
echo $close;
$this->render_trend_card(array(), 0);
$this->render_retention_card();
return;
}
echo '