<?php
/**
 * Admin: menus, guide editor box, starter library, settings, import / export.
 *
 * @package Hintwise
 */

defined( 'ABSPATH' ) || exit;

/**
 * Admin screens.
 */
class Hintwise_Admin {

	/**
	 * Register hooks.
	 */
	public static function init() {
		add_action( 'admin_menu', array( __CLASS__, 'menu' ), 9 );
		add_filter( 'parent_file', array( __CLASS__, 'parent_file' ) );
		add_filter( 'submenu_file', array( __CLASS__, 'submenu_file' ) );
		add_action( 'admin_enqueue_scripts', array( __CLASS__, 'assets' ) );
		add_action( 'add_meta_boxes_' . Hintwise_Docs::TYPE, array( __CLASS__, 'meta_boxes' ) );
		add_action( 'save_post_' . Hintwise_Docs::TYPE, array( __CLASS__, 'save_doc' ), 10, 2 );
		add_filter( 'manage_' . Hintwise_Docs::TYPE . '_posts_columns', array( __CLASS__, 'columns' ) );
		add_action( 'manage_' . Hintwise_Docs::TYPE . '_posts_custom_column', array( __CLASS__, 'column' ), 10, 2 );
		add_filter( 'post_row_actions', array( __CLASS__, 'row_actions' ), 10, 2 );
		add_filter( 'page_row_actions', array( __CLASS__, 'row_actions' ), 10, 2 );
		add_action( 'admin_post_hintwise_settings', array( __CLASS__, 'handle_settings' ) );
		add_action( 'admin_post_hintwise_library', array( __CLASS__, 'handle_library' ) );
		add_action( 'admin_post_hintwise_export', array( __CLASS__, 'handle_export' ) );
		add_action( 'admin_post_hintwise_import', array( __CLASS__, 'handle_import' ) );
		add_action( 'admin_post_hintwise_wp_help', array( 'Hintwise_WP_Help', 'handle' ) );
		add_action( 'admin_notices', array( __CLASS__, 'notices' ) );
		add_filter( 'plugin_action_links_' . plugin_basename( HINTWISE_FILE ), array( __CLASS__, 'action_links' ) );
	}

	/**
	 * Admin menu.
	 */
	public static function menu() {
		$s      = Hintwise_Settings::get();
		$manage = Hintwise_Settings::manage_cap();
		$read   = Hintwise_Docs::has_any() ? 'read' : 'do_not_allow';
		add_menu_page( $s['menu_label'], $s['menu_label'], $read, 'hintwise', array( 'Hintwise_Handbook', 'render' ), $s['menu_icon'] );
		add_submenu_page( 'hintwise', $s['menu_label'], __( 'Read the guide', 'cedar-hintwise' ), $read, 'hintwise', array( 'Hintwise_Handbook', 'render' ) );
		add_submenu_page( 'hintwise', __( 'Guides', 'cedar-hintwise' ), __( 'All guides', 'cedar-hintwise' ), $manage, 'edit.php?post_type=' . Hintwise_Docs::TYPE );
		add_submenu_page( 'hintwise', __( 'Add guide', 'cedar-hintwise' ), __( 'Add guide', 'cedar-hintwise' ), $manage, 'post-new.php?post_type=' . Hintwise_Docs::TYPE );
		add_submenu_page( 'hintwise', __( 'Starter library', 'cedar-hintwise' ), __( 'Starter library', 'cedar-hintwise' ), $manage, 'hintwise-library', array( __CLASS__, 'render_library' ) );
		/**
		 * Fires after the Hintwise sub-menus are added (Pro adds its screens here).
		 */
		do_action( 'hintwise_admin_menu' );
		add_submenu_page( 'hintwise', __( 'Hintwise settings', 'cedar-hintwise' ), __( 'Settings', 'cedar-hintwise' ), $manage, 'hintwise-settings', array( __CLASS__, 'render_settings' ) );
	}

	/**
	 * Keep the menu open while editing guides.
	 *
	 * @param string $file Parent file.
	 * @return string
	 */
	public static function parent_file( $file ) {
		$screen = get_current_screen();
		if ( $screen && Hintwise_Docs::TYPE === $screen->post_type ) {
			return 'hintwise';
		}
		return $file;
	}

	/**
	 * Highlight the right sub-menu while editing guides.
	 *
	 * @param string|null $file Submenu file.
	 * @return string|null
	 */
	public static function submenu_file( $file ) {
		$screen = get_current_screen();
		if ( $screen && Hintwise_Docs::TYPE === $screen->post_type ) {
			return 'add' === $screen->action ? 'post-new.php?post_type=' . Hintwise_Docs::TYPE : 'edit.php?post_type=' . Hintwise_Docs::TYPE;
		}
		return $file;
	}

	/**
	 * Styles and scripts for Hintwise's own screens only: the Site Guide, the Starter library,
	 * Settings, the Pro screens and the guide list / editor. The help button and the Dashboard
	 * widget load their own small, scoped styles (see Hintwise_Panel and Hintwise_Dashboard).
	 *
	 * @param string $hook Hook suffix.
	 */
	public static function assets( $hook ) {
		wp_register_style( 'hintwise-admin', HINTWISE_URL . 'assets/css/admin.css', array(), HINTWISE_VERSION );
		if ( ! self::is_own_screen( $hook ) ) {
			return;
		}
		wp_enqueue_style( 'hintwise-admin' );
		$screen = get_current_screen();
		if ( $screen && Hintwise_Docs::TYPE === $screen->post_type && 'post' === $screen->base ) {
			wp_enqueue_script( 'hintwise-editor', HINTWISE_URL . 'assets/js/editor.js', array(), HINTWISE_VERSION, true );
		}
	}

	/**
	 * Whether the current admin screen is one of Hintwise's own.
	 *
	 * @param string $hook Hook suffix.
	 * @return bool
	 */
	public static function is_own_screen( $hook ) {
		$screen = get_current_screen();
		if ( $screen && Hintwise_Docs::TYPE === $screen->post_type ) {
			return true;
		}
		// toplevel_page_hintwise and {menu}_page_hintwise-* (library, settings, Pro screens).
		return 1 === preg_match( '/(^|_)page_hintwise(-[a-z0-9-]+)?$/', (string) $hook );
	}

	/* ---------------------------------------------------------------------
	 * Guide editor
	 * ------------------------------------------------------------------- */

	/**
	 * Meta boxes on the guide editor.
	 */
	public static function meta_boxes() {
		add_meta_box( 'hintwise-where', __( 'Where and for whom', 'cedar-hintwise' ), array( __CLASS__, 'render_where_box' ), Hintwise_Docs::TYPE, 'normal', 'high' );
	}

	/**
	 * "Where and for whom" box.
	 *
	 * @param WP_Post $post Guide.
	 */
	public static function render_where_box( $post ) {
		$roles    = Hintwise_Docs::roles( $post->ID );
		$screens  = Hintwise_Docs::screens( $post->ID );
		$required = (bool) get_post_meta( $post->ID, Hintwise_Docs::META_REQUIRED, true );
		$known    = array();
		wp_nonce_field( 'hintwise_doc', 'hintwise_doc_nonce' );
		?>
		<div class="hintwise-where">
			<div class="hintwise-where__col">
				<h4><?php esc_html_e( 'Show this guide on these screens', 'cedar-hintwise' ); ?></h4>
				<p class="description"><?php esc_html_e( 'The guide appears in the help button (and the Help tab) on the screens you tick. It is always in the Site Guide.', 'cedar-hintwise' ); ?></p>
				<input type="search" class="hintwise-filter" placeholder="<?php esc_attr_e( 'Filter screens…', 'cedar-hintwise' ); ?>" aria-label="<?php esc_attr_e( 'Filter screens', 'cedar-hintwise' ); ?>">
				<div class="hintwise-screen-list">
					<?php foreach ( Hintwise_Screens::choices() as $group => $items ) : ?>
						<?php if ( ! $items ) { continue; } ?>
						<fieldset>
							<legend><?php echo esc_html( $group ); ?></legend>
							<?php foreach ( $items as $key => $label ) : ?>
								<?php $known[] = $key; ?>
								<label><input type="checkbox" name="hintwise_screens[]" value="<?php echo esc_attr( $key ); ?>" <?php checked( in_array( $key, $screens, true ) ); ?>> <?php echo esc_html( $label ); ?></label>
							<?php endforeach; ?>
						</fieldset>
					<?php endforeach; ?>
				</div>
				<p>
					<label for="hintwise-custom-screens"><?php esc_html_e( 'Other screen IDs (advanced, comma separated)', 'cedar-hintwise' ); ?></label><br>
					<input type="text" class="widefat code" id="hintwise-custom-screens" name="hintwise_custom_screens" value="<?php echo esc_attr( implode( ', ', array_map( array( __CLASS__, 'short_key' ), array_diff( $screens, $known ) ) ) ); ?>" placeholder="toplevel_page_example">
				</p>
			</div>
			<div class="hintwise-where__col">
				<h4><?php esc_html_e( 'Who can read it', 'cedar-hintwise' ); ?></h4>
				<p class="description"><?php esc_html_e( 'Leave all unticked to show the guide to everyone who can log in to wp-admin.', 'cedar-hintwise' ); ?></p>
				<?php foreach ( wp_roles()->get_names() as $role => $name ) : ?>
					<label class="hintwise-block"><input type="checkbox" name="hintwise_roles[]" value="<?php echo esc_attr( $role ); ?>" <?php checked( in_array( $role, $roles, true ) ); ?>> <?php echo esc_html( translate_user_role( $name ) ); ?></label>
				<?php endforeach; ?>
				<h4><?php esc_html_e( 'Onboarding', 'cedar-hintwise' ); ?></h4>
				<?php if ( hintwise_is_pro() ) : ?>
					<label class="hintwise-block"><input type="checkbox" name="hintwise_required" value="1" <?php checked( $required ); ?>> <?php esc_html_e( 'Required reading: list it on the Dashboard checklist until each user has read it', 'cedar-hintwise' ); ?></label>
				<?php else : ?>
					<label class="hintwise-block hintwise-locked"><input type="checkbox" disabled> <?php esc_html_e( 'Required reading checklist and read tracking', 'cedar-hintwise' ); ?> <a class="hintwise-pro-badge" href="<?php echo esc_url( hintwise_upgrade_url() ); ?>"><?php esc_html_e( 'Pro', 'cedar-hintwise' ); ?></a></label>
				<?php endif; ?>
				<h4><?php esc_html_e( 'Placeholders', 'cedar-hintwise' ); ?></h4>
				<p class="description">
					<?php
					echo wp_kses(
						__( '<code>{{site}}</code> site name, <code>{{contact}}</code>, <code>{{email}}</code>, <code>{{phone}}</code> your contact details, and <code>{{admin:edit.php}}</code> as a link address for any wp-admin screen.', 'cedar-hintwise' ),
						array( 'code' => array() )
					);
					?>
				</p>
			</div>
		</div>
		<?php
	}

	/**
	 * Show "id:foo" as "foo" in the free-text field.
	 *
	 * @param string $key Key.
	 * @return string
	 */
	private static function short_key( $key ) {
		return 0 === strpos( $key, 'id:' ) ? substr( $key, 3 ) : $key;
	}

	/**
	 * Save the guide box.
	 *
	 * @param int     $post_id Guide ID.
	 * @param WP_Post $post    Guide.
	 */
	public static function save_doc( $post_id, $post ) {
		if ( ! isset( $_POST['hintwise_doc_nonce'] ) || ! wp_verify_nonce( sanitize_key( wp_unslash( $_POST['hintwise_doc_nonce'] ) ), 'hintwise_doc' ) ) {
			return;
		}
		if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || wp_is_post_revision( $post_id ) || ! current_user_can( 'edit_post', $post_id ) ) {
			return;
		}
		$screens = isset( $_POST['hintwise_screens'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['hintwise_screens'] ) ) : array();
		$custom  = isset( $_POST['hintwise_custom_screens'] ) ? sanitize_text_field( wp_unslash( $_POST['hintwise_custom_screens'] ) ) : '';
		foreach ( array_filter( array_map( 'trim', explode( ',', $custom ) ) ) as $c ) {
			$screens[] = preg_match( '/^(id|list|edit):/', $c ) ? $c : 'id:' . $c;
		}
		update_post_meta( $post_id, Hintwise_Docs::META_SCREENS, Hintwise_Docs::sanitize_list( $screens ) );

		$roles = isset( $_POST['hintwise_roles'] ) ? array_map( 'sanitize_key', wp_unslash( (array) $_POST['hintwise_roles'] ) ) : array();
		$roles = array_values( array_intersect( $roles, array_keys( wp_roles()->get_names() ) ) );
		update_post_meta( $post_id, Hintwise_Docs::META_ROLES, $roles );

		if ( hintwise_is_pro() ) {
			if ( ! empty( $_POST['hintwise_required'] ) ) {
				update_post_meta( $post_id, Hintwise_Docs::META_REQUIRED, 1 );
			} else {
				delete_post_meta( $post_id, Hintwise_Docs::META_REQUIRED );
			}
		}
	}

	/**
	 * Guide list columns.
	 *
	 * @param array $cols Columns.
	 * @return array
	 */
	public static function columns( $cols ) {
		$out = array();
		foreach ( $cols as $k => $v ) {
			$out[ $k ] = $v;
			if ( 'title' === $k ) {
				$out['hintwise_screens'] = __( 'Shown on', 'cedar-hintwise' );
				$out['hintwise_roles']   = __( 'Visible to', 'cedar-hintwise' );
			}
		}
		unset( $out['date'] );
		return $out;
	}

	/**
	 * Guide list column values.
	 *
	 * @param string $col     Column.
	 * @param int    $post_id Guide ID.
	 */
	public static function column( $col, $post_id ) {
		if ( 'hintwise_screens' === $col ) {
			$labels = array_map( array( 'Hintwise_Screens', 'label' ), Hintwise_Docs::screens( $post_id ) );
			echo $labels ? esc_html( implode( ', ', $labels ) ) : '<span aria-hidden="true">—</span>';
		} elseif ( 'hintwise_roles' === $col ) {
			$names = wp_roles()->get_names();
			$roles = array_map(
				function ( $r ) use ( $names ) {
					return isset( $names[ $r ] ) ? translate_user_role( $names[ $r ] ) : $r;
				},
				Hintwise_Docs::roles( $post_id )
			);
			echo esc_html( $roles ? implode( ', ', $roles ) : __( 'Everyone', 'cedar-hintwise' ) );
		}
	}

	/**
	 * "Read" link in the guide list.
	 *
	 * @param array   $actions Actions.
	 * @param WP_Post $post    Post.
	 * @return array
	 */
	public static function row_actions( $actions, $post ) {
		if ( Hintwise_Docs::TYPE === $post->post_type ) {
			unset( $actions['view'], $actions['inline hide-if-no-js'] );
			$actions['hintwise_read'] = '<a href="' . esc_url( Hintwise_Docs::url( $post->ID ) ) . '">' . esc_html__( 'Read', 'cedar-hintwise' ) . '</a>';
		}
		return $actions;
	}

	/* ---------------------------------------------------------------------
	 * Starter library
	 * ------------------------------------------------------------------- */

	/**
	 * Library screen.
	 */
	public static function render_library() {
		if ( ! Hintwise_Settings::can_manage() ) {
			return;
		}
		$installed = Hintwise_Library::installed();
		?>
		<div class="wrap hintwise-wrap">
			<h1><?php esc_html_e( 'Starter library', 'cedar-hintwise' ); ?></h1>
			<p class="hintwise-lead"><?php esc_html_e( 'Ready-made, plain-English guides for the everyday jobs on this site. Each one is linked to the screens it explains, adapts to your theme and plugins, and is yours to edit once added.', 'cedar-hintwise' ); ?></p>
			<?php Hintwise_WP_Help::render_box(); ?>
			<div class="hintwise-packs">
				<?php foreach ( Hintwise_Library::packs() as $id => $pack ) : ?>
					<?php
					$locked    = $pack['pro'] && ! hintwise_is_pro();
					$available = $pack['available'];
					$guides    = $available && ! $locked ? Hintwise_Library::guides( $id ) : array();
					if ( $locked && $available ) {
						foreach ( $pack['titles'] ?? array() as $i => $t ) {
							$guides[] = array(
								'id'    => $id . '/preview-' . $i,
								'title' => $t,
							);
						}
					}
					?>
					<form class="hintwise-pack<?php echo $available ? '' : ' is-unavailable'; ?>" method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
						<input type="hidden" name="action" value="hintwise_library">
						<input type="hidden" name="pack" value="<?php echo esc_attr( $id ); ?>">
						<?php wp_nonce_field( 'hintwise_library' ); ?>
						<h2>
							<?php echo esc_html( $pack['title'] ); ?>
							<?php if ( $pack['pro'] ) : ?>
								<span class="hintwise-pro-badge"><?php esc_html_e( 'Pro', 'cedar-hintwise' ); ?></span>
							<?php endif; ?>
						</h2>
						<p><?php echo esc_html( $pack['description'] ); ?></p>
						<?php if ( ! $available ) : ?>
							<p class="hintwise-muted"><?php echo esc_html( $pack['note'] ); ?></p>
						<?php else : ?>
							<ul class="hintwise-pack__guides">
								<?php foreach ( $guides as $g ) : ?>
									<?php $has = isset( $installed[ $g['id'] ] ); ?>
									<li>
										<?php if ( $has ) : ?>
											<span class="hintwise-pack__done"><?php echo esc_html( $g['title'] ); ?></span>
											<a class="hintwise-added" href="<?php echo esc_url( Hintwise_Docs::url( $installed[ $g['id'] ] ) ); ?>"><?php esc_html_e( 'Added', 'cedar-hintwise' ); ?></a>
										<?php elseif ( $locked ) : ?>
											<span class="hintwise-pack__locked"><?php echo esc_html( $g['title'] ); ?></span>
										<?php else : ?>
											<label>
												<input type="checkbox" name="guides[]" value="<?php echo esc_attr( $g['id'] ); ?>" checked>
												<?php echo esc_html( $g['title'] ); ?>
											</label>
										<?php endif; ?>
									</li>
								<?php endforeach; ?>
							</ul>
							<?php if ( $locked ) : ?>
								<a class="button button-primary" href="<?php echo esc_url( hintwise_upgrade_url() ); ?>"><?php esc_html_e( 'Unlock with Pro', 'cedar-hintwise' ); ?></a>
							<?php elseif ( count( array_intersect_key( $installed, array_flip( wp_list_pluck( $guides, 'id' ) ) ) ) < count( $guides ) ) : ?>
								<button type="submit" class="button button-primary"><?php esc_html_e( 'Add selected guides', 'cedar-hintwise' ); ?></button>
							<?php else : ?>
								<p class="hintwise-muted"><?php esc_html_e( 'All guides from this pack are in your handbook.', 'cedar-hintwise' ); ?></p>
							<?php endif; ?>
						<?php endif; ?>
					</form>
				<?php endforeach; ?>
			</div>
			<?php if ( ! hintwise_is_pro() ) : ?>
				<p class="hintwise-muted"><?php esc_html_e( 'Pro adds packs for SEO plugins, form plugins, Elementor and a site-care handover pack.', 'cedar-hintwise' ); ?> <a href="<?php echo esc_url( hintwise_upgrade_url() ); ?>"><?php esc_html_e( 'See Pro', 'cedar-hintwise' ); ?></a></p>
			<?php endif; ?>
		</div>
		<?php
	}

	/**
	 * Install guides from the library.
	 */
	public static function handle_library() {
		if ( ! Hintwise_Settings::can_manage() ) {
			wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'cedar-hintwise' ), 403 );
		}
		check_admin_referer( 'hintwise_library' );
		$pack   = isset( $_POST['pack'] ) ? sanitize_key( wp_unslash( $_POST['pack'] ) ) : '';
		$guides = isset( $_POST['guides'] ) ? array_map( 'sanitize_text_field', wp_unslash( (array) $_POST['guides'] ) ) : array();
		$msg    = 'none';
		if ( $guides ) {
			$r   = Hintwise_Library::install( $pack, $guides );
			$msg = is_wp_error( $r ) ? 'error' : 'added-' . (int) $r['created'];
		}
		wp_safe_redirect( add_query_arg( 'hintwise_msg', $msg, admin_url( 'admin.php?page=hintwise-library' ) ) );
		exit;
	}

	/* ---------------------------------------------------------------------
	 * Settings
	 * ------------------------------------------------------------------- */

	/**
	 * Settings screen.
	 */
	public static function render_settings() {
		if ( ! Hintwise_Settings::can_manage() ) {
			return;
		}
		$s   = Hintwise_Settings::get();
		$pro = hintwise_is_pro();
		?>
		<div class="wrap hintwise-wrap">
			<h1><?php esc_html_e( 'Hintwise settings', 'cedar-hintwise' ); ?></h1>
			<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
				<input type="hidden" name="action" value="hintwise_settings">
				<?php wp_nonce_field( 'hintwise_settings' ); ?>

				<h2 class="title"><?php esc_html_e( 'Handbook', 'cedar-hintwise' ); ?></h2>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row"><label for="hw-menu-label"><?php esc_html_e( 'Menu name', 'cedar-hintwise' ); ?></label></th>
						<td><input type="text" id="hw-menu-label" name="hintwise[menu_label]" value="<?php echo esc_attr( $s['menu_label'] ); ?>" class="regular-text" maxlength="40">
						<p class="description"><?php esc_html_e( 'What the handbook is called in the admin menu, e.g. “Site Guide”, “Help” or “How-to”.', 'cedar-hintwise' ); ?></p></td>
					</tr>
					<tr>
						<th scope="row"><label for="hw-welcome-title"><?php esc_html_e( 'Welcome message', 'cedar-hintwise' ); ?></label></th>
						<td><input type="text" id="hw-welcome-title" name="hintwise[welcome_title]" value="<?php echo esc_attr( $s['welcome_title'] ); ?>" class="regular-text"><br>
						<textarea name="hintwise[welcome_text]" rows="3" class="large-text" aria-label="<?php esc_attr_e( 'Welcome text', 'cedar-hintwise' ); ?>"><?php echo esc_textarea( $s['welcome_text'] ); ?></textarea>
						<p class="description"><?php esc_html_e( 'Shown at the top of the Site Guide and in the Dashboard widget.', 'cedar-hintwise' ); ?></p></td>
					</tr>
					<tr>
						<th scope="row"><?php esc_html_e( 'Where help appears', 'cedar-hintwise' ); ?></th>
						<td>
							<label class="hintwise-block"><input type="checkbox" name="hintwise[help_button]" value="1" <?php checked( $s['help_button'] ); ?>> <?php esc_html_e( 'Help button on admin screens (including the block editor)', 'cedar-hintwise' ); ?></label>
							<label class="hintwise-block"><?php esc_html_e( 'Button position:', 'cedar-hintwise' ); ?>
								<select name="hintwise[help_position]">
									<option value="right" <?php selected( $s['help_position'], 'right' ); ?>><?php esc_html_e( 'Bottom right', 'cedar-hintwise' ); ?></option>
									<option value="left" <?php selected( $s['help_position'], 'left' ); ?>><?php esc_html_e( 'Bottom left', 'cedar-hintwise' ); ?></option>
								</select>
							</label>
							<label class="hintwise-block"><input type="checkbox" name="hintwise[help_tabs]" value="1" <?php checked( $s['help_tabs'] ); ?>> <?php esc_html_e( 'Also add pinned guides to the “Help” tab at the top of classic screens', 'cedar-hintwise' ); ?></label>
							<label class="hintwise-block"><input type="checkbox" name="hintwise[dashboard_widget]" value="1" <?php checked( $s['dashboard_widget'] ); ?>> <?php esc_html_e( 'Dashboard widget with the welcome message, key guides and your contact details', 'cedar-hintwise' ); ?></label>
						</td>
					</tr>
				</table>

				<h2 class="title"><?php esc_html_e( 'Your contact details', 'cedar-hintwise' ); ?></h2>
				<p><?php esc_html_e( 'Shown on the Dashboard, in the help panel and under every guide, so people know who to ask.', 'cedar-hintwise' ); ?></p>
				<table class="form-table" role="presentation">
					<?php
					$fields = array(
						'contact_name'  => array( __( 'Name or company', 'cedar-hintwise' ), 'text', __( 'e.g. Northwind Web Studio', 'cedar-hintwise' ) ),
						'contact_email' => array( __( 'Support email', 'cedar-hintwise' ), 'email', 'support@example.com' ),
						'contact_phone' => array( __( 'Phone', 'cedar-hintwise' ), 'tel', '' ),
						'contact_url'   => array( __( 'Support page or booking link', 'cedar-hintwise' ), 'url', 'https://' ),
						'contact_hours' => array( __( 'Opening hours', 'cedar-hintwise' ), 'text', __( 'e.g. Mon–Fri, 9:00–17:00', 'cedar-hintwise' ) ),
					);
					foreach ( $fields as $key => $f ) :
						?>
						<tr>
							<th scope="row"><label for="hw-<?php echo esc_attr( $key ); ?>"><?php echo esc_html( $f[0] ); ?></label></th>
							<td><input type="<?php echo esc_attr( $f[1] ); ?>" id="hw-<?php echo esc_attr( $key ); ?>" name="hintwise[<?php echo esc_attr( $key ); ?>]" value="<?php echo esc_attr( $s[ $key ] ); ?>" class="regular-text" placeholder="<?php echo esc_attr( $f[2] ); ?>"></td>
						</tr>
					<?php endforeach; ?>
				</table>

				<?php
				/**
				 * Fires inside the settings form (Pro adds branding and sync settings).
				 *
				 * @param array $s Settings.
				 */
				do_action( 'hintwise_settings_fields', $s );
				?>

				<h2 class="title"><?php esc_html_e( 'Uninstall', 'cedar-hintwise' ); ?></h2>
				<table class="form-table" role="presentation">
					<tr>
						<th scope="row"><?php esc_html_e( 'Guides', 'cedar-hintwise' ); ?></th>
						<td><label><input type="checkbox" name="hintwise[delete_docs]" value="1" <?php checked( $s['delete_docs'] ); ?>> <?php esc_html_e( 'Delete all guides when the plugin is uninstalled', 'cedar-hintwise' ); ?></label>
						<p class="description"><?php esc_html_e( 'Off by default, so reinstalling brings your handbook back.', 'cedar-hintwise' ); ?></p></td>
					</tr>
				</table>
				<?php submit_button(); ?>
			</form>

			<hr>
			<h2 class="title"><?php esc_html_e( 'Move guides between sites', 'cedar-hintwise' ); ?></h2>
			<p><?php esc_html_e( 'Write your handbook once and reuse it on every client site: export it here and import it on the other site.', 'cedar-hintwise' ); ?></p>
			<div class="hintwise-transfer">
				<form method="post" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
					<input type="hidden" name="action" value="hintwise_export">
					<?php wp_nonce_field( 'hintwise_export' ); ?>
					<?php submit_button( __( 'Download guides (.json)', 'cedar-hintwise' ), 'secondary', 'submit', false ); ?>
				</form>
				<form method="post" enctype="multipart/form-data" action="<?php echo esc_url( admin_url( 'admin-post.php' ) ); ?>">
					<input type="hidden" name="action" value="hintwise_import">
					<?php wp_nonce_field( 'hintwise_import' ); ?>
					<label for="hw-import" class="screen-reader-text"><?php esc_html_e( 'Guides file', 'cedar-hintwise' ); ?></label>
					<input type="file" id="hw-import" name="hintwise_file" accept=".json,application/json" required>
					<?php submit_button( __( 'Import guides', 'cedar-hintwise' ), 'secondary', 'submit', false ); ?>
				</form>
			</div>
			<?php Hintwise_WP_Help::render_box( true ); ?>
			<?php if ( ! $pro ) : ?>
				<div class="hintwise-upsell">
					<h2><?php esc_html_e( 'Hintwise Pro', 'cedar-hintwise' ); ?></h2>
					<ul>
						<li><?php esc_html_e( 'Guided tours: click-through walkthroughs that point at the real buttons on any admin screen.', 'cedar-hintwise' ); ?></li>
						<li><?php esc_html_e( 'Library sync: keep one master handbook on your own site and have every client site update from it automatically.', 'cedar-hintwise' ); ?></li>
						<li><?php esc_html_e( 'Handover pack: a printable / PDF handbook with a cover page, site facts and your contact details.', 'cedar-hintwise' ); ?></li>
						<li><?php esc_html_e( 'Required reading and read tracking, with a checklist on the Dashboard and a report of who has read what.', 'cedar-hintwise' ); ?></li>
						<li><?php esc_html_e( 'Your branding: logo, color and menu icon, and no Hintwise credit.', 'cedar-hintwise' ); ?></li>
						<li><?php esc_html_e( 'More starter packs: SEO plugins, form plugins, Elementor, and a site-care handover pack.', 'cedar-hintwise' ); ?></li>
					</ul>
					<a class="button button-primary" href="<?php echo esc_url( hintwise_upgrade_url() ); ?>"><?php esc_html_e( 'Start the free 14-day trial', 'cedar-hintwise' ); ?></a>
				</div>
			<?php endif; ?>
		</div>
		<?php
	}

	/**
	 * Save settings.
	 */
	public static function handle_settings() {
		if ( ! Hintwise_Settings::can_manage() ) {
			wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'cedar-hintwise' ), 403 );
		}
		check_admin_referer( 'hintwise_settings' );
		Hintwise_Settings::save( self::settings_from_request() );
		wp_safe_redirect( add_query_arg( 'hintwise_msg', 'saved', admin_url( 'admin.php?page=hintwise-settings' ) ) );
		exit;
	}

	/**
	 * The posted settings form, sanitized before anything else sees it. Callers check the nonce.
	 *
	 * @return array Sanitized settings, ready to save.
	 */
	public static function settings_from_request() {
		// phpcs:disable WordPress.Security.NonceVerification.Missing, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Nonce checked by the caller; every field is sanitized by Hintwise_Settings::sanitize_input() in this same statement.
		$input = isset( $_POST['hintwise'] ) && is_array( $_POST['hintwise'] ) ? Hintwise_Settings::sanitize_input( wp_unslash( $_POST['hintwise'] ) ) : array();
		// phpcs:enable
		// Unticked checkboxes are not posted.
		foreach ( array( 'dashboard_widget', 'help_button', 'help_tabs', 'delete_docs' ) as $k ) {
			$input[ $k ] = ! empty( $input[ $k ] );
		}
		$settings = Hintwise_Settings::sanitize( array_merge( Hintwise_Settings::get(), $input ) );
		/**
		 * Filters the sanitized settings before they are saved (Pro handles its checkboxes and
		 * the sync key here). Whatever the filter returns is sanitized again.
		 *
		 * @param array $settings Sanitized settings.
		 * @param array $input    The sanitized form input.
		 */
		return Hintwise_Settings::sanitize( (array) apply_filters( 'hintwise_settings_input', $settings, $input ) );
	}

	/**
	 * Download the guides as JSON.
	 */
	public static function handle_export() {
		if ( ! Hintwise_Settings::can_manage() ) {
			wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'cedar-hintwise' ), 403 );
		}
		check_admin_referer( 'hintwise_export' );
		$name = 'hintwise-guides-' . sanitize_title( wp_parse_url( home_url(), PHP_URL_HOST ) ) . '-' . gmdate( 'Y-m-d' ) . '.json';
		nocache_headers();
		header( 'Content-Type: application/json; charset=utf-8' );
		header( 'Content-Disposition: attachment; filename="' . $name . '"' );
		echo wp_json_encode( Hintwise_Transfer::export(), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );
		exit;
	}

	/**
	 * Import guides from an uploaded JSON file.
	 */
	public static function handle_import() {
		if ( ! Hintwise_Settings::can_manage() ) {
			wp_die( esc_html__( 'Sorry, you are not allowed to do that.', 'cedar-hintwise' ), 403 );
		}
		check_admin_referer( 'hintwise_import' );
		$msg = 'import-error';
		if ( isset( $_FILES['hintwise_file']['tmp_name'] ) && is_uploaded_file( sanitize_text_field( $_FILES['hintwise_file']['tmp_name'] ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotValidated
			$json = file_get_contents( sanitize_text_field( $_FILES['hintwise_file']['tmp_name'] ) ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
			$r    = Hintwise_Transfer::import( json_decode( (string) $json, true ) );
			if ( ! is_wp_error( $r ) ) {
				$msg = 'imported-' . (int) $r['created'];
			}
		}
		wp_safe_redirect( add_query_arg( 'hintwise_msg', $msg, admin_url( 'admin.php?page=hintwise-settings' ) ) );
		exit;
	}

	/**
	 * Result notices after our forms.
	 */
	public static function notices() {
		$screen = get_current_screen();
		if ( ! $screen || false === strpos( $screen->id, 'hintwise' ) || ! isset( $_GET['hintwise_msg'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
			return;
		}
		$msg  = sanitize_key( wp_unslash( $_GET['hintwise_msg'] ) ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$type = 'success';
		if ( 'saved' === $msg ) {
			$text = __( 'Settings saved.', 'cedar-hintwise' );
		} elseif ( preg_match( '/^added-(\d+)$/', $msg, $m ) ) {
			/* translators: %d: number of guides */
			$text = sprintf( _n( '%d guide added to your handbook. Open the Site Guide to read it, or edit it under All guides.', '%d guides added to your handbook. Open the Site Guide to read them, or edit them under All guides.', (int) $m[1], 'cedar-hintwise' ), (int) $m[1] );
		} elseif ( preg_match( '/^imported-(\d+)$/', $msg, $m ) ) {
			/* translators: %d: number of guides */
			$text = sprintf( _n( '%d guide imported.', '%d guides imported.', (int) $m[1], 'cedar-hintwise' ), (int) $m[1] );
		} elseif ( 'import-error' === $msg ) {
			$text = __( 'That file could not be imported. Choose a .json file exported by Hintwise.', 'cedar-hintwise' );
			$type = 'error';
		} elseif ( 'none' === $msg ) {
			$text = __( 'Tick at least one guide to add.', 'cedar-hintwise' );
			$type = 'warning';
		} else {
			/**
			 * Filters the text of a Hintwise result notice (Pro messages).
			 *
			 * @param string $text Text.
			 * @param string $msg  Message key.
			 */
			$text = (string) apply_filters( 'hintwise_notice_text', '', $msg );
			if ( '' === $text ) {
				return;
			}
		}
		printf( '<div class="notice notice-%1$s is-dismissible"><p>%2$s</p></div>', esc_attr( $type ), esc_html( $text ) );
	}

	/**
	 * Plugin list links.
	 *
	 * @param array $links Links.
	 * @return array
	 */
	public static function action_links( $links ) {
		array_unshift( $links, '<a href="' . esc_url( admin_url( 'admin.php?page=hintwise-library' ) ) . '">' . esc_html__( 'Get started', 'cedar-hintwise' ) . '</a>' );
		if ( ! hintwise_is_pro() ) {
			$links[] = '<a href="' . esc_url( hintwise_upgrade_url() ) . '" style="color:#2f6b4f;font-weight:600">' . esc_html__( 'Go Pro', 'cedar-hintwise' ) . '</a>';
		}
		return $links;
	}
}