<?php
namespace JVBase\managers\SEO\render\Traits\_Properties;

use JVBase\managers\SEO\render\Thing\Intangible\StructuredValue\PropertyValue;
use JVBase\managers\SEO\render\Traits\_Helpers\arrayHelper;

if (!defined('ABSPATH')) {
	exit;
}
trait additionalPropertyTrait {
	use arrayHelper;
	/**
	 * @var PropertyValue|array A property-value pair representing an additional characteristic of the entity, e.g. a product feature or another characteristic for which there is no matching property in schema.org.
	 *
	 * Note: Publishers should be aware that applications designed to use specific schema.org properties (e.g. https://schema.org/width, https://schema.org/color, https://schema.org/gtin13, ...) will typically expect such data to be provided using those properties, rather than using the generic property/value mechanism.
	 */
	protected PropertyValue|array $additionalProperty;

	public function getAdditionalProperty():PropertyValue|array|null
	{
		return $this->additionalProperty??null;
	}
	public function setAdditionalProperty(PropertyValue|array $additionalProperty):void
	{
		if (is_array($additionalProperty)) {
			$additionalProperty = $this->classArray('additionalProperty', $additionalProperty, 'JVBase\managers\SEO\render\Thing\Intangible\StructuredValue\PropertyValue');
		}
		$this->additionalProperty = $additionalProperty;
	}

	public function getAdditionalPropertyFieldConfig():array
	{
		return [
			'type'	=> 'repeater',
			'label'	=> 'Additional Properties',
			'hint'	=> 'If you need to define another property that does not exist anywhere on this page, add it here.',
			'fields'	=> [
				'name'	=> [
					'type'	=> 'text',
					'label'	=> 'Name'
				],
				'propertyID'	=> [
					'type'	=> 'text',
					'label'	=> 'Property ID',
					'hint'	=> 'A commonly used identifier for the characteristic represented by the property, e.g. a manufacturer or a standard code for a property. propertyID can be (1) a prefixed string, mainly meant to be used with standards for product properties; (2) a site-specific, non-prefixed string (e.g. the primary key of the property or the vendor-specific ID of the property), or (3) a URL indicating the type of the property, either pointing to an external vocabulary, or a Web resource that describes the property (e.g. a glossary entry). Standards bodies should promote a standard prefix for the identifiers of properties from their standards.'
				],
				'value'	=> [
					'type'	=> 'textarea',
					'label'	=> 'Value'
				]
			]
		];
	}
}