<?php

namespace AIBP;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Renders the plugin admin pages and handles form actions.
 *
 * @package AI_Blog_Poster
 */
class Admin {

	const PAGE_SLUG               = 'ai-blog-poster';
	const SETTINGS_PAGE_SLUG      = 'ai-blog-poster-settings';
	const IMPORTED_POSTS_SLUG     = 'ai-blog-poster-imported-posts';
	const DEBUG_PAGE_SLUG         = 'ai-blog-poster-debug-history';
	const HELP_PAGE_SLUG          = 'ai-blog-poster-help';
	const MANUAL_SYNC_ACTION      = 'aibp_manual_sync';
	const REGENERATE_TOKEN_ACTION = 'aibp_regenerate_cron_token';
	const CLEAR_HISTORY_ACTION    = 'aibp_clear_debug_history';

	/**
	 * @var Settings
	 */
	private $settings;

	/**
	 * @var Sync_Service
	 */
	private $sync_service;

	/**
	 * @var Scheduler
	 */
	private $scheduler;

	/**
	 * @var Debug_History
	 */
	private $debug_history;

	/**
	 * @param Settings      $settings      Plugin settings service.
	 * @param Sync_Service  $sync_service  Shared sync service.
	 * @param Scheduler     $scheduler     Scheduler service.
	 * @param Debug_History $debug_history Debug history service.
	 */
	public function __construct( Settings $settings, Sync_Service $sync_service, Scheduler $scheduler, Debug_History $debug_history ) {
		$this->settings      = $settings;
		$this->sync_service  = $sync_service;
		$this->scheduler     = $scheduler;
		$this->debug_history = $debug_history;

		add_action( 'admin_menu', array( $this, 'add_menu' ) );
		add_action( 'admin_init', array( $this, 'register_settings' ) );
		add_action( 'admin_notices', array( $this, 'render_admin_notice' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
		add_action( 'admin_post_' . self::MANUAL_SYNC_ACTION, array( $this, 'handle_manual_sync' ) );
		add_action( 'admin_post_' . self::REGENERATE_TOKEN_ACTION, array( $this, 'handle_regenerate_token' ) );
		add_action( 'admin_post_' . self::CLEAR_HISTORY_ACTION, array( $this, 'handle_clear_debug_history' ) );
		add_action( 'update_option_' . Settings::OPTION_NAME, array( $this, 'after_settings_saved' ), 10, 2 );
	}

	/**
	 * Enqueues plugin CSS and JS on plugin admin pages only.
	 *
	 * @param string $hook_suffix Current admin page hook suffix.
	 */
	public function enqueue_assets( $hook_suffix ) {
		$plugin_pages = array(
			'toplevel_page_' . self::PAGE_SLUG,
			'ai-blog-poster_page_' . self::SETTINGS_PAGE_SLUG,
			'ai-blog-poster_page_' . self::IMPORTED_POSTS_SLUG,
			'ai-blog-poster_page_' . self::DEBUG_PAGE_SLUG,
			'ai-blog-poster_page_' . self::HELP_PAGE_SLUG,
		);

		if ( ! in_array( $hook_suffix, $plugin_pages, true ) ) {
			return;
		}

		wp_enqueue_style(
			'aibp-admin',
			AIBP_PLUGIN_URL . 'assets/css/admin.css',
			array(),
			AIBP_VERSION
		);

		// Only load JS on the Settings page where the cron toggle is needed.
		if ( 'ai-blog-poster_page_' . self::SETTINGS_PAGE_SLUG === $hook_suffix ) {
			wp_enqueue_script(
				'aibp-admin',
				AIBP_PLUGIN_URL . 'assets/js/admin.js',
				array(),
				AIBP_VERSION,
				true
			);

			wp_localize_script(
				'aibp-admin',
				'aibpAdmin',
				array(
					'optionName' => Settings::OPTION_NAME,
				)
			);
		}
	}

	/**
	 * Registers the plugin admin menu and subpages.
	 */
	public function add_menu() {
		add_menu_page(
			__( 'AI Blog Poster', 'ai-blog-poster' ),
			__( 'AI Blog Poster', 'ai-blog-poster' ),
			'manage_options',
			self::PAGE_SLUG,
			array( $this, 'render_dashboard_page' ),
			'dashicons-edit-page',
			80
		);

		add_submenu_page(
			self::PAGE_SLUG,
			__( 'Dashboard', 'ai-blog-poster' ),
			__( 'Dashboard', 'ai-blog-poster' ),
			'manage_options',
			self::PAGE_SLUG,
			array( $this, 'render_dashboard_page' )
		);

		add_submenu_page(
			self::PAGE_SLUG,
			__( 'Settings', 'ai-blog-poster' ),
			__( 'Settings', 'ai-blog-poster' ),
			'manage_options',
			self::SETTINGS_PAGE_SLUG,
			array( $this, 'render_page' )
		);

		add_submenu_page(
			self::PAGE_SLUG,
			__( 'Imported Posts', 'ai-blog-poster' ),
			__( 'Imported Posts', 'ai-blog-poster' ),
			'manage_options',
			self::IMPORTED_POSTS_SLUG,
			array( $this, 'render_imported_posts_page' )
		);

		add_submenu_page(
			self::PAGE_SLUG,
			__( 'Debug History', 'ai-blog-poster' ),
			__( 'Debug History', 'ai-blog-poster' ),
			'manage_options',
			self::DEBUG_PAGE_SLUG,
			array( $this, 'render_debug_history_page' )
		);

		add_submenu_page(
			self::PAGE_SLUG,
			__( 'Help', 'ai-blog-poster' ),
			__( 'Help', 'ai-blog-poster' ),
			'manage_options',
			self::HELP_PAGE_SLUG,
			array( $this, 'render_help_page' )
		);
	}

	/**
	 * Registers plugin settings with the WordPress Settings API.
	 */
	public function register_settings() {
		$this->settings->register();
	}

	/**
	 * Renders the plugin dashboard page.
	 */
	public function render_dashboard_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$settings        = $this->settings->get_all();
		$manual_sync_url = wp_nonce_url(
			admin_url( 'admin-post.php?action=' . self::MANUAL_SYNC_ACTION ),
			self::MANUAL_SYNC_ACTION
		);
		$last_sync       = ! empty( $settings['last_sync'] )
			? $this->format_timestamp( (int) $settings['last_sync'] )
			: __( 'Never', 'ai-blog-poster' );
		$last_run        = ! empty( $settings['last_run'] )
			? $this->format_timestamp( (int) $settings['last_run'] )
			: __( 'Never', 'ai-blog-poster' );
		$sync_mode       = 'manual_cron' === $settings['sync_mode']
			? __( 'Manual Server Cron', 'ai-blog-poster' )
			: __( 'WordPress Cron', 'ai-blog-poster' );
		$imported_count  = $this->get_imported_post_count();
		$debug_entries   = $this->debug_history->get_entries();
		$latest_entry    = ! empty( $debug_entries[0] ) ? $debug_entries[0] : array();
		$imported_url    = admin_url( 'admin.php?page=' . self::IMPORTED_POSTS_SLUG );
		$help_url        = admin_url( 'admin.php?page=' . self::HELP_PAGE_SLUG );
		?>
		<div class="wrap">
			<h1><?php esc_html_e( 'AI Blog Poster Dashboard', 'ai-blog-poster' ); ?></h1>
			<p><?php esc_html_e( 'Use this dashboard to check sync status, run a manual sync, and open the plugin settings or debug history.', 'ai-blog-poster' ); ?></p>

			<div class="aibp-dashboard-cards">
				<div class="postbox">
					<h2><?php esc_html_e( 'Last Run', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php echo esc_html( $last_run ); ?></strong></p>
				</div>

				<div class="postbox">
					<h2><?php esc_html_e( 'Last Imported', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php echo esc_html( $last_sync ); ?></strong></p>
				</div>

				<div class="postbox">
					<h2><?php esc_html_e( 'Sync Mode', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php echo esc_html( $sync_mode ); ?></strong></p>
				</div>

				<a class="postbox" href="<?php echo esc_url( $imported_url ); ?>">
					<h2><?php esc_html_e( 'Imported Posts', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php echo esc_html( (string) $imported_count ); ?></strong></p>
					<p class="description"><?php esc_html_e( 'Click to view imported post list.', 'ai-blog-poster' ); ?></p>
				</a>

				<div class="postbox">
					<h2><?php esc_html_e( 'Latest Debug Status', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php echo esc_html( ! empty( $latest_entry['status'] ) ? ucfirst( $latest_entry['status'] ) : __( 'No history yet', 'ai-blog-poster' ) ); ?></strong></p>
				</div>

				<a class="postbox" href="<?php echo esc_url( $help_url ); ?>">
					<h2><?php esc_html_e( 'Help', 'ai-blog-poster' ); ?></h2>
					<p><strong><?php esc_html_e( 'Setup Process', 'ai-blog-poster' ); ?></strong></p>
					<p class="description"><?php esc_html_e( 'Click to view setup and sync instructions.', 'ai-blog-poster' ); ?></p>
				</a>
			</div>

			<p>
				<a class="button button-primary" href="<?php echo esc_url( $manual_sync_url ); ?>"><?php esc_html_e( 'Run Manual Sync', 'ai-blog-poster' ); ?></a>
				<a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::SETTINGS_PAGE_SLUG ) ); ?>"><?php esc_html_e( 'Open Settings', 'ai-blog-poster' ); ?></a>
				<a class="button" href="<?php echo esc_url( $imported_url ); ?>"><?php esc_html_e( 'View Imported Posts', 'ai-blog-poster' ); ?></a>
				<a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::DEBUG_PAGE_SLUG ) ); ?>"><?php esc_html_e( 'View Debug History', 'ai-blog-poster' ); ?></a>
				<a class="button" href="<?php echo esc_url( $help_url ); ?>"><?php esc_html_e( 'Help', 'ai-blog-poster' ); ?></a>
			</p>
		</div>
		<?php
	}

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

		$settings             = $this->settings->get_all();
		$manual_sync_url      = wp_nonce_url(
			admin_url( 'admin-post.php?action=' . self::MANUAL_SYNC_ACTION ),
			self::MANUAL_SYNC_ACTION
		);
		$regenerate_token_url = wp_nonce_url(
			admin_url( 'admin-post.php?action=' . self::REGENERATE_TOKEN_ACTION ),
			self::REGENERATE_TOKEN_ACTION
		);
		$last_sync            = ! empty( $settings['last_sync'] )
			? $this->format_timestamp( (int) $settings['last_sync'] )
			: __( 'Never', 'ai-blog-poster' );
		$last_run             = ! empty( $settings['last_run'] )
			? $this->format_timestamp( (int) $settings['last_run'] )
			: __( 'Never', 'ai-blog-poster' );
		$manual_cron_url      = $this->scheduler->get_manual_cron_url();
		$sync_mode            = isset( $settings['sync_mode'] ) ? $settings['sync_mode'] : 'wp_cron';
		$example_cron_cmd     = 'curl -s "' . $manual_cron_url . '"';
		$hourly_cron_cmd      = '0 * * * * curl -s "' . $manual_cron_url . '" >/dev/null 2>&1';
		$is_manual_cron       = 'manual_cron' === $sync_mode;
		$masked_api_key       = $this->settings->mask_api_key( $settings['api_key'] );
		$api_key_set          = ! empty( $settings['api_key'] );
		?>
		<div class="wrap">
			<h1><?php esc_html_e( 'AI Blog Poster Settings', 'ai-blog-poster' ); ?></h1>

			<form method="post" action="options.php">
				<?php settings_fields( Settings::OPTION_GROUP ); ?>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row">
							<label for="aibp_api_key"><?php esc_html_e( 'API Key', 'ai-blog-poster' ); ?></label>
						</th>
						<td>
							<input
								type="text"
								class="regular-text"
								id="aibp_api_key"
								name="<?php echo esc_attr( Settings::OPTION_NAME ); ?>[api_key]"
								value="<?php echo esc_attr( $masked_api_key ); ?>"
								autocomplete="new-password"
								placeholder="<?php echo esc_attr( $api_key_set ? __( 'API key saved — enter a new key to replace', 'ai-blog-poster' ) : __( 'Enter API key', 'ai-blog-poster' ) ); ?>"
							/>
							<p class="description"><?php esc_html_e( 'For security, only the first 5 and last 5 characters are shown. Replace this value only when changing the API key.', 'ai-blog-poster' ); ?></p>
							<p class="<?php echo $api_key_set ? 'aibp-status-ok' : 'aibp-status-error'; ?>">
								<?php echo $api_key_set ? esc_html__( 'Status: API key is configured.', 'ai-blog-poster' ) : esc_html__( 'Status: API key is not configured.', 'ai-blog-poster' ); ?>
							</p>
						</td>
					</tr>

					<tr>
						<th scope="row"><?php esc_html_e( 'Sync Mode', 'ai-blog-poster' ); ?></th>
						<td>
							<fieldset>
								<label>
									<input type="radio" name="<?php echo esc_attr( Settings::OPTION_NAME ); ?>[sync_mode]" value="wp_cron" <?php checked( $sync_mode, 'wp_cron' ); ?> />
									<?php esc_html_e( 'WordPress Cron', 'ai-blog-poster' ); ?>
								</label>
								<br />
								<label>
									<input type="radio" name="<?php echo esc_attr( Settings::OPTION_NAME ); ?>[sync_mode]" value="manual_cron" <?php checked( $sync_mode, 'manual_cron' ); ?> />
									<?php esc_html_e( 'Manual Server Cron', 'ai-blog-poster' ); ?>
								</label>
							</fieldset>
							<p class="description"><?php esc_html_e( 'Use Manual Server Cron to trigger sync from your hosting cron job instead of WP-Cron.', 'ai-blog-poster' ); ?></p>
						</td>
					</tr>

					<tr class="aibp-wp-cron-row<?php echo $is_manual_cron ? ' aibp-hidden' : ''; ?>">
						<th scope="row">
							<label for="aibp_sync_frequency"><?php esc_html_e( 'Sync Frequency (minutes)', 'ai-blog-poster' ); ?></label>
						</th>
						<td>
							<input
								type="number"
								min="5"
								step="1"
								id="aibp_sync_frequency"
								name="<?php echo esc_attr( Settings::OPTION_NAME ); ?>[sync_frequency]"
								value="<?php echo esc_attr( (string) $settings['sync_frequency'] ); ?>"
							/>
							<p class="description"><?php esc_html_e( 'Minimum 5 minutes. Example: enter 60 to sync once every 60 minutes via WP-Cron.', 'ai-blog-poster' ); ?></p>
						</td>
					</tr>

					<tr class="aibp-manual-cron-row<?php echo $is_manual_cron ? '' : ' aibp-hidden'; ?>">
						<th scope="row"><?php esc_html_e( 'Manual Cron URL', 'ai-blog-poster' ); ?></th>
						<td>
							<input type="text" readonly class="large-text code" value="<?php echo esc_attr( $manual_cron_url ); ?>" />
							<p class="description"><?php esc_html_e( 'Copy this URL into your hosting cron job to trigger sync automatically.', 'ai-blog-poster' ); ?></p>
							<p><a class="button" href="<?php echo esc_url( $regenerate_token_url ); ?>"><?php esc_html_e( 'Regenerate Cron Token', 'ai-blog-poster' ); ?></a></p>
							<p class="description"><?php esc_html_e( 'Keep the token private. Regenerating it invalidates the old URL.', 'ai-blog-poster' ); ?></p>
						</td>
					</tr>

					<tr class="aibp-manual-cron-row<?php echo $is_manual_cron ? '' : ' aibp-hidden'; ?>">
						<th scope="row"><?php esc_html_e( 'Example Cron Command', 'ai-blog-poster' ); ?></th>
						<td>
							<input type="text" readonly class="large-text code" value="<?php echo esc_attr( $example_cron_cmd ); ?>" />
							<p class="description">
								<?php
								printf(
									/* translators: %d: sync frequency in minutes */
									esc_html__( 'Run this command every %d minutes from your hosting cron panel.', 'ai-blog-poster' ),
									(int) $settings['sync_frequency']
								);
								?>
							</p>
							<p class="description"><?php esc_html_e( 'For hourly sync, use the timing 0 * * * *:', 'ai-blog-poster' ); ?></p>
							<input type="text" readonly class="large-text code" value="<?php echo esc_attr( $hourly_cron_cmd ); ?>" />
						</td>
					</tr>

					<tr>
						<th scope="row">
							<label for="aibp_default_author_id"><?php esc_html_e( 'Default Author', 'ai-blog-poster' ); ?></label>
						</th>
						<td>
							<?php
							wp_dropdown_users(
								array(
									'name'       => Settings::OPTION_NAME . '[default_author_id]',
									'id'         => 'aibp_default_author_id',
									'selected'   => (int) $settings['default_author_id'],
									'capability' => 'edit_posts',
								)
							);
							?>
							<p class="description"><?php esc_html_e( 'WordPress author assigned to all imported posts.', 'ai-blog-poster' ); ?></p>
						</td>
					</tr>

					<tr>
						<th scope="row">
							<label for="aibp_default_category_id"><?php esc_html_e( 'Default Category', 'ai-blog-poster' ); ?></label>
						</th>
						<td>
							<?php
							wp_dropdown_categories(
								array(
									'taxonomy'          => 'category',
									'name'              => Settings::OPTION_NAME . '[default_category_id]',
									'id'                => 'aibp_default_category_id',
									'selected'          => (int) $settings['default_category_id'],
									'show_option_none'  => __( 'No default category', 'ai-blog-poster' ),
									'option_none_value' => 0,
									'hide_empty'        => false,
								)
							);
							?>
						</td>
					</tr>

					<tr>
						<th scope="row">
							<label for="aibp_default_post_status"><?php esc_html_e( 'Default Post Status', 'ai-blog-poster' ); ?></label>
						</th>
						<td>
							<select id="aibp_default_post_status" name="<?php echo esc_attr( Settings::OPTION_NAME ); ?>[default_post_status]">
								<option value="publish" <?php selected( $settings['default_post_status'], 'publish' ); ?>><?php esc_html_e( 'Publish', 'ai-blog-poster' ); ?></option>
								<option value="draft" <?php selected( $settings['default_post_status'], 'draft' ); ?>><?php esc_html_e( 'Draft', 'ai-blog-poster' ); ?></option>
								<option value="pending" <?php selected( $settings['default_post_status'], 'pending' ); ?>><?php esc_html_e( 'Pending Review', 'ai-blog-poster' ); ?></option>
								<option value="private" <?php selected( $settings['default_post_status'], 'private' ); ?>><?php esc_html_e( 'Private', 'ai-blog-poster' ); ?></option>
							</select>
							<p class="description"><?php esc_html_e( 'How imported posts are saved in WordPress.', 'ai-blog-poster' ); ?></p>
						</td>
					</tr>

					<tr>
						<th scope="row"><?php esc_html_e( 'Last Run', 'ai-blog-poster' ); ?></th>
						<td><p><?php echo esc_html( $last_run ); ?></p></td>
					</tr>

					<tr>
						<th scope="row"><?php esc_html_e( 'Last Imported', 'ai-blog-poster' ); ?></th>
						<td><p><?php echo esc_html( $last_sync ); ?></p></td>
					</tr>
				</table>

				<?php submit_button( __( 'Save Settings', 'ai-blog-poster' ) ); ?>
			</form>

			<hr />
			<p>
				<a class="button button-primary" href="<?php echo esc_url( $manual_sync_url ); ?>">
					<?php esc_html_e( 'Run Manual Sync', 'ai-blog-poster' ); ?>
				</a>
			</p>
		</div>
		<?php
	}

	/**
	 * Renders the list of posts imported by AI Blog Poster.
	 */
	public function render_imported_posts_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$paged    = isset( $_GET['paged'] ) ? max( 1, absint( $_GET['paged'] ) ) : 1; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$per_page = 20;
		$query    = new \WP_Query(
			array(
				'post_type'              => 'post',
				'post_status'            => 'any',
				'posts_per_page'         => $per_page,
				'paged'                  => $paged,
				'meta_key'               => Sync_Service::REMOTE_ID_META_KEY,
				'orderby'                => 'date',
				'order'                  => 'DESC',
				'ignore_sticky_posts'    => true,
				'update_post_meta_cache' => true,
				'update_post_term_cache' => false,
			)
		);
		?>
		<div class="wrap">
			<h1><?php esc_html_e( 'Imported Posts', 'ai-blog-poster' ); ?></h1>
			<p><?php esc_html_e( 'Posts created by AI Blog Poster. Duplicate checks use the AIBP Blog ID shown below.', 'ai-blog-poster' ); ?></p>

			<p>
				<a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::PAGE_SLUG ) ); ?>"><?php esc_html_e( 'Back to Dashboard', 'ai-blog-poster' ); ?></a>
			</p>

			<table class="widefat striped">
				<thead>
					<tr>
						<th><?php esc_html_e( 'AIBP Blog ID', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Title', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Status', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Author', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Date', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Actions', 'ai-blog-poster' ); ?></th>
					</tr>
				</thead>
				<tbody>
					<?php if ( ! $query->have_posts() ) : ?>
						<tr>
							<td colspan="6"><?php esc_html_e( 'No imported posts found yet.', 'ai-blog-poster' ); ?></td>
						</tr>
					<?php else : ?>
						<?php
						while ( $query->have_posts() ) :
							$query->the_post();
							$post_id  = get_the_ID();
							$blog_id  = get_post_meta( $post_id, Sync_Service::REMOTE_ID_META_KEY, true );
							$status   = get_post_status_object( get_post_status( $post_id ) );
							$author   = get_userdata( (int) get_post_field( 'post_author', $post_id ) );
							$edit_url = get_edit_post_link( $post_id, '' );
							$view_url = get_permalink( $post_id );
							?>
							<tr>
								<td><?php echo esc_html( (string) $blog_id ); ?></td>
								<td><strong><?php echo esc_html( get_the_title( $post_id ) ); ?></strong></td>
								<td><?php echo esc_html( $status ? $status->label : get_post_status( $post_id ) ); ?></td>
								<td><?php echo esc_html( $author ? $author->display_name : '-' ); ?></td>
								<td><?php echo esc_html( get_the_date( 'Y-m-d H:i:s', $post_id ) ); ?></td>
								<td>
									<?php if ( $edit_url ) : ?>
										<a href="<?php echo esc_url( $edit_url ); ?>"><?php esc_html_e( 'Edit', 'ai-blog-poster' ); ?></a>
									<?php endif; ?>
									<?php if ( $view_url ) : ?>
										<?php if ( $edit_url ) : ?>
											<span aria-hidden="true"> | </span>
										<?php endif; ?>
										<a href="<?php echo esc_url( $view_url ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'View', 'ai-blog-poster' ); ?></a>
									<?php endif; ?>
								</td>
							</tr>
							<?php
						endwhile;
						wp_reset_postdata();
						?>
					<?php endif; ?>
				</tbody>
			</table>

			<?php if ( $query->max_num_pages > 1 ) : ?>
				<div class="tablenav">
					<div class="tablenav-pages">
						<?php
						echo wp_kses_post(
							paginate_links(
								array(
									'base'      => add_query_arg( 'paged', '%#%', admin_url( 'admin.php?page=' . self::IMPORTED_POSTS_SLUG ) ),
									'format'    => '',
									'current'   => $paged,
									'total'     => $query->max_num_pages,
									'prev_text' => __( '&laquo;', 'ai-blog-poster' ),
									'next_text' => __( '&raquo;', 'ai-blog-poster' ),
								)
							)
						);
						?>
					</div>
				</div>
			<?php endif; ?>
		</div>
		<?php
	}

	/**
	 * Renders recent sync entries for debugging.
	 */
	public function render_debug_history_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$entries   = $this->debug_history->get_entries();
		$clear_url = wp_nonce_url(
			admin_url( 'admin-post.php?action=' . self::CLEAR_HISTORY_ACTION ),
			self::CLEAR_HISTORY_ACTION
		);
		?>
		<div class="wrap">
			<h1><?php esc_html_e( 'AI Blog Poster Debug History', 'ai-blog-poster' ); ?></h1>
			<p><?php esc_html_e( 'Recent sync attempts from manual sync, WordPress Cron, and Manual Server Cron.', 'ai-blog-poster' ); ?></p>

			<p>
				<a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::PAGE_SLUG ) ); ?>"><?php esc_html_e( 'Back to Dashboard', 'ai-blog-poster' ); ?></a>
				<a class="button button-secondary" href="<?php echo esc_url( $clear_url ); ?>"><?php esc_html_e( 'Clear Debug History', 'ai-blog-poster' ); ?></a>
			</p>

			<table class="widefat striped">
				<thead>
					<tr>
						<th><?php esc_html_e( 'Time', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Source', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Status', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Message', 'ai-blog-poster' ); ?></th>
						<th><?php esc_html_e( 'Details', 'ai-blog-poster' ); ?></th>
					</tr>
				</thead>
				<tbody>
					<?php if ( empty( $entries ) ) : ?>
						<tr>
							<td colspan="5"><?php esc_html_e( 'No debug history yet. Run a manual sync to create the first entry.', 'ai-blog-poster' ); ?></td>
						</tr>
					<?php else : ?>
						<?php foreach ( $entries as $entry ) : ?>
							<tr>
								<td><?php echo esc_html( ! empty( $entry['time'] ) ? $this->format_timestamp( (int) $entry['time'] ) : '-' ); ?></td>
								<td><?php echo esc_html( ! empty( $entry['source'] ) ? $entry['source'] : '-' ); ?></td>
								<td><?php echo esc_html( ! empty( $entry['status'] ) ? $entry['status'] : '-' ); ?></td>
								<td><?php echo esc_html( ! empty( $entry['message'] ) ? $entry['message'] : '-' ); ?></td>
								<td>
									<pre class="aibp-debug-pre"><?php echo esc_html( $this->format_debug_context( ! empty( $entry['context'] ) ? $entry['context'] : array() ) ); ?></pre>
								</td>
							</tr>
						<?php endforeach; ?>
					<?php endif; ?>
				</tbody>
			</table>
		</div>
		<?php
	}

	/**
	 * Renders setup and troubleshooting instructions.
	 */
	public function render_help_page() {
		if ( ! current_user_can( 'manage_options' ) ) {
			return;
		}

		$manual_cron_url  = $this->scheduler->get_manual_cron_url();
		$hourly_cron_cmd  = '0 * * * * curl -s "' . $manual_cron_url . '" >/dev/null 2>&1';
		$api_key_img      = AIBP_PLUGIN_URL . 'assets/api.png';
		?>
		<div class="wrap">
			<h1><?php esc_html_e( 'AI Blog Poster Help', 'ai-blog-poster' ); ?></h1>
			<p><?php esc_html_e( 'Follow this guide to connect the plugin, import posts, and troubleshoot sync issues.', 'ai-blog-poster' ); ?></p>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '1. Generate and Add Your API Key', 'ai-blog-poster' ); ?></h2>
				<p><?php esc_html_e( 'Create or copy an API key from your AI Blog Poster account, then paste it into the plugin settings.', 'ai-blog-poster' ); ?></p>
				<p>
					<img
						src="<?php echo esc_url( $api_key_img ); ?>"
						alt="<?php esc_attr_e( 'AI Blog Poster API key generation screen showing the APIs menu and Create API Key button.', 'ai-blog-poster' ); ?>"
						class="aibp-help-screenshot"
					/>
				</p>
				<ol>
					<li><?php esc_html_e( 'Log in to your AI Blog Poster account.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Open the APIs menu from the left sidebar.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Click Create API Key if you do not already have one.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Copy the API key from the API Key column.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Open WordPress Admin > AI Blog Poster > Settings and paste the key.', 'ai-blog-poster' ); ?></li>
				</ol>
				<p><a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::SETTINGS_PAGE_SLUG ) ); ?>"><?php esc_html_e( 'Open Settings', 'ai-blog-poster' ); ?></a></p>
			</div>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '2. Choose a Sync Mode', 'ai-blog-poster' ); ?></h2>
				<p><strong><?php esc_html_e( 'WordPress Cron', 'ai-blog-poster' ); ?></strong> &mdash; <?php esc_html_e( 'WordPress runs sync automatically based on site traffic and the frequency setting.', 'ai-blog-poster' ); ?></p>
				<p><strong><?php esc_html_e( 'Manual Server Cron', 'ai-blog-poster' ); ?></strong> &mdash; <?php esc_html_e( 'Your hosting cron triggers sync via a secure URL. More reliable on production sites.', 'ai-blog-poster' ); ?></p>
			</div>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '3. Manual Server Cron Setup', 'ai-blog-poster' ); ?></h2>
				<ol>
					<li><?php esc_html_e( 'Select Manual Server Cron in Settings and click Save Settings.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Copy the Manual Cron URL or the example command below into your hosting cron panel.', 'ai-blog-poster' ); ?></li>
				</ol>
				<p><strong><?php esc_html_e( 'Manual Cron URL', 'ai-blog-poster' ); ?></strong></p>
				<input type="text" readonly class="large-text code" value="<?php echo esc_attr( $manual_cron_url ); ?>" />
				<p><strong><?php esc_html_e( 'Hourly cron command (0 * * * *)', 'ai-blog-poster' ); ?></strong></p>
				<input type="text" readonly class="large-text code" value="<?php echo esc_attr( $hourly_cron_cmd ); ?>" />
				<p class="description"><?php esc_html_e( 'Keep the token private. Regenerate it from Settings if it is ever exposed.', 'ai-blog-poster' ); ?></p>
			</div>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '4. Configure Post Defaults', 'ai-blog-poster' ); ?></h2>
				<ul>
					<li><?php esc_html_e( 'Default Author — WordPress user assigned to imported posts.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Default Category — added to imported posts alongside API categories.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Default Post Status — Publish, Draft, Pending Review, or Private.', 'ai-blog-poster' ); ?></li>
				</ul>
			</div>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '5. Run Sync and Review Results', 'ai-blog-poster' ); ?></h2>
				<ul>
					<li><?php esc_html_e( 'API Returned — records the API sent to the plugin.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Created — new WordPress posts inserted.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Already Imported — records skipped because they already exist.', 'ai-blog-poster' ); ?></li>
					<li><?php esc_html_e( 'Failed — records the plugin could not process.', 'ai-blog-poster' ); ?></li>
				</ul>
				<p>
					<a class="button button-primary" href="<?php echo esc_url( wp_nonce_url( admin_url( 'admin-post.php?action=' . self::MANUAL_SYNC_ACTION ), self::MANUAL_SYNC_ACTION ) ); ?>"><?php esc_html_e( 'Run Manual Sync', 'ai-blog-poster' ); ?></a>
					<a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::IMPORTED_POSTS_SLUG ) ); ?>"><?php esc_html_e( 'View Imported Posts', 'ai-blog-poster' ); ?></a>
				</p>
			</div>

			<div class="postbox aibp-help-section">
				<h2><?php esc_html_e( '6. Troubleshoot with Debug History', 'ai-blog-poster' ); ?></h2>
				<p><?php esc_html_e( 'Open Debug History to see sync source, requested timestamp, API errors, and import counts.', 'ai-blog-poster' ); ?></p>
				<p><a class="button" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::DEBUG_PAGE_SLUG ) ); ?>"><?php esc_html_e( 'Open Debug History', 'ai-blog-poster' ); ?></a></p>
			</div>
		</div>
		<?php
	}

	/**
	 * Handles the manual sync form action.
	 */
	public function handle_manual_sync() {
		if ( ! current_user_can( 'manage_options' ) ) {
			wp_die( esc_html__( 'You do not have permission to perform this action.', 'ai-blog-poster' ) );
		}

		check_admin_referer( self::MANUAL_SYNC_ACTION );

		$result = $this->sync_service->sync( 'manual' );

		if ( is_wp_error( $result ) ) {
			$this->add_admin_message( $result->get_error_message(), 'error' );
		} else {
			$message = sprintf(
				/* translators: 1: returned count, 2: created count, 3: duplicate count, 4: failed count */
				__( 'Sync complete. API Returned: %1$d, Created: %2$d, Already Imported: %3$d, Failed: %4$d.', 'ai-blog-poster' ),
				(int) $result['fetched'],
				(int) $result['created'],
				(int) $result['skipped'],
				(int) $result['failed']
			);
			$this->add_admin_message( $message, 'updated' );
		}

		wp_safe_redirect( admin_url( 'admin.php?page=' . self::SETTINGS_PAGE_SLUG ) );
		exit;
	}

	/**
	 * Handles the cron token regeneration action.
	 */
	public function handle_regenerate_token() {
		if ( ! current_user_can( 'manage_options' ) ) {
			wp_die( esc_html__( 'You do not have permission to perform this action.', 'ai-blog-poster' ) );
		}

		check_admin_referer( self::REGENERATE_TOKEN_ACTION );
		$this->settings->regenerate_cron_token();
		$this->add_admin_message( __( 'Cron token regenerated. Update your server cron job with the new URL.', 'ai-blog-poster' ), 'updated' );
		wp_safe_redirect( admin_url( 'admin.php?page=' . self::SETTINGS_PAGE_SLUG ) );
		exit;
	}

	/**
	 * Handles the clear debug history action.
	 */
	public function handle_clear_debug_history() {
		if ( ! current_user_can( 'manage_options' ) ) {
			wp_die( esc_html__( 'You do not have permission to perform this action.', 'ai-blog-poster' ) );
		}

		check_admin_referer( self::CLEAR_HISTORY_ACTION );
		$this->debug_history->clear();
		$this->add_admin_message( __( 'Debug history cleared.', 'ai-blog-poster' ), 'updated' );
		wp_safe_redirect( admin_url( 'admin.php?page=' . self::DEBUG_PAGE_SLUG ) );
		exit;
	}

	/**
	 * Refreshes the cron schedule after settings are saved.
	 *
	 * @param mixed $old_value Previous option value.
	 * @param mixed $value     New option value.
	 */
	public function after_settings_saved( $old_value, $value ) {
		$this->scheduler->register_schedule();

		$message = $this->scheduler->is_wp_cron_enabled()
			? __( 'Settings saved and WP-Cron schedule updated.', 'ai-blog-poster' )
			: __( 'Settings saved. Use the Manual Cron URL in your server cron job.', 'ai-blog-poster' );

		$this->add_admin_message( $message, 'updated' );
	}

	/**
	 * Prints the stored one-time admin notice.
	 */
	public function render_admin_notice() {
		$notice = get_transient( 'aibp_admin_notice' );

		if ( empty( $notice['message'] ) ) {
			return;
		}

		delete_transient( 'aibp_admin_notice' );
		$class = 'error' === $notice['type'] ? 'notice notice-error' : 'notice notice-success';
		?>
		<div class="<?php echo esc_attr( $class ); ?> is-dismissible">
			<p><?php echo esc_html( $notice['message'] ); ?></p>
		</div>
		<?php
	}

	/**
	 * Stores a one-time notice for the next page load.
	 *
	 * @param string $message Notice text.
	 * @param string $type    Notice type ('error' or 'updated').
	 */
	private function add_admin_message( $message, $type ) {
		set_transient(
			'aibp_admin_notice',
			array(
				'message' => $message,
				'type'    => $type,
			),
			60
		);
	}

	/**
	 * Returns the total number of posts imported by the plugin.
	 *
	 * @return int
	 */
	private function get_imported_post_count() {
		$query = new \WP_Query(
			array(
				'post_type'              => 'post',
				'post_status'            => 'any',
				'posts_per_page'         => 1,
				'fields'                 => 'ids',
				'meta_key'               => Sync_Service::REMOTE_ID_META_KEY,
				'no_found_rows'          => false,
				'ignore_sticky_posts'    => true,
				'update_post_meta_cache' => false,
				'update_post_term_cache' => false,
			)
		);

		return (int) $query->found_posts;
	}

	/**
	 * Formats a Unix timestamp using the site timezone.
	 *
	 * @param int $timestamp Unix timestamp.
	 * @return string
	 */
	private function format_timestamp( $timestamp ) {
		if ( function_exists( 'wp_date' ) ) {
			return wp_date( 'Y-m-d H:i:s', $timestamp );
		}

		return date_i18n( 'Y-m-d H:i:s', $timestamp );
	}

	/**
	 * Formats debug context as indented JSON for the admin table.
	 *
	 * @param array<mixed> $context Debug context array.
	 * @return string
	 */
	private function format_debug_context( array $context ) {
		if ( empty( $context ) ) {
			return '{}';
		}

		$json = wp_json_encode( $context, JSON_PRETTY_PRINT );

		return false === $json ? '{}' : $json;
	}
}