<?php
namespace Elementor;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Elementor base data control.
*
* An abstract class for creating new data controls in the panel.
*
* @since 1.5.0
* @abstract
*/
abstract class Base_Data_Control extends Base_Control {
public function __construct() {
parent::__construct();
$default_value = $this->get_default_value();
if ( '' !== $default_value ) {
$this->set_settings( 'default_value', $default_value );
}
}
/**
* Get data control default value.
*
* Retrieve the default value of the data control. Used to return the default
* values while initializing the data control.
*
* @since 1.5.0
* @access public
*
* @return string Control default value.
*/
public function get_default_value() {
return '';
}
/**
* Get data control value.
*
* Retrieve the value of the data control from a specific Controls_Stack settings.
*
* @since 1.5.0
* @access public
*
* @param array $control Control.
* @param array $settings Element settings.
*
* @return mixed Control values.
*/
public function get_value( $control, $settings ) {
if ( ! isset( $control['default'] ) ) {
$control['default'] = $this->get_default_value();
}
if ( isset( $settings[ $control['name'] ] ) ) {
$value = $settings[ $control['name'] ];
} else {
$value = $control['default'];
}
return $value;
}
/**
* Parse dynamic tags.
*
* Iterates through all the controls and renders all the dynamic tags.
*
* @since 2.0.0
* @access public
*
* @param string $dynamic_value The dynamic tag text.
* @param array $dynamic_settings The dynamic tag settings.
*
* @return string|string[]|mixed A string or an array of strings with the
* return value from each tag callback function.
*/
public function parse_tags( $dynamic_value, $dynamic_settings ) {
$current_dynamic_settings = $this->get_settings( 'dynamic' );
if ( is_array( $current_dynamic_settings ) ) {
$dynamic_settings = array_merge( $current_dynamic_settings, $dynamic_settings );
}
return Plugin::$instance->dynamic_tags->parse_tags_text( $dynamic_value, $dynamic_settings, [ Plugin::$instance->dynamic_tags, 'get_tag_data_content' ] );
}
/**
* Get data control style value.
*
* Retrieve the style of the control. Used when adding CSS rules to the control
* while extracting CSS from the `selectors` data argument.
*
* @since 1.5.0
* @since 2.3.3 New `$control_data` parameter added.
* @access public
*
* @param string $css_property CSS property.
* @param string $control_value Control value.
* @param array $control_data Control Data.
*
* @return string Control style value.
*/
public function get_style_value( $css_property, $control_value, array $control_data ) {
if ( 'DEFAULT' === $css_property ) {
return $control_data['default'];
}
return $control_value;
}
/**
* Get data control unique ID.
*
* Retrieve the unique ID of the control. Used to set a uniq CSS ID for the
* element.
*
* @since 1.5.0
* @access protected
*
* @param string $input_type Input type. Default is 'default'.
*
* @return string Unique ID.
*/
protected function get_control_uid( $input_type = 'default' ) {
return 'elementor-control-' . $input_type . '-{{{ data._cid }}}';
}
/**
* Safe Print data control unique ID.
*
* Retrieve the unique ID of the control. Used to set a unique CSS ID for the
* element.
*
* @access protected
*
* @param string $input_type Input type. Default is 'default'.
*/
protected function print_control_uid( $input_type = 'default' ) {
echo esc_attr( $this->get_control_uid( $input_type ) );
}
}