<?php
/**
 * Кнопка aiModelka на странице товара витрины.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Storefront;

use Aimodelka\Admin\Assets;
use Aimodelka\Product_Block;

defined( 'ABSPATH' ) || exit;

/**
 * Блок aiModelka на странице одиночного товара витрины — под рядом миниатюр галереи
 * (Documents/WPPlugin-HLD.md §2.1).
 *
 * Зачем. Редактор товара с телефона тяжёлый, а фото вещи чаще всего лежат как раз
 * в телефоне. Человек, который смотрит товар на витрине, нажимает кнопку прямо там:
 * то же окно, те же «В галерею товара» / «Сделать изображением товара». Вторая кнопка
 * в блоке — «Упорядочить фото»: окошко порядка фото карточки прямо на странице
 * (Documents/WPPlugin-HLD.md §2.10), без aiModelka и без ключа.
 *
 * Кто видит. Только тот, кто может редактировать этот товар, — независимо от ключа aiModelka:
 * окошку «Упорядочить фото» ключ не нужен, а кнопку окна без ключа блок не печатает. Покупателям
 * и гостям блок не печатается и скрипт не подключается — ни байта. Кеш страниц (WP Fastest
 * Cache и подобные) вошедшим с правом редактировать страницы из кеша не отдаёт и в кеш
 * не кладёт, поэтому плагин для кеша ничего не делает.
 *
 * Где печатается — три яруса, потому что темы рисуют галерею по-разному; блок печатается
 * один раз (отметка «уже напечатан»):
 *
 * 1. Хук `woocommerce_product_thumbnails` с приоритетом после миниатюр WooCommerce
 *    (у них 20, здесь 30) — внутри зоны галереи.
 * 2. Хук `woocommerce_after_single_product` — если тема заменила шаблон галереи и первый
 *    хук не сработал: блок внизу карточки товара.
 * 3. `wp_footer` — если не вызываются и хуки шаблона (тема на блоках): блок печатается
 *    скрытым.
 *
 * Где бы блок ни был напечатан, скрипт страницы ставит его следом за зоной галереи
 * `.woocommerce-product-gallery` — соседом, а не внутрь: внутренности галереи перестраивают
 * тема и плагины-слайдеры. Зоны галереи нет — в конец элемента `.product`; нет и его — блок
 * остаётся там, где напечатан, видимым.
 *
 * Кнопки, строка состояния, данные и тексты скрипта — общие с редактором (Product_Block);
 * у витрины нет подсказки и строки «N photos in the product» и свой css: ряд кнопок и окошко.
 */
final class Product_Button {

	/** Приоритет на `woocommerce_product_thumbnails`: миниатюры WooCommerce печатаются на 20. */
	private const THUMBNAILS_PRIORITY = 30;

	/**
	 * Решение «показывать ли блок на этой странице» — считается один раз за запрос.
	 *
	 * @var bool|null
	 */
	private ?bool $shows = null;

	/**
	 * Блок уже напечатан на этой странице.
	 *
	 * @var bool
	 */
	private bool $printed = false;

	/**
	 * Подписывается на события WordPress и WooCommerce.
	 *
	 * @return void
	 */
	public function register(): void {
		add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_assets' ) );
		add_action( 'woocommerce_product_thumbnails', array( $this, 'render_in_gallery' ), self::THUMBNAILS_PRIORITY );
		add_action( 'woocommerce_after_single_product', array( $this, 'render_after_product' ) );
		add_action( 'wp_footer', array( $this, 'render_in_footer' ) );
	}

	/**
	 * Подключает скрипт и стили витрины — только когда блок будет напечатан.
	 *
	 * @return void
	 */
	public function enqueue_assets(): void {
		if ( ! $this->shows() ) {
			return;
		}

		Assets::enqueue_storefront(
			array(
				'screen'  => 'product',
				'product' => Product_Block::page_data( $this->product_id(), Product_Block::PAGE_STOREFRONT ),
			)
		);
	}

	/**
	 * Ярус 1: внутри зоны галереи, после миниатюр. Только у галереи самого товара страницы —
	 * хук общий, и тема может вызвать его для другого товара.
	 *
	 * @return void
	 */
	public function render_in_gallery(): void {
		global $product;

		if ( ! $product instanceof \WC_Product || $product->get_id() !== $this->product_id() ) {
			return;
		}

		$this->print_block( 'gallery' );
	}

	/**
	 * Ярус 2: внизу карточки товара.
	 *
	 * @return void
	 */
	public function render_after_product(): void {
		$this->print_block( 'product' );
	}

	/**
	 * Ярус 3: в конце страницы, скрытым — скрипт переставит.
	 *
	 * @return void
	 */
	public function render_in_footer(): void {
		$this->print_block( 'footer' );
	}

	/**
	 * Печатает блок, если его ещё не было на странице и он здесь положен.
	 *
	 * Обёртка несёт ярус (`data-aimodelka-tier`) — по нему скрипт решает, что делать с блоком,
	 * а отчёт о проверке на сайте говорит, какой ярус сработал.
	 *
	 * @param string $tier gallery, product или footer.
	 * @return void
	 */
	private function print_block( string $tier ): void {
		if ( $this->printed || ! $this->shows() ) {
			return;
		}

		$this->printed = true;

		printf(
			'<div id="aimodelka-storefront" class="aimodelka-storefront" data-aimodelka-tier="%s"%s>',
			esc_attr( $tier ),
			'footer' === $tier ? ' hidden' : ''
		);
		Product_Block::render( $this->product_id(), Product_Block::PAGE_STOREFRONT );
		echo '</div>';
	}

	/**
	 * Показывать ли блок на этой странице: одиночный товар и у вошедшего право редактировать
	 * этот товар. Ключ aiModelka здесь не при чём: окошко «Упорядочить фото» работает без него,
	 * а кнопку окна без ключа не печатает Product_Block.
	 *
	 * @return bool
	 */
	private function shows(): bool {
		if ( null === $this->shows ) {
			$product_id  = $this->product_id();
			$this->shows = $product_id > 0 && current_user_can( 'edit_product', $product_id );
		}

		return $this->shows;
	}

	/**
	 * Id товара страницы одиночного товара; 0 — это не страница товара.
	 *
	 * @return int
	 */
	private function product_id(): int {
		if ( ! function_exists( 'is_product' ) || ! is_product() ) {
			return 0;
		}

		$product_id = (int) get_queried_object_id();

		return $product_id > 0 && 'product' === get_post_type( $product_id ) ? $product_id : 0;
	}
}