B4BY.588

: / home / sportmx / public_html / wp-content / plugins / fakerpress / src / FakerPress / Fields /
Filename : Factory.php
back
<?php
/**
 * Factory class for creating field instances.
 *
 * @since TBD
 */

namespace FakerPress\Fields;

use FakerPress\Contracts\Service_Provider;
use function FakerPress\get;
use function FakerPress\make;

/**
 * Class Factory
 *
 * Factory class responsible for creating and managing field instances.
 *
 * @since 0.6.4
 *
 * @package FakerPress\Fields
 */
class Factory extends Service_Provider {
	/**
	 * Array of registered field types.
	 *
	 * @since TBD
	 *
	 * @var array<string,string>
	 */
	protected $types = [];

	/**
	 * Register all the Admin Views as Singletons and initializes them.
	 *
	 * @since 0.6.0
	 *
	 * @return void
	 */
	public function register() {
		// Register the provider as a singleton.
		$this->container->singleton( static::class, $this );

		// When fetching all items it will initialize.
		$this->get_all_types();
	}

	/**
	 * Creates field instances from configuration.
	 *
	 * @since TBD
	 *
	 * @param array|Field_Abstract $fields Configuration array or Field instance.
	 *
	 * @return Field_Abstract|\WP_Error|array Array of fields, single field, or WP_Error on invalid config.
	 */
	public function make( $fields ) {
		if ( $fields instanceof Field_Abstract ) {
			return ! $fields->is_init() ? $fields->init() : $fields;
		}

		if ( ! is_array( $fields ) ) {
			return new \WP_Error( 'fakerpress-fields-factory-invalid-config', null, [ 'fields' => $fields ] );
		}

		if ( $this->is_valid_field_config( $fields ) ) {
			$field_class = $this->get_field_class_for_type( (string) get( $fields, 'type' ) );
			/** @var Field_Abstract $field */
			$field = make( $field_class );

			// Now using the class create a new instance and init it with the params.
			return $field->init( $fields );
		}

		return array_map( [ $this, 'make' ], $fields );
	}

	/**
	 * Gets all registered field types.
	 *
	 * @since TBD
	 *
	 * @return array<string,string> Array of field types with slug => class mapping.
	 */
	public function get_all_types(): array {
		$default_types = [
			Raw_Field::class,
			Fieldset_Field::class,
		];

		/**
		 * Allows the filtering of the FakerPress available modules.
		 *
		 * @since 0.6.0
		 *
		 * @param string[] $views Which modules are available.
		 */
		$types = apply_filters( 'fakerpress.fields', $default_types );

		foreach ( $types as $field_type ) {
			// Skips all non Field Abstract items.
			if ( ! is_subclass_of( $field_type, Field_Abstract::class ) ) {
				continue;
			}

			$this->container->bind( $field_type, $field_type );

			$this->types[ $field_type::get_slug() ] = $field_type;
		}

		return $this->types;
	}

	/**
	 * Gets the field class name for a given field type.
	 *
	 * @since TBD
	 *
	 * @param string $type The field type slug.
	 *
	 * @return string The field class name.
	 */
	public function get_field_class_for_type( string $type ): string {
		return get( $this->get_all_types(), $type );
	}

	/**
	 * Validates if a field configuration array is valid.
	 *
	 * @since TBD
	 *
	 * @param array $field The field configuration array.
	 *
	 * @return bool Whether the field configuration is valid.
	 */
	public function is_valid_field_config( array $field ): bool {
		return (bool) $this->get_field_class_for_type( (string) get( $field, 'type' ) );
	}
}