<h2>File Contents: /home/planet5/public_html/wp-content/plugins/elementor/includes/controls/groups/copy_of_base.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-content/plugins/elementor/includes/controls/groups/copy_of_base.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
namespace Elementor;

if ( ! defined( &#039;ABSPATH&#039; ) ) {
	exit; // Exit if accessed directly.
}

/**
 * Elementor group control base.
 *
 * An abstract class for creating new group controls in the panel.
 *
 * @since 1.0.0
 * @abstract
 */
abstract class Group_Control_Base implements Group_Control_Interface {

	/**
	 * Arguments.
	 *
	 * Holds all the group control arguments.
	 *
	 * @access private
	 *
	 * @var array Group control arguments.
	 */
	private $args = [];

	/**
	 * Options.
	 *
	 * Holds all the group control options.
	 *
	 * Currently supports only the popover options.
	 *
	 * @access private
	 *
	 * @var array Group control options.
	 */
	private $options;

	/**
	 * Get options.
	 *
	 * Retrieve group control options. If options are not set, it will initialize default options.
	 *
	 * @since 1.9.0
	 * @access public
	 *
	 * @param array $option Optional. Single option.
	 *
	 * @return mixed Group control options. If option parameter was not specified, it will
	 *               return an array of all the options. If single option specified, it will
	 *               return the option value or `null` if option does not exists.
	 */
	final public function get_options( $option = null ) {
		if ( null === $this-&gt;options ) {
			$this-&gt;init_options();
		}

		if ( $option ) {
			if ( isset( $this-&gt;options[ $option ] ) ) {
				return $this-&gt;options[ $option ];
			}

			return null;
		}

		return $this-&gt;options;
	}

	/**
	 * Add new controls to stack.
	 *
	 * Register multiple controls to allow the user to set/update data.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @param Controls_Stack $element   The element stack.
	 * @param array          $user_args The control arguments defined by the user.
	 * @param array          $options   Optional. The element options. Default is
	 *                                  an empty array.
	 */
	final public function add_controls( Controls_Stack $element, array $user_args, array $options = [] ) {
		$this-&gt;init_args( $user_args );

		// Filter which controls to display
		$filtered_fields = $this-&gt;filter_fields();
		$filtered_fields = $this-&gt;prepare_fields( $filtered_fields );

		// For php &lt; 7
		reset( $filtered_fields );

		if ( isset( $this-&gt;args[&#039;separator&#039;] ) ) {
			$filtered_fields[ key( $filtered_fields ) ][&#039;separator&#039;] = $this-&gt;args[&#039;separator&#039;];
		}

		$has_injection = false;

		if ( ! empty( $options[&#039;position&#039;] ) ) {
			$has_injection = true;

			$element-&gt;start_injection( $options[&#039;position&#039;] );

			unset( $options[&#039;position&#039;] );
		}

		if ( $this-&gt;get_options( &#039;popover&#039; ) ) {
			$this-&gt;start_popover( $element );
		}

		foreach ( $filtered_fields as $field_id =&gt; $field_args ) {
			// Add the global group args to the control
			$field_args = $this-&gt;add_group_args_to_field( $field_id, $field_args );

			// Register the control
			$id = $this-&gt;get_controls_prefix() . $field_id;

			if ( ! empty( $field_args[&#039;responsive&#039;] ) ) {
				unset( $field_args[&#039;responsive&#039;] );

				$element-&gt;add_responsive_control( $id, $field_args, $options );
			} else {
				$element-&gt;add_control( $id, $field_args, $options );
			}
		}

		if ( $this-&gt;get_options( &#039;popover&#039; ) ) {
			$element-&gt;end_popover();
		}

		if ( $has_injection ) {
			$element-&gt;end_injection();
		}
	}

	/**
	 * Get arguments.
	 *
	 * Retrieve group control arguments.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @return array Group control arguments.
	 */
	final public function get_args() {
		return $this-&gt;args;
	}

	/**
	 * Get fields.
	 *
	 * Retrieve group control fields.
	 *
	 * @since 1.2.2
	 * @access public
	 *
	 * @return array Control fields.
	 */
	final public function get_fields() {
		if ( null === static::$fields ) {
			static::$fields = $this-&gt;init_fields();
		}

		return static::$fields;
	}

	/**
	 * Get controls prefix.
	 *
	 * Retrieve the prefix of the group control, which is `{{ControlName}}_`.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @return string Control prefix.
	 */
	public function get_controls_prefix() {
		return $this-&gt;args[&#039;name&#039;] . &#039;_&#039;;
	}

	/**
	 * Get group control classes.
	 *
	 * Retrieve the classes of the group control.
	 *
	 * @since 1.0.0
	 * @access public
	 *
	 * @return string Group control classes.
	 */
	public function get_base_group_classes() {
		return &#039;elementor-group-control-&#039; . static::get_type() . &#039; elementor-group-control&#039;;
	}

	/**
	 * Init fields.
	 *
	 * Initialize group control fields.
	 *
	 * @abstract
	 * @since 1.2.2
	 * @access protected
	 */
	abstract protected function init_fields();

	/**
	 * Get default options.
	 *
	 * Retrieve the default options of the group control. Used to return the
	 * default options while initializing the group control.
	 *
	 * @since 1.9.0
	 * @access protected
	 *
	 * @return array Default group control options.
	 */
	protected function get_default_options() {
		return [];
	}

	/**
	 * Get child default arguments.
	 *
	 * Retrieve the default arguments for all the child controls for a specific group
	 * control.
	 *
	 * @since 1.2.2
	 * @access protected
	 *
	 * @return array Default arguments for all the child controls.
	 */
	protected function get_child_default_args() {
		return [];
	}

	/**
	 * Filter fields.
	 *
	 * Filter which controls to display, using `include`, `exclude` and the
	 * `condition` arguments.
	 *
	 * @since 1.2.2
	 * @access protected
	 *
	 * @return array Control fields.
	 */
	protected function filter_fields() {
		$args = $this-&gt;get_args();

		$fields = $this-&gt;get_fields();

		if ( ! empty( $args[&#039;include&#039;] ) ) {
			$fields = array_intersect_key( $fields, array_flip( $args[&#039;include&#039;] ) );
		}

		if ( ! empty( $args[&#039;exclude&#039;] ) ) {
			$fields = array_diff_key( $fields, array_flip( $args[&#039;exclude&#039;] ) );
		}

		return $fields;
	}

	/**
	 * Add group arguments to field.
	 *
	 * Register field arguments to group control.
	 *
	 * @since 1.2.2
	 * @access protected
	 *
	 * @param string $control_id Group control id.
	 * @param array  $field_args Group control field arguments.
	 *
	 * @return array
	 */
	protected function add_group_args_to_field( $control_id, $field_args ) {
		$args = $this-&gt;get_args();

		if ( ! empty( $args[&#039;tab&#039;] ) ) {
			$field_args[&#039;tab&#039;] = $args[&#039;tab&#039;];
		}

		if ( ! empty( $args[&#039;section&#039;] ) ) {
			$field_args[&#039;section&#039;] = $args[&#039;section&#039;];
		}

		$field_args[&#039;classes&#039;] = $this-&gt;get_base_group_classes() . &#039; elementor-group-control-&#039; . $control_id;

		foreach ( [ &#039;condition&#039;, &#039;conditions&#039; ] as $condition_type ) {
			if ( ! empty( $args[ $condition_type ] ) ) {
				if ( empty( $field_args[ $condition_type ] ) ) {
					$field_args[ $condition_type ] = [];
				}

				$field_args[ $condition_type ] += $args[ $condition_type ];
			}
		}

		return $field_args;
	}

	/**
	 * Prepare fields.
	 *
	 * Process group control fields before adding them to `add_control()`.
	 *
	 * @since 1.2.2
	 * @access protected
	 *
	 * @param array $fields Group control fields.
	 *
	 * @return array Processed fields.
	 */
	protected function prepare_fields( $fields ) {
		$popover_options = $this-&gt;get_options( &#039;popover&#039; );

		$popover_name = ! $popover_options ? null : $popover_options[&#039;starter_name&#039;];

		foreach ( $fields as $field_key =&gt; &amp;$field ) {
			if ( $popover_name ) {
				$field[&#039;condition&#039;][ $popover_name . &#039;!&#039; ] = &#039;&#039;;
			}

			if ( isset( $this-&gt;args[&#039;fields_options&#039;][&#039;__all&#039;] ) ) {
				$field = array_merge( $field, $this-&gt;args[&#039;fields_options&#039;][&#039;__all&#039;] );
			}

			if ( isset( $this-&gt;args[&#039;fields_options&#039;][ $field_key ] ) ) {
				$field = array_merge( $field, $this-&gt;args[&#039;fields_options&#039;][ $field_key ] );
			}

			if ( ! empty( $field[&#039;condition&#039;] ) ) {
				$field = $this-&gt;add_condition_prefix( $field );
			}

			if ( ! empty( $field[&#039;conditions&#039;] ) ) {
				$field[&#039;conditions&#039;] = $this-&gt;add_conditions_prefix( $field[&#039;conditions&#039;] );
			}

			if ( ! empty( $field[&#039;selectors&#039;] ) ) {
				$field[&#039;selectors&#039;] = $this-&gt;handle_selectors( $field[&#039;selectors&#039;] );
			}

			if ( ! empty( $field[&#039;device_args&#039;] ) ) {
				foreach ( $field[&#039;device_args&#039;] as $device =&gt; $device_arg ) {
					if ( ! empty( $field[&#039;device_args&#039;][ $device ][&#039;condition&#039;] ) ) {
						$field[&#039;device_args&#039;][ $device ] = $this-&gt;add_condition_prefix( $field[&#039;device_args&#039;][ $device ] );
					}

					if ( ! empty( $field[&#039;device_args&#039;][ $device ][&#039;conditions&#039;] ) ) {
						$field[&#039;device_args&#039;][ $device ][&#039;conditions&#039;] = $this-&gt;add_conditions_prefix( $field[&#039;device_args&#039;][ $device ][&#039;conditions&#039;] );
					}

					if ( ! empty( $device_arg[&#039;selectors&#039;] ) ) {
						$field[&#039;device_args&#039;][ $device ][&#039;selectors&#039;] = $this-&gt;handle_selectors( $device_arg[&#039;selectors&#039;] );
					}
				}
			}
		}

		return $fields;
	}

	/**
	 * Init options.
	 *
	 * Initializing group control options.
	 *
	 * @since 1.9.0
	 * @access private
	 */
	private function init_options() {
		$default_options = [
			&#039;popover&#039; =&gt; [
				&#039;starter_name&#039; =&gt; &#039;popover_toggle&#039;,
				&#039;starter_value&#039; =&gt; &#039;custom&#039;,
				&#039;starter_title&#039; =&gt; &#039;&#039;,
			],
		];

		$this-&gt;options = array_replace_recursive( $default_options, $this-&gt;get_default_options() );
	}

	/**
	 * Init arguments.
	 *
	 * Initializing group control base class.
	 *
	 * @since 1.2.2
	 * @access protected
	 *
	 * @param array $args Group control settings value.
	 */
	protected function init_args( $args ) {
		$this-&gt;args = array_merge( $this-&gt;get_default_args(), $this-&gt;get_child_default_args(), $args );

		if ( isset( $this-&gt;args[&#039;scheme&#039;] ) ) {
			$this-&gt;args[&#039;global&#039;][&#039;default&#039;] = Plugin::$instance-&gt;kits_manager-&gt;convert_scheme_to_global( $this-&gt;args[&#039;scheme&#039;] );
		}
	}

	/**
	 * Get default arguments.
	 *
	 * Retrieve the default arguments of the group control. Used to return the
	 * default arguments while initializing the group control.
	 *
	 * @since 1.2.2
	 * @access private
	 *
	 * @return array Control default arguments.
	 */
	private function get_default_args() {
		return [
			&#039;default&#039; =&gt; &#039;&#039;,
			&#039;selector&#039; =&gt; &#039;{{WRAPPER}}&#039;,
			&#039;fields_options&#039; =&gt; [],
		];
	}

	/**
	 * Add condition prefix.
	 *
	 * Used to add the group prefix to controls with conditions, to
	 * distinguish them from other controls with the same name.
	 *
	 * This way Elementor can apply condition logic to a specific control in a
	 * group control.
	 *
	 * @since 1.2.0
	 * @access private
	 *
	 * @param array $field Group control field.
	 *
	 * @return array Group control field.
	 */
	private function add_condition_prefix( $field ) {
		$controls_prefix = $this-&gt;get_controls_prefix();

		$prefixed_condition_keys = array_map(
			function( $key ) use ( $controls_prefix ) {
				return $controls_prefix . $key;
			},
			array_keys( $field[&#039;condition&#039;] )
		);

		$field[&#039;condition&#039;] = array_combine(
			$prefixed_condition_keys,
			$field[&#039;condition&#039;]
		);

		return $field;
	}

	private function add_conditions_prefix( $conditions ) {
		$controls_prefix = $this-&gt;get_controls_prefix();

		foreach ( $conditions[&#039;terms&#039;] as &amp; $condition ) {
			if ( isset( $condition[&#039;terms&#039;] ) ) {
				$condition = $this-&gt;add_conditions_prefix( $condition );

				continue;
			}

			$condition[&#039;name&#039;] = $controls_prefix . $condition[&#039;name&#039;];
		}

		return $conditions;
	}

	/**
	 * Handle selectors.
	 *
	 * Used to process the CSS selector of group control fields. When using
	 * group control, Elementor needs to apply the selector to different fields.
	 * This method handles the process.
	 *
	 * In addition, it handles selector values from other fields and process the
	 * css.
	 *
	 * @since 1.2.2
	 * @access private
	 *
	 * @param array $selectors An array of selectors to process.
	 *
	 * @return array Processed selectors.
	 */
	private function handle_selectors( $selectors ) {
		$args = $this-&gt;get_args();

		$selectors = array_combine(
			array_map(
				function( $key ) use ( $args ) {
					return str_replace( &#039;{{SELECTOR}}&#039;, $args[&#039;selector&#039;], $key );
				}, array_keys( $selectors )
			),
			$selectors
		);

		if ( ! $selectors ) {
			return $selectors;
		}

		$controls_prefix = $this-&gt;get_controls_prefix();

		foreach ( $selectors as &amp;$selector ) {
			$selector = preg_replace_callback( &#039;/{{\K(.*?)(?=}})/&#039;, function( $matches ) use ( $controls_prefix ) {
				$is_external_reference = false;

				return preg_replace_callback( &#039;/[^ ]+?(?=\.)\./&#039;, function( $sub_matches ) use ( $controls_prefix, &amp;$is_external_reference ) {
					$placeholder = $sub_matches[0];

					if ( &#039;external.&#039; === $placeholder ) {
						$is_external_reference = true;

						return &#039;&#039;;
					}

					if ( $is_external_reference ) {
						$is_external_reference = false;

						return $placeholder;
					}

					return $controls_prefix . $placeholder;
				}, $matches[1] );
			}, $selector );
		}

		return $selectors;
	}

	/**
	 * Start popover.
	 *
	 * Starts a group controls popover.
	 *
	 * @since 1.9.1
	 * @access private
	 * @param Controls_Stack $element Element.
	 */
	private function start_popover( Controls_Stack $element ) {
		$popover_options = $this-&gt;get_options( &#039;popover&#039; );

		$settings = $this-&gt;get_args();

		if ( isset( $settings[&#039;global&#039;] ) ) {
			if ( ! isset( $popover_options[&#039;settings&#039;][&#039;global&#039;] ) ) {
				$popover_options[&#039;settings&#039;][&#039;global&#039;] = [];
			}

			$popover_options[&#039;settings&#039;][&#039;global&#039;] = array_replace_recursive( $popover_options[&#039;settings&#039;][&#039;global&#039;], $settings[&#039;global&#039;] );
		}

		if ( isset( $settings[&#039;label&#039;] ) ) {
			$label = $settings[&#039;label&#039;];
		} else {
			$label = $popover_options[&#039;starter_title&#039;];
		}

		$control_params = [
			&#039;type&#039; =&gt; Controls_Manager::POPOVER_TOGGLE,
			&#039;label&#039; =&gt; $label,
			&#039;return_value&#039; =&gt; $popover_options[&#039;starter_value&#039;],
		];

		if ( ! empty( $popover_options[&#039;settings&#039;] ) ) {
			$control_params = array_replace_recursive( $control_params, $popover_options[&#039;settings&#039;] );
		}

		foreach ( [ &#039;condition&#039;, &#039;conditions&#039; ] as $key ) {
			if ( ! empty( $settings[ $key ] ) ) {
				$control_params[ $key ] = $settings[ $key ];
			}
		}

		$starter_name = $popover_options[&#039;starter_name&#039;];

		if ( isset( $this-&gt;args[&#039;fields_options&#039;][ $starter_name ] ) ) {
			$control_params = array_merge( $control_params, $this-&gt;args[&#039;fields_options&#039;][ $starter_name ] );
		}

		$control_params[&#039;groupPrefix&#039;] = $this-&gt;get_controls_prefix();

		$element-&gt;add_control( $this-&gt;get_controls_prefix() . $starter_name, $control_params );

		$element-&gt;start_popover();
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-content%2Fplugins%2Felementor%2Fincludes%2Fcontrols%2Fgroups'>⬅ Back to Directory</a>