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

namespace Aimodelka\Admin;

use Aimodelka\Meta;

defined( 'ABSPATH' ) || exit;

/**
 * Колонка статуса в списке товаров (Documents/WPPlugin-HLD.md §2.6):
 *
 * - прочерк — фото aiModelka в товар ещё не сохранялись;
 * - «N фото · дата» — сколько фото aiModelka лежит в товаре и когда сохранено последнее
 *   (строку собирает Saved_Photos — тем же кодом, что строку под кнопкой в редакторе товара);
 * - «сохраняется…» — сохранение не закончилось и доделывается в фоне.
 *
 * Только чтение меты товара, без обращений к aiModelka: список товаров открывают часто,
 * и он не должен ждать чужого сервера. Мету всех товаров страницы WordPress читает одним
 * запросом при загрузке списка, поэтому колонка не добавляет запросов к базе на каждую строку.
 *
 * По умолчанию колонка скрыта: в списке товаров WooCommerce и так тесно, а статус нужен
 * не всем. Включается она в «Настройках экрана» списка товаров, галочкой «aiModelka»
 * в разделе «Столбцы». Скрытой по умолчанию её делает штатный фильтр WordPress
 * «default_hidden_columns»; он действует, только пока человек сам не менял набор колонок
 * этого списка: после этого WordPress помнит его выбор.
 *
 * Ширину колонке задают стили плагина (aimodelka-admin.css). Таблица списка товаров
 * со строгой раскладкой колонок, и почти всем колонкам WooCommerce ширину задаёт сам —
 * колонке без своей ширины достался бы остаток в несколько пикселей.
 */
final class Product_Column {

	/** Ключ колонки в таблице списка товаров. */
	private const COLUMN = 'aimodelka';

	/** Id экрана списка товаров в админке WordPress. */
	private const SCREEN = 'edit-product';

	/**
	 * Подписывается на события WordPress.
	 *
	 * @return void
	 */
	public function register(): void {
		add_filter( 'manage_edit-product_columns', array( $this, 'add_column' ), 20 );
		add_filter( 'default_hidden_columns', array( $this, 'hide_by_default' ), 10, 2 );
		add_action( 'manage_product_posts_custom_column', array( $this, 'render_cell' ), 10, 2 );
		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_styles' ) );
	}

	/**
	 * Скрывает колонку, пока человек сам не выбрал колонки списка товаров.
	 *
	 * Фильтр общий для всех списков админки, и до нас его могли пройти чужие плагины:
	 * если они вернули не список, он отдаётся дальше как есть — ронять админку из-за
	 * чужой ошибки плагин не должен.
	 *
	 * @param mixed $hidden Колонки, скрытые по умолчанию.
	 * @param mixed $screen Экран админки, для которого их спрашивают.
	 * @return mixed
	 */
	public function hide_by_default( mixed $hidden, mixed $screen ): mixed {
		if ( is_array( $hidden ) && $screen instanceof \WP_Screen && self::SCREEN === $screen->id ) {
			$hidden[] = self::COLUMN;
		}

		return $hidden;
	}

	/**
	 * Подключает стили плагина в списке товаров — в них ширина колонки.
	 *
	 * @param string $hook_suffix Какая страница админки открыта.
	 * @return void
	 */
	public function enqueue_styles( string $hook_suffix ): void {
		if ( 'edit.php' !== $hook_suffix || ! current_user_can( 'edit_products' ) ) {
			return;
		}

		$screen = get_current_screen();

		if ( null === $screen || self::SCREEN !== $screen->id ) {
			return;
		}

		Assets::enqueue_style();
	}

	/**
	 * Добавляет колонку перед датой — или в конец, если колонки даты нет.
	 *
	 * @param array<string, string> $columns Колонки списка товаров.
	 * @return array<string, string>
	 */
	public function add_column( array $columns ): array {
		if ( ! current_user_can( 'edit_products' ) ) {
			return $columns;
		}

		$title  = __( 'aiModelka', 'aimodelka' );
		$result = array();

		foreach ( $columns as $key => $label ) {
			if ( 'date' === $key ) {
				$result[ self::COLUMN ] = $title;
			}

			$result[ $key ] = $label;
		}

		if ( ! isset( $result[ self::COLUMN ] ) ) {
			$result[ self::COLUMN ] = $title;
		}

		return $result;
	}

	/**
	 * Выводит ячейку колонки для товара.
	 *
	 * @param string $column     Какая колонка выводится.
	 * @param int    $product_id Id товара.
	 * @return void
	 */
	public function render_cell( string $column, int $product_id ): void {
		if ( self::COLUMN !== $column ) {
			return;
		}

		if ( '' !== get_post_meta( $product_id, Meta::PENDING_SAVE, true ) ) {
			echo esc_html__( 'Saving…', 'aimodelka' );
			return;
		}

		$text = Saved_Photos::column_text( $product_id );

		if ( '' === $text ) {
			echo '<span aria-hidden="true">—</span><span class="screen-reader-text">' . esc_html__( 'No aiModelka photos yet', 'aimodelka' ) . '</span>';
			return;
		}

		echo esc_html( $text );
	}
}