<?php
defined('ABSPATH') || exit;

/** One focused welcome after the first successful individual UI activation. */
final class OWWC_Activation {
    const SEEN = 'owwc_activation_seen_v1';
    private static $armed = false;
    private static $persisted = false;

    public static function init(): void {
        register_activation_hook(OWWC_FILE, [__CLASS__, 'activated']);
        add_action('activated_plugin', [__CLASS__, 'completed'], 10, 2);
        add_action('plugins_loaded', [__CLASS__, 'remember_existing'], 30);
        add_filter('plugin_action_links_' . plugin_basename(OWWC_FILE), [__CLASS__, 'links']);
    }

    /** Existing active installations must not gain a welcome redirect on reactivation. */
    public static function remember_existing(): void {
        if (get_option(self::SEEN, false) !== false) { return; }
        if (in_array(plugin_basename(OWWC_FILE), (array) get_option('active_plugins', []), true)) {
            add_option(self::SEEN, '1', '', false);
        }
    }

    /** Core calls this only after it has saved the successful activation. */
    public static function completed(string $plugin, bool $network_wide): void {
        if ($plugin !== plugin_basename(OWWC_FILE)) { return; }
        $saved = $network_wide ? array_key_exists($plugin, (array) get_site_option('active_sitewide_plugins', [])) :
            in_array($plugin, (array) get_option('active_plugins', []), true);
        if (!$saved) { return; }
        self::$persisted = !$network_wide;
        // Bulk, network and programmatic activations are remembered without navigation.
        add_option(self::SEEN, '1', '', false);
    }

    public static function activated(bool $network_wide): void {
        global $pagenow;
        if (get_option(self::SEEN, false) !== false || $network_wide || is_multisite() || is_network_admin()
            || !is_admin() || $pagenow !== 'plugins.php' || wp_doing_ajax() || wp_doing_cron()
            || (defined('WP_CLI') && WP_CLI) || (defined('REST_REQUEST') && REST_REQUEST)
            || !current_user_can('activate_plugins') || !current_user_can('manage_woocommerce')
            || !class_exists('WooCommerce') || !defined('WC_VERSION') || version_compare(WC_VERSION, '9.9', '<')) { return; }
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Core has authorized activation; these scalars only narrow a fixed local post-persistence success redirect.
        $action = isset($_REQUEST['action']) && is_string($_REQUEST['action']) ? sanitize_key(wp_unslash($_REQUEST['action'])) : '';
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Exact plugin identity narrows core's authorized activation; it never authorizes a request or controls the destination.
        $plugin = isset($_REQUEST['plugin']) && is_string($_REQUEST['plugin']) ? sanitize_text_field(wp_unslash($_REQUEST['plugin'])) : '';
        if ($action !== 'activate' || $plugin !== plugin_basename(OWWC_FILE)) { return; }
        self::$armed = true;
        add_filter('wp_redirect', [__CLASS__, 'destination'], 10, 2);
    }

    /** Do not interrupt core's error redirect or redirect before activation persistence. */
    public static function destination($location, $status) {
        if (!self::$armed || !self::$persisted || !is_string($location) || $status !== 302
            || strpos($location, admin_url('plugins.php') . '?') !== 0
            || !in_array(plugin_basename(OWWC_FILE), (array) get_option('active_plugins', []), true)) { return $location; }
        $query = [];
        wp_parse_str((string) wp_parse_url($location, PHP_URL_QUERY), $query);
        if (($query['activate'] ?? null) !== 'true' || isset($query['error'])) { return $location; }
        self::$armed = false;
        remove_filter('wp_redirect', [__CLASS__, 'destination'], 10);
        return admin_url('admin.php?page=orderworth&view=settings');
    }

    public static function links(array $links): array {
        if (current_user_can('manage_woocommerce')) {
            array_unshift($links, '<a href="' . esc_url(admin_url('admin.php?page=orderworth&view=settings')) . '">' .
                esc_html__('Settings', 'orderworth') . '</a>');
        }
        return $links;
    }
}