<?php
/** Local first-run guidance and reversible, per-user workspace focus. */
if ( ! defined( 'ABSPATH' ) ) { exit; }

final class KCONV_Onboarding {
    private static $activating = false;

    public static function boot() {
        add_action( 'activated_plugin', array( __CLASS__, 'activated' ), 10, 2 );
        add_action( 'kconv_admin_menu', array( __CLASS__, 'menu' ) );
        add_filter( 'admin_body_class', array( __CLASS__, 'body_class' ) );
        add_action( 'admin_enqueue_scripts', array( __CLASS__, 'assets' ) );
        add_action( 'admin_notices', array( __CLASS__, 'toolbar' ), 1 );
        add_action( 'admin_post_kconv_focus', array( __CLASS__, 'save_focus' ) );
        add_action( 'wp_ajax_kconv_focus', array( __CLASS__, 'save_focus' ) );
    }

    /** The success hook below runs only after WordPress has completed activation. */
    public static function activate( $network_wide = false ) {
        self::$activating = ! $network_wide;
    }

    public static function activated( $plugin, $network_wide ) {
        global $pagenow;
        if ( ! self::$activating || $network_wide || plugin_basename( KCONV_FILE ) !== $plugin
            || ! is_admin() || 'plugins.php' !== $pagenow || is_network_admin() || is_multisite()
            || wp_doing_ajax() || wp_doing_cron() || ( defined( 'REST_REQUEST' ) && REST_REQUEST )
            || ( defined( 'WP_CLI' ) && WP_CLI ) || ! current_user_can( 'activate_plugins' )
            || ! current_user_can( 'manage_options' ) || get_option( 'kconv_schema_problem' ) ) { return; }
        // Core has authenticated this successful activation. Only its ordinary
        // manual request may replace the immediately following success redirect.
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Core owns activation authorization; this sanitized flag only excludes bulk and background requests.
        $action = isset( $_REQUEST['action'] ) && is_string( $_REQUEST['action'] ) ? sanitize_key( wp_unslash( $_REQUEST['action'] ) ) : '';
        if ( 'activate' === $action ) { add_filter( 'wp_redirect', array( __CLASS__, 'activation_destination' ), 10, 2 ); }
    }

    public static function key( $name ) { return 'kconv_' . $name . '_' . get_current_blog_id(); }

    /** A failed activation, update or later admin visit cannot inherit this redirect. */
    public static function activation_destination( $location, $status ) {
        if ( ! is_string( $location ) || 302 !== $status || 0 !== strpos( $location, admin_url( 'plugins.php' ) . '?' ) ) { return $location; }
        $query = array();
        wp_parse_str( (string) wp_parse_url( $location, PHP_URL_QUERY ), $query );
        if ( 'true' !== ( $query['activate'] ?? null ) || isset( $query['error'] ) ) { return $location; }
        remove_filter( 'wp_redirect', array( __CLASS__, 'activation_destination' ), 10 );
        $page = get_user_meta( get_current_user_id(), self::key( 'onboarding_shown' ), true ) ? 'killerconversions' : 'kconv-start';
        return admin_url( 'admin.php?page=' . $page );
    }

    public static function menu() {
        add_submenu_page( 'killerconversions', __( 'Start here', 'killerconversions' ), __( 'Start here', 'killerconversions' ), 'manage_options', 'kconv-start', array( __CLASS__, 'screen' ) );
    }

    public static function focused() {
        return '0' !== get_user_meta( get_current_user_id(), self::key( 'focus' ), true );
    }

    private static function allowed() {
        return current_user_can( 'manage_options' ) || ( class_exists( 'KCONV_Core' ) && KCONV_Core::can( 'kconv_view_entries' ) );
    }

    public static function body_class( $classes ) {
        if ( KCONV_Admin_Scope::plugin() && self::allowed() ) { $classes .= ' kconv-owned-screen' . ( self::focused() ? ' kconv-focus' : '' ); }
        return $classes;
    }

    public static function assets() {
        if ( ! KCONV_Admin_Scope::plugin() || ! self::allowed() ) { return; }
        wp_enqueue_style( 'kconv-onboarding', KCONV_URL . 'assets/onboarding.css', array(), KCONV_VERSION );
        wp_enqueue_script( 'kconv-onboarding', KCONV_URL . 'assets/onboarding.js', array(), KCONV_VERSION, true );
        wp_localize_script( 'kconv-onboarding', 'KCONV_Onboarding', array(
            'ajax' => admin_url( 'admin-ajax.php' ),
            'enter' => __( 'Enter focus mode', 'killerconversions' ),
            'exit' => __( 'Exit focus mode', 'killerconversions' ),
            'saved' => __( 'Workspace preference saved for you on this site.', 'killerconversions' ),
            'error' => __( 'Your focus preference could not be saved. Your edits are still here; try again.', 'killerconversions' ),
        ) );
    }

    /** Keep WordPress notices intact; this bar changes chrome, never the form DOM. */
    public static function toolbar( $embedded = false ) {
        if ( ! $embedded && class_exists( 'KCONV_Workspace_Navigation' ) && KCONV_Workspace_Navigation::will_render() ) { return; }
        if ( ! KCONV_Admin_Scope::plugin() || ! self::allowed() ) { return; }
        echo '<div class="kconv-focus-bar"><a href="' . esc_url( admin_url() ) . '" class="kconv-back-wordpress"><span aria-hidden="true">' . esc_html( is_rtl() ? '→' : '←' ) . '</span> ' . esc_html__( 'Back to WordPress', 'killerconversions' ) . '</a><form action="' . esc_url( admin_url( 'admin-post.php' ) ) . '" method="post" data-kconv-focus-form><input type="hidden" name="action" value="kconv_focus"><input type="hidden" name="focus" value="' . esc_attr( self::focused() ? '0' : '1' ) . '">';
        wp_nonce_field( 'kconv_focus' );
        echo '<button type="submit" class="button" aria-pressed="' . esc_attr( self::focused() ? 'true' : 'false' ) . '">' . esc_html( self::focused() ? __( 'Exit focus mode', 'killerconversions' ) : __( 'Enter focus mode', 'killerconversions' ) ) . '</button></form><span class="screen-reader-text" role="status" data-kconv-focus-status></span></div>';
    }

    public static function save_focus() {
        if ( ! self::allowed() ) { wp_die( esc_html__( 'You cannot change this workspace preference.', 'killerconversions' ), '', array( 'response' => 403 ) ); }
        check_admin_referer( 'kconv_focus' );
        $focus = isset( $_POST['focus'] ) && is_string( $_POST['focus'] ) ? sanitize_text_field( wp_unslash( $_POST['focus'] ) ) : '';
        if ( ! in_array( $focus, array( '0', '1' ), true ) ) { wp_die( esc_html__( 'Choose a valid focus preference.', 'killerconversions' ), '', array( 'response' => 400 ) ); }
        update_user_meta( get_current_user_id(), self::key( 'focus' ), $focus );
        if ( $focus !== get_user_meta( get_current_user_id(), self::key( 'focus' ), true ) ) {
            if ( wp_doing_ajax() ) { wp_send_json_error( array( 'message' => __( 'The preference could not be saved. Try again.', 'killerconversions' ) ), 503 ); }
            wp_die( esc_html__( 'The preference could not be saved. Try again.', 'killerconversions' ), '', array( 'response' => 503, 'back_link' => true ) );
        }
        if ( wp_doing_ajax() ) { wp_send_json_success( array( 'focused' => '1' === $focus ) ); }
        wp_safe_redirect( wp_get_referer() ? wp_get_referer() : admin_url( 'admin.php?page=kconv-start' ) );
        exit;
    }

    public static function screen() {
        if ( ! current_user_can( 'manage_options' ) ) { return; }
        if ( ! get_user_meta( get_current_user_id(), self::key( 'onboarding_shown' ), true ) ) { update_user_meta( get_current_user_id(), self::key( 'onboarding_shown' ), time() ); }
        $forms = get_posts( array( 'post_type' => 'kconv_form', 'post_status' => array( 'draft', 'publish' ), 'post_parent' => 0, 'posts_per_page' => 1, 'fields' => 'ids' ) );
        echo '<div class="wrap kconv-admin kconv-app kconv-start-app">';
        KCONV_Admin::navigation( 'start' );
        echo '<header class="kconv-start-heading"><span class="kconv-eyebrow">' . esc_html__( 'START HERE', 'killerconversions' ) . '</span><h1>' . esc_html( $forms ? __( 'Start with a useful form.', 'killerconversions' ) : __( 'Create your first form.', 'killerconversions' ) ) . '</h1><p>' . esc_html__( 'Choose a starting point, make it yours, then try it before publishing. All three starters are included in Free.', 'killerconversions' ) . '</p></header><div class="kconv-start-grid">';
        $starters = array(
            array( 'contact', __( 'Collect enquiries', 'killerconversions' ), __( 'Give visitors a clear way to ask a question or request a callback.', 'killerconversions' ), __( 'Start an enquiry form', 'killerconversions' ) ),
            array( 'quote', __( 'Request a quote', 'killerconversions' ), __( 'Collect the project details you need to prepare a personal quote.', 'killerconversions' ), __( 'Start a quote enquiry', 'killerconversions' ) ),
            array( 'agency_brief', __( 'Collect a project brief', 'killerconversions' ), __( 'Collect the goals, service and timing needed for a useful reply.', 'killerconversions' ), __( 'Start a project brief form', 'killerconversions' ) ),
        );
        foreach ( $starters as $index => $starter ) {
            echo '<article class="kconv-start-card"><span class="kconv-start-number" aria-hidden="true">0' . esc_html( $index + 1 ) . '</span><h2>' . esc_html( $starter[1] ) . '</h2><p>' . esc_html( $starter[2] ) . '</p><a class="button button-primary" href="' . esc_url( admin_url( 'admin.php?page=killerconversions&edit=new&template=' . $starter[0] ) ) . '">' . esc_html( $starter[3] ) . '</a></article>';
        }
        echo '</div><section class="kconv-start-next"><h2>' . esc_html__( 'From first draft to your website', 'killerconversions' ) . '</h2><ol><li><strong>' . esc_html__( 'Make it yours', 'killerconversions' ) . '</strong><span>' . esc_html__( 'Edit the questions and choose where responses should go.', 'killerconversions' ) . '</span></li><li><strong>' . esc_html__( 'Try your form', 'killerconversions' ) . '</strong><span>' . esc_html__( 'Check the visitor experience without sending a submission.', 'killerconversions' ) . '</span></li><li><strong>' . esc_html__( 'Publish and add to a page', 'killerconversions' ) . '</strong><span>' . esc_html__( 'Use the form block or shortcode, then send a real test.', 'killerconversions' ) . '</span></li></ol></section>';
        echo '<div class="kconv-start-links"><a href="' . esc_url( admin_url( 'admin.php?page=killerconversions' ) ) . '">' . esc_html__( 'Go to my forms', 'killerconversions' ) . '</a><a href="' . esc_url( admin_url( 'admin.php?page=kconv-privacy-emails' ) ) . '">' . esc_html__( 'Privacy & emails', 'killerconversions' ) . '</a><a href="' . esc_url( 'https://killerconversions.com/docs/' ) . '" target="_blank" rel="noopener noreferrer">' . esc_html__( 'Read the guide', 'killerconversions' ) . '</a></div><p class="description">' . esc_html__( 'Creating and using forms does not require sharing your domain or signing up for emails.', 'killerconversions' ) . '</p>';
        KCONV_Pro_Discovery::preview_navigation( 'start' );
        echo '</div>';
    }
}