272 lines
6.2 KiB
PHP
272 lines
6.2 KiB
PHP
<?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;
|
|
}
|
|
}
|