<?php
/**
 * Admin settings / dashboard for Aha Orbit Testimonials.
 *
 * Provides:
 *  – Top-level menu "Aha Orbit Testimonials" (the dashboard / settings page).
 *  – Submenu shortcut to the CPT list.
 *  – Tabbed settings UI (General, Shortcode, Uninstall).
 *
 * Add-ons can register additional tabs via the
 * `aha_orbit_testimonials_settings_tabs` filter.
 *
 * @package Aha_Orbit_Testimonials
 * @since   1.0.0
 */

if (!defined('WPINC')) {
	die;
}

/**
 * Settings page manager.
 */
class Aha_Orbit_Testimonials_Settings
{

	/**
	 * WP option name for the general settings tab.
	 */
	const OPTION_GENERAL = 'aha_orbit_testimonials_general';

	/**
	 * Instance.
	 *
	 * @var self|null
	 */
	private static $instance = null;

	/**
	 * Field renderers.
	 *
	 * @var Aha_Orbit_Testimonials_Settings_Fields
	 */
	private $fields;

	/**
	 * Get instance.
	 *
	 * @return self
	 */
	public static function get_instance()
	{
		if (null === self::$instance) {
			self::$instance = new self();
		}
		return self::$instance;
	}

	/**
	 * Constructor.
	 */
	private function __construct()
	{
		$this->fields = new Aha_Orbit_Testimonials_Settings_Fields(
			self::OPTION_GENERAL,
			array($this, 'get_settings')
		);

		add_action('admin_menu', array($this, 'register_admin_menus'));
		add_action('admin_init', array($this, 'register_settings'));
		add_action('admin_init', array($this, 'maybe_save_uninstall_preference'));
		// The Uninstall tab is always last. Add-ons can insert their own tabs
		// (e.g. a Extra tab) at priority < 100 via this same filter.
		add_filter('aha_orbit_testimonials_settings_tabs', array($this, 'append_uninstall_tab'), 100);
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Menu registration
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Register the full admin menu structure: parent, Settings submenu, and Testimonials submenu.
	 * All three are registered sequentially in the same hook to guarantee order and avoid
	 * edge cases with the auto-generated duplicate first submenu.
	 */
	public function register_admin_menus()
	{
		// 1. Parent menu.
		add_menu_page(
			__('Aha Orbit Testimonials', 'aha-orbit-testimonials'),
			__('Aha Orbit', 'aha-orbit-testimonials'),
			'manage_options',
			AHA_ORBIT_TESTIMONIALS_ADMIN_SLUG,
			array($this, 'render_page'),
			'dashicons-format-quote',
			57
		);

		// 2. Override the auto-generated first submenu (which duplicates the parent label) with "Settings".
		add_submenu_page(
			AHA_ORBIT_TESTIMONIALS_ADMIN_SLUG,
			__('Aha Orbit Testimonials – Settings', 'aha-orbit-testimonials'),
			__('Settings', 'aha-orbit-testimonials'),
			'manage_options',
			AHA_ORBIT_TESTIMONIALS_ADMIN_SLUG,
			array($this, 'render_page')
		);

		// 3. Link to the CPT post list.
		add_submenu_page(
			AHA_ORBIT_TESTIMONIALS_ADMIN_SLUG,
			__('Testimonials', 'aha-orbit-testimonials'),
			__('Testimonials', 'aha-orbit-testimonials'),
			'edit_posts',
			'edit.php?post_type=' . AHA_ORBIT_TESTIMONIALS_CPT
		);
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Settings API
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Register options and fields for the General tab.
	 */
	public function register_settings()
	{
		// ── General ──────────────────────────────────────────────────────────
		register_setting(
			'aha_orbit_testimonials_general_group',
			self::OPTION_GENERAL,
			array(
				'sanitize_callback' => array($this, 'sanitize_general'),
			)
		);

		add_settings_section(
			'aha_orbit_testimonials_status',
			__('Plugin Status', 'aha-orbit-testimonials'),
			array($this->fields, 'render_section_status'),
			'aha-orbit-testimonials-general'
		);

		add_settings_field(
			'aha_orbit_testimonials_enabled',
			__('Enable all orbits', 'aha-orbit-testimonials'),
			array($this->fields, 'render_field_enabled'),
			'aha-orbit-testimonials-general',
			'aha_orbit_testimonials_status'
		);
	}

	/**
	 * Sanitize general settings input.
	 *
	 * @param mixed $input Raw input.
	 * @return array<string, mixed>
	 */
	public function sanitize_general($input)
	{
		if (!is_array($input)) {
			return $this->get_defaults();
		}

		return array(
			'enabled' => !empty($input['enabled']) ? 1 : 0,
		);
	}

	/**
	 * Default general settings.
	 *
	 * @return array<string, mixed>
	 */
	public function get_defaults()
	{
		return array(
			'enabled' => 1,
		);
	}

	/**
	 * Retrieve current general settings (merged with defaults).
	 *
	 * @return array<string, mixed>
	 */
	public function get_settings()
	{
		return wp_parse_args(get_option(self::OPTION_GENERAL, array()), $this->get_defaults());
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Tabs filter
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Append the Uninstall tab (always last, priority 100).
	 *
	 * Add-ons should use the same filter at a lower priority (e.g. 50) to
	 * inject their own tabs before this one.
	 *
	 * Example:
	 *   add_filter( 'aha_orbit_testimonials_settings_tabs', function( $tabs ) {
	 *       $tabs['my_tab'] = __( 'My Tab', 'my-addon' );
	 *       return $tabs;
	 *   }, 50 );
	 *
	 * @param array<string, string> $tabs Tab slug => label.
	 * @return array<string, string>
	 */
	public function append_uninstall_tab($tabs)
	{
		if (!is_array($tabs)) {
			$tabs = array();
		}
		$tabs['uninstall'] = __('Uninstall', 'aha-orbit-testimonials');
		return $tabs;
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Uninstall preference
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Save the "remove data on uninstall" preference from the Uninstall tab form.
	 */
	public function maybe_save_uninstall_preference()
	{
		if (!isset($_POST['aha_orbit_uninstall_prefs'])) {
			return;
		}
		if (!current_user_can('manage_options')) {
			wp_die(esc_html__('Permission denied.', 'aha-orbit-testimonials'));
		}
		check_admin_referer('aha_orbit_uninstall_prefs', 'aha_orbit_uninstall_prefs_nonce');

		$erase = isset($_POST['aha_orbit_remove_data_on_uninstall']) ? '1' : '0';
		update_option(AHA_ORBIT_TESTIMONIALS_UNINSTALL_DELETE_DATA_OPTION, $erase, false);

		wp_safe_redirect(
			add_query_arg(
				array(
					'page' => AHA_ORBIT_TESTIMONIALS_ADMIN_SLUG,
					'tab' => 'uninstall',
					'aha_orbit_uninstall_saved' => '1',
				),
				admin_url('admin.php')
			)
		);
		exit;
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Page rendering
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Render the full settings / dashboard page.
	 */
	public function render_page()
	{
		if (!current_user_can('manage_options')) {
			return;
		}

		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if (isset($_GET['aha_orbit_uninstall_saved']) && '1' === $_GET['aha_orbit_uninstall_saved']) {
			echo '<div class="notice notice-success is-dismissible"><p>' . esc_html__('Uninstall preferences saved successfully.', 'aha-orbit-testimonials') . '</p></div>';
		}

		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$active_tab = isset($_GET['tab']) ? sanitize_key(wp_unslash($_GET['tab'])) : 'general';

		$tabs = array(
			'general'   => __('General', 'aha-orbit-testimonials'),
			'shortcode' => __('Shortcode', 'aha-orbit-testimonials'),
		);

		/**
		 * Filter the dashboard tabs.
		 *
		 * @param array<string, string> $tabs Tab slug => label.
		 */
		$tabs = apply_filters('aha_orbit_testimonials_settings_tabs', $tabs);

		if (!array_key_exists($active_tab, $tabs)) {
			$active_tab = 'general';
		}

		?>
		<div class="wrap aha-orbit-testimonials-settings-wrap">

			<?php include AHA_ORBIT_TESTIMONIALS_PATH . 'templates/admin/page-header.php'; ?>

			<?php if ('uninstall' === $active_tab): ?>

				<?php $this->render_uninstall_tab(); ?>

			<?php elseif ('shortcode' === $active_tab): ?>

				<div class="aha-orbit-testimonials-tab-content">
					<?php $this->render_shortcode_tab(); ?>
				</div>

			<?php elseif ('general' === $active_tab): ?>

				<form action="options.php" method="post">
					<?php settings_fields('aha_orbit_testimonials_general_group'); ?>
					<div class="aha-orbit-testimonials-tab-content">
						<?php do_settings_sections('aha-orbit-testimonials-general'); ?>
					</div>
					<?php submit_button(__('Save settings', 'aha-orbit-testimonials')); ?>
				</form>

				<?php $this->render_coming_soon_section(); ?>

			<?php else: ?>

				<?php
				/**
				 * Action: aha_orbit_testimonials_settings_tab_{$active_tab}
				 *
				 * Fires when an add-on tab is active. Add-ons hook here to render
				 * their own tab content (e.g. a License tab).
				 *
				 * @since 1.1.1
				 */
				do_action( 'aha_orbit_testimonials_settings_tab_' . $active_tab );
				?>

			<?php endif; ?>

			<?php include AHA_ORBIT_TESTIMONIALS_PATH . 'templates/admin/page-sidebar.php'; ?>

		</div>
		<?php
	}

	/* ─────────────────────────────────────────────────────────────────────────
	   Tab renderers
	   ───────────────────────────────────────────────────────────────────────── */

	/**
	 * Render the Shortcode reference tab.
	 *
	 * @return void
	 */
	private function render_shortcode_tab()
	{
		$orbits_url = esc_url(add_query_arg(array('post_type' => AHA_ORBIT_TESTIMONIALS_CPT), admin_url('edit.php')));
		?>
		<div class="aha-orbit-testimonials-shortcode-tab">
			<h2 class="title aha-orbit-testimonials-shortcode-tab-title">
				<?php esc_html_e('Orbit Testimonials shortcode', 'aha-orbit-testimonials'); ?></h2>
			<p class="description aha-orbit-testimonials-shortcode-tab-lead">
				<?php esc_html_e('Embed any Orbit on any page, post, or widget area using just its ID. All behaviour and design settings are configured directly on each Orbit.', 'aha-orbit-testimonials'); ?>
			</p>

			<div class="aha-orbit-testimonials-shortcode-hero">
				<p class="aha-orbit-testimonials-shortcode-hero-label">
					<?php esc_html_e('Paste this shortcode in your content or widget:', 'aha-orbit-testimonials'); ?></p>
				<input type="text" class="aha-orbit-testimonials-shortcode-input" readonly value='[aha_orbit id="1"]'
					aria-label="<?php esc_attr_e('Shortcode', 'aha-orbit-testimonials'); ?>" />

				<div class="aha-orbit-testimonials-shortcode-callout" role="note">
					<p class="aha-orbit-testimonials-shortcode-callout-title">
						<?php esc_html_e('Replace 1 with the ID of your Orbit.', 'aha-orbit-testimonials'); ?>
					</p>
					<p>
						<?php
						echo wp_kses(
							sprintf(
								/* translators: %s: link to Orbit list */
								__('Find the ID in the URL when editing an Orbit (post=<strong>123</strong>) or in the <a href="%s">Orbit Testimonials list</a>.', 'aha-orbit-testimonials'),
								$orbits_url
							),
							array(
								'a'      => array('href' => array()),
								'strong' => array(),
							)
						);
						?>
					</p>
				</div>
			</div>

			<h3 class="aha-orbit-testimonials-shortcode-section-title">
				<?php esc_html_e('Examples', 'aha-orbit-testimonials'); ?></h3>
			<table class="widefat striped aha-orbit-testimonials-shortcode-table">
				<thead>
					<tr>
						<th class="column-use-case"><?php esc_html_e('Use case', 'aha-orbit-testimonials'); ?></th>
						<th><?php esc_html_e('Code', 'aha-orbit-testimonials'); ?></th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td><?php esc_html_e('Embed the Orbit with ID 1', 'aha-orbit-testimonials'); ?></td>
						<td><code>[aha_orbit id="1"]</code></td>
					</tr>
					<tr>
						<td><?php esc_html_e('Embed the Orbit with ID 5', 'aha-orbit-testimonials'); ?></td>
						<td><code>[aha_orbit id="5"]</code></td>
					</tr>
					<tr>
						<td><?php esc_html_e('Use in a widget or theme template', 'aha-orbit-testimonials'); ?></td>
						<td><code><?php echo esc_html("<?php echo do_shortcode('[aha_orbit id=\"1\"]'); ?>"); ?></code></td>
					</tr>
				</tbody>
			</table>

			<h3 class="aha-orbit-testimonials-shortcode-section-title">
				<?php esc_html_e('In page builders & themes', 'aha-orbit-testimonials'); ?></h3>
			<ul class="aha-orbit-testimonials-shortcode-builder-list">
				<li><?php esc_html_e('Elementor: drag a Shortcode widget into any section and paste the shortcode.', 'aha-orbit-testimonials'); ?>
				</li>
				<li><?php esc_html_e('Block Editor: add a Shortcode block anywhere in a template, page, or pattern.', 'aha-orbit-testimonials'); ?>
				</li>
				<li><?php esc_html_e('Astra / Kadence / similar: use an HTML or shortcode element and paste the code there.', 'aha-orbit-testimonials'); ?>
				</li>
				<li><?php esc_html_e('Classic widgets: place a Text or Custom HTML widget and paste the shortcode.', 'aha-orbit-testimonials'); ?>
				</li>
			</ul>

			<p class="description aha-orbit-testimonials-shortcode-after-table">
				<?php
				echo wp_kses(
					sprintf(
						/* translators: %s: link to Orbit list */
						__('All behaviour and design settings (colours, autoplay, arrows, etc.) are configured per-Orbit in the <a href="%s">Orbit editor</a>.', 'aha-orbit-testimonials'),
						$orbits_url
					),
					array('a' => array('href' => array()))
				);
				?>
			</p>
		</div>
		<?php
	}

	/**
	 * Render the coming soon section below the General settings form.
	 *
	 * @return void
	 */
	private function render_coming_soon_section()
	{
		?>
		<div class="aha-orbit-testimonials-coming-soon-section">
			<h3><?php esc_html_e('Coming soon — More ways to use Aha Orbit', 'aha-orbit-testimonials'); ?></h3>
			<p class="description">
				<?php esc_html_e('We are working on exciting new features: a native Elementor widget, a Gutenberg block, and more. Stay tuned for updates!', 'aha-orbit-testimonials'); ?>
			</p>
		</div>
		<?php
	}

	/**
	 * Render the Uninstall tab.
	 */
	private function render_uninstall_tab()
	{
		$remove = get_option(AHA_ORBIT_TESTIMONIALS_UNINSTALL_DELETE_DATA_OPTION, '0');
		?>
		<div class="aha-orbit-testimonials-uninstall-tab">
			<div class="aha-orbit-testimonials-uninstall-danger">
				<strong><?php esc_html_e('Warning', 'aha-orbit-testimonials'); ?></strong>
				<p><?php esc_html_e('When "Remove all data" is checked, deleting (uninstalling) the plugin will permanently erase all Orbit Testimonials posts and settings. This cannot be undone.', 'aha-orbit-testimonials'); ?>
				</p>
			</div>

			<form method="post" action="">
				<?php wp_nonce_field('aha_orbit_uninstall_prefs', 'aha_orbit_uninstall_prefs_nonce'); ?>
				<input type="hidden" name="aha_orbit_uninstall_prefs" value="1" />

				<table class="form-table">
					<tr>
						<th scope="row"><?php esc_html_e('Remove all data on uninstall', 'aha-orbit-testimonials'); ?></th>
						<td>
							<label for="aha_orbit_remove_data_on_uninstall">
								<input type="checkbox" id="aha_orbit_remove_data_on_uninstall"
									name="aha_orbit_remove_data_on_uninstall" value="1" <?php checked($remove, '1'); ?> />
								<?php esc_html_e('Delete all plugin data when the plugin is deleted', 'aha-orbit-testimonials'); ?>
							</label>
							<p class="description">
								<?php esc_html_e('Includes: all Orbit Testimonials posts, post meta, and plugin options.', 'aha-orbit-testimonials'); ?>
							</p>
						</td>
					</tr>
				</table>

				<?php submit_button(__('Save preference', 'aha-orbit-testimonials')); ?>
			</form>
		</div>
		<?php
	}
}