ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / letacommog / metras / wp-content / plugins / wp-lastweets / vendor / htmlburger / carbon-fields / core / Field

<?php

namespace Carbon_Fields\Field;

use Carbon_Fields\Helper\Helper;
use Carbon_Fields\Datastore\Datastore_Interface;
use Carbon_Fields\Exception\Incorrect_Syntax_Exception;

class Group_Field {

/**
	 * Default name to use for groups which have no name defined by the user
	 */
	const DEFAULT_GROUP_NAME = '_';

/**
	 * Unique group identificator. Generated randomly.
	 *
	 * @var string
	 */
	protected $group_id;

/**
	 * Sanitized group name.
	 *
	 * @var string
	 */
	protected $name;

/**
	 * Group label, used during rendering.
	 *
	 * @var string
	 */
	protected $label;

/**
	 * Group label template.
	 *
	 * @var string
	 */
	protected $label_template;

/**
	 * Group fields.
	 *
	 * @var array
	 */
	protected $fields = array();

/**
	 * List of registered unique field names
	 *
	 * @see register_field_name()
	 * @var array
	 */
	protected $registered_field_names = array();

/**
	 * Create a group field with the specified name and label.
	 *
	 * @param string $name
	 * @param string $label
	 * @param array  $fields
	 */
	public function __construct( $name, $label, $fields ) {
		$this->set_name( $name );
		$this->set_label( $label );
		$this->add_fields( $fields );

// Pick random ID
		$random_string = md5( mt_rand() . $this->get_name() . $this->get_label() );
		$random_string = substr( $random_string, 0, 5 ); // 5 chars should be enough
		$this->group_id = 'carbon-group-' . $random_string;
	}

/**
	 * Add a group of fields.
	 *
	 * @param array $fields
	 */
	public function add_fields( $fields ) {
		foreach ( $fields as $field ) {
			if ( ! is_a( $field, __NAMESPACE__ . '\\Field' ) ) {
				Incorrect_Syntax_Exception::raise( 'Object must be of type ' . __NAMESPACE__ . '\\Field' );
			}

$this->register_field_name( $field->get_name() );
		}

$this->fields = array_merge( $this->fields, $fields );
	}

/**
	 * Fields attribute getter.
	 *
	 * @return array
	 */
	public function get_fields() {
		return $this->fields;
	}

/**
	 * Return the names of all fields.
	 *
	 * @return array
	 */
	public function get_field_names() {
		$names = array();

foreach ( $this->fields as $field ) {
			$names[] = $field->get_name();
		}

return $names;
	}

/**
	 * Returns an array that holds the field data, suitable for JSON representation.
	 *
	 * @param bool $load  Should the value be loaded from the database or use the value from the current instance.
	 * @return array
	 */
	public function to_json( $load ) {
		$fields_data = array();

foreach ( $this->get_fields() as $field ) {
			$fields_data[] = $field->to_json( $load );
		}

$group_data = array(
			'group_id' => $this->get_group_id(),
			'name' => $this->get_name(),
			'label' => $this->get_label(),
			'label_template' => $this->get_label_template(),
			'fields' => $fields_data,
		);

return $group_data;
	}

/**
	 * Group ID attribute getter.
	 *
	 * @return string
	 */
	public function get_group_id() {
		return $this->group_id;
	}

/**
	 * Set the group label.
	 *
	 * @param  string $label If null, the label will be generated from the group name
	 * @return self   $this
	 */
	public function set_label( $label ) {
		if ( is_null( $label ) ) {
			// Try to guess field label from its name
			$label = Helper::normalize_label( $this->get_name() );
		}
		$this->label = $label;
		return $this;
	}

/**
	 * Label attribute getter.
	 *
	 * @return string
	 */
	public function get_label() {
		return $this->label;
	}

/**
	 * Set the label template.
	 *
	 * @param  string $template
	 * @return self   $this
	 */
	public function set_label_template( $template ) {
		$this->label_template = $template;
		return $this;
	}

/**
	 * Get the label template.
	 *
	 * @return string
	 */
	public function get_label_template() {
		return $this->label_template;
	}

/**
	 * Print the label template.
	 */
	public function template_label() {
		echo $this->label_template;
	}

/**
	 * Set the group name.
	 *
	 * @param  string $name Group name, either sanitized or not
	 * @return self   $this
	 */
	public function set_name( $name ) {
		if ( ! $name ) {
			$name = static::DEFAULT_GROUP_NAME;
		}

if ( ! Helper::is_valid_entity_id( $name ) ) {
			Incorrect_Syntax_Exception::raise( 'Group names can only contain lowercase alphanumeric characters, dashes and underscores ("' . $name . '" passed).' );
			return $this;
		}

$this->name = $name;
		return $this;
	}

/**
	 * Return the group name.
	 *
	 * @return string
	 */
	public function get_name() {
		return $this->name;
	}

/**
	 * Assign a DataStore instance for all group fields.
	 *
	 * @param  object  $datastore
	 * @param  boolean $set_as_default
	 * @return self    $this
	 */
	public function set_datastore( Datastore_Interface $datastore, $set_as_default = false ) {
		foreach ( $this->fields as $field ) {
			$field->set_datastore( $datastore, $set_as_default );
		}
		return $this;
	}

/**
	 * Perform checks whether there is a field registered with the name $name.
	 * If not, the field name is recorded.
	 *
	 * @param string $name
	 * @return boolean
	 */
	public function register_field_name( $name ) {
		if ( in_array( $name, $this->registered_field_names ) ) {
			Incorrect_Syntax_Exception::raise( 'Field name "' . $name . '" already registered' );
			return false;
		}

$this->registered_field_names[] = $name;
		return true;
	}
}

[+] ..
[-] Date_Field.php [edit]
[-] Checkbox_Field.php [edit]
[-] Broken_Field.php [edit]
[-] Sidebar_Field.php [edit]
[-] Textarea_Field.php [edit]
[-] Radio_Image_Field.php [edit]
[-] Text_Field.php [edit]
[-] Multiselect_Field.php [edit]
[-] Set_Field.php [edit]
[-] Radio_Field.php [edit]
[-] Group_Field.php [edit]
[-] Header_Scripts_Field.php [edit]
[-] Oembed_Field.php [edit]
[-] Scripts_Field.php [edit]
[-] Hidden_Field.php [edit]
[-] Field.php [edit]
[-] Date_Time_Field.php [edit]
[-] Footer_Scripts_Field.php [edit]
[-] Time_Field.php [edit]
[-] Image_Field.php [edit]
[-] Gravity_Form_Field.php [edit]
[-] Color_Field.php [edit]
[-] Complex_Field.php [edit]
[-] Select_Field.php [edit]
[-] Predefined_Options_Field.php [edit]
[-] Rich_Text_Field.php [edit]
[-] Separator_Field.php [edit]
[-] File_Field.php [edit]
[-] Association_Field.php [edit]
[-] Media_Gallery_Field.php [edit]
[-] Map_Field.php [edit]
[-] Html_Field.php [edit]