<?php
/**
 * Блок aiModelka с кнопками типов фотосессии в редакторе товара.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Admin;

use Aimodelka\Config;
use Aimodelka\Product_Block;

defined( 'ABSPATH' ) || exit;

/**
 * Блок aiModelka в правой колонке классического редактора товара (Documents/WPPlugin-HLD.md §2.1).
 *
 * Где стоит. Отдельный блок (meta box) в правой колонке, сразу над блоком «Изображение
 * товара»: кнопка меняет фото товара и поэтому стоит рядом с ними.
 *
 * Как блок оказывается над «Изображением товара». Тут две части.
 *
 * 1. Блок регистрируется в правой колонке с обычным приоритетом («default»). «Изображение
 *    товара» (его регистрирует WordPress) и «Галерея товара» (WooCommerce) стоят там
 *    с низким («low»), а WordPress выводит блоки колонки по приоритетам. Без сохранённого
 *    порядка блоков наш блок встаёт прямо над ними.
 * 2. Но WooCommerce при первом открытии редактора товара сохраняет каждому пользователю
 *    порядок блоков — настройку пользователя «meta-box-order_product»: «Опубликовать»,
 *    «Изображение товара», «Галерея товара», категории, метки. Блоки из сохранённого
 *    порядка WordPress выводит раньше всех остальных, и новый блок, которого в этом порядке
 *    нет, оказался бы в самом низу колонки. Поэтому, пока нашего блока в сохранённом
 *    порядке нет, плагин при чтении порядка вставляет его прямо перед «Изображением товара»
 *    (place_before_product_image). В базу при этом ничего не пишется.
 *
 * Когда человек сам перетащит блоки, WordPress сохранит порядок уже вместе с нашим блоком,
 * и плагин в него больше не вмешивается: порядок, выбранный человеком, главнее.
 *
 * Что в блоке:
 * - заголовок — логотип aiModelka файлом из папки плагина (латиницей на любом языке);
 * - есть ключ — кнопка окна во всю ширину блока, под ней кнопка «Упорядочить фото» (окошко
 *   порядка фото карточки, Documents/WPPlugin-HLD.md §2.10), строка хода работы
 *   («Открываем aiModelka…», «Окно открыто», «Сохраняем…», ошибки словами) и строка
 *   о товаре — всё это печатает общий с витриной Product_Block;
 * - нет ключа — только «Упорядочить фото» (окошку ключ не нужен) и ссылка на настройки
 *   (или просьба к администратору магазина, если у человека нет права их менять).
 *
 * Данные и тексты для скрипта страницы — тоже общие (Product_Block::page_data с `page`
 * «editor»): в редакторе скрипт берёт изображение товара и галерею из скрытых полей формы
 * и после сохранения перерисовывает блоки «Изображение товара» и «Галерея товара».
 *
 * Только для тех, кто может редактировать этот товар: право редактировать товары — это
 * право тратить кредиты аккаунта aiModelka (Documents/WPPlugin-HLD.md §4.5).
 */
final class Product_Box {

	/** Id блока в редакторе товара. */
	private const META_BOX_ID = 'aimodelka-product';

	/** Id блока «Изображение товара» — его регистрирует WordPress. */
	private const PRODUCT_IMAGE_BOX_ID = 'postimagediv';

	/** Id блока «Галерея товара» — его регистрирует WooCommerce. */
	private const PRODUCT_GALLERY_BOX_ID = 'woocommerce-product-images';

	/** Логотип в заголовке блока — файл в папке плагина. */
	private const LOGO_FILE = 'assets/aimodelka-logo.svg';

	/**
	 * Высота логотипа на странице, в пикселях: примерно строка заголовка блока
	 * (у заголовков блоков WordPress — 14 пикселей шрифт и 1.4 межстрочный интервал).
	 */
	private const LOGO_HEIGHT = 20;

	/** Ширина логотипа при этой высоте — по пропорциям рисунка в файле. */
	private const LOGO_WIDTH = 119;

	/**
	 * Подписывается на события WordPress.
	 *
	 * Блок регистрируется на событии «add_meta_boxes_product»: оно срабатывает только
	 * в редакторе товара и после общего «add_meta_boxes», на котором свои блоки регистрируют
	 * WordPress и WooCommerce.
	 *
	 * @return void
	 */
	public function register(): void {
		add_action( 'add_meta_boxes_product', array( $this, 'add_meta_box' ) );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
	}

	/**
	 * Регистрирует блок aiModelka в правой колонке редактора товара.
	 *
	 * @param mixed $post Товар, который открыт в редакторе.
	 * @return void
	 */
	public function add_meta_box( mixed $post ): void {
		if ( ! $post instanceof \WP_Post || ! current_user_can( 'edit_product', $post->ID ) ) {
			return;
		}

		add_meta_box(
			self::META_BOX_ID,
			self::title_html(),
			array( $this, 'render' ),
			'product',
			'side',
			'default',
			// Заголовок блока — картинка. Имя простым текстом WordPress показывает
			// в «Настройках экрана», в списке блоков, которые можно скрыть.
			array( '__widget_basename' => __( 'aiModelka', 'aimodelka' ) )
		);

		// Только вместе с блоком: без него вставлять в порядок нечего.
		add_filter( 'get_user_option_meta-box-order_product', array( $this, 'place_before_product_image' ) );
	}

	/**
	 * Вставляет блок aiModelka в сохранённый порядок блоков прямо перед «Изображением
	 * товара» — только при чтении порядка и только пока нашего блока в нём нет (см. описание
	 * класса).
	 *
	 * Если блока «Изображение товара» нет (у человека нет права загружать файлы, и WordPress
	 * его не показывает), наш блок встаёт перед «Галереей товара». Нет и её — порядок
	 * не меняется, и блок стоит там, куда его ставит приоритет.
	 *
	 * @param mixed $order Сохранённый порядок: колонка («side», «normal», «advanced») → id блоков
	 *                     через запятую; false — порядок не сохранён.
	 * @return mixed Порядок для вывода страницы.
	 */
	public function place_before_product_image( mixed $order ): mixed {
		if ( ! is_array( $order ) ) {
			return $order;
		}

		foreach ( $order as $ids ) {
			if ( in_array( self::META_BOX_ID, explode( ',', (string) $ids ), true ) ) {
				return $order;
			}
		}

		foreach ( array( self::PRODUCT_IMAGE_BOX_ID, self::PRODUCT_GALLERY_BOX_ID ) as $anchor ) {
			foreach ( $order as $context => $ids ) {
				$boxes    = explode( ',', (string) $ids );
				$position = array_search( $anchor, $boxes, true );

				if ( false !== $position ) {
					array_splice( $boxes, $position, 0, self::META_BOX_ID );
					$order[ $context ] = implode( ',', $boxes );

					return $order;
				}
			}
		}

		return $order;
	}

	/**
	 * Выводит содержимое блока aiModelka.
	 *
	 * @param mixed $post Товар, который открыт в редакторе.
	 * @return void
	 */
	public function render( mixed $post ): void {
		if ( ! $post instanceof \WP_Post || ! current_user_can( 'edit_product', $post->ID ) ) {
			return;
		}

		echo '<div id="aimodelka-product-box" class="aimodelka-product-box">';

		// Кнопка окна (при ключе) и «Упорядочить фото» (всегда) — общие с витриной.
		Product_Block::render( (int) $post->ID, Product_Block::PAGE_EDITOR );

		if ( ! Config::has_api_key() && current_user_can( 'manage_woocommerce' ) ) {
			printf(
				'<p class="aimodelka-product-box__note">%1$s <a href="%2$s">%3$s</a></p>',
				esc_html__( 'To generate photos on a model, add your aiModelka key in the plugin settings.', 'aimodelka' ),
				esc_url( Settings_Page::url() ),
				esc_html__( 'Open settings', 'aimodelka' )
			);
		} elseif ( ! Config::has_api_key() ) {
			printf(
				'<p class="aimodelka-product-box__note">%s</p>',
				esc_html__( 'To generate photos on a model, ask the shop administrator to add the aiModelka key in WooCommerce → aiModelka.', 'aimodelka' )
			);
		}

		echo '</div>';
	}

	/**
	 * Подключает скрипт на странице редактирования товара и передаёт ему данные товара.
	 *
	 * @param string $hook_suffix Какая страница админки открыта.
	 * @return void
	 */
	public function enqueue_assets( string $hook_suffix ): void {
		if ( 'post.php' !== $hook_suffix && 'post-new.php' !== $hook_suffix ) {
			return;
		}

		$screen = get_current_screen();
		$post   = get_post();

		if ( null === $screen || 'product' !== $screen->post_type || ! $post || ! current_user_can( 'edit_product', $post->ID ) ) {
			return;
		}

		Assets::enqueue_editor(
			array(
				'screen'  => 'product',
				'product' => Product_Block::page_data( (int) $post->ID, Product_Block::PAGE_EDITOR ),
			)
		);
	}

	/**
	 * Заголовок блока: логотип aiModelka и его название для программ чтения с экрана.
	 *
	 * WordPress выводит заголовок блока как есть, без экранирования, поэтому всё, что сюда
	 * попадает, экранируется здесь. Картинка — без подписи (alt=""): название рядом, скрытым
	 * текстом, и WordPress берёт его же, когда подписывает блок для программ чтения с экрана.
	 * Картинку нельзя утащить мышью и она не ловит нажатия: заголовок блока — это ручка,
	 * за которую блок перетаскивают и сворачивают.
	 *
	 * @return string Разметка заголовка.
	 */
	private static function title_html(): string {
		return sprintf(
			'<img class="aimodelka-product-box__logo" src="%1$s" width="%2$d" height="%3$d" alt="" draggable="false"><span class="screen-reader-text">%4$s</span>',
			esc_url( add_query_arg( 'ver', AIMODELKA_VERSION, AIMODELKA_PLUGIN_URL . self::LOGO_FILE ) ),
			self::LOGO_WIDTH,
			self::LOGO_HEIGHT,
			esc_html__( 'aiModelka', 'aimodelka' )
		);
	}
}