149 lines
3.7 KiB
PHP
149 lines
3.7 KiB
PHP
<?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 ) );
|
|
}
|
|
}
|