Prosellers Shell V2.0

Editing: Border.php

Cancel

<?php
/**
 * Border Field.
 *
 * @package Divi
 * @subpackage Builder
 */

/**
 * Handles border field for modules.
 */
class ET_Builder_Module_Field_Border extends ET_Builder_Module_Field_Base {

/**
	 * @var ET_Core_Data_Utils
	 */
	protected static $_;

/**
	 * @var ET_Builder_Module_Helper_ResponsiveOptions
	 *
	 * @since 3.23
	 */
	public static $responsive = null;

protected static $_is_default = array();

/**
	 * List of no border reset.
	 *
	 * @since 3.23 Remove pricing tables from the list to allow border reset.
	 *
	 * @var array
	 */
	protected static $_no_border_reset = array(
		'et_pb_accordion',
		'et_pb_accordion_item',
		'et_pb_pricing_table',
		'et_pb_tabs',
		'et_pb_toggle',
		'et_pb_social_media_follow',
	);

/**
	 * Option template helper.
	 *
	 * @var ET_Builder_Module_Helper_OptionTemplate
	 */
	public $template;

/**
	 * ET_Builder_Module_Field_Border constructor.
	 */
	public function __construct() {
		$this->template = et_pb_option_template();
		self::$_        = ET_Core_Data_Utils::instance();
		$this->set_template();
	}

/**
	 * Set option template for borders
	 *
	 * @since 3.28
	 *
	 * @return void
	 */
	public function set_template() {
		$template = $this->template;
		if ( $template->is_enabled() && ! $template->has( 'border' ) ) {
			$template_placeholders = $template->placeholders(
				array(
					'suffix'              => null,
					'label_prefix'        => null,
					'tab_slug'            => null,
					'toggle_slug'         => null,
					'color_type'          => null,
					'depends_on'          => null,
					'depends_show_if_not' => null,
					'depends_show_if'     => null,
					'use_radius'          => null,
					'sub_toggle'          => null,
					'defaults'            => array(
						'border_radii'  => null,
						'border_styles' => array(
							'width' => null,
							'color' => null,
							'style' => null,
						),
					),
				)
			);
			$template->add( 'border', $this->get_fields( $template_placeholders ) );
		}
	}

/**
	 * Get border fields.
	 *
	 * @since 3.28 Add option template support
	 * @since 3.23 Add support for responsive settings. Add allowed units for some range fields.
	 *
	 * @param array $args               Border settings arguments.
	 * @param bool  $return_template_id return template id
	 *
	 * @return array Border fields.
	 */
	public function get_fields( array $args = array(), $return_template_id = false ) {
		$settings = shortcode_atts(
			array(
				'suffix'              => '',
				'label_prefix'        => '',
				'tab_slug'            => 'advanced',
				'toggle_slug'         => 'border',
				'color_type'          => 'color-alpha',
				'depends_on'          => null,
				'depends_show_if_not' => null,
				'depends_show_if'     => null,
				'sub_toggle'          => null,
				'use_radius'          => true,
				'defaults'            => array(
					'border_radii'  => 'on||||',
					'border_styles' => array(
						'width' => '0px',
						'color' => '#333333',
						'style' => 'solid',
					),
				),
			),
			$args
		);

if ( $this->template->is_enabled() && $this->template->has( 'border' ) ) {
			return $this->template->create( 'border', $settings, $return_template_id );
		}

$additional_options = array();
		$suffix             = $settings['suffix'];
		$defaults           = $settings['defaults']['border_styles'];
		$defaultUnit        = 'px';

if ( $settings['use_radius'] ) {
			$additional_options[ "border_radii{$suffix}" ] = array(
				'label'           => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Rounded Corners', 'et_builder' ) ),
				'type'            => 'border-radius',
				'hover'           => 'tabs',
				'validate_input'  => true,
				'default'         => $settings['defaults']['border_radii'],
				'tab_slug'        => $settings['tab_slug'],
				'toggle_slug'     => $settings['toggle_slug'],
				'sub_toggle'      => $settings['sub_toggle'],
				'attr_suffix'     => $suffix,
				'option_category' => 'border',
				'description'     => esc_html__( 'Here you can control the corner radius of this element. Enable the link icon to control all four corners at once, or disable to define custom values for each.', 'et_builder' ),
				'tooltip'         => esc_html__( 'Sync values', 'et_builder' ),
				'mobile_options'  => true,
				'sticky'          => true,
				'allowed_units'   => array( '%', 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
			);
		} else {
			$additional_options[ "border_radii{$suffix}" ] = array();
		}

$additional_options[ "border_styles{$suffix}" ] = array(
			'label'               => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Border Styles', 'et_builder' ) ),
			'description'         => esc_html__( 'You can add borders to any element, customize their appearance and assign unique styles to each edge.', 'et_builder' ),
			'tab_slug'            => $settings['tab_slug'],
			'toggle_slug'         => $settings['toggle_slug'],
			'sub_toggle'          => $settings['sub_toggle'],
			'type'                => 'composite',
			'attr_suffix'         => $suffix,
			'option_category'     => 'border',
			'composite_type'      => 'tabbed',
			'composite_structure' => array(
				'border_all'    => array(
					'icon'     => 'border-all',
					'controls' => array(
						"border_width_all{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Border Width', 'et_builder' ) ),
							'description'    => esc_html__( 'Increasing the width of the border will increase its size/thickness.', 'et_builder' ),
							'type'           => 'range',
							'hover'          => 'tabs',
							'default'        => $defaults['width'],
							'default_unit'   => $defaultUnit,
							'allowed_units'  => array( 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
							'range_settings' => array(
								'min'       => 0,
								'max'       => 50,
								'step'      => 1,
								'min_limit' => 0,
							),
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_color_all{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Border Color', 'et_builder' ) ),
							'description'    => esc_html__( 'Pick a color to be used for the border.', 'et_builder' ),
							'type'           => $settings['color_type'],
							'hover'          => 'tabs',
							'default'        => $defaults['color'],
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_style_all{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Border Style', 'et_builder' ) ),
							'description'    => esc_html__( 'Borders support various different styles, each of which will change the shape of the border element.', 'et_builder' ),
							'type'           => 'select',
							'options'        => et_builder_get_border_styles(),
							'default'        => $defaults['style'],
							'context'        => "border_styles{$suffix}",
							'hover'          => 'tabs',
							'mobile_options' => true,
							'sticky'         => true,
						),
					),
				),
				'border_top'    => array(
					'icon'     => 'border-top',
					'controls' => array(
						"border_width_top{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Top Border Width', 'et_builder' ) ),
							'description'    => esc_html__( 'Increasing the width of the border will increase its size/thickness.', 'et_builder' ),
							'type'           => 'range',
							'hover'          => 'tabs',
							'allow_empty'    => true,
							'default_from'   => "border_all.controls.border_width_all{$suffix}",
							'default_unit'   => $defaultUnit,
							'allowed_units'  => array( 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
							'range_settings' => array(
								'min'       => 0,
								'max'       => 50,
								'step'      => 1,
								'min_limit' => 0,
							),
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_color_top{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Top Border Color', 'et_builder' ) ),
							'description'    => esc_html__( 'Pick a color to be used for the border.', 'et_builder' ),
							'type'           => $settings['color_type'],
							'hover'          => 'tabs',
							'default_from'   => "border_all.controls.border_color_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_style_top{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Top Border Style', 'et_builder' ) ),
							'description'    => esc_html__( 'Borders support various different styles, each of which will change the shape of the border element.', 'et_builder' ),
							'type'           => 'select',
							'options'        => et_builder_get_border_styles(),
							'default_from'   => "border_all.controls.border_style_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'hover'          => 'tabs',
							'mobile_options' => true,
							'sticky'         => true,
						),
					),
				),
				'border_right'  => array(
					'icon'     => 'border-right',
					'controls' => array(
						"border_width_right{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Right Border Width', 'et_builder' ) ),
							'description'    => esc_html__( 'Increasing the width of the border will increase its size/thickness.', 'et_builder' ),
							'type'           => 'range',
							'hover'          => 'tabs',
							'allow_empty'    => true,
							'default_from'   => "border_all.controls.border_width_all{$suffix}",
							'default_unit'   => $defaultUnit,
							'allowed_units'  => array( 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
							'range_settings' => array(
								'min'       => 0,
								'max'       => 50,
								'step'      => 1,
								'min_limit' => 0,
							),
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_color_right{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Right Border Color', 'et_builder' ) ),
							'description'    => esc_html__( 'Pick a color to be used for the border.', 'et_builder' ),
							'type'           => $settings['color_type'],
							'hover'          => 'tabs',
							'default_from'   => "border_all.controls.border_color_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_style_right{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Right Border Style', 'et_builder' ) ),
							'description'    => esc_html__( 'Borders support various different styles, each of which will change the shape of the border element.', 'et_builder' ),
							'type'           => 'select',
							'options'        => et_builder_get_border_styles(),
							'default_from'   => "border_all.controls.border_style_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'hover'          => 'tabs',
							'mobile_options' => true,
							'sticky'         => true,
						),
					),
				),
				'border_bottom' => array(
					'icon'     => 'border-bottom',
					'controls' => array(
						"border_width_bottom{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Bottom Border Width', 'et_builder' ) ),
							'description'    => esc_html__( 'Increasing the width of the border will increase its size/thickness.', 'et_builder' ),
							'type'           => 'range',
							'hover'          => 'tabs',
							'allow_empty'    => true,
							'default_from'   => "border_all.controls.border_width_all{$suffix}",
							'default_unit'   => $defaultUnit,
							'allowed_units'  => array( 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
							'range_settings' => array(
								'min'       => 0,
								'max'       => 50,
								'step'      => 1,
								'min_limit' => 0,
							),
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_color_bottom{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Bottom Border Color', 'et_builder' ) ),
							'description'    => esc_html__( 'Pick a color to be used for the border.', 'et_builder' ),
							'type'           => $settings['color_type'],
							'hover'          => 'tabs',
							'default_from'   => "border_all.controls.border_color_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_style_bottom{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Bottom Border Style', 'et_builder' ) ),
							'description'    => esc_html__( 'Borders support various different styles, each of which will change the shape of the border element.', 'et_builder' ),
							'type'           => 'select',
							'options'        => et_builder_get_border_styles(),
							'default_from'   => "border_all.controls.border_style_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'hover'          => 'tabs',
							'mobile_options' => true,
							'sticky'         => true,
						),
					),
				),
				'border_left'   => array(
					'icon'     => 'border-left',
					'controls' => array(
						"border_width_left{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Left Border Width', 'et_builder' ) ),
							'description'    => esc_html__( 'Increasing the width of the border will increase its size/thickness.', 'et_builder' ),
							'type'           => 'range',
							'hover'          => 'tabs',
							'allow_empty'    => true,
							'default_from'   => "border_all.controls.border_width_all{$suffix}",
							'default_unit'   => $defaultUnit,
							'allowed_units'  => array( 'em', 'rem', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw' ),
							'range_settings' => array(
								'min'       => 0,
								'max'       => 50,
								'step'      => 1,
								'min_limit' => 0,
							),
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_color_left{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Left Border Color', 'et_builder' ) ),
							'description'    => esc_html__( 'Pick a color to be used for the border.', 'et_builder' ),
							'type'           => $settings['color_type'],
							'hover'          => 'tabs',
							'default_from'   => "border_all.controls.border_color_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'mobile_options' => true,
							'sticky'         => true,
						),
						"border_style_left{$suffix}" => array(
							'label'          => sprintf( '%1$s%2$s', '' !== $settings['label_prefix'] ? sprintf( '%1$s ', $settings['label_prefix'] ) : '', esc_html__( 'Left Border Style', 'et_builder' ) ),
							'description'    => esc_html__( 'Borders support various different styles, each of which will change the shape of the border element.', 'et_builder' ),
							'type'           => 'select',
							'options'        => et_builder_get_border_styles(),
							'default_from'   => "border_all.controls.border_style_all{$suffix}",
							'context'        => "border_styles{$suffix}",
							'hover'          => 'tabs',
							'mobile_options' => true,
							'sticky'         => true,
						),
					),
				),
			),
		);

// Override default_from. In some cases, we need to set different default from the parent
		// modules. For example, in Pricing Tables -> Pricing Area borders, we only want to set
		// default value for border bottom width, but keep the rest to inherit from border all.
		if ( ! empty( $settings['defaults']['composite'] ) ) {
			$composites     = $additional_options[ "border_styles{$suffix}" ]['composite_structure'];
			$new_composites = array();
			foreach ( $settings['defaults']['composite'] as $border_position => $default_controls ) {
				// Make sure the border position property exists on additional_options.
				if ( ! isset( $composites[ $border_position ] ) ) {
					continue;
				}

// Make sure it has controls.
				if ( ! isset( $composites[ $border_position ]['controls'] ) ) {
					continue;
				}

// Make sure target controls are not empty.
				if ( ! empty( $default_controls ) ) {
					foreach ( $default_controls as $control_key => $control_default ) {
						// Make sure the target control exists on border_styles.
						$control_suffix = $control_key . $suffix;
						if ( isset( $composites[ $border_position ]['controls'][ $control_suffix ] ) ) {
							// Unset default_from and set default attribute.
							unset( $composites[ $border_position ]['controls'][ $control_suffix ]['default_from'] );
							$composites[ $border_position ]['controls'][ $control_suffix ]['default'] = $control_default;
						}
					}
				}
			}

// Set composites structures back to additional options border styles.
			$additional_options[ "border_styles{$suffix}" ]['composite_structure'] = $composites;
		}

// Add options dependency
		if ( ! is_null( $settings['depends_on'] ) ) {
			foreach ( $additional_options as &$option ) {
				$option['depends_on']          = $settings['depends_on'];
				$option['depends_show_if']     = $settings['depends_show_if'];
				$option['depends_show_if_not'] = $settings['depends_show_if_not'];
			}
		}

return $additional_options;
	}

/**
	 * Get border radii CSS styles.
	 *
	 * @since 3.23 Add responsive setting support.
	 * @since 4.6.0 Add sticky style support
	 *
	 * @param  array          $atts            All module attributes.
	 * @param  array          $advanced_fields All module advanced fields definition.
	 * @param  string         $suffix          Border options group or toggle name.
	 * @param  boolean|string $overflow        Overflow status or type.
	 * @param  boolean        $is_hover        Hover options status.
	 * @param  string         $device          Current active device.
	 * @param boolean        $is_sticky       Sticky options status.
	 *
	 * @return string                          Generated border radii styles.
	 */
	public function get_radii_style( array $atts, array $advanced_fields, $suffix = '', $overflow = true, $is_hover = false, $device = 'desktop', $is_sticky = false ) {
		$style = '';

$important = '';

// Backward compatibility. Use `border` settings as default if exists.
		$legacy_border = self::$_->array_get( $advanced_fields, 'border', array() );

$borders_fields = self::$_->array_get(
			$advanced_fields,
			'borders',
			array(
				'default' => $legacy_border,
			)
		);

if ( isset( $borders_fields['css']['important'] ) ) {
			if ( 'plugin_only' === $borders_fields['css']['important'] ) {
				$important = et_builder_has_limitation( 'force_use_global_important' ) ? '!important' : '';
			} else {
				$important = '!important';
			}
		}

// Border Radius CSS
		$is_desktop   = 'desktop' === $device;
		$value_suffix = '';

if ( $is_hover ) {
			$value_suffix = et_pb_hover_options()->get_suffix();
		}

if ( $is_sticky ) {
			$value_suffix = et_pb_sticky_options()->get_suffix();
		}

$value_suffix = ! $is_hover && ! $is_sticky && ! $is_desktop ? "_{$device}" : $value_suffix;

// Get border settings based on main border_radii field on option template.
		// This used to refer to module's advanced_fields property but for performance reason
		// it is now fetched from option template field's instead.
		// Rebuilt field on option template is cached on property so it is safe to get it on demand.
		$border_advanced_setting = self::$_->array_get( $advanced_fields, "border{$suffix}", array() );
		$border_template_id      = ET_Builder_Module_Fields_Factory::get( 'Border' )->get_fields( $border_advanced_setting, true );
		$border_fields           = $this->template->is_enabled() ? $this->template->rebuild_field_template( $border_template_id ) : array();

// Border radii settings
		$settings = self::$_->array_get( $border_fields, "border_radii{$suffix}", array() );
		$radii    = isset( $atts[ "border_radii{$suffix}{$value_suffix}" ] ) ? $atts[ "border_radii{$suffix}{$value_suffix}" ] : false;

// Bail early if current device value doesn't exist.
		if ( false === $radii || empty( $radii ) ) {
			return '';
		}

// Bail early if current device is tablet/phone and responsive is disabled.
		if ( ! $is_desktop && ! et_pb_responsive_options()->is_responsive_enabled( $atts, "border_radii{$suffix}" ) ) {
			return '';
		}

// We need the default radius value.
		if ( ! isset( $settings['default'] ) ) {
			$settings['default'] = 'on||||';
		}

// Make sure current radii value is different with default value. Default of desktop is
		// default. Default of tablet is desktop and default of phone is tablet.
		if ( isset( $settings['default'] ) && ! $is_desktop ) {
			// Get previous device value.
			$previous_suffix = 'phone' === $device ? '_tablet' : '';
			$radii_previous  = isset( $atts[ "border_radii{$suffix}{$previous_suffix}" ] ) ? $atts[ "border_radii{$suffix}{$previous_suffix}" ] : false;
			if ( $radii_previous ) {
				$settings['default'] = $radii_previous;
			}
		}

if ( isset( $settings['default'] ) && ( $settings['default'] !== $radii ) ) {
			$radii = explode( '|', $radii );
			if ( count( $radii ) === 5 ) {
				$top_left_radius     = empty( $radii[1] ) ? '0' : esc_html( $radii[1] );
				$top_right_radius    = empty( $radii[2] ) ? '0' : esc_html( $radii[2] );
				$bottom_right_radius = empty( $radii[3] ) ? '0' : esc_html( $radii[3] );
				$bottom_left_radius  = empty( $radii[4] ) ? '0' : esc_html( $radii[4] );

$important = et_core_intentionally_unescaped( $important, 'fixed_string' );
				$style     = "border-radius: {$top_left_radius} {$top_right_radius} {$bottom_right_radius} {$bottom_left_radius}{$important};";
				if ( true === $overflow || in_array( $overflow, array( 'overflow-x', 'overflow-y' ) ) ) {
					// $overflow can be either a boolean or a string: 'overflow-x' / 'overflow-y'
					// If it is a boolean the CSS property is set to 'overflow'
					$overflow_property = in_array( $overflow, array( 'overflow-x', 'overflow-y' ), true ) ? $overflow : 'overflow';
					$style            .= "{$overflow_property}: hidden{$important};";
				}
			}
		}

return $style;
	}

/**
	 * Get border styles CSS styles.
	 *
	 * @since 3.23 Add responsive setting support.
	 * @since 4.6.0 Add sticky style support
	 *
	 * @param  array   $attrs           All module attributes.
	 * @param  array   $advanced_fields All module advanced fields definition.
	 * @param  string  $suffix          Border options group or toggle name.
	 * @param  boolean $is_hover        Hover options status.
	 * @param  string  $device          Current active device.
	 * @param  boolean $is_sticky       Sticky options status.
	 *
	 * @return string                   Generated border styles.
	 */
	public function get_borders_style( array $attrs, array $advanced_fields, $suffix = '', $is_hover = false, $device = 'desktop', $is_sticky = false ) {
		$style         = '';
		$important     = '';
		$hover         = et_pb_hover_options();
		$sticky        = et_pb_sticky_options();
		$is_desktop    = 'desktop' === $device;
		$device_suffix = ! $is_desktop ? "_{$device}" : '';

self::$_is_default = array();

if ( self::$_->array_get( $advanced_fields, "border{$suffix}.css.important", false ) ) {
			if ( 'plugin_only' === self::$_->array_get( $advanced_fields, "border{$suffix}.css.important", '' ) ) {
				$important = et_builder_has_limitation( 'force_use_global_important' ) ? '!important' : '';
			} else {
				$important = '!important';
			}
		}

// Get border settings based on main border_style field on option template.
		// This used to refer to module's advanced_fields property but for performance reason
		// it is now fetched from option template field's instead.
		// Rebuilt field on option template is cached on property so it is safe to get it on demand.
		$border_advanced_setting = self::$_->array_get( $advanced_fields, "border{$suffix}", array() );
		$border_template_id      = ET_Builder_Module_Fields_Factory::get( 'Border' )->get_fields( $border_advanced_setting, true );
		$border_fields           = $this->template->is_enabled() ? $this->template->rebuild_field_template( $border_template_id ) : array();

// Border Style settings
		$settings = self::$_->array_get( $border_fields, "border_styles{$suffix}", array() );

if ( ! isset( $settings['composite_structure'] ) || ! is_array( $settings['composite_structure'] ) ) {
			return $style;
		}

$styles       = array();
		$properties   = array( 'width', 'style', 'color' );
		$border_edges = array( 'top', 'right', 'bottom', 'left' );

// Individual edge tabs get their default values from the all edges tab. If a value in
		// the all edges tab has been changed from the default, that value will be used as the
		// default for the individual edge tabs, otherwise the all edges default value is used.
		$value_suffix = '';

if ( $is_hover ) {
			$value_suffix = $hover->get_suffix();
		}

if ( $is_sticky ) {
			$value_suffix = $sticky->get_suffix();
		}

foreach ( $border_edges as $edge ) {
			$edge = "{$edge}";

foreach ( $properties as $property ) {
				// Set key to get all edges and edge value based on current active device.
				$all_edges_key        = "border_{$property}_all{$suffix}";
				$all_edges_key_device = "border_{$property}_all{$suffix}{$device_suffix}";
				$edge_key             = "border_{$property}_{$edge}{$suffix}";
				$edge_key_device      = "border_{$property}_{$edge}{$suffix}{$device_suffix}";

$is_all_edges_responsive = et_pb_responsive_options()->is_responsive_enabled( $attrs, $all_edges_key );
				$is_edge_responsive      = et_pb_responsive_options()->is_responsive_enabled( $attrs, $edge_key );
				$all_edges_desktop_value = et_pb_responsive_options()->get_any_value( $attrs, $all_edges_key );
				$edge_desktop_value      = et_pb_responsive_options()->get_any_value( $attrs, $edge_key );

// Don't output styles for default values unless the default value is actually
				// a custom value from the all edges tab.
				$value = false;
				if ( $is_hover ) {
					$default_hover_value = $hover->is_enabled( $edge_key, $attrs ) ? $edge_desktop_value : false;
					$value               = $hover->get_value( $edge_key, $attrs, $default_hover_value );
				} elseif ( $is_sticky ) {
					$default_sticky_value = $sticky->is_enabled( $edge_key, $attrs ) ? $edge_desktop_value : false;
					$value                = $sticky->get_value( $edge_key, $attrs, $default_sticky_value );
				} elseif ( ! $is_desktop ) {
					$value = $is_edge_responsive ? et_pb_responsive_options()->get_any_value( $attrs, $edge_key_device, '', true ) : et_pb_responsive_options()->get_any_value( $attrs, $edge_key );
				} elseif ( $is_desktop ) {
					$value = $edge_desktop_value;
				}

if ( ! $value ) {
					// If specific edge value doesn't exist, get from all active device.
					$value = false;
					if ( $is_hover ) {
						$default_hover_value = $hover->is_enabled( $all_edges_key, $attrs ) ? $all_edges_desktop_value : false;
						$value               = $hover->get_value( $all_edges_key, $attrs, $default_hover_value );
					} elseif ( $is_sticky ) {
						$default_sticky_value = $sticky->is_enabled( $all_edges_key, $attrs ) ? $all_edges_desktop_value : false;
						$value                = $sticky->get_value( $all_edges_key, $attrs, $default_sticky_value );
					} elseif ( $is_desktop || ( ! $is_desktop && $is_all_edges_responsive ) ) {
						$value = et_pb_responsive_options()->get_any_value( $attrs, $all_edges_key_device );
					}

if ( ! $value ) {
						self::$_is_default[] = "{$edge_key}{$value_suffix}";
						self::$_is_default[] = "{$all_edges_key}{$value_suffix}";

continue;
					}
				}

// Don't output wrongly migrated border-color value
				if ( 'color' === $property && 'off' === $value ) {
					continue;
				}

if ( ! isset( $styles[ $property ] ) ) {
					$styles[ $property ] = array();
				}

// Sanitize value
				if ( 'width' === $property ) {
					$value = et_builder_process_range_value( $value );
				}

$styles[ $property ][ $edge ] = esc_html( $value );
			}
		}

foreach ( $styles as $prop => $edges ) {
			$all_values = array_values( $edges );
			$all_edges  = 4 === count( $all_values );

if ( $all_edges && 1 === count( array_unique( $all_values ) ) ) {
				// All edges have the same value, so let's combine them into a single prop.
				$style .= "border-{$prop}:{$all_values[0]}{$important};";

} elseif ( $all_edges && $edges['top'] === $edges['bottom'] && $edges['left'] === $edges['right'] ) {
				// Let's combine them into a single prop.
				$style .= "border-{$prop}:{$edges['top']} {$edges['left']}{$important};";

} elseif ( $all_edges ) {
				// You know the drill.
				$style .= "border-{$prop}:{$edges['top']} {$edges['right']} {$edges['bottom']} {$edges['left']}{$important};";

} else {
				// We're not going to mess with the other shorthand variants, so separate styles it is!
				foreach ( $edges as $edge => $value ) {
					$style .= "border-{$edge}-{$prop}:{$value}{$important};";
				}
			}
		}

return $style;
	}

/**
	 * Whether or not the provided module needs the border reset CSS class.
	 *
	 * @param string $module_slug
	 * @param array  $attrs
	 *
	 * @return bool
	 */
	public function needs_border_reset_class( $module_slug, $attrs ) {
		if ( in_array( $module_slug, self::$_no_border_reset ) ) {
			return false;
		}

foreach ( $attrs as $attr => $value ) {
			if ( ! $value || 0 === strpos( $attr, 'border_radii' ) ) {
				continue;
			}

// don't use 2 === substr_count( $attr, '_' ) because in some cases border option may have 3 underscores ( in case we have several border options in module ).
			// It's enough to make sure we have more than 1 underscores.
			$is_new_border_attr = 0 === strpos( $attr, 'border_' ) && substr_count( $attr, '_' ) > 1;

if ( $is_new_border_attr && ! in_array( $attr, self::$_is_default ) ) {
				return true;
			}
		}

return false;
	}

/**
	 * Check if attribute has border radius values.
	 *
	 * @param array $attrs border attrs.
	 *
	 * @return bool
	 */
	public function has_any_border_attrs( $attrs ) {
		foreach ( $attrs as $attr => $value ) {
			// Dont neglet border radius here.
			// Since border and border radius are handled by same function.
			// We should also check for border radius here.
			if ( ! $value ) {
				continue;
			}

if ( $is_new_border_attr && ! in_array( $attr, self::$_is_default, true ) ) {
				return true;
			}
		}

return false;
	}

/**
	 * Add border reset class using filter. Obsolete method and only applied to old 3rd party modules without `modules_classname()` method
	 *
	 * @param string $output
	 * @param string $module_slug
	 *
	 * @return string
	 */
	public function add_border_reset_class( $output, $module_slug ) {
		if ( in_array( $module_slug, ET_Builder_Element::$uses_module_classname ) ) {
			return $output;
		}

remove_filter( "{$module_slug}_shortcode_output", array( $this, 'add_border_reset_class' ), 10 );

return preg_replace( "/class=\"(.*?{$module_slug}_\d+.*?)\"/", 'class="$1 et_pb_with_border"', $output, 1 );
	}
}

return new ET_Builder_Module_Field_Border();

Editing: Border.php

Upload Files

Create New

Change Permissions

Change Date

Rename Item

Confirm Delete