<?php
/**
 * The official texts the plugin shows, and their versions.
 *
 * @package Careback
 */

namespace Careback;

defined( 'ABSPATH' ) || exit;

/**
 * Which version of each official text of the European Union the plugin ships,
 * in one place: the model withdrawal form of Directive 2011/83/EU, Annex I(B)
 * (N-114), and the harmonised notice on the legal guarantee of Commission
 * Implementing Regulation (EU) 2025/1960 (N-115). Settings and Setup name the
 * version beside each text with a link to check EUR-Lex for later changes, the
 * support report lists them (N-125), and the readme's "Official texts and their
 * versions" says the same (a check holds all three to this list).
 */
class Official_Texts {

	/**
	 * Each text: its act, its dates (Y-m-d) and where to read it on EUR-Lex.
	 * model_form: the directive's number and the date of the consolidated
	 * version followed. legal_guarantee: the regulation's number, the day it was
	 * adopted, its publication in the Official Journal (L series), the day it
	 * applies from.
	 */
	const TEXTS = array(
		'model_form'      => array(
			'act'          => '2011/83/EU',
			'consolidated' => '2026-09-27',
			'url'          => 'https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:02011L0083-20260927',
		),
		'legal_guarantee' => array(
			'act'       => '2025/1960',
			'adopted'   => '2025-09-25',
			'published' => '2025-10-02',
			'applies'   => '2026-09-27',
			'url'       => 'https://eur-lex.europa.eu/legal-content/EN/TXT/HTML/?uri=CELEX:32025R1960',
		),
	);

	/** The acknowledgement of the source the EU's reuse rules ask for. */
	const SOURCE = '© European Union, https://eur-lex.europa.eu/';

	/**
	 * One date of the list, as a day (25 September 2025) or as the Official
	 * Journal writes it (2.10.2025); month names in the language of the screen
	 * unless $english.
	 *
	 * @param string $ymd     The date, Y-m-d.
	 * @param string $format  'day' or 'journal'.
	 * @param bool   $english In English whatever the language of the screen.
	 * @return string
	 */
	private static function date( $ymd, $format, $english ) {
		$time = strtotime( $ymd . ' 00:00:00 UTC' );

		if ( 'journal' === $format ) {
			return gmdate( 'j.n.Y', $time );
		}

		if ( $english ) {
			return gmdate( 'j F Y', $time );
		}

		/* translators: a PHP date() format for a full date (25 September 2025): keep the letters, set the order, words and separators of your language. */
		return (string) wp_date( _x( 'j F Y', 'full date format (PHP date())', 'careback' ), $time, new \DateTimeZone( 'UTC' ) );
	}

	/**
	 * Which version of the text the plugin shows, as one sentence; in English
	 * (the support report, the readme) or in the language of the screen.
	 *
	 * @param string $key     model_form or legal_guarantee.
	 * @param bool   $english In English whatever the language of the screen.
	 * @return string '' for a text not on the list.
	 */
	public static function version( $key, $english = false ) {
		if ( ! isset( self::TEXTS[ $key ] ) ) {
			return '';
		}

		$text = self::TEXTS[ $key ];

		if ( 'model_form' === $key ) {
			if ( $english ) {
				$sentence = 'Annex I(B) of Directive %1$s, consolidated version of %2$s.';
			} else {
				/* translators: 1: number of the directive, 2011/83/EU; 2: date of the consolidated version followed. */
				$sentence = __( 'Annex I(B) of Directive %1$s, consolidated version of %2$s.', 'careback' );
			}

			return sprintf( $sentence, $text['act'], self::date( $text['consolidated'], 'day', $english ) );
		}

		if ( $english ) {
			$sentence = 'Official notice from Commission Implementing Regulation (EU) %1$s of %2$s (OJ L, %3$s), applies from %4$s.';
		} else {
			/* translators: 1: number of the regulation, 2025/1960; 2: date it was adopted; 3: date of its publication in the Official Journal, such as 2.10.2025; 4: date it applies from. */
			$sentence = __( 'Official notice from Commission Implementing Regulation (EU) %1$s of %2$s (OJ L, %3$s), applies from %4$s.', 'careback' );
		}

		return sprintf( $sentence, $text['act'], self::date( $text['adopted'], 'day', $english ), self::date( $text['published'], 'journal', $english ), self::date( $text['applies'], 'day', $english ) );
	}

	/**
	 * The version line under a setting or a readiness item: the sentence and
	 * the link to check EUR-Lex for later changes, in a new tab.
	 *
	 * @param string $key model_form or legal_guarantee.
	 * @return void
	 */
	public static function render_version( $key ) {
		if ( ! isset( self::TEXTS[ $key ] ) ) {
			return;
		}
		?>
		<p class="description careback-official-version">
			<?php echo esc_html( self::version( $key ) ); ?>
			<a href="<?php echo esc_url( self::TEXTS[ $key ]['url'] ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Check EUR-Lex for later changes', 'careback' ); ?><span class="screen-reader-text"> <?php esc_html_e( '(opens in a new tab)', 'careback' ); ?></span></a>
		</p>
		<?php
	}

	/**
	 * The row under the statutory withdrawal switch on Settings, while it is on:
	 * the two official texts, the shortcode of each and its version.
	 *
	 * @return void
	 */
	public static function render_settings_row() {
		?>
		<tr class="careback-official-texts-row">
			<th scope="row"><?php esc_html_e( 'Official texts', 'careback' ); ?></th>
			<td>
				<p>
					<strong><?php esc_html_e( 'Model withdrawal form', 'careback' ); ?></strong> —
					<?php
					/* translators: %s: the shortcode, [careback_withdrawal_form]. */
					echo wp_kses( sprintf( __( 'shortcode %s for your terms page. It is also linked under the returns form.', 'careback' ), '<code>[' . Model_Form::SHORTCODE . ']</code>' ), array( 'code' => array() ) );
					?>
				</p>
				<?php self::render_version( 'model_form' ); ?>
				<p>
					<strong><?php esc_html_e( 'Legal guarantee notice', 'careback' ); ?></strong> —
					<?php
					/* translators: %s: the shortcode, [careback_legal_guarantee]. */
					echo wp_kses( sprintf( __( 'shortcode %s for the pages customers read before they buy: product, checkout or terms pages, or your footer.', 'careback' ), '<code>[' . Legal_Guarantee::SHORTCODE . ']</code>' ), array( 'code' => array() ) );
					?>
				</p>
				<?php self::render_version( 'legal_guarantee' ); ?>
			</td>
		</tr>
		<?php
	}

	/**
	 * The lines of the support report (N-125), in English: each text, whether
	 * customers can be shown it, its version and its source.
	 *
	 * @param Settings $settings Plugin settings.
	 * @return string[]
	 */
	public static function report_lines( Settings $settings ) {
		$hidden = Routes::withdrawal_offered( $settings ) ? 'hidden (WooCommerce not active)' : 'hidden (statutory withdrawal off)';

		return array(
			'Model withdrawal form [' . Model_Form::SHORTCODE . ']: ' . ( Model_Form::offered( $settings ) ? 'shown' : $hidden ) . '; ' . self::version( 'model_form', true ) . ' ' . self::TEXTS['model_form']['url'],
			'Legal guarantee notice [' . Legal_Guarantee::SHORTCODE . ']: ' . ( Legal_Guarantee::offered( $settings ) ? 'shown' : $hidden ) . ( Legal_Guarantee::placed() ? ', on a published page' : ', not found on a published page' ) . '; ' . self::version( 'legal_guarantee', true ) . ' ' . self::TEXTS['legal_guarantee']['url'],
		);
	}
}