156 lines
4.1 KiB
PHP
156 lines
4.1 KiB
PHP
<?php
|
|
/**
|
|
* Creative Elements - live Theme & Page Builder
|
|
*
|
|
* @author WebshopWorks, Elementor
|
|
* @copyright 2019-2022 WebshopWorks.com & Elementor.com
|
|
* @license https://www.gnu.org/licenses/gpl-3.0.html
|
|
*/
|
|
|
|
namespace CE;
|
|
|
|
defined('_PS_VERSION_') or die;
|
|
|
|
/**
|
|
* Elementor base data control.
|
|
*
|
|
* An abstract class for creating new data controls in the panel.
|
|
*
|
|
* @since 1.5.0
|
|
* @abstract
|
|
*/
|
|
abstract class BaseDataControl extends BaseControl
|
|
{
|
|
/**
|
|
* 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 getDefaultValue()
|
|
{
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Retrieve default control settings.
|
|
*
|
|
* Get the default settings of the control. Used to return the default
|
|
* settings while initializing the control.
|
|
*
|
|
* @since 2.0.0
|
|
* @access protected
|
|
*
|
|
* @return array Control default settings.
|
|
*/
|
|
protected function getDefaultSettings()
|
|
{
|
|
$default_settings = parent::getDefaultSettings();
|
|
|
|
$default_settings['dynamic'] = false;
|
|
|
|
return $default_settings;
|
|
}
|
|
|
|
/**
|
|
* 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 getValue($control, $settings)
|
|
{
|
|
if (!isset($control['default'])) {
|
|
$control['default'] = $this->getDefaultValue();
|
|
}
|
|
|
|
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 parseTags($dynamic_value, $dynamic_settings)
|
|
{
|
|
$current_dynamic_settings = $this->getSettings('dynamic');
|
|
|
|
if (is_array($current_dynamic_settings)) {
|
|
$dynamic_settings = array_merge($current_dynamic_settings, $dynamic_settings);
|
|
}
|
|
|
|
return Plugin::$instance->dynamic_tags->parseTagsText($dynamic_value, $dynamic_settings, [Plugin::$instance->dynamic_tags, 'getTagDataContent']);
|
|
}
|
|
|
|
/**
|
|
* 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 getStyleValue($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 getControlUid($input_type = 'default')
|
|
{
|
|
return 'elementor-control-' . $input_type . '-{{{ data._cid }}}';
|
|
}
|
|
}
|