<?php
/**
 * Plugin Name:       ELIA Assistant
 * Plugin URI:        https://elia-assistant.com
 * Description:       ELIA Assistant AI chatbot answers your visitors 24/7. With WooCommerce, it also answers questions about your products, prices and stock.
 * Version:           1.0.0
 * Author:            ELIA
 * Author URI:        https://elia.sk
 * License:           GPL-2.0-or-later
 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain:       elia-assistant
 * Requires at least: 5.9
 * Requires PHP:      7.4
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

define( 'ELIA_ASSISTANT_VERSION', '1.0.0' );

// The ELIA environment the plugin talks to. Production by default; a test site can point at
// staging from wp-config.php, before the plugin loads:
//   define( 'ELIA_ASSISTANT_APP_URL', 'https://app-stage.elia-assistant.com' );
//   define( 'ELIA_ASSISTANT_API_URL', 'https://api-stage.elia-assistant.com/api' );
// The widget id and widget.js must come from the same environment.
if ( ! defined( 'ELIA_ASSISTANT_APP_URL' ) ) {
    define( 'ELIA_ASSISTANT_APP_URL', 'https://app.elia-assistant.com' );
}
if ( ! defined( 'ELIA_ASSISTANT_API_URL' ) ) {
    define( 'ELIA_ASSISTANT_API_URL', 'https://api.elia-assistant.com/api' );
}
define( 'ELIA_ASSISTANT_CDN',    untrailingslashit( ELIA_ASSISTANT_APP_URL ) . '/widget.js' );
define( 'ELIA_ASSISTANT_OPTION', 'elia_assistant_options' );

// Kept in its own option, not inside ELIA_ASSISTANT_OPTION: elia_assistant_sanitize() rebuilds
// its array from scratch and would drop anything it does not list explicitly.
define( 'ELIA_ASSISTANT_WC_OPTION',    'elia_assistant_wc_key' );
define( 'ELIA_ASSISTANT_DASHBOARD_URL', untrailingslashit( ELIA_ASSISTANT_APP_URL ) . '/config' );

// Set from the uninstall dialog on the Plugins screen and read by uninstall.php.
define( 'ELIA_ASSISTANT_KEEP_DATA_OPTION', 'elia_assistant_keep_data' );

// Per-user flag: the "connect your account" notice on the Plugins screen was dismissed.
define( 'ELIA_ASSISTANT_NOTICE_META', 'elia_assistant_notice_dismissed' );

// ─── Themes (used for shortcode theme-override validation) ────────────────────

function elia_assistant_themes(): array {
    return [
        'midnight'   => [ 'label' => 'Midnight',    'base' => '#0f1117', 'accent' => '#6366f1' ],
        'monoDark'   => [ 'label' => 'Mono Dark',   'base' => '#09090b', 'accent' => '#fafafa' ],
        'forest'     => [ 'label' => 'Forest',      'base' => '#1b362c', 'accent' => '#22c55e' ],
        'cherry'     => [ 'label' => 'Cherry',      'base' => '#ffffff', 'accent' => '#ef4444' ],
        'cherryDark' => [ 'label' => 'Cherry Dark', 'base' => '#440b19', 'accent' => '#ef4444' ],
        'slate'      => [ 'label' => 'Slate',       'base' => '#334155', 'accent' => '#38bdf8' ],
        'amber'      => [ 'label' => 'Amber',       'base' => '#3d2c15', 'accent' => '#f59e0b' ],
        'sunrise'    => [ 'label' => 'Sunrise',     'base' => '#ffffff', 'accent' => '#f97316' ],
        'ivory'      => [ 'label' => 'Ivory',       'base' => '#f1ede5', 'accent' => '#e08229' ],
        'sky'        => [ 'label' => 'Sky',         'base' => '#ffffff', 'accent' => '#5ba1da' ],
        'lavender'   => [ 'label' => 'Lavender',    'base' => '#faf5ff', 'accent' => '#8b5cf6' ],
        'nice'       => [ 'label' => 'Nice',        'base' => '#ffffff', 'accent' => '#3f7e83' ],
        'navy'       => [ 'label' => 'Navy',        'base' => '#ebf3f2', 'accent' => '#bed6dd' ],
        'graphite'   => [ 'label' => 'Graphite',    'base' => '#313949', 'accent' => '#4185eb' ],
        'stone'      => [ 'label' => 'Stone',       'base' => '#44403c', 'accent' => '#fbbf24' ],
        'olive'      => [ 'label' => 'Olive',       'base' => '#2e3220', 'accent' => '#a3b14b' ],
        'mint'       => [ 'label' => 'Mint',        'base' => '#f4fbf7', 'accent' => '#0f9d63' ],
        'rose'       => [ 'label' => 'Rose',        'base' => '#fff7f9', 'accent' => '#db2777' ],
        'linen'      => [ 'label' => 'Linen',       'base' => '#fcfbf8', 'accent' => '#d6e6e0' ],
        'mono'       => [ 'label' => 'Mono',        'base' => '#ffffff', 'accent' => '#18181b' ],
    ];
}

// ─── Defaults ────────────────────────────────────────────────────────────────

function elia_assistant_defaults(): array {
    return [
        'widget_id'                => '',
        'enabled'                  => '1',
        'show_floating'            => '1',
        'language_override_enabled' => '0',
        'language_override'        => '',
        'is_test'                  => '0',
    ];
}

// ─── Sanitize ─────────────────────────────────────────────────────────────────

function elia_assistant_sanitize( $raw ): array {
    $out = [];

    // options.php has already verified the settings nonce before it calls this sanitize callback.
    // phpcs:ignore WordPress.Security.NonceVerification.Missing
    $disconnect = ! empty( $_POST['ec_disconnect'] );

    $widget_id = strtolower( trim( sanitize_text_field( $raw['widget_id'] ?? '' ) ) );
    if ( $disconnect ) {
        $widget_id = '';
    } elseif ( $widget_id !== '' && ! elia_assistant_is_widget_id( $widget_id ) ) {
        add_settings_error(
            ELIA_ASSISTANT_OPTION,
            'elia_assistant_widget_id',
            __( 'This is not a widget ID. Copy it again from the WordPress card in the ELIA Assistant dashboard.', 'elia-assistant' )
        );
        // Keep the ID that worked rather than replacing it with a typo.
        $widget_id = elia_assistant_widget_id( (array) get_option( ELIA_ASSISTANT_OPTION, [] ) );
    }
    $out['widget_id'] = $widget_id;
    $out['enabled']   = empty( $raw['enabled'] ) ? '0' : '1';
    $out['show_floating']             = empty( $raw['show_floating'] ) ? '0' : '1';
    $language                         = sanitize_key( $raw['language_override'] ?? '' );
    $out['language_override']         = array_key_exists( $language, elia_assistant_languages() ) ? $language : '';
    $out['language_override_enabled'] = ! empty( $raw['language_override_enabled'] ) && $out['language_override'] !== '' ? '1' : '0';
    $out['is_test']                   = empty( $raw['is_test'] ) ? '0' : '1';

    return $out;
}


// ─── Widget id ────────────────────────────────────────────────────────────────

/**
 * The widget id is the id of the agent whose chat widget the site shows, copied from the WordPress
 * card in the dashboard. It is public: the dashboard's embed snippet carries the same value.
 */
function elia_assistant_is_widget_id( string $value ): bool {
    return (bool) preg_match( '/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i', $value );
}

function elia_assistant_widget_id( array $opts ): string {
    $widget_id = isset( $opts['widget_id'] ) && is_string( $opts['widget_id'] ) ? $opts['widget_id'] : '';
    return elia_assistant_is_widget_id( $widget_id ) ? $widget_id : '';
}

// ─── Language detection ───────────────────────────────────────────────────────

/**
 * Returns the 2-letter code of the language the current page is in.
 * Asks the language plugin first: WPML (whose wpml_current_language filter Polylang answers too),
 * Polylang, then Weglot, which translates the page without switching the WordPress locale. Then the
 * locale, which TranslatePress and the others switch per page. Codes like pt-br or zh_CN are cut
 * to their language part. A site with another language plugin can say which language the page is
 * in through the elia_assistant_language filter.
 */
function elia_assistant_current_language(): string {
    // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- WPML's own filter, read here, not defined by this plugin.
    $candidates = [ apply_filters( 'wpml_current_language', null ) ];
    if ( function_exists( 'pll_current_language' ) ) {
        $candidates[] = pll_current_language( 'slug' );
    }
    if ( function_exists( 'weglot_get_current_language' ) ) {
        $candidates[] = weglot_get_current_language();
    }
    $candidates[] = get_locale();

    $lang = 'en';
    foreach ( $candidates as $candidate ) {
        // WPML answers "all" in the admin when every language is listed; that is not a language.
        $code = is_string( $candidate ) ? strtolower( (string) preg_split( '/[-_]/', $candidate )[0] ) : '';
        if ( preg_match( '/^[a-z]{2}$/', $code ) ) {
            $lang = $code;
            break;
        }
    }

    $filtered = apply_filters( 'elia_assistant_language', $lang );
    return is_string( $filtered ) && preg_match( '/^[a-z]{2}$/', $filtered ) ? $filtered : $lang;
}

function elia_assistant_resolve_language( array $opts ): string {
    if ( ( $opts['language_override_enabled'] ?? '0' ) === '1' && ! empty( $opts['language_override'] ) ) {
        return $opts['language_override'];
    }
    return elia_assistant_current_language();
}

// ─── WooCommerce detection and read-only key ─────────────────────────────────

/**
 * Returns WooCommerce store info when the plugin is active, or null.
 * class_exists() is enough - by the time admin_menu runs, an active WooCommerce
 * has already loaded.
 */
function elia_assistant_woocommerce_info(): ?array {
    if ( ! class_exists( 'WooCommerce' ) ) {
        return null;
    }
    return [
        'version'   => defined( 'WC_VERSION' ) ? WC_VERSION : '',
        // The value to enter as "Store URL" in ELIA: the MCP server appends
        // /wp-json/wc/v3/, which is where WordPress mounts REST routes.
        'store_url' => home_url(),
    ];
}

function elia_assistant_wc_table(): string {
    global $wpdb;
    return $wpdb->prefix . 'woocommerce_api_keys';
}

function elia_assistant_wc_transient_key(): string {
    return 'elia_assistant_wc_new_key_' . get_current_user_id();
}

/**
 * Returns the stored key metadata, but only if the key still exists in WooCommerce.
 * Someone may have deleted it from WooCommerce → Settings → Advanced → REST API.
 */
function elia_assistant_wc_stored_key(): ?array {
    $stored = get_option( ELIA_ASSISTANT_WC_OPTION );
    if ( ! is_array( $stored ) || empty( $stored['key_id'] ) ) {
        return null;
    }

    global $wpdb;
    $table = elia_assistant_wc_table();
    // The table name is $wpdb->prefix plus a constant, so it is safe to interpolate. The lookup must
    // hit the live table (the key may have been deleted in WooCommerce), so it is not cached.
    // phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared, PluginCheck.Security.DirectDB.UnescapedDBParameter
    $row   = $wpdb->get_row(
        $wpdb->prepare( "SELECT truncated_key, permissions FROM {$table} WHERE key_id = %d", (int) $stored['key_id'] ),
        ARRAY_A
    );
    // phpcs:enable

    return $row ? array_merge( $stored, $row ) : null;
}

function elia_assistant_wc_redirect( string $notice ): void {
    // Back to the WooCommerce block, not the top of the page: the new key or the notice is there.
    wp_safe_redirect( add_query_arg(
        [ 'page' => 'elia-assistant', 'ec_wc' => $notice ],
        admin_url( 'options-general.php' )
    ) . '#elia-wc-title' );
    exit;
}

/**
 * Creates a read-only WooCommerce REST key, exactly as the WooCommerce admin screen does.
 * WooCommerce exposes no public API for this, hence the direct insert.
 * The consumer key is stored one-way hashed, so the full value only exists here - it is
 * handed to the transient for a single display and never persisted by this plugin.
 */
function elia_assistant_wc_generate(): void {
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( esc_html__( 'Insufficient permissions.', 'elia-assistant' ) );
    }
    check_admin_referer( 'elia_assistant_wc_generate' );

    if ( ! class_exists( 'WooCommerce' ) || ! function_exists( 'wc_rand_hash' ) || ! function_exists( 'wc_api_hash' ) ) {
        elia_assistant_wc_redirect( 'unavailable' );
    }

    global $wpdb;
    $table = elia_assistant_wc_table();

    // Regenerating replaces the old key rather than leaving it live.
    $previous = get_option( ELIA_ASSISTANT_WC_OPTION );
    // WooCommerce has no public API for creating or deleting REST keys, so this mirrors what its admin screen does.
    // phpcs:disable WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
    if ( is_array( $previous ) && ! empty( $previous['key_id'] ) ) {
        $wpdb->delete( $table, [ 'key_id' => (int) $previous['key_id'] ], [ '%d' ] );
    }

    $consumer_key    = 'ck_' . wc_rand_hash();
    $consumer_secret = 'cs_' . wc_rand_hash();

    $inserted = $wpdb->insert(
        $table,
        [
            'user_id'         => get_current_user_id(),
            'description'     => 'ELIA Assistant',
            'permissions'     => 'read',
            'consumer_key'    => wc_api_hash( $consumer_key ),
            'consumer_secret' => $consumer_secret,
            'truncated_key'   => substr( $consumer_key, -7 ),
        ],
        [ '%d', '%s', '%s', '%s', '%s', '%s' ]
    );
    // phpcs:enable

    if ( ! $inserted ) {
        delete_option( ELIA_ASSISTANT_WC_OPTION );
        elia_assistant_wc_redirect( 'failed' );
    }

    update_option( ELIA_ASSISTANT_WC_OPTION, [
        'key_id'    => (int) $wpdb->insert_id,
        'truncated' => substr( $consumer_key, -7 ),
        'created'   => time(),
    ], false );

    set_transient( elia_assistant_wc_transient_key(), [
        'consumer_key'    => $consumer_key,
        'consumer_secret' => $consumer_secret,
    ], 120 );

    elia_assistant_wc_redirect( 'generated' );
}

function elia_assistant_wc_revoke(): void {
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( esc_html__( 'Insufficient permissions.', 'elia-assistant' ) );
    }
    check_admin_referer( 'elia_assistant_wc_revoke' );

    $stored = get_option( ELIA_ASSISTANT_WC_OPTION );
    if ( is_array( $stored ) && ! empty( $stored['key_id'] ) ) {
        global $wpdb;
        // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
        $wpdb->delete( elia_assistant_wc_table(), [ 'key_id' => (int) $stored['key_id'] ], [ '%d' ] );
    }

    delete_option( ELIA_ASSISTANT_WC_OPTION );
    delete_transient( elia_assistant_wc_transient_key() );

    elia_assistant_wc_redirect( 'revoked' );
}

add_action( 'admin_post_elia_assistant_wc_generate', 'elia_assistant_wc_generate' );
add_action( 'admin_post_elia_assistant_wc_revoke',   'elia_assistant_wc_revoke' );

// ─── Remote config fetch ─────────────────────────────────────────────────────

/**
 * Fetch the widget's saved config from the ELIA API, for the preview on the settings page. The site
 * does not need it: widget.js loads the config by widget id in the visitor's browser.
 * Returns the decoded response array on success, an array with '_status'=>'not_found' on HTTP 404
 * (no widget with this id, or it was never saved), or null on error / no widget id.
 * Not cached: it runs once each time the settings page opens, so the preview is always current.
 */
function elia_assistant_fetch_remote_config(): ?array {
    $opts      = array_merge( elia_assistant_defaults(), (array) get_option( ELIA_ASSISTANT_OPTION, [] ) );
    $widget_id = elia_assistant_widget_id( $opts );
    if ( $widget_id === '' ) {
        return null;
    }

    $api_url  = untrailingslashit( ELIA_ASSISTANT_API_URL ) . '/public/chat-widget/' . rawurlencode( $widget_id );
    $response = wp_remote_get( $api_url, [ 'timeout' => 10 ] );

    if ( is_wp_error( $response ) ) {
        return null;
    }

    $code = (int) wp_remote_retrieve_response_code( $response );

    if ( $code === 404 ) {
        return [ '_status' => 'not_found' ];
    }

    if ( $code !== 200 ) {
        return null;
    }

    $body = json_decode( wp_remote_retrieve_body( $response ), true );
    if ( ! is_array( $body ) || ! isset( $body['config'] ) || ! is_array( $body['config'] ) ) {
        return null;
    }

    return $body;
}

// ─── Admin: helpers ───────────────────────────────────────────────────────────

/**
 * Languages the chat widget ships translations for, with their own names.
 */
function elia_assistant_languages(): array {
    return [
        'bg' => 'Български',
        'cs' => 'Čeština',
        'da' => 'Dansk',
        'de' => 'Deutsch',
        'el' => 'Ελληνικά',
        'en' => 'English',
        'es' => 'Español',
        'et' => 'Eesti',
        'fi' => 'Suomi',
        'fr' => 'Français',
        'hr' => 'Hrvatski',
        'hu' => 'Magyar',
        'it' => 'Italiano',
        'lt' => 'Lietuvių',
        'lv' => 'Latviešu',
        'nl' => 'Nederlands',
        'pl' => 'Polski',
        'pt' => 'Português',
        'ro' => 'Română',
        'ru' => 'Русский',
        'sk' => 'Slovenčina',
        'sl' => 'Slovenščina',
        'sv' => 'Svenska',
        'uk' => 'Українська',
    ];
}

/**
 * Reads a text the dashboard may store per language (config.i18n[lang][key]) or globally.
 */
function elia_assistant_config_text( array $config, string $key, string $lang ): string {
    $i18n = isset( $config['i18n'] ) && is_array( $config['i18n'] ) ? $config['i18n'] : [];
    foreach ( [ $lang, 'en' ] as $code ) {
        if ( isset( $i18n[ $code ][ $key ] ) && is_string( $i18n[ $code ][ $key ] ) && trim( $i18n[ $code ][ $key ] ) !== '' ) {
            return trim( $i18n[ $code ][ $key ] );
        }
    }
    if ( isset( $config[ $key ] ) && is_string( $config[ $key ] ) ) {
        return trim( $config[ $key ] );
    }
    return '';
}

/**
 * Picks dark or light text for a background colour, so the preview bubble stays readable on every theme.
 */
function elia_assistant_text_on( string $hex ): string {
    $hex = ltrim( $hex, '#' );
    if ( strlen( $hex ) !== 6 ) {
        return '#1d2327';
    }
    [ $r, $g, $b ] = array_map( 'hexdec', str_split( $hex, 2 ) );
    return ( 0.299 * $r + 0.587 * $g + 0.114 * $b ) > 150 ? '#1d2327' : '#ffffff';
}

function elia_assistant_mode_label( string $mode ): string {
    switch ( $mode ) {
        case 'fullscreen':
            return __( 'opens full screen', 'elia-assistant' );
        case 'mixed':
            return __( 'chat window that can expand to full screen', 'elia-assistant' );
        default:
            return __( 'chat window in the corner', 'elia-assistant' );
    }
}

/**
 * The ELIA mark (frontend/public/favicon.svg) with its transforms flattened, drawn inline so nothing
 * is loaded from outside.
 */
function elia_assistant_mark(): string {
    return '<svg class="elia-mark" viewBox="0 0 48 46" width="28" height="27" aria-hidden="true" focusable="false"><g fill="#db3328">'
        . '<rect x="5.59" y="4.78" width="8.29" height="1.69"/><rect x="5.59" y="8.94" width="8.29" height="2.81"/>'
        . '<rect x="5.59" y="14.23" width="8.29" height="3.94"/><rect x="5.59" y="20.18" width="8.29" height="5.63"/>'
        . '<rect x="5.59" y="27.83" width="8.29" height="3.94"/><rect x="5.59" y="34.24" width="8.29" height="2.81"/>'
        . '<rect x="5.59" y="39.53" width="8.29" height="1.69"/>'
        . '<rect x="19.85" y="0" width="8.29" height="1.13"/><rect x="19.85" y="4.14" width="8.29" height="1.69"/>'
        . '<rect x="19.85" y="8.94" width="8.29" height="2.81"/><rect x="19.85" y="14.23" width="8.29" height="3.94"/>'
        . '<rect x="19.85" y="20.18" width="8.29" height="5.63"/><rect x="19.85" y="27.83" width="8.29" height="3.94"/>'
        . '<rect x="19.85" y="34.24" width="8.29" height="2.81"/><rect x="19.85" y="40.17" width="8.29" height="1.69"/>'
        . '<rect x="19.85" y="44.87" width="8.29" height="1.13"/>'
        . '<rect x="34.11" y="4.78" width="8.29" height="1.69"/><rect x="34.11" y="8.94" width="8.29" height="2.81"/>'
        . '<rect x="34.11" y="14.23" width="8.29" height="3.94"/><rect x="34.11" y="20.18" width="8.29" height="5.63"/>'
        . '<rect x="34.11" y="27.83" width="8.29" height="3.94"/><rect x="34.11" y="34.24" width="8.29" height="2.81"/>'
        . '<rect x="34.11" y="39.53" width="8.29" height="1.69"/></g></svg>';
}

/**
 * Save and Discard for a block whose changes are saved only when the admin is happy with them
 * (data-elia-manual). admin.js shows it once something in the block differs from what is saved;
 * without JS it stays hidden and the form's own Save changes button is shown instead.
 */
function elia_assistant_block_save_bar(): void {
    ?>
    <div class="elia-block-save" data-elia-block-save hidden>
        <button type="button" class="button button-primary" data-elia-save><?php esc_html_e( 'Save changes', 'elia-assistant' ); ?></button>
        <button type="button" class="button-link" data-elia-discard><?php esc_html_e( 'Discard changes', 'elia-assistant' ); ?></button>
    </div>
    <?php
}

function elia_assistant_external_link( string $url, string $label, string $class = 'button' ): string {
    return sprintf(
        '<a class="%1$s" href="%2$s" target="_blank" rel="noopener noreferrer">%3$s<span class="screen-reader-text"> %4$s</span><span class="dashicons dashicons-external" aria-hidden="true"></span></a>',
        esc_attr( $class ),
        esc_url( $url ),
        esc_html( $label ),
        esc_html__( '(opens in a new tab)', 'elia-assistant' )
    );
}

// ─── Admin: settings page ─────────────────────────────────────────────────────

add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), function ( array $links ): array {
    array_unshift( $links, sprintf(
        '<a href="%s">%s</a>',
        esc_url( admin_url( 'options-general.php?page=elia-assistant' ) ),
        esc_html__( 'Settings', 'elia-assistant' )
    ) );
    return $links;
} );

/**
 * Right after activation the site shows no chat until a widget ID is entered. Say so on the
 * Plugins screen, where the person who just activated the plugin is looking. The notice can be
 * dismissed; the choice is remembered per user and the notice also goes away once an ID is saved.
 */
add_action( 'admin_notices', function () {
    $screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
    if ( ! $screen || $screen->id !== 'plugins' || ! current_user_can( 'manage_options' ) ) {
        return;
    }
    $opts = (array) get_option( ELIA_ASSISTANT_OPTION, [] );
    if ( elia_assistant_widget_id( $opts ) !== '' || get_user_meta( get_current_user_id(), ELIA_ASSISTANT_NOTICE_META, true ) ) {
        return;
    }
    printf(
        '<div class="notice notice-info is-dismissible elia-assistant-connect-notice"><p><strong>%1$s</strong> %2$s <a href="%3$s">%4$s</a></p></div>',
        esc_html__( 'ELIA Assistant is almost ready.', 'elia-assistant' ),
        esc_html__( 'Enter your widget ID to show the chat on your site.', 'elia-assistant' ),
        esc_url( admin_url( 'options-general.php?page=elia-assistant' ) ),
        esc_html__( 'Connect now', 'elia-assistant' )
    );

    // WordPress only hides a dismissed notice; remember the choice so it stays hidden.
    wp_register_script( 'elia-assistant-notice', false, [], ELIA_ASSISTANT_VERSION, true );
    wp_enqueue_script( 'elia-assistant-notice' );
    wp_add_inline_script(
        'elia-assistant-notice',
        sprintf(
            'document.addEventListener("click", function (e) {'
            . 'if (!e.target.closest || !e.target.closest(".elia-assistant-connect-notice .notice-dismiss")) { return; }'
            . 'fetch(%1$s, { method: "POST", credentials: "same-origin", body: new URLSearchParams({ action: "elia_assistant_dismiss_notice", _ajax_nonce: %2$s }) });'
            . '});',
            wp_json_encode( admin_url( 'admin-ajax.php' ) ),
            wp_json_encode( wp_create_nonce( 'elia_assistant_dismiss_notice' ) )
        )
    );
} );

add_action( 'wp_ajax_elia_assistant_dismiss_notice', function () {
    check_ajax_referer( 'elia_assistant_dismiss_notice' );
    if ( ! current_user_can( 'manage_options' ) ) {
        wp_send_json_error( null, 403 );
    }
    update_user_meta( get_current_user_id(), ELIA_ASSISTANT_NOTICE_META, '1' );
    wp_send_json_success();
} );

add_action( 'admin_menu', function () {
    add_options_page(
        __( 'ELIA Assistant', 'elia-assistant' ),
        __( 'ELIA Assistant', 'elia-assistant' ),
        'manage_options',
        'elia-assistant',
        'elia_assistant_render_settings_page'
    );
} );

add_action( 'admin_init', function () {
    register_setting( 'elia_assistant', ELIA_ASSISTANT_OPTION, [
        'sanitize_callback' => 'elia_assistant_sanitize',
    ] );
} );

add_action( 'admin_enqueue_scripts', function ( string $hook ) {
    if ( $hook !== 'settings_page_elia-assistant' ) {
        return;
    }
    $base = plugin_dir_url( __FILE__ ) . 'admin/';
    wp_enqueue_style( 'elia-assistant-admin', $base . 'admin.css', [ 'dashicons' ], ELIA_ASSISTANT_VERSION );
    wp_enqueue_script( 'elia-assistant-admin', $base . 'admin.js', [], ELIA_ASSISTANT_VERSION, true );
    wp_localize_script( 'elia-assistant-admin', 'eliaAssistantAdmin', [
        'copied'     => __( 'Copied', 'elia-assistant' ),
        'copyFailed' => __( 'Press Ctrl+C to copy', 'elia-assistant' ),
        'saving'     => __( 'Saving…', 'elia-assistant' ),
        'saved'      => __( 'Saved', 'elia-assistant' ),
        'saveFailed' => __( 'Could not save. Check your connection and try again.', 'elia-assistant' ),
    ] );
} );

function elia_assistant_render_settings_page(): void {
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }

    $opts    = array_merge( elia_assistant_defaults(), (array) get_option( ELIA_ASSISTANT_OPTION, [] ) );
    $has_id = elia_assistant_widget_id( $opts ) !== '';
    $remote = $has_id ? elia_assistant_fetch_remote_config() : null;

    if ( ! $has_id ) {
        $state = 'disconnected';
    } elseif ( $remote === null ) {
        $state = 'error';
    } elseif ( isset( $remote['_status'] ) ) {
        $state = 'not_found';
    } else {
        $state = 'connected';
    }

    $statuses = [
        'disconnected' => [ 'neutral', __( 'Not connected', 'elia-assistant' ) ],
        'error'        => [ 'warning', __( 'Preview unavailable', 'elia-assistant' ) ],
        'not_found'    => [ 'error', __( 'Widget not found', 'elia-assistant' ) ],
        'connected'    => [ 'ok', __( 'Connected', 'elia-assistant' ) ],
    ];

    $languages     = elia_assistant_languages();
    $detected      = elia_assistant_current_language();
    $detected_name = $languages[ $detected ] ?? $detected;
    $manual_lang   = $opts['language_override_enabled'] === '1' && isset( $languages[ $opts['language_override'] ] );
    $floating      = $opts['show_floating'] !== '0';
    $themes        = elia_assistant_themes();
    $is_test       = $opts['is_test'] === '1';
    $enabled       = $opts['enabled'] !== '0';
    ?>
    <div class="wrap elia-admin">

        <div class="elia-head">
            <div class="elia-head-text">
                <h1 class="elia-title"><?php echo elia_assistant_mark(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static SVG ?><?php esc_html_e( 'ELIA Assistant', 'elia-assistant' ); ?></h1>
                <p class="elia-lede"><?php esc_html_e( 'An AI assistant that answers your visitors\' questions in a chat on your site, day and night.', 'elia-assistant' ); ?></p>
            </div>
            <?php echo elia_assistant_external_link( ELIA_ASSISTANT_DASHBOARD_URL, __( 'ELIA Assistant dashboard', 'elia-assistant' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside ?>
        </div>
        <hr class="wp-header-end">

        <?php // The two switches save as soon as they change; the placement and language blocks have their own Save (admin.js). The widget ID and the buttons in step 1 submit the form. ?>
        <form method="post" action="options.php" class="elia-form" data-elia-autosave>
            <?php settings_fields( 'elia_assistant' ); ?>
            <?php // Enter in the widget ID field submits with the form's first button; without this one that would be Disconnect. ?>
            <button type="submit" class="screen-reader-text" tabindex="-1" aria-hidden="true"><?php esc_html_e( 'Save ID', 'elia-assistant' ); ?></button>

            <?php /* ── On / off ────────────────────────────────────── */ ?>
            <section class="elia-card elia-power" aria-labelledby="elia-power-title">
                <label class="elia-switch">
                    <input type="checkbox" role="switch" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[enabled]" value="1" <?php checked( $enabled ); ?> data-elia-toggle="power" />
                    <span class="elia-switch-track" aria-hidden="true"></span>
                    <span class="elia-power-body">
                        <span id="elia-power-title" class="elia-power-title"><?php esc_html_e( 'Show the chat on my site', 'elia-assistant' ); ?></span>
                        <span class="elia-power-text" data-elia-when="power:1"<?php echo $enabled ? '' : ' hidden'; ?>><?php esc_html_e( 'Visitors see the chat wherever you placed it below.', 'elia-assistant' ); ?></span>
                        <span class="elia-power-text" data-elia-when="power:0"<?php echo $enabled ? ' hidden' : ''; ?>><?php esc_html_e( 'The chat is hidden on your whole site. Your settings stay as they are, so you can turn it back on at any time.', 'elia-assistant' ); ?></span>
                    </span>
                </label>
                <span class="elia-status elia-status--ok" data-elia-when="power:1"<?php echo $enabled ? '' : ' hidden'; ?>><?php esc_html_e( 'On', 'elia-assistant' ); ?></span>
                <span class="elia-status elia-status--neutral" data-elia-when="power:0"<?php echo $enabled ? ' hidden' : ''; ?>><?php esc_html_e( 'Off', 'elia-assistant' ); ?></span>
            </section>

            <?php /* ── Test site: right under the switch, so a staging site is told apart at a glance ── */ ?>
            <section class="elia-card elia-power elia-power--test" aria-labelledby="elia-test-title">
                <label class="elia-switch">
                    <input type="checkbox" role="switch" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[is_test]" value="1" <?php checked( $is_test ); ?> data-elia-toggle="test" />
                    <span class="elia-switch-track" aria-hidden="true"></span>
                    <span class="elia-power-body">
                        <span id="elia-test-title" class="elia-power-title"><?php esc_html_e( 'Test mode (staging site)', 'elia-assistant' ); ?></span>
                        <span class="elia-power-text"><?php esc_html_e( 'Every message from this site is marked as a test: left out of Insights, and turned into an interaction only if test interactions are on in Interaction settings. Do not use it on your live website.', 'elia-assistant' ); ?></span>
                    </span>
                </label>
                <span class="elia-status elia-status--warning" data-elia-when="test:1"<?php echo $is_test ? '' : ' hidden'; ?>><?php esc_html_e( 'Test mode on', 'elia-assistant' ); ?></span>
            </section>

            <ol class="elia-steps">

                <?php /* ── Step 1: connect ─────────────────────────────── */ ?>
                <li class="elia-step<?php echo $state === 'connected' ? ' is-done' : ''; ?>">
                    <span class="elia-step-marker" aria-hidden="true"><span class="elia-step-number">1</span><span class="dashicons dashicons-yes"></span></span>
                    <section class="elia-card" aria-labelledby="elia-connect-title">
                        <header class="elia-card-head">
                            <h2 id="elia-connect-title"><?php esc_html_e( 'Connect your chat widget', 'elia-assistant' ); ?></h2>
                            <span class="elia-status elia-status--<?php echo esc_attr( $statuses[ $state ][0] ); ?>"><?php echo esc_html( $statuses[ $state ][1] ); ?></span>
                        </header>

                        <?php if ( $state === 'connected' ) :
                            $config   = (array) $remote['config'];
                            $theme_id = isset( $config['theme'] ) && is_string( $config['theme'] ) && isset( $themes[ $config['theme'] ] ) ? $config['theme'] : 'sky';
                            $theme    = $themes[ $theme_id ];
                            $lang     = elia_assistant_resolve_language( $opts );
                            $bot      = elia_assistant_config_text( $config, 'botName', $lang );
                            $cta      = elia_assistant_config_text( $config, 'ctaText', $lang );
                            $mode     = isset( $config['mode'] ) && is_string( $config['mode'] ) ? $config['mode'] : 'window';
                            $left     = isset( $config['position'] ) && $config['position'] === 'left';
                            $show_cta = ( $config['showCta'] ?? true ) !== false && $mode !== 'fullscreen';
                            ?>
                            <div class="elia-widget">
                                <div class="elia-preview<?php echo $left ? ' is-left' : ''; ?>" style="<?php echo esc_attr( sprintf( '--elia-base:%s;--elia-accent:%s;--elia-base-ink:%s', $theme['base'], $theme['accent'], elia_assistant_text_on( $theme['base'] ) ) ); ?>" aria-hidden="true">
                                    <?php if ( $show_cta ) : ?>
                                        <span class="elia-preview-bubble"><?php echo esc_html( $cta !== '' ? $cta : __( 'Hi! How can I help you?', 'elia-assistant' ) ); ?></span>
                                    <?php endif; ?>
                                    <span class="elia-preview-button"><svg viewBox="0 0 24 24" width="18" height="18" focusable="false"><path d="M4 5.5A2.5 2.5 0 0 1 6.5 3h11A2.5 2.5 0 0 1 20 5.5v8a2.5 2.5 0 0 1-2.5 2.5H10l-4.2 3.4A.5.5 0 0 1 5 19v-3a2.5 2.5 0 0 1-1-2V5.5Z"/></svg></span>
                                </div>
                                <dl class="elia-facts">
                                    <div>
                                        <dt><?php esc_html_e( 'Assistant name', 'elia-assistant' ); ?></dt>
                                        <dd><?php echo esc_html( $bot !== '' ? $bot : __( 'Not set', 'elia-assistant' ) ); ?></dd>
                                    </div>
                                    <div>
                                        <dt><?php esc_html_e( 'Look', 'elia-assistant' ); ?></dt>
                                        <dd><?php echo esc_html( sprintf(
                                            /* translators: 1: theme name, e.g. Midnight; 2: how the chat opens, e.g. "chat window in the corner" */
                                            __( '%1$s theme, %2$s', 'elia-assistant' ),
                                            $theme['label'],
                                            elia_assistant_mode_label( $mode )
                                        ) ); ?></dd>
                                    </div>
                                    <?php if ( ! empty( $remote['updatedAt'] ) && strtotime( $remote['updatedAt'] ) ) : ?>
                                        <div>
                                            <dt><?php esc_html_e( 'Last change', 'elia-assistant' ); ?></dt>
                                            <dd><?php echo esc_html( wp_date( get_option( 'date_format' ), strtotime( $remote['updatedAt'] ) ) ); ?></dd>
                                        </div>
                                    <?php endif; ?>
                                </dl>
                            </div>
                            <p class="elia-note"><?php esc_html_e( 'The assistant\'s name, look and answers are managed in the ELIA Assistant dashboard. Every change saved there shows on your site right away, and here the next time you open this page.', 'elia-assistant' ); ?></p>
                            <div class="elia-actions">
                                <?php echo elia_assistant_external_link( ELIA_ASSISTANT_DASHBOARD_URL, __( 'Change in ELIA Assistant dashboard', 'elia-assistant' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside ?>
                                <button type="submit" name="ec_disconnect" value="1" class="button-link elia-link-danger"><?php esc_html_e( 'Disconnect', 'elia-assistant' ); ?></button>
                            </div>

                        <?php elseif ( $state === 'not_found' ) : ?>
                            <div class="elia-callout elia-callout--error">
                                <p><?php esc_html_e( 'ELIA Assistant has no saved chat widget with this ID, so nothing is shown on your site.', 'elia-assistant' ); ?></p>
                                <p><?php esc_html_e( 'Check that you copied the whole ID from Configuration → Integrations → WordPress in the ELIA Assistant dashboard. If the card asks you to save the chat widget first, click Customize Chat Widget, set it up and click Save. Then come back and click Try again.', 'elia-assistant' ); ?></p>
                            </div>
                            <div class="elia-actions">
                                <?php echo elia_assistant_external_link( ELIA_ASSISTANT_DASHBOARD_URL, __( 'Open ELIA Assistant dashboard', 'elia-assistant' ), 'button button-primary' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside ?>
                                <a class="button" href="<?php echo esc_url( admin_url( 'options-general.php?page=elia-assistant' ) ); ?>"><?php esc_html_e( 'Try again', 'elia-assistant' ); ?></a>
                                <button type="submit" name="ec_disconnect" value="1" class="button-link elia-link-danger"><?php esc_html_e( 'Disconnect', 'elia-assistant' ); ?></button>
                            </div>

                        <?php elseif ( $state === 'error' ) : ?>
                            <div class="elia-callout elia-callout--warning">
                                <p><?php esc_html_e( 'The widget settings could not be loaded from ELIA Assistant to show them here. The chat on your site loads them on its own, so it is not affected. Try again in a few minutes.', 'elia-assistant' ); ?></p>
                            </div>
                            <div class="elia-actions">
                                <a class="button" href="<?php echo esc_url( admin_url( 'options-general.php?page=elia-assistant' ) ); ?>"><?php esc_html_e( 'Try again', 'elia-assistant' ); ?></a>
                                <button type="submit" name="ec_disconnect" value="1" class="button-link elia-link-danger"><?php esc_html_e( 'Disconnect', 'elia-assistant' ); ?></button>
                            </div>

                        <?php else : ?>
                            <p class="elia-intro"><?php esc_html_e( 'The plugin needs the ID of your chat widget from the ELIA Assistant dashboard. It takes about a minute:', 'elia-assistant' ); ?></p>
                            <ol class="elia-howto">
                                <li><?php
                                    printf(
                                        /* translators: %s: link with the text "Open the ELIA Assistant dashboard" */
                                        esc_html__( '%s and log in.', 'elia-assistant' ),
                                        elia_assistant_external_link( ELIA_ASSISTANT_DASHBOARD_URL, __( 'Open the ELIA Assistant dashboard', 'elia-assistant' ), 'elia-inline-link' ) // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside
                                    );
                                ?></li>
                                <li><?php esc_html_e( 'Open Configuration → Integrations and, under Channels, the WordPress card.', 'elia-assistant' ); ?></li>
                                <li><?php esc_html_e( 'Copy the widget ID and paste it below.', 'elia-assistant' ); ?></li>
                            </ol>
                        <?php endif; ?>

                        <?php if ( $state === 'connected' || $state === 'error' ) : ?>
                            <details class="elia-keyswap">
                                <summary><?php esc_html_e( 'Use a different widget ID', 'elia-assistant' ); ?></summary>
                        <?php endif; ?>
                                <div class="elia-key-field">
                                    <label for="elia_widget_id"><?php esc_html_e( 'Widget ID', 'elia-assistant' ); ?></label>
                                    <div class="elia-key-row">
                                        <input id="elia_widget_id" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[widget_id]"
                                               type="text" class="regular-text code" autocomplete="off" spellcheck="false"
                                               value="<?php echo esc_attr( $opts['widget_id'] ); ?>" />
                                        <button type="submit" class="button<?php echo $has_id ? '' : ' button-primary'; ?>"><?php
                                            echo $has_id ? esc_html__( 'Save ID', 'elia-assistant' ) : esc_html__( 'Connect', 'elia-assistant' );
                                        ?></button>
                                    </div>
                                </div>
                        <?php if ( $state === 'connected' || $state === 'error' ) : ?>
                            </details>
                        <?php endif; ?>
                    </section>
                </li>

                <?php /* ── Step 2: placement ──────────────────────────── */ ?>
                <li class="elia-step">
                    <span class="elia-step-marker" aria-hidden="true"><span class="elia-step-number">2</span></span>
                    <section class="elia-card" aria-labelledby="elia-place-title" data-elia-manual>
                        <header class="elia-card-head">
                            <h2 id="elia-place-title"><?php esc_html_e( 'Choose where the chat appears', 'elia-assistant' ); ?></h2>
                        </header>
                        <fieldset class="elia-choices">
                            <legend class="screen-reader-text"><?php esc_html_e( 'Where the chat appears', 'elia-assistant' ); ?></legend>
                            <label class="elia-choice">
                                <input type="radio" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[show_floating]" value="1" <?php checked( $floating ); ?> data-elia-toggle="placement" />
                                <span class="elia-choice-body">
                                    <span class="elia-choice-title"><?php esc_html_e( 'On every page', 'elia-assistant' ); ?> <span class="elia-tag"><?php esc_html_e( 'Recommended', 'elia-assistant' ); ?></span></span>
                                    <span class="elia-choice-text"><?php esc_html_e( 'A chat button stays in the corner of every page. Visitors click it to start a conversation.', 'elia-assistant' ); ?></span>
                                </span>
                            </label>
                            <label class="elia-choice">
                                <input type="radio" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[show_floating]" value="0" <?php checked( ! $floating ); ?> data-elia-toggle="placement" />
                                <span class="elia-choice-body">
                                    <span class="elia-choice-title"><?php esc_html_e( 'Only on pages I choose', 'elia-assistant' ); ?></span>
                                    <span class="elia-choice-text"><?php esc_html_e( 'The chat appears inside the content of selected pages, for example on a Contact page.', 'elia-assistant' ); ?></span>
                                </span>
                            </label>
                        </fieldset>

                        <div class="elia-reveal" data-elia-when="placement:1">
                            <p class="elia-note">
                                <?php esc_html_e( 'After saving, open your site and look for the chat button in the corner.', 'elia-assistant' ); ?>
                                <?php echo elia_assistant_external_link( home_url( '/' ), __( 'View your site', 'elia-assistant' ), 'elia-inline-link' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside ?>
                            </p>
                        </div>

                        <div class="elia-reveal elia-shortcode" data-elia-when="placement:0">
                            <p><?php esc_html_e( 'Edit the page where you want the chat, add a Shortcode block and paste this code into it:', 'elia-assistant' ); ?></p>
                            <div class="elia-code-row">
                                <code id="elia-shortcode" class="elia-code">[elia_assistant]</code>
                                <button type="button" class="button" data-elia-copy="#elia-shortcode"><span class="dashicons dashicons-admin-page" aria-hidden="true"></span><?php esc_html_e( 'Copy code', 'elia-assistant' ); ?></button>
                            </div>
                            <div class="elia-builder">
                                <label>
                                    <span><?php esc_html_e( 'Chat height', 'elia-assistant' ); ?></span>
                                    <select data-elia-sc="height">
                                        <option value=""><?php esc_html_e( 'Medium (500 px)', 'elia-assistant' ); ?></option>
                                        <option value="400px"><?php esc_html_e( 'Small (400 px)', 'elia-assistant' ); ?></option>
                                        <option value="700px"><?php esc_html_e( 'Large (700 px)', 'elia-assistant' ); ?></option>
                                        <option value="80vh"><?php esc_html_e( 'Most of the screen', 'elia-assistant' ); ?></option>
                                    </select>
                                </label>
                            </div>
                            <p class="description"><?php esc_html_e( 'Changing the height here only changes the code above. Copy it again afterwards. Colors come from the ELIA Assistant dashboard.', 'elia-assistant' ); ?></p>
                        </div>
                        <?php elia_assistant_block_save_bar(); ?>
                    </section>
                </li>

                <?php /* ── Step 3: language ───────────────────────────── */ ?>
                <li class="elia-step">
                    <span class="elia-step-marker" aria-hidden="true"><span class="elia-step-number">3</span></span>
                    <section class="elia-card" aria-labelledby="elia-lang-title" data-elia-manual>
                        <header class="elia-card-head">
                            <h2 id="elia-lang-title"><?php esc_html_e( 'Choose the chat language', 'elia-assistant' ); ?></h2>
                        </header>
                        <fieldset class="elia-choices">
                            <legend class="screen-reader-text"><?php esc_html_e( 'Chat language', 'elia-assistant' ); ?></legend>
                            <label class="elia-choice">
                                <input type="radio" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[language_override_enabled]" value="0" <?php checked( ! $manual_lang ); ?> data-elia-toggle="lang" />
                                <span class="elia-choice-body">
                                    <span class="elia-choice-title"><?php esc_html_e( 'Same as the page', 'elia-assistant' ); ?> <span class="elia-tag"><?php esc_html_e( 'Recommended', 'elia-assistant' ); ?></span></span>
                                    <span class="elia-choice-text"><?php echo esc_html( sprintf(
                                        /* translators: %s: language name, e.g. Slovenčina */
                                        __( 'On multilingual sites the chat follows the language of each page. Right now it is %s.', 'elia-assistant' ),
                                        $detected_name
                                    ) ); ?></span>
                                </span>
                            </label>
                            <label class="elia-choice">
                                <input type="radio" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[language_override_enabled]" value="1" <?php checked( $manual_lang ); ?> data-elia-toggle="lang" />
                                <span class="elia-choice-body">
                                    <span class="elia-choice-title"><?php esc_html_e( 'Always the same language', 'elia-assistant' ); ?></span>
                                    <span class="elia-choice-text"><?php esc_html_e( 'The chat uses the language you pick here on every page.', 'elia-assistant' ); ?></span>
                                </span>
                            </label>
                        </fieldset>
                        <div class="elia-reveal elia-lang" data-elia-when="lang:1">
                            <label for="elia_language"><?php esc_html_e( 'Chat language', 'elia-assistant' ); ?></label>
                            <select id="elia_language" name="<?php echo esc_attr( ELIA_ASSISTANT_OPTION ); ?>[language_override]">
                                <?php foreach ( $languages as $code => $name ) : ?>
                                    <option value="<?php echo esc_attr( $code ); ?>" <?php selected( $manual_lang ? $opts['language_override'] : $detected, $code ); ?>><?php echo esc_html( $name ); ?></option>
                                <?php endforeach; ?>
                            </select>
                        </div>
                        <?php elia_assistant_block_save_bar(); ?>
                    </section>
                </li>
            </ol>

            <noscript>
                <div class="elia-save">
                    <?php submit_button( __( 'Save changes', 'elia-assistant' ), 'primary large', 'submit', false ); ?>
                </div>
            </noscript>
            <p class="elia-autosave" role="status" aria-live="polite" data-elia-autosave-status></p>
        </form>

        <?php elia_assistant_render_woocommerce_section(); ?>
    </div>
    <?php
}

// ─── Admin: WooCommerce section ──────────────────────────────────────────────

function elia_assistant_wc_copy_field( string $id, string $label, string $value ): void {
    ?>
    <div class="elia-copy-field">
        <label for="<?php echo esc_attr( $id ); ?>"><?php echo esc_html( $label ); ?></label>
        <div class="elia-code-row">
            <input id="<?php echo esc_attr( $id ); ?>" type="text" readonly class="elia-code-input" value="<?php echo esc_attr( $value ); ?>" />
        </div>
    </div>
    <?php
}

/**
 * Rendered outside the settings form: the buttons below post to admin-post.php,
 * and HTML does not allow a form inside a form. On sites without WooCommerce it is shown greyed
 * out, so the option is known about.
 */
function elia_assistant_render_woocommerce_section(): void {
    $wc = elia_assistant_woocommerce_info();
    if ( ! $wc ) {
        ?>
        <section class="elia-card elia-card--extra is-disabled" aria-labelledby="elia-wc-title">
            <header class="elia-card-head">
                <h2 id="elia-wc-title"><?php esc_html_e( 'Products from your WooCommerce store', 'elia-assistant' ); ?></h2>
                <span class="elia-status elia-status--neutral"><?php esc_html_e( 'WooCommerce not installed', 'elia-assistant' ); ?></span>
            </header>
            <p class="elia-intro"><?php esc_html_e( 'With WooCommerce, the assistant can answer questions about your products, prices and stock. Install and activate WooCommerce to use it.', 'elia-assistant' ); ?></p>
            <p class="elia-actions">
                <button type="button" class="button" disabled><?php esc_html_e( 'Create read-only key', 'elia-assistant' ); ?></button>
            </p>
        </section>
        <?php
        return;
    }

    // Display-only status flag set by our own redirect after a nonce-checked action.
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended
    $notice = isset( $_GET['ec_wc'] ) ? sanitize_key( wp_unslash( $_GET['ec_wc'] ) ) : '';

    // One-shot: read and immediately drop, so the pair is never shown twice.
    $new_key = get_transient( elia_assistant_wc_transient_key() );
    if ( $new_key !== false ) {
        delete_transient( elia_assistant_wc_transient_key() );
    }
    if ( ! is_array( $new_key ) || empty( $new_key['consumer_key'] ) ) {
        $new_key = null;
    }
    $stored = elia_assistant_wc_stored_key();
    $https  = strpos( $wc['store_url'], 'https://' ) === 0;
    ?>
    <section class="elia-card elia-card--extra" aria-labelledby="elia-wc-title">
        <header class="elia-card-head">
            <h2 id="elia-wc-title" tabindex="-1"><?php esc_html_e( 'Products from your WooCommerce store', 'elia-assistant' ); ?></h2>
            <?php if ( $stored || $new_key ) : ?>
                <span class="elia-status elia-status--ok"><?php esc_html_e( 'Key created', 'elia-assistant' ); ?></span>
            <?php else : ?>
                <span class="elia-status elia-status--neutral"><?php esc_html_e( 'Optional', 'elia-assistant' ); ?></span>
            <?php endif; ?>
        </header>

        <?php if ( $notice === 'failed' || $notice === 'unavailable' ) : ?>
            <div class="elia-callout elia-callout--error"><p><?php esc_html_e( 'Could not create the WooCommerce API key. Create one manually under WooCommerce → Settings → Advanced → REST API.', 'elia-assistant' ); ?></p></div>
        <?php elseif ( $notice === 'revoked' ) : ?>
            <div class="elia-callout elia-callout--ok"><p><?php esc_html_e( 'The key was deleted. The assistant can no longer read your products.', 'elia-assistant' ); ?></p></div>
        <?php endif; ?>

        <?php if ( ! $https ) : ?>
            <div class="elia-callout elia-callout--warning"><p><?php esc_html_e( 'Your site does not use a secure connection (HTTPS). ELIA Assistant can connect only to stores on HTTPS, so ask your web hosting provider to turn on an SSL certificate first.', 'elia-assistant' ); ?></p></div>
        <?php endif; ?>

        <?php if ( $new_key ) : ?>

            <div class="elia-callout elia-callout--warning">
                <p><strong><?php esc_html_e( 'Copy the connection details now.', 'elia-assistant' ); ?></strong>
                   <?php esc_html_e( 'The Consumer Key is shown only once and cannot be displayed again. If you lose it, delete the key and create a new one.', 'elia-assistant' ); ?></p>
            </div>
            <?php
            elia_assistant_wc_copy_field( 'elia-wc-url', __( 'Store URL', 'elia-assistant' ), $wc['store_url'] );
            elia_assistant_wc_copy_field( 'elia-wc-key', __( 'Consumer Key', 'elia-assistant' ), $new_key['consumer_key'] );
            elia_assistant_wc_copy_field( 'elia-wc-secret', __( 'Consumer Secret', 'elia-assistant' ), $new_key['consumer_secret'] );
            ?>
            <?php // One Copy button for all three, joined by "|", which none of them contains (the key and secret are ck_/cs_ plus hex). ?>
            <p><button type="button" class="button button-primary" data-elia-copy="#elia-wc-url, #elia-wc-key, #elia-wc-secret"><span class="dashicons dashicons-admin-page" aria-hidden="true"></span><?php esc_html_e( 'Copy connection details', 'elia-assistant' ); ?></button></p>
            <p class="elia-note"><?php esc_html_e( 'The copied text holds the store URL, Consumer Key and Consumer Secret, separated by |.', 'elia-assistant' ); ?></p>
            <div class="elia-actions">
                <?php echo elia_assistant_external_link( ELIA_ASSISTANT_DASHBOARD_URL, __( 'Open ELIA Assistant dashboard', 'elia-assistant' ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside ?>
            </div>

        <?php elseif ( $stored ) : ?>

            <p><?php echo esc_html( sprintf(
                /* translators: 1: date the key was created, 2: last characters of the consumer key */
                __( 'A read-only key for ELIA Assistant was created on %1$s (ends with …%2$s). The assistant can read your products, prices and stock, but cannot change anything in your store.', 'elia-assistant' ),
                wp_date( get_option( 'date_format' ), (int) $stored['created'] ),
                $stored['truncated']
            ) ); ?></p>
            <div class="elia-actions">
                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
                    <input type="hidden" name="action" value="elia_assistant_wc_generate" />
                    <?php wp_nonce_field( 'elia_assistant_wc_generate' ); ?>
                    <button type="submit" class="button"><?php esc_html_e( 'Create a new key', 'elia-assistant' ); ?></button>
                </form>
                <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
                    <input type="hidden" name="action" value="elia_assistant_wc_revoke" />
                    <?php wp_nonce_field( 'elia_assistant_wc_revoke' ); ?>
                    <button type="submit" class="button-link elia-link-danger"><?php esc_html_e( 'Delete key', 'elia-assistant' ); ?></button>
                </form>
            </div>
            <p class="description"><?php esc_html_e( 'A new key replaces the current one, so it has to be entered in ELIA Assistant again.', 'elia-assistant' ); ?></p>

        <?php else : ?>

            <p class="elia-intro"><?php esc_html_e( 'Let the assistant answer questions about your products, prices and stock. It needs read-only access to your store:', 'elia-assistant' ); ?></p>
            <ol class="elia-howto">
                <li><?php esc_html_e( 'Click Create read-only key. The key is created in your store and cannot change anything in it.', 'elia-assistant' ); ?></li>
                <li><?php esc_html_e( 'Click Copy connection details to copy the three values that appear.', 'elia-assistant' ); ?></li>
                <li><?php esc_html_e( 'Enter them in the ELIA Assistant dashboard under Configuration → Integrations → WooCommerce.', 'elia-assistant' ); ?></li>
            </ol>
            <form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>" class="elia-actions">
                <input type="hidden" name="action" value="elia_assistant_wc_generate" />
                <?php wp_nonce_field( 'elia_assistant_wc_generate' ); ?>
                <button type="submit" class="button button-primary"><?php esc_html_e( 'Create read-only key', 'elia-assistant' ); ?></button>
            </form>
            <p class="description"><?php esc_html_e( 'This plugin never sends the key anywhere. You decide who gets it.', 'elia-assistant' ); ?></p>

        <?php endif; ?>
    </section>
    <?php
}

// ─── Admin: uninstall dialog ──────────────────────────────────────────────────

/**
 * When the plugin is deleted from the Plugins screen, ask whether to keep its settings.
 * The answer is stored for uninstall.php. Deleting without the dialog (bulk delete, WP-CLI)
 * removes the settings, as before.
 */
add_action( 'admin_enqueue_scripts', function ( string $hook ) {
    if ( $hook !== 'plugins.php' || ! current_user_can( 'delete_plugins' ) ) {
        return;
    }

    $data = [
        'plugin'  => plugin_basename( __FILE__ ),
        'ajaxUrl' => admin_url( 'admin-ajax.php' ),
        'nonce'   => wp_create_nonce( 'elia_assistant_uninstall_choice' ),
        'i18n'    => [
            'title'  => __( 'Delete ELIA Assistant', 'elia-assistant' ),
            'text'   => __( 'Do you want to keep the plugin settings? If you keep them, your widget ID, settings and the generated WooCommerce key stay in place and are used again if you reinstall the plugin.', 'elia-assistant' ),
            'keep'   => __( 'Delete plugin, keep settings', 'elia-assistant' ),
            'remove' => __( 'Delete plugin and settings', 'elia-assistant' ),
            'cancel' => __( 'Cancel', 'elia-assistant' ),
            'error'  => __( 'Could not save your choice. Please try again.', 'elia-assistant' ),
        ],
    ];

    wp_register_style( 'elia-assistant-uninstall', false, [], ELIA_ASSISTANT_VERSION );
    wp_enqueue_style( 'elia-assistant-uninstall' );
    wp_add_inline_style( 'elia-assistant-uninstall', '
        .elia-un-overlay { position: fixed; inset: 0; z-index: 100000; background: rgba(0,0,0,.6); display: flex; align-items: center; justify-content: center; padding: 16px; }
        .elia-un-dialog { background: #fff; max-width: 480px; width: 100%; padding: 20px 24px; border-radius: 4px; box-shadow: 0 8px 30px rgba(0,0,0,.3); }
        .elia-un-dialog h2 { margin: 0 0 12px; font-size: 1.3em; }
        .elia-un-dialog p { margin: 0 0 20px; }
        .elia-un-actions { display: flex; flex-wrap: wrap; gap: 8px; justify-content: flex-end; }
        .elia-un-actions .elia-un-remove { color: #b32d2e; border-color: #b32d2e; }
        .elia-un-error { color: #b32d2e; margin: 0 0 12px; }
    ' );

    wp_register_script( 'elia-assistant-uninstall', false, [ 'jquery', 'updates' ], ELIA_ASSISTANT_VERSION, true );
    wp_enqueue_script( 'elia-assistant-uninstall' );
    wp_add_inline_script(
        'elia-assistant-uninstall',
        'var eliaAssistantUninstall = ' . wp_json_encode( $data ) . ';',
        'before'
    );
    wp_add_inline_script(
        'elia-assistant-uninstall',
        '(function () {
            var cfg = window.eliaAssistantUninstall;
            if (!cfg) { return; }
            var selector = \'tr[data-plugin="\' + cfg.plugin + \'"] .delete a\';

            function el(tag, cls, text) {
                var node = document.createElement(tag);
                if (cls) { node.className = cls; }
                if (text) { node.textContent = text; }
                return node;
            }

            function runDelete(link) {
                var row = link.closest(\'tr\');
                if (window.wp && wp.updates && typeof wp.updates.deletePlugin === \'function\') {
                    wp.updates.deletePlugin({ plugin: row.getAttribute(\'data-plugin\'), slug: row.getAttribute(\'data-slug\') });
                } else {
                    window.location.href = link.href;
                }
            }

            function openDialog(link) {
                var overlay = el(\'div\', \'elia-un-overlay\');
                var dialog = el(\'div\', \'elia-un-dialog\');
                dialog.setAttribute(\'role\', \'dialog\');
                dialog.setAttribute(\'aria-modal\', \'true\');
                dialog.setAttribute(\'aria-labelledby\', \'elia-un-title\');
                var title = el(\'h2\', \'\', cfg.i18n.title);
                title.id = \'elia-un-title\';
                var error = el(\'p\', \'elia-un-error\');
                error.hidden = true;
                var actions = el(\'div\', \'elia-un-actions\');
                var cancel = el(\'button\', \'button\', cfg.i18n.cancel);
                var keep = el(\'button\', \'button button-primary\', cfg.i18n.keep);
                var remove = el(\'button\', \'button elia-un-remove\', cfg.i18n.remove);
                [cancel, keep, remove].forEach(function (b) { b.type = \'button\'; actions.appendChild(b); });
                dialog.appendChild(title);
                dialog.appendChild(el(\'p\', \'\', cfg.i18n.text));
                dialog.appendChild(error);
                dialog.appendChild(actions);
                overlay.appendChild(dialog);
                document.body.appendChild(overlay);
                keep.focus();

                function close() {
                    document.removeEventListener(\'keydown\', onKey);
                    overlay.remove();
                    link.focus();
                }
                function onKey(e) { if (e.key === \'Escape\') { close(); } }
                document.addEventListener(\'keydown\', onKey);
                overlay.addEventListener(\'click\', function (e) { if (e.target === overlay) { close(); } });
                cancel.addEventListener(\'click\', close);

                function choose(keepData) {
                    keep.disabled = remove.disabled = true;
                    var body = new URLSearchParams({
                        action: \'elia_assistant_uninstall_choice\',
                        _ajax_nonce: cfg.nonce,
                        keep: keepData ? \'1\' : \'0\'
                    });
                    fetch(cfg.ajaxUrl, { method: \'POST\', credentials: \'same-origin\', body: body })
                        .then(function (r) { return r.json(); })
                        .then(function (res) {
                            if (!res || !res.success) { throw new Error(\'failed\'); }
                            close();
                            runDelete(link);
                        })
                        .catch(function () {
                            error.textContent = cfg.i18n.error;
                            error.hidden = false;
                            keep.disabled = remove.disabled = false;
                        });
                }
                keep.addEventListener(\'click\', function () { choose(true); });
                remove.addEventListener(\'click\', function () { choose(false); });
            }

            // Capture phase, so this runs before the WordPress handler and its own confirm().
            document.addEventListener(\'click\', function (e) {
                var link = e.target.closest ? e.target.closest(selector) : null;
                if (!link) { return; }
                e.preventDefault();
                e.stopImmediatePropagation();
                openDialog(link);
            }, true);
        })();'
    );
} );

add_action( 'wp_ajax_elia_assistant_uninstall_choice', function () {
    check_ajax_referer( 'elia_assistant_uninstall_choice' );
    if ( ! current_user_can( 'delete_plugins' ) ) {
        wp_send_json_error( null, 403 );
    }
    $keep = isset( $_POST['keep'] ) && sanitize_key( wp_unslash( $_POST['keep'] ) ) === '1';
    update_option( ELIA_ASSISTANT_KEEP_DATA_OPTION, $keep ? '1' : '0', false );
    wp_send_json_success();
} );

// ─── Embed options ────────────────────────────────────────────────────────────

/**
 * Options for Chatui.createChat() on the site, in the same shape as the dashboard's embed snippet:
 * { widgetId: "…" } plus what this plugin decides per page (target, mode, language) and,
 * on a test site, isTest: true, which marks every message from it as a test one.
 * widget.js loads the saved config by widgetId on every page view and lays these options over it,
 * so a Save in the dashboard reaches the site at once. Null when the chat is switched off or no
 * widget id is set.
 */
function elia_assistant_embed_options( array $opts, array $overrides ): ?array {
    $widget_id = elia_assistant_widget_id( $opts );
    if ( $widget_id === '' || ( $opts['enabled'] ?? '1' ) === '0' ) {
        return null;
    }

    $config             = array_merge( [ 'widgetId' => $widget_id ], $overrides );
    $config['language'] = elia_assistant_resolve_language( $opts );

    if ( ( $opts['is_test'] ?? '0' ) === '1' ) {
        $config['isTest'] = true;
    }

    return $config;
}

// ─── Frontend: floating widget ────────────────────────────────────────────────

add_action( 'wp_footer', function () {
    $opts = array_merge( elia_assistant_defaults(), (array) get_option( ELIA_ASSISTANT_OPTION, [] ) );

    if ( empty( $opts['show_floating'] ) || $opts['show_floating'] === '0' ) {
        return;
    }

    $config = elia_assistant_embed_options( $opts, [ 'target' => '#elia-chat' ] );
    if ( ! $config ) {
        return;
    }

    wp_enqueue_script( 'elia-assistant', ELIA_ASSISTANT_CDN, [], ELIA_ASSISTANT_VERSION, true );
    wp_add_inline_script( 'elia-assistant', 'Chatui.createChat(' . wp_json_encode( $config ) . ');' );
    echo '<div id="elia-chat"></div>' . "\n";
} );

// ─── Shortcode: [elia_assistant] ──────────────────────────────────────────────

add_shortcode( 'elia_assistant', function ( $atts ) {
    $atts = shortcode_atts( [
        'height' => '500px',
    ], $atts, 'elia_assistant' );

    $opts   = array_merge( elia_assistant_defaults(), (array) get_option( ELIA_ASSISTANT_OPTION, [] ) );
    $id     = 'elia-chat-' . wp_unique_id();
    $overrides = [ 'mode' => 'embedded', 'target' => '#' . $id ];

    $config = elia_assistant_embed_options( $opts, $overrides );
    if ( ! $config ) {
        return '<!-- elia_assistant: chat switched off or no widget ID configured -->';
    }

    $config_json = wp_json_encode( $config );
    $height      = trim( (string) $atts['height'] );
    if ( ! preg_match( '/^\d+(\.\d+)?(px|em|rem|vh|%)$/', $height ) ) {
        $height = '500px';
    }

    wp_enqueue_script( 'elia-assistant', ELIA_ASSISTANT_CDN, [], ELIA_ASSISTANT_VERSION, true );

    $init_js = '(function(){'
        . 'var el = document.getElementById(' . wp_json_encode( $id ) . ');'
        . 'if (!el || el.dataset.eliaInit) return;'
        . 'el.dataset.eliaInit = "1";'
        . 'Chatui.createChat(' . $config_json . ');'
        . '})();';

    wp_add_inline_script( 'elia-assistant', $init_js );

    return sprintf(
        '<div id="%s" style="height:%s;border-radius:12px;overflow:hidden;"></div>',
        esc_attr( $id ),
        esc_attr( $height )
    );
} );