<?php
if ( ! defined( 'ABSPATH' ) ) exit;

class FLINK_Admin {

    /**
     * Allowed-HTML ruleset for echoing plugin-generated admin markup
     * (rule/pillar rows). It extends the post ruleset with the SVG icon
     * tags and the data-* / form attributes our rows use, so we can pass
     * the markup through wp_kses() at output time ("escaping late") without
     * stripping icons or breaking the JS hooks. The dynamic *values* inside
     * this markup are already escaped at build time with esc_html/esc_attr/
     * esc_url; wp_kses() here is the final output-layer guard.
     *
     * @return array
     */
    public static function admin_kses_allowed() {
        return array(
            'nav'      => array( 'class' => true ),
            'div'      => array( 'class' => true, 'data-id' => true, 'data-lang' => true, 'data-rule-id' => true, 'data-keyword' => true, 'data-synonyms' => true, 'style' => true, 'title' => true ),
            'span'     => array( 'class' => true, 'title' => true, 'style' => true ),
            'a'        => array( 'href' => true, 'class' => true, 'title' => true, 'target' => true, 'rel' => true, 'data-id' => true ),
            'button'   => array( 'class' => true, 'title' => true, 'type' => true, 'data-id' => true, 'data-pilar-id' => true, 'data-rule-id' => true, 'data-keyword' => true ),
            'label'    => array( 'class' => true ),
            'input'    => array( 'type' => true, 'class' => true, 'value' => true, 'checked' => true, 'data-id' => true, 'placeholder' => true ),
            'svg'      => array( 'width' => true, 'height' => true, 'viewbox' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true, 'stroke-linejoin' => true, 'class' => true, 'xmlns' => true, 'aria-hidden' => true ),
            'path'     => array( 'd' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true, 'stroke-linejoin' => true ),
            'polygon'  => array( 'points' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true, 'stroke-linejoin' => true ),
            'polyline' => array( 'points' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true, 'stroke-linejoin' => true ),
            'line'     => array( 'x1' => true, 'y1' => true, 'x2' => true, 'y2' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true ),
            'circle'   => array( 'cx' => true, 'cy' => true, 'r' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true ),
            'rect'     => array( 'x' => true, 'y' => true, 'width' => true, 'height' => true, 'rx' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true ),
        );
    }

    public function init() {
        add_action( 'admin_menu',            array( $this, 'register_menu' ) );
        add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );

        // Onboarding glue
        add_action( 'wp_ajax_flink_hide_onboarding', array( $this, 'ajax_hide_onboarding' ) );
        add_action( 'admin_init',                 array( $this, 'maybe_redirect_to_onboarding' ) );

        // Settings actions
        add_action( 'admin_init',                 array( $this, 'maybe_delete_openai_key' ) );

        // Pin sidebar highlight to "Enlazado" when the user is on a
        // legacy URL that we couldn't safely redirect (eg. one with
        // edit params). WordPress decides which submenu item gets the
        // active class based on $submenu_file; we override it so the
        // sidebar always shows the user where they are.
        add_filter( 'submenu_file', array( $this, 'pin_enlazado_submenu_highlight' ) );
    }

    /**
     * Force the sidebar's "Enlazado" entry to look active when the
     * user is rendering one of the legacy hidden pages. Without this,
     * pages like ?page=flinkil-pilares&edit=12 render fine but the
     * sidebar shows no active item, which feels broken.
     */
    public function pin_enlazado_submenu_highlight( $submenu_file ) {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        $page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( $_GET['page'] ) ) : '';
        $legacy = array(
            'flinkil-pilares',
            'flinkil-reglas',
            'flinkil-exitos',
        );
        if ( in_array( $page, $legacy, true ) ) {
            return 'flinkil-enlazado';
        }
        // System legacy pages keep the "Sistema" hub (flinkil-ajustes)
        // highlighted. Herramientas is common; KB is Paid-only.
        $sistema_legacy = array( 'flinkil-herramientas' );
        if ( in_array( $page, $sistema_legacy, true ) ) {
            return 'flinkil-ajustes';
        }
        return $submenu_file;
    }

    /**
     * Handles the "Eliminar clave" button in Ajustes → IA.
     * Validates nonce + capability, then wipes the option.
     * Redirects back to the same tab with a success flag so the
     * user gets a clear visual confirmation.
     */
    public function maybe_delete_openai_key() {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( empty( $_POST['flink_delete_openai_key'] ) ) return;
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( 'Sin permisos suficientes.', 403 );
        }
        check_admin_referer( 'flink_delete_openai_key', 'flink_delete_openai_key_nonce' );
        delete_option( 'flink_openai_key' );
        wp_safe_redirect( add_query_arg(
            array( 'page' => 'flinkil-ajustes', 'tab' => 'ia', 'key_deleted' => '1' ),
            admin_url( 'admin.php' )
        ) );
        exit;
    }

    /**
     * AJAX: hide the "Primeros pasos" item from the menu.
     * Stores the choice in an option; the menu registration reads
     * it on the next admin page load. Reversible from Ajustes if we
     * later add a setting for it.
     */
    public function ajax_hide_onboarding() {
        if ( ! current_user_can( 'manage_options' ) ) wp_send_json_error( '', 403 );
        check_ajax_referer( 'flink_hide_onboarding', 'nonce' );
        update_option( 'flink_onboarding_hidden', '1' );
        wp_send_json_success();
    }

    /**
     * On first activation, redirect once to the onboarding page so
     * brand-new users land on a guided screen instead of an empty
     * "Crear contenido". The redirect flag is set by the activation
     * hook in the main plugin file and consumed (deleted) here.
     */
    public function maybe_redirect_to_onboarding() {
        if ( ! get_transient( 'flink_onboarding_redirect' ) ) return;
        delete_transient( 'flink_onboarding_redirect' );
        // Don't redirect during AJAX, cron, REST, or bulk plugin activations.
        if ( wp_doing_ajax() || wp_doing_cron() ) return;
        if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) return;
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( isset( $_GET['activate-multi'] ) ) return;
        if ( ! current_user_can( 'manage_options' ) ) return;
        wp_safe_redirect( admin_url( 'admin.php?page=flinkil-onboarding' ) );
        exit;
    }

    /**
     * Returns the menu-and-page-layout CSS that needs to apply on every
     * plugin admin page. Returned as a string so it can be attached to
     * the main 'flink-admin' style handle via wp_add_inline_style() in
     * enqueue_assets() — that's the WordPress.org-compliant way to ship
     * inline styles.
     */
    public function get_wide_screen_css() {
        return '
            #wpcontent { padding-left: 20px !important; }
            #wpbody-content .wrap { max-width: none !important; padding-right: 24px; }
        /* Hide the WP auto-generated duplicate first submenu item */
        /* Hide the auto-generated duplicate "04 IL" first submenu item */
        #toplevel_page_04-internal-linking ul li:first-child,
        #toplevel_page_04-internal-linking ul li a[href="admin.php?page=04-internal-linking"],
        /* Hide the default first submenu item that duplicates the parent */
        #toplevel_page_04-internal-linking ul li a[href*="page=04-internal-linking"]:not([href*="flinkil-"]) {
            display: none !important;
        }

        /* ── Simple page headers (Ajustes & Herramientas) ──
           These two pages dropped the illustrated header that the
           rest of the plugin uses, because they are functional/
           technical contexts where the illustration didn\'t fit.
           Same typographic scale as FLINK_Page_Header (.ilph-title) so
           the page hierarchy stays consistent across the plugin. */
        .il-page .ilset-simple-hd,
        .il-page .ilh-simple-hd {
            margin: 0 0 22px;
        }
        .il-page .ilset-simple-hd h1,
        .il-page .ilh-simple-hd h1 {
            font-size: 28px !important; font-weight: 700 !important;
            letter-spacing: -.03em !important; line-height: 1.1 !important;
            margin: 0 0 6px !important;
            color: var(--ds-ink, #0f1419) !important;
        }
        .il-page .ilset-simple-hd p,
        .il-page .ilh-simple-hd p {
            font-size: 15px !important; color: var(--ds-ink3, #6b7280) !important;
            margin: 0 !important; line-height: 1.5 !important;
        }
        ';
    }

    public function register_menu() {
        /*
         * 04 IL
         * ├─ Crear contenido
         * ├─ Crear imágenes
         * ├─ Traducciones
         * ├─ Automatizaciones
         * ├─ ─── ENLAZADO ───
         * │  ├─ Páginas pilar
         * │  ├─ Reglas de enlazado
         * │  ├─ Enlazado semántico
         * │  └─ Mapa de enlaces
         * ├─ ─── SISTEMA ───
         * │  ├─ Ajustes
         * │  └─ Herramientas
         */

        add_menu_page( '4Linking', '4Linking', 'manage_options',
            '04-internal-linking', '__return_false', 'dashicons-networking', 30 );

        // ── Primeros pasos (onboarding) ──────────────────────────
        // Shown until the user dismisses it via the page itself
        // (sets il_onboarding_hidden=1). Until then it's the first
        // item in the submenu — visible to first-time users.
        if ( get_option( 'flink_onboarding_hidden', '0' ) !== '1' ) {
            add_submenu_page( '04-internal-linking', 'Primeros pasos', 'Primeros pasos',
                'manage_options', 'flinkil-onboarding', array( $this, '_render_onboarding' ) );
        } else {
            // Keep it reachable by URL (so the user can re-enable from
            // a settings link if they ever want to), but hidden from menu.
            add_submenu_page( null, 'Primeros pasos', 'Primeros pasos',
                'manage_options', 'flinkil-onboarding', array( $this, '_render_onboarding' ) );
        }

        // ── ENLAZADO ─────────────────────────────────────────────
        // Renders a tabbed interface for the four enlazado views
        // (pilares / reglas / semantic / mapa). The original sub-pages
        // are still registered below as hidden pages so deep links
        // (?page=flinkil-pilares) keep working — critical because URLs
        // are referenced from emails, error messages and from JS inside
        // the plugin itself.
        add_submenu_page( '04-internal-linking', 'Enlazado', 'Enlazado',
            'manage_options', 'flinkil-enlazado', array( $this, '_render_enlazado_hub' ) );

        // ── SISTEMA ──────────────────────────────────────────────
        // Single hub entry with tabs: Bases de conocimiento (PRO),
        // Ajustes and Herramientas. Reuses the flinkil-ajustes slug as
        // base so its asset loading keeps working. The hub uses `sec`
        // (not `tab`) as its query param to avoid colliding with the
        // internal tabs that the Ajustes page itself uses (?tab=ia,
        // ?tab=enlazado, ...).
        add_submenu_page( '04-internal-linking', 'Sistema', 'Sistema',
            'manage_options', 'flinkil-ajustes', array( $this, '_render_sistema_hub' ) );

        // KB, Ajustes and Herramientas keep their own slugs as hidden
        // routes so deep-links keep resolving. Ajustes shares its slug
        // with the hub, so it isn't registered separately here.
        add_submenu_page( null, 'Herramientas', 'Herramientas',
            'manage_options', 'flinkil-herramientas', array( $this, 'render_herramientas' ) );

        // ── Hidden / direct-URL-only pages ────────────────────────
        // The 4 enlazado views are registered as hidden so the existing
        // URLs (?page=flinkil-pilares etc.) continue to resolve. They're
        // not shown in the sidebar — the user reaches them via the
        // tabs inside the "Enlazado" hub. Direct URLs from emails,
        // error messages and JS code still work because the parent is
        // null (= no submenu placement, just route registration).
        add_submenu_page( null, 'Páginas pilar',     'Páginas pilar',     'manage_options', 'flinkil-pilares',  array( $this, 'render_pilares' ) );
        add_submenu_page( null, 'Reglas de enlazado','Reglas de enlazado','manage_options', 'flinkil-reglas',   array( $this, 'render_reglas' ) );
        add_submenu_page( null, 'Mapa de enlaces',   'Mapa de enlaces',   'manage_options', 'flinkil-exitos',   array( $this, '_render_exitos' ) );
        add_submenu_page( null, 'URLs excluidas', 'URLs excluidas', 'manage_options', 'flinkil-exclusiones', array( $this, 'render_exclusiones' ) );
        // Redirect bare top-level to the right landing page.
        // In the full edition the landing page is "Crear contenido" — the
        // content-generation flow that most users open first. The free
        // edition doesn't include that module, so it lands on the
        // Enlazado hub instead, which is its main feature.
        add_action( 'admin_init', function () {
            global $pagenow;
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            if ( $pagenow !== 'admin.php' || empty( $_GET['page'] ) ) return;
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            $page = sanitize_key( wp_unslash( $_GET['page'] ) );

            if ( $page === '04-internal-linking' ) {
                // Full edition lands on Crear contenido; the free edition
                // (which doesn't ship that module) lands on Enlazado.
                if ( ! headers_sent() ) wp_safe_redirect( admin_url( 'admin.php?page=flinkil-enlazado' ) );
                exit;
            }

            // Legacy URL → hub tab redirects.
            // The four enlazado views are still registered as hidden
            // pages (so direct loads work and any in-flight bookmark
            // doesn't 404), but visiting them via the menu / a pasted
            // link should land on the hub with the matching tab so the
            // sidebar highlight stays coherent. Only redirect plain
            // URLs without a query that already names a tab — this
            // keeps internal callers that pass extra params (eg.
            // ?page=flinkil-pilares&edit=12) free to opt out by also
            // passing &skip_hub=1.
            $legacy_to_tab = array(
                'flinkil-pilares'  => 'pilares',
                'flinkil-reglas'   => 'reglas',
                'flinkil-exitos'   => 'mapa',
            );
            // System pages → Sistema hub sections (uses `sec` param).
            // Herramientas is common to both editions; KB is Paid-only.
            $legacy_to_sistema_sec = array(
                'flinkil-herramientas'   => 'herramientas',
            );
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            if ( isset( $legacy_to_sistema_sec[ $page ] ) && empty( $_GET['skip_hub'] ) ) {
                // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
                $extras = array_diff_key( $_GET, array( 'page' => 1 ) );
                if ( empty( $extras ) ) {
                    wp_safe_redirect( admin_url( 'admin.php?page=flinkil-ajustes&sec=' . $legacy_to_sistema_sec[ $page ] ) );
                    exit;
                }
            }
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            if ( isset( $legacy_to_tab[ $page ] ) && empty( $_GET['skip_hub'] ) ) {
                // Only redirect if the URL is "naked" — no extra params
                // beyond `page`. This protects deep links like edit
                // dialogs from being broken by the redirect.
                // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
                $extras = array_diff_key( $_GET, array( 'page' => 1 ) );
                if ( empty( $extras ) ) {
                    wp_safe_redirect( admin_url( 'admin.php?page=flinkil-enlazado&tab=' . $legacy_to_tab[ $page ] ) );
                    exit;
                }
            }
        } );
    }

    /**
     * Hub renderer for the unified "Enlazado" page. Delegates to one
     * of the four sub-renderers based on the active tab. Each tab keeps
     * its own URL slug as a query param so deep-linking within the hub
     * is possible (?page=flinkil-enlazado&tab=reglas).
     *
     * The tab strip itself is rendered inline here (not by each
     * sub-renderer) so we don't touch the four existing render_*
     * methods. They keep behaving exactly as before — header, body,
     * everything. We just wrap them in a tab navigation.
     */
    public function _render_enlazado_hub() {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        $tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'pilares';
        $valid = array(
            'pilares',
            'reglas',
            'mapa',
        );
        if ( ! in_array( $tab, $valid, true ) ) $tab = 'pilares';

        // Each tab carries a small line icon (18×18) for the compact
        // card-style navigation. Icons follow the Lucide-style stroke
        // look defined in the brand manual.
        $tabs = array(
            'pilares'  => array(
                'label'  => 'Páginas pilar',
                'method' => 'render_pilares',
                'icon'   => '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="12 2 15 8.5 22 9.3 17 14 18.5 21 12 17.5 5.5 21 7 14 2 9.3 9 8.5 12 2"/></svg>',
            ),
            'reglas'   => array(
                'label'  => 'Reglas',
                'method' => 'render_reglas',
                'icon'   => '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="9 11 12 14 22 4"/><path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11"/></svg>',
            ),
            'mapa'     => array(
                'label'  => 'Mapa de enlaces',
                'method' => '_render_exitos',
                'icon'   => '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 3v18h18"/><path d="M7 14l4-4 4 3 5-6"/></svg>',
            ),
        );

        // Stash the navigation so the active tab's FLINK_Page_Header
        // call renders it directly below the section header (option 2:
        // navigation integrated into the content, not floating on top).
        self::$pending_hubnav = self::render_hub_nav( 'flinkil-enlazado', $tab, $tabs );

        // Wrap in .il-screen so every Enlazado tab shares the same
        // page background and header position as Crear contenido.
        echo '<div class="il-screen">';
        // Delegate to the original renderer for the active tab.
        $method = $tabs[ $tab ]['method'];
        if ( method_exists( $this, $method ) ) {
            $this->$method();
        }
        echo '</div>';

        // Clear it afterwards so it never leaks into an unrelated page.
        self::$pending_hubnav = '';
    }

    /**
     * Hub renderer for "Sistema". Tabs: Bases de conocimiento (PRO),
     * Ajustes, Herramientas. Reuses the flinkil-ajustes slug as base and
     * uses `sec` as its query param (NOT `tab`) so it never collides with
     * the internal tabs the Ajustes page uses (?tab=ia, ?tab=enlazado...).
     */
    public function _render_sistema_hub() {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        $sec = isset( $_GET['sec'] ) ? sanitize_key( wp_unslash( $_GET['sec'] ) ) : 'ajustes';

        $tabs = array();
        $tabs['ajustes'] = array(
            'label'      => 'Ajustes',
            'method'     => 'render_ajustes',
            'header_key' => 'ajustes',
            'title'      => 'Ajustes',
            'subtitle'   => 'Configuración global del plugin. Los cambios se aplican inmediatamente.',
            'icon'   => '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>',
        );
        $tabs['herramientas'] = array(
            'label'      => 'Herramientas',
            'method'     => 'render_herramientas',
            'header_key' => 'herramientas',
            'title'      => 'Herramientas',
            'subtitle'   => 'Mantenimiento, copias de seguridad y monitorización del plugin.',
            'icon'   => '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg>',
        );

        if ( ! isset( $tabs[ $sec ] ) ) {
            // Requested section doesn't exist in this edition → fall back
            // to Ajustes, which is always present (Free and Paid).
            $sec = isset( $tabs['ajustes'] ) ? 'ajustes' : array_key_first( $tabs );
        }

        // Wrap in .il-screen for the shared page background, matching the
        // Enlazado and Crear contenido hubs.
        echo '<div class="il-screen">';

        // Stash the hub navigation so FLINK_Page_Header::render() paints it
        // right below the section header — same pattern as the other hubs.
        self::$pending_hubnav = self::render_hub_nav( 'flinkil-ajustes', $sec, $tabs, 'sec' );

        // Ajustes and Herramientas don't call Page_Header themselves, so the
        // hub paints their header here (icon + title + subtitle) for the same
        // look as Crear contenido. KB has header_key empty because it renders
        // its own header (and thus the navigation) on its own.
        if ( ! empty( $tabs[ $sec ]['header_key'] ) ) {
            FLINK_Page_Header::render(
                $tabs[ $sec ]['header_key'],
                $tabs[ $sec ]['title'],
                $tabs[ $sec ]['subtitle'],
                ''
            );
        }

        $method = $tabs[ $sec ]['method'];
        if ( method_exists( $this, $method ) ) {
            $this->$method();
        }

        echo '</div>';
        self::$pending_hubnav = '';
    }

    /**
     * Render the compact card-style tab navigation shared by every hub
     * (Enlazado, and later Crear contenido / Sistema). Centralised so the
     * three hubs stay visually identical and a style tweak applies once.
     *
     * @param string $page   The admin page slug (e.g. 'flinkil-enlazado').
     * @param string $active The active tab key.
     * @param array  $tabs   Map of key => [ 'label' => ..., 'icon' => ... ].
     */
    /**
     * HTML of the hub navigation for the current request, stashed by the
     * hub renderer so that FLINK_Page_Header::render() can output it right
     * below the section header. This places the navigation "inside" the
     * content (after the title) rather than floating above everything.
     *
     * @var string
     */
    public static $pending_hubnav = '';

    public static function render_hub_nav( $page, $active, $tabs, $param = 'tab' ) {
        // SVG icons are emitted via wp_kses with an explicit allow-list
        // (the same one Page_Header uses) so the stroke icons survive
        // sanitisation instead of being stripped by wp_kses_post.
        $svg_allowed = array(
            'svg'      => array( 'viewbox' => true, 'xmlns' => true, 'fill' => true, 'stroke' => true, 'stroke-width' => true, 'stroke-linecap' => true, 'stroke-linejoin' => true ),
            'path'     => array( 'd' => true, 'fill' => true ),
            'polygon'  => array( 'points' => true ),
            'polyline' => array( 'points' => true ),
            'circle'   => array( 'cx' => true, 'cy' => true, 'r' => true ),
            'line'     => array( 'x1' => true, 'y1' => true, 'x2' => true, 'y2' => true ),
            'rect'     => array( 'x' => true, 'y' => true, 'width' => true, 'height' => true, 'rx' => true ),
        );
        $html  = '<nav class="il-hubnav">';
        foreach ( $tabs as $key => $info ) {
            $url       = admin_url( 'admin.php?page=' . $page . '&' . $param . '=' . $key );
            $is_active = ( $active === $key );
            $html .= '<a href="' . esc_url( $url ) . '" class="il-hubnav-card' . ( $is_active ? ' is-active' : '' ) . '">';
            if ( ! empty( $info['icon'] ) ) {
                $html .= '<span class="il-hubnav-ic">' . wp_kses( $info['icon'], $svg_allowed ) . '</span>';
            }
            $html .= '<span class="il-hubnav-label">' . esc_html( $info['label'] ) . '</span>';
            $html .= '</a>';
        }
        $html .= '</nav>';
        return $html;
    }

    /** Proxy render functions — load module and call its render_page() */
    public function _render_onboarding() {
        // Page-specific CSS and JS — enqueued here rather than from
        // enqueue_assets() because they're only needed on this page.
        wp_enqueue_style(
            'il-page-onboarding',
            FLINK_PLUGIN_URL . 'admin/css/page-onboarding.css',
            array( 'flink-admin' ),
            filemtime( FLINK_PLUGIN_DIR . 'admin/css/page-onboarding.css' )
        );
        wp_enqueue_script(
            'il-page-onboarding',
            FLINK_PLUGIN_URL . 'admin/js/page-onboarding.js',
            array( 'jquery' ),
            filemtime( FLINK_PLUGIN_DIR . 'admin/js/page-onboarding.js' ),
            true
        );
        // Pass nonce + redirect URL via wp_localize_script — the
        // WordPress.org-compliant way to ship PHP values to a JS file.
        // PRO lands on Crear contenido (the hub); Free has no such page,
        // so it lands on the Enlazado hub instead.
        $onboarding_redirect = admin_url( 'admin.php?page=flinkil-enlazado' );
        wp_localize_script(
            'il-page-onboarding',
            'FLINK_ONBOARDING',
            array(
                'ajaxurl'     => admin_url( 'admin-ajax.php' ),
                'nonce'       => wp_create_nonce( 'flink_hide_onboarding' ),
                'redirectUrl' => $onboarding_redirect,
            )
        );

        // The view renders directly — no module needed
        echo '<div class="il-page">';
        require FLINK_PLUGIN_DIR . 'views/page-onboarding.php';
        echo '</div>';
    }
    public function _render_exitos() {
        FLINK_Link_Stats::maybe_install();
        wp_enqueue_style(
            'il-page-exitos',
            FLINK_PLUGIN_URL . 'admin/css/page-exitos.css',
            array( 'flink-admin' ),
            filemtime( FLINK_PLUGIN_DIR . 'admin/css/page-exitos.css' )
        );
        wp_enqueue_script( 'flink-exitos', FLINK_PLUGIN_URL . 'admin/js/exitos.js', array( 'jquery' ), filemtime( FLINK_PLUGIN_DIR . 'admin/js/exitos.js' ), true );
        wp_localize_script( 'flink-exitos', 'FLINK_EXITOS', array(
            'ajaxurl'  => admin_url( 'admin-ajax.php' ),
            'nonce'    => wp_create_nonce( 'flink_nonce' ),
            'semantic' => class_exists( 'FLINK_Semantic_DB' ) ? 1 : 0,
        ) );
        require FLINK_PLUGIN_DIR . 'includes/views/page-exitos.php';
    }
    private function _get_module( $id ) {
        global $flink_modules;
        return isset( $flink_modules[ $id ] ) ? $flink_modules[ $id ] : null;
    }

        public function enqueue_assets( $hook ) {
        // Match any subpage of this plugin regardless of exact hook format WordPress uses
        $is_plugin_page = ( $hook === 'toplevel_page_04-internal-linking' )
            || ( strpos( $hook, 'flinkil-' ) !== false )
            || ( strpos( $hook, '04-internal-linking' ) !== false )
            || ( strpos( $hook, 'flinkil-pilares' ) !== false );
        if ( ! $is_plugin_page ) return;
        wp_enqueue_style( 'flink-google-fonts', 'https://fonts.googleapis.com/css2?family=DM+Sans:opsz,wght@9..40,400;9..40,500;9..40,600;9..40,700&family=JetBrains+Mono:wght@400;500;600&display=swap', array(), FLINK_VERSION );
        wp_enqueue_style(  'flink-admin', FLINK_PLUGIN_URL . 'admin/css/admin.css', array( 'flink-google-fonts' ), filemtime( FLINK_PLUGIN_DIR . 'admin/css/admin.css' ) );
        // Attach the wide-screen + menu CSS as inline style on the same handle.
        // get_wide_screen_css() returns a hard-coded CSS string with no user
        // input; wp_add_inline_style() is the WordPress API for injecting
        // inline CSS and handles output safely (it is not echoed directly).
        wp_add_inline_style( 'flink-admin', $this->get_wide_screen_css() );

        // Inject the shared illustrated-header styles too — these used to
        // be emitted from a separate admin_head hook. get_styles() likewise
        // returns a static, hard-coded CSS string.
        if ( class_exists( 'FLINK_Page_Header' ) ) {
            wp_add_inline_style( 'flink-admin', FLINK_Page_Header::get_styles() );
        }

        wp_enqueue_script( 'flink-admin', FLINK_PLUGIN_URL . 'admin/js/admin.js',   array( 'jquery' ), FLINK_VERSION . '.' . filemtime( FLINK_PLUGIN_DIR . 'admin/js/admin.js' ), true );

        // Settings crawl modal — only on the Ajustes page (it depends on
        // the modal HTML rendered there).
        if ( strpos( $hook, 'flinkil-ajustes' ) !== false ) {
            wp_enqueue_script(
                'flink-settings-crawl',
                FLINK_PLUGIN_URL . 'admin/js/settings-crawl.js',
                array( 'jquery' ),
                filemtime( FLINK_PLUGIN_DIR . 'admin/js/settings-crawl.js' ),
                true
            );
            wp_enqueue_script(
                'flink-settings-tipos',
                FLINK_PLUGIN_URL . 'admin/js/settings-tipos.js',
                array( 'jquery' ),
                filemtime( FLINK_PLUGIN_DIR . 'admin/js/settings-tipos.js' ),
                true
            );
        }
        // Get active languages from Polylang (if available) for the rule form
        $active_langs = array();
        if ( class_exists( 'FLINK_Polylang_Bridge' ) ) {
            $active_langs = FLINK_Polylang_Bridge::get_active_languages();
        } elseif ( function_exists( 'pll_languages_list' ) ) {
            $slugs = pll_languages_list( array( 'fields' => 'slug' ) );
            $names = pll_languages_list( array( 'fields' => 'name' ) );
            if ( is_array( $slugs ) ) {
                foreach ( $slugs as $i => $slug ) {
                    $active_langs[] = array(
                        'slug' => $slug,
                        'name' => ( is_array( $names ) && isset( $names[ $i ] ) ) ? $names[ $i ] : strtoupper( $slug ),
                    );
                }
            }
        }

        // Detect site default language from Polylang
        $default_lang = '';
        if ( function_exists( 'pll_default_language' ) ) {
            $default_lang = pll_default_language();
        } elseif ( ! empty( $active_langs ) ) {
            $default_lang = $active_langs[0]['slug'];
        }

        wp_localize_script( 'flink-admin', 'FLINK_DATA', array(
            'rulesUrl'          => admin_url( 'admin.php?page=flinkil-reglas' ),
            'ajaxurl'           => admin_url( 'admin-ajax.php' ),
            'nonce'             => wp_create_nonce( 'flink_nonce' ),
            // Only a boolean flag is exposed — never the key itself.
            // The key stays server-side and is consumed only by AJAX
            // handlers that read it from get_option(). Exposing the
            // raw key to JS would leak it into the page DOM, browser
            // extensions and any screenshots of devtools.
            'has_openai'        => ! empty( get_option( 'flink_openai_key', '' ) ),
            'active_langs'      => $active_langs,
            'default_lang'      => $default_lang,
            'needs_processing'  => 0,
            // ── Legal URLs for the OpenAI BYOK consent modal (v4.5.0) ──
            // Auto-selects the English variants when WordPress is
            // running in any English locale (en_US, en_GB, etc.) so
            // the modal links to documents the admin can actually
            // read. Can still be overridden via `il_legal_urls`
            // filter for non-standard deployments.
            'legalUrls'         => apply_filters(
                'flink_legal_urls',
                ( 0 === strpos( get_locale(), 'en' ) )
                    ? array(
                        'privacy' => 'https://4linking.com/en/privacy-policy/',
                        'terms'   => 'https://4linking.com/en/terms-and-conditions/',
                    )
                    : array(
                        'privacy' => 'https://4linking.com/politica-de-privacidad/',
                        'terms'   => 'https://4linking.com/terminos-y-condiciones/',
                    )
            ),
        ) );
    }

    /* ══════════════════════════════════════════════════════════
       PÁGINAS PILAR
    ══════════════════════════════════════════════════════════ */
    public function render_pilares() {
        $pilares_obj  = new FLINK_Pilares();
        $all_pilares  = $pilares_obj->get_all();
        $links_map    = array();
        $total_links  = 0;
        foreach ( $all_pilares as $p ) {
            $cnt = FLINK_Stats::count_real_links_for_pilar( $p );
            $links_map[ $p->id ] = $cnt;
            $total_links += $cnt;
        }
        $total_pilares = count( $all_pilares );

        $active_langs = array();
        if ( class_exists( 'FLINK_Polylang_Bridge' ) ) {
            $active_langs = FLINK_Polylang_Bridge::get_active_languages();
        }
        $default_lang = function_exists('pll_default_language') ? pll_default_language() : ( $active_langs[0]['slug'] ?? '' );

        // Count per language for chips
        $per_lang = array();
        foreach ( $all_pilares as $p ) {
            $lg = $p->idioma ?: '';
            $per_lang[ $lg ] = ( $per_lang[ $lg ] ?? 0 ) + 1;
        }
        ?>
        <div class="il-page il-page-pilares ilpp-page">

            <!-- Header -->
            <?php
            $btn = '<button class="ilpp-btn-new" id="btn-add-pilar">'
                 . '<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>'
                 . 'Nueva página pilar'
                 . '</button>';
            FLINK_Page_Header::render(
                'pilares',
                'Páginas pilar',
                'Define las páginas clave de tu arquitectura de contenido. Las reglas de enlazado apuntarán a estas páginas.',
                $btn
            );
            ?>

            <!-- Stats bar -->
            <?php $avg_per_pilar = $total_pilares > 0 ? round( $total_links / $total_pilares, 1 ) : 0; ?>
            <div class="ilpp-stats">
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M19.07 4.93a10 10 0 0 1 0 14.14M4.93 4.93a10 10 0 0 0 0 14.14"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( $total_pilares ); ?></span>
                    <span class="ilpp-stat-l">Pilares totales</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( number_format( $total_links ) ); ?></span>
                    <span class="ilpp-stat-l">Enlaces a pilares</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="2" y1="12" x2="22" y2="12"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo count( $active_langs ); ?></span>
                    <span class="ilpp-stat-l">Idiomas activos</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18"/><path d="M3 15h18"/><path d="M9 3v18"/><path d="M15 3v18"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( $avg_per_pilar ); ?></span>
                    <span class="ilpp-stat-l">enlaces por pilar</span>
                    <span class="ilpp-stat-sub">Media por pilar</span>
                </div>
            </div>

            <!-- Form drawer -->
            <div class="ilpp-drawer" id="form-pilar" style="display:none;">
                <div class="ilpp-drawer-inner">
                    <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:16px;">
                        <div class="ilpp-drawer-title" id="ilpp-drawer-title">Nueva p&aacute;gina pilar</div>
                        <button class="ilpp-drawer-close" id="btn-cancel-pilar-x">
                            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                        </button>
                    </div>
                    <div class="ilpp-drawer-fields">
                        <div class="ilpp-field">
                            <label class="ilpp-label">Nombre <span class="ilpp-req">*</span></label>
                            <input id="pilar-nombre" type="text" class="ilpp-input" placeholder="Ej: Gu&iacute;a de enlazado interno en WordPress" autocomplete="off">
                        </div>
                        <div class="ilpp-field">
                            <label class="ilpp-label">URL</label>
                            <div class="ilpp-url-wrap" style="position:relative;">
                                <input id="pilar-url" type="text" class="ilpp-input" placeholder="/guia-enlazado-interno-wordpress/" autocomplete="off">
                                <div class="ilpp-url-suggest" id="pilar-url-suggest" style="display:none;position:absolute;top:100%;left:0;right:0;z-index:50;background:#fff;border:1px solid var(--ds-border,#e2e8f0);border-radius:8px;box-shadow:0 8px 24px rgba(0,0,0,.08);max-height:280px;overflow-y:auto;margin-top:4px;"></div>
                            </div>
                        </div>
                        <?php if ( ! empty( $active_langs ) ) : ?>
                        <div class="ilpp-field ilpp-field-sm">
                            <label class="ilpp-label">Idioma</label>
                            <select id="pilar-idioma" class="ilpp-input ilpp-select">
                                <option value="">— Todos —</option>
                                <?php foreach ( $active_langs as $lang ) : ?>
                                <option value="<?php echo esc_attr($lang['slug']); ?>"
                                    <?php echo esc_attr( $lang['slug'] === $default_lang ? 'selected' : '' ); ?>>
                                    <?php echo esc_html($lang['name']); ?>
                                </option>
                                <?php endforeach; ?>
                            </select>
                        </div>
                        <?php endif; ?>
                    </div>
                    <div class="ilpp-drawer-foot">
                        <button class="ilpp-btn-cancel" id="btn-cancel-pilar">Cancelar</button>
                        <button class="ilpp-btn-save" id="btn-save-pilar">
                            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="20 6 9 17 4 12"/></svg>
                            Guardar cambios
                        </button>
                    </div>
                </div>
            </div>

            <!-- Language filter + search (inline) -->
            <div class="ilpp-filter-bar">
                <div class="ilr-lang-filter" id="ilp-lang-filter" style="flex:1;">
                    <span class="ilpp-filter-label-text">IDIOMA</span>
                    <button class="ilr-lang-filter-btn ilr-lang-filter-active" data-lang="">
                        Todos <span class="ilr-lang-count"><?php echo esc_html( $total_pilares ); ?></span>
                    </button>
                    <?php
                    $sorted = array();
                    foreach ( $active_langs as $l ) { if ( $l['slug'] === $default_lang ) array_unshift( $sorted, $l ); else $sorted[] = $l; }
                    foreach ( $sorted as $lang ) :
                        $cnt = $per_lang[ $lang['slug'] ] ?? 0;
                    ?>
                    <button class="ilr-lang-filter-btn" data-lang="<?php echo esc_attr($lang['slug']); ?>">
                        <?php echo esc_html( strtoupper( $lang["slug"] ) ); ?> <span class="ilr-lang-count"><?php echo esc_html( $cnt ); ?></span>
                    </button>
                    <?php endforeach; ?>
                </div>
                <div class="ilpp-search-wrap">
                    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    <input type="text" id="ilp-search" class="ilpp-search-input" placeholder="Buscar pilar o URL…" autocomplete="off">
                    <button id="ilp-search-clear" class="ilpp-search-clear" style="display:none;">×</button>
                </div>
            </div>

            <!-- Table -->
            <div class="ilpp-table" id="pilares-list">
                <?php if ( empty( $all_pilares ) ) : ?>
                <div class="ilpp-empty" id="pilares-empty">
                    <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.2"><rect x="3" y="3" width="7" height="7" rx="1"/><rect x="14" y="3" width="7" height="7" rx="1"/><rect x="3" y="14" width="7" height="7" rx="1"/><rect x="14" y="14" width="7" height="7" rx="1"/></svg>
                    <p>Todav&iacute;a no hay p&aacute;ginas pilar.</p>
                    <p class="ilpp-empty-sub">Crea la primera con el bot&oacute;n "Nueva p&aacute;gina pilar".</p>
                </div>
                <?php else : ?>
                <div class="ilpp-table-head">
                    <span class="ilpp-th-lang">Idioma</span>
                    <span class="ilpp-th-name">Nombre</span>
                    <span class="ilpp-th-url">URL</span>
                    <span class="ilpp-th-links">Enlaces</span>
                    <span class="ilpp-th-acts"></span>
                </div>
                <?php
                $page_size = 100;
                $shown = 0;
                foreach ( $all_pilares as $p ) {
                    if ( $shown >= $page_size ) break;
                    echo wp_kses( $this->render_pilar_row( $p, $links_map[ $p->id ] ?? 0 ), self::admin_kses_allowed() );
                    $shown++;
                }
                ?>
                <?php endif; ?>
            </div>

            <?php if ( $total_pilares > 100 ) : ?>
            <div style="padding:14px 0;text-align:center;font-size:13px;color:var(--ds-ink3);">
                Mostrando 100 de <?php echo esc_html( $total_pilares ); ?> p&aacute;ginas pilar.
            </div>
            <?php endif; ?>

        </div>
        <?php
    }

    public function render_pilar_card( $p ) { return $this->render_pilar_row( $p, 0 ); }

    public function render_pilar_row( $p, $link_count = 0 ) {
        $idioma_upper = ! empty( $p->idioma ) ? strtoupper( $p->idioma ) : 'ALL';

        ob_start(); ?>
        <div class="ilpp-row" data-id="<?php echo esc_html( $p->id ); ?>" data-lang="<?php echo esc_attr( $p->idioma ?? '' ); ?>">
            <div class="ilpp-row-lang">
                <span class="ilpp-lang-pill"><?php echo esc_html( $idioma_upper ); ?></span>
            </div>
            <div class="ilpp-row-name">
                <?php echo esc_html( $p->nombre ); ?>
            </div>
            <div class="ilpp-row-url-cell">
                <a href="<?php echo esc_url( $p->url ); ?>" target="_blank" class="ilpp-row-url-link" title="<?php echo esc_attr( $p->url ); ?>">
                    <?php echo esc_html( $p->url ); ?>
                </a>
            </div>
            <div class="ilpp-row-links">
                <button class="ilpp-links-btn btn-pilar-detail" data-pilar-id="<?php echo esc_html( $p->id ); ?>" title="Ver posts que enlazan">
                    <span class="ilpp-links-n"><?php echo (int) $link_count; ?></span>
                    <svg width="10" height="10" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="9 18 15 12 9 6"/></svg>
                </button>
            </div>
            <div class="ilpp-row-acts">
                <button class="ilpp-act btn-edit-pilar" data-id="<?php echo esc_html( $p->id ); ?>" title="Editar">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
                </button>
                <button class="ilpp-act ilpp-act-del btn-delete-pilar" data-id="<?php echo esc_html( $p->id ); ?>" title="Eliminar">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-1 14H6L5 6"/><path d="M10 11v6M14 11v6"/><path d="M9 6V4h6v2"/></svg>
                </button>
            </div>
        </div>
        <?php return ob_get_clean();
    }

    /* ══════════════════════════════════════════════════════════
       REGLAS DE ENLAZADO
    ══════════════════════════════════════════════════════════ */
    public function render_reglas() {
        $pilares_obj = new FLINK_Pilares();
        $reglas_obj  = new FLINK_Reglas();
        $pilares     = $pilares_obj->get_all();
        $reglas      = $reglas_obj->get_all();
        $total_reglas  = count( $reglas );
        $active_count  = count( array_filter( $reglas, function($r){ return (bool)$r->activo; } ) );

        $active_langs = array();
        if ( class_exists( 'FLINK_Polylang_Bridge' ) ) {
            $active_langs = FLINK_Polylang_Bridge::get_active_languages();
        } elseif ( function_exists( 'pll_languages_list' ) ) {
            $slugs = pll_languages_list( array( 'fields' => 'slug' ) );
            $names = pll_languages_list( array( 'fields' => 'name' ) );
            foreach ( (array) $slugs as $i => $slug ) {
                $active_langs[] = array( 'slug' => $slug, 'name' => $names[$i] ?? strtoupper($slug) );
            }
        }
        $default_lang = function_exists('pll_default_language') ? pll_default_language() : ( $active_langs[0]['slug'] ?? '' );

        // Count per lang for chips
        $per_lang = array();
        foreach ( $reglas as $r ) {
            $lg = ! empty( $r->idioma ) ? $r->idioma : ( $default_lang ?: '__all__' );
            $per_lang[ $lg ] = ( $per_lang[ $lg ] ?? 0 ) + 1;
        }
        $kw_set = array_unique( array_column( $reglas, 'nombre' ) );
        ?>
        <div class="il-page ilpp-page ilrr-page">

            <!-- Header -->
            <?php
            $btn = '<button class="ilrr-btn-process" id="btn-process-pending" title="Aplicar las reglas activas a todos los posts del sitio">'
                 . '<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"/></svg>'
                 . '<span id="btn-process-label">Aplicar enlaces</span>'
                 . '</button>'
                 . '<button class="ilpp-btn-new" id="btn-add-regla">'
                 . '<svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>'
                 . 'Nueva regla'
                 . '</button>';
            FLINK_Page_Header::render(
                'reglas',
                'Reglas de enlazado',
                'Cuando una palabra clave aparezca en cualquier publicación, se convertirá automáticamente en un enlace hacia la URL o página pilar que indiques.',
                $btn
            );
            ?>

            <!-- Stats bar -->
            <?php
            $total_rule_links = 0;
            foreach ( $reglas as $_r ) {
                $total_rule_links += (int) FLINK_Stats::count_links_by_rule( $_r->id );
            }
            $avg_per_rule = $total_reglas > 0 ? round( $total_rule_links / $total_reglas, 1 ) : 0;
            $active_pct   = $total_reglas > 0 ? round( ( $active_count / $total_reglas ) * 100 ) : 0;
            ?>
            <div class="ilpp-stats">
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="8" y1="6" x2="21" y2="6"/><line x1="8" y1="12" x2="21" y2="12"/><line x1="8" y1="18" x2="21" y2="18"/><line x1="3" y1="6" x2="3.01" y2="6"/><line x1="3" y1="12" x2="3.01" y2="12"/><line x1="3" y1="18" x2="3.01" y2="18"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( $total_reglas ); ?></span>
                    <span class="ilpp-stat-l">Reglas totales</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( $active_count ); ?></span>
                    <span class="ilpp-stat-l"><?php echo esc_html( $active_pct ); ?>% en uso</span>
                    <span class="ilpp-stat-sub">Activas</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( number_format( $total_rule_links ) ); ?></span>
                    <span class="ilpp-stat-l">Enlaces generados</span>
                </div>
                <div class="ilpp-stat">
                    <div class="ilpp-stat-icon"><svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18"/><path d="M3 15h18"/><path d="M9 3v18"/><path d="M15 3v18"/></svg></div>
                    <span class="ilpp-stat-n"><?php echo esc_html( $avg_per_rule ); ?></span>
                    <span class="ilpp-stat-l">enlaces</span>
                    <span class="ilpp-stat-sub">Media por regla</span>
                </div>
            </div>

            <!-- Progress bar -->
            <div id="il-process-bar" style="display:none;" class="ilrr-progress-wrap">
                <div class="ilrr-progress-head">
                    <span id="il-progress-title">Procesando posts…</span>
                    <span id="il-progress-pct">0%</span>
                </div>
                <div class="ilrr-progress-track"><div class="ilrr-progress-fill" id="il-progress-fill"></div></div>
                <div class="ilrr-progress-sub" id="il-progress-sub">Preparando…</div>
            </div>

            <!-- Form panel (same drawer style as pilares) -->
            <div class="ilpp-drawer ilrr-form-panel" id="form-regla" style="display:none;">
                <div class="ilpp-drawer-inner">
                    <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:16px;">
                        <div class="ilpp-drawer-title" id="form-regla-title">Nueva regla</div>
                        <button class="ilrr-panel-close" id="btn-cancel-regla">
                            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                        </button>
                    </div>
                    <input type="hidden" id="regla-id">

                    <!-- Row 1: idioma + prioridad + max -->
                    <div class="ilrr-form-row1">
                        <div class="ilrr-form-field">
                            <label class="ilpp-label">Idioma</label>
                            <select id="regla-idioma" class="ilpp-input ilpp-select">
                                <?php foreach ( $active_langs as $lang ) : ?>
                                <option value="<?php echo esc_attr( $lang['slug'] ); ?>"
                                    <?php echo esc_attr( $lang['slug'] === $default_lang ? 'selected' : '' ); ?>>
                                    <?php echo esc_html( $lang['name'] ); ?>
                                    <?php echo esc_html( $lang['slug'] === $default_lang ? ' ✶' : '' ); ?>
                                </option>
                                <?php endforeach; ?>
                                <?php if ( empty( $active_langs ) ) : ?>
                                <option value="">Todos los idiomas</option>
                                <?php endif; ?>
                            </select>
                        </div>
                        <div class="ilrr-form-field">
                            <label class="ilpp-label">Prioridad <span class="ilrr-prio-num" id="prio-display">50</span></label>
                            <div class="ilrr-range-wrap">
                                <input type="range" id="regla-prioridad-range" min="1" max="100" value="50" class="ilrr-range">
                                <input type="number" id="regla-prioridad" min="1" max="100" value="50" class="ilrr-num-input">
                            </div>
                        </div>
                        <div class="ilrr-form-field ilrr-form-field-xs">
                            <label class="ilpp-label">Máx. enlaces / post</label>
                            <input type="number" id="regla-max" min="1" max="20" value="1" class="ilpp-input" style="width:70px;">
                        </div>
                        <?php
                        ?>
                    </div>

                    <!-- Row 2: keyword + sinónimos + destino -->
                    <div class="ilrr-form-row2">
                        <div class="ilrr-form-field" style="flex:1;">
                            <label class="ilpp-label">Keyword <span class="ilpp-req">*</span></label>
                            <input id="regla-keyword" type="text" class="ilpp-input" autocomplete="off" placeholder="ej: seguro de salud">
                        </div>
                        <div class="ilrr-form-field" style="flex:1.4;position:relative;">
                                <label class="ilpp-label">
                                    Sinónimos
                                    <span style="font-weight:400;color:#8e8e99;">(uno por línea)</span>
                                </label>
                                <textarea id="regla-sinonimos" class="ilpp-input ilrr-synonyms"
                                    placeholder="seguro médico&#10;cobertura médica&#10;póliza de salud"></textarea>
                                <div class="ilrr-ai-status" id="ai-status" style="display:none;"></div>
                        </div>
                        <div class="ilrr-form-field" style="flex:1.2;">
                            <label class="ilpp-label">Página pilar destino</label>
                            <select id="regla-pilar-id" class="ilpp-input ilpp-select" style="margin-bottom:6px;">
                                <option value="">— seleccionar pilar —</option>
                            </select>
                            <label class="ilpp-label" style="margin-top:4px;">O URL directa</label>
                            <input type="text" id="regla-url-manual" class="ilpp-input" placeholder="https://…" autocomplete="off">
                        </div>
                    </div>

                    <!-- Ayuda desplegable -->
                    <div class="ilrr-help-toggle-row">
                        <button type="button" class="ilrr-help-toggle-btn" id="ilrf-help-toggle">
                            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>
                            ¿Cómo funcionan las reglas?
                        </button>
                    </div>
                    <div class="ilrr-help-body" id="ilrf-help-panel" style="display:none;">
                        <p><strong>Keyword:</strong> la palabra exacta que el plugin buscará en cada artículo y convertirá en enlace.</p>
                        <p><strong>Sinónimos:</strong> variantes que también generarán el mismo enlace (plurales, géneros, expresiones relacionadas).</p>
                        <p><strong>Idioma:</strong> la regla solo se aplica a posts escritos en ese idioma (detectado via Polylang).</p>
                        <p><strong>Prioridad:</strong> cuando varias reglas compiten por el mismo post, las de mayor prioridad se aplican primero.</p>
                        <p><strong>Máx. enlaces / post:</strong> cuántas veces puede insertarse este enlace en un mismo artículo.</p>
                    </div>

                    <div class="ilpp-drawer-foot">
                        <button class="ilpp-btn-cancel" id="btn-cancel-regla-2">Cancelar</button>
                        <button class="ilpp-btn-save" id="btn-save-regla">
                            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="20 6 9 17 4 12"/></svg>
                            Guardar regla
                        </button>
                    </div>
                </div>
            </div>

            <!-- Language filter bar -->
            <div class="ilr-lang-filter" id="ilr-lang-filter">
                <button class="ilr-lang-filter-btn ilr-lang-filter-active" data-lang="">
                    <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><line x1="8" y1="6" x2="21" y2="6"/><line x1="8" y1="12" x2="21" y2="12"/><line x1="8" y1="18" x2="21" y2="18"/><line x1="3" y1="6" x2="3.01" y2="6"/><line x1="3" y1="12" x2="3.01" y2="12"/><line x1="3" y1="18" x2="3.01" y2="18"/></svg>
                    Todos
                </button>
                <?php
                $sorted = array();
                foreach ( $active_langs as $l ) { if ( $l['slug'] === $default_lang ) array_unshift( $sorted, $l ); else $sorted[] = $l; }
                foreach ( $sorted as $lang ) :
                    $is_def = $lang['slug'] === $default_lang;
                ?>
                <button class="ilr-lang-filter-btn<?php echo esc_attr( $is_def ? ' ilr-filter-default' : '' ); ?>"
                    data-lang="<?php echo esc_attr($lang['slug']); ?>">
                    <?php echo esc_html($lang['name']); ?>
                    <?php if ( $is_def ) : ?><span class="ilr-default-star">✶</span><?php endif; ?>
                </button>
                <?php endforeach; ?>
                <span class="ilr-filter-sep"></span>
                <button class="ilr-lang-filter-btn ilr-filter-disabled-btn" id="ilr-filter-disabled" data-lang="" data-disabled-filter="1">
                    <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="4.93" y1="4.93" x2="19.07" y2="19.07"/></svg>
                    Solo activas
                </button>
            </div>

            <!-- Search + results -->
            <div class="ilpp-search-bar">
                <div class="ilpp-search-wrap" style="flex:1;">
                    <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>
                    <input type="text" id="ilr-search" class="ilpp-search-input" placeholder="Buscar keyword o URL…" autocomplete="off">
                    <button id="ilr-search-clear" class="ilpp-search-clear" title="Limpiar" style="display:none;">&times;</button>
                </div>
                <span class="ilpp-results-label" id="ilrr-results-label"><?php echo esc_html( $total_reglas ); ?> resultados</span>
            </div>

            <!-- Table -->
            <div class="ilpp-table" id="reglas-list">
                <?php if ( empty( $reglas ) ) : ?>
                <div class="ilpp-empty">
                    <svg width="40" height="40" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.2"><path d="M9 3H5a2 2 0 0 0-2 2v4"/><path d="M9 3h10a2 2 0 0 1 2 2v4"/><path d="M3 9v10a2 2 0 0 0 2 2h4"/><path d="M21 9v10a2 2 0 0 1-2 2h-4"/><line x1="9" y1="12" x2="15" y2="12"/><line x1="12" y1="9" x2="12" y2="15"/></svg>
                    <p>Todavía no hay reglas de enlazado.</p>
                    <p class="ilpp-empty-sub">Crea la primera con el botón "Nueva regla".</p>
                </div>
                <?php else : ?>

                <!-- Bulk actions bar (appears when at least one row is selected) -->
                <div class="ilrr-bulk-bar" id="ilrr-bulk-bar" style="display:none;">
                    <span class="ilrr-bulk-count"><span id="ilrr-bulk-n">0</span> seleccionadas</span>
                    <div class="ilrr-bulk-actions">
                        <button type="button" class="ilrr-bulk-btn" id="ilrr-bulk-activate">
                            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="20 6 9 17 4 12"/></svg>
                            Activar
                        </button>
                        <button type="button" class="ilrr-bulk-btn" id="ilrr-bulk-deactivate">
                            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                            Desactivar
                        </button>
                        <button type="button" class="ilrr-bulk-btn ilrr-bulk-btn-danger" id="ilrr-bulk-delete">
                            <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-1 14H6L5 6"/><path d="M10 11v6M14 11v6"/></svg>
                            Eliminar
                        </button>
                    </div>
                    <button type="button" class="ilrr-bulk-clear" id="ilrr-bulk-clear" title="Deseleccionar todas">
                        <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                    </button>
                </div>

                <div class="ilrr-table-head">
                    <span class="ilrr-th-sel">
                        <label class="ilrr-sel">
                            <input type="checkbox" class="ilrr-sel-cb" id="ilrr-sel-all">
                            <span class="ilrr-sel-box"></span>
                        </label>
                    </span>
                    <span>Idioma</span>
                    <span>Keyword</span>
                    <span>Sin&oacute;nimos</span>
                    <span>Pilar / URL</span>
                    <span class="ilrr-th-center">Prioridad</span>
                    <span class="ilrr-th-center">M&aacute;x</span>
                    <span class="ilrr-th-center">Enlaces</span>
                    <span class="ilrr-th-center">Estado</span>
                    <span></span>
                </div>
                <?php foreach ( $reglas as $r ) : ?>
                    <?php echo wp_kses( $this->render_regla_item( $r, $pilares, $active_langs, $default_lang ), self::admin_kses_allowed() ); ?>
                <?php endforeach; ?>
                <?php endif; ?>
            </div>

        </div>
        <?php
    }

    public function render_regla_item( $r, $pilares, $active_langs = array(), $default_lang = '' ) {
        // Resolve destination
        $pilar_nombre = '—';
        $dest_href    = '';
        $dest_url     = '';
        if ( ! empty( $r->destino_valor ) ) {
            $pilar_nombre = '—';
            $dest_url     = $r->destino_valor;
            $dest_href    = esc_url( $r->destino_valor );
        } else {
            foreach ( $pilares as $p ) {
                if ( (int) $p->id === (int) $r->pilar_id ) {
                    $pilar_nombre = $p->nombre;
                    $dest_url     = $p->url;
                    $dest_href    = esc_url( $p->url );
                    break;
                }
            }
        }

        $keyword   = ! empty( $r->nombre ) ? $r->nombre : '—';
        $prio      = (int) $r->prioridad;
        $max_links = (int) ( $r->max_enlaces ?? 1 );
        $active    = (bool) $r->activo;
        $prio_cls  = $prio >= 75 ? 'hi' : ( $prio >= 40 ? 'mid' : 'lo' );

        // Synonyms
        $syn_list = array();
        $syn_text = '';
        if ( ! empty( $r->descripcion ) ) {
            $syn_list = array_filter( array_map( 'trim', explode( "\n", $r->descripcion ) ) );
            $syn_text = esc_attr( strtolower( $r->descripcion ) );
        }

        // Link count
        $link_count = (int) FLINK_Stats::count_links_by_rule( $r->id );

        $idioma_slug  = ! empty( $r->idioma ) ? $r->idioma : ( $default_lang ?: '' );
        $idioma_upper = $idioma_slug ? strtoupper( $idioma_slug ) : 'ALL';

        ob_start(); ?>
        <div class="ilrr-row <?php echo esc_attr( $active ? '' : 'ilrr-row-off' ); ?>"
             data-id="<?php echo esc_html( $r->id ); ?>"
             data-lang="<?php echo esc_attr( $idioma_slug ); ?>"
             data-synonyms="<?php echo esc_html( $syn_text ); ?>">

            <!-- Selector -->
            <div class="ilrr-cell ilrr-cell-sel">
                <label class="ilrr-sel">
                    <input type="checkbox" class="ilrr-sel-cb" data-id="<?php echo esc_html( $r->id ); ?>">
                    <span class="ilrr-sel-box"></span>
                </label>
            </div>

            <!-- Idioma -->
            <div class="ilrr-cell ilrr-cell-lang">
                <span class="ilrr-lang-badge"><?php echo esc_html( $idioma_upper ); ?></span>
            </div>

            <!-- Keyword -->
            <div class="ilrr-cell ilrr-cell-kw">
                <span class="ilrr-kw"><?php echo esc_html( $keyword ); ?></span>
            </div>

            <!-- Sinónimos -->
            <div class="ilrr-cell ilrr-cell-syn">
                <?php if ( ! empty( $syn_list ) ) : ?>
                    <?php foreach ( array_slice( $syn_list, 0, 3 ) as $syn ) : ?>
                    <span class="ilrr-syn-pill"><?php echo esc_html( $syn ); ?></span>
                    <?php endforeach; ?>
                    <?php if ( count( $syn_list ) > 3 ) : ?>
                    <span class="ilrr-syn-pill ilrr-syn-more">+<?php echo count( $syn_list ) - 3; ?></span>
                    <?php endif; ?>
                <?php else : ?>
                    <span class="ilrr-no-syn">sin sin&oacute;nimos</span>
                <?php endif; ?>
            </div>

            <!-- Pilar / URL -->
            <div class="ilrr-cell ilrr-cell-dest">
                <?php if ( $dest_href ) : ?>
                <div class="ilrr-dest-name"><?php echo esc_html( $pilar_nombre !== '—' ? $pilar_nombre : '' ); ?></div>
                <a href="<?php echo esc_html( $dest_href ); ?>" class="ilrr-dest-url" target="_blank"><?php echo esc_html( $dest_url ); ?></a>
                <?php else : ?>
                <span class="ilrr-no-syn">—</span>
                <?php endif; ?>
            </div>

            <!-- Prioridad -->
            <div class="ilrr-cell ilrr-cell-prio">
                <span class="ilrr-prio-badge ilrr-prio-<?php echo esc_html( $prio_cls ); ?>"><?php echo esc_html( $prio ); ?></span>
            </div>

            <!-- Máx -->
            <div class="ilrr-cell ilrr-cell-max">
                <?php echo esc_html( $max_links ); ?>
            </div>

            <!-- Enlaces -->
            <div class="ilrr-cell ilrr-cell-links">
                <?php if ( $link_count > 0 ) : ?>
                <button class="ilrr-links-btn btn-rule-link-detail" data-rule-id="<?php echo esc_html( $r->id ); ?>" data-keyword="<?php echo esc_attr( $keyword ); ?>">
                    <?php echo esc_html( number_format( $link_count ) ); ?>
                </button>
                <?php else : ?>
                —
                <?php endif; ?>
            </div>

            <!-- Toggle activo/inactivo -->
            <div class="ilrr-cell ilrr-cell-toggle">
                <button class="ilrr-toggle btn-toggle-regla <?php echo esc_attr( $active ? 'ilrr-toggle-on' : 'ilrr-toggle-off' ); ?>"
                    data-id="<?php echo esc_html( $r->id ); ?>" title="<?php echo $active ? 'Desactivar regla' : 'Activar regla'; ?>">
                    <span class="ilrr-toggle-dot"></span>
                </button>
            </div>

            <!-- Acciones -->
            <div class="ilrr-cell ilrr-cell-acts">
                <button class="ilpp-act btn-edit-regla" data-id="<?php echo esc_html( $r->id ); ?>" title="Editar">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
                </button>
                <button class="ilpp-act btn-reprocess-regla" data-id="<?php echo esc_html( $r->id ); ?>" title="Reprocesar regla en todos los posts">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"/></svg>
                </button>
                <button class="ilpp-act ilpp-act-del btn-delete-regla" data-id="<?php echo esc_html( $r->id ); ?>" title="Eliminar">
                    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-1 14H6L5 6"/><path d="M10 11v6M14 11v6"/><path d="M9 6V4h6v2"/></svg>
                </button>
            </div>

        </div>
        <?php return ob_get_clean();
    }


    /* ══════════════════════════════════════════════════════════
       URLs EXCLUIDAS — redesign completo
    ══════════════════════════════════════════════════════════ */
    public function render_exclusiones() {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( isset( $_POST['flink_exc_action'] ) && check_admin_referer( 'flink_exclusiones_nonce' ) ) {
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            if ( $_POST['flink_exc_action'] === 'add' && ! empty( $_POST['flink_exc_url'] ) ) {
                // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
                $exc_url  = sanitize_text_field( wp_unslash( $_POST['flink_exc_url'] ) );
                $added    = FLINK_Exclusiones::add( $exc_url );
                if ( $added ) {
                    // Exclusion = this page stops generating outgoing links.
                    // Strip all outgoing plugin links from the excluded post itself.
                    // Other posts that link TO this page are NOT affected — incoming links are allowed.
                    $linker  = new FLINK_Linker();
                    $linker->init_for_batch();
                    $stripped = $linker->strip_links_for_exclusion( $exc_url );
                    update_option( 'flink_needs_processing', 1, false );
                    $msg      = 'URL añadida a exclusiones' . ( $stripped > 0 ? '. Se han eliminado los enlaces salientes de ' . $stripped . ' artículo' . ( $stripped !== 1 ? 's' : '' ) : '' ) . '.';
                    $msg_type = 'ok';
                } else {
                    $msg_type = 'warn';
                    $msg      = 'Esa URL ya estaba excluida.';
                }
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            } elseif ( $_POST['flink_exc_action'] === 'remove' && ! empty( $_POST['flink_exc_url_remove'] ) ) {
                // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
                FLINK_Exclusiones::remove( sanitize_text_field( wp_unslash( $_POST['flink_exc_url_remove'] ) ) );
                $msg_type = 'ok';
                update_option( 'flink_needs_processing', 1, false );
                $msg      = 'URL eliminada de la lista. A partir de ahora esta página volverá a generar enlaces salientes normalmente.';
            }
        }
        $exclusiones = FLINK_Exclusiones::get_all();
        $count       = count( $exclusiones );
        ?>
        <div class="il-page il-page-exc">

            <?php
            $actions = '';
            if ( $count > 0 ) {
                $plural  = $count !== 1 ? 's' : '';
                $actions = '<div class="ilx-count-pill">' . (int) $count . ' URL' . $plural . ' excluida' . $plural . '</div>';
            }
            FLINK_Page_Header::render(
                'exclusiones',
                'URLs excluidas',
                'Las páginas que añadas aquí no recibirán enlaces salientes generados por el plugin. Sí podrán seguir recibiendo enlaces entrantes desde otros artículos.',
                $actions
            );
            ?>

            <?php if ( ! empty( $msg ) ) : ?>
            <div class="ilx-alert ilx-alert-<?php echo esc_html( $msg_type ); ?>">
                <?php if ( $msg_type === 'ok' ) : ?>
                    <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polyline points="20 6 9 17 4 12"/></svg>
                <?php else : ?>
                    <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>
                <?php endif; ?>
                <?php echo esc_html( $msg ); ?>
            </div>
            <?php if ( $msg_type === 'ok' ) : ?>
            <div class="ilx-process-notice">
                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>
                <div>
                    <strong>Nota:</strong> al excluir una página, sus enlaces salientes se eliminan automáticamente. Si la reactivas, usa "Procesar posts" para regenerarlos.
                    Los nuevos artículos sí los respetarán, pero los existentes necesitan reprocesarse.
                </div>
                <a href="<?php echo esc_url( admin_url( 'admin.php?page=flinkil-reglas' ) ); ?>" class="ilx-process-btn">
                    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><polygon points="5 3 19 12 5 21 5 3"/></svg>
                    Ir a Reglas y procesar posts
                </a>
            </div>
            <?php endif; ?>
            <?php endif; ?>

            <div class="ilx-layout ilx-layout-wide">

                <!-- Panel izquierdo: formulario -->
                <div class="ilx-panel-add">
                    <div class="ilx-panel-header">
                        <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="12" y1="5" x2="12" y2="19"/><line x1="5" y1="12" x2="19" y2="12"/></svg>
                        Excluir una URL
                    </div>
                    <div class="ilx-panel-body">
                        <form method="post">
                            <?php wp_nonce_field( 'flink_exclusiones_nonce' ); ?>
                            <input type="hidden" name="flink_exc_action" value="add">
                            <div class="ilx-field">
                                <label class="ilx-label">URL de la página</label>
                                <div class="ilx-input-wrap">
                                    <svg class="ilx-input-icon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg>
                                    <input type="text" name="flink_exc_url" class="ilx-input"
                                        placeholder="/mi-pagina/"
                                        autocomplete="off" spellcheck="false">
                                </div>
                            </div>
                            <p class="ilx-hint">Ruta relativa <code>/mi-pagina/</code> o URL completa <code>https://...</code></p>
                            <button type="submit" class="ilx-btn-add">Añadir a la lista</button>
                        </form>
                    </div>
                    <div class="ilx-panel-info">
                        <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>
                        <span>Las páginas excluidas <strong>no insertan</strong> enlaces salientes hacia páginas pilar. Sí pueden <strong>seguir recibiendo</strong> enlaces entrantes desde otros artículos. Al excluir una URL, se eliminan los enlaces salientes que esa página ya tenía insertados.</span>
                    </div>
                </div>

                <!-- Panel derecho: lista -->
                <div class="ilx-panel-list">
                    <?php if ( empty( $exclusiones ) ) : ?>
                        <div class="ilx-empty">
                            <div class="ilx-empty-icon">
                                <svg width="26" height="26" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><circle cx="12" cy="12" r="10"/><line x1="4.93" y1="4.93" x2="19.07" y2="19.07"/></svg>
                            </div>
                            <p class="ilx-empty-title">Sin exclusiones activas</p>
                            <p class="ilx-empty-sub">El plugin aplicará el enlazado en todos los contenidos publicados</p>
                        </div>
                    <?php else : ?>
                        <div class="ilx-list-head">
                            <span>#</span>
                            <span>URL excluida</span>
                            <span></span>
                        </div>
                        <?php foreach ( $exclusiones as $i => $url ) : ?>
                        <div class="ilx-item">
                            <span class="ilx-item-num"><?php echo (int) ( $i + 1 ); ?></span>
                            <span class="ilx-item-url"><?php echo esc_html( $url ); ?></span>
                            <form method="post">
                                <?php wp_nonce_field( 'flink_exclusiones_nonce' ); ?>
                                <input type="hidden" name="flink_exc_action"     value="remove">
                                <input type="hidden" name="flink_exc_url_remove" value="<?php echo esc_attr( $url ); ?>">
                                <button type="submit" class="ilx-remove">
                                    <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>
                                    Eliminar
                                </button>
                            </form>
                        </div>
                        <?php endforeach; ?>
                        <div class="ilx-list-footer"><?php echo esc_html( $count ); ?> URL<?php echo $count !== 1 ? 's' : ''; ?> en la lista de exclusión</div>
                    <?php endif; ?>
                </div>

            </div><!-- /.ilx-layout -->

        </div>
        <?php
    }

    /* ══════════════════════════════════════════════════════════
       HERRAMIENTAS
    ══════════════════════════════════════════════════════════ */
    public function render_herramientas() {
        $export_url = wp_nonce_url( admin_url( 'admin.php?flink_action=export' ), 'flink_export' );
        $csv_url    = wp_nonce_url( admin_url( 'admin.php?flink_action=export_rules_csv' ), 'flink_export_rules_csv' );
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        $active_tab = $_GET['tab'] ?? 'herramientas';
        ?>
        <div class="il-page il-page-md">

            <!-- Tab bar -->
            <div class="ilh-tabs">
                <a href="<?php echo esc_url( admin_url('admin.php?page=flinkil-herramientas&tab=herramientas') ); ?>"
                   class="ilh-tab <?php echo esc_attr( $active_tab === 'herramientas' ? 'ilh-tab-active' : '' ); ?>">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>
                    Copias de seguridad
                </a>
                <a href="<?php echo esc_url( admin_url('admin.php?page=flinkil-herramientas&tab=exclusiones') ); ?>"
                   class="ilh-tab <?php echo esc_attr( $active_tab === 'exclusiones' ? 'ilh-tab-active' : '' ); ?>">
                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><line x1="4.93" y1="4.93" x2="19.07" y2="19.07"/></svg>
                    URLs excluidas
                </a>
            </div>

            <?php if ( $active_tab === 'exclusiones' ) {
                $this->render_exclusiones(); return;
            } ?>

            <div class="ilh-grid">

                <!-- BACKUP COMPLETO JSON -->
                <div class="ilh-card">
                    <div class="ilh-card-header">
                        <div class="ilh-card-icon ilh-icon-blue">
                            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>
                        </div>
                        <div>
                            <div class="ilh-card-title">Copia de seguridad</div>
                            <div class="ilh-card-sub">Exporta todo el plugin en un .json. Al restaurar, podrás elegir qué partes recuperar.</div>
                        </div>
                    </div>
                    <div class="ilh-card-body">
                        <div class="ilh-two-col">

                            <!-- ── EXPORT ─────────────────────────── -->
                            <div class="ilh-panel">
                                <div class="ilh-panel-title">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
                                    Exportar
                                </div>
                                <p class="ilh-panel-desc">Genera un <code>.json</code> que contiene todo lo que has personalizado en el plugin.</p>
                                <ul class="ilh-checklist">
                                    <li class="ok">Páginas pilar y reglas</li>
                                    <li class="ok">URLs excluidas</li>
                                    <li class="ok">Plantillas de imagen y contenido</li>
                                    <li class="ok">Bases de conocimiento y fichas</li>
                                    <li class="ok">Automatizaciones programadas</li>
                                    <li class="ok">Ajustes globales</li>
                                    <li class="no">API key de OpenAI (seguridad)</li>
                                </ul>
                                <a href="<?php echo esc_url( $export_url ); ?>" class="ilh-btn ilh-btn-primary">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
                                    Descargar backup .json
                                </a>
                            </div>

                            <!-- ── IMPORT ─────────────────────────── -->
                            <div class="ilh-panel">
                                <div class="ilh-panel-title">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    Restaurar
                                </div>
                                <p class="ilh-panel-desc">Sube un <code>.json</code> exportado del plugin. Te mostraremos lo que contiene y elegirás qué restaurar.</p>

                                <!-- 1. File picker — initial state.
                                     Two ways to provide the file:
                                       - Drag the .json onto the dropzone
                                       - Or click the "Seleccionar archivo" button
                                     Both end up triggering the same hidden
                                     file input, so the rest of the flow is
                                     identical regardless of which one you used. -->
                                <div class="ilh-dropzone" id="ilie-file-area" onclick="if(!event.target.matches('input')){document.getElementById('ilie-file-input').click();}">
                                    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><polyline points="12 18 12 12"/><polyline points="9 15 12 12 15 15"/></svg>
                                    <span id="ilie-file-label">Arrastra el .json aquí</span>
                                    <input type="file" id="ilie-file-input" accept=".json" style="display:none;">
                                </div>
                                <div class="ilie-import-status" id="ilie-import-status" style="display:none;"></div>

                                <!-- 2. Preview panel — shown after file is parsed -->
                                <div class="ilie-preview" id="ilie-preview" style="display:none;">
                                    <div class="ilie-preview-meta" id="ilie-preview-meta"></div>
                                    <div class="ilie-preview-title">Selecciona qué quieres restaurar:</div>
                                    <div class="ilie-preview-list" id="ilie-preview-list">
                                        <!-- Populated by JS based on counts -->
                                    </div>
                                    <div class="ilh-import-modes">
                                        <label class="ilh-radio"><input type="radio" name="ilie_mode" value="merge" checked><span><strong>Combinar</strong> — añade sin eliminar lo existente</span></label>
                                        <label class="ilh-radio"><input type="radio" name="ilie_mode" value="replace"><span><strong>Reemplazar</strong> — borra las secciones seleccionadas antes de importar</span></label>
                                    </div>
                                    <div style="display:flex;gap:8px;align-items:center;margin-top:12px;">
                                        <button class="ilh-btn ilh-btn-primary" id="ilie-btn-import" disabled>
                                            <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                            <span id="ilie-btn-import-label">Restaurar selección</span>
                                        </button>
                                        <button type="button" class="ilh-btn" id="ilie-btn-cancel">Cancelar</button>
                                    </div>
                                </div>
                            </div>
                        </div>
                    </div>
                </div>

                <!-- REGLAS CSV -->
                <div class="ilh-card">
                    <div class="ilh-card-header">
                        <div class="ilh-card-icon ilh-icon-green">
                            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg>
                        </div>
                        <div>
                            <div class="ilh-card-title">Reglas de enlazado — CSV</div>
                            <div class="ilh-card-sub">Exporta e importa reglas desde Excel o cualquier hoja de cálculo</div>
                        </div>
                    </div>
                    <div class="ilh-card-body">
                        <div class="ilh-two-col">
                            <div class="ilh-panel">
                                <div class="ilh-panel-title">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
                                    Exportar reglas a CSV
                                </div>
                                <p class="ilh-panel-desc">Descarga todas las reglas en formato <code>.csv</code> compatible con Excel, Google Sheets o LibreOffice.</p>
                                <a href="<?php echo esc_url( $csv_url ); ?>" class="ilh-btn ilh-btn-green">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="17 8 12 3 7 8"/><line x1="12" y1="3" x2="12" y2="15"/></svg>
                                    Descargar CSV
                                </a>
                            </div>
                            <div class="ilh-panel">
                                <div class="ilh-panel-title">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    Importar reglas desde CSV
                                </div>
                                <p class="ilh-panel-desc">Sube un <code>.csv</code> con el formato indicado. Filas con la misma keyword actualizan la regla existente.</p>
                                <details class="ilh-csv-guide">
                                    <summary>&#128203; Ver estructura requerida del CSV</summary>
                                    <div class="ilh-csv-guide-body">
                                        <p>La primera fila debe ser la cabecera con estas columnas:</p>
                                        <table class="ilh-csv-table">
                                            <thead><tr><th>Columna</th><th>Obligatorio</th><th>Descripci&oacute;n</th><th>Ejemplo</th></tr></thead>
                                            <tbody>
                                                <tr><td><code>keyword</code></td><td>&#10003;</td><td>Palabra exacta a enlazar</td><td>seguro de salud</td></tr>
                                                <tr><td><code>sinonimos</code></td><td></td><td>Sin&oacute;nimos separados por | (pipe)</td><td>seguro m&eacute;dico|cobertura</td></tr>
                                                <tr><td><code>url_destino</code></td><td>&#10003;</td><td>URL completa de destino</td><td>https://web.com/seguros/</td></tr>
                                                <tr><td><code>idioma</code></td><td></td><td>C&oacute;digo de idioma (es, en, fr&hellip;)</td><td>es</td></tr>
                                                <tr><td><code>prioridad</code></td><td></td><td>N&uacute;mero 1&ndash;100. Por defecto: 50</td><td>80</td></tr>
                                                <tr><td><code>max_enlaces</code></td><td></td><td>M&aacute;x. enlaces por post. Por defecto: 1</td><td>2</td></tr>
                                                <tr><td><code>activo</code></td><td></td><td>1 = activa, 0 = desactivada</td><td>1</td></tr>
                                            </tbody>
                                        </table>
                                        <p class="ilh-csv-note">&#128161; El separador puede ser coma o punto y coma &mdash; se detecta autom&aacute;ticamente. Columnas en cualquier orden.</p>
                                    </div>
                                </details>
                                <div class="ilh-import-modes" style="margin-top:12px;">
                                    <label class="ilh-radio"><input type="radio" name="ilcsv_mode" value="merge" checked><span><strong>Combinar</strong> &mdash; a&ntilde;ade sin eliminar existentes</span></label>
                                    <label class="ilh-radio"><input type="radio" name="ilcsv_mode" value="replace"><span><strong>Reemplazar</strong> &mdash; elimina todas las reglas antes de importar</span></label>
                                </div>
                                <div class="ilh-dropzone" id="ilcsv-file-area">
                                    <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><polyline points="12 18 12 12"/><polyline points="9 15 12 12 15 15"/></svg>
                                    <span id="ilcsv-file-label">Arrastra el .csv aqu&iacute; o haz clic</span>
                                    <input type="file" id="ilcsv-file-input" accept=".csv,.txt" style="display:none;">
                                </div>
                                <button type="button" class="ilh-btn ilh-btn-primary" id="ilcsv-btn-browse">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/></svg>
                                    Seleccionar archivo
                                </button>
                                <div id="ilcsv-import-status" class="ilie-import-status" style="display:none;"></div>
                                <button class="ilh-btn ilh-btn-green" id="ilcsv-btn-import">
                                    <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><polyline points="7 10 12 15 17 10"/><line x1="12" y1="15" x2="12" y2="3"/></svg>
                                    Importar reglas
                                </button>
                            </div>
                        </div>
                    </div>
                </div>

            </div>
        </div>
        <?php
    }

    /* ══════════════════════════════════════════════════════════
       AJUSTES
    ══════════════════════════════════════════════════════════ */
    public function render_ajustes() {
        $openai_key  = get_option( 'flink_openai_key', '' );
        $key_saved   = ! empty( $openai_key );

        // Display a redacted preview of the saved key. We show the first
        // 7 chars (the "sk-proj-" or "sk-" prefix that lets users tell
        // their keys apart) plus the last 4 (a verification suffix) and
        // bullet out the middle. This preview is for the admin's eyes
        // only — the real key never reaches the form input.
        $key_display = '';
        if ( $key_saved ) {
            $len = strlen( $openai_key );
            if ( $len > 14 ) {
                $key_display = substr( $openai_key, 0, 7 )
                             . str_repeat( '•', 16 )
                             . substr( $openai_key, -4 );
            } else {
                // Unusually short key; just show bullets
                $key_display = str_repeat( '•', max( 8, $len ) );
            }
        }

        // Default tab is "Módulos" in Paid (showcases the modules system),
        // "enlazado" in Free (the only feature configurable from Ajustes).
        // The strip script removes the Paid line; Free keeps the fallback.
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( ! isset( $active_tab ) ) $active_tab = sanitize_key( wp_unslash( $_GET['tab'] ?? 'enlazado' ) );
        // Back-compat redirects: keep old bookmarks working after
        // tab merges/removals.
        if ( $active_tab === 'semantico' ) {
            // Old "Enlazado semántico" tab → merged into "Enlazado".
            $active_tab = 'enlazado';
        }
        if ( $active_tab === 'actividad' ) {
            // "Actividad" tab was removed entirely.
            if ( ! isset( $active_tab ) || $active_tab === 'actividad' ) $active_tab = 'enlazado';
        }
        $base_url    = admin_url( 'admin.php?page=flinkil-ajustes' );
        // Each tab has a small SVG icon that fits the vertical sidebar layout.
        // Icons are minimal (no fill, stroke 2) to match the rest of the plugin's design system.
        //
        // Order is intentional and groups tabs by mental model:
        //   Group 1 (essential): Módulos, OpenAI
        //   Group 2 (per feature): Enlazado, Contenido e imágenes
        //   Group 3 (advanced): Cron, General
        // The visual separator between groups is rendered in the loop below
        // by reading the '_group' marker on each tab.
        $tabs = array(
            'enlazado'         => array(
                'label' => 'Enlazado',
                'icon'  => '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg>',
                '_group' => 2,
            ),
            'generales'        => array(
                // Renamed "Generales" → "General" (singular).
                'label' => 'General',
                'icon'  => '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>',
                '_group' => 3,
            ),
        );
        ?>
        <div class="il-page il-page-std ilset-page">

            <!-- Two-column layout: vertical sidebar + content -->
            <div class="ilset-layout">

                <!-- Vertical sidebar -->
                <nav class="ilset-sidebar" aria-label="Secciones de Ajustes">
                <?php
                // Render with subtle visual separators between groups.
                // We track the previous group seen and emit a thin
                // horizontal divider every time the group number jumps.
                $prev_group = null;
                foreach ( $tabs as $slug => $tab ) :
                    $group = $tab['_group'] ?? 1;
                    if ( $prev_group !== null && $group !== $prev_group ) {
                        echo '<div class="ilset-nav-sep" aria-hidden="true"></div>';
                    }
                    $prev_group = $group;
                ?>
                    <a href="<?php echo esc_url( add_query_arg( 'tab', $slug, $base_url ) ); ?>"
                       class="ilset-nav-item <?php echo esc_attr( $active_tab === $slug ? 'ilset-nav-active' : '' ); ?>">
                        <?php echo wp_kses( $tab["icon"], array( "svg" => array( "width" => array(), "height" => array(), "viewbox" => array(), "fill" => array(), "stroke" => array(), "stroke-width" => array() ), "path" => array( "d" => array() ), "circle" => array( "cx" => array(), "cy" => array(), "r" => array() ), "rect" => array(), "polyline" => array( "points" => array() ), "line" => array(), "polygon" => array() ) ); ?>
                        <span><?php echo esc_html( $tab['label'] ); ?></span>
                    </a>
                <?php endforeach; ?>
                </nav>

                <div class="ilset-tab-content">

            <?php if ( $active_tab === 'enlazado' ) : ?>
            <div class="ilset-section">

                        <div class="ilset-section-head">
                            <div class="ilset-section-icon">
                                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M19.07 4.93a10 10 0 0 1 0 14.14M4.93 4.93a10 10 0 0 0 0 14.14"/></svg>
                            </div>
                            <div>
                                <div class="ilset-section-title">Comportamiento del enlazado</div>
                                <div class="ilset-section-desc">Controla dónde y cuántos enlaces inserta el plugin</div>
                            </div>
                        </div>
                        <form method="post" action="options.php">
                            <?php settings_fields( 'flink_settings' ); ?>
                            <div class="ilset-field-group">
                                <div class="ilset-field">
                                    <div style="padding:0 0 8px;">
                                        <label class="ilset-label">Aplicar enlazado en (origen)</label>
                                        <div class="ilset-hint">Tipos de contenido <strong>donde</strong> el plugin insertar&aacute; enlaces autom&aacute;ticamente. Aplica tanto a reglas como al enlazado sem&aacute;ntico. Recomendado: solo <em>Entrada</em> &mdash; tus p&aacute;ginas pilar deben quedar intactas.</div>
                                    </div>
                                    <?php
                                    $current_tipos = get_option('flink_origen_tipo', 'post');
                                    $current_arr = ($current_tipos === 'any') ? array('post','page') : array_map('trim', explode(',', $current_tipos));
                                    $all_types = get_post_types(array('public' => true), 'objects');
                                    $exclude = array('attachment','revision','nav_menu_item','custom_css','customize_changeset','oembed_cache','wp_block','wp_template','wp_template_part','wp_navigation','wp_font_family','wp_font_face','wp_global_styles');
                                    ?>
                                    <div style="display:flex;flex-wrap:wrap;gap:8px 16px;padding:4px 0;">
                                    <?php foreach($all_types as $pt):
                                        if(in_array($pt->name, $exclude)) continue;
                                        $checked = in_array($pt->name, $current_arr) ? 'checked' : '';
                                    ?>
                                        <label style="display:flex;align-items:center;gap:6px;font-size:13px;font-weight:500;cursor:pointer;">
                                            <input type="checkbox" name="il_origen_tipos[]" value="<?php echo esc_attr($pt->name); ?>" <?php echo esc_html( $checked ); ?> style="accent-color:#2563eb;width:16px;height:16px;">
                                            <?php echo esc_html($pt->labels->singular_name); ?>
                                        </label>
                                    <?php endforeach; ?>
                                    </div>
                                    <input type="hidden" name="flink_origen_tipo" id="il-origen-tipo-hidden" value="<?php echo esc_attr($current_tipos); ?>">
                                </div>

                                <div class="ilset-field">
                                    <div style="padding:0 0 8px;">
                                        <label class="ilset-label">Permitir como destino</label>
                                        <div class="ilset-hint">Tipos de contenido <strong>hacia</strong> los que se pueden generar enlaces. Para arquitectura piramidal SEO, marca <em>Entrada</em> + <em>P&aacute;gina</em>: tus posts del blog enlazar&aacute;n a las p&aacute;ginas pilar sin que estas reciban modificaciones.</div>
                                    </div>
                                    <?php
                                    $current_dest = get_option('flink_destino_tipo', 'post,page');
                                    $current_dest_arr = ($current_dest === 'any') ? array('post','page') : array_map('trim', explode(',', $current_dest));
                                    ?>
                                    <div style="display:flex;flex-wrap:wrap;gap:8px 16px;padding:4px 0;">
                                    <?php foreach($all_types as $pt):
                                        if(in_array($pt->name, $exclude)) continue;
                                        $checked = in_array($pt->name, $current_dest_arr) ? 'checked' : '';
                                    ?>
                                        <label style="display:flex;align-items:center;gap:6px;font-size:13px;font-weight:500;cursor:pointer;">
                                            <input type="checkbox" name="il_destino_tipos[]" value="<?php echo esc_attr($pt->name); ?>" <?php echo esc_html( $checked ); ?> style="accent-color:#2563eb;width:16px;height:16px;">
                                            <?php echo esc_html($pt->labels->singular_name); ?>
                                        </label>
                                    <?php endforeach; ?>
                                    </div>
                                    <input type="hidden" name="flink_destino_tipo" id="il-destino-tipo-hidden" value="<?php echo esc_attr($current_dest); ?>">
                                </div>
                                <div class="ilset-field ilset-field-row ilset-field-last">
                                    <div class="ilset-field-info">
                                        <label class="ilset-label">M&aacute;ximo de enlaces por post (reglas)</label>
                                        <div class="ilset-hint">N&uacute;mero m&aacute;ximo de enlaces que las <strong>reglas de enlazado</strong> pueden insertar en un mismo post. Este l&iacute;mite aplica solo a los enlaces generados por reglas, no al enlazado sem&aacute;ntico (que tiene su propio l&iacute;mite). Recomendado: entre 3 y 5.</div>
                                    </div>
                                    <input type="number" name="flink_max_enlaces_total" min="1" max="20"
                                        class="ilset-input ilset-input-num"
                                        value="<?php echo (int) get_option('flink_max_enlaces_total',5); ?>">
                                </div>
                            </div>
                            <div class="ilset-form-footer">
                                <?php submit_button('Guardar','ilset-btn-save','submit',false); ?>
                            </div>
                        </form>
                    
            </div>

            <?php
            ?>

            <?php
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended -- Read-only check for the WordPress core ?settings-updated=true flag that core itself appends after Settings API saves; no form data is processed here.
            if ( isset( $_GET['settings-updated'] ) ) : ?>
            <!-- Crawl dialog after saving enlazado settings -->
            <div id="il-settings-crawl" style="position:fixed;inset:0;z-index:999999;background:rgba(0,0,0,.45);display:flex;align-items:center;justify-content:center;backdrop-filter:blur(3px);">
            <div style="background:#fff;border-radius:14px;max-width:480px;width:92%;box-shadow:0 20px 60px rgba(0,0,0,.2);overflow:hidden;">
              <div style="padding:28px 28px 0;text-align:center;">
                <div style="width:48px;height:48px;border-radius:12px;background:rgba(37,99,235,.08);display:inline-flex;align-items:center;justify-content:center;margin-bottom:14px;">
                  <svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="#2563eb" stroke-width="2"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 1 1-2.12-9.36L23 10"/></svg>
                </div>
                <h3 style="font-size:17px;font-weight:700;color:#111827;margin:0 0 8px;">Ajustes de enlazado actualizados</h3>
                <p style="font-size:14px;color:#6b7280;margin:0 0 20px;line-height:1.5;">El cambio en el n&uacute;mero m&aacute;ximo de enlaces afecta a todos los art&iacute;culos. Para aplicar la nueva configuraci&oacute;n es necesario ejecutar un rastreo completo.</p>
              </div>
              <div id="il-scrawl-progress" style="display:none;padding:0 28px 8px;">
                <div style="height:5px;background:#f0f1f4;border-radius:3px;overflow:hidden;"><div id="il-scrawl-fill" style="height:100%;width:0%;background:#2563eb;border-radius:3px;transition:width .3s;"></div></div>
                <div style="display:flex;justify-content:space-between;margin-top:6px;font-size:12px;color:#6b7280;"><span id="il-scrawl-status">Preparando&hellip;</span><span id="il-scrawl-count">0 enlaces</span></div>
              </div>
              <div style="display:flex;gap:10px;justify-content:center;padding:0 28px 24px;">
                <button id="il-scrawl-cancel" style="font-family:inherit;font-size:14px;font-weight:500;color:#6b7280;background:none;border:1px solid #e5e7eb;border-radius:10px;padding:10px 24px;cursor:pointer;">Cancelar</button>
                <button id="il-scrawl-run" style="font-family:inherit;font-size:14px;font-weight:700;color:#fff;background:#2563eb;border:none;border-radius:10px;padding:10px 24px;cursor:pointer;box-shadow:0 2px 8px rgba(37,99,235,.3);">Rastrear ahora</button>
              </div>
            </div>
            </div>
            <?php endif; ?>
            <?php endif; ?>

            <?php
            ?>

            <?php
            ?>

            <?php if ( $active_tab === 'generales' ) : ?>
            <div class="ilset-section">
                <div class="ilset-section-head">
                    <div class="ilset-section-icon">
                        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06A1.65 1.65 0 0 0 4.68 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06A1.65 1.65 0 0 0 9 4.68a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
                    </div>
                    <div>
                        <div class="ilset-section-title">Ajustes generales</div>
                        <div class="ilset-section-desc">Configuraci&oacute;n general del plugin</div>
                    </div>
                </div>
                <form method="post" action="options.php">
                    <?php settings_fields( 'flink_settings_general' ); ?>
                    <div class="ilset-field-group">
                        <div class="ilset-field">
                            <label style="display:flex;align-items:flex-start;gap:10px;cursor:pointer;">
                                <?php
                                // Inverted semantics: the option stores "hidden"
                                // (1=hide), but the user-facing checkbox is
                                // "Show in menu". We pre-tick the box when
                                // hidden=0 (i.e. visible). On submit we send
                                // value 0 if checked (= visible) by relying on
                                // a hidden default-0 input below, then the
                                // checkbox value=1 overrides only if checked.
                                // To keep the storage semantics consistent
                                // ("1=hide"), we reverse on save with a small
                                // helper pattern below.
                                $onb_hidden = (int) get_option( 'flink_onboarding_hidden', 0 );
                                ?>
                                <!-- Always-submitted "1=hide" base value; checkbox below overrides to 0 when ticked -->
                                <input type="hidden" name="flink_onboarding_hidden" value="1">
                                <input type="checkbox" name="flink_onboarding_hidden" value="0"
                                    <?php checked( $onb_hidden, 0 ); ?>
                                    style="accent-color:#2563eb;width:18px;height:18px;margin-top:2px;">
                                <div>
                                    <div class="ilset-label" style="margin:0;">Mostrar gu&iacute;a &laquo;Primeros pasos&raquo; en el men&uacute;</div>
                                    <div class="ilset-hint">Si est&aacute; activado, aparecer&aacute; el ítem <strong>Primeros pasos</strong> al principio del men&uacute; del plugin con la pantalla de bienvenida y los v&iacute;deos demostrativos. Desact&iacute;valo cuando ya conozcas el plugin.</div>
                                </div>
                            </label>
                        </div>
                        <div class="ilset-field">
                            <label style="display:flex;align-items:flex-start;gap:10px;cursor:pointer;">
                                <input type="checkbox" name="flink_delete_data_on_uninstall" value="1"
                                    <?php checked( get_option( 'flink_delete_data_on_uninstall', 0 ), 1 ); ?>
                                    style="accent-color:#ef4444;width:18px;height:18px;margin-top:2px;">
                                <div>
                                    <div class="ilset-label" style="margin:0;color:#dc2626;">Eliminar todos los datos al desinstalar</div>
                                    <div class="ilset-hint">Al eliminar el plugin se borrar&aacute;n <strong>todas las tablas</strong> de la base de datos (reglas, pilares, plantillas, enlaces sem&aacute;nticos, registros, cola de contenido) y <strong>todas las opciones</strong> de configuraci&oacute;n. Esta acci&oacute;n es irreversible. Deja esta opci&oacute;n desmarcada si planeas reinstalar el plugin m&aacute;s adelante.</div>
                                </div>
                            </label>
                        </div>
                    </div>
                    <div class="ilset-form-footer">
                        <?php submit_button('Guardar','ilset-btn-save','submit',false); ?>
                    </div>
                </form>
            </div>
            <?php endif; ?>

            <?php
            ?>

            </div><!-- /.ilset-tab-content -->
            </div><!-- /.ilset-layout -->
        </div>
        <?php
        // The checkbox-to-hidden-field sync for il_origen_tipos /
        // il_destino_tipos lives in admin/js/settings-tipos.js, enqueued
        // conditionally from enqueue_assets() when we're on the Ajustes
        // page. Inline <script> is not allowed by WordPress.org review.

    }


}

add_action( 'admin_init', function() {
    register_setting( 'flink_settings', 'flink_max_enlaces_total', array(
        'type'              => 'integer',
        'default'           => 5,
        'sanitize_callback' => 'absint',
    ) );
    register_setting( 'flink_settings', 'flink_origen_tipo',      array('type'=>'string','default'=>'post','sanitize_callback'=>'sanitize_text_field') );
    // Separate "destino" setting: which post_types can RECEIVE links.
    // Default 'post,page' implements the SEO-correct topical cluster
    // pattern out of the box: blog posts link TO pillar pages, but
    // pillar pages aren't touched by the linking engine.
    register_setting( 'flink_settings', 'flink_destino_tipo',     array('type'=>'string','default'=>'post,page','sanitize_callback'=>'sanitize_text_field') );
    // General settings
    register_setting( 'flink_settings_general', 'flink_delete_data_on_uninstall', array(
        'type'              => 'integer',
        'default'           => 0,
        'sanitize_callback' => function( $val ) { return $val ? 1 : 0; },
    ) );
    // The onboarding hidden flag is "1 = hidden". The setting field is
    // labelled positively ("Mostrar guía de Primeros pasos en el menú")
    // so we invert the user-facing checkbox value when sanitising:
    // checkbox checked → hidden=0 (show), unchecked → hidden=1 (hide).
    // The form submits a hidden helper field that always exists so an
    // unchecked checkbox is detectable.
    register_setting( 'flink_settings_general', 'flink_onboarding_hidden', array(
        'type'              => 'integer',
        'default'           => 0,
        'sanitize_callback' => function( $val ) { return $val ? 1 : 0; },
    ) );

} );

// Handle unchecked checkbox — when form submits without checkbox, set to 0
add_action( 'admin_init', function() {
    // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
    if ( isset( $_POST['option_page'] ) && $_POST['option_page'] === 'flink_settings_content' ) {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( ! isset( $_POST['flink_show_predefined_templates'] ) ) {
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            $_POST['flink_show_predefined_templates'] = '0';
        }
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( ! isset( $_POST['flink_disable_comments'] ) ) {
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            $_POST['flink_disable_comments'] = '0';
        }
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( ! isset( $_POST['flink_seo_slug_enabled'] ) ) {
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            $_POST['flink_seo_slug_enabled'] = '0';
        }
    }
    // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
    if ( isset( $_POST['option_page'] ) && $_POST['option_page'] === 'flink_settings_general' ) {
        // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
        if ( ! isset( $_POST['flink_delete_data_on_uninstall'] ) ) {
            // phpcs:ignore WordPress.Security.NonceVerification.Missing,WordPress.Security.NonceVerification.Recommended,WordPress.Security.ValidatedSanitizedInput.InputNotSanitized,WordPress.Security.ValidatedSanitizedInput.MissingUnslash,WordPress.Security.ValidatedSanitizedInput.InputNotValidated -- Nonce verified upstream in handler/page bootstrap. Value is sanitized at use site.
            $_POST['flink_delete_data_on_uninstall'] = '0';
        }
    }
}, 5 );

// Flag needs_processing when settings that affect linking are changed
add_action( 'update_option_flink_max_enlaces_total', function( $old, $new ) {
    if ( $old != $new ) {
        update_option( 'flink_needs_processing', 1, false );
        delete_option( 'flink_batch_reviewed' );
    }
}, 10, 2 );
add_action( 'update_option_flink_origen_tipo', function( $old, $new ) {
    if ( $old != $new ) {
        update_option( 'flink_needs_processing', 1, false );
        delete_option( 'flink_batch_reviewed' );
    }
}, 10, 2 );