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

/** One optional integration check shared by settings and the setup assistant. */
function mkb_glossar_elementor_available() {
    return did_action('elementor/loaded') && class_exists('\\Elementor\\Plugin');
}

add_action('admin_menu', function () {
    add_submenu_page('edit.php?post_type=mkb_glossar', __('MKB Glossar Settings', 'mkb-glossar'), __('Settings', 'mkb-glossar'), 'manage_options', 'mkb-glossar', 'mkb_glossar_settings_page');
});
add_action('admin_init', function () {
    register_setting('mkb_glossar_settings', 'mkb_glossar_options', ['sanitize_callback' => 'mkb_glossar_sanitize']);
    // Rewrite-rule flushes and stored migration markers are privileged writes.
    // An editor visiting wp-admin must not trigger an upgrade/migration side effect.
    if (!current_user_can('manage_options')) return;
    // Refresh persisted rewrite rules once on upgrade. In WPML, admin-side
    // language discovery must be available when the rules are regenerated.
    $rewrite_version = '3.14.20';
    if (get_option('mkb_glossar_rewrite_version') !== $rewrite_version || get_option('mkb_glossar_flush')) {
        mkb_glossar_register();
        mkb_glossar_language_rewrites();
        flush_rewrite_rules();
        update_option('mkb_glossar_rewrite_version', $rewrite_version);
        delete_option('mkb_glossar_flush');
    }
});

/** Only families already declared in the active Elementor Kit are selectable.
 * No font library is fetched and no external font stylesheet is enqueued here.
 */
function mkb_glossar_kit_font_families() {
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Plugin')) return [];
    $kit = mkb_glossar_get_optional_kit();
    if (empty($kit['available'])) return [];
    $families = [];
    foreach ((array) ($kit['tokens']['typography'] ?? []) as $token) {
        $family = trim((string) ($token['style']['font_family'] ?? ''));
        if ($family === '' || strlen($family) > 200 || !preg_match('/^[\p{L}\p{N} ._\-]+$/u', $family)) continue;
        $families[$family] = $family;
    }
    natcasesort($families);
    return array_values($families);
}

/** Load the currently selected kit font for the admin live preview through Elementor.
 * Elementor owns Google Fonts opt-in, font classification, caching and local/CDN policy.
 * The Glossar never builds Google Fonts URLs and never loads the entire font catalog.
 */
function mkb_glossar_enqueue_preview_font() {
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Fonts')) return;
    $google_font = '\Elementor\Core\Files\Fonts\Google_Font';
    if (!class_exists($google_font) || !method_exists($google_font, 'enqueue')) return;
    $chosen = trim((string) (mkb_glossar_opts()['tooltip']['font_family'] ?? ''));
    if ($chosen === '' || $chosen === 'inherit') {
        $kit = mkb_glossar_get_optional_inheritance();
        $chosen = trim((string) ($kit['values']['font_family'] ?? ''));
    }
    if ($chosen === '' || !in_array($chosen, mkb_glossar_kit_font_families(), true)) return;
    if (!\Elementor\Fonts::is_google_fonts_enabled()) return;
    // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Required third-party WPML/Elementor API hook name; changing it would break integration.
    if (!apply_filters('elementor/frontend/print_google_fonts', true)) return;
    if (\Elementor\Fonts::get_font_type($chosen) !== \Elementor\Fonts::GOOGLE) return;
    try {
        $google_font::enqueue($chosen, $google_font::TYPE_DEFAULT);
    } catch (\Throwable $error) {
        // Font loading must not interrupt the Glossar settings screen.
    }
}

/** Resolve exactly one active-kit font through Elementor for the admin preview. */
add_action('wp_ajax_mkb_glossar_preview_font', function () {
    if (!current_user_can('manage_options')) wp_send_json_error(['message' => 'Forbidden'], 403);
    check_ajax_referer('mkb_glossar_preview_font', 'nonce');
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Fonts')) wp_send_json_error(['message' => 'Elementor unavailable'], 400);
    $family = isset($_POST['family']) && is_string($_POST['family'])
        ? trim(sanitize_text_field(wp_unslash($_POST['family'])))
        : '';
    if (!in_array($family, mkb_glossar_kit_font_families(), true)) wp_send_json_error(['message' => 'Font not in active kit'], 400);
    // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- Required third-party WPML/Elementor API hook name; changing it would break integration.
    if (!\Elementor\Fonts::is_google_fonts_enabled() || !apply_filters('elementor/frontend/print_google_fonts', true)) {
        wp_send_json_success(['url' => '', 'blocked' => true]);
    }
    if (\Elementor\Fonts::get_font_type($family) !== \Elementor\Fonts::GOOGLE) {
        wp_send_json_success(['url' => '', 'blocked' => false]);
    }
    $loader = '\Elementor\Core\Files\Fonts\Google_Font';
    if (!class_exists($loader) || !method_exists($loader, 'enqueue')) wp_send_json_error(['message' => 'Font loader unavailable'], 400);
    try {
        $loader::enqueue($family, $loader::TYPE_DEFAULT);
        $handle = 'elementor-gf-local-' . sanitize_key($family);
        if (!wp_style_is($handle, 'enqueued')) $handle = 'elementor-gf-' . sanitize_key($family);
        $style = wp_styles()->registered[$handle] ?? null;
        if (!$style || empty($style->src)) wp_send_json_error(['message' => 'Font stylesheet unavailable'], 500);
        $url = $style->src;
        if (strpos($url, '//') === 0) $url = set_url_scheme($url);
        if (!preg_match('~^https?://~i', $url)) $url = site_url($url);
        // Elementor owns this URL; reject non-HTTP schemes and unexpected hosts.
        $host = wp_parse_url($url, PHP_URL_HOST);
        $local_host = wp_parse_url(site_url(), PHP_URL_HOST);
        if (!in_array($host, [$local_host, 'fonts.googleapis.com'], true)) wp_send_json_error(['message' => 'Unsupported font host'], 400);
        wp_send_json_success(['url' => esc_url_raw($url), 'blocked' => false]);
    } catch (\Throwable $error) {
        wp_send_json_error(['message' => 'Font stylesheet unavailable'], 500);
    }
});

function mkb_glossar_sanitize($raw) {
    $old = mkb_glossar_opts();
    if (!is_array($raw)) return $old;
    $out = $old;
    $section = mkb_glossar_request_key($raw,'_section');
    // Setup owns only labels and one URL base, never language rewrites or other options.
    // Validate the complete request before mutating a single persisted setting.
    if ($section === 'setup_names') {
        $existing = get_option('mkb_glossar_options', []);
        if (!is_array($existing)) $existing = [];
        if (!current_user_can('manage_options')) return $existing;
        $values = [];
        foreach (['label', 'singular'] as $key) {
            if (!isset($raw[$key]) || !is_string($raw[$key])) return $existing;
            $value = trim(sanitize_text_field($raw[$key]));
            if ($value === '' || preg_match_all('/./us', $value) > 80) return $existing;
            $values[$key] = $value;
        }
        $base = mkb_glossar_url_base_candidate($raw['slug'] ?? null);
        if ($base === '' || (mkb_glossar_setup_state() === 'pending' || $base !== (string)($old['slug'] ?? ''))
            && mkb_glossar_url_base_problem($base) !== null) return $existing;
        foreach ($values as $key => $value) $existing[$key] = $value;
        if ($base !== (string)($old['slug'] ?? '')) {
            $existing['slug'] = $base;
            update_option('mkb_glossar_flush', 1);
        }
        return $existing;
    }
    // A settings tab must only save its own fields. Other tabs retain their values.
    if ($section === 'general') {
        $out['label'] = isset($raw['label']) && is_scalar($raw['label']) ? sanitize_text_field((string)$raw['label']) : $old['label'];
        $out['singular'] = isset($raw['singular']) && is_scalar($raw['singular']) ? sanitize_text_field((string)$raw['singular']) : $old['singular'];
        $requested_base = mkb_glossar_url_base_candidate($raw['slug'] ?? null);
        if ($requested_base === '') {
            add_settings_error('mkb_glossar_options', 'invalid_base', __('Enter a valid single-segment URL base. The previous address was kept.', 'mkb-glossar'), 'error');
            return $old; // Reject the entire General form instead of a partial save.
        } elseif ($requested_base !== (string)$old['slug'] && ($problem = mkb_glossar_url_base_problem($requested_base)) !== null) {
            add_settings_error('mkb_glossar_options', 'url_base_conflict', $problem, 'error');
            return $old; // No label or translated-URL changes on collision.
        } else {
            $out['slug'] = $requested_base;
        }
        // Language-specific bases are opt-in. Existing installations retain their current URLs.
        if (function_exists('mkb_glossar_url_languages')) {
            $submitted = isset($raw['language_slugs']) && is_array($raw['language_slugs']) ? $raw['language_slugs'] : [];
            $default_language = mkb_glossar_default_language();
            // Migrate a former explicit default-language override only when it differs
            // from the old global base. This prevents silently changing existing URLs.
            $existing = (array)($old['language_slugs'] ?? []);
            if ($default_language !== '' && isset($existing[$default_language])) {
                $legacy_default = sanitize_title((string)$existing[$default_language]);
                if ($legacy_default !== '' && $legacy_default !== sanitize_title((string)$old['slug']) && $out['slug'] === $old['slug']) {
                    $migration_problem = mkb_glossar_url_base_problem($legacy_default);
                    if ($migration_problem === null) {
                        $out['slug'] = $legacy_default;
                        add_settings_error('mkb_glossar_options','default_slug_migrated',__('The former default-language URL base was transferred to the main URL base. Review existing permalinks.','mkb-glossar'),'warning');
                    } else {
                        add_settings_error('mkb_glossar_options','default_slug_conflict', $migration_problem, 'error');
                    }
                }
            }
            $active_languages = mkb_glossar_url_languages();
            $translated = $existing; // Never lose translated URL bases when provider is unavailable.
            foreach ($active_languages as $code) {
                if ($code === $default_language) continue;
                if (!array_key_exists($code, $submitted) || !is_string($submitted[$code])) continue;
                $raw_value = trim($submitted[$code]);
                if ($raw_value === '') { unset($translated[$code]); continue; }
                $value = mkb_glossar_url_base_candidate($raw_value);
                if ($value === '') {
                    add_settings_error('mkb_glossar_options','invalid_language_base', __('An invalid translated URL base was ignored. Existing URLs were kept.', 'mkb-glossar'), 'error');
                    continue;
                }
                // These URLs are prefixed/owned by the language plugin. Static root
                // conflicts are not evidence of a conflict within that language.
                unset($translated[$code]);
                if ($value !== $out['slug']) $translated[$code] = $value;
            }
            // The default language uses the global base; secondary language bases
            // may coincide with it (the language prefix keeps URLs distinct).
            $out['language_slugs'] = $translated;
            if ($translated !== $existing || $out['slug'] !== $old['slug']) update_option('mkb_glossar_flush', 1);
        }
        // Elementor widgets are optional. Existing installations default to all-on.
        // A complete validated map is required: malformed/nested values preserve the
        // previous configuration, and the fields are absent when Elementor is inactive.
        if (mkb_glossar_elementor_available() && array_key_exists('elementor_widgets', $raw)) {
            $submitted = $raw['elementor_widgets'];
            $keys = mkb_glossar_elementor_widget_keys();
            $valid = is_array($submitted) && count($submitted) === count($keys)
                && !array_diff(array_keys($submitted), $keys);
            if ($valid) {
                foreach ($keys as $key) {
                    if (!isset($submitted[$key]) || !is_scalar($submitted[$key])
                        || !in_array((string)$submitted[$key], ['0', '1'], true)) { $valid = false; break; }
                }
            }
            if ($valid) {
                $out['elementor_widgets'] = array_fill_keys($keys, 1);
                foreach ($keys as $key) $out['elementor_widgets'][$key] = (int)$submitted[$key];
            } else {
                add_settings_error('mkb_glossar_options', 'invalid_widget_settings',
                    __('The Elementor widget selection was not saved because the submitted values were invalid.', 'mkb-glossar'), 'error');
            }
        }
        // One centrally chosen Elementor Free template; never trust an arbitrary ID.
        if (mkb_glossar_elementor_available() && array_key_exists('elementor_details_template', $raw)) {
            $candidate = is_scalar($raw['elementor_details_template']) ? absint($raw['elementor_details_template']) : -1;
            if ($candidate === 0 || ($candidate > 0 && function_exists('mkb_glossar_shared_template_is_valid')
                && mkb_glossar_shared_template_is_valid($candidate))) {
                $out['elementor_details_template'] = $candidate;
            } else {
                add_settings_error('mkb_glossar_options', 'invalid_shared_template',
                    __('The selected Elementor template is unavailable. The previous setting was kept.', 'mkb-glossar'), 'error');
            }
        }
        if ($out['slug'] !== $old['slug']) {
            add_settings_error('mkb_glossar_options', 'slug_updated', __('URL base changed. Review existing URLs and redirects.', 'mkb-glossar'), 'warning');
            update_option('mkb_glossar_flush', 1);
        }
    } elseif ($section === 'presentation') {
        // Save only this tab, including an explicit unchecked schema switch.
        $out['schema_enabled'] = isset($raw['schema_enabled']) && is_scalar($raw['schema_enabled']) && (string)$raw['schema_enabled'] === '1' ? 1 : 0;
        $out['overview_page_size'] = isset($raw['overview_page_size']) && is_scalar($raw['overview_page_size'])
            ? max(1, min(200, absint($raw['overview_page_size']))) : (int)$old['overview_page_size'];
        $out['details_design'] = mkb_glossar_details_design_settings($raw['details_design'] ?? []);
    } elseif ($section === 'linking') {
        $out['mark_external_links'] = isset($raw['mark_external_links']) && is_scalar($raw['mark_external_links']) && (string)$raw['mark_external_links']==='1' ? 1 : 0;
        // Keep the global icon choice even when external markers are turned off.
        $choice = $raw['external_icon_style'] ?? 'default';
        $out['external_icon_style'] = is_string($choice) && in_array($choice, mkb_glossar_external_icon_styles(), true)
            ? $choice : 'default';
        $candidate = $raw['external_icon_attachment_id'] ?? 0;
        if (is_scalar($candidate) && ctype_digit((string)$candidate)) {
            $candidate = absint($candidate);
            if ($candidate === 0) {
                $out['external_icon_attachment_id'] = 0;
            } elseif (mkb_glossar_external_icon_attachment_url($candidate) !== '' && current_user_can('edit_post', $candidate)) {
                $out['external_icon_attachment_id'] = $candidate;
            } else {
                add_settings_error('mkb_glossar_options', 'invalid_external_icon',
                    __('The selected image cannot be used as a glossary icon. The previous image was kept.', 'mkb-glossar'), 'error');
            }
        }

        $out['auto_link'] = !empty($raw['auto_link']) && is_scalar($raw['auto_link']) ? 1 : 0;
        $out['max_links'] = isset($raw['max_links']) && is_scalar($raw['max_links']) ? max(1, min(100, absint($raw['max_links']))) : $old['max_links'];
        $out['repeat_per_term'] = isset($raw['repeat_per_term']) && is_scalar($raw['repeat_per_term']) ? max(1, min(10, absint($raw['repeat_per_term']))) : $old['repeat_per_term'];
        $allowed = array_keys(get_post_types(['public' => true]));
        $selected = isset($raw['enabled_types']) && is_array($raw['enabled_types']) ? array_filter($raw['enabled_types'], 'is_scalar') : [];
        $out['enabled_types'] = array_values(array_intersect($allowed, array_map('sanitize_key', $selected)));
    } elseif ($section === 'exclusions') {
        // Per-post exclusions are managed by authenticated AJAX and post editor.
        $out['excluded_terms'] = [];
        foreach ((array) ($raw['excluded_terms'] ?? []) as $tax => $ids) {
            $tax = is_scalar($tax) ? sanitize_key((string)$tax) : '';
            if (!$tax || !taxonomy_exists($tax) || !is_scalar($ids)) continue;
            $out['excluded_terms'][$tax] = array_values(array_unique(array_filter(array_map('absint', preg_split('/[\s,;]+/', (string) $ids)))));
        }
    } elseif ($section === 'tooltips') {
        $allowed_keys = ['background','color','border_color','font_family','font_size','font_weight','line_height','radius','padding','border_width','max_width'];
        $input = isset($raw['tooltip']) && is_array($raw['tooltip']) ? $raw['tooltip'] : [];
        $value = (array) ($old['tooltip'] ?? []);
        foreach ($allowed_keys as $key) {
            if (isset($input[$key]) && !is_scalar($input[$key])) continue;
            $entry = isset($input[$key]) ? trim((string) $input[$key]) : '';
            if ($entry === '') { unset($value[$key]); if ($key === 'line_height') unset($value['line_height_unit']); continue; } // Empty = inherit.
            if (in_array($key, ['background','color','border_color'], true)) {
                $entry = sanitize_hex_color($entry);
                if (!$entry) { unset($value[$key]); continue; }
            } elseif ($key === 'font_family') {
                $entry = sanitize_text_field($entry);
                if (!in_array($entry, array_merge(['inherit','Arial, sans-serif','Georgia, serif','Verdana, sans-serif','Tahoma, sans-serif','Trebuchet MS, sans-serif','Times New Roman, serif','Courier New, monospace','system-ui, sans-serif'], mkb_glossar_kit_font_families(), [(string) ($old['tooltip']['font_family'] ?? '')]), true)) { unset($value[$key]); continue; }
            } else {
                $limits = ['font_size' => [10, 48], 'font_weight' => [100, 900], 'line_height' => [0, 500], 'radius' => [0, 80], 'padding' => [0, 60], 'border_width' => [0, 10], 'max_width' => [180, 700]];
                if ($key === 'line_height') {
                    $raw_unit = $input['line_height_unit'] ?? ($old['tooltip']['line_height_unit'] ?? 'percent');
                    $unit = is_scalar($raw_unit) ? sanitize_key((string)$raw_unit) : 'percent';
                    if (!in_array($unit, ['factor','px','percent'], true)) $unit = 'factor';
                    $number = is_numeric($entry) ? (float) $entry : 0;
                    $entry = $unit === 'factor' ? min(3.5, max(0.8, $number)) : ($unit === 'px' ? min(96, max(8, $number)) : min(350, max(80, $number)));
                    $value['line_height_unit'] = $unit;
                } else {
                    $entry = max($limits[$key][0], min($limits[$key][1], absint($entry)));
                    if ($key === 'font_weight') $entry = (int) (round($entry / 100) * 100);
                }
            }
            $value[$key] = $entry;
        }
        $out['tooltip'] = $value;
    }
    return $out;
}

function mkb_glossar_settings_page() {
    if (!current_user_can('manage_options')) return;
    $tabs = ['general' => __('General','mkb-glossar'), 'linking' => __('Linking','mkb-glossar'), 'exclusions' => __('Exclusions','mkb-glossar'), 'presentation' => __('Appearance & SEO','mkb-glossar'), 'tooltips' => __('Tooltips','mkb-glossar')];
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $tab = mkb_glossar_request_key($_GET, 'tab', 'general');
    if (!isset($tabs[$tab])) $tab = 'general';
    $o = mkb_glossar_opts();
    // Each tab opens at the instruction that explains its main controls.
    $help_topic = ['general' => 'start-step-1', 'linking' => 'linking-step-2', 'exclusions' => 'linking-step-4', 'presentation' => 'display-step-5', 'tooltips' => 'tooltips-step-4'][$tab];
    echo '<div class="wrap mkb-glossar-settings-screen"><header class="mkb-glossar-page-header"><h1>'.esc_html__('MKB Glossar Settings','mkb-glossar').'</h1></header>';
    echo '<div class="mkb-glossar-settings-navrow"><nav class="mkb-glossar-tab-list" aria-label="'.esc_attr__('Settings sections','mkb-glossar').'">';
    // One consistent, stroke-based icon family for all tabs; no external assets.
    $tab_icon_paths = [
        'general' => '<path d="M4 7h16M4 17h16"/><circle cx="9" cy="7" r="2"/><circle cx="15" cy="17" r="2"/>',
        'linking' => '<path d="M10 13a5 5 0 0 0 7.1 0l2.1-2.1a5 5 0 0 0-7.1-7.1L10.7 5"/><path d="M14 11a5 5 0 0 0-7.1 0l-2.1 2.1a5 5 0 0 0 7.1 7.1l1.4-1.4"/>',
        'exclusions' => '<path d="M4 4l16 16M9.4 4.8 12 3l8 3v5c0 4-2.6 7.5-6 9.3M5.4 7.1 4 6v5c0 4.5 3.1 8.3 8 10 1.1-.4 2.1-1 3-1.6"/>',
        'presentation' => '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M3 10h18M9 10v10"/>',
        'tooltips' => '<path d="M20 11.5a7.5 7.5 0 0 1-7.5 7.5H7l-3 2v-5.5A7.5 7.5 0 1 1 20 11.5Z"/>',
    ];
    foreach ($tabs as $key => $label) {
        $url = add_query_arg(['post_type'=>'mkb_glossar','page'=>'mkb-glossar','tab'=>$key], admin_url('edit.php'));
        $active = $key === $tab;
        echo '<a class="mkb-glossar-ui-tab '.($active ? 'is-active' : '').'" href="'.esc_url($url).'"'.($active ? ' aria-current="page"' : '').'>';
        echo '<svg class="mkb-glossar-tab-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">'.wp_kses($tab_icon_paths[$key], [
            'path' => ['d' => true],
            'circle' => ['cx' => true, 'cy' => true, 'r' => true],
        ]).'</svg><span class="mkb-glossar-tab-label">'.esc_html($label).'</span></a>';
    }
    echo '</nav>';
    // Help is a normal link alongside, but not inside, the settings-tab navigation.
    echo '<a class="mkb-glossar-help-shortcut" href="'.esc_url(mkb_glossar_help_url($help_topic)).'"><span class="dashicons dashicons-editor-help" aria-hidden="true"></span><span>'.esc_html__('Handbook','mkb-glossar').'</span></a></div>';
    settings_errors();
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    if ($tab === 'general' && (isset($_GET['setup_skipped']) || isset($_GET['setup_completed']))) {
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
        echo '<div class="notice notice-success is-dismissible"><p>' . esc_html(isset($_GET['setup_skipped'])
            ? __('Setup was skipped. All settings remain available; you can restart the assistant below.', 'mkb-glossar')
            : __('Setup completed. You can restart the assistant later under General settings.', 'mkb-glossar')) . '</p></div>';
    }
    if ($tab !== 'exclusions') {
        echo '<form method="post" action="'.esc_url(admin_url('options.php')).'">';
        settings_fields('mkb_glossar_settings');
    }
    if ($tab !== 'exclusions') {
        $panel_class = in_array($tab, ['general', 'linking', 'presentation'], true) ? ' mkb-glossar-ui-form-card' : ($tab === 'tooltips' ? ' mkb-glossar-ui-tooltip-card' : '');
        echo '<section class="mkb-glossar-settings-panel'.esc_attr($panel_class).'">';
        if ($tab === 'general') {
            echo '<header class="mkb-glossar-ui-section-header"><div><h2>'.esc_html__('Basic settings', 'mkb-glossar').'</h2><p>'.esc_html__('Manage glossary labels and the public URL base.', 'mkb-glossar').'</p></div></header>';
        } elseif ($tab === 'presentation') {
            echo '<header class="mkb-glossar-ui-section-header"><div><h2>'.esc_html__('Appearance and structured glossary data','mkb-glossar').'</h2><p>'.esc_html__('Choose how your glossary appears: how many terms visitors see first, how sources and related terms look, and what search engines learn about your explanations.','mkb-glossar').'</p></div></header>';
        } elseif ($tab === 'linking') {
            echo '<header class="mkb-glossar-ui-section-header"><div><h2>'.esc_html__('Automatic glossary linking', 'mkb-glossar').'</h2><p>'.esc_html__('Configure automatic links and choose the content types where linking is allowed.', 'mkb-glossar').'</p></div></header>';
        }
    }
    if ($tab === 'tooltips') echo '<div class="mkb-glossar-tooltip-layout"><div class="mkb-glossar-tooltip-fields"><header class="mkb-glossar-tooltip-section-heading"><h2>'.esc_html__('Tooltip design', 'mkb-glossar').'</h2><p>'.esc_html__('Customize individual tooltip properties or keep inherited values.', 'mkb-glossar').'</p></header>';
    if ($tab !== 'exclusions') {
        echo '<input type="hidden" name="mkb_glossar_options[_section]" value="'.esc_attr($tab).'"><table class="form-table" role="presentation">';
    }
    if ($tab === 'presentation') {
        echo '<tr><th>'.esc_html__('Help search engines understand your terms','mkb-glossar').'</th><td>';
        echo '<label class="mkb-maturity-switch"><input type="checkbox" name="mkb_glossar_options[schema_enabled]" value="1" '.checked(!empty($o['schema_enabled']),true,false).'> '.esc_html__('Share structured information about published glossary terms','mkb-glossar').'</label>';
        echo '<p class="description">'.esc_html__('MKB Glossary adds the term name, explanation and alternative names in the Schema.org DefinedTerm format. Search engines can then identify what each term means. Only published terms are included.','mkb-glossar').'</p></td></tr>';
        echo '<tr><th><label for="mkb-overview-page-size">'.esc_html__('Terms per loading batch','mkb-glossar').'</label></th><td>';
        echo '<div class="mkb-maturity-size-settings"><input id="mkb-overview-page-size" class="mkb-maturity-page-size" type="number" name="mkb_glossar_options[overview_page_size]" min="1" max="200" step="1" required value="'.esc_attr(max(1,min(200,(int)($o['overview_page_size']??36)))).'" aria-describedby="mkb-overview-page-help" inputmode="numeric">';
        echo '<div class="mkb-maturity-size-presets" role="group" aria-label="'.esc_attr__('Quick selection for loading batch size','mkb-glossar').'">';
        foreach ([12,24,36,50,100] as $page_size) echo '<button class="mkb-maturity-size-preset" type="button" data-mkb-page-size="'.esc_attr((string)$page_size).'" aria-pressed="false">'.esc_html((string)$page_size).'</button>';
        echo '</div></div><p id="mkb-overview-page-help" class="description">'.esc_html__('Enter any number from 1 to 200 or use a quick choice. For example, with 100 published terms and a value of 50, the first 50 appear initially; clicking “Load more terms” adds the next 50 to the same page. Search, topics and alphabet cover all published terms.','mkb-glossar').'</p></td></tr>';
        echo '<tr><th>'.esc_html__('Sources and related terms: common design','mkb-glossar').'</th><td>';
        echo '<div class="mkb-maturity-design-intro"><h3>'.esc_html__('Design sources and related terms for your whole glossary','mkb-glossar').'</h3>';
        echo '<p>'.esc_html__('Choose the colors, corners and spacing of the sources and related terms shown beneath a glossary explanation. Save your choices once and every term page uses the same appearance.','mkb-glossar').'</p>';
        echo '<p>'.esc_html__('Choose a color or type its six-digit value. Leave a field empty to use your website\'s existing design. The preview updates as you make changes.','mkb-glossar').'</p></div>';
        echo '<div class="mkb-maturity-design-grid">';
        $design=(array)($o['details_design']??[]);
        $fields=[
            'background'=>__('Background color','mkb-glossar'),
            'text'=>__('Text color','mkb-glossar'),
            'border'=>__('Border color','mkb-glossar'),
            'heading'=>__('Heading color','mkb-glossar'),
            'links'=>__('Link color','mkb-glossar'),
            'radius'=>__('Corner radius (px)','mkb-glossar'),
            'gap'=>__('Space between sections (px)','mkb-glossar'),
            'padding'=>__('Inner spacing (px)','mkb-glossar'),
        ];
        foreach ($fields as $key=>$label) {
            $numeric=in_array($key,['radius','gap','padding'],true);
            $id='mkb-details-'.$key;
            $value=(string)($design[$key]??'');
            echo '<div class="mkb-maturity-field"><label for="'.esc_attr($id).'">'.esc_html($label).'</label>';
            if (!$numeric) {
                $swatch = sanitize_hex_color($value) ?: '#edf1f4';
                echo '<div class="mkb-admin-color-field mkb-maturity-color-control">';
                /* translators: %s is the configured site label or design control name. */
                echo '<input class="mkb-admin-color-swatch mkb-maturity-color-swatch" type="color" value="'.esc_attr($swatch).'" aria-label="'.esc_attr(sprintf(__('Choose %s','mkb-glossar'),$label)).'" data-mkb-swatch="'.esc_attr($key).'">';
                echo '<input class="mkb-admin-color-hex mkb-maturity-value" id="'.esc_attr($id).'" name="mkb_glossar_options[details_design]['.esc_attr($key).']" type="text" value="'.esc_attr($value).'" placeholder="'.esc_attr__('Use theme colors','mkb-glossar').'" maxlength="7" inputmode="text" spellcheck="false" autocomplete="off" data-mkb-color-error="'.esc_attr__('Enter a color such as #336699, or leave this field empty.','mkb-glossar').'" data-mkb-setting="'.esc_attr($key).'">';
                /* translators: Placeholders are the site-configured collection/item names or numerical counts shown in this message. */
                echo '<button type="button" class="mkb-maturity-color-reset" data-mkb-reset-color="'.esc_attr($key).'" title="'.esc_attr__('Use website colors','mkb-glossar').'" aria-label="'.esc_attr(sprintf(__('Reset %s to website colors','mkb-glossar'),$label)).'"><svg viewBox="0 0 24 24" width="14" height="14" aria-hidden="true" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M3 11a9 9 0 1 1 2.6 6.4"/><path d="M3 4v7h7"/></svg></button>';
                echo '</div>';
            } else {
                $limits=['radius'=>[0,48],'gap'=>[4,80],'padding'=>[0,60]];
                echo '<input class="mkb-maturity-value" id="'.esc_attr($id).'" name="mkb_glossar_options[details_design]['.esc_attr($key).']" type="number" min="'.esc_attr($limits[$key][0]).'" max="'.esc_attr($limits[$key][1]).'" value="'.esc_attr($value).'" placeholder="—" autocomplete="off" data-mkb-setting="'.esc_attr($key).'">';
            }
            echo '</div>';
        }
        echo '</div><p class="description">'.esc_html(mkb_glossar_elementor_available()
            ? __('Tip: Use the reset icon beside a color to return to your website\'s colors. If you use a shared Elementor template, its styling takes priority for these sections.','mkb-glossar')
            : __('Tip: Use the reset icon beside a color to return to your website\'s colors.','mkb-glossar')).'</p>';
        echo '<div class="mkb-maturity-preview" aria-label="'.esc_attr__('Live preview','mkb-glossar').'">';
        echo '<div class="mkb-maturity-preview-card"><strong>'.esc_html__('Sources and references','mkb-glossar').'</strong><span>'.esc_html__('Documentation','mkb-glossar').'</span></div>';
        echo '<div class="mkb-maturity-preview-card"><strong>'.esc_html__('Related terms','mkb-glossar').'</strong><span>'.esc_html__('Example','mkb-glossar').'</span></div>';
        echo '</div></td></tr>';
    }
    if ($tab === 'general') {
        $default_language = function_exists('mkb_glossar_default_language') ? mkb_glossar_default_language() : '';
        $languages = function_exists('mkb_glossar_url_languages') ? mkb_glossar_url_languages() : [];
        foreach (['label'=>__('Collection name','mkb-glossar'), 'singular'=>__('Name of one item','mkb-glossar'), 'slug'=>__('URL base','mkb-glossar')] as $key => $label) {
            // translators: %s: ISO language code for the default language of the glossary URL.
            if ($key === 'slug' && $default_language !== '') $label = sprintf(__('URL base · %s (default)','mkb-glossar'), strtoupper($default_language));
            echo '<tr'.($key === 'slug' ? ' class="mkb-glossar-default-url-row"' : '').'><th><label for="mkb_'.esc_attr($key).'">'.esc_html($label).'</label></th><td><input class="regular-text" id="mkb_'.esc_attr($key).'" name="mkb_glossar_options['.esc_attr($key).']" value="'.esc_attr($o[$key]).'">';
            if ($key === 'slug') {
                $problem = mkb_glossar_url_base_problem((string)$o['slug']);
                if ($problem !== null) echo '<p class="description" role="alert">'.esc_html($problem).'</p>';
                else echo '<p class="description">'.esc_html__('The base is checked again when saved. Other plugins may define additional URL rules.', 'mkb-glossar').'</p>';
            }
            echo '</td></tr>';
        }
        $language_slugs = (array)($o['language_slugs'] ?? []);
        $other_languages = array_values(array_filter($languages, static fn($code) => is_string($code) && $code !== $default_language));
        if ($other_languages) {
            echo '<tr><th scope="row">'.esc_html__('Multilingual URL bases', 'mkb-glossar').'</th><td>';
            echo '<details class="mkb-glossar-language-bases"><summary>'.esc_html__('Configure additional languages', 'mkb-glossar').' ('.count($other_languages).')</summary>';
            echo '<p class="description">'.esc_html__('Only configured languages appear here. Leave a field empty to use the default base. Existing language settings are preserved when the translation plugin is inactive.', 'mkb-glossar').'</p>';
            foreach ($other_languages as $code) {
                // translators: %s is a language code returned by Polylang or WPML.
                $label = sprintf(__('URL base – %s','mkb-glossar'), strtoupper($code));
                echo '<div class="mkb-glossar-language-base-field"><label for="mkb-glossar-lang-base-'.esc_attr($code).'">'.esc_html($label).'</label>';
                echo '<input class="regular-text" id="mkb-glossar-lang-base-'.esc_attr($code).'" name="mkb_glossar_options[language_slugs]['.esc_attr($code).']" value="'.esc_attr($language_slugs[$code] ?? '').'" placeholder="'.esc_attr($o['slug']).'" pattern="[a-z0-9-]+"></div>';
            }
            echo '<p class="description">'.esc_html__('Changing public URLs may require redirects. Check your WPML or Polylang URL configuration before changing translated bases.', 'mkb-glossar').'</p></details></td></tr>';
        }
    } elseif ($tab === 'linking') {
        echo '<tr><th>'.esc_html__('Automatic linking','mkb-glossar').'</th><td><label><input type="checkbox" name="mkb_glossar_options[auto_link]" value="1" '.checked($o['auto_link'],1,false).'> '.esc_html__('Enable','mkb-glossar').'</label></td></tr>';
        echo '<tr class="mkb-glossar-external-marker-row'.(!empty($o['mark_external_links']) ? ' is-icon-visible' : '').'"><th>'.esc_html__('Mark external glossary destinations','mkb-glossar').'</th><td><label class="mkb-glossar-ui-check-item"><input type="checkbox" id="mkb-glossar-mark-external-links" aria-controls="mkb-glossar-external-icon-settings" aria-expanded="'.(!empty($o['mark_external_links']) ? 'true' : 'false').'" name="mkb_glossar_options[mark_external_links]" value="1" '.checked(!empty($o['mark_external_links']),true,false).'> '.esc_html__('Show a small external-link symbol','mkb-glossar').'</label><p class="description">'.esc_html__('This option marks only terms whose own editor has an external destination enabled and saved. Normal glossary links remain unchanged.','mkb-glossar').'</p></td></tr>';
        // One radio group; WordPress stores exactly the same option keys as in DEV.3.16.10.
        $icon_choices = [
            'default' => ['external-link.svg', __('Standard', 'mkb-glossar')],
            'arrow' => ['arrow-up-right.svg', __('Arrow', 'mkb-glossar')],
            'globe' => ['globe.svg', __('Globe', 'mkb-glossar')],
            'link' => ['link.svg', __('Link', 'mkb-glossar')],
        ];
        $selected_icon = (string)($o['external_icon_style'] ?? 'default');
        if (!in_array($selected_icon, mkb_glossar_external_icon_styles(), true)) $selected_icon = 'default';
        $image_id = absint($o['external_icon_attachment_id'] ?? 0);
        $image_url = mkb_glossar_external_icon_attachment_url($image_id);
        echo '<tr id="mkb-glossar-external-icon-settings" class="mkb-glossar-external-icon-settings"'.(!empty($o['mark_external_links']) ? '' : ' hidden').'><th scope="row">'.esc_html__('Icon for external links', 'mkb-glossar').'</th><td>';
        echo '<fieldset id="mkb-glossar-external-style" class="mkb-glossar-icon-picker">';
        echo '<legend class="screen-reader-text">'.esc_html__('Icon for external links', 'mkb-glossar').'</legend>';
        echo '<div class="mkb-glossar-icon-tiles">';
        foreach ($icon_choices as $key => $icon_info) {
            $icon_url = MKB_GLOSSAR_URL . 'assets/icons/' . $icon_info[0];
            echo '<label class="mkb-glossar-icon-tile"><input type="radio" name="mkb_glossar_options[external_icon_style]" value="'.esc_attr($key).'" '.checked($selected_icon, $key, false).'>';
            echo '<span class="mkb-glossar-icon-tile-visual" aria-hidden="true"><img src="'.esc_url($icon_url).'" alt="" width="22" height="22"></span>';
            echo '<span class="mkb-glossar-icon-tile-text">'.esc_html($icon_info[1]).'</span></label>';
        }
        echo '</div>';
        echo '<div class="mkb-glossar-icon-custom-section">';
        echo '<label class="mkb-glossar-icon-custom-choice"><input type="radio" name="mkb_glossar_options[external_icon_style]" value="custom" '.checked($selected_icon, 'custom', false).'>';
        echo '<span class="mkb-glossar-icon-custom-glyph" aria-hidden="true"><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="4" width="18" height="16" rx="2"/><circle cx="8.5" cy="9" r="1.5"/><path d="m4 18 5-5 3 3 4-5 4 5"/></svg></span>';
        echo '<span class="mkb-glossar-icon-custom-heading"><strong>'.esc_html__('Own image from the WordPress Media Library', 'mkb-glossar').'</strong>';
        echo '<span>'.esc_html__('PNG, WebP, JPG or AVIF. Preview and remove images here; SVG uploads remain disabled.', 'mkb-glossar').'</span></span></label>';
        echo '<div id="mkb-glossar-custom-icon" class="mkb-glossar-custom-icon"'.($selected_icon === 'custom' ? '' : ' hidden').'>';
        echo '<input type="hidden" id="mkb-glossar-external-attachment" name="mkb_glossar_options[external_icon_attachment_id]" value="'.esc_attr((string)$image_id).'">';
        echo '<div class="mkb-glossar-custom-icon-actions"><button id="mkb-glossar-pick-icon" type="button" class="button">'.esc_html__('Choose image', 'mkb-glossar').'</button>';
        echo '<button id="mkb-glossar-clear-icon" type="button" class="button"'.($image_id ? '' : ' disabled').'>'.esc_html__('Remove image', 'mkb-glossar').'</button></div>';
        echo '<div id="mkb-glossar-icon-preview" class="mkb-glossar-icon-preview" aria-live="polite">';
        if ($image_url) echo '<img src="'.esc_url($image_url).'" alt="'.esc_attr__('Selected icon preview', 'mkb-glossar').'">';
        else echo '<span>'.esc_html__('No image selected; the standard icon will be used.', 'mkb-glossar').'</span>';
        echo '</div></div></div></fieldset>';
        echo '<p class="description mkb-glossar-icon-color-hint">'.esc_html__('Built-in icons use the link color. Your own image keeps its original colors.', 'mkb-glossar').' ';
        echo '<a class="mkb-glossar-context-help" href="'.esc_url(mkb_glossar_help_url('linking-step-2')).'">'.esc_html__('See icon examples in the handbook', 'mkb-glossar').'</a></p></td></tr>';
        foreach (['max_links'=>__('Maximum links per content','mkb-glossar'), 'repeat_per_term'=>__('Links per glossary term and page','mkb-glossar')] as $key => $label) {
            echo '<tr><th>'.esc_html($label).'</th><td><input type="number" min="1" max="'.($key === 'max_links' ? '100' : '10').'" name="mkb_glossar_options['.esc_attr($key).']" value="'.esc_attr($o[$key]).'"></td></tr>';
        }
        echo '<tr class="mkb-glossar-ui-types-row"><th>'.esc_html__('Enable linking for content types','mkb-glossar').'</th><td><div class="mkb-glossar-ui-content-types">';
        foreach (get_post_types(['public'=>true], 'objects') as $type) {
            if ($type->name === 'mkb_glossar') continue;
            echo '<label class="mkb-glossar-ui-check-item"><input type="checkbox" name="mkb_glossar_options[enabled_types][]" value="'.esc_attr($type->name).'" '.checked(in_array($type->name,(array)$o['enabled_types'],true),true,false).'> '.esc_html($type->label).' ('.esc_html($type->name).')</label>';
        }
        echo '</div></td></tr>';
    } elseif ($tab === 'exclusions') {
        // This section is not submitted as a settings table: individual rules are managed with AJAX.
        // No empty form/table above this pane: it caused the persistent tab-to-card gap.
        echo '<div class="mkb-glossar-exclusions-screen">';
        echo '<section class="mkb-glossar-exclusions-section" aria-labelledby="mkb-glossar-individual-heading">';
        echo '<div class="mkb-glossar-section-heading"><div><h2 id="mkb-glossar-individual-heading">'.esc_html__('Individual content exclusions','mkb-glossar').'</h2>';
        echo '<p>'.esc_html__('Search and exclude individual pages, posts or custom post types.','mkb-glossar').'</p></div></div>';
        echo '<label class="mkb-glossar-search-label" for="mkb-glossar-exclusion-search">'.esc_html__('Add exclusion','mkb-glossar').'</label>';
        echo '<div class="mkb-glossar-search-wrap"><span class="dashicons dashicons-search" aria-hidden="true"></span><input id="mkb-glossar-exclusion-search" type="search" autocomplete="off" placeholder="'.esc_attr__('Search by content title…','mkb-glossar').'"></div>';
        echo '<div id="mkb-glossar-exclusion-results" class="mkb-glossar-search-results" role="status" aria-live="polite"></div>';
        echo '<div class="mkb-glossar-exclusion-panel"><div class="mkb-glossar-panel-heading"><h3>'.esc_html__('Currently excluded','mkb-glossar').'</h3><span id="mkb-glossar-exclusion-count" class="mkb-glossar-count">0</span></div>';
        echo '<div class="mkb-glossar-exclusion-table-wrap"><table class="mkb-glossar-exclusion-table"><thead><tr><th scope="col">'.esc_html__('Content','mkb-glossar').'</th><th scope="col">'.esc_html__('Type','mkb-glossar').'</th><th scope="col">'.esc_html__('Exclusion reason','mkb-glossar').'</th><th scope="col" class="mkb-glossar-actions-head">'.esc_html__('Actions','mkb-glossar').'</th></tr></thead><tbody id="mkb-glossar-exclusion-list" aria-live="polite"></tbody></table></div></div>';
        echo '<p class="mkb-glossar-section-note">'.esc_html__('You can also edit individual exclusions in the content editor. Changes take effect immediately.','mkb-glossar').'</p></section>';
        echo '<section class="mkb-glossar-exclusions-section" aria-labelledby="mkb-glossar-taxonomy-heading"><div class="mkb-glossar-section-heading"><div><h2 id="mkb-glossar-taxonomy-heading">'.esc_html__('Taxonomy rules','mkb-glossar').'</h2>';
        echo '<p>'.esc_html__('Exclude all content assigned to selected categories or terms. These rules are separate from individual exclusions.','mkb-glossar').'</p></div></div>';
        echo '<form method="post" action="'.esc_url(admin_url('options.php')).'" class="mkb-glossar-taxonomy-form">';
        settings_fields('mkb_glossar_settings');
        echo '<input type="hidden" name="mkb_glossar_options[_section]" value="exclusions">';
        $found = false;
        foreach (get_taxonomies(['public'=>true], 'objects') as $tax) {
            if ($tax->name === 'mkb_glossar_topic') continue;
            $found = true;
            $taxonomy_label = $tax->name === 'post_format' ? __('Post formats (WordPress)', 'mkb-glossar') : $tax->label;
            echo '<div class="mkb-glossar-taxonomy-field"><label for="mkb-glossar-tax-'.esc_attr($tax->name).'">'.esc_html($taxonomy_label).'</label>';
            echo '<input id="mkb-glossar-tax-'.esc_attr($tax->name).'" type="text" name="mkb_glossar_options[excluded_terms]['.esc_attr($tax->name).']" value="'.esc_attr(implode(', ',(array)($o['excluded_terms'][$tax->name] ?? []))).'" aria-describedby="mkb-glossar-tax-help">';
            echo '</div>';
        }
        if (!$found) echo '<p>'.esc_html__('No public taxonomies available.','mkb-glossar').'</p>';
        echo '<p id="mkb-glossar-tax-help" class="description">'.esc_html__('Enter numeric taxonomy term IDs (not glossary entry IDs), separated by commas. Leave unused fields empty.','mkb-glossar').' <a class="mkb-glossar-context-help" href="'.esc_url(mkb_glossar_help_url('linking-step-9')).'">'.esc_html__('How to find IDs and use exclusions','mkb-glossar').'</a></p>';
        echo '<p class="submit"><button type="submit" name="submit" id="submit" class="button button-primary mkb-admin-save-button"><svg class="mkb-admin-button-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2Z"/><path d="M17 21v-8H7v8M7 3v5h8"/></svg>'.esc_html__('Save taxonomy rules','mkb-glossar').'</button></p>';
        echo '</form></section></div>';
        return;
    } elseif ($tab === 'tooltips') {
        echo '<tr><th>'.esc_html__('Design inheritance','mkb-glossar').'</th><td><p>'.esc_html__('Each field can inherit the global design or override it. Clear an override to restore inheritance.','mkb-glossar').'</p></td></tr>';
        $fields = [
            'background'=>__('Background color','mkb-glossar'), 'color'=>__('Text color','mkb-glossar'), 'border_color'=>__('Border color','mkb-glossar'),
            'font_family'=>__('Font family','mkb-glossar'), 'font_size'=>__('Font size (px)','mkb-glossar'), 'font_weight'=>__('Font weight','mkb-glossar'),
            'line_height'=>__('Line height','mkb-glossar'), 'radius'=>__('Corner radius (px)','mkb-glossar'),
            'padding'=>__('Padding (px)','mkb-glossar'), 'border_width'=>__('Border width (px)','mkb-glossar'), 'max_width'=>__('Maximum width (px)','mkb-glossar')
        ];
        $fonts = [''=>'— '.__('Inherit','mkb-glossar').' —','system-ui, sans-serif'=>'System UI','Arial, sans-serif'=>'Arial','Georgia, serif'=>'Georgia','Verdana, sans-serif'=>'Verdana','Tahoma, sans-serif'=>'Tahoma','Trebuchet MS, sans-serif'=>'Trebuchet MS','Times New Roman, serif'=>'Times New Roman','Courier New, monospace'=>'Courier New'];
        $kit_fonts = mkb_glossar_kit_font_families();
        foreach ($kit_fonts as $family) {
            if (!isset($fonts[$family])) $fonts[$family] = $family;
        }
        // A previously saved family remains visible even if its Kit token was removed.
        // Saving it again is refused by validation unless Elementor still supplies it.
        $saved_family = (string) ($o['tooltip']['font_family'] ?? '');
        if ($saved_family !== '' && !isset($fonts[$saved_family])) $fonts[$saved_family] = $saved_family;

        foreach ($fields as $key => $label) {
            $value = $o['tooltip'][$key] ?? '';
            echo '<tr><th><label for="mkb-tooltip-'.esc_attr($key).'">'.esc_html($label).'</label></th><td><div class="mkb-glossar-design-control">';
            if (in_array($key,['background','color','border_color'],true)) {
                echo '<span class="mkb-admin-color-field">';
                echo '<input type="color" class="mkb-glossar-color-picker mkb-admin-color-swatch" data-for="mkb-tooltip-'.esc_attr($key).'" value="'.esc_attr(sanitize_hex_color($value) ?: '#ffffff').'" aria-label="'.esc_attr($label).'">';
                echo '<input class="regular-text mkb-glossar-design-input mkb-admin-color-hex" id="mkb-tooltip-'.esc_attr($key).'" type="text" pattern="#[0-9a-fA-F]{6}" name="mkb_glossar_options[tooltip]['.esc_attr($key).']" value="'.esc_attr($value).'" placeholder="'.esc_attr__('Inherit (HEX)','mkb-glossar').'">';
                echo '</span>';
            } elseif ($key==='font_family') {
                echo '<select class="mkb-glossar-design-input mkb-admin-type-control" id="mkb-tooltip-font_family" name="mkb_glossar_options[tooltip][font_family]">';
                foreach($fonts as $font=>$name) {
                    if ($font !== '' && in_array($font, $kit_fonts, true)) continue;
                    echo '<option value="'.esc_attr($font).'" '.selected($value,$font,false).'>'.esc_html($name).'</option>';
                }
                if ($kit_fonts) {
                    echo '<optgroup label="'.esc_attr__('Fonts in active Elementor Kit','mkb-glossar').'">';
                    foreach ($kit_fonts as $family) echo '<option value="'.esc_attr($family).'" '.selected($value,$family,false).'>'.esc_html($family).'</option>';
                    echo '</optgroup>';
                }
                echo '</select>';
            } elseif ($key === 'font_weight') {
                $weights = [100=>'Thin',200=>'Extra Light',300=>'Light',400=>'Regular',500=>'Medium',600=>'Semi Bold',700=>'Bold',800=>'Extra Bold',900=>'Black'];
                echo '<select class="mkb-glossar-design-input mkb-admin-type-control" id="mkb-tooltip-font_weight" name="mkb_glossar_options[tooltip][font_weight]">';
                echo '<option value="">'.esc_html__('Inherit','mkb-glossar').'</option>';
                foreach ($weights as $weight=>$name) echo '<option value="'.esc_attr($weight).'" '.selected((string)$value,(string)$weight,false).'>'.esc_html($weight.' – '.$name).'</option>';
                echo '</select>';
            } elseif ($key === 'line_height') {
                $unit = $o['tooltip']['line_height_unit'] ?? 'percent'; // Legacy data used percentages.
                echo '<input class="mkb-glossar-design-input mkb-glossar-number mkb-admin-type-control" id="mkb-tooltip-line_height" type="number" min="0" step="any" name="mkb_glossar_options[tooltip][line_height]" value="'.esc_attr($value).'" placeholder="'.esc_attr__('Inherit','mkb-glossar').'">';
                echo '<select class="mkb-glossar-unit" id="mkb-tooltip-line_height_unit" name="mkb_glossar_options[tooltip][line_height_unit]" aria-label="'.esc_attr__('Line height unit','mkb-glossar').'">';
                foreach (['factor'=>__('Factor','mkb-glossar'),'px'=>__('Pixels (px)','mkb-glossar'),'percent'=>__('Percent (%)','mkb-glossar')] as $unit_key=>$unit_label) echo '<option value="'.esc_attr($unit_key).'" '.selected($unit,$unit_key,false).'>'.esc_html($unit_label).'</option>';
                echo '</select>';
            } else {
                echo '<input class="mkb-glossar-design-input mkb-glossar-number mkb-admin-type-control" id="mkb-tooltip-'.esc_attr($key).'" type="number" min="0" max="900" name="mkb_glossar_options[tooltip]['.esc_attr($key).']" value="'.esc_attr($value).'" placeholder="'.esc_attr__('Inherit','mkb-glossar').'">';
            }
            echo '<button type="button" class="button mkb-glossar-reset" data-for="mkb-tooltip-'.esc_attr($key).'">'.esc_html__('Reset','mkb-glossar').'</button></div>';
            echo '<span class="mkb-glossar-design-source" data-property="'.esc_attr($key).'" aria-live="polite"></span></td></tr>';
        }


    }
    echo '</table>';
    if ($tab === 'general' && mkb_glossar_elementor_available()) {
        $selected = absint($o['elementor_details_template'] ?? 0);
        echo '<div class="mkb-glossar-shared-template-settings">';
        echo '<h2>' . esc_html__('One design for sources and related terms on every glossary page', 'mkb-glossar') . '</h2>';
        echo '<p>' . esc_html__('This setting controls only the two sections “Sources and references” and “Related terms” below each glossary explanation—not the term title, the explanation or the whole page. With Elementor Free, save a container holding the MKB Glossary Details widget. In that widget, select an example glossary term for the editor preview and design the sections once. Choose the saved container below to apply that design automatically to every published glossary term.', 'mkb-glossar') . '</p>';
        echo '<label for="mkb-glossar-shared-template">' . esc_html__('Elementor template for sources and related terms', 'mkb-glossar') . '</label>';
        $choices = function_exists('mkb_glossar_shared_template_choices') ? mkb_glossar_shared_template_choices() : [];
        echo '<select id="mkb-glossar-shared-template" name="mkb_glossar_options[elementor_details_template]">';
        echo '<option value="0"' . selected($selected, 0, false) . '>' . esc_html__('Standard glossary layout (without Elementor)', 'mkb-glossar') . '</option>';
        foreach ($choices as $id => $label) {
            echo '<option value="' . esc_attr($id) . '"' . selected($selected, $id, false) . '>' . esc_html($label) . '</option>';
        }
        if ($selected && !isset($choices[$selected])) {
            echo '<option value="' . esc_attr($selected) . '" selected disabled>' . esc_html__('Previously selected template is currently unavailable', 'mkb-glossar') . '</option>';
        }
        echo '</select>';
        echo '<p class="mkb-glossar-shared-template-tip">' . esc_html__('The term selected for the Elementor editor preview is only an example. On the actual site each glossary page displays its own sources and related terms. Without a usable template, MKB Glossar keeps the standard appearance. You do not have to edit each term.', 'mkb-glossar') . '</p>';
        if (did_action('elementor/loaded') && current_user_can('edit_posts')) {
            echo '<a class="mkb-glossar-shared-template-link" href="' . esc_url(admin_url('edit.php?post_type=elementor_library')) . '">' . esc_html__('Edit saved Elementor templates', 'mkb-glossar') . '</a>';
        }
        echo '</div>';
        // Keep all three widgets enabled on upgrades until an administrator opts out.
        $widget_labels = [
            'overview' => __('Glossary overview', 'mkb-glossar'),
            'search' => __('Glossary search field', 'mkb-glossar'),
            'details' => __('Sources and related terms', 'mkb-glossar'),
        ];
        echo '<div class="mkb-glossar-widget-settings"><h2>'.esc_html__('Elementor widgets', 'mkb-glossar').'</h2>';
        echo '<p class="description">'.esc_html__('Choose which MKB Glossar widgets appear in Elementor. All widgets are enabled by default. Shortcodes and Gutenberg blocks work independently of these switches.', 'mkb-glossar').'</p>';
        echo '<div class="mkb-glossar-widget-settings-list">';
        foreach ($widget_labels as $key => $label) {
            $id = 'mkb-glossar-elementor-widget-' . $key;
            echo '<div class="mkb-glossar-widget-settings-item"><input type="hidden" name="mkb_glossar_options[elementor_widgets]['.esc_attr($key).']" value="0">';
            echo '<label for="'.esc_attr($id).'"><input type="checkbox" id="'.esc_attr($id).'" name="mkb_glossar_options[elementor_widgets]['.esc_attr($key).']" value="1" '.checked(mkb_glossar_elementor_widget_enabled($key), true, false).'> '.esc_html($label).'</label></div>';
        }
        echo '</div><p class="description">'.esc_html__('Disable only widgets you do not use. A widget removed from Elementor may no longer render on existing pages that contain it. Re-enable it here to restore those pages.', 'mkb-glossar').'</p></div>';
    }
    echo '<p class="submit"><button type="submit" name="submit" id="submit" class="button button-primary mkb-admin-save-button"><svg class="mkb-admin-button-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2Z"/><path d="M17 21v-8H7v8M7 3v5h8"/></svg>'.esc_html__('Save settings','mkb-glossar').'</button></p>';
    if ($tab === 'tooltips') {
        echo '</form>'; // Close MKB settings form before the independent Elementor global form.
        echo '</div><aside class="mkb-glossar-tooltip-preview-panel" aria-label="'.esc_attr__('Live preview','mkb-glossar').'">';
        echo '<h2>'.esc_html__('Live preview','mkb-glossar').'</h2>';
        echo '<div class="mkb-glossar-preview-area"><div id="mkb-glossar-tooltip-preview">'.esc_html__('Face Framing: highlights around the face.','mkb-glossar').'</div></div>';
        $kit_data = mkb_glossar_get_optional_kit();
        if (!empty($kit_data['available'])) {
            echo '<div class="mkb-glossar-kit-summary"><strong>'.esc_html__('Elementor global design','mkb-glossar').'</strong>';
            // translators: %d: numeric Elementor Kit ID used for the active global design.
            echo '<p>'.esc_html(sprintf(__('Active kit ID: %d.','mkb-glossar'), $kit_data['kit_id'])).'</p>';
            // Authorized users edit the same tokens in place; no duplicated read-only row.
            if (current_user_can('manage_options')) {
                require_once MKB_GLOSSAR_PATH . 'includes/elementor-global-editor.php';
                mkb_glossar_render_global_color_editor();
            } elseif (!empty($kit_data['tokens']['colors'])) {
                echo '<div class="mkb-glossar-kit-colors" role="list">';
                foreach ($kit_data['tokens']['colors'] as $token) echo '<span class="mkb-glossar-kit-color-token" role="listitem"><i aria-hidden="true" style="background:'.esc_attr($token['color']).'"></i><span class="mkb-glossar-kit-color-name">'.esc_html($token['name']).'</span><code>'.esc_html($token['color']).'</code></span>';
                echo '</div>';
            }
            if (current_user_can('manage_options')) {
                require_once MKB_GLOSSAR_PATH . 'includes/elementor-typography-editor.php';
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-backups.php';
                mkb_glossar_render_global_typography_editor();
            } elseif (!empty($kit_data['tokens']['typography'])) {
                echo '<div class="mkb-glossar-kit-typography"><strong>'.esc_html__('Global typography:','mkb-glossar').'</strong><div class="mkb-glossar-kit-typography-tokens">';
                foreach ($kit_data['tokens']['typography'] as $token) echo '<span class="mkb-glossar-kit-type-token">'.esc_html($token['name']).'</span>';
                echo '</div></div>';
            }
            if (current_user_can('manage_options')) { require_once MKB_GLOSSAR_PATH . 'includes/elementor-backups.php'; mkb_glossar_render_backup_history(); }
            echo '</div>';
        } else {
            // No Elementor-specific section or warning when the integration is unavailable.
        }
        if (!empty($kit_data['available'])) echo '<p class="description">'.esc_html__('Non-overridden tooltip properties inherit the Elementor text design.','mkb-glossar').'</p>';
        echo '</aside></div>';
    }
    if ($tab !== 'exclusions') echo '</section>';
    if ($tab !== 'tooltips') echo '</form>';
    if ($tab === 'general') {
        echo '<section class="mkb-glossar-settings-panel mkb-glossar-info-panel mkb-glossar-ui-info-card mkb-glossar-setup-entry">';
        echo '<header class="mkb-glossar-ui-section-header"><span class="dashicons dashicons-welcome-learn-more" aria-hidden="true"></span><div><h2>' . esc_html__('Setup assistant', 'mkb-glossar') . '</h2><p>' . esc_html__('Choose your names first, then review the other setup steps. You can reopen the assistant without resetting content or settings.', 'mkb-glossar') . '</p></div></header>';
        echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '">';
        echo '<input type="hidden" name="action" value="mkb_glossar_setup_restart">';
        wp_nonce_field('mkb_glossar_setup_restart');
        echo '<button type="submit" class="button mkb-glossar-help-shortcut"><svg class="mkb-glossar-setup-restart-icon" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M3 11a9 9 0 1 1 2.6 6.4"/><path d="M3 4v7h7"/></svg><span>' . esc_html__('Restart guided setup', 'mkb-glossar') . '</span></button></form>';
        echo '</section>';
        echo '<section class="mkb-glossar-settings-panel mkb-glossar-info-panel mkb-glossar-ui-info-card">';
        echo '<header class="mkb-glossar-ui-section-header"><span class="dashicons dashicons-shortcode" aria-hidden="true"></span><div><h2>'.esc_html__('Integration','mkb-glossar').'</h2><p>'.esc_html(mkb_glossar_elementor_available()
            ? __('Build the overview with Elementor, Gutenberg or a shortcode.', 'mkb-glossar')
            : __('Place the overview on a page with Gutenberg or a shortcode.', 'mkb-glossar')).'</p></div></header>';
        mkb_glossar_render_shortcode_copy_control();
        mkb_glossar_render_shortcode_reference('settings');
        echo '<p class="mkb-glossar-settings-embed-note">' . esc_html__('Using Gutenberg? Add the “MKB Glossar” block instead.', 'mkb-glossar') . '</p>';
        echo '</section>';
    }
    echo '</div>';
}

add_action('admin_enqueue_scripts',function($hook){
    if ($hook !== 'mkb_glossar_page_mkb-glossar') return;
    // RC4.5: URL cleanup for consumed one-time notices; never emit raw script tags.
    wp_enqueue_script(
        'mkb-glossar-admin-notice-cleanup',
        MKB_GLOSSAR_URL . 'assets/admin-notice-cleanup.js',
        [],
        MKB_GLOSSAR_VERSION,
        true
    );
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $tab = mkb_glossar_request_key($_GET, 'tab', 'general');
    if (!in_array($tab,['general','linking','exclusions','presentation','tooltips'],true)) return;
    $settings_css_path = MKB_GLOSSAR_PATH . 'assets/admin-settings.css';
    $settings_css_version = is_file($settings_css_path) ? (string) filemtime($settings_css_path) : MKB_GLOSSAR_VERSION;
    wp_enqueue_style('mkb-glossar-admin', MKB_GLOSSAR_URL.'assets/admin-settings.css', [], $settings_css_version);
    if ($tab === 'linking') {
        wp_enqueue_media(); // WordPress native, permission-aware Media Library picker.
        $icon_js = MKB_GLOSSAR_PATH . 'assets/admin-external-icon.js';
        wp_enqueue_script('mkb-glossar-external-icon-admin', MKB_GLOSSAR_URL . 'assets/admin-external-icon.js',
            ['media-views'], is_file($icon_js) ? (string)filemtime($icon_js) : MKB_GLOSSAR_VERSION, true);
        wp_add_inline_script('mkb-glossar-external-icon-admin', 'window.mkbGlossarIconLabels=' . wp_json_encode([
            'title' => __('Choose an icon image', 'mkb-glossar'),
            'button' => __('Use this icon', 'mkb-glossar'),
            'empty' => __('No image selected; the standard icon will be used.', 'mkb-glossar'),
            'preview' => __('Selected icon preview', 'mkb-glossar'),
        ]) . ';', 'before');
    }
    if ($tab === 'presentation') {
        $appearance_js = MKB_GLOSSAR_PATH . 'assets/admin-maturity.js';
        wp_enqueue_script('mkb-glossar-admin-maturity', MKB_GLOSSAR_URL . 'assets/admin-maturity.js', [], is_file($appearance_js) ? (string)filemtime($appearance_js) : MKB_GLOSSAR_VERSION, true);
    }
    if ($tab === 'general') {
        // Reuse the already-tested Help copy behavior; load only on the embedding screen.
        $copy_script = MKB_GLOSSAR_PATH . 'assets/admin-help.js';
        wp_enqueue_script('mkb-glossar-admin-shortcode-copy', MKB_GLOSSAR_URL . 'assets/admin-help.js', [], is_file($copy_script) ? (string) filemtime($copy_script) : MKB_GLOSSAR_VERSION, true);
    }
    if ($tab === 'tooltips' && did_action('elementor/loaded') && class_exists('\Elementor\Plugin')) {
        // Keep Elementor global color text fields and native swatches in sync without submitting the form.
        $global_color_sync = <<<'JS'
document.addEventListener('input', function (event) {
    var target = event.target;
    var item = target.closest('.mkb-glossar-global-color-item');
    if (!item || !item.closest('form.mkb-glossar-global-form')) return;
    var picker = item.querySelector('input[data-mkb-global-picker]');
    var hex = item.querySelector('input[type="text"][name^="colors["]');
    if (!picker || !hex) return;
    if (target === picker) {
        hex.value = picker.value;
    } else if (target === hex) {
        var value = hex.value.trim();
        if (/^#[0-9a-fA-F]{6}$/.test(value)) picker.value = value;
    }
});
document.addEventListener('keydown', function (event) {
    if (event.key !== 'Enter' || event.isComposing) return;
    var target = event.target;
    if (target.matches('form.mkb-glossar-global-form input[type="text"][name^="colors["]')) {
        event.preventDefault();
    }
});
JS;
        wp_enqueue_script('jquery-core');
        wp_add_inline_script('jquery-core', $global_color_sync, 'after');
    }
    if ($tab === 'tooltips') mkb_glossar_enqueue_preview_font();
    if ($tab === 'tooltips') { wp_enqueue_script('mkb-glossar-admin-design',MKB_GLOSSAR_URL.'assets/admin-design.js',[],MKB_GLOSSAR_VERSION,true); wp_add_inline_script('mkb-glossar-admin-design', 'window.mkbGlossarElementorKit = '.wp_json_encode(mkb_glossar_get_optional_inheritance()).';', 'before'); wp_add_inline_script('mkb-glossar-admin-design', 'window.mkbGlossarPreviewFonts = '.wp_json_encode(['url'=>admin_url('admin-ajax.php'),'nonce'=>wp_create_nonce('mkb_glossar_preview_font'),'families'=>mkb_glossar_kit_font_families()]).';', 'before'); wp_add_inline_script('mkb-glossar-admin-design', 'window.mkbGlossarDesignLabels = '.wp_json_encode(['custom'=>__('Individual','mkb-glossar'),'inherited'=>__('Inherited','mkb-glossar'),'source'=>__('Source','mkb-glossar'),'fallback'=>__('MKB default','mkb-glossar')]).';', 'before'); return; }
    wp_enqueue_script('mkb-glossar-admin-exclusions', MKB_GLOSSAR_URL.'assets/admin-exclusions.js',[],MKB_GLOSSAR_VERSION,true);
    wp_add_inline_script('mkb-glossar-admin-exclusions','window.mkbGlossarExclusions='.wp_json_encode([
        'url'=>admin_url('admin-ajax.php'), 'nonce'=>wp_create_nonce('mkb_glossar_exclusions'),
        'remove'=>__('Remove','mkb-glossar'), 'add'=>__('Exclude','mkb-glossar'), 'none'=>__('No matches','mkb-glossar'), 'empty'=>__('No individually excluded content.','mkb-glossar'), 'type'=>__('Content type','mkb-glossar'), 'reason'=>__('Reason','mkb-glossar'), 'individual'=>__('Individual exclusion','mkb-glossar'), 'legacy'=>__('Legacy ID rule','mkb-glossar'), 'edit'=>__('Edit','mkb-glossar'), 'searchHint'=>__('Choose a result to exclude it','mkb-glossar'), 'loading'=>__('Loading…','mkb-glossar'), 'error'=>__('Could not update exclusions. Please try again.','mkb-glossar'), 'content'=>__('Content','mkb-glossar')
    ]).';','before');
});

add_action('wp_ajax_mkb_glossar_exclusions',function(){
    if (!current_user_can('manage_options')) wp_send_json_error(['message'=>'Forbidden'],403);
    check_ajax_referer('mkb_glossar_exclusions','nonce');
    // The nonce and capability are checked above; reject malformed request shapes before sanitization.
    if (!mkb_glossar_request_optional_scalar_fields($_POST,['mode','id','query'])) wp_send_json_error(['message'=>'Invalid input'],400);
    $mode = mkb_glossar_request_key($_POST,'mode','list');
    if (!in_array($mode,['list','search','add','remove'],true)) wp_send_json_error(['message'=>'Invalid mode'],400);
    if (in_array($mode,['add','remove'],true)) {
        $raw_id = isset($_POST['id']) && is_scalar($_POST['id'])
            ? sanitize_text_field(wp_unslash((string) $_POST['id'])) : null;
        if (!is_scalar($raw_id) || !ctype_digit((string)$raw_id)) wp_send_json_error(['message'=>'Invalid content'],400);
        $id=absint($raw_id);
        $p=get_post($id);
        if (!$p || $p->post_type==='mkb_glossar' || !current_user_can('edit_post',$id)) wp_send_json_error(['message'=>'Invalid content'],400);
        update_post_meta($id,'_mkb_glossar_exclude',$mode==='add'?'1':'0');
        // Legacy global ID exclusions are preserved and continue to be effective.
    }
    $o=mkb_glossar_opts();
    $ids=array_map('absint',(array)($o['excluded_ids'] ?? []));
    $marked=get_posts(['post_type'=>'any','post_status'=>'any','posts_per_page'=>500,'fields'=>'ids', 'meta_query'=>[['key'=>'_mkb_glossar_exclude','value'=>'1']]]);
    $ids=array_values(array_unique(array_merge($ids,$marked)));
    $excluded=[];
    foreach ($ids as $id) { $p=get_post($id); if (!$p || $p->post_type==='mkb_glossar') continue; $excluded[]=['id'=>$id,'title'=>get_the_title($id),'type'=>$p->post_type,'type_label'=>get_post_type_object($p->post_type)->labels->singular_name ?? $p->post_type,'locked'=>in_array($id,(array)$o['excluded_ids']),'edit'=>get_edit_post_link($id,'raw') ?: '']; }
    $results=[];
    if ($mode==='search') {
        $query=sanitize_text_field(wp_unslash((string)($_POST['query'] ?? '')));
        if ((function_exists('mb_strlen') ? mb_strlen($query) : strlen($query)) > 150) wp_send_json_error(['message'=>'Search too long'],400);
        if (function_exists('mb_strlen') ? mb_strlen($query)>=2 : strlen($query)>=2) {
            $posts=get_posts(['post_type'=>array_values(array_diff(get_post_types(['show_ui'=>true]),['mkb_glossar','attachment'])),'post_status'=>['publish','draft','private','pending','future'],'posts_per_page'=>15,'s'=>$query]);
            foreach ($posts as $p) $results[]=['id'=>$p->ID,'title'=>get_the_title($p),'type'=>$p->post_type,'type_label'=>get_post_type_object($p->post_type)->labels->singular_name ?? $p->post_type,'excluded'=>in_array($p->ID,$ids)];
        }
    }
    wp_send_json_success(['excluded'=>$excluded,'results'=>$results]);
});

/** Lazily load the integration only when Elementor is active and ready. */
function mkb_glossar_get_optional_kit() {
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Plugin')) return ['available'=>false];
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-design.php';
    return mkb_glossar_elementor_design_tokens();
}
function mkb_glossar_get_optional_inheritance() {
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Plugin')) return ['available'=>false, 'values'=>[], 'sources'=>[]];
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-design.php';
    return mkb_glossar_elementor_inherited_values();
}

// Register the guarded global color save handler only when Elementor is loaded.
add_action('admin_init', function () {
    if (!did_action('elementor/loaded') || !class_exists('\Elementor\Plugin')) return;
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-global-editor.php';
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-typography-editor.php';
    require_once MKB_GLOSSAR_PATH . 'includes/elementor-backups.php';
});

// DEV.3.9.0: shared, screen-scoped asset routing for non-settings admin pages.
// Preserve separate asset handles and only load assets on their original screens.
add_action('admin_enqueue_scripts', static function () {
    $screen = get_current_screen();
    $is_terms = $screen && $screen->base === 'edit-tags' && $screen->taxonomy === 'mkb_glossar_topic';
    $is_posts = $screen && $screen->base === 'edit' && $screen->post_type === 'mkb_glossar';
    if ($is_terms || $is_posts) {
        $management_css = MKB_GLOSSAR_PATH . 'assets/admin-management.css';
        wp_enqueue_style('mkb-glossar-management-ui', MKB_GLOSSAR_URL . 'assets/admin-management.css', [], is_file($management_css) ? (string)filemtime($management_css) : MKB_GLOSSAR_VERSION);
        if ($is_posts) {
            wp_enqueue_script('mkb-glossar-list-filters', MKB_GLOSSAR_URL . 'assets/admin-list-filters.js', [], MKB_GLOSSAR_VERSION, true);
        }
    }

    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $page = isset($_GET['page']) && is_scalar($_GET['page']) ? sanitize_key(wp_unslash($_GET['page'])) : '';
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $tab = isset($_GET['tab']) && is_scalar($_GET['tab']) ? sanitize_key(wp_unslash($_GET['tab'])) : '';
    if ($page === 'mkb-glossar' && in_array($tab, ['', 'general', 'linking', 'exclusions', 'presentation', 'tooltips'], true)) {
        // Filemtime also refreshes this scoped stylesheet during UI revisions at the same DEV version.
        $design_css = MKB_GLOSSAR_PATH . 'assets/admin-design-system.css';
        $design_version = is_file($design_css) ? (string) filemtime($design_css) : MKB_GLOSSAR_VERSION;
        wp_enqueue_style('mkb-glossar-backup-ui', MKB_GLOSSAR_URL . 'assets/admin-design-system.css', [], $design_version);
        wp_enqueue_script('mkb-glossar-backup-ui', MKB_GLOSSAR_URL . 'assets/admin-backup-ui.js', [], MKB_GLOSSAR_VERSION, true);
    }
});


/** A language selector in the glossary list, backed by the translation provider's query. */
add_action('restrict_manage_posts',function($post_type,$which='top') {
 if ($post_type !== 'mkb_glossar' || $which !== 'top') return;
 if (!mkb_glossar_polylang_enabled() || !function_exists('pll_languages_list')) return;
 $languages = (array)pll_languages_list(['fields'=>'slug']);
 if (!$languages) return;
 // Reuse Polylang's canonical `lang` query variable and never add a second
 // request filter. If Polylang has already emitted its own selector, skip ours.
 if (did_action('pll_admin_language_filter_rendered')) return;
 // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
 $chosen = mkb_glossar_request_key($_GET,'lang','all');
 echo '<label class="screen-reader-text" for="mkb-glossar-language-filter">'.esc_html__('Filter by language','mkb-glossar').'</label>';
 echo '<select id="mkb-glossar-language-filter" name="lang" aria-label="'.esc_attr__('Filter by language','mkb-glossar').'"><option value="all">'.esc_html__('All languages','mkb-glossar').'</option>';
 foreach ($languages as $code) {
  $label = function_exists('pll_the_languages') ? (array)pll_the_languages(['raw'=>1]) : [];
  $name = isset($label[$code]['name']) ? $label[$code]['name'] : strtoupper($code);
  echo '<option value="'.esc_attr($code).'" '.selected($chosen,$code,false).'>'.esc_html($name).'</option>';
 }
 echo '</select>';
},40,2);

/** DEV.3.14.7: Native taxonomy-backed topic selector on the glossary post list. */
add_action('restrict_manage_posts', static function ($post_type, $which = 'top') {
    if ($post_type !== 'mkb_glossar' || $which !== 'top') return;
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $language = isset($_GET['lang']) && is_scalar($_GET['lang']) ? sanitize_key(wp_unslash($_GET['lang'])) : 'all';
    $args = ['taxonomy' => 'mkb_glossar_topic', 'hide_empty' => false, 'orderby' => 'name', 'order' => 'ASC'];
    // Explicit language for Polylang. Empty language means no language constraint.
    if (mkb_glossar_polylang_enabled()) $args['lang'] = $language === 'all' ? '' : $language;
    $terms = get_terms($args);
    if (is_wp_error($terms)) $terms = [];
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $chosen = isset($_GET['mkb_topic_filter']) && is_scalar($_GET['mkb_topic_filter']) ? sanitize_title(wp_unslash($_GET['mkb_topic_filter'])) : '';
    echo '<label class="screen-reader-text" for="mkb-glossar-topic-filter">'.esc_html__('Filter by topic', 'mkb-glossar').'</label>';
    echo '<select id="mkb-glossar-topic-filter" name="mkb_topic_filter" aria-label="'.esc_attr__('Filter by topic', 'mkb-glossar').'">';
    echo '<option value="">'.esc_html__('All topics', 'mkb-glossar').'</option>';
    foreach ($terms as $term) {
        echo '<option value="'.esc_attr($term->slug).'" '.selected($chosen, $term->slug, false).'>'.esc_html($term->name).'</option>';
    }
    echo '</select>';
}, 45, 2);

/** Filter glossary posts with the registered WordPress topic taxonomy, without custom SQL. */
add_action('pre_get_posts', static function ($query) {
    if (!is_admin() || !$query->is_main_query()) return;
    if ($query->get('post_type') !== 'mkb_glossar') return;
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    if (empty($_GET['mkb_topic_filter']) || !is_scalar($_GET['mkb_topic_filter'])) return;
    // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only GET/navigation parameter; no state is changed and input is validated separately.
    $slug = sanitize_title(wp_unslash($_GET['mkb_topic_filter']));
    if ($slug === '') return;
    $tax_query = (array)$query->get('tax_query');
    $tax_query[] = ['taxonomy' => 'mkb_glossar_topic', 'field' => 'slug', 'terms' => [$slug], 'include_children' => true];
    $query->set('tax_query', $tax_query);
});

/** Glossary table: show the last editorial update separately from publication date. */
add_filter('manage_edit-mkb_glossar_columns', static function($columns) {
    $out = [];
    foreach ($columns as $key => $label) {
        if ($key === 'date') $out['mkb_glossar_modified'] = __('Last edited', 'mkb-glossar');
        $out[$key] = $label;
    }
    if (!isset($out['mkb_glossar_modified'])) $out['mkb_glossar_modified'] = __('Last edited', 'mkb-glossar');
    return $out;
}, 20);
add_action('manage_mkb_glossar_posts_custom_column', static function($column, $post_id) {
    if ($column !== 'mkb_glossar_modified') return;
    echo '<time datetime="' . esc_attr(get_post_modified_time('c', true, $post_id)) . '">'
         . esc_html(get_post_modified_time(get_option('date_format').' '.get_option('time_format'), false, $post_id, true)) . '</time>';
}, 10, 2);
add_filter('manage_edit-mkb_glossar_sortable_columns', static function($columns) {
    $columns['mkb_glossar_modified'] = 'modified';
    $columns['taxonomy-mkb_glossar_topic'] = 'mkb_glossar_first_topic';
    return $columns;
});

/** Sort the native topics column by the first alphabetical topic name.
 * Multi-topic items sort by their alphabetically first topic. Empty topics come last. */
add_filter('posts_clauses', static function($clauses, $query) {
    if (!is_admin() || !$query->is_main_query() || $query->get('post_type') !== 'mkb_glossar'
        || $query->get('orderby') !== 'mkb_glossar_first_topic') return $clauses;
    global $wpdb;
    $topic = $wpdb->prepare(
        "(SELECT MIN(t.name) FROM {$wpdb->term_relationships} AS tr JOIN {$wpdb->term_taxonomy} AS tt ON tt.term_taxonomy_id = tr.term_taxonomy_id JOIN {$wpdb->terms} AS t ON t.term_id = tt.term_id WHERE tr.object_id = {$wpdb->posts}.ID AND tt.taxonomy = %s)",
        'mkb_glossar_topic'
    );
    $order = strtoupper((string)$query->get('order')) === 'DESC' ? 'DESC' : 'ASC';
    $clauses['orderby'] = "CASE WHEN {$topic} IS NULL THEN 1 ELSE 0 END ASC, {$topic} {$order}, {$wpdb->posts}.post_title ASC";
    return $clauses;
}, 20, 2);