File "class-acf-field.php"
Full Path: /home/flipjqml/onlinebetsolution.com/wp-content/plugins/advanced-custom-fields-pro/includes/fields/class-acf-field.php
File size: 11.01 KB
MIME-type: text/x-php
Charset: utf-8
<?php
if ( ! class_exists( 'acf_field' ) ) :
#[AllowDynamicProperties]
class acf_field {
// field information properties.
public $name = '';
public $label = '';
public $category = 'basic';
public $description = '';
public $doc_url = false;
public $tutorial_url = false;
public $preview_image = false;
public $pro = false;
public $defaults = array();
public $l10n = array();
public $public = true;
public $show_in_rest = true;
public $supports = array(
'escaping_html' => false, // Set true when a field handles its own HTML escaping in format_value
'required' => true,
);
/**
* Initializes the `acf_field` class. To initialize a field type that is
* extending this class, use the `initialize()` method in the child class instead.
*
* @since 5.0.0
*/
public function __construct() {
// Initialize the field type.
$this->initialize();
// Register info about the field type.
acf_register_field_type_info(
array(
'label' => $this->label,
'name' => $this->name,
'category' => $this->category,
'description' => $this->description,
'doc_url' => $this->doc_url,
'tutorial_url' => $this->tutorial_url,
'preview_image' => $this->preview_image,
'pro' => $this->pro,
'public' => $this->public,
)
);
// 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, 4 );
$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_rest_value', array( $this, 'validate_rest_value' ), 10, 3 );
$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 );
// Most fields can use the "Required" validation setting as well as most presentation settings.
$this->add_field_action( 'acf/field_group/render_field_settings_tab/validation', array( $this, 'render_required_setting' ), 5 );
foreach ( acf_get_combined_field_type_settings_tabs() as $tab_key => $tab_label ) {
$this->add_field_action( "acf/field_group/render_field_settings_tab/{$tab_key}", array( $this, "render_field_{$tab_key}_settings" ), 9, 1 );
}
}
/**
* Initializes the field type. Overridden in child classes.
*
* @since 5.6.0
*/
public function initialize() {
/* do nothing */
}
/**
* Checks a function `is_callable()` before adding the filter, since
* classes that extend `acf_field` might not implement all filters.
*
* @since 5.0.0
*
* @param string $tag The name of the filter to add the callback to.
* @param string $function_to_add The callback to be run when the filter is applied.
* @param integer $priority The priority to add the filter on.
* @param integer $accepted_args The number of args to pass to the function.
* @return void
*/
public function add_filter( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) {
// Bail early if not callable.
if ( ! is_callable( $function_to_add ) ) {
return;
}
add_filter( $tag, $function_to_add, $priority, $accepted_args );
}
/**
* Adds a filter specific to the current field type.
*
* @since 5.4.0
*
* @param string $tag The name of the filter to add the callback to.
* @param string $function_to_add The callback to be run when the filter is applied.
* @param integer $priority The priority to add the filter on.
* @param integer $accepted_args The number of args to pass to the function.
* @return void
*/
public function add_field_filter( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) {
// Append the field type name to the tag before adding the filter.
$tag .= '/type=' . $this->name;
$this->add_filter( $tag, $function_to_add, $priority, $accepted_args );
}
/**
* Checks a function `is_callable()` before adding the action, since
* classes that extend `acf_field` might not implement all actions.
*
* @since 5.0.0
*
* @param string $tag The name of the action to add the callback to.
* @param string $function_to_add The callback to be run when the action is ran.
* @param integer $priority The priority to add the action on.
* @param integer $accepted_args The number of args to pass to the function.
* @return void
*/
public function add_action( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) {
// Bail early if not callable
if ( ! is_callable( $function_to_add ) ) {
return;
}
add_action( $tag, $function_to_add, $priority, $accepted_args );
}
/**
* Adds an action specific to the current field type.
*
* @since 5.4.0
*
* @param string $tag The name of the action to add the callback to.
* @param string $function_to_add The callback to be run when the action is ran.
* @param integer $priority The priority to add the action on.
* @param integer $accepted_args The number of args to pass to the function.
* @return void
*/
public function add_field_action( $tag = '', $function_to_add = '', $priority = 10, $accepted_args = 1 ) {
// Append the field type name to the tag before adding the action.
$tag .= '/type=' . $this->name;
$this->add_action( $tag, $function_to_add, $priority, $accepted_args );
}
/**
* Appends default settings to a field.
* Runs on `acf/validate_field/type={$this->name}`.
*
* @since 3.6
*
* @param array $field The field array.
* @return array $field
*/
public 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 $field;
}
/**
* Append l10n text translations to an array which is later passed to JS.
* Runs on `acf/input/admin_l10n`.
*
* @since 3.6
*
* @param array $l10n
* @return array $l10n
*/
public function input_admin_l10n( $l10n ) {
// Bail early if no defaults.
if ( empty( $this->l10n ) ) {
return $l10n;
}
// Append.
$l10n[ $this->name ] = $this->l10n;
return $l10n;
}
/**
* Add additional validation for fields being updated via the REST API.
*
* @param boolean $valid The current validity booleean
* @param integer $value The value of the field
* @param array $field The field array
* @return boolean|WP_Error
*/
public function validate_rest_value( $valid, $value, $field ) {
return $valid;
}
/**
* Return the schema array for the REST API.
*
* @param array $field
* @return array
*/
public function get_rest_schema( array $field ) {
$schema = array(
'type' => array( 'string', 'null' ),
'required' => ! empty( $field['required'] ),
);
if ( isset( $field['default_value'] ) && '' !== $field['default_value'] ) {
$schema['default'] = $field['default_value'];
}
return $schema;
}
/**
* Return an array of links for addition to the REST API response. Each link is an array and must have both `rel` and
* `href` keys. The `href` key must be a REST API resource URL. If a link is marked as `embeddable`, the `_embed` URL
* parameter will trigger WordPress to dispatch an internal sub request and load the object within the same request
* under the `_embedded` response property.
*
* e.g;
* [
* [
* 'rel' => 'acf:post',
* 'href' => 'https://example.com/wp-json/wp/v2/posts/497',
* 'embeddable' => true,
* ],
* [
* 'rel' => 'acf:user',
* 'href' => 'https://example.com/wp-json/wp/v2/users/2',
* 'embeddable' => true,
* ],
* ]
*
* @param mixed $value The raw (unformatted) field value.
* @param string|integer $post_id
* @param array $field
* @return array
*/
public function get_rest_links( $value, $post_id, array $field ) {
return array();
}
/**
* Apply basic formatting to prepare the value for default REST output.
*
* @param mixed $value
* @param string|integer $post_id
* @param array $field
* @return mixed
*/
public function format_value_for_rest( $value, $post_id, array $field ) {
return $value;
}
/**
* Renders the "Required" setting on the field type "Validation" settings tab.
*
* @since 6.2.5
*
* @param array $field The field type being rendered.
* @return void
*/
public function render_required_setting( $field ) {
$supports_required = acf_field_type_supports( $field['type'], 'required', true );
// Only prevent rendering if explicitly disabled.
if ( ! $supports_required ) {
return;
}
acf_render_field_setting(
$field,
array(
'label' => __( 'Required', 'acf' ),
'instructions' => '',
'type' => 'true_false',
'name' => 'required',
'ui' => 1,
'class' => 'field-required',
),
true
);
}
}
endif; // class_exists check