<?php

namespace Imagely\NGG\DataMappers;

use Imagely\NGG\DataMapper\WPPostDriver;
use Imagely\NGG\DataMappers\DisplayType as DisplayTypeMapper;
use Imagely\NGG\Settings\Settings;

/**
 * DisplayedGallery data mapper class.
 *
 * Handles database operations for displayed gallery entities, including CRUD operations
 * and displayed gallery-specific functionality.
 */
class DisplayedGallery extends WPPostDriver {

	/**
	 * Singleton instance of the DisplayedGallery mapper.
	 *
	 * @var DisplayedGallery|null
	 */
	protected static $instance = null;

	/**
	 * The model class this mapper handles.
	 *
	 * @var string
	 */
	public $model_class = 'Imagely\NGG\DataTypes\DisplayedGallery';

	/**
	 * @var string
	 */
	protected $object_cache_group = 'ngg_displayed_galleries';

	/**
	 * Constructor.
	 *
	 * Initializes the mapper with the displayed_gallery post type.
	 */
	public function __construct() {
		parent::__construct( 'displayed_gallery' );
	}

	/**
	 * Gets the singleton instance of the DisplayedGallery mapper.
	 *
	 * @return DisplayedGallery The DisplayedGallery mapper instance.
	 */
	public static function get_instance() {
		if ( ! isset( self::$instance ) ) {
			self::$instance = new DisplayedGallery();
		}
		return self::$instance;
	}

	/**
	 * Gets the display type associated with a displayed gallery entity.
	 *
	 * @param \Imagely\NGG\DataTypes\DisplayedGallery $entity The displayed gallery entity.
	 * @return null|\Imagely\NGG\DataTypes\DisplayType The display type or null if not found.
	 */
	public function get_display_type( $entity ) {
		$mapper = DisplayTypeMapper::get_instance();
		return $mapper->find_by_name( $entity->display_type );
	}

	/**
	 * Checks if the mapper has a method with the given name.
	 *
	 * @param string $name The method name to check.
	 * @return bool True if the method exists, false otherwise.
	 */
	public function has_method( $name ) {
		return method_exists( $this, $name );
	}

	/**
	 * Sets defaults needed for the entity.
	 *
	 * @param \Imagely\NGG\DataTypes\DisplayedGallery $entity The displayed gallery entity to set defaults for.
	 */
	public function set_defaults( $entity ) {
		// Ensure that we have a settings array.
		if ( ! isset( $entity->display_settings ) ) {
			$entity->display_settings = [];
		}

		// Default ordering.
		$settings = Settings::get_instance();
		$this->set_default_value( $entity, 'order_by', $settings->get( 'galSort' ) );
		$this->set_default_value( $entity, 'order_direction', $settings->get( 'galSortDir' ) );

		// Ensure we have an exclusions array.
		$this->set_default_value( $entity, 'exclusions', [] );

		// Ensure other properties exist.
		$this->set_default_value( $entity, 'container_ids', [] );
		$this->set_default_value( $entity, 'excluded_container_ids', [] );
		$this->set_default_value( $entity, 'sortorder', [] );
		$this->set_default_value( $entity, 'entity_ids', [] );
		$this->set_default_value( $entity, 'returns', 'included' );

		// Set maximum_entity_count.
		$this->set_default_value( $entity, 'maximum_entity_count', $settings->get( 'maximum_entity_count' ) );
	}
}