<?php if( ! class_exists('acf_field') ) : class acf_field { // vars var $name = '', $label = '', $category = 'basic', $defaults = array(), $l10n = array(), $public = true; /* * __construct * * This construcor registeres many actions and filters * * @type function * @date 5/03/2014 * @since 5.0.0 * * @param n/a * @return n/a */ function __construct() { // info $this->add_filter('acf/get_field_types', array($this, 'get_field_types'), 10, 1); // value $this->add_field_filter('acf/load_value', array($this, 'load_value'), 10, 3); $this->add_field_filter('acf/update_value', array($this, 'update_value'), 10, 3); $this->add_field_filter('acf/format_value', array($this, 'format_value'), 10, 3); $this->add_field_filter('acf/validate_value', array($this, 'validate_value'), 10, 4); $this->add_field_action('acf/delete_value', array($this, 'delete_value'), 10, 3); // field $this->add_field_filter('acf/validate_field', array($this, 'validate_field'), 10, 1); $this->add_field_filter('acf/load_field', array($this, 'load_field'), 10, 1); $this->add_field_filter('acf/update_field', array($this, 'update_field'), 10, 1); $this->add_field_filter('acf/duplicate_field', array($this, 'duplicate_field'), 10, 1); $this->add_field_action('acf/delete_field', array($this, 'delete_field'), 10, 1); $this->add_field_action('acf/render_field', array($this, 'render_field'), 9, 1); $this->add_field_action('acf/render_field_settings', array($this, 'render_field_settings'), 9, 1); $this->add_field_filter('acf/prepare_field', array($this, 'prepare_field'), 10, 1); $this->add_field_filter('acf/translate_field', array($this, 'translate_field'), 10, 1); // input actions $this->add_action("acf/input/admin_enqueue_scripts", array($this, 'input_admin_enqueue_scripts'), 10, 0); $this->add_action("acf/input/admin_head", array($this, 'input_admin_head'), 10, 0); $this->add_action("acf/input/form_data", array($this, 'input_form_data'), 10, 1); $this->add_filter("acf/input/admin_l10n", array($this, 'input_admin_l10n'), 10, 1); $this->add_action("acf/input/admin_footer", array($this, 'input_admin_footer'), 10, 1); // field group actions $this->add_action("acf/field_group/admin_enqueue_scripts", array($this, 'field_group_admin_enqueue_scripts'), 10, 0); $this->add_action("acf/field_group/admin_head", array($this, 'field_group_admin_head'), 10, 0); $this->add_action("acf/field_group/admin_footer", array($this, 'field_group_admin_footer'), 10, 0); } /* * add_filter * * This function checks if the function is_callable before adding the filter * * @type function * @date 5/03/2014 * @since 5.0.0 * * @param $tag (string) * @param $function_to_add (string) * @param $priority (int) * @param $accepted_args (int) * @return n/a */ function add_filter( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) { // bail early if no callable if( !is_callable($function_to_add) ) return; // add add_filter( $tag, $function_to_add, $priority, $accepted_args ); } /* * add_field_filter * * This function will add a field type specific filter * * @type function * @date 29/09/2016 * @since 5.4.0 * * @param $tag (string) * @param $function_to_add (string) * @param $priority (int) * @param $accepted_args (int) * @return n/a */ function add_field_filter( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) { // append $tag .= '/type=' . $this->name; // add $this->add_filter( $tag, $function_to_add, $priority, $accepted_args ); } /* * add_action * * This function checks if the function is_callable before adding the action * * @type function * @date 5/03/2014 * @since 5.0.0 * * @param $tag (string) * @param $function_to_add (string) * @param $priority (int) * @param $accepted_args (int) * @return n/a */ function add_action( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) { // bail early if no callable if( !is_callable($function_to_add) ) return; // add add_action( $tag, $function_to_add, $priority, $accepted_args ); } /* * add_field_action * * This function will add a field type specific filter * * @type function * @date 29/09/2016 * @since 5.4.0 * * @param $tag (string) * @param $function_to_add (string) * @param $priority (int) * @param $accepted_args (int) * @return n/a */ function add_field_action( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) { // append $tag .= '/type=' . $this->name; // add $this->add_action( $tag, $function_to_add, $priority, $accepted_args ); } /* * get_field_types() * * This function will append the current field type to the list of available field types * * @type function * @since 3.6 * @date 23/01/13 * * @param $fields (array) * @return $fields */ function get_field_types( $types ) { // append $types[ $this->name ] = array( 'label' => $this->label, 'name' => $this->name, 'category' => $this->category, 'public' => $this->public ); // return return $types; } /* * validate_field * * This function will append default settings to a field * * @type filter ("acf/validate_field/type={$this->name}") * @since 3.6 * @date 23/01/13 * * @param $field (array) * @return $field (array) */ function validate_field( $field ) { // bail early if no defaults if( !is_array($this->defaults) ) return $field; // merge in defaults but keep order of $field keys foreach( $this->defaults as $k => $v ) { if( !isset($field[ $k ]) ) $field[ $k ] = $v; } // return return $field; } /* * admin_l10n * * This function will append l10n text translations to an array which is later passed to JS * * @type filter ("acf/input/admin_l10n") * @since 3.6 * @date 23/01/13 * * @param $l10n (array) * @return $l10n (array) */ function input_admin_l10n( $l10n ) { // bail early if no defaults if( empty($this->l10n) ) return $l10n; // append $l10n[ $this->name ] = $this->l10n; // return return $l10n; } } endif; // class_exists check /* * acf_get_field_types * * This function will return an array containing info about all field types * * @type function * @date 22/10/16 * @since 5.5.0 * * @param n/a * @return (array) */ function acf_get_field_types() { // vars $cache_key = 'acf_get_field_types'; // check cache if( acf_isset_cache($cache_key) ) return acf_get_cache($cache_key); // get types $types = apply_filters('acf/get_field_types', array()); // update cache acf_set_cache($cache_key, $types); // return return $types; } /* * acf_get_grouped_field_types * * This function will return a grouped array of fields types (category => name) * * @type function * @date 1/10/13 * @since 5.0.0 * * @param n/a * @return (array) */ function acf_get_grouped_field_types() { // vars $types = array(); $l10n = array( 'basic' => __('Basic', 'acf'), 'content' => __('Content', 'acf'), 'choice' => __('Choice', 'acf'), 'relational' => __('Relational', 'acf'), 'jquery' => __('jQuery', 'acf'), 'layout' => __('Layout', 'acf'), ); // get field type information $types_info = acf_get_field_types(); // loop foreach( $types_info as $info ) { // bail early if not public if( !$info['public'] ) continue; // vars $cat = $info['category']; // default to basic if( !$cat ) $cat = 'basic'; // translate $cat = isset($l10n[ $cat ]) ? $l10n[ $cat ] : $cat; // append $types[ $cat ][ $info['name'] ] = $info['label']; } // return return $types; } /* * acf_get_field_type_label * * This function will return the label of a field type * * @type function * @date 1/10/13 * @since 5.0.0 * * @param n/a * @return (array) */ function acf_get_field_type_label( $type = '' ) { // vars $types = acf_get_field_types(); // bail early if doesn't exist if( !isset($types[ $type ]) ) return ''; // return return $types[ $type ]['label']; } /* * acf_field_type_exists * * This function will check if the field_type exists * * @type function * @date 1/10/13 * @since 5.0.0 * * @param $type (string) * @return (boolean) */ function acf_field_type_exists( $type = '' ) { // vars $types = acf_get_field_types(); // return return isset($types[ $type ]); } ?>