<?php
/**
 * Уведомления плагина в админке WordPress.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Admin;

use Aimodelka\Plugin;

defined( 'ABSPATH' ) || exit;

/**
 * Уведомления вверху страниц админки.
 *
 * Четыре случая:
 * - WooCommerce выключен или слишком старый — плагин больше ничего не делает;
 * - включён экспериментальный блочный редактор товара — кнопка там не появится
 *   (Documents/WPPlugin-HLD.md §2.1);
 * - ключ aiModelka перестал работать — это выясняет ежесуточная проверка связи или любой
 *   запрос, получивший «ключ неверен»;
 * - фоновая задача так и не смогла сохранить фото в товар — с названием товара.
 *
 * Показываются только там, где они к месту: на странице плагинов, в редакторе товара
 * и в настройках aiModelka, а не на каждой странице админки — так
 * требует правило каталога WordPress (п. 11). Каждое исчезает само, когда причина
 * устранена; «не удалось сохранить фото» ещё и скрывается ссылкой «Скрыть».
 *
 * Состояние «ключ не работает» и список несохранённых товаров — записи в таблице настроек
 * WordPress; своих таблиц у плагина нет.
 */
final class Notices {

	/** Отметка «ключ не принят сервисом»: момент, когда это выяснилось. */
	public const KEY_REJECTED_OPTION = 'aimodelka_key_rejected';

	/** Товары, в которые фоновая задача не смогла сохранить фото: id товара → момент отказа. */
	public const FAILED_SAVES_OPTION = 'aimodelka_failed_saves';

	/** Действие admin-post.php, которым человек скрывает уведомление о несохранённых фото. */
	private const HIDE_FAILED_SAVE_ACTION = 'aimodelka_hide_failed_save';

	/** Страницы админки, где уведомления к месту, кроме настроек aiModelka: плагины и редактор товара. */
	private const SCREENS = array( 'plugins', 'product' );

	/**
	 * Подписывается на события WordPress.
	 *
	 * @return void
	 */
	public function register(): void {
		add_action( 'admin_notices', array( $this, 'render' ) );
		add_action( 'admin_post_' . self::HIDE_FAILED_SAVE_ACTION, array( $this, 'handle_hide_failed_save' ) );
	}

	/**
	 * Отмечает, что сервис не принял ключ, — до следующей успешной проверки связи или нового ключа.
	 *
	 * @return void
	 */
	public static function flag_key_rejected(): void {
		update_option( self::KEY_REJECTED_OPTION, time() );
	}

	/**
	 * Снимает отметку «ключ не принят».
	 *
	 * @return void
	 */
	public static function clear_key_rejected(): void {
		delete_option( self::KEY_REJECTED_OPTION );
	}

	/**
	 * Запоминает товар, в который фоновая задача не смогла сохранить фото.
	 *
	 * @param int $product_id Id товара.
	 * @return void
	 */
	public static function add_failed_save( int $product_id ): void {
		$failed                = self::failed_saves();
		$failed[ $product_id ] = time();
		update_option( self::FAILED_SAVES_OPTION, $failed );
	}

	/**
	 * Убирает товар из списка несохранённых — после успешного сохранения или по нажатию «Скрыть».
	 *
	 * @param int $product_id Id товара.
	 * @return void
	 */
	public static function remove_failed_save( int $product_id ): void {
		$failed = self::failed_saves();

		if ( ! isset( $failed[ $product_id ] ) ) {
			return;
		}

		unset( $failed[ $product_id ] );

		if ( array() === $failed ) {
			delete_option( self::FAILED_SAVES_OPTION );
		} else {
			update_option( self::FAILED_SAVES_OPTION, $failed );
		}
	}

	/**
	 * Уведомление «плагину нужен WooCommerce». Плагин при этом больше ничего не делает.
	 *
	 * @return void
	 */
	public static function render_woocommerce_missing(): void {
		if ( ! current_user_can( 'activate_plugins' ) || ! self::on_relevant_screen() ) {
			return;
		}

		self::print_notice( 'error', esc_html__( 'aiModelka needs WooCommerce. Install and turn on WooCommerce to use it.', 'aimodelka' ) );
	}

	/**
	 * Уведомление «WooCommerce слишком старый».
	 *
	 * @return void
	 */
	public static function render_woocommerce_outdated(): void {
		if ( ! current_user_can( 'activate_plugins' ) || ! self::on_relevant_screen() ) {
			return;
		}

		self::print_notice(
			'error',
			esc_html(
				sprintf(
					/* translators: 1: minimum WooCommerce version, 2: WooCommerce version of this site. */
					__( 'aiModelka needs WooCommerce %1$s or newer. This site has WooCommerce %2$s. Update WooCommerce to use aiModelka.', 'aimodelka' ),
					AIMODELKA_MIN_WC,
					defined( 'WC_VERSION' ) ? WC_VERSION : '?'
				)
			)
		);
	}

	/**
	 * Выводит уведомления, которые относятся к этой странице и этому человеку.
	 *
	 * @return void
	 */
	public function render(): void {
		$this->render_block_editor_notice();
		$this->render_key_rejected_notice();
		$this->render_failed_saves_notice();
	}

	/**
	 * Обрабатывает «Скрыть» у уведомления о несохранённых фото.
	 *
	 * Проверяет право редактировать товары и одноразовый ключ формы (nonce), убирает товар
	 * из списка и возвращает человека на страницу, где он нажал ссылку.
	 *
	 * @return void
	 */
	public function handle_hide_failed_save(): void {
		$product_id = isset( $_GET['product_id'] ) ? absint( wp_unslash( $_GET['product_id'] ) ) : 0;

		check_admin_referer( self::HIDE_FAILED_SAVE_ACTION . '_' . $product_id );

		if ( ! current_user_can( 'edit_products' ) ) {
			wp_die( esc_html__( 'You are not allowed to do this.', 'aimodelka' ), 403 );
		}

		self::remove_failed_save( $product_id );

		wp_safe_redirect( wp_get_referer() ? wp_get_referer() : admin_url() );
		exit;
	}

	/**
	 * «Включён экспериментальный редактор товара» — в редакторе товара и в настройках плагина.
	 *
	 * @return void
	 */
	private function render_block_editor_notice(): void {
		if ( ! current_user_can( 'edit_products' ) || ! Plugin::product_block_editor_enabled() ) {
			return;
		}

		$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;

		if ( null === $screen || ! in_array( $screen->id, array( 'product', 'woocommerce_page_' . Settings_Page::PAGE_SLUG ), true ) ) {
			return;
		}

		self::print_notice( 'warning', esc_html__( 'The new product editor (beta) is turned on in WooCommerce. The aiModelka button in the product works only in the classic product editor. Turn the new editor off in WooCommerce → Settings → Advanced → Features.', 'aimodelka' ) );
	}

	/**
	 * «Ключ aiModelka не работает» — тем, кто может поменять ключ.
	 *
	 * @return void
	 */
	private function render_key_rejected_notice(): void {
		if ( ! current_user_can( 'manage_woocommerce' ) || ! get_option( self::KEY_REJECTED_OPTION ) || ! self::on_relevant_screen() ) {
			return;
		}

		self::print_notice(
			'error',
			sprintf(
				'%1$s <a href="%2$s">%3$s</a>',
				esc_html__( 'The aiModelka key does not work. Get a new key in your aiModelka account and paste it in the plugin settings.', 'aimodelka' ),
				esc_url( Settings_Page::url() ),
				esc_html__( 'Open settings', 'aimodelka' )
			)
		);
	}

	/**
	 * «Не удалось сохранить фото в товар» — по уведомлению на товар, со ссылкой на товар
	 * и «Скрыть».
	 *
	 * @return void
	 */
	private function render_failed_saves_notice(): void {
		if ( ! current_user_can( 'edit_products' ) || ! self::on_relevant_screen() ) {
			return;
		}

		foreach ( array_keys( self::failed_saves() ) as $product_id ) {
			$product = wc_get_product( $product_id );

			if ( ! $product ) {
				// Товар удалили — уведомлять больше не о чем.
				self::remove_failed_save( (int) $product_id );
				continue;
			}

			$hide_url = wp_nonce_url(
				add_query_arg(
					array(
						'action'     => self::HIDE_FAILED_SAVE_ACTION,
						'product_id' => $product_id,
					),
					admin_url( 'admin-post.php' )
				),
				self::HIDE_FAILED_SAVE_ACTION . '_' . $product_id
			);

			self::print_notice(
				'error',
				sprintf(
					'%1$s <a href="%2$s">%3$s</a> · <a href="%4$s">%5$s</a>',
					esc_html(
						sprintf(
							/* translators: %s: product name. */
							__( 'aiModelka could not save the photos to the product “%s”. The photos are safe in the aiModelka photo session: open the product, click “Open photo shoot” and save them again.', 'aimodelka' ),
							$product->get_name()
						)
					),
					esc_url( (string) get_edit_post_link( $product_id ) ),
					esc_html__( 'Open the product', 'aimodelka' ),
					esc_url( $hide_url ),
					esc_html__( 'Hide', 'aimodelka' )
				)
			);
		}
	}

	/**
	 * Открыта ли страница, где уведомления плагина к месту (см. описание класса).
	 *
	 * Страница настроек aiModelka — подменю WooCommerce, поэтому её id собирается из
	 * адреса страницы настроек.
	 *
	 * @return bool
	 */
	private static function on_relevant_screen(): bool {
		$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;

		if ( null === $screen ) {
			return false;
		}

		return in_array( $screen->id, self::SCREENS, true ) || 'woocommerce_page_' . Settings_Page::PAGE_SLUG === $screen->id;
	}

	/**
	 * Список несохранённых товаров из настроек; испорченная запись — пустой список.
	 *
	 * @return array<int, int> Id товара → момент отказа.
	 */
	private static function failed_saves(): array {
		$failed = get_option( self::FAILED_SAVES_OPTION, array() );

		return is_array( $failed ) ? $failed : array();
	}

	/**
	 * Печатает уведомление в разметке WordPress.
	 *
	 * @param string $type    error, warning, success или info.
	 * @param string $html    Уже экранированное содержимое.
	 * @return void
	 */
	private static function print_notice( string $type, string $html ): void {
		printf(
			'<div class="notice notice-%1$s"><p>%2$s</p></div>',
			esc_attr( $type ),
			wp_kses(
				$html,
				array(
					'a' => array( 'href' => array() ),
				)
			)
		);
	}
}