<?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 ) ); } }