%3$s

<?php

namespace WPMailSMTP\Admin\Recommendations;

use WPMailSMTP\PartnerPlugins\PartnerPlugin;
use WPMailSMTP\WP;

/**
 * Abstract recommended-plugins landing page.
 *
 * Renders a 3-step Install -> Setup -> Result landing page for a single
 * recommended product, handles the per-product status-check AJAX, and records
 * install attribution.
 *
 * @since 4.9.0
 */
abstract class PageAbstract {

	/**
	 * Admin menu page slug.
	 *
	 * @since 4.9.0
	 *
	 * @var string
	 */
	public const SLUG = '';

	/**
	 * Configuration. Page-specific links only.
	 *
	 * @since 4.9.0
	 *
	 * @var array
	 */
	protected $config = [];

	/**
	 * The plugin this page promotes.
	 *
	 * @since 4.10.0
	 *
	 * @var PartnerPlugin
	 */
	private $plugin;

	/**
	 * Runtime data used for generating page HTML.
	 *
	 * @since 4.9.0
	 *
	 * @var array
	 */
	protected $output_data = [];

	/**
	 * Constructor.
	 *
	 * @since 4.9.0
	 */
	public function __construct() {

		if ( ! current_user_can( wp_mail_smtp()->get_capability_manage_options() ) ) {
			return;
		}

		$this->hooks();
	}

	/**
	 * Hooks.
	 *
	 * @since 4.9.0
	 */
	public function hooks(): void {

		$plugin = static::get_plugin_name();

		if ( wp_doing_ajax() ) {
			add_action( "wp_ajax_wp_mail_smtp_page_check_{$plugin}_status", [ $this, 'ajax_check_plugin_status' ] );
			add_action( 'activated_plugin', [ $this, 'plugin_activated' ] );
		}

		// Check what page we are on.
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		$page = isset( $_GET['page'] ) ? sanitize_key( $_GET['page'] ) : '';

		// Only load if we are actually on the correct page.
		if ( $page !== static::SLUG ) {
			return;
		}

		add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
	}

	/**
	 * Enqueue JS and CSS files.
	 *
	 * @since 4.9.0
	 */
	public function enqueue_assets(): void {

		$min = WP::asset_min();

		// Lity (registered by Admin\Area).
		wp_enqueue_style( 'wp-mail-smtp-admin-lity' );
		wp_enqueue_script( 'wp-mail-smtp-admin-lity' );

		// Custom styles for Lity image size limitation.
		wp_add_inline_style(
			'wp-mail-smtp-admin-lity',
			'
			.lity-image .lity-container {
				max-width: 1040px !important;
			}
			.lity-image img {
				max-width: 1040px !important;
				width: 100%;
				height: auto;
			}
			'
		);

		wp_enqueue_script(
			'wp-mail-smtp-admin-recommendations-' . static::get_plugin_name(),
			wp_mail_smtp()->assets_url . "/js/smtp-recommendations{$min}.js",
			[ 'jquery', 'wp-mail-smtp-admin' ],
			WPMS_PLUGIN_VER,
			true
		);

		wp_localize_script(
			'wp-mail-smtp-admin-recommendations-' . static::get_plugin_name(),
			'wp_mail_smtp_recommendations',
			[ 'plugin_page' => $this->get_js_strings() ]
		);
	}

	/**
	 * Generate and output page HTML.
	 *
	 * @since 4.9.0
	 */
	public function output(): void {

		echo '<div id="wp-mail-smtp-admin-' . esc_attr( static::get_plugin_name() ) . '" class="wp-mail-smtp-plugin-recommendation-page">';

		$this->output_section_heading();
		$this->output_section_screenshot();
		$this->output_section_footer();
		$this->output_section_step_install();
		$this->output_section_step_setup();
		$this->output_section_step_result();

		echo '</div>';
	}

	/**
	 * Generate and output step 'Install' section HTML.
	 *
	 * @since 4.9.0
	 *
	 * @noinspection HtmlUnknownTarget
	 */
	protected function output_section_step_install(): void {

		$step = $this->get_data_step_install();

		if ( empty( $step ) ) {
			return;
		}

		$button_format       = '<button class="button %3$s" data-plugin="%1$s" data-action="%4$s" data-provider="%5$s">%2$s</button>';
		$button_allowed_html = [
			'button' => [
				'class'         => true,
				'data-plugin'   => true,
				'data-action'   => true,
				'data-provider' => true,
			],
		];

		$is_url      = (bool) preg_match( '#^https?://#i', (string) $step['plugin'] );
		$plugin_attr = $is_url ? esc_url( $step['plugin'] ) : esc_attr( $step['plugin'] );
		$button      = sprintf( $button_format, $plugin_attr, esc_html( $step['button_text'] ), esc_attr( $step['button_class'] ), esc_attr( $step['button_action'] ), esc_attr( static::get_plugin_name() ) );

		printf(
			'<section class="step step-install">
				<aside class="num">
					<img src="%1$s" alt="%2$s" />
					<i class="loader hidden"></i>
				</aside>
				<div>
					<h2>%3$s</h2>
					<p>%4$s</p>
					%5$s
				</div>
			</section>',
			esc_url( wp_mail_smtp()->assets_url . '/images/recommendations/' . $step['icon'] ),
			esc_attr__( 'Step 1', 'wp-mail-smtp' ),
			esc_html( $step['heading'] ),
			esc_html( $step['description'] ),
			wp_kses( $button, $button_allowed_html )
		);
	}

	/**
	 * Generate and output step 'Setup' section HTML.
	 *
	 * @since 4.9.0
	 *
	 * @noinspection HtmlUnknownTarget
	 */
	protected function output_section_step_setup(): void {

		$step = $this->get_data_step_setup();

		if ( empty( $step ) ) {
			return;
		}

		printf(
			'<section class="step step-setup %1$s">
				<aside class="num">
					<img src="%2$s" alt="%3$s" />
					<i class="loader hidden"></i>
				</aside>
				<div>
					<h2>%4$s</h2>
					<p>%5$s</p>
					<button class="button %6$s" data-url="%7$s">%8$s</button>
				</div>
			</section>',
			esc_attr( $step['section_class'] ),
			esc_url( wp_mail_smtp()->assets_url . '/images/recommendations/' . $step['icon'] ),
			esc_attr__( 'Step 2', 'wp-mail-smtp' ),
			esc_html( $step['heading'] ),
			esc_html( $step['description'] ),
			esc_attr( $step['button_class'] ),
			esc_url( $this->get_plugin()->get_setup_url() ),
			esc_html( $step['button_text'] )
		);
	}

	/**
	 * Generate and output footer section HTML.
	 *
	 * @since 4.9.0
	 */
	protected function output_section_footer(): void {
		// Default implementation - can be overridden by child classes.
	}

	/**
	 * Step 'Install' data.
	 *
	 * @since 4.9.0
	 *
	 * @return array Step data.
	 */
	protected function get_data_step_install(): array {

		$plugin = $this->get_plugin();

		$step                    = [];
		$step['heading']         = $this->get_install_heading();
		$step['description']     = $this->get_install_description();

		$this->output_data['plugin_installed']     = $plugin->is_installed();
		$this->output_data['plugin_activated']     = false;
		$this->output_data['pro_plugin_installed'] = $plugin->is_pro_installed();
		$this->output_data['pro_plugin_activated'] = false;

		if ( $plugin->get_install_state() === PartnerPlugin::STATE_NOT_INSTALLED ) {
			$step['icon']          = 'plugin-page/step-1.svg';
			$step['button_text']   = $this->get_install_button_text();
			$step['button_class']  = 'button-primary';
			$step['button_action'] = 'install';
			$step['plugin']        = $plugin->get_download_url();

			return $step;
		}

		$this->output_data['plugin_activated'] = $plugin->is_active();

		$is_offered = ! $this->output_data['plugin_activated'];

		$step['icon']          = $this->output_data['plugin_activated'] ? 'plugin-page/complete.svg' : 'plugin-page/step-1.svg';
		$step['button_text']   = $this->output_data['plugin_activated']
			? $this->get_installed_activated_text()
			: $this->get_activate_text();
		$step['button_class']  = $is_offered ? 'button-primary' : 'grey disabled';
		$step['button_action'] = $is_offered ? 'activate' : '';
		$step['plugin']        = $plugin->get_installed_basename();
		$step['is_pro']        = $this->output_data['pro_plugin_installed'];

		return $step;
	}

	/**
	 * Step 'Setup' data.
	 *
	 * @since 4.9.0
	 *
	 * @return array Step data.
	 */
	protected function get_data_step_setup(): array {

		$step = [];

		$this->output_data['plugin_setup'] = false;

		if ( $this->output_data['plugin_activated'] ) {
			$this->output_data['plugin_setup'] = $this->is_plugin_configured();
		}

		$step['icon']          = 'plugin-page/step-2.svg';
		$step['section_class'] = $this->output_data['plugin_activated'] ? '' : 'grey';
		$step['heading']       = $this->get_setup_heading();
		$step['description']   = $this->get_setup_description();
		$step['button_text']   = $this->get_setup_button_text();
		$step['button_class']  = 'grey disabled';

		if ( $this->output_data['plugin_setup'] ) {
			$step['icon']          = 'plugin-page/complete.svg';
			$step['section_class'] = '';
			$step['button_text']   = $this->get_setup_completed_text();
		} else {
			$step['button_class'] = $this->output_data['plugin_activated'] ? 'button-primary' : 'grey disabled';
		}

		return $step;
	}

	/**
	 * Ajax endpoint. Check plugin setup status.
	 * Used to properly init the step 2 section after completing step 1.
	 *
	 * @since 4.9.0
	 */
	public function ajax_check_plugin_status(): void {

		// Security checks.
		if (
			! check_ajax_referer( 'wp-mail-smtp-admin', 'nonce', false ) ||
			! current_user_can( wp_mail_smtp()->get_capability_manage_options() )
		) {
			wp_send_json_error(
				[ 'error' => esc_html__( 'You do not have permission.', 'wp-mail-smtp' ) ]
			);
		}

		$result = [];

		if ( ! $this->is_plugin_available() ) {
			wp_send_json_error(
				[ 'error' => esc_html__( 'Plugin unavailable.', 'wp-mail-smtp' ) ]
			);
		}

		$result['setup_status'] = (int) $this->is_plugin_configured();

		$result['license_level']    = $this->is_pro_active() ? 'pro' : 'lite';
		$result['step3_button_url'] = $this->config[ static::get_plugin_name() . '_addon_page' ];
		$result['result_status']    = $this->is_plugin_finished_setup();
		$result['addon_installed']  = (int) $this->get_plugin()->is_pro_installed();

		wp_send_json_success( $result );
	}

	/**
	 * Set the source of the plugin installation.
	 *
	 * @since 4.9.0
	 *
	 * @param string $plugin_basename The basename of the plugin.
	 */
	public function plugin_activated( string $plugin_basename ): void {

		if ( $plugin_basename !== $this->get_plugin()->get_basename() ) {
			return;
		}

		$source = wp_mail_smtp()->is_pro() ? 'WP Mail SMTP Pro' : 'WP Mail SMTP';

		update_option( static::get_plugin_name() . '_source', $source, false );
		update_option( static::get_plugin_name() . '_date', time(), false );
	}

	/**
	 * JS strings.
	 *
	 * @since 4.9.0
	 *
	 * @return array Array of strings.
	 */
	protected function get_js_strings(): array {

		return [
			'installing'    => esc_html__( 'Installing...', 'wp-mail-smtp' ),
			'activating'    => esc_html__( 'Activating...', 'wp-mail-smtp' ),
			'activated'     => $this->get_installed_activated_text(),
			'activated_pro' => $this->get_pro_installed_activated_text(),
			'install_now'   => esc_html__( 'Install Now', 'wp-mail-smtp' ),
			'activate_now'  => esc_html__( 'Activate Now', 'wp-mail-smtp' ),
		];
	}

	/**
	 * Get the plugin name for use in IDs, CSS classes, and config keys.
	 *
	 * @since 4.9.0
	 *
	 * @return string Plugin name.
	 */
	abstract protected static function get_plugin_name(): string;

	/**
	 * Generate and output heading section HTML.
	 *
	 * @since 4.9.0
	 *
	 * @noinspection HtmlUnknownTarget
	 */
	public function output_section_heading(): void {

		$strings = $this->get_heading_strings();

		// Heading section.
		printf(
			'<section class="top">
				<img class="img-top" src="%1$s" alt="%2$s"/>
				<h1>%3$s</h1>
				<p>%4$s</p>
			</section>',
			esc_url( $this->get_heading_image_url() ),
			esc_attr( $this->get_heading_alt_text() ),
			esc_html( $this->get_heading_title() ),
			esc_html( implode( ' ', $strings ) )
		);
	}

	/**
	 * Get heading image URL.
	 *
	 * @since 4.9.0
	 *
	 * @return string Heading image URL.
	 */
	protected function get_heading_image_url(): string {

		return wp_mail_smtp()->assets_url . '/images/recommendations/plugins/' . static::get_plugin_name() . '/logo.svg'; // phpcs:ignore WPForms.Formatting.EmptyLineBeforeReturn.RemoveEmptyLineBeforeReturnStatement
	}

	/**
	 * Get heading title text.
	 *
	 * @since 4.9.0
	 *
	 * @return string Heading title.
	 */
	abstract protected function get_heading_title(): string;

	/**
	 * Get heading alt text for logo.
	 *
	 * @since 4.9.0
	 *
	 * @return string Heading alt text.
	 */
	abstract protected function get_heading_alt_text(): string;

	/**
	 * Get heading description strings.
	 *
	 * @since 4.9.0
	 *
	 * @return array Array of description strings.
	 */
	abstract protected function get_heading_strings(): array;

	/**
	 * Generate and output screenshot section HTML.
	 *
	 * @since 4.9.0
	 */
	protected function output_section_screenshot(): void {

		$features = $this->get_screenshot_features();

		$list = '';

		foreach ( $features as $feature ) {
			$list .= sprintf(
				'<li><span aria-hidden="true" class="wpms:icon-[fa6-solid--arrow-right] wpms:text-link wpms:w-[14px] wpms:h-[14px] wpms:shrink-0"></span>%s</li>',
				esc_html( $feature )
			);
		}

		// Screenshot section.
		printf(
			'<section class="screenshot">
				<div class="cont">
					<img src="%1$s" alt="%2$s" srcset="%4$s 2x"/>
					<a href="%3$s" class="hover" data-lity></a>
				</div>
				<ul>%5$s</ul>
			</section>',
			esc_url( wp_mail_smtp()->assets_url . '/images/recommendations/plugins/' . static::get_plugin_name() . '/screenshot-tnail.png' ),
			esc_attr( $this->get_screenshot_alt_text() ),
			esc_url( wp_mail_smtp()->assets_url . '/images/recommendations/plugins/' . static::get_plugin_name() . '/screenshot-full-2x.png' ),
			esc_url( wp_mail_smtp()->assets_url . '/images/recommendations/plugins/' . static::get_plugin_name() . '/screenshot-tnail-2x.png' ),
			wp_kses(
				$list,
				[
					'li'   => [],
					'span' => [
						'class'       => [],
						'aria-hidden' => [],
					],
				]
			)
		);
	}

	/**
	 * Get screenshot features list.
	 *
	 * @since 4.9.0
	 *
	 * @return array Array of feature strings.
	 */
	abstract protected function get_screenshot_features(): array;

	/**
	 * Get screenshot alt text.
	 *
	 * @since 4.9.0
	 *
	 * @return string Alt text for screenshot image.
	 */
	abstract protected function get_screenshot_alt_text(): string;

	/**
	 * Generate and output step 'Result' section HTML.
	 *
	 * @since 4.9.0
	 */
	abstract protected function output_section_step_result(): void;

	/**
	 * The plugin this page promotes.
	 *
	 * @since 4.10.0
	 *
	 * @return PartnerPlugin
	 */
	protected function get_plugin(): PartnerPlugin {

		if ( $this->plugin === null ) {
			$this->plugin = $this->create_plugin();
		}

		return $this->plugin;
	}

	/**
	 * Build the plugin this page promotes.
	 *
	 * @since 4.10.0
	 *
	 * @return PartnerPlugin
	 */
	abstract protected function create_plugin(): PartnerPlugin;

	/**
	 * Whether the plugin is configured.
	 *
	 * @since 4.9.0
	 *
	 * @return bool
	 */
	protected function is_plugin_configured(): bool {

		return $this->get_plugin()->is_configured();
	}


	/**
	 * Whether the plugin has nothing left for the user to set up.
	 *
	 * @since 4.9.0
	 *
	 * @return bool
	 */
	protected function is_plugin_finished_setup(): bool {

		return $this->is_plugin_configured();
	}

	/**
	 * Whether the plugin's own API is available.
	 *
	 * @since 4.9.0
	 *
	 * @return bool
	 */
	protected function is_plugin_available(): bool {

		return $this->get_plugin()->is_loaded();
	}

	/**
	 * Whether the plugin's premium tier is unlocked.
	 *
	 * @since 4.9.0
	 *
	 * @return bool
	 */
	protected function is_pro_active(): bool {

		return $this->get_plugin()->is_pro_active();
	}

	/**
	 * Get the heading for the installation step.
	 *
	 * @since 4.9.0
	 *
	 * @return string Install step heading.
	 */
	abstract protected function get_install_heading(): string;

	/**
	 * Get the description for the installation step.
	 *
	 * @since 4.9.0
	 *
	 * @return string Install step description.
	 */
	abstract protected function get_install_description(): string;

	/**
	 * Get the installation button text.
	 *
	 * @since 4.9.0
	 *
	 * @return string Install button text.
	 */
	abstract protected function get_install_button_text(): string;

	/**
	 * Get the text when a plugin is installed and activated.
	 *
	 * @since 4.9.0
	 *
	 * @return string Installed & activated text.
	 */
	abstract protected function get_installed_activated_text(): string;

	/**
	 * Get the activate button text.
	 *
	 * @since 4.9.0
	 *
	 * @return string Activate button text.
	 */
	abstract protected function get_activate_text(): string;

	/**
	 * Get the heading for the setup step.
	 *
	 * @since 4.9.0
	 *
	 * @return string Setup step heading.
	 */
	abstract protected function get_setup_heading(): string;

	/**
	 * Get the description for the setup step.
	 *
	 * @since 4.9.0
	 *
	 * @return string Setup step description.
	 */
	abstract protected function get_setup_description(): string;

	/**
	 * Get the setup button text.
	 *
	 * @since 4.9.0
	 *
	 * @return string Setup button text.
	 */
	abstract protected function get_setup_button_text(): string;

	/**
	 * Get the text when setup is completed.
	 *
	 * @since 4.9.0
	 *
	 * @return string Setup completed text.
	 */
	abstract protected function get_setup_completed_text(): string;

	/**
	 * Get the text when a pro-version is installed and activated.
	 *
	 * @since 4.9.0
	 *
	 * @return string Pro installed and activated text.
	 */
	abstract protected function get_pro_installed_activated_text(): string;
}