first commit

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

@@ -0,0 +1,271 @@
+<?php
+namespace Elementor;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly.
+}
+
+/**
+ * Elementor skin base.
+ *
+ * An abstract class to register new skins for Elementor widgets. Skins allows
+ * you to add new templates, set custom controls and more.
+ *
+ * To register new skins for your widget use the `add_skin()` method inside the
+ * widget's `register_skins()` method.
+ *
+ * @since 1.0.0
+ * @abstract
+ */
+abstract class Skin_Base extends Sub_Controls_Stack {
+
+	/**
+	 * Parent widget.
+	 *
+	 * Holds the parent widget of the skin. Default value is null, no parent widget.
+	 *
+	 * @access protected
+	 *
+	 * @var Widget_Base|null
+	 */
+	protected $parent = null;
+
+	/**
+	 * Skin base constructor.
+	 *
+	 * Initializing the skin base class by setting parent widget and registering
+	 * controls actions.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @param Widget_Base $parent
+	 */
+	public function __construct( Widget_Base $parent ) {
+		parent::__construct( $parent );
+
+		$this->_register_controls_actions();
+	}
+
+	/**
+	 * Render skin.
+	 *
+	 * Generates the final HTML on the frontend.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @abstract
+	 */
+	abstract public function render();
+
+	/**
+	 * Render element in static mode.
+	 *
+	 * If not inherent will call the base render.
+	 */
+	public function render_static() {
+		$this->render();
+	}
+
+	/**
+	 * Determine the render logic.
+	 */
+	public function render_by_mode() {
+		if ( Plugin::$instance->frontend->is_static_render_mode() ) {
+			$this->render_static();
+
+			return;
+		}
+
+		$this->render();
+	}
+
+	/**
+	 * Register skin controls actions.
+	 *
+	 * Run on init and used to register new skins to be injected to the widget.
+	 * This method is used to register new actions that specify the location of
+	 * the skin in the widget.
+	 *
+	 * Example usage:
+	 * `add_action( 'elementor/element/{widget_id}/{section_id}/before_section_end', [ $this, 'register_controls' ] );`
+	 *
+	 * @since 1.0.0
+	 * @access protected
+	 */
+	protected function _register_controls_actions() {}
+
+	/**
+	 * Get skin control ID.
+	 *
+	 * Retrieve the skin control ID. Note that skin controls have special prefix
+	 * to distinguish them from regular controls, and from controls in other
+	 * skins.
+	 *
+	 * @since 1.0.0
+	 * @access protected
+	 *
+	 * @param string $control_base_id Control base ID.
+	 *
+	 * @return string Control ID.
+	 */
+	protected function get_control_id( $control_base_id ) {
+		$skin_id = str_replace( '-', '_', $this->get_id() );
+		return $skin_id . '_' . $control_base_id;
+	}
+
+	/**
+	 * Get skin settings.
+	 *
+	 * Retrieve all the skin settings or, when requested, a specific setting.
+	 *
+	 * @since 1.0.0
+	 * @TODO: rename to get_setting() and create backward compatibility.
+	 *
+	 * @access public
+	 *
+	 * @param string $control_base_id Control base ID.
+	 *
+	 * @return mixed
+	 */
+	public function get_instance_value( $control_base_id ) {
+		$control_id = $this->get_control_id( $control_base_id );
+		return $this->parent->get_settings( $control_id );
+	}
+
+	/**
+	 * Start skin controls section.
+	 *
+	 * Used to add a new section of controls to the skin.
+	 *
+	 * @since 1.3.0
+	 * @access public
+	 *
+	 * @param string $id   Section ID.
+	 * @param array  $args Section arguments.
+	 */
+	public function start_controls_section( $id, $args = [] ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::start_controls_section( $id, $args );
+	}
+
+	/**
+	 * Add new skin control.
+	 *
+	 * Register a single control to the allow the user to set/update skin data.
+	 *
+	 * @param string $id   Control ID.
+	 * @param array  $args Control arguments.
+	 * @param array  $options
+	 *
+	 * @return bool True if skin added, False otherwise.
+
+	 * @since 3.0.0 New `$options` parameter added.
+	 * @access public
+	 *
+	 */
+	public function add_control( $id, $args = [], $options = [] ) {
+		$args['condition']['_skin'] = $this->get_id();
+		return parent::add_control( $id, $args, $options );
+	}
+
+	/**
+	 * Update skin control.
+	 *
+	 * Change the value of an existing skin control.
+	 *
+	 * @since 1.3.0
+	 * @since 1.8.1 New `$options` parameter added.
+	 *
+	 * @access public
+	 *
+	 * @param string $id      Control ID.
+	 * @param array  $args    Control arguments. Only the new fields you want to update.
+	 * @param array  $options Optional. Some additional options.
+	 */
+	public function update_control( $id, $args, array $options = [] ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::update_control( $id, $args, $options );
+	}
+
+	/**
+	 * Add new responsive skin control.
+	 *
+	 * Register a set of controls to allow editing based on user screen size.
+	 *
+	 * @param string $id   Responsive control ID.
+	 * @param array  $args Responsive control arguments.
+	 * @param array  $options
+	 *
+	 * @since  1.0.5
+	 * @access public
+	 *
+	 */
+	public function add_responsive_control( $id, $args, $options = [] ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::add_responsive_control( $id, $args );
+	}
+
+	/**
+	 * Start skin controls tab.
+	 *
+	 * Used to add a new tab inside a group of tabs.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 *
+	 * @param string $id   Control ID.
+	 * @param array  $args Control arguments.
+	 */
+	public function start_controls_tab( $id, $args ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::start_controls_tab( $id, $args );
+	}
+
+	/**
+	 * Start skin controls tabs.
+	 *
+	 * Used to add a new set of tabs inside a section.
+	 *
+	 * @since 1.5.0
+	 * @access public
+	 *
+	 * @param string $id Control ID.
+	 */
+	public function start_controls_tabs( $id ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::start_controls_tabs( $id );
+	}
+
+	/**
+	 * Add new group control.
+	 *
+	 * Register a set of related controls grouped together as a single unified
+	 * control.
+	 *
+	 * @param string $group_name Group control name.
+	 * @param array  $args       Group control arguments. Default is an empty array.
+	 * @param array  $options
+	 *
+	 * @since  1.0.0
+	 * @access public
+	 *
+	 */
+	final public function add_group_control( $group_name, $args = [], $options = [] ) {
+		$args['condition']['_skin'] = $this->get_id();
+		parent::add_group_control( $group_name, $args );
+	}
+
+	/**
+	 * Set parent widget.
+	 *
+	 * Used to define the parent widget of the skin.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 *
+	 * @param Widget_Base $parent Parent widget.
+	 */
+	public function set_parent( $parent ) {
+		$this->parent = $parent;
+	}
+}

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

@@ -0,0 +1,242 @@
+<?php
+namespace Elementor;
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly
+}
+
+/**
+ * Elementor sub controls stack.
+ *
+ * An abstract class that can be used to divide a large ControlsStack into small parts.
+ *
+ * @abstract
+ */
+abstract class Sub_Controls_Stack {
+	/**
+	 * @var Controls_Stack
+	 */
+	protected $parent;
+
+	/**
+	 * Get self ID.
+	 *
+	 * Retrieve the self ID.
+	 *
+	 * @access public
+	 * @abstract
+	 */
+	abstract public function get_id();
+
+	/**
+	 * Get self title.
+	 *
+	 * Retrieve the self title.
+	 *
+	 * @access public
+	 * @abstract
+	 */
+	abstract public function get_title();
+
+	/**
+	 * Constructor.
+	 *
+	 * Initializing the base class by setting parent stack.
+	 *
+	 * @access public
+	 * @param Controls_Stack $parent
+	 */
+	public function __construct( $parent ) {
+		$this->parent = $parent;
+	}
+
+	/**
+	 * Get control ID.
+	 *
+	 * Retrieve the control ID. Note that the sub controls stack may have a special prefix
+	 * to distinguish them from regular controls, and from controls in other
+	 * sub stack.
+	 *
+	 * By default do nothing, and return the original id.
+	 *
+	 * @access protected
+	 *
+	 * @param string $control_base_id Control base ID.
+	 *
+	 * @return string Control ID.
+	 */
+	protected function get_control_id( $control_base_id ) {
+		return $control_base_id;
+	}
+
+	/**
+	 * Add new control.
+	 *
+	 * Register a single control to allow the user to set/update data.
+	 *
+	 * @access public
+	 *
+	 * @param string $id   Control ID.
+	 * @param array  $args Control arguments.
+	 * @param array  $options
+	 *
+	 * @return bool True if added, False otherwise.
+	 */
+	public function add_control( $id, $args, $options = [] ) {
+		return $this->parent->add_control( $this->get_control_id( $id ), $args, $options );
+	}
+
+	/**
+	 * Update control.
+	 *
+	 * Change the value of an existing control.
+	 *
+	 * @access public
+	 *
+	 * @param string $id      Control ID.
+	 * @param array  $args    Control arguments. Only the new fields you want to update.
+	 * @param array  $options Optional. Some additional options.
+	 */
+	public function update_control( $id, $args, array $options = [] ) {
+		$this->parent->update_control( $this->get_control_id( $id ), $args, $options );
+	}
+
+	/**
+	 * Remove control.
+	 *
+	 * Unregister an existing control.
+	 *
+	 * @access public
+	 *
+	 * @param string $id Control ID.
+	 */
+	public function remove_control( $id ) {
+		$this->parent->remove_control( $this->get_control_id( $id ) );
+	}
+
+	/**
+	 * Add new group control.
+	 *
+	 * Register a set of related controls grouped together as a single unified
+	 * control.
+	 *
+	 * @access public
+	 *
+	 * @param string $group_name Group control name.
+	 * @param array  $args       Group control arguments. Default is an empty array.
+	 * @param array  $options
+	 *
+	 */
+	public function add_group_control( $group_name, $args, $options = [] ) {
+		$args['name'] = $this->get_control_id( $args['name'] );
+		$this->parent->add_group_control( $group_name, $args, $options );
+	}
+
+	/**
+	 * Add new responsive control.
+	 *
+	 * Register a set of controls to allow editing based on user screen size.
+	 *
+	 * @access public
+	 *
+	 * @param string $id   Responsive control ID.
+	 * @param array  $args Responsive control arguments.
+	 * @param array  $options
+	 */
+	public function add_responsive_control( $id, $args, $options = [] ) {
+		$this->parent->add_responsive_control( $this->get_control_id( $id ), $args, $options );
+	}
+
+	/**
+	 * Update responsive control.
+	 *
+	 * Change the value of an existing responsive control.
+	 *
+	 * @access public
+	 *
+	 * @param string $id   Responsive control ID.
+	 * @param array  $args Responsive control arguments.
+	 */
+	public function update_responsive_control( $id, $args ) {
+		$this->parent->update_responsive_control( $this->get_control_id( $id ), $args );
+	}
+
+	/**
+	 * Remove responsive control.
+	 *
+	 * Unregister an existing responsive control.
+	 *
+	 * @access public
+	 *
+	 * @param string $id Responsive control ID.
+	 */
+	public function remove_responsive_control( $id ) {
+		$this->parent->remove_responsive_control( $this->get_control_id( $id ) );
+	}
+
+	/**
+	 * Start controls section.
+	 *
+	 * Used to add a new section of controls to the stack.
+	 *
+	 * @access public
+	 *
+	 * @param string $id   Section ID.
+	 * @param array  $args Section arguments.
+	 */
+
+	public function start_controls_section( $id, $args = [] ) {
+		$this->parent->start_controls_section( $this->get_control_id( $id ), $args );
+	}
+
+	/**
+	 * End controls section.
+	 *
+	 * Used to close an existing open controls section.
+	 *
+	 * @access public
+	 */
+	public function end_controls_section() {
+		$this->parent->end_controls_section();
+	}
+
+	/**
+	 * Start controls tabs.
+	 *
+	 * Used to add a new set of tabs inside a section.
+	 *
+	 * @access public
+	 *
+	 * @param string $id Control ID.
+	 */
+	public function start_controls_tabs( $id ) {
+		$this->parent->start_controls_tabs( $this->get_control_id( $id ) );
+	}
+
+	public function start_controls_tab( $id, $args ) {
+		$this->parent->start_controls_tab( $this->get_control_id( $id ), $args );
+	}
+
+
+	/**
+	 * End controls tabs.
+	 *
+	 * Used to close an existing open controls tabs.
+	 *
+	 * @access public
+	 */
+	public function end_controls_tab() {
+		$this->parent->end_controls_tab();
+	}
+
+	/**
+	 * End controls tabs.
+	 *
+	 * Used to close an existing open controls tabs.
+	 *
+	 * @access public
+	 */
+	public function end_controls_tabs() {
+		$this->parent->end_controls_tabs();
+	}
+}