File "shared-widget-controls-trait.php"

Full Path: /home2/sdektunc/cepali.edu.mx/wp-content/plugins/elementor/core/base/traits/shared-widget-controls-trait.php
File size: 6.99 KB
MIME-type: text/x-php
Charset: utf-8

<?php

namespace Elementor\Core\Base\Traits;

use Elementor\Controls_Manager;
use Elementor\Modules\FloatingButtons\Control\Hover_Animation_Floating_Buttons;
use Elementor\Plugin;
use Elementor\Shapes;
use Elementor\Utils;

trait Shared_Widget_Controls_Trait {

	protected $border_width_range = [
		'min' => 0,
		'max' => 10,
		'step' => 1,
	];

	protected function add_html_tag_control( string $name, string $default = 'h2' ): void {
		$this->add_control(
			$name,
			[
				'label' => esc_html__( 'HTML Tag', 'elementor' ),
				'type' => Controls_Manager::SELECT,
				'options' => [
					'h1' => 'H1',
					'h2' => 'H2',
					'h3' => 'H3',
					'h4' => 'H4',
					'h5' => 'H5',
					'h6' => 'H6',
					'div' => 'div',
					'span' => 'span',
					'p' => 'p',
				],
				'default' => $default,
			]
		);
	}

	/**
	 * Remove any child arrays where all properties are empty
	 */
	protected function clean_array(
		$input_array = []
	) {
		$output_array = array_filter( $input_array, function( $sub_array ) {
			// Use array_filter on the sub array
			$filtered_sub_array = array_filter( $sub_array, function( $val ) {
				// Filter out empty or null values
				return ! is_null( $val ) && '' !== $val;
			} );
			// A non-empty result means the sub array contains some non-empty value(s)
			return ! empty( $filtered_sub_array );
		} );
		return $output_array;
	}

	protected function get_link_attributes(
		$link = [],
		$other_attributes = []
	) {
		$url_attrs = [];
		$rel_string = '';

		if ( ! empty( $link['url'] ) ) {
			$url_attrs['href'] = esc_url( $link['url'] );
		}

		if ( ! empty( $link['is_external'] ) ) {
			$url_attrs['target'] = '_blank';
			$rel_string .= 'noopener ';
		}

		if ( ! empty( $link['nofollow'] ) ) {
			$rel_string .= 'nofollow ';
		}

		if ( ! empty( $rel_string ) ) {
			$url_attrs['rel'] = $rel_string;
		}

		/**
		 * Note - we deliberately merge $other_attributes second
		 * to allow overriding default attributes values such as a more formatted href
		 */
		$url_combined_attrs = array_merge(
			$url_attrs,
			$other_attributes,
			Utils::parse_custom_attributes( $link['custom_attributes'] ?? '' ),
		);

		return $url_combined_attrs;
	}

	protected function add_icons_per_row_control(
		string $name = 'icons_per_row',
		$options = [
			'2' => '2',
			'3' => '3',
		],
		string $default = '3',
		$label = '',
		$selector_custom_property = '--e-link-in-bio-icon-columns'
	): void {
		if ( ! $label ) {
			$label = esc_html__( 'Icons Per Row', 'elementor' );
		}
		$this->add_control(
			$name,
			[
				'label' => $label,
				'type' => Controls_Manager::SELECT,
				'options' => $options,
				'default' => $default,
				'render_type' => 'template',
				'selectors' => [
					'{{WRAPPER}} .e-link-in-bio' => $selector_custom_property . ': {{VALUE}};',
				],
			]
		);
	}

	protected function add_slider_control(
		string $name,
		array $args = []
	): void {
		$default_args = [
			'type' => Controls_Manager::SLIDER,
			'default' => [
				'unit' => 'px',
			],
			'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
			'range' => [
				'px' => [
					'min' => 0,
					'max' => 100,
					'step' => 1,
				],
			],
		];

		$this->add_control(
			$name,
			array_merge_recursive( $default_args, $args )
		);
	}

	protected function add_borders_control(
		string $prefix,
		array $show_border_args = [],
		array $border_width_args = [],
		array $border_color_args = []
	): void {
		$show_border = [
			'label' => esc_html__( 'Border', 'elementor' ),
			'type' => Controls_Manager::SWITCHER,
			'label_on' => esc_html__( 'Yes', 'elementor' ),
			'label_off' => esc_html__( 'No', 'elementor' ),
			'return_value' => 'yes',
			'default' => '',
		];

		$this->add_control(
			$prefix . '_show_border',
			array_merge( $show_border, $show_border_args )
		);

		$condition = [
			$prefix . '_show_border' => 'yes',
		];

		if ( isset( $border_width_args['condition'] ) ) {
			$condition = array_merge( $condition, $border_width_args['condition'] );
			unset( $border_width_args['condition'] );
		}

		$border_width = [
			'label' => esc_html__( 'Border Width', 'elementor' ) . ' (px)',
			'type' => Controls_Manager::SLIDER,
			'size_units' => [ 'px' ],
			'range' => [
				'px' => $this->border_width_range,
			],
			'condition' => $condition,
			'default' => [
				'unit' => 'px',
				'size' => 1,
			],
		];

		$this->add_responsive_control(
			$prefix . '_border_width',
			array_merge( $border_width, $border_width_args ),
		);

		$condition = [
			$prefix . '_show_border' => 'yes',
		];

		if ( isset( $border_color_args['condition'] ) ) {
			$condition = array_merge( $condition, $border_color_args['condition'] );
			unset( $border_color_args['condition'] );
		}

		$border_color = [
			'label' => esc_html__( 'Border Color', 'elementor' ),
			'type' => Controls_Manager::COLOR,
			'condition' => $condition,
			'default' => '#000000',
		];

		$this->add_control(
			$prefix . '_border_color',
			array_merge( $border_color, $border_color_args )
		);
	}

	protected function get_shape_divider( $side = 'bottom' ) {
		$settings = $this->settings;
		$base_setting_key = "identity_section_style_cover_divider_$side";
		$file_name = $settings[ $base_setting_key ];

		if ( empty( $file_name ) ) {
			return [];
		}

		$negative = ! empty( $settings[ $base_setting_key . '_negative' ] );
		$shape_path = Shapes::get_shape_path( $file_name, $negative );

		if ( ! is_file( $shape_path ) || ! is_readable( $shape_path ) ) {
			return [];
		}

		return [
			'negative' => $negative,
			'svg' => Utils::file_get_contents( $shape_path ),
		];
	}

	protected function print_shape_divider( $side = 'bottom' ) {
		$shape_divider = $this->get_shape_divider( $side );

		if ( empty( $shape_divider ) ) {
			return;
		}
		?>
		<div
			class="elementor-shape elementor-shape-<?php echo esc_attr( $side ); ?>"
			data-negative="<?php
			echo esc_attr( $shape_divider['negative'] ? 'true' : 'false' );
			?>"
		>
			<?php
			// PHPCS - The file content is being read from a strict file path structure.
			echo $shape_divider['svg']; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
			?>
		</div>
		<?php
	}

	protected function get_configured_breakpoints( $add_desktop = 'true' ) {
		$active_devices = Plugin::$instance->breakpoints->get_active_devices_list( [ 'reverse' => true ] );
		$active_breakpoint_instances = Plugin::$instance->breakpoints->get_active_breakpoints();

		$devices_options = [];

		foreach ( $active_devices as $device_key ) {
			$device_label = 'desktop' === $device_key ? esc_html__( 'Desktop', 'elementor' ) : $active_breakpoint_instances[ $device_key ]->get_label();
			$devices_options[ $device_key ] = $device_label;
		}

		return [
			'active_devices' => $active_devices,
			'devices_options' => $devices_options,
		];
	}

	protected function add_hover_animation_control(
		string $name,
		array $args = []
	): void {

		$this->add_control(
			$name,
			array_merge(
				[
					'label' => esc_html__( 'Hover Animation', 'elementor' ),
					'type' => Hover_Animation_Floating_Buttons::TYPE,
					'frontend_available' => true,
					'default' => 'grow',
				],
				$args
			)
		);
	}
}