<?php
/**
 * Миниатюры и имена файлов вложений — для списков, которые плагин отдаёт окну.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Media;

defined( 'ABSPATH' ) || exit;

/**
 * Что окно знает о вложении из медиатеки: адрес миниатюры и имя файла (Documents/WPPlugin-HLD.md §4.4).
 *
 * Список фото товара для шага «Фото товара» (Product_Photos) показывает окну вложения
 * миниатюрой среднего размера с сайта магазина и именем файла на случай, если миниатюра
 * не загрузилась. Правила — здесь, отдельно от списка: какие id — изображения, какой
 * размер миниатюры, откуда имя файла.
 */
final class Attachment_Info {

	/** Размер миниатюры для окна — средний: плитка окна шириной около полутора сотен точек. */
	private const THUMB_SIZE = 'medium';

	/**
	 * Какие из id — изображения из медиатеки: порядок сохраняется, повторы, не вложения
	 * и не картинки отбрасываются, список обрезается по пределу.
	 *
	 * @param array<int|string> $attachment_ids Id вложений.
	 * @param int               $limit          Сколько id брать в рассмотрение.
	 * @return int[]
	 */
	public static function image_ids( array $attachment_ids, int $limit ): array {
		$ids = array();

		foreach ( array_slice( $attachment_ids, 0, $limit ) as $attachment_id ) {
			$attachment_id = (int) $attachment_id;

			if ( $attachment_id > 0 && ! in_array( $attachment_id, $ids, true ) && 'attachment' === get_post_type( $attachment_id ) && wp_attachment_is_image( $attachment_id ) ) {
				$ids[] = $attachment_id;
			}
		}

		return $ids;
	}

	/**
	 * Адрес миниатюры вложения для окна; пустая строка — адреса нет.
	 *
	 * @param int $attachment_id Id вложения.
	 * @return string
	 */
	public static function thumb_url( int $attachment_id ): string {
		return (string) wp_get_attachment_image_url( $attachment_id, self::THUMB_SIZE );
	}

	/**
	 * Адрес картинки в полный размер — для просмотра в окне (лупа на слоте): человек видит
	 * тот же файл, что уходит в фотосессию, а не миниатюру. Оригинал, если WordPress хранит
	 * его отдельно от уменьшенной копии «-scaled», иначе — сам файл вложения; '' — адреса нет.
	 *
	 * @param int $attachment_id Id вложения.
	 * @return string
	 */
	public static function full_url( int $attachment_id ): string {
		$url = wp_get_original_image_url( $attachment_id );

		return is_string( $url ) && '' !== $url ? $url : (string) wp_get_attachment_url( $attachment_id );
	}

	/**
	 * Имя файла вложения — окно показывает его, если миниатюра не загрузилась.
	 *
	 * @param int $attachment_id Id вложения.
	 * @return string
	 */
	public static function file_name( int $attachment_id ): string {
		$path = (string) get_attached_file( $attachment_id );

		if ( '' === $path ) {
			$path = (string) wp_parse_url( (string) wp_get_attachment_url( $attachment_id ), PHP_URL_PATH );
		}

		return wp_basename( $path );
	}
}