<?php
/**
 * Two sections of the Settings tab: when the periods start (N-76) and deleting
 * the plugin (N-104).
 *
 * @package Careback
 */

namespace Careback;

defined( 'ABSPATH' ) || exit;

/**
 * "When the periods start", the first section of Deadlines and reminders: the
 * order status that means delivered, the delivery buffer and an example with
 * real dates. "Deleting the plugin", the last of Safeguards: the box that has
 * deleting the plugin delete all its data too, with what goes and what always
 * stays. Registered through the screen's own hooks (`careback_settings_sections`,
 * `careback_save_settings`), so an add-on adds a row to either the same way
 * (`careback_settings_fields`).
 */
class Admin_Sections {

	/** The query argument that names the fields a save refused. */
	const INVALID_ARG = 'careback_invalid';

	/**
	 * Fields the last save refused, in this request.
	 *
	 * @var string[]
	 */
	private static $invalid = array();

	/**
	 * Hooks the sections and their save.
	 *
	 * @return void
	 */
	public static function init() {
		add_filter( Admin::SECTIONS_FILTER, array( __CLASS__, 'sections' ) );
		add_filter( Admin::SAVE_FILTER, array( __CLASS__, 'save' ), 10, 4 );
	}

	/**
	 * Adds the two sections, each in its place.
	 *
	 * @param array $sections Section key => group, label, position, render.
	 * @return array
	 */
	public static function sections( $sections ) {
		$sections = (array) $sections;

		$sections['periods'] = array(
			'tab'      => 'timing',
			'label'    => __( 'When the periods start', 'careback' ),
			'position' => 5,
			'render'   => array( __CLASS__, 'render_periods' ),
		);

		$sections['deleting'] = array(
			'tab'      => 'safeguards',
			'label'    => __( 'Deleting the plugin', 'careback' ),
			'position' => 90,
			'render'   => array( __CLASS__, 'render_deleting' ),
		);

		return $sections;
	}

	/**
	 * The fields of the last save that were refused (their stored value kept).
	 *
	 * @return string[]
	 */
	public static function invalid_fields() {
		return self::$invalid;
	}

	/**
	 * The values of the two sections, from the returns form. A status that is
	 * not one to choose and a buffer outside 0–30 are refused: the stored value
	 * stays and the field says why.
	 *
	 * @param array         $values   Values the form stores.
	 * @param string        $screen   Id of the screen saving (Admin::SCREEN).
	 * @param Settings|null $settings The screen's settings.
	 * @param array         $posted   The posted form (Admin::save(), after its capability and nonce checks).
	 * @return array
	 */
	public static function save( $values, $screen = '', $settings = null, $posted = array() ) {
		$values = (array) $values;
		$posted = (array) $posted;

		if ( Admin::SCREEN !== $screen ) {
			return $values;
		}

		unset( $settings );
		self::$invalid = array();

		$values['delete_data_on_uninstall'] = empty( $posted['delete_data_on_uninstall'] ) ? 0 : 1;

		if ( isset( $posted['delivered_status'] ) && is_scalar( $posted['delivered_status'] ) ) {
			$status = sanitize_key( $posted['delivered_status'] );

			if ( isset( Periods::choices()[ $status ] ) ) {
				$values['delivered_status'] = $status;
			}
		}

		if ( isset( $posted['delivery_buffer_days'] ) && is_scalar( $posted['delivery_buffer_days'] ) ) {
			$buffer = trim( sanitize_text_field( $posted['delivery_buffer_days'] ) );

			if ( '' !== $buffer && ctype_digit( $buffer ) && (int) $buffer <= Periods::BUFFER_MAX ) {
				$values['delivery_buffer_days'] = (int) $buffer;
			} else {
				self::$invalid[] = 'delivery_buffer_days';
			}
		}

		return $values;
	}

	/**
	 * True when the save before this screen refused the field.
	 *
	 * @param string $field Field name.
	 * @return bool
	 */
	private static function refused( $field ) {
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- display only: the result of the redirect after a save; nothing is changed.
		$raw = isset( $_GET[ self::INVALID_ARG ] ) && is_scalar( $_GET[ self::INVALID_ARG ] ) ? sanitize_text_field( wp_unslash( $_GET[ self::INVALID_ARG ] ) ) : '';

		return in_array( $field, explode( ',', $raw ), true );
	}

	/**
	 * When the periods start: the explanation, the status, the buffer, the
	 * example.
	 *
	 * @param array         $s        Stored settings.
	 * @param string        $screen   Id of the screen printing it.
	 * @param Settings|null $settings The settings that screen prints.
	 */
	public static function render_periods( array $s, $screen = '', $settings = null ) {
		unset( $screen );
		$settings = $settings instanceof Settings ? $settings : new Settings();
		$status   = Periods::delivered_status( $settings );
		$buffer   = Periods::buffer_days( $settings );
		$choices  = Periods::choices();
		$refused  = self::refused( 'delivery_buffer_days' );
		$example  = self::example( $settings, $choices );
		?>
		<p class="description"><?php esc_html_e( 'The periods for withdrawal and return count from delivery. When a delivery service or another plugin records the delivery date on the order, that date counts. Otherwise the periods count from the day the order got the status below.', 'careback' ); ?></p>
		<table class="form-table" role="presentation">
			<tr>
				<th scope="row"><label for="careback-delivered-status"><?php esc_html_e( 'Order status that means delivered', 'careback' ); ?></label></th>
				<td>
					<select id="careback-delivered-status" name="delivered_status"<?php echo 'completed' !== $status ? ' aria-describedby="careback-delivered-status-note"' : ''; ?>>
						<?php foreach ( $choices as $slug => $label ) : ?>
							<option value="<?php echo esc_attr( $slug ); ?>" <?php selected( $status, $slug ); ?>><?php echo esc_html( $label ); ?></option>
						<?php endforeach; ?>
					</select>
					<?php Admin_Tip::render( __( 'Completed unless your shop sets another status when the parcel arrives, for example one a shipping plugin adds. Requests can always be filed from this status.', 'careback' ) ); ?>
					<?php if ( 'completed' !== $status ) : ?>
						<p class="careback-inline-warning" id="careback-delivered-status-note"><?php esc_html_e( 'WooCommerce does not keep the date an order got this status. Careback records it from now on. For orders that already have it, the periods count from the day the order was last changed.', 'careback' ); ?></p>
					<?php endif; ?>
				</td>
			</tr>
			<tr>
				<th scope="row"><label for="careback-delivery-buffer"><?php esc_html_e( 'Delivery buffer (days)', 'careback' ); ?></label></th>
				<td>
					<input id="careback-delivery-buffer" type="number" min="0" max="<?php echo esc_attr( (string) Periods::BUFFER_MAX ); ?>" step="1" name="delivery_buffer_days" value="<?php echo esc_attr( (string) $buffer ); ?>"<?php echo $refused ? ' aria-invalid="true" aria-describedby="careback-delivery-buffer-error careback-delivery-buffer-help"' : ' aria-describedby="careback-delivery-buffer-help"'; ?> class="small-text" />
					<?php if ( $refused ) : ?>
						<span class="careback-field-error" id="careback-delivery-buffer-error" role="alert"><?php esc_html_e( 'Enter a whole number from 0 to 30.', 'careback' ); ?></span>
					<?php endif; ?>
					<p class="description" id="careback-delivery-buffer-help"><?php esc_html_e( 'Added to the status date, for shops that set this status when they ship. Not added to a recorded delivery date.', 'careback' ); ?></p>
					<p class="careback-example" id="careback-periods-example" aria-live="polite" data-template="<?php echo esc_attr( $example['template'] ); ?>" data-dates="<?php echo esc_attr( (string) wp_json_encode( $example['dates'] ) ); ?>"><?php echo esc_html( $example['text'] ); ?></p>
				</td>
			</tr>
			<?php Admin::print_fields( 'periods', array(), $s, Admin::SCREEN, $settings ); ?>
		</table>
		<?php
	}

	/**
	 * The example under the buffer: its sentence for the stored values, its
	 * template and the dates for every buffer, so the script redraws it as the
	 * fields change; without a script it shows the stored values.
	 *
	 * @param Settings             $settings Plugin settings.
	 * @param array<string,string> $choices  Status slug => label.
	 * @return array{text:string,template:string,dates:array}
	 */
	private static function example( Settings $settings, array $choices ) {
		$status    = Periods::delivered_status( $settings );
		$label     = isset( $choices[ $status ] ) ? $choices[ $status ] : $status;
		$statutory = (int) $settings->get( 'statutory_window_days', 14 );
		$return    = (int) $settings->get( 'return_window_days', 30 );
		$now       = time();
		$day       = static function ( $offset ) use ( $now ) {
			/* translators: a PHP date() format for a day and month (29 October): keep the letters, set the order and separators of your language. */
			return (string) wp_date( _x( 'j F', 'day and month format (PHP date())', 'careback' ), $now + (int) $offset * DAY_IN_SECONDS );
		};

		if ( Routes::withdrawal_offered( $settings ) ) {
			/* translators: 1: an order status, such as "Completed", 2: the day the periods start, 3: the last day of the withdrawal, 4: the last day of the return. */
			$template = __( 'Example: an order marked %1$s today → the periods start on %2$s; withdrawal is possible until %3$s, return until %4$s.', 'careback' );
		} else {
			/* translators: 1: an order status, such as "Completed", 2: the day the return period starts, 3: its last day. */
			$template = __( 'Example: an order marked %1$s today → the return period starts on %2$s and ends on %3$s.', 'careback' );
		}

		$dates = array();

		for ( $buffer = 0; $buffer <= Periods::BUFFER_MAX; $buffer++ ) {
			$dates[] = Routes::withdrawal_offered( $settings )
				? array( $day( $buffer ), $day( $buffer + $statutory ), $day( $buffer + $return ) )
				: array( $day( $buffer ), $day( $buffer + $return ) );
		}

		$current = $dates[ Periods::buffer_days( $settings ) ];

		return array(
			'text'     => vsprintf( $template, array_merge( array( $label ), $current ) ),
			'template' => $template,
			'dates'    => $dates,
		);
	}

	/**
	 * Deleting the plugin: the box, what goes, what always stays, and when
	 * nothing goes.
	 *
	 * @param array         $s        Stored settings.
	 * @param string        $screen   Id of the screen printing it.
	 * @param Settings|null $settings The settings that screen prints.
	 */
	public static function render_deleting( array $s, $screen = '', $settings = null ) {
		unset( $screen );
		$settings   = $settings instanceof Settings ? $settings : new Settings();
		$ticked     = ! empty( $settings->get( 'delete_data_on_uninstall', 0 ) );
		$dependents = Data_Eraser::dependents();
		$in_config  = defined( 'CAREBACK_HASH_KEY' ) && CAREBACK_HASH_KEY;
		?>
		<table class="form-table" role="presentation">
			<tr>
				<th scope="row"><?php esc_html_e( 'Your data', 'careback' ); ?></th>
				<td>
					<label><input type="checkbox" id="careback-delete-data" name="delete_data_on_uninstall" value="1" <?php checked( $ticked ); ?>/> <?php esc_html_e( 'Delete all Careback data when the plugin is deleted', 'careback' ); ?></label>
					<div class="careback-panel is-danger" id="careback-delete-data-warning">
						<p><strong><?php esc_html_e( 'This cannot be undone.', 'careback' ); ?></strong> <?php esc_html_e( 'If you may need the requests later, make a backup of your database before you delete the plugin.', 'careback' ); ?></p>
					</div>
					<p><strong><?php esc_html_e( 'Deleted when you delete the plugin:', 'careback' ); ?></strong></p>
					<ul class="careback-list-plain">
						<li><?php esc_html_e( 'all requests, with their history, and the security log;', 'careback' ); ?></li>
						<li><?php esc_html_e( 'Careback\'s settings, including those of its emails in WooCommerce → Settings → Emails;', 'careback' ); ?></li>
						<li><?php echo $in_config ? esc_html__( 'the key behind the email fingerprints (unless it is set in wp-config.php);', 'careback' ) : esc_html__( 'the key behind the email fingerprints;', 'careback' ); ?></li>
						<li><?php esc_html_e( 'the delivery dates and tracking numbers Careback saved on orders;', 'careback' ); ?></li>
						<li><?php esc_html_e( 'its scheduled tasks and temporary data.', 'careback' ); ?></li>
					</ul>
					<p><strong><?php esc_html_e( 'Always kept:', 'careback' ); ?></strong> <?php esc_html_e( 'your WooCommerce orders and their notes, including the notes Careback added.', 'careback' ); ?></p>
					<p class="description"><?php esc_html_e( 'Deactivating Careback deletes nothing. While another plugin that needs Careback is installed, deleting Careback keeps its data and settings. With this box unticked, deleting the plugin removes its settings and scheduled tasks and keeps the requests, the security log and the key, so a later install finds them again.', 'careback' ); ?></p>
					<?php foreach ( $dependents as $name ) : ?>
						<p class="careback-inline-warning">
							<?php
							/* translators: %1$s: name of an installed plugin that needs Careback. */
							echo esc_html( sprintf( __( '%1$s needs Careback and is installed, so deleting Careback now keeps all its data and settings. Delete %1$s first.', 'careback' ), $name ) );
							?>
						</p>
					<?php endforeach; ?>
				</td>
			</tr>
			<?php Admin::print_fields( 'deleting', array(), $s, Admin::SCREEN, $settings ); ?>
		</table>
		<?php
	}
}