801 lines
33 KiB
PHP
801 lines
33 KiB
PHP
<?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;
|
|
}
|
|
|
|
// 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_' ) && ( 'border_radii' === $attr || substr_count( $attr, '_' ) > 1 );
|
|
|
|
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();
|