<?php
/**
 * Admin screens.
 *
 * @package AccessVane
 */

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

/**
 * Registers menus and renders the plugin's admin pages.
 */
class AccessVane_Admin {

	const MENU_SLUG = 'accessvane';
	const CAPABILITY = 'manage_options';

	/**
	 * Hook registration.
	 *
	 * @return void
	 */
	public function register() {
		add_action( 'admin_menu', array( $this, 'menus' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'assets' ) );
		add_action( 'admin_post_accessvane_save_fixes', array( $this, 'handle_save_fixes' ) );
	}

	/**
	 * Register the menu and its sub-pages.
	 *
	 * @return void
	 */
	public function menus() {
		add_menu_page(
			__( 'AccessVane', 'accessvane' ),
			__( 'Accessibility', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG,
			array( $this, 'render_dashboard' ),
			'dashicons-universal-access-alt',
			58
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Accessibility overview', 'accessvane' ),
			__( 'Overview', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG,
			array( $this, 'render_dashboard' )
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Scan pages', 'accessvane' ),
			__( 'Scan pages', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG . '-scan',
			array( $this, 'render_scan' )
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Repairs', 'accessvane' ),
			__( 'Repairs', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG . '-fixes',
			array( $this, 'render_fixes' )
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Image alt text', 'accessvane' ),
			__( 'Image alt text', 'accessvane' ),
			'upload_files',
			self::MENU_SLUG . '-alt-text',
			array( accessvane()->alt_text, 'render_page' )
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Accessibility statement', 'accessvane' ),
			__( 'Statement', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG . '-statement',
			array( accessvane()->statement, 'render_page' )
		);

		add_submenu_page(
			self::MENU_SLUG,
			__( 'Manual checks', 'accessvane' ),
			__( 'Manual checks', 'accessvane' ),
			self::CAPABILITY,
			self::MENU_SLUG . '-manual',
			array( $this, 'render_manual' )
		);
	}

	/**
	 * Whether the current screen belongs to this plugin.
	 *
	 * @param string $hook Current admin page hook.
	 * @return bool
	 */
	private function is_plugin_screen( $hook ) {
		return false !== strpos( (string) $hook, self::MENU_SLUG );
	}

	/**
	 * Enqueue admin assets on our screens only.
	 *
	 * @param string $hook Current admin page hook.
	 * @return void
	 */
	public function assets( $hook ) {
		if ( ! $this->is_plugin_screen( $hook ) ) {
			return;
		}

		wp_enqueue_style(
			'accessvane-admin',
			ACCESSVANE_URL . 'assets/css/admin.css',
			array(),
			ACCESSVANE_VERSION
		);

		// axe-core is only needed on the scanning screen, and it is a large
		// file — do not make every other screen pay for it.
		if ( false !== strpos( $hook, self::MENU_SLUG . '-scan' ) ) {
			wp_enqueue_script(
				'accessvane-axe',
				ACCESSVANE_URL . 'assets/js/axe.js',
				array(),
				ACCESSVANE_AXE_VERSION,
				true
			);

			// Our own checks, injected into the scanned frame alongside axe.
			wp_enqueue_script(
				'accessvane-custom-checks',
				ACCESSVANE_URL . 'assets/js/custom-checks.js',
				array(),
				ACCESSVANE_VERSION,
				true
			);

			wp_enqueue_script(
				'accessvane-admin',
				ACCESSVANE_URL . 'assets/js/admin.js',
				array( 'accessvane-axe', 'accessvane-custom-checks', 'wp-api-fetch' ),
				ACCESSVANE_VERSION,
				true
			);

			wp_localize_script(
				'accessvane-admin',
				'accessVane',
				array(
					'restUrl'  => esc_url_raw( rest_url( AccessVane_REST::NAMESPACE_V1 ) ),
					'nonce'    => wp_create_nonce( 'wp_rest' ),
					'homeUrl'  => esc_url_raw( home_url() ),
					'strings'  => array(
						'scanning'      => __( 'Opening the page...', 'accessvane' ),
						'analysing'     => __( 'Checking it...', 'accessvane' ),
						'saving'        => __( 'Saving the result...', 'accessvane' ),
						'done'          => __( 'Done', 'accessvane' ),
						'failedLoad'    => __( 'That page could not be loaded for scanning. If a security plugin blocks framing on your own site, allow same-origin framing and try again.', 'accessvane' ),
						'failedRun'     => __( 'The page loaded but could not be checked. This usually means a plugin is blocking scripts inside the frame.', 'accessvane' ),
						'failedSave'    => __( 'The result could not be saved. Please reload and try again.', 'accessvane' ),
						'timeout'       => __( 'That page took too long to load. Try again, or scan a simpler page.', 'accessvane' ),
						'confirmDelete' => __( 'Remove this page from the results?', 'accessvane' ),
						'selectPage'    => __( 'Select at least one page first.', 'accessvane' ),
					),
				)
			);
		}
	}

	/**
	 * Shared page header.
	 *
	 * @param string $title Page title.
	 * @param string $intro Supporting sentence.
	 * @return void
	 */
	private function header( $title, $intro ) {
		printf(
			'<div class="wrap accessvane-wrap"><h1 class="accessvane-title">%s</h1><p class="accessvane-intro">%s</p>',
			esc_html( $title ),
			esc_html( $intro )
		);
	}

	/**
	 * The honesty note. Shown on every screen that reports a result.
	 *
	 * @return void
	 */
	private function coverage_note() {
		?>
		<div class="accessvane-note">
			<strong><?php esc_html_e( 'What an automatic check can and cannot tell you', 'accessvane' ); ?></strong>
			<p>
				<?php
				esc_html_e(
					'Automated testing reliably detects roughly a third of WCAG failures. A clean scan is a good sign, not a certificate of compliance, and no plugin can honestly promise otherwise. The Manual checks screen covers the rest — the keyboard and screen reader tests there will tell you more about your site than any scan.',
					'accessvane'
				);
				?>
			</p>
		</div>
		<?php
	}

	/**
	 * Score badge markup.
	 *
	 * @param int $score Score out of 100.
	 * @return void
	 */
	private function score_badge( $score ) {
		$score = (int) $score;

		if ( $score >= 90 ) {
			$state = 'good';
		} elseif ( $score >= 70 ) {
			$state = 'warn';
		} else {
			$state = 'bad';
		}

		printf(
			'<span class="accessvane-score accessvane-score--%1$s">%2$d<small>/100</small></span>',
			esc_attr( $state ),
			$score // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- cast to int above.
		);
	}

	/**
	 * Overview screen.
	 *
	 * @return void
	 */
	public function render_dashboard() {
		$summary = AccessVane_Storage::summary();
		$issues  = AccessVane_Catalog::issues();

		$this->header(
			__( 'Accessibility overview', 'accessvane' ),
			__( 'A summary of every page you have scanned, and what to do next.', 'accessvane' )
		);

		if ( 0 === $summary['pages'] ) {
			?>
			<div class="accessvane-empty">
				<h2><?php esc_html_e( 'Nothing scanned yet', 'accessvane' ); ?></h2>
				<p>
					<?php
					esc_html_e(
						'Start with your homepage, then a content page, your contact page, and — if you sell online — a product page and the checkout. Most accessibility problems live in the theme, so a handful of pages usually reveals nearly everything.',
						'accessvane'
					);
					?>
				</p>
				<a class="button button-primary button-hero" href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::MENU_SLUG . '-scan' ) ); ?>">
					<?php esc_html_e( 'Scan my first page', 'accessvane' ); ?>
				</a>
			</div>
			</div>
			<?php
			return;
		}

		?>
		<div class="accessvane-summary">
			<div class="accessvane-summary__score">
				<?php $this->score_badge( $summary['average_score'] ); ?>
				<p><?php esc_html_e( 'Average across scanned pages', 'accessvane' ); ?></p>
			</div>
			<div class="accessvane-summary__counts">
				<?php
				$levels = array(
					'critical' => __( 'Critical', 'accessvane' ),
					'serious'  => __( 'Serious', 'accessvane' ),
					'moderate' => __( 'Moderate', 'accessvane' ),
					'minor'    => __( 'Minor', 'accessvane' ),
				);

				foreach ( $levels as $key => $label ) {
					printf(
						'<div class="accessvane-count accessvane-count--%1$s"><span class="accessvane-count__n">%2$d</span><span class="accessvane-count__label">%3$s</span></div>',
						esc_attr( $key ),
						(int) $summary[ $key ],
						esc_html( $label )
					);
				}
				?>
			</div>
		</div>

		<p class="accessvane-meta">
			<?php
			printf(
				/* translators: 1: number of pages, 2: number of elements, 3: human-readable time difference. */
				esc_html__( '%1$d pages scanned, %2$d affected elements found. Last scan %3$s ago.', 'accessvane' ),
				(int) $summary['pages'],
				(int) $summary['elements'],
				esc_html( human_time_diff( $summary['last_scanned_at'], time() ) )
			);
			?>
		</p>

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

		<h2><?php esc_html_e( 'Your most widespread problems', 'accessvane' ); ?></h2>
		<table class="widefat striped accessvane-table">
			<thead>
				<tr>
					<th><?php esc_html_e( 'Problem', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Severity', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Pages', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Elements', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Repairable here', 'accessvane' ); ?></th>
				</tr>
			</thead>
			<tbody>
				<?php foreach ( array_slice( $summary['top_issues'], 0, 12 ) as $row ) : ?>
					<?php $catalog = isset( $issues[ $row['id'] ] ) ? $issues[ $row['id'] ] : null; ?>
					<tr>
						<td>
							<strong><?php echo esc_html( $catalog ? $catalog['title'] : $row['id'] ); ?></strong>
							<?php if ( $catalog ) : ?>
								<p class="accessvane-dim"><?php echo esc_html( $catalog['plain'] ); ?></p>
							<?php endif; ?>
						</td>
						<td><span class="accessvane-pill accessvane-pill--<?php echo esc_attr( $row['impact'] ); ?>"><?php echo esc_html( ucfirst( $row['impact'] ) ); ?></span></td>
						<td><?php echo (int) $row['pages']; ?></td>
						<td><?php echo (int) $row['elements']; ?></td>
						<td>
							<?php if ( ! empty( $row['autoFixable'] ) ) : ?>
								<a href="<?php echo esc_url( admin_url( 'admin.php?page=' . self::MENU_SLUG . '-fixes' ) ); ?>"><?php esc_html_e( 'Yes — turn on a repair', 'accessvane' ); ?></a>
							<?php else : ?>
								<span class="accessvane-dim"><?php esc_html_e( 'Needs an editing change', 'accessvane' ); ?></span>
							<?php endif; ?>
						</td>
					</tr>
				<?php endforeach; ?>
			</tbody>
		</table>

		<h2><?php esc_html_e( 'Pages you have scanned', 'accessvane' ); ?></h2>
		<table class="widefat striped accessvane-table">
			<thead>
				<tr>
					<th><?php esc_html_e( 'Page', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Score', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Critical', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Serious', 'accessvane' ); ?></th>
					<th><?php esc_html_e( 'Scanned', 'accessvane' ); ?></th>
				</tr>
			</thead>
			<tbody>
				<?php foreach ( AccessVane_Storage::all() as $result ) : ?>
					<tr>
						<td>
							<strong><?php echo esc_html( $result['title'] ? $result['title'] : $result['url'] ); ?></strong>
							<p class="accessvane-dim"><a href="<?php echo esc_url( $result['url'] ); ?>" target="_blank" rel="noopener noreferrer"><?php echo esc_html( $result['url'] ); ?></a></p>
						</td>
						<td><?php $this->score_badge( $result['score'] ); ?></td>
						<td><?php echo (int) $result['counts']['critical']; ?></td>
						<td><?php echo (int) $result['counts']['serious']; ?></td>
						<td><?php echo esc_html( human_time_diff( $result['scanned_at'], time() ) ); ?></td>
					</tr>
				<?php endforeach; ?>
			</tbody>
		</table>

		<?php AccessVane_Review::render(); ?>

		<?php accessvane()->sibling->render(); ?>
		</div>
		<?php
	}

	/**
	 * Scanning screen. The scan itself is driven by assets/js/admin.js.
	 *
	 * @return void
	 */
	public function render_scan() {
		$this->header(
			__( 'Scan pages', 'accessvane' ),
			__( 'Pick the pages to check. Each one opens invisibly in this browser tab and is tested there, so nothing is sent to any server and the scan costs nothing to run.', 'accessvane' )
		);

		$pages = get_posts(
			array(
				'post_type'      => array( 'page', 'post' ),
				'post_status'    => 'publish',
				'numberposts'    => 100,
				'orderby'        => 'menu_order title',
				'order'          => 'ASC',
				'suppress_filters' => false,
			)
		);

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

		<div class="accessvane-card">
			<h2><?php esc_html_e( 'Choose what to scan', 'accessvane' ); ?></h2>

			<p class="accessvane-quick">
				<button type="button" class="button" data-accessvane-preset="key"><?php esc_html_e( 'Select the pages that matter most', 'accessvane' ); ?></button>
				<button type="button" class="button" data-accessvane-preset="all"><?php esc_html_e( 'Select all', 'accessvane' ); ?></button>
				<button type="button" class="button" data-accessvane-preset="none"><?php esc_html_e( 'Clear selection', 'accessvane' ); ?></button>
			</p>

			<ul class="accessvane-pagelist">
				<li>
					<label>
						<input type="checkbox" class="accessvane-target" value="<?php echo esc_url( home_url( '/' ) ); ?>" data-title="<?php esc_attr_e( 'Homepage', 'accessvane' ); ?>" data-key="1" checked>
						<strong><?php esc_html_e( 'Homepage', 'accessvane' ); ?></strong>
						<span class="accessvane-dim"><?php echo esc_html( home_url( '/' ) ); ?></span>
					</label>
				</li>
				<?php foreach ( $pages as $page ) : ?>
					<?php
					$permalink = get_permalink( $page );
					$is_key    = $this->is_key_page( $page );
					?>
					<li>
						<label>
							<input type="checkbox" class="accessvane-target" value="<?php echo esc_url( $permalink ); ?>" data-title="<?php echo esc_attr( $page->post_title ); ?>" data-key="<?php echo $is_key ? '1' : '0'; ?>">
							<strong><?php echo esc_html( $page->post_title ); ?></strong>
							<span class="accessvane-dim"><?php echo esc_html( $permalink ); ?></span>
						</label>
					</li>
				<?php endforeach; ?>
			</ul>

			<p>
				<button type="button" class="button button-primary button-hero" id="accessvane-run"><?php esc_html_e( 'Scan selected pages', 'accessvane' ); ?></button>
				<span id="accessvane-status" class="accessvane-status" role="status" aria-live="polite"></span>
			</p>
		</div>

		<div id="accessvane-results" class="accessvane-results"></div>

		<iframe id="accessvane-frame" title="<?php esc_attr_e( 'Page being scanned', 'accessvane' ); ?>" aria-hidden="true" tabindex="-1"></iframe>
		</div>
		<?php
	}

	/**
	 * Heuristic for the pages worth scanning first.
	 *
	 * @param WP_Post $page Page object.
	 * @return bool
	 */
	private function is_key_page( $page ) {
		if ( (int) get_option( 'page_on_front' ) === $page->ID ) {
			return true;
		}

		$needles = array( 'contact', 'about', 'shop', 'cart', 'checkout', 'product', 'service', 'book', 'appointment' );
		$slug    = strtolower( $page->post_name );

		foreach ( $needles as $needle ) {
			if ( false !== strpos( $slug, $needle ) ) {
				return true;
			}
		}

		return false;
	}

	/**
	 * Repairs screen.
	 *
	 * @return void
	 */
	public function render_fixes() {
		$settings = AccessVane_Settings::all();

		$this->header(
			__( 'Repairs', 'accessvane' ),
			__( 'Each repair changes the pages your visitors receive, not a layer on top of them. Everything here is off until you switch it on, and switching it off restores exactly what your theme produced before.', 'accessvane' )
		);

		if ( isset( $_GET['accessvane_saved'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only notice flag.
			printf(
				'<div class="notice notice-success is-dismissible"><p>%s</p></div>',
				esc_html__( 'Repairs saved. Open your site in a new tab to see the result.', 'accessvane' )
			);
		}

		$groups = $this->fix_definitions();
		?>
		<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
			<input type="hidden" name="action" value="accessvane_save_fixes">
			<?php wp_nonce_field( 'accessvane_save_fixes' ); ?>

			<?php foreach ( $groups as $group ) : ?>
				<div class="accessvane-card">
					<h2><?php echo esc_html( $group['title'] ); ?></h2>
					<p class="accessvane-dim"><?php echo esc_html( $group['intro'] ); ?></p>

					<?php foreach ( $group['fixes'] as $key => $fix ) : ?>
						<div class="accessvane-fix">
							<label class="accessvane-fix__toggle">
								<input type="checkbox" name="<?php echo esc_attr( $key ); ?>" value="1" <?php checked( ! empty( $settings[ $key ] ) ); ?>>
								<strong><?php echo esc_html( $fix['label'] ); ?></strong>
							</label>
							<p class="accessvane-fix__what"><?php echo esc_html( $fix['what'] ); ?></p>
							<p class="accessvane-fix__risk">
								<em><?php echo esc_html( $fix['risk'] ); ?></em>
							</p>
						</div>
					<?php endforeach; ?>

					<?php if ( ! empty( $group['options'] ) ) : ?>
						<div class="accessvane-options">
							<?php foreach ( $group['options'] as $option ) : ?>
								<p>
									<label for="accessvane-<?php echo esc_attr( $option['key'] ); ?>"><?php echo esc_html( $option['label'] ); ?></label><br>
									<?php if ( 'color' === $option['type'] ) : ?>
										<input type="text" id="accessvane-<?php echo esc_attr( $option['key'] ); ?>" name="<?php echo esc_attr( $option['key'] ); ?>" value="<?php echo esc_attr( $settings[ $option['key'] ] ); ?>" class="regular-text" placeholder="#0b63ce">
									<?php elseif ( 'number' === $option['type'] ) : ?>
										<input type="number" min="1" max="6" id="accessvane-<?php echo esc_attr( $option['key'] ); ?>" name="<?php echo esc_attr( $option['key'] ); ?>" value="<?php echo esc_attr( $settings[ $option['key'] ] ); ?>">
									<?php else : ?>
										<input type="text" id="accessvane-<?php echo esc_attr( $option['key'] ); ?>" name="<?php echo esc_attr( $option['key'] ); ?>" value="<?php echo esc_attr( $settings[ $option['key'] ] ); ?>" class="regular-text" placeholder="<?php echo esc_attr( $option['placeholder'] ); ?>">
									<?php endif; ?>
									<span class="description"><?php echo esc_html( $option['help'] ); ?></span>
								</p>
							<?php endforeach; ?>
						</div>
					<?php endif; ?>
				</div>
			<?php endforeach; ?>

			<div class="accessvane-card">
				<h2><?php esc_html_e( 'When you remove this plugin', 'accessvane' ); ?></h2>
				<label class="accessvane-fix__toggle">
					<input type="checkbox" name="delete_data_on_uninstall" value="1" <?php checked( ! empty( $settings['delete_data_on_uninstall'] ) ); ?>>
					<strong><?php esc_html_e( 'Delete all AccessVane settings and scan results on uninstall', 'accessvane' ); ?></strong>
				</label>
				<p class="accessvane-dim">
					<?php esc_html_e( 'Off by default, so deleting the plugin by accident does not lose your work. Your alt text and your accessibility statement page are never deleted — they belong to your site, not to this plugin.', 'accessvane' ); ?>
				</p>
			</div>

			<?php submit_button( __( 'Save repairs', 'accessvane' ) ); ?>
		</form>
		</div>
		<?php
	}

	/**
	 * The repairs offered, grouped for the screen.
	 *
	 * Each carries an honest note about what could go wrong — a site owner
	 * deciding whether to switch something on deserves to know the risk before
	 * they find out on their live site.
	 *
	 * @return array
	 */
	private function fix_definitions() {
		return array(
			array(
				'title'  => __( 'Keyboard access', 'accessvane' ),
				'intro'  => __( 'The repairs that matter most to anyone who cannot use a mouse.', 'accessvane' ),
				'fixes'  => array(
					'fix_skip_link'        => array(
						'label' => __( 'Add a "skip to main content" link', 'accessvane' ),
						'what'  => __( 'Adds a link at the very top of every page that jumps past the header and menu. It stays invisible until someone tabs to it.', 'accessvane' ),
						'risk'  => __( 'Safe. If the target below does not exist in your theme, the plugin finds your main content area and points the link there instead, so it always lands somewhere real.', 'accessvane' ),
					),
					'fix_focus_visible'    => array(
						'label' => __( 'Show a visible outline on the focused element', 'accessvane' ),
						'what'  => __( 'Draws a clear ring around whatever the keyboard is currently on. Many themes remove this for looks, which leaves keyboard users unable to see where they are.', 'accessvane' ),
						'risk'  => __( 'Safe. It only appears for keyboard users, never on mouse clicks.', 'accessvane' ),
					),
					'fix_scrollable_focus' => array(
						'label' => __( 'Make scrolling areas reachable by keyboard', 'accessvane' ),
						'what'  => __( 'Wide tables and code blocks that scroll sideways cannot be scrolled without a mouse. This makes them a keyboard stop.', 'accessvane' ),
						'risk'  => __( 'Low. It adds extra tab stops on pages with wide tables, which is the intended trade.', 'accessvane' ),
					),
				),
				'options' => array(
					array(
						'key'         => 'skip_link_target',
						'type'        => 'text',
						'label'       => __( 'Skip link target', 'accessvane' ),
						'placeholder' => '#content',
						'help'        => __( 'The id of your main content area. Leave it as #content unless you know yours differs; if it is not found, the plugin detects the right one automatically.', 'accessvane' ),
					),
					array(
						'key'         => 'skip_link_text',
						'type'        => 'text',
						'label'       => __( 'Skip link wording', 'accessvane' ),
						'placeholder' => __( 'Skip to main content', 'accessvane' ),
						'help'        => __( 'Leave blank to use the default.', 'accessvane' ),
					),
					array(
						'key'         => 'focus_ring_color',
						'type'        => 'color',
						'label'       => __( 'Focus outline colour', 'accessvane' ),
						'placeholder' => '#0b63ce',
						'help'        => __( 'Pick something that stands out against your backgrounds.', 'accessvane' ),
					),
					array(
						'key'         => 'focus_ring_width',
						'type'        => 'number',
						'label'       => __( 'Focus outline thickness (pixels)', 'accessvane' ),
						'placeholder' => '3',
						'help'        => __( 'Between 1 and 6. Three is a good default.', 'accessvane' ),
					),
				),
			),
			array(
				'title' => __( 'Reading and seeing', 'accessvane' ),
				'intro' => __( 'Repairs for visitors with low vision or colour blindness.', 'accessvane' ),
				'fixes' => array(
					'fix_viewport_zoom'  => array(
						'label' => __( 'Allow pinch-zoom on phones', 'accessvane' ),
						'what'  => __( 'Some themes and speed plugins block zooming. This unblocks it, which is one of the most common and most frustrating failures on mobile.', 'accessvane' ),
						'risk'  => __( 'Safe. Nothing on your page changes until a visitor chooses to zoom.', 'accessvane' ),
					),
					'fix_link_underline' => array(
						'label' => __( 'Underline links inside your content', 'accessvane' ),
						'what'  => __( 'Links in paragraphs that are only marked by colour are invisible to colour-blind readers. This underlines them — content links only, not menus or buttons.', 'accessvane' ),
						'risk'  => __( 'Visible change. Your body-copy links will look different. Turn it on, look at a post, and decide.', 'accessvane' ),
					),
				),
			),
			array(
				'title' => __( 'Screen reader information', 'accessvane' ),
				'intro' => __( 'Repairs that give assistive software the names and structure it needs.', 'accessvane' ),
				'fixes' => array(
					'fix_image_alt'       => array(
						'label' => __( 'Supply missing image descriptions', 'accessvane' ),
						'what'  => __( 'Where an image has no alt text, uses its caption or title instead, and marks it decorative when there is nothing meaningful to say. File names are never used — they describe nothing.', 'accessvane' ),
						'risk'  => __( 'Safe, but it is a stopgap. Real descriptions written by you are always better — the Image alt text screen makes that quick.', 'accessvane' ),
					),
					'fix_form_labels'     => array(
						'label' => __( 'Name form fields that have no label', 'accessvane' ),
						'what'  => __( 'Gives orphaned fields a name from their placeholder or field name, so a screen reader announces something useful instead of "edit text".', 'accessvane' ),
						'risk'  => __( 'Low, and also a stopgap. The real fix is a visible label in your form plugin, which sighted visitors need too.', 'accessvane' ),
					),
					'fix_iframe_titles'   => array(
						'label' => __( 'Title embedded videos and maps', 'accessvane' ),
						'what'  => __( 'Names each embed so a screen reader says what it contains instead of just "frame".', 'accessvane' ),
						'risk'  => __( 'Safe. Nothing visible changes.', 'accessvane' ),
					),
					'fix_landmark_labels' => array(
						'label' => __( 'Tell your menus apart', 'accessvane' ),
						'what'  => __( 'When a page has several navigation areas, names each one so they are not all announced as simply "navigation".', 'accessvane' ),
						'risk'  => __( 'Safe. Nothing visible changes.', 'accessvane' ),
					),
					'fix_lang_attribute'  => array(
						'label' => __( 'Declare the page language', 'accessvane' ),
						'what'  => __( 'Makes sure every page states its language, so a screen reader uses the right pronunciation. Without it, English can be read with a French accent.', 'accessvane' ),
						'risk'  => __( 'Safe. Only applies if your theme has left it out.', 'accessvane' ),
					),
				),
			),
		);
	}

	/**
	 * Save the repairs form.
	 *
	 * @return void
	 */
	public function handle_save_fixes() {
		if ( ! current_user_can( self::CAPABILITY ) ) {
			wp_die( esc_html__( 'You are not allowed to change these settings.', 'accessvane' ), 403 );
		}

		check_admin_referer( 'accessvane_save_fixes' );

		// Values are sanitised field by field inside AccessVane_Settings::save().
		$input = wp_unslash( $_POST ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized

		// Preserve settings that this form does not present.
		$existing = AccessVane_Settings::all();
		$input    = array_merge(
			array(
				'statement_page_id' => $existing['statement_page_id'],
			),
			$input
		);

		AccessVane_Settings::save( $input );

		wp_safe_redirect(
			add_query_arg(
				array(
					'page'             => self::MENU_SLUG . '-fixes',
					'accessvane_saved' => '1',
				),
				admin_url( 'admin.php' )
			)
		);
		exit;
	}

	/**
	 * Manual checks screen.
	 *
	 * @return void
	 */
	public function render_manual() {
		$this->header(
			__( 'Manual checks', 'accessvane' ),
			__( 'The problems no scanner can find. Work through these and you will have covered what automated testing cannot reach.', 'accessvane' )
		);

		?>
		<div class="accessvane-note">
			<strong><?php esc_html_e( 'Why this screen exists', 'accessvane' ); ?></strong>
			<p>
				<?php
				esc_html_e(
					'A scanner can see that an image has alt text. It cannot tell whether that alt text is accurate. It can see that a button is focusable, but not whether pressing it does the right thing. Roughly two thirds of accessibility requirements need a person. These are those checks, written so you can carry them out yourself.',
					'accessvane'
				);
				?>
			</p>
		</div>

		<ol class="accessvane-manual">
			<?php foreach ( AccessVane_Catalog::manual_checks() as $check ) : ?>
				<li class="accessvane-card">
					<h2><?php echo esc_html( $check['title'] ); ?></h2>
					<p class="accessvane-pillrow">
						<span class="accessvane-pill accessvane-pill--wcag">
							<?php
							printf(
								/* translators: 1: WCAG success criteria list, 2: conformance level. */
								esc_html__( 'WCAG %1$s - Level %2$s', 'accessvane' ),
								esc_html( implode( ', ', (array) $check['wcag'] ) ),
								esc_html( $check['level'] )
							);
							?>
						</span>
					</p>
					<p><strong><?php esc_html_e( 'How to do it:', 'accessvane' ); ?></strong> <?php echo esc_html( $check['how'] ); ?></p>
					<p><strong><?php esc_html_e( 'What to look for:', 'accessvane' ); ?></strong> <?php echo esc_html( $check['lookFor'] ); ?></p>
					<p class="accessvane-dim"><em><?php echo esc_html( $check['whyAutomationMisses'] ); ?></em></p>
				</li>
			<?php endforeach; ?>
		</ol>
		</div>
		<?php
	}
}