first commit

wp-content/plugins/elementor/includes/controls/base.php

@@ -0,0 +1,156 @@
+<?php
+namespace Elementor;
+
+use Elementor\Core\Base\Base_Object;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly.
+}
+
+/**
+ * Elementor base control.
+ *
+ * An abstract class for creating new controls in the panel.
+ *
+ * @since 1.0.0
+ * @abstract
+ */
+abstract class Base_Control extends Base_Object {
+
+	/**
+	 * Base settings.
+	 *
+	 * Holds all the base settings of the control.
+	 *
+	 * @access private
+	 *
+	 * @var array
+	 */
+	private $_base_settings = [
+		'label' => '',
+		'description' => '',
+		'show_label' => true,
+		'label_block' => false,
+		'separator' => 'default',
+	];
+
+	/**
+	 * Get features.
+	 *
+	 * Retrieve the list of all the available features. Currently Elementor uses only
+	 * the `UI` feature.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 * @static
+	 *
+	 * @return array Features array.
+	 */
+	public static function get_features() {
+		return [];
+	}
+
+	/**
+	 * Get control type.
+	 *
+	 * Retrieve the control type.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 * @abstract
+	 */
+	abstract public function get_type();
+
+	/**
+	 * Control base constructor.
+	 *
+	 * Initializing the control base class.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 */
+	public function __construct() {
+		$this->set_settings( array_merge( $this->_base_settings, $this->get_default_settings() ) );
+
+		$this->set_settings( 'features', static::get_features() );
+	}
+
+	/**
+	 * Enqueue control scripts and styles.
+	 *
+	 * Used to register and enqueue custom scripts and styles used by the control.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 */
+	public function enqueue() {}
+
+	/**
+	 * Control content template.
+	 *
+	 * Used to generate the control HTML in the editor using Underscore JS
+	 * template. The variables for the class are available using `data` JS
+	 * object.
+	 *
+	 * Note that the content template is wrapped by Base_Control::print_template().
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 * @abstract
+	 */
+	abstract public function content_template();
+
+	/**
+	 * Print control template.
+	 *
+	 * Used to generate the control HTML in the editor using Underscore JS
+	 * template. The variables for the class are available using `data` JS
+	 * object.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 */
+	final public function print_template() {
+		?>
+		<script type="text/html" id="tmpl-elementor-control-<?php echo esc_attr( $this->get_type() ); ?>-content">
+			<div class="elementor-control-content">
+				<?php
+				$this->content_template();
+				?>
+			</div>
+		</script>
+		<?php
+	}
+
+	/**
+	 * Get default control settings.
+	 *
+	 * Retrieve the default settings of the control. Used to return the default
+	 * settings while initializing the control.
+	 *
+	 * @since 1.5.0
+	 * @access protected
+	 *
+	 * @return array Control default settings.
+	 */
+	protected function get_default_settings() {
+		return [];
+	}
+
+	public static function get_assets( $setting ) {
+		return [];
+	}
+
+	/**
+	 * Update value of control that needs to be updated after import.
+	 *
+	 * @param mixed $value
+	 * @param array $control_args
+	 * @param array $config
+	 *
+	 * @return mixed
+	 */
+	public function on_import_update_settings( $value, array $control_args, array $config ) {
+		return $value;
+	}
+}