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 class Sub_Controls_Stack {
abstract public function get_id();
* Retrieve the self title.
abstract public function get_title();
* Initializing the base class by setting parent stack.
* @param Controls_Stack $element_parent
public function __construct( $element_parent ) {
$this->parent = $element_parent;
* 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
* By default do nothing, and return the original id.
* @param string $control_base_id Control base ID.
* @return string Control ID.
protected function get_control_id( $control_base_id ) {
* Register a single control to allow the user to set/update data.
* @param string $id Control ID.
* @param array $args Control arguments.
* @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 );
* Change the value of an existing control.
* @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 );
* Unregister an existing control.
* @param string $id Control ID.
public function remove_control( $id ) {
$this->parent->remove_control( $this->get_control_id( $id ) );
* Register a set of related controls grouped together as a single unified
* @param string $group_name Group control name.
* @param array $args Group control arguments. Default is an empty array.
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.
* @param string $id Responsive control ID.
* @param array $args Responsive control arguments.
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.
* @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.
* @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.
* @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 );
* Used to close an existing open controls section.
public function end_controls_section() {
$this->parent->end_controls_section();
* Used to add a new set of tabs inside a section.
* @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 );
* Used to close an existing open controls tabs.
public function end_controls_tab() {
$this->parent->end_controls_tab();
* Used to close an existing open controls tabs.
public function end_controls_tabs() {
$this->parent->end_controls_tabs();