|
Server : Microsoft-IIS/10.0 System : Windows NT HMW9050 6.2 build 9200 (Unknow Windows version Standard Edition) i586 User : fatorc ( 0) PHP Version : 5.3.28 Disable Function : escapeshellarg, escapeshellcmd, exec, passthru, proc_close, proc_open, shell_exec, system, dl, popen, php_check_syntax, php_strip_whitespace, symlink, link, openlog, apache_child_terminate Directory : e:/home/fatorc/Web/wp-content/plugins/types/library/toolset/types/embedded/classes/field/ |
Upload File : |
<?php
/**
* Instance of a field belonging to some object.
*
* @since 1.9
*/
abstract class WPCF_Field_Instance extends WPCF_Field_Instance_Unsaved {
private $object_id;
/**
* WPCF_Field_Instance constructor.
*
* @param WPCF_Field_Definition $definition Field definition.
* @param int $object_id Id of the object containing the field.
*/
public function __construct( $definition, $object_id ) {
parent::__construct( $definition );
if ( $object_id != (int) $object_id || 0 >= (int) $object_id ) {
throw new InvalidArgumentException( 'Invalid object id.' );
}
$this->object_id = (int) $object_id;
}
/**
* Accessor object to manipulate the database value directly.
*
* @return WPCF_Field_Accessor_Abstract
*/
protected function get_accessor() {
if( null == $this->accessor ) {
$this->accessor = $this->get_definition()->get_accessor( $this );
}
return $this->accessor;
}
public function get_object_id() {
return $this->object_id;
}
/**
* Delete all field values (both for single and repetitive fields).
*/
public function delete_all_values() {
$this->get_accessor()->delete_raw_value();
}
/**
* Overwrite current field values with new ones.
*
* @param array $values Array of values. For non-repetitive field there must be exactly one value. Order of values
* in this array will be stored as sort order.
* @return bool True on success, false if some error has occured.
*/
public abstract function update_all_values( $values );
/**
* Add a single field value to the database.
*
* The value will be passed through filters as needed and stored, based on field configuration.
*
* @param mixed $value Raw value, which MUST be validated already.
*
* @return mixed
*/
public abstract function add_value( $value );
/**
* @return string Meta key that is used to store value order for repetitive fields.
*/
protected function get_order_meta_name() {
return sprintf( '_%s-sort-order', $this->get_definition()->get_slug() );
}
/**
* @return WPCF_Field_Accessor_Abstract An accessor to get the sort order for repetitive fields.
*/
protected abstract function get_order_accessor();
/**
* For repetitive field, get the order of individual values.
*
* @return array Meta IDs in the order defining the field value order.
*/
protected function get_sort_order() {
$accessor = $this->get_order_accessor();
return wpcf_ensarr( $accessor->get_raw_value() );
}
/**
* Update order of inidvidual values for a repetitive field.
*
* @param int[] $order Array of meta IDs. It must be a complete match to actual values stored in the database.
* @return bool|mixed Update result. Depends on the underlying accessor.
*/
protected function set_sort_order( $order ) {
if( !is_array( $order ) ) {
return false;
}
$accessor = $this->get_order_accessor();
return $accessor->update_raw_value( $order );
}
/**
* @return mixed Value of the field in the "intermediate" format.
*/
public function get_value() {
return $this->get_definition()->get_data_mapper()->database_to_intermediate( $this->get_raw_value() );
}
}