You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1959 lines
83 KiB
PHP
1959 lines
83 KiB
PHP
<?php
|
|
/**
|
|
* Background helper Class.
|
|
*
|
|
* @package Divi
|
|
* @subpackage Builder
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
die( 'Direct access forbidden.' );
|
|
}
|
|
|
|
|
|
/**
|
|
* Background helper methods.
|
|
*
|
|
* Intended for module that needs to extend module background mechanism with few modification
|
|
* (eg. post slider which needs to apply module background on individual slide that has featured
|
|
* image).
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.6.0 Add sticky style support
|
|
* @since 4.15.0 Add pattern/mask style support.
|
|
*
|
|
* Class ET_Builder_Module_Helper_Background
|
|
*/
|
|
class ET_Builder_Module_Helper_Background {
|
|
/**
|
|
* Returns instance of the class.
|
|
*
|
|
* @return ET_Builder_Module_Helper_Background
|
|
*/
|
|
public static function instance() {
|
|
static $instance;
|
|
|
|
return $instance ? $instance : $instance = new self();
|
|
}
|
|
|
|
/**
|
|
* Get prop name alias. Some background settings (eg. button's gradient background enable) might
|
|
* use slightly different prop name to store background config;
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param array $aliases Aliases.
|
|
* @param string $prop_name Prop name.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_prop_name_alias( $aliases = array(), $prop_name = '' ) {
|
|
// If no aliases given, simply return the prop name because it has no alias.
|
|
if ( empty( $aliases ) ) {
|
|
return $prop_name;
|
|
}
|
|
|
|
return isset( $aliases[ $prop_name ] ) ? $aliases[ $prop_name ] : $prop_name;
|
|
}
|
|
|
|
/**
|
|
* Get gradient properties for hover mode
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.6.0 add capability to look for sticky style's gradient
|
|
* @since 4.16.0 Uses the `_stops` field introduced in the Gradient Builder update.
|
|
*
|
|
* @param string $mode Mode name.
|
|
* @param array $props Module's props.
|
|
* @param string $base_prop_name Background base prop name.
|
|
* @param array $gradient_properties_desktop {
|
|
* @type string $mode
|
|
* @type string $stops
|
|
* @type string $type
|
|
* @type string $direction
|
|
* @type string $radial_direction
|
|
* @type string $color_start
|
|
* @type string $color_end
|
|
* @type string $start_position
|
|
* @type string $end_position
|
|
* }
|
|
*
|
|
* @return array|false
|
|
*/
|
|
public function get_gradient_mode_properties( $mode, $props, $base_prop_name, $gradient_properties_desktop = array() ) {
|
|
$helper = et_builder_get_helper( $mode );
|
|
|
|
if ( ! $mode ) {
|
|
return false;
|
|
}
|
|
|
|
// Desktop value as default.
|
|
$gradient_repeat_desktop = et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_repeat_image", '', true );
|
|
$gradient_type_desktop = et_()->array_get( $gradient_properties_desktop, 'type', '' );
|
|
$gradient_direction_desktop = et_()->array_get( $gradient_properties_desktop, 'direction', '' );
|
|
$gradient_radial_direction_desktop = et_()->array_get( $gradient_properties_desktop, 'radial_direction', '' );
|
|
$gradient_stops_desktop = et_()->array_get( $gradient_properties_desktop, 'stops', '' );
|
|
$gradient_unit_desktop = et_()->array_get( $gradient_properties_desktop, 'unit', '' );
|
|
$gradient_overlays_image_desktop = et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_overlays_image", '', true );
|
|
|
|
$gradient_color_start_desktop = et_()->array_get( $gradient_properties_desktop, 'color_start', '' );
|
|
$gradient_color_end_desktop = et_()->array_get( $gradient_properties_desktop, 'color_end', '' );
|
|
$gradient_start_position_desktop = et_()->array_get( $gradient_properties_desktop, 'start_position', '' );
|
|
$gradient_end_position_desktop = et_()->array_get( $gradient_properties_desktop, 'end_position', '' );
|
|
|
|
// Mode value.
|
|
$gradient_repeat_mode = $helper->get_raw_value( "{$base_prop_name}_color_repeat_image", $props, $gradient_repeat_desktop );
|
|
$gradient_type_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_type", $props, $gradient_type_desktop );
|
|
$gradient_direction_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_direction", $props, $gradient_direction_desktop );
|
|
$gradient_direction_radial_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_direction_radial", $props, $gradient_radial_direction_desktop );
|
|
$gradient_stops_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_stops", $props, $gradient_stops_desktop );
|
|
$gradient_unit_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_unit", $props, $gradient_unit_desktop );
|
|
$gradient_overlays_image_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_overlays_image", $props, $gradient_overlays_image_desktop );
|
|
|
|
$gradient_start_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_start", $props, $gradient_color_start_desktop );
|
|
$gradient_end_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_end", $props, $gradient_color_end_desktop );
|
|
$gradient_start_position_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_start_position", $props, $gradient_start_position_desktop );
|
|
$gradient_end_position_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_end_position", $props, $gradient_end_position_desktop );
|
|
|
|
$color_start_value = '' !== $gradient_start_mode ? $gradient_start_mode : $gradient_color_start_desktop;
|
|
$color_end_value = '' !== $gradient_end_mode ? $gradient_end_mode : $gradient_color_end_desktop;
|
|
|
|
return array(
|
|
'repeat' => '' !== $gradient_repeat_mode ? $gradient_repeat_mode : $gradient_repeat_desktop,
|
|
'type' => '' !== $gradient_type_mode ? $gradient_type_mode : $gradient_type_desktop,
|
|
'direction' => '' !== $gradient_direction_mode ? $gradient_direction_mode : $gradient_direction_desktop,
|
|
'radial_direction' => '' !== $gradient_direction_radial_mode ? $gradient_direction_radial_mode : $gradient_radial_direction_desktop,
|
|
'stops' => '' !== $gradient_stops_mode ? $gradient_stops_mode : $gradient_stops_desktop,
|
|
'color_start' => '' !== $gradient_start_mode ? $gradient_start_mode : $gradient_color_start_desktop,
|
|
'color_end' => '' !== $gradient_end_mode ? $gradient_end_mode : $gradient_color_end_desktop,
|
|
'start_position' => '' !== $gradient_start_position_mode ? $gradient_start_position_mode : $gradient_start_position_desktop,
|
|
'end_position' => '' !== $gradient_end_position_mode ? $gradient_end_position_mode : $gradient_end_position_desktop,
|
|
'unit' => '' !== $gradient_unit_mode ? $gradient_unit_mode : $gradient_stops_desktop,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get gradient properties based on given props
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.16.0 Uses the `_stops` field introduced in the Gradient Builder update.
|
|
*
|
|
* @param array $props Module's props.
|
|
* @param string $base_prop_name Background base prop name.
|
|
* @param string $suffix Background base prop name's suffix.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_gradient_properties( $props, $base_prop_name, $suffix ) {
|
|
return array(
|
|
'repeat' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_repeat{$suffix}", '', true ),
|
|
'type' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_type{$suffix}", '', true ),
|
|
'direction' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_direction{$suffix}", '', true ),
|
|
'radial_direction' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_direction_radial{$suffix}", '', true ),
|
|
'stops' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_stops{$suffix}", '', true ),
|
|
'unit' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_unit{$suffix}", '', true ),
|
|
'color_start' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_start{$suffix}", '', true ),
|
|
'color_end' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_end{$suffix}", '', true ),
|
|
'start_position' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_start_position{$suffix}", '', true ),
|
|
'end_position' => et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_color_gradient_end_position{$suffix}", '', true ),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get background gradient style based on properties given
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.16.0 Uses the `_stops` field introduced in the Gradient Builder update.
|
|
*
|
|
* @param array $args {
|
|
* @type string $repeat Whether the gradient stops repeat.
|
|
* @type string $type Linear or radial gradient.
|
|
* @type string $direction The gradient line's angle of direction.
|
|
* @type string $radial_direction The position of the gradient.
|
|
* @type string $stops Brace-delimited list of color stops.
|
|
* @type string $color_start Deprecated.
|
|
* @type string $color_end Deprecated.
|
|
* @type string $start_position Deprecated.
|
|
* @type string $end_position Deprecated.
|
|
* }
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_gradient_style( $args ) {
|
|
$default_gradient = array(
|
|
'repeat' => ET_Global_Settings::get_value( 'all_background_gradient_repeat' ),
|
|
'type' => ET_Global_Settings::get_value( 'all_background_gradient_type' ),
|
|
'direction' => ET_Global_Settings::get_value( 'all_background_gradient_direction' ),
|
|
'radial_direction' => ET_Global_Settings::get_value( 'all_background_gradient_direction_radial' ),
|
|
'stops' => ET_Global_Settings::get_value( 'all_background_gradient_stops' ),
|
|
);
|
|
|
|
$defaults = apply_filters( 'et_pb_default_gradient', $default_gradient );
|
|
$args = wp_parse_args( array_filter( $args ), $defaults );
|
|
$stops = str_replace( '|', ', ', $args['stops'] );
|
|
|
|
$stops = $this->get_color_value( $stops );
|
|
|
|
switch ( $args['type'] ) {
|
|
case 'conic':
|
|
$type = 'conic';
|
|
$direction = "from {$args['direction']} at {$args['radial_direction']}";
|
|
break;
|
|
case 'elliptical':
|
|
$type = 'radial';
|
|
$direction = "ellipse at {$args['radial_direction']}";
|
|
break;
|
|
case 'radial':
|
|
case 'circular':
|
|
$type = 'radial';
|
|
$direction = "circle at {$args['radial_direction']}";
|
|
break;
|
|
case 'linear':
|
|
default:
|
|
$type = 'linear';
|
|
$direction = $args['direction'];
|
|
}
|
|
|
|
// Apply gradient repeat (if set).
|
|
if ( 'on' === $args['repeat'] ) {
|
|
$type = "repeating-{$type}";
|
|
}
|
|
|
|
return esc_html(
|
|
"{$type}-gradient( {$direction}, {$stops} )"
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get individual background image style
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.15.0 deprecated
|
|
*
|
|
* @deprecated Use {@see get_attr_value} instead.
|
|
*
|
|
* @param string $attr Background attribute name.
|
|
* @param string $base_prop_name Base background prop name.
|
|
* @param string $suffix Attribute name suffix.
|
|
* @param array $props Module props.
|
|
* @param array $fields_definition Module's fields definition.
|
|
* @param bool $is_prev_image_active Whether previous background image is active or not.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_image_style( $attr, $base_prop_name, $suffix = '', $props = array(), $fields_definition = array(), $is_prev_image_active = true ) {
|
|
return $this->get_attr_value( $attr, $base_prop_name, $suffix = '', $props, $fields_definition, $is_prev_image_active );
|
|
}
|
|
|
|
/**
|
|
* Get individual default value.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param string $attr Background attribute name.
|
|
* @param string $base_prop_name Base background prop name.
|
|
* @param array $fields_definition Module's fields definition.
|
|
* @param bool $is_prev_device_active Whether previous background image is active or not.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_attr_default( $attr, $base_prop_name, $fields_definition = array(), $is_prev_device_active = true ) {
|
|
$default = isset( $fields_definition[ "{$base_prop_name}_{$attr}" ]['default'] )
|
|
? $fields_definition[ "{$base_prop_name}_{$attr}" ]['default']
|
|
: '';
|
|
|
|
return $is_prev_device_active ? $default : '';
|
|
}
|
|
|
|
/**
|
|
* Get individual background attribute value.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param string $attr Background attribute name.
|
|
* @param string $base_prop_name Base background prop name.
|
|
* @param string $suffix Attribute name suffix.
|
|
* @param array $props Module props.
|
|
* @param array $fields_definition Module's fields definition.
|
|
* @param bool $is_prev_device_active Whether is active in previous device or not.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_attr_value( $attr, $base_prop_name, $suffix = '', $props = array(), $fields_definition = array(), $is_prev_device_active = true ) {
|
|
$default = $this->get_attr_default( $attr, $base_prop_name, $fields_definition, $is_prev_device_active );
|
|
|
|
return et_pb_responsive_options()->get_any_value( $props, "{$base_prop_name}_{$attr}{$suffix}", $default, ! $is_prev_device_active );
|
|
}
|
|
|
|
/**
|
|
* Return CSS for Transform State.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param string $values Transform states.
|
|
* @param string $state Query state, valid options: horizontal | vertical | rotate | invert.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_transform_state( $values, $state ) {
|
|
$flip = '' !== $values ? explode( '|', $values ) : array();
|
|
|
|
switch ( $state ) {
|
|
case 'horizontal':
|
|
$result = in_array( 'flip_horizontal', $flip, true );
|
|
break;
|
|
case 'invert':
|
|
$result = in_array( 'invert', $flip, true );
|
|
break;
|
|
case 'rotate':
|
|
$result = in_array( 'rotate_90_degree', $flip, true );
|
|
break;
|
|
case 'vertical':
|
|
$result = in_array( 'flip_vertical', $flip, true );
|
|
break;
|
|
default:
|
|
$result = false;
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Return CSS for Transform State.
|
|
*
|
|
* We use `scale` here because CSS Transform's `rotateX`/`rotateY` trigger a 10+
|
|
* year old Safari bug that hides rotated background images (including SVGs).
|
|
*
|
|
* @see https://bugs.webkit.org/show_bug.cgi?id=61824
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param bool $horizontal Horizontal state.
|
|
* @param bool $vertical Vertical state.
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_transform_css( $horizontal, $vertical ) {
|
|
$flip_h = $horizontal ? '-1' : '1';
|
|
$flip_v = $vertical ? '-1' : '1';
|
|
|
|
return "scale($flip_h, $flip_v)";
|
|
}
|
|
|
|
/**
|
|
* Helper function to return CSS for BackgroundPosition.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param string $position Position.
|
|
* @param string $horizontal_offset Horizontal Offset.
|
|
* @param string $vertical_offset Vertical Offset.
|
|
* @param string $position_default Default Position.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_background_position_css( $position, $horizontal_offset, $vertical_offset, $position_default = '' ) {
|
|
$position_value = empty( $position ) ? $position_default : $position;
|
|
$horizontal_offset_value = et_builder_process_range_value( $horizontal_offset );
|
|
$vertical_offset_value = et_builder_process_range_value( $vertical_offset );
|
|
$position_array = explode( '_', $position_value );
|
|
$output = array();
|
|
|
|
// Vertical Offset.
|
|
if ( isset( $position_array[0] ) ) {
|
|
switch ( $position_array[0] ) {
|
|
case 'top':
|
|
// Top doesn't need suffix when value is 0.
|
|
$output['position-y'] = 0 === (int) $vertical_offset
|
|
? $position_array[0]
|
|
: "{$position_array[0]} {$vertical_offset_value}";
|
|
break;
|
|
case 'bottom':
|
|
$output['position-y'] = "{$position_array[0]} {$vertical_offset_value}";
|
|
break;
|
|
case 'center':
|
|
default:
|
|
$output['position-y'] = 'center';
|
|
}
|
|
}
|
|
|
|
// Horizontal Offset.
|
|
if ( isset( $position_array[1] ) ) {
|
|
switch ( $position_array[1] ) {
|
|
case 'left':
|
|
// Left doesn't need suffix when value is 0.
|
|
$output['position-x'] = 0 === (int) $horizontal_offset
|
|
? $position_array[1]
|
|
: "{$position_array[1]} {$horizontal_offset_value}";
|
|
break;
|
|
case 'right':
|
|
$output['position-x'] = "{$position_array[1]} {$horizontal_offset_value}";
|
|
break;
|
|
case 'center':
|
|
default:
|
|
$output['position-x'] = 'center';
|
|
}
|
|
} else {
|
|
// When $position_array[1] is absence.
|
|
$output['position-x'] = 'center';
|
|
}
|
|
|
|
// Prepare output for the CSS value.
|
|
$output['position'] = 'center' === $output['position-x'] && 'center' === $output['position-y']
|
|
? 'center'
|
|
: "{$output['position-x']} {$output['position-y']}";
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Helper function to return CSS for BackgroundSize.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @param string $size Size.
|
|
* @param string $width Width.
|
|
* @param string $height Vertical Offset.
|
|
* @param string $size_default Default Size.
|
|
* @param string $type Type, use to handle special case.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_background_size_css( $size, $width, $height, $size_default = '', $type = '' ) {
|
|
$size_value = '' === $size ? $size_default : $size;
|
|
$output = array();
|
|
|
|
switch ( $size_value ) {
|
|
case 'custom':
|
|
$is_width_auto = 'auto' === $width || '' === $width || 0 === (int) $width;
|
|
$is_height_auto = 'auto' === $height || '' === $height || 0 === (int) $height;
|
|
$width_value = $is_width_auto ? 'auto' : et_builder_process_range_value( $width );
|
|
$height_value = $is_height_auto ? 'auto' : et_builder_process_range_value( $height );
|
|
|
|
if ( $is_width_auto && $is_height_auto ) {
|
|
$output['size'] = 'initial';
|
|
} else {
|
|
$output['size'] = "{$width_value} {$height_value}";
|
|
}
|
|
break;
|
|
case 'stretch':
|
|
// For mask, increase 2px to resolve sub-pixel rendering issue in Chrome/Safari.
|
|
$output['size'] = 'mask' === $type
|
|
? 'calc(100% + 2px) calc(100% + 2px)'
|
|
: '100% 100%';
|
|
break;
|
|
case 'cover':
|
|
case 'contain':
|
|
case 'initial':
|
|
$output['size'] = $size_value;
|
|
break;
|
|
default:
|
|
$output['size'] = '';
|
|
}
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Get background UI option's style based on given props and prop name
|
|
*
|
|
* @since 4.3.3
|
|
* @since 4.6.0 Add sticky style support.
|
|
* @since 4.15.0 Add pattern/mask style support.
|
|
*
|
|
* @todo Further simplify this method; Break it down into more encapsulated methods
|
|
*
|
|
* @param array $args {
|
|
* @type string $base_prop_name
|
|
* @type array $props
|
|
* @type string $important
|
|
* @type array $fields_Definition
|
|
* @type string $selector
|
|
* @type string $selector_hover
|
|
* @type string $selector_sticky
|
|
* @type number $priority
|
|
* @type string $function_name
|
|
* @type bool $has_background_color_toggle
|
|
* @type bool $use_background_color
|
|
* @type bool $use_background_color_gradient
|
|
* @type bool $use_background_image
|
|
* @type bool $use_background_video
|
|
* @type bool $use_background_pattern
|
|
* @type bool $use_background_mask
|
|
* @type bool $use_background_color_reset
|
|
* @type bool $use_background_image_parallax
|
|
* }
|
|
*/
|
|
public function get_background_style( $args = array() ) {
|
|
// Default settings.
|
|
$defaults = array(
|
|
'base_prop_name' => 'background',
|
|
'props' => array(),
|
|
'important' => '',
|
|
'fields_definition' => array(),
|
|
'selector' => '',
|
|
'selector_hover' => '',
|
|
'selector_sticky' => '',
|
|
'selector_pattern' => '',
|
|
'selector_mask' => '',
|
|
'priority' => '',
|
|
'function_name' => '',
|
|
'has_background_color_toggle' => false,
|
|
'use_background_color' => true,
|
|
'use_background_color_gradient' => true,
|
|
'use_background_image' => true,
|
|
'use_background_video' => true,
|
|
'use_background_color_reset' => true,
|
|
'use_background_pattern' => true,
|
|
'use_background_mask' => true,
|
|
'use_background_image_parallax' => true,
|
|
'prop_name_aliases' => array(),
|
|
);
|
|
|
|
// Parse arguments.
|
|
$args = wp_parse_args( $args, $defaults );
|
|
|
|
// Break argument into variables.
|
|
$base_prop_name = $args['base_prop_name'];
|
|
$props = $args['props'];
|
|
$important = $args['important'];
|
|
$fields_definition = $args['fields_definition'];
|
|
$selector = $args['selector'];
|
|
$selector_pattern = $args['selector_pattern'];
|
|
$selector_mask = $args['selector_mask'];
|
|
$priority = $args['priority'];
|
|
$function_name = $args['function_name'];
|
|
|
|
// Possible values for use_background_* variables are true, false, or 'fields_only'.
|
|
$has_color_toggle_options = $args['has_background_color_toggle'];
|
|
$use_gradient_options = $args['use_background_color_gradient'];
|
|
$use_image_options = $args['use_background_image'];
|
|
$use_color_options = $args['use_background_color'];
|
|
$use_color_reset_options = $args['use_background_color_reset'];
|
|
$use_pattern_options = $args['use_background_pattern'];
|
|
$use_mask_options = $args['use_background_mask'];
|
|
|
|
// Prop name aliases. Some background element uses different prop name (eg. button background).
|
|
$prop_name_aliases = $args['prop_name_aliases'];
|
|
|
|
// Save processed background. These will be compared with the smaller device background
|
|
// processed value to avoid rendering the same styles.
|
|
$processed_color = '';
|
|
$gradient_properties_desktop = array();
|
|
$gradient_overlays_image_desktop = 'off';
|
|
|
|
// Store background images status because the process is extensive.
|
|
$image_status = $this->get_default_mode_status();
|
|
$processed_image_size_style = array( 'size' => $this->get_attr_default( 'size', $base_prop_name, $fields_definition ) );
|
|
$processed_image = '';
|
|
$processed_image_position_style = '';
|
|
$processed_image_blend_style = '';
|
|
|
|
// Background pattern.
|
|
$pattern_base_prop_name = "{$base_prop_name}_pattern";
|
|
$pattern_status = $this->get_default_mode_status();
|
|
$processed_pattern_transform_style = '';
|
|
$processed_pattern_svg = '';
|
|
$processed_pattern_size_style = array( 'size' => $this->get_attr_default( 'size', $pattern_base_prop_name, $fields_definition ) );
|
|
$processed_pattern_position_style = '';
|
|
|
|
// Background mask.
|
|
$mask_base_prop_name = "{$base_prop_name}_mask";
|
|
$mask_status = $this->get_default_mode_status();
|
|
$processed_mask_transform_style = '';
|
|
$processed_mask_svg = '';
|
|
$processed_mask_size_style = array( 'size' => $this->get_attr_default( 'size', $mask_base_prop_name, $fields_definition ) );
|
|
$processed_mask_position_style = '';
|
|
|
|
// Helper.
|
|
$feature_manager = ET_Builder_Module_Features::instance();
|
|
$responsive = et_pb_responsive_options();
|
|
|
|
/**
|
|
* Module Component.
|
|
*
|
|
* @var ET_Builder_Element $module
|
|
*/
|
|
$module = isset( $args['module'] ) ? $args['module'] : ET_Builder_Element::get_module( $function_name );
|
|
|
|
// Bail, there is nothing to process.
|
|
// Happens when et_pb_posts module don't find a $post to process.
|
|
if ( is_string( $module ) || ! ( $module && $module instanceof ET_Builder_Element ) ) {
|
|
return;
|
|
}
|
|
|
|
// We got the module, get unprocessed attrs.
|
|
$attrs_unprocessed = $module->get_attrs_unprocessed();
|
|
|
|
// Get dynamic attributes.
|
|
$dynamic_attributes = $this->_get_enabled_dynamic_attributes( $props );
|
|
|
|
// Parsed prop name, in case it has aliases.
|
|
$base_prop_name_parsed = $this->get_prop_name_alias( $prop_name_aliases, $base_prop_name );
|
|
|
|
// Background Desktop, Tablet, and Phone.
|
|
foreach ( $responsive->get_modes() as $device ) {
|
|
$is_desktop = 'desktop' === $device;
|
|
$suffix = ! $is_desktop ? "_{$device}" : '';
|
|
$style = '';
|
|
|
|
$style_pattern = '';
|
|
$style_mask = '';
|
|
|
|
// Conditionals.
|
|
$has_gradient = false;
|
|
$has_image = false;
|
|
$has_gradient_and_image = false;
|
|
$is_gradient_disabled = false;
|
|
$is_image_disabled = false;
|
|
|
|
$is_enabled = $feature_manager->get(
|
|
// Is background responsive enabled for $device.
|
|
// keys: bared, baret, barep.
|
|
'bare' . $device[0],
|
|
function() use ( $responsive, $base_prop_name_parsed, $props ) {
|
|
return $responsive->is_responsive_enabled( $props, $base_prop_name_parsed );
|
|
}
|
|
);
|
|
|
|
// Ensure responsive settings is enabled on mobile.
|
|
if ( ! $is_desktop && ! $is_enabled ) {
|
|
continue;
|
|
}
|
|
|
|
// Styles output.
|
|
$image_style = '';
|
|
$color_style = '';
|
|
$images = array();
|
|
$gradient_overlays_image = 'off';
|
|
|
|
$image_size_style = '';
|
|
$image_position_style = '';
|
|
$pattern_transform_style = '';
|
|
$pattern_style_svg = '';
|
|
$pattern_size_style = '';
|
|
$pattern_position_style = '';
|
|
$mask_transform_style = '';
|
|
$mask_style_svg = '';
|
|
$mask_size_style = '';
|
|
$mask_position_style = '';
|
|
|
|
// A. Background Gradient.
|
|
if ( $use_gradient_options && 'fields_only' !== $use_gradient_options ) {
|
|
$use_gradient = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
$this->get_prop_name_alias( $prop_name_aliases, "use_{$base_prop_name}_color_gradient" ),
|
|
$device,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
|
|
// 1. Ensure gradient color is active.
|
|
if ( 'on' === $use_gradient ) {
|
|
$gradient_overlays_image = $responsive->get_any_value( $props, "{$base_prop_name}_color_gradient_overlays_image{$suffix}", '', true );
|
|
$gradient_properties = $this->get_gradient_properties( $props, $base_prop_name, $suffix );
|
|
|
|
// Will be used as default of Gradient hover.
|
|
if ( $is_desktop ) {
|
|
$gradient_properties_desktop = $gradient_properties;
|
|
$gradient_overlays_image_desktop = $gradient_overlays_image;
|
|
}
|
|
|
|
// Save background gradient into background images list.
|
|
$background_gradient = $this->get_gradient_style( $gradient_properties );
|
|
$images[] = $background_gradient;
|
|
|
|
// Flag to inform Background Color if current module has Gradient.
|
|
$has_gradient = true;
|
|
} elseif ( 'off' === $use_gradient ) {
|
|
$is_gradient_disabled = true;
|
|
}
|
|
}
|
|
|
|
// B. Background Image.
|
|
if ( $use_image_options && 'fields_only' !== $use_image_options ) {
|
|
$image = $responsive->get_inheritance_background_value( $props, "{$base_prop_name}_image", $device, $base_prop_name, $fields_definition );
|
|
$parallax = $responsive->get_any_value( $props, "parallax{$suffix}", 'off' );
|
|
|
|
// Determine whether force inline styles.
|
|
if ( ! ET_Builder_Element::$forced_inline_styles ) {
|
|
$background_image_field = $responsive->get_field_name( "{$base_prop_name}_image", $device );
|
|
$raw = isset( $attrs_unprocessed[ $background_image_field ] ) ? $attrs_unprocessed[ $background_image_field ] : '';
|
|
if ( $this->_is_dynamic_value( $background_image_field, $raw, $dynamic_attributes ) ) {
|
|
ET_Builder_Element::$forced_inline_styles = true;
|
|
}
|
|
}
|
|
|
|
// Featured image as background is in higher priority.
|
|
if ( $module->featured_image_background ) {
|
|
$featured_image = isset( $props['featured_image'] ) ? $props['featured_image'] : '';
|
|
$featured_placement = isset( $props['featured_placement'] ) ? $props['featured_placement'] : '';
|
|
$featured_image_src_obj = wp_get_attachment_image_src( get_post_thumbnail_id( self::_get_main_post_id() ), 'full' );
|
|
$featured_image_src = isset( $featured_image_src_obj[0] ) ? $featured_image_src_obj[0] : '';
|
|
|
|
if ( 'on' === $featured_image && 'background' === $featured_placement && '' !== $featured_image_src ) {
|
|
$image = $featured_image_src;
|
|
}
|
|
}
|
|
|
|
// Background image and parallax status.
|
|
$is_image_active = '' !== $image && 'on' !== $parallax;
|
|
$image_status[ $device ] = $is_image_active;
|
|
|
|
// 1. Ensure image exists and parallax is off.
|
|
if ( $is_image_active ) {
|
|
// Flag to inform Background Color if current module has Image.
|
|
$has_image = true;
|
|
|
|
// Check previous Background image status. Needed to get the correct value.
|
|
$is_prev_image_active = true;
|
|
|
|
if ( ! $is_desktop ) {
|
|
$is_prev_image_active = 'tablet' === $device ?
|
|
$image_status['desktop'] :
|
|
$image_status['tablet'];
|
|
}
|
|
|
|
// Size.
|
|
$image_size_default = $this->get_attr_default( 'size', $base_prop_name, $fields_definition );
|
|
$image_size_inherit = $this->get_attr_value( 'size', $base_prop_name, $suffix, $props, $fields_definition, false );
|
|
$image_width_inherit = $this->get_attr_value( 'image_width', $base_prop_name, $suffix, $props, $fields_definition, false );
|
|
$image_height_inherit = $this->get_attr_value( 'image_height', $base_prop_name, $suffix, $props, $fields_definition, false );
|
|
|
|
if ( '' !== $image_size_inherit || $image_width_inherit || $image_height_inherit ) {
|
|
// Get Size CSS.
|
|
$image_size_style = $this->get_background_size_css( $image_size_inherit, $image_width_inherit, $image_height_inherit, $image_size_default, 'image' );
|
|
|
|
// Set image background size styles only it's different compared to the larger device.
|
|
if ( $processed_image_size_style !== $image_size_style ) {
|
|
if ( isset( $image_size_style['size'] ) && $image_size_style['size'] ) {
|
|
$style .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $image_size_style['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if image size has 'stretch' value or not.
|
|
$is_image_size_stretch = 'stretch' === $this->get_attr_value( 'size', $base_prop_name, $suffix, $props, $fields_definition, false );
|
|
|
|
// Repeat.
|
|
$image_repeat = $this->get_attr_value( 'repeat', $base_prop_name, $suffix, $props, $fields_definition, $is_prev_image_active );
|
|
|
|
// Print image repeat when image size is not 'stretch'.
|
|
if ( ! $is_image_size_stretch && '' !== $image_repeat ) {
|
|
$style .= sprintf( 'background-repeat: %1$s; ', esc_html( $image_repeat ) );
|
|
}
|
|
|
|
// Position.
|
|
$image_position_default = $this->get_attr_default( "{$base_prop_name}_position{$suffix}", $base_prop_name, $fields_definition );
|
|
$image_position_inherit = $this->get_attr_value( 'position', $base_prop_name, $suffix, $props, $fields_definition, $is_prev_image_active );
|
|
$image_horizontal_offset_inherit = $this->get_attr_value( 'horizontal_offset', $base_prop_name, $suffix, $props, $fields_definition, $is_prev_image_active );
|
|
$image_vertical_offset_inherit = $this->get_attr_value( 'vertical_offset', $base_prop_name, $suffix, $props, $fields_definition, $is_prev_image_active );
|
|
|
|
// Check if image repeat has 'space' value or not.
|
|
$is_image_repeat_space = 'space' === $this->get_attr_value( 'repeat', $base_prop_name, $suffix, $props, $fields_definition, false );
|
|
|
|
// Print image repeat origin/offset when image size is not 'stretch', and
|
|
// image repeat is not 'space'.
|
|
if (
|
|
! $is_image_size_stretch
|
|
&& ! $is_image_repeat_space
|
|
&& ( '' !== $image_position_inherit || $image_horizontal_offset_inherit || $image_vertical_offset_inherit )
|
|
) {
|
|
// Get Position CSS.
|
|
$image_position_style = $this->get_background_position_css( $image_position_inherit, $image_horizontal_offset_inherit, $image_vertical_offset_inherit, $image_position_default );
|
|
|
|
// Set background image position styles only it's different compared to the larger device.
|
|
if ( $processed_image_position_style !== $image_position_style ) {
|
|
$style .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $image_position_style['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Blend.
|
|
$image_blend_inherit = $this->get_attr_value( 'blend', $base_prop_name, $suffix, $props, $fields_definition, $is_prev_image_active );
|
|
$image_blend_default = $this->get_attr_default( 'blend', $base_prop_name, $fields_definition );
|
|
|
|
if ( '' !== $image_blend_inherit ) {
|
|
// Don't print the same image blend style.
|
|
if ( $processed_image_blend_style !== $image_blend_inherit ) {
|
|
$style .= sprintf( 'background-blend-mode: %1$s; ', esc_html( $image_blend_inherit ) );
|
|
}
|
|
|
|
// Reset - If background has image and gradient, force background-color: initial.
|
|
if ( $has_gradient && 'fields_only' !== $use_color_reset_options && $image_blend_inherit !== $image_blend_default ) {
|
|
$has_gradient_and_image = true;
|
|
$color_style = 'initial';
|
|
|
|
$style .= sprintf( 'background-color: initial%1$s; ', esc_html( $important ) );
|
|
}
|
|
|
|
$processed_image_blend_style = $image_blend_inherit;
|
|
}
|
|
|
|
// Only append background image when the image is exist.
|
|
$images[] = sprintf( 'url(%1$s)', esc_html( $image ) );
|
|
} elseif ( '' === $image ) {
|
|
// Reset - If background image is disabled, ensure we reset prev background blend mode.
|
|
if ( '' !== $processed_image_blend_style ) {
|
|
$style .= 'background-blend-mode: normal; ';
|
|
$processed_image_blend_style = '';
|
|
}
|
|
|
|
$is_image_disabled = true;
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $images ) ) {
|
|
// Check if Parallax and Gradient Overlays are on.
|
|
$gradient_overlays_image = $responsive->get_any_value( $props, "{$base_prop_name}_color_gradient_overlays_image{$suffix}", 'off', true );
|
|
$parallax = $responsive->get_any_value( $props, "parallax{$suffix}", 'off', true );
|
|
|
|
// The browsers stack the images in the opposite order to what you'd expect.
|
|
if ( 'on' !== $gradient_overlays_image ) {
|
|
$images = array_reverse( $images );
|
|
}
|
|
|
|
if ( $use_gradient_options && 'on' === $gradient_overlays_image && 'on' === $parallax ) {
|
|
// Set background image to initial when Parallax and Gradient Overlays are on.
|
|
$image_style = 'initial';
|
|
} else {
|
|
// Set background image styles only it's different compared to the larger device.
|
|
$image_style = join( ', ', $images );
|
|
}
|
|
|
|
if ( $processed_image !== $image_style ) {
|
|
$style .= sprintf(
|
|
'background-image: %1$s%2$s;',
|
|
esc_html( $image_style ),
|
|
$important
|
|
);
|
|
}
|
|
} elseif ( ! $is_desktop && $is_gradient_disabled && $is_image_disabled ) {
|
|
// Reset - If background image and gradient are disabled, reset current background image.
|
|
$image_style = 'initial';
|
|
|
|
$style .= sprintf(
|
|
'background-image: %1$s%2$s;',
|
|
esc_html( $image_style ),
|
|
$important
|
|
);
|
|
}
|
|
|
|
// Save processed background images.
|
|
$processed_image = $image_style;
|
|
|
|
// Save processed styles.
|
|
$processed_image_size_style = $image_size_style;
|
|
$processed_image_position_style = $image_position_style;
|
|
|
|
// C. Background Color.
|
|
if ( $use_color_options && 'fields_only' !== $use_color_options ) {
|
|
|
|
$use_color_value = $responsive->get_any_value( $props, "use_{$base_prop_name}_color{$suffix}", 'on', true );
|
|
|
|
if ( ! $has_gradient_and_image && 'off' !== $use_color_value ) {
|
|
$color = $responsive->get_inheritance_background_value( $props, "{$base_prop_name}_color", $device, $base_prop_name, $fields_definition );
|
|
$color = ! $is_desktop && '' === $color ? 'initial' : $color;
|
|
$color_style = $color;
|
|
|
|
if ( '' !== $color && $processed_color !== $color ) {
|
|
$style .= sprintf(
|
|
'background-color: %1$s%2$s; ',
|
|
esc_html( $this->get_color_value( $color ) ),
|
|
esc_html( $important )
|
|
);
|
|
}
|
|
} elseif ( $has_color_toggle_options && 'off' === $use_color_value && ! $is_desktop ) {
|
|
// Reset - If current module has background color toggle, it's off, and current mode
|
|
// it's not desktop, we should reset the background color.
|
|
$style .= sprintf(
|
|
'background-color: initial %1$s; ',
|
|
esc_html( $important )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Save processed background color.
|
|
$processed_color = $color_style;
|
|
|
|
// E. Background Pattern.
|
|
if ( $use_pattern_options && 'fields_only' !== $use_pattern_options ) {
|
|
$pattern_style_name = $responsive->get_inheritance_background_value( $props, "{$pattern_base_prop_name}_style", $device, $base_prop_name, $fields_definition );
|
|
|
|
$is_pattern_active = '' !== $pattern_style_name;
|
|
$pattern_status[ $device ] = $is_pattern_active;
|
|
|
|
if ( $is_pattern_active ) {
|
|
// Check previous pattern status. Needed to get the correct value.
|
|
$is_prev_pattern_active = true;
|
|
if ( ! $is_desktop ) {
|
|
$is_prev_pattern_active = 'tablet' === $device ? $pattern_status['desktop'] : $pattern_status['tablet'];
|
|
}
|
|
|
|
// Pattern Transform.
|
|
$pattern_transform_inherit = $responsive->get_any_value( $props, "{$pattern_base_prop_name}_transform{$suffix}", '', true );
|
|
|
|
$pattern_is_horizontal = $this->get_transform_state( $pattern_transform_inherit, 'horizontal' );
|
|
$pattern_is_vertical = $this->get_transform_state( $pattern_transform_inherit, 'vertical' );
|
|
$pattern_is_rotated = $this->get_transform_state( $pattern_transform_inherit, 'rotate' );
|
|
$pattern_is_inverted = $this->get_transform_state( $pattern_transform_inherit, 'invert' );
|
|
$pattern_transform_style = $this->get_transform_css( $pattern_is_horizontal, $pattern_is_vertical );
|
|
|
|
$is_pattern_transform_style_different = $processed_pattern_transform_style !== $pattern_transform_style;
|
|
|
|
if ( $is_pattern_transform_style_different && ( $pattern_is_horizontal || $pattern_is_vertical ) ) {
|
|
$style_pattern .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $pattern_transform_style )
|
|
);
|
|
} elseif ( $is_pattern_transform_style_different && ! $is_desktop ) {
|
|
$style_pattern .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $pattern_transform_style )
|
|
);
|
|
}
|
|
|
|
// Pattern Image.
|
|
$pattern_color = $responsive->get_any_value( $props, "{$pattern_base_prop_name}_color{$suffix}", '', true );
|
|
$pattern_style_svg = et_pb_background_pattern_options()->get_svg( $pattern_style_name, $pattern_color, 'default', $pattern_is_rotated, $pattern_is_inverted );
|
|
|
|
// Set pattern style when it's different compared to the larger device.
|
|
if ( $processed_pattern_svg !== $pattern_style_svg ) {
|
|
$style_pattern .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $pattern_style_svg )
|
|
);
|
|
}
|
|
|
|
// Pattern Size.
|
|
$pattern_size_default = $this->get_attr_default( 'size', $pattern_base_prop_name, $fields_definition );
|
|
$pattern_size_inherit = $this->get_attr_value( 'size', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
$pattern_width_inherit = $this->get_attr_value( 'width', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
$pattern_height_inherit = $this->get_attr_value( 'height', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
|
|
if ( '' !== $pattern_size_inherit || $pattern_width_inherit || $pattern_height_inherit ) {
|
|
// Get Size CSS.
|
|
$pattern_size_style = $this->get_background_size_css( $pattern_size_inherit, $pattern_width_inherit, $pattern_height_inherit, $pattern_size_default );
|
|
|
|
// Set pattern background size styles only it's different compared to the larger device.
|
|
if ( $processed_pattern_size_style !== $pattern_size_style ) {
|
|
if ( isset( $pattern_size_style['size'] ) && $pattern_size_style['size'] ) {
|
|
$style_pattern .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $pattern_size_style['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if pattern size has 'stretch' value or not.
|
|
$is_pattern_size_stretch = 'stretch' === $this->get_attr_value( 'size', $pattern_base_prop_name, $suffix, $props, $fields_definition, false );
|
|
|
|
// Pattern Repeat.
|
|
$pattern_repeat_inherit = $this->get_attr_value( 'repeat', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
|
|
// Print pattern repeat when pattern size is not 'stretch'.
|
|
if ( ! $is_pattern_size_stretch && '' !== $pattern_repeat_inherit ) {
|
|
$style_pattern .= sprintf(
|
|
'background-repeat: %1$s; ',
|
|
esc_html( $pattern_repeat_inherit )
|
|
);
|
|
}
|
|
|
|
// Pattern Repeat Origin.
|
|
$pattern_position_default = $this->get_attr_default( 'repeat_origin', $pattern_base_prop_name, $fields_definition );
|
|
$pattern_position_inherit = $this->get_attr_value( 'repeat_origin', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
$pattern_horizontal_offset_inherit = $this->get_attr_value( 'horizontal_offset', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
$pattern_vertical_offset_inherit = $this->get_attr_value( 'vertical_offset', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
|
|
// Check if pattern repeat has 'space' value or not.
|
|
$is_pattern_repeat_space = 'space' === $this->get_attr_value( 'repeat', $pattern_base_prop_name, $suffix, $props, $fields_definition, false );
|
|
|
|
// Print pattern repeat origin/offset when pattern size is not 'stretch', and
|
|
// pattern repeat is not 'space'.
|
|
if (
|
|
! $is_pattern_size_stretch
|
|
&& ! $is_pattern_repeat_space
|
|
&& ( '' !== $pattern_position_inherit || $pattern_horizontal_offset_inherit || $pattern_vertical_offset_inherit )
|
|
) {
|
|
// Get Position CSS.
|
|
$pattern_position_style = $this->get_background_position_css( $pattern_position_inherit, $pattern_horizontal_offset_inherit, $pattern_vertical_offset_inherit, $pattern_position_default );
|
|
|
|
// Set background pattern position styles only it's different compared to the larger device.
|
|
if ( $processed_pattern_position_style !== $pattern_position_style ) {
|
|
$style_pattern .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $pattern_position_style['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Pattern Blend Mode.
|
|
$pattern_blend_inherit = $this->get_attr_value( 'blend_mode', $pattern_base_prop_name, $suffix, $props, $fields_definition, $is_prev_pattern_active );
|
|
|
|
if ( '' !== $pattern_blend_inherit ) {
|
|
$style_pattern .= sprintf(
|
|
'mix-blend-mode: %1$s; ',
|
|
esc_html( $pattern_blend_inherit )
|
|
);
|
|
}
|
|
} elseif ( ! $is_desktop && $processed_pattern_svg !== $pattern_style_svg ) {
|
|
// Reset pattern image.
|
|
$pattern_style_svg = 'initial';
|
|
$style_pattern .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $pattern_style_svg )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Save processed styles.
|
|
$processed_pattern_transform_style = $pattern_transform_style;
|
|
$processed_pattern_svg = $pattern_style_svg;
|
|
$processed_pattern_size_style = $pattern_size_style;
|
|
$processed_pattern_position_style = $pattern_position_style;
|
|
|
|
// F. Background Mask.
|
|
if ( $use_mask_options && 'fields_only' !== $use_mask_options ) {
|
|
$mask_style_name = $responsive->get_inheritance_background_value( $props, "{$mask_base_prop_name}_style", $device, $base_prop_name, $fields_definition );
|
|
|
|
$is_mask_active = '' !== $mask_style_name;
|
|
$mask_status[ $device ] = $is_mask_active;
|
|
|
|
if ( $is_mask_active ) {
|
|
// Check previous mask status. Needed to get the correct value.
|
|
$is_prev_mask_active = true;
|
|
if ( ! $is_desktop ) {
|
|
$is_prev_mask_active = 'tablet' === $device ? $mask_status['desktop'] : $mask_status['tablet'];
|
|
}
|
|
|
|
// Mask Transform.
|
|
$mask_transform_inherit = $responsive->get_any_value( $props, "{$mask_base_prop_name}_transform{$suffix}", '', true );
|
|
|
|
$mask_is_horizontal = $this->get_transform_state( $mask_transform_inherit, 'horizontal' );
|
|
$mask_is_vertical = $this->get_transform_state( $mask_transform_inherit, 'vertical' );
|
|
$mask_is_rotated = $this->get_transform_state( $mask_transform_inherit, 'rotate' );
|
|
$mask_is_inverted = $this->get_transform_state( $mask_transform_inherit, 'invert' );
|
|
$mask_transform_style = $this->get_transform_css( $mask_is_horizontal, $mask_is_vertical );
|
|
|
|
$is_mask_transform_style_different = $processed_mask_transform_style !== $mask_transform_style;
|
|
|
|
if ( $is_mask_transform_style_different && ( $mask_is_horizontal || $mask_is_vertical ) ) {
|
|
$style_mask .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $mask_transform_style )
|
|
);
|
|
} elseif ( $is_mask_transform_style_different && ! $is_desktop ) {
|
|
$style_mask .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $mask_transform_style )
|
|
);
|
|
}
|
|
|
|
// Mask Size.
|
|
$mask_size_default = $this->get_attr_default( 'size', $mask_base_prop_name, $fields_definition );
|
|
$mask_size_inherit = $this->get_attr_value( 'size', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
$mask_width_inherit = $this->get_attr_value( 'width', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
$mask_height_inherit = $this->get_attr_value( 'height', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
|
|
if ( '' !== $mask_size_inherit || ( $mask_width_inherit || $mask_height_inherit ) ) {
|
|
// Get Size CSS.
|
|
$mask_size_style = $this->get_background_size_css( $mask_size_inherit, $mask_width_inherit, $mask_height_inherit, $mask_size_default, 'mask' );
|
|
|
|
// Set mask background size styles only it's different compared to the larger device.
|
|
if ( $processed_mask_size_style !== $mask_size_style ) {
|
|
if ( isset( $mask_size_style['size'] ) && $mask_size_style['size'] ) {
|
|
$style_mask .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $mask_size_style['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if mask size has 'stretch' value or not.
|
|
$is_mask_size_stretch = 'stretch' === $mask_size_inherit;
|
|
|
|
// Set background mask style only it's different compared to the larger device.
|
|
$mask_color = $responsive->get_any_value( $props, "{$mask_base_prop_name}_color{$suffix}", '', true );
|
|
$mask_ratio = $responsive->get_any_value( $props, "{$mask_base_prop_name}_aspect_ratio{$suffix}", '', true );
|
|
$mask_style_svg = et_pb_background_mask_options()->get_svg( $mask_style_name, $mask_color, $mask_ratio, $mask_is_rotated, $mask_is_inverted, $mask_size_inherit );
|
|
|
|
if ( $processed_mask_svg !== $mask_style_svg ) {
|
|
$style_mask .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $mask_style_svg )
|
|
);
|
|
}
|
|
|
|
// Mask Position.
|
|
$mask_position_default = $responsive->get_any_value( $props, "{$mask_base_prop_name}_position{$suffix}", '', true );
|
|
$mask_position_inherit = $this->get_attr_value( 'position', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
$mask_horizontal_offset_inherit = $this->get_attr_value( 'horizontal_offset', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
$mask_vertical_offset_inherit = $this->get_attr_value( 'vertical_offset', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
|
|
if ( ! $is_mask_size_stretch && ( '' !== $mask_position_inherit || $mask_horizontal_offset_inherit || $mask_vertical_offset_inherit ) ) {
|
|
// Get Position CSS.
|
|
$mask_position_style = $this->get_background_position_css( $mask_position_inherit, $mask_horizontal_offset_inherit, $mask_vertical_offset_inherit, $mask_position_default );
|
|
|
|
// Set background mask position styles only it's different compared to the larger device.
|
|
if ( $processed_mask_position_style !== $mask_position_style ) {
|
|
$style_mask .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $mask_position_style['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Mask Blend Mode.
|
|
$mask_blend_inherit = $this->get_attr_value( 'blend_mode', $mask_base_prop_name, $suffix, $props, $fields_definition, $is_prev_mask_active );
|
|
|
|
if ( '' !== $mask_blend_inherit ) {
|
|
$style_mask .= sprintf(
|
|
'mix-blend-mode: %1$s; ',
|
|
esc_html( $mask_blend_inherit )
|
|
);
|
|
}
|
|
} elseif ( ! $is_desktop && $processed_mask_svg !== $mask_style_svg ) {
|
|
// Reset mask image.
|
|
$mask_style_svg = 'initial';
|
|
$style_mask .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $mask_style_svg )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Save processed styles.
|
|
$processed_mask_transform_style = $mask_transform_style;
|
|
$processed_mask_svg = $mask_style_svg;
|
|
$processed_mask_size_style = $mask_size_style;
|
|
$processed_mask_position_style = $mask_position_style;
|
|
|
|
// Add media query parameter.
|
|
$background_args = array();
|
|
if ( ! $is_desktop ) {
|
|
$current_media_query = 'tablet' === $device ? 'max_width_980' : 'max_width_767';
|
|
$background_args['media_query'] = ET_Builder_Element::get_media_query( $current_media_query );
|
|
}
|
|
|
|
// Render background styles.
|
|
if ( '' !== $style ) {
|
|
$el_style = array(
|
|
'selector' => $selector,
|
|
'declaration' => rtrim( $style ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, wp_parse_args( $background_args, $el_style ) );
|
|
}
|
|
|
|
// Render pattern styles.
|
|
if ( '' !== $style_pattern ) {
|
|
$el_pattern_style = array(
|
|
'selector' => $selector_pattern,
|
|
'declaration' => rtrim( $style_pattern ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, wp_parse_args( $background_args, $el_pattern_style ) );
|
|
}
|
|
|
|
// Render mask styles.
|
|
if ( '' !== $style_mask ) {
|
|
$el_mask_style = array(
|
|
'selector' => $selector_mask,
|
|
'declaration' => rtrim( $style_mask ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, wp_parse_args( $background_args, $el_mask_style ) );
|
|
}
|
|
}
|
|
|
|
// Background Modes (Hover & Sticky).
|
|
$modes = array( 'hover', 'sticky' );
|
|
|
|
foreach ( $modes as $mode ) {
|
|
// Get helper.
|
|
$helper = et_builder_get_helper( $mode );
|
|
|
|
// Bail if no helper.
|
|
if ( ! $helper ) {
|
|
continue;
|
|
}
|
|
|
|
// Get selector.
|
|
$selector_mode = $args[ "selector_{$mode}" ];
|
|
|
|
$selector_pattern_mode = '';
|
|
$selector_mask_mode = '';
|
|
|
|
// If no fixed selector defined, prepend / append default selector.
|
|
if ( '' === $selector_mode ) {
|
|
if ( 'hover' === $mode ) {
|
|
$selector_mode = $helper->add_hover_to_selectors( $selector );
|
|
} elseif ( 'sticky' === $mode ) {
|
|
$is_sticky_module = $helper->is_sticky_module( $props );
|
|
$selector_mode = $helper->add_sticky_to_order_class( $selector, $is_sticky_module );
|
|
}
|
|
}
|
|
|
|
$base_prop_name_mode_parsed = $this->get_prop_name_alias( $prop_name_aliases, $base_prop_name );
|
|
$is_enabled_mode = $helper->is_enabled( $base_prop_name_mode_parsed, $props );
|
|
$background_image_field = "{$base_prop_name}_image";
|
|
|
|
if ( 'hover' === $mode ) {
|
|
$selector_pattern_mode = $helper->add_hover_to_order_class( $selector_pattern );
|
|
$selector_mask_mode = $helper->add_hover_to_order_class( $selector_mask );
|
|
$background_image_field = $helper->get_hover_field( $background_image_field );
|
|
} elseif ( 'sticky' === $mode ) {
|
|
$is_sticky_module = $helper->is_sticky_module( $props );
|
|
$selector_pattern_mode = $helper->add_sticky_to_order_class( $selector_pattern, $is_sticky_module );
|
|
$selector_mask_mode = $helper->add_sticky_to_order_class( $selector_mask, $is_sticky_module );
|
|
$background_image_field = $helper->get_sticky_field( $background_image_field );
|
|
}
|
|
|
|
// Check if mode is enabled.
|
|
if ( $is_enabled_mode ) {
|
|
$images_mode = array();
|
|
$style_mode = '';
|
|
|
|
$style_pattern_mode = '';
|
|
$style_mask_mode = '';
|
|
|
|
$has_gradient_mode = false;
|
|
$has_image_mode = false;
|
|
$has_gradient_and_image_mode = false;
|
|
$is_gradient_mode_disabled = false;
|
|
$is_image_mode_disabled = false;
|
|
|
|
$gradient_overlays_image_mode = 'off';
|
|
|
|
// Background Gradient Mode (Hover / Sticky).
|
|
// This part is little bit different compared to responsive implementation. In
|
|
// this case, mode is enabled on the background field, not on the each of those
|
|
// fields. So, built in function get_value() doesn't work in this case.
|
|
// Temporarily, we need to fetch the the value from get_raw_value().
|
|
if ( $use_gradient_options && 'fields_only' !== $use_gradient_options ) {
|
|
$use_gradient_mode = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
$this->get_prop_name_alias( $prop_name_aliases, "use_{$base_prop_name}_color_gradient" ),
|
|
$mode,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
|
|
// 1. Ensure gradient color is active and values are not null.
|
|
if ( 'on' === $use_gradient_mode ) {
|
|
// Flag to inform BG Color if current module has Gradient.
|
|
$has_gradient_mode = true;
|
|
$gradient_values_mode = $this->get_gradient_mode_properties(
|
|
$mode,
|
|
$props,
|
|
$base_prop_name,
|
|
$gradient_properties_desktop
|
|
);
|
|
|
|
$gradient_mode = $this->get_gradient_style( $gradient_values_mode );
|
|
$images_mode[] = $gradient_mode;
|
|
|
|
$gradient_overlays_image_desktop = $responsive->get_any_value(
|
|
$props,
|
|
"{$base_prop_name}_color_gradient_overlays_image",
|
|
'',
|
|
true
|
|
);
|
|
$gradient_overlays_image_mode = $helper->get_raw_value(
|
|
"{$base_prop_name}_color_gradient_overlays_image",
|
|
$props,
|
|
$gradient_overlays_image_desktop
|
|
);
|
|
} elseif ( 'off' === $use_gradient_mode ) {
|
|
$is_gradient_mode_disabled = true;
|
|
}
|
|
}
|
|
|
|
// Background Image Mode (Hover / Sticky).
|
|
// This part is little bit different compared to responsive implementation. In
|
|
// this case, mode is enabled on the background field, not on the each of those
|
|
// fields. So, built in function get_value() doesn't work in this case.
|
|
// Temporarily, we need to fetch the the value from get_raw_value().
|
|
if ( $use_image_options && 'fields_only' !== $use_image_options ) {
|
|
$image_mode = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
"{$base_prop_name}_image",
|
|
$mode,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
$parallax_mode = $helper->get_raw_value( 'parallax', $props );
|
|
|
|
// Determine whether force inline styles.
|
|
if ( ! ET_Builder_Element::$forced_inline_styles ) {
|
|
$raw = isset( $attrs_unprocessed[ $background_image_field ] ) ? $attrs_unprocessed[ $background_image_field ] : '';
|
|
if ( $this->_is_dynamic_value( $background_image_field, $raw, $dynamic_attributes ) ) {
|
|
ET_Builder_Element::$forced_inline_styles = true;
|
|
}
|
|
}
|
|
|
|
// Featured image as background is in higher priority.
|
|
if ( $module->featured_image_background ) {
|
|
$featured_image = isset( $props['featured_image'] ) ? $props['featured_image'] : '';
|
|
$featured_placement = isset( $props['featured_placement'] ) ? $props['featured_placement'] : '';
|
|
$featured_image_src_obj = wp_get_attachment_image_src( get_post_thumbnail_id( self::_get_main_post_id() ), 'full' );
|
|
$featured_image_src = isset( $featured_image_src_obj[0] ) ? $featured_image_src_obj[0] : '';
|
|
|
|
if ( 'on' === $featured_image && 'background' === $featured_placement && '' !== $featured_image_src ) {
|
|
$image_mode = $featured_image_src;
|
|
}
|
|
}
|
|
|
|
if ( '' !== $image_mode && null !== $image_mode && 'on' !== $parallax_mode ) {
|
|
// Flag to inform BG Color if current module has Image.
|
|
$has_image_mode = true;
|
|
|
|
// Size.
|
|
$image_size_default = $this->get_attr_default( 'size', $base_prop_name, $fields_definition );
|
|
$image_size_mode = $helper->get_raw_value( "{$base_prop_name}_size", $props );
|
|
$image_size_desktop = isset( $props[ "{$base_prop_name}_size" ] ) ? $props[ "{$base_prop_name}_size" ] : '';
|
|
|
|
if ( empty( $image_size_mode ) && ! empty( $image_size_desktop ) ) {
|
|
$image_size_mode = $image_size_desktop;
|
|
}
|
|
|
|
$is_same_image_size = $image_size_mode === $image_size_desktop;
|
|
|
|
if ( ! empty( $image_size_mode ) && ! $is_same_image_size ) {
|
|
$image_width_desktop = isset( $props[ "{$base_prop_name}_image_width" ] ) ? $props[ "{$base_prop_name}_image_width" ] : '';
|
|
$image_width_mode = $helper->get_raw_value( "{$base_prop_name}_image_width", $props, $image_width_desktop );
|
|
$image_height_desktop = isset( $props[ "{$base_prop_name}_image_height" ] ) ? $props[ "{$base_prop_name}_image_height" ] : '';
|
|
$image_height_mode = $helper->get_raw_value( "{$base_prop_name}_image_height", $props, $image_height_desktop );
|
|
|
|
// Get Size CSS.
|
|
$image_size_style_desktop = $this->get_background_size_css( $image_size_desktop, $image_width_desktop, $image_height_desktop, $image_size_default, 'image' );
|
|
$image_size_style_mode = $this->get_background_size_css( $image_size_mode, $image_width_mode, $image_height_mode, $image_size_default, 'image' );
|
|
|
|
$is_same_image_size_style = $image_size_style_mode === $image_size_style_desktop;
|
|
|
|
if ( ! empty( $image_size_style_mode ) && ! $is_same_image_size_style ) {
|
|
if ( isset( $image_size_style_mode['size'] ) && $image_size_style_mode['size'] ) {
|
|
$style_mode .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $image_size_style_mode['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if image size has 'stretch' value or not.
|
|
$is_image_size_stretch_mode = 'stretch' === $image_size_mode;
|
|
|
|
// Repeat.
|
|
$image_repeat_mode = $helper->get_raw_value( "{$base_prop_name}_repeat", $props );
|
|
$image_repeat_desktop = isset( $props[ "{$base_prop_name}_repeat" ] ) ? $props[ "{$base_prop_name}_repeat" ] : '';
|
|
$is_same_image_repeat = $image_repeat_mode === $image_repeat_desktop;
|
|
|
|
if ( empty( $image_repeat_mode ) && ! empty( $image_repeat_desktop ) ) {
|
|
$image_repeat_mode = $image_repeat_desktop;
|
|
}
|
|
|
|
// Don't print the same image repeat.
|
|
// Don't print image repeat when image size is 'stretch'.
|
|
if ( ! empty( $image_repeat_mode ) && ! $is_same_image_repeat && ! $is_image_size_stretch_mode ) {
|
|
$style_mode .= sprintf(
|
|
'background-repeat: %1$s; ',
|
|
esc_html( $image_repeat_mode )
|
|
);
|
|
}
|
|
|
|
// Position.
|
|
$image_position_mode = $helper->get_raw_value( "{$base_prop_name}_position", $props );
|
|
$image_position_desktop = isset( $props[ "{$base_prop_name}_position" ] ) ? $props[ "{$base_prop_name}_position" ] : '';
|
|
|
|
if ( empty( $image_position_mode ) && ! empty( $image_position_desktop ) ) {
|
|
$image_position_mode = $image_position_desktop;
|
|
}
|
|
|
|
// Check if pattern repeat has 'space' value or not.
|
|
$is_image_repeat_space_mode = 'space' === $image_repeat_mode;
|
|
|
|
// Print image position/offset when pattern size is not 'stretch', and
|
|
// image repeat is not 'space'.
|
|
if ( ! empty( $image_position_mode ) && ! $is_image_repeat_space_mode && ! $is_image_size_stretch_mode ) {
|
|
$horizontal_offset_desktop = isset( $props[ "{$base_prop_name}_horizontal_offset" ] ) ? $props[ "{$base_prop_name}_horizontal_offset" ] : '';
|
|
$horizontal_offset_mode = $helper->get_raw_value( "{$base_prop_name}_horizontal_offset", $props, $horizontal_offset_desktop );
|
|
$vertical_offset_desktop = isset( $props[ "{$base_prop_name}_vertical_offset" ] ) ? $props[ "{$base_prop_name}_vertical_offset" ] : '';
|
|
$vertical_offset_mode = $helper->get_raw_value( "{$base_prop_name}_vertical_offset", $props, $vertical_offset_desktop );
|
|
|
|
// Get Position CSS.
|
|
$image_position_style_desktop = $this->get_background_position_css( $image_position_desktop, $horizontal_offset_desktop, $vertical_offset_desktop );
|
|
$image_position_style_mode = $this->get_background_position_css( $image_position_mode, $horizontal_offset_mode, $vertical_offset_mode );
|
|
|
|
$is_same_image_position_style = $image_position_style_mode === $image_position_style_desktop;
|
|
|
|
if ( ! empty( $image_position_style_mode ) && ! $is_same_image_position_style ) {
|
|
$style_mode .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $image_position_style_mode['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Blend.
|
|
$image_blend_mode = $helper->get_raw_value( "{$base_prop_name}_blend", $props );
|
|
$image_blend_default = $this->get_attr_default( 'blend', $base_prop_name, $fields_definition );
|
|
$image_blend_desktop = isset( $props[ "{$base_prop_name}_blend" ] ) ? $props[ "{$base_prop_name}_blend" ] : '';
|
|
$is_same_image_blend = $image_blend_mode === $image_blend_desktop;
|
|
|
|
if ( empty( $image_blend_mode ) && ! empty( $image_blend_desktop ) ) {
|
|
$image_blend_mode = $image_blend_desktop;
|
|
}
|
|
|
|
if ( ! empty( $image_blend_mode ) ) {
|
|
// Don't print the same background blend.
|
|
if ( ! $is_same_image_blend ) {
|
|
$style_mode .= sprintf(
|
|
'background-blend-mode: %1$s; ',
|
|
esc_html( $image_blend_mode )
|
|
);
|
|
}
|
|
|
|
// Force background-color: initial.
|
|
if ( $has_gradient_mode && $has_image_mode && $image_blend_mode !== $image_blend_default ) {
|
|
$has_gradient_and_image_mode = true;
|
|
$style_mode .= sprintf( 'background-color: initial%1$s; ', esc_html( $important ) );
|
|
}
|
|
}
|
|
|
|
// Only append background image when the image is exist.
|
|
$images_mode[] = sprintf( 'url(%1$s)', esc_html( $image_mode ) );
|
|
} elseif ( '' === $image_mode ) {
|
|
$is_image_mode_disabled = true;
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $images_mode ) ) {
|
|
// Check if Parallax and Gradient Overlays are on.
|
|
$gradient_overlays_image_desktop = $responsive->get_any_value( $props, "{$base_prop_name}_color_gradient_overlays_image", 'off', true );
|
|
$gradient_overlays_image_mode = $helper->get_raw_value( "{$base_prop_name}_color_gradient_overlays_image", $props, $gradient_overlays_image_desktop );
|
|
$parallax_desktop = $responsive->get_any_value( $props, 'parallax', 'off', true );
|
|
$parallax_mode = $helper->get_raw_value( 'parallax', $props, $parallax_desktop );
|
|
|
|
// The browsers stack the images in the opposite order to what you'd expect.
|
|
if ( 'on' !== $gradient_overlays_image_mode ) {
|
|
$images_mode = array_reverse( $images_mode );
|
|
}
|
|
|
|
if ( $use_gradient_options && 'on' === $gradient_overlays_image_mode && 'on' === $parallax_mode ) {
|
|
// Set background image to initial when Parallax and Gradient Overlays are on.
|
|
$images_mode = 'initial';
|
|
} else {
|
|
$images_mode = join( ', ', $images_mode );
|
|
}
|
|
|
|
$style_mode .= sprintf(
|
|
'background-image: %1$s%2$s;',
|
|
esc_html( $images_mode ),
|
|
$important
|
|
);
|
|
} elseif ( $is_gradient_mode_disabled && $is_image_mode_disabled ) {
|
|
$style_mode .= sprintf(
|
|
'background-image: initial %1$s;',
|
|
$important
|
|
);
|
|
}
|
|
|
|
// Background Color Mode (Hover / Sticky).
|
|
if ( $use_color_options && 'fields_only' !== $use_color_options ) {
|
|
$use_color_mode_default = isset( $props[ "use_{$base_prop_name}_color" ] ) ? $props[ "use_{$base_prop_name}_color" ] : 'on';
|
|
$use_color_mode_value = $helper->get_raw_value( "use_{$base_prop_name}_color", $props );
|
|
$use_color_mode_value = ! empty( $use_color_mode_value )
|
|
? $use_color_mode_value
|
|
: $use_color_mode_default;
|
|
|
|
if ( ! $has_gradient_and_image_mode && 'off' !== $use_color_mode_value ) {
|
|
$color_mode = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
"{$base_prop_name}_color",
|
|
$mode,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
|
|
$color_mode = '' !== $color_mode ? $color_mode : 'transparent';
|
|
|
|
if ( '' !== $color_mode ) {
|
|
$style_mode .= sprintf(
|
|
'background-color: %1$s%2$s; ',
|
|
esc_html( $this->get_color_value( $color_mode ) ),
|
|
esc_html( $important )
|
|
);
|
|
}
|
|
} elseif ( $has_color_toggle_options && 'off' === $use_color_mode_value ) {
|
|
// Reset - If current module has background color toggle, it's off, and current mode
|
|
// it's not desktop, we should reset the background color.
|
|
$style .= sprintf(
|
|
'background-color: initial %1$s; ',
|
|
esc_html( $important )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Background Pattern Mode (Hover / Sticky).
|
|
// This part is little bit different compared to responsive implementation. In
|
|
// this case, mode is enabled on the background field, not on the each of those
|
|
// fields. So, built in function get_value() doesn't work in this case.
|
|
// Temporarily, we need to fetch the the value from get_raw_value().
|
|
if ( $use_pattern_options && 'fields_only' !== $use_pattern_options ) {
|
|
$pattern_style_name_mode = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
"{$pattern_base_prop_name}_style",
|
|
$mode,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
|
|
if ( '' !== $pattern_style_name_mode ) {
|
|
// Pattern Transform.
|
|
$pattern_transform_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_transform", $props );
|
|
$pattern_transform_desktop = isset( $props[ "{$pattern_base_prop_name}_transform" ] ) ? $props[ "{$pattern_base_prop_name}_transform" ] : '';
|
|
|
|
if ( empty( $pattern_transform_mode ) && ! empty( $pattern_transform_desktop ) ) {
|
|
$pattern_transform_mode = $pattern_transform_desktop;
|
|
}
|
|
|
|
$pattern_is_horizontal_mode = $this->get_transform_state( $pattern_transform_mode, 'horizontal' );
|
|
$pattern_is_vertical_mode = $this->get_transform_state( $pattern_transform_mode, 'vertical' );
|
|
$pattern_is_rotated_mode = $this->get_transform_state( $pattern_transform_mode, 'rotate' );
|
|
$pattern_is_inverted_mode = $this->get_transform_state( $pattern_transform_mode, 'invert' );
|
|
|
|
if ( ! empty( $pattern_transform_mode ) && ( $pattern_is_horizontal_mode || $pattern_is_vertical_mode ) ) {
|
|
$style_pattern_mode .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $this->get_transform_css( $pattern_is_horizontal_mode, $pattern_is_vertical_mode ) )
|
|
);
|
|
};
|
|
|
|
// Set background pattern style only it's different compared to the larger device.
|
|
$pattern_color_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_color", $props );
|
|
$pattern_color_desktop = isset( $props[ "{$pattern_base_prop_name}_color" ] ) ? $props[ "{$pattern_base_prop_name}_color" ] : '';
|
|
|
|
if ( empty( $pattern_color_mode ) && ! empty( $pattern_color_desktop ) ) {
|
|
$pattern_color_mode = $pattern_color_desktop;
|
|
}
|
|
|
|
$pattern_style_svg_mode = et_pb_background_pattern_options()->get_svg( $pattern_style_name_mode, $pattern_color_mode, 'default', $pattern_is_rotated_mode, $pattern_is_inverted_mode );
|
|
|
|
$style_pattern_mode .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $pattern_style_svg_mode )
|
|
);
|
|
|
|
// Pattern Size.
|
|
$pattern_size_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_size", $props );
|
|
$pattern_size_desktop = isset( $props[ "{$pattern_base_prop_name}_size" ] ) ? $props[ "{$pattern_base_prop_name}_size" ] : '';
|
|
|
|
if ( empty( $pattern_size_mode ) && ! empty( $pattern_size_desktop ) ) {
|
|
$pattern_size_mode = $pattern_size_desktop;
|
|
}
|
|
|
|
if ( ! empty( $pattern_size_mode ) ) {
|
|
$pattern_width_desktop = isset( $props[ "{$pattern_base_prop_name}_width" ] ) ? $props[ "{$pattern_base_prop_name}_width" ] : '';
|
|
$pattern_width_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_width", $props, $pattern_width_desktop );
|
|
$pattern_height_desktop = isset( $props[ "{$pattern_base_prop_name}_height" ] ) ? $props[ "{$pattern_base_prop_name}_height" ] : '';
|
|
$pattern_height_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_height", $props, $pattern_height_desktop );
|
|
|
|
// Get Size CSS.
|
|
$pattern_size_style_desktop = $this->get_background_size_css( $pattern_size_desktop, $pattern_width_desktop, $pattern_height_desktop );
|
|
$pattern_size_style_mode = $this->get_background_size_css( $pattern_size_mode, $pattern_width_mode, $pattern_height_mode );
|
|
|
|
$is_same_pattern_size_style = $pattern_size_style_mode === $pattern_size_style_desktop;
|
|
|
|
if ( ! empty( $pattern_size_style_mode ) && ! $is_same_pattern_size_style ) {
|
|
if ( isset( $pattern_size_style_mode['size'] ) && $pattern_size_style_mode['size'] ) {
|
|
$style_pattern_mode .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $pattern_size_style_mode['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check if pattern size has 'stretch' value or not.
|
|
$is_pattern_size_stretch_mode = 'stretch' === $pattern_size_mode;
|
|
|
|
// Pattern Repeat.
|
|
$pattern_repeat_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_repeat", $props );
|
|
$pattern_repeat_desktop = isset( $props[ "{$pattern_base_prop_name}_repeat" ] ) ? $props[ "{$pattern_base_prop_name}_repeat" ] : '';
|
|
|
|
if ( empty( $pattern_repeat_mode ) && ! empty( $pattern_repeat_desktop ) ) {
|
|
$pattern_repeat_mode = $pattern_repeat_desktop;
|
|
}
|
|
|
|
$is_same_pattern_repeat_style = $pattern_repeat_mode === $pattern_repeat_desktop;
|
|
|
|
// Don't print the same pattern repeat.
|
|
// Don't print pattern repeat when pattern size is 'stretch'.
|
|
if ( ! empty( $pattern_repeat_mode ) && ! $is_same_pattern_repeat_style && ! $is_pattern_size_stretch_mode ) {
|
|
$style_pattern_mode .= sprintf(
|
|
'background-repeat: %1$s; ',
|
|
esc_html( $pattern_repeat_mode )
|
|
);
|
|
}
|
|
|
|
// Pattern repeat origin.
|
|
$pattern_position_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_repeat_origin", $props );
|
|
$pattern_position_desktop = isset( $props[ "{$pattern_base_prop_name}_repeat_origin" ] ) ? $props[ "{$pattern_base_prop_name}_repeat_origin" ] : '';
|
|
|
|
if ( empty( $pattern_position_mode ) && ! empty( $pattern_position_desktop ) ) {
|
|
$pattern_position_mode = $pattern_position_desktop;
|
|
}
|
|
|
|
// Check if pattern repeat has 'space' value or not.
|
|
$is_pattern_repeat_space_mode = 'space' === $pattern_repeat_mode;
|
|
|
|
// Print pattern repeat origin/offset when pattern size is not 'stretch',
|
|
// and pattern repeat is not 'space'.
|
|
if ( ! empty( $pattern_position_mode ) && ! $is_pattern_repeat_space_mode && ! $is_pattern_size_stretch_mode ) {
|
|
$pattern_horizontal_offset_desktop = isset( $props[ "{$pattern_base_prop_name}_horizontal_offset" ] ) ? $props[ "{$pattern_base_prop_name}_horizontal_offset" ] : '';
|
|
$pattern_horizontal_offset_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_horizontal_offset", $props, $pattern_horizontal_offset_desktop );
|
|
$pattern_vertical_offset_desktop = isset( $props[ "{$pattern_base_prop_name}_vertical_offset" ] ) ? $props[ "{$pattern_base_prop_name}_vertical_offset" ] : '';
|
|
$pattern_vertical_offset_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_vertical_offset", $props, $pattern_vertical_offset_desktop );
|
|
|
|
// Get Position CSS.
|
|
$pattern_position_style_desktop = $this->get_background_position_css( $pattern_position_desktop, $pattern_horizontal_offset_desktop, $pattern_vertical_offset_desktop );
|
|
$pattern_position_style_mode = $this->get_background_position_css( $pattern_position_mode, $pattern_horizontal_offset_mode, $pattern_vertical_offset_mode );
|
|
|
|
$is_same_pattern_position_style = $pattern_position_style_mode === $pattern_position_style_desktop;
|
|
|
|
if ( ! empty( $pattern_position_style_mode ) && ! $is_same_pattern_position_style ) {
|
|
$style_pattern_mode .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $pattern_position_style_mode['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Pattern Blend Mode.
|
|
$pattern_blend_mode = $helper->get_raw_value( "{$pattern_base_prop_name}_blend_mode", $props );
|
|
$pattern_blend_desktop = isset( $props[ "{$pattern_base_prop_name}_blend_mode" ] ) ? $props[ "{$pattern_base_prop_name}_blend_mode" ] : '';
|
|
|
|
if ( empty( $pattern_blend_mode ) && ! empty( $pattern_blend_desktop ) ) {
|
|
$pattern_blend_mode = $pattern_blend_desktop;
|
|
}
|
|
|
|
$is_same_pattern_blend_style = $pattern_blend_mode === $pattern_blend_desktop;
|
|
|
|
// Don't print the same pattern blend mode.
|
|
if ( ! empty( $pattern_blend_mode ) && ! $is_same_pattern_blend_style ) {
|
|
$style_pattern_mode .= sprintf(
|
|
'mix-blend-mode: %1$s; ',
|
|
esc_html( $pattern_blend_mode )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Background Mask Mode (Hover / Sticky).
|
|
// This part is little bit different compared to responsive implementation. In
|
|
// this case, mode is enabled on the background field, not on the each of those
|
|
// fields. So, built in function get_value() doesn't work in this case.
|
|
// Temporarily, we need to fetch the the value from get_raw_value().
|
|
if ( $use_mask_options && 'fields_only' !== $use_mask_options ) {
|
|
$mask_style_name_mode = $responsive->get_inheritance_background_value(
|
|
$props,
|
|
"{$base_prop_name}_mask_style",
|
|
$mode,
|
|
$base_prop_name,
|
|
$fields_definition
|
|
);
|
|
|
|
if ( '' !== $mask_style_name_mode ) {
|
|
// Mask Transform.
|
|
$mask_transform_mode = $helper->get_raw_value( "{$mask_base_prop_name}_transform", $props );
|
|
$mask_transform_desktop = isset( $props[ "{$mask_base_prop_name}_transform" ] ) ? $props[ "{$mask_base_prop_name}_transform" ] : '';
|
|
|
|
if ( empty( $mask_transform_mode ) && ! empty( $mask_transform_desktop ) ) {
|
|
$mask_transform_mode = $mask_transform_desktop;
|
|
}
|
|
|
|
$mask_is_horizontal_mode = $this->get_transform_state( $mask_transform_mode, 'horizontal' );
|
|
$mask_is_vertical_mode = $this->get_transform_state( $mask_transform_mode, 'vertical' );
|
|
$mask_is_rotated_mode = $this->get_transform_state( $mask_transform_mode, 'rotate' );
|
|
$mask_is_inverted_mode = $this->get_transform_state( $mask_transform_mode, 'invert' );
|
|
|
|
if ( ! empty( $mask_transform_mode ) && ( $mask_is_horizontal_mode || $mask_is_vertical_mode ) ) {
|
|
$style_mask_mode .= sprintf(
|
|
'transform: %1$s; ',
|
|
esc_html( $this->get_transform_css( $mask_is_horizontal_mode, $mask_is_vertical_mode ) )
|
|
);
|
|
};
|
|
|
|
// Mask Size.
|
|
$mask_size_default = $this->get_attr_default( 'size', $mask_base_prop_name, $fields_definition );
|
|
$mask_size_mode = $helper->get_raw_value( "{$mask_base_prop_name}_size", $props );
|
|
$mask_size_desktop = isset( $props[ "{$mask_base_prop_name}_size" ] ) ? $props[ "{$mask_base_prop_name}_size" ] : '';
|
|
|
|
if ( empty( $mask_size_mode ) && ! empty( $mask_size_desktop ) ) {
|
|
$mask_size_mode = $mask_size_desktop;
|
|
}
|
|
|
|
if ( ! empty( $mask_size_mode ) ) {
|
|
$mask_width_desktop = isset( $props[ "{$mask_base_prop_name}_width" ] ) ? $props[ "{$mask_base_prop_name}_width" ] : '';
|
|
$mask_width_mode = $helper->get_raw_value( "{$mask_base_prop_name}_width", $props, $mask_width_desktop );
|
|
$mask_height_desktop = isset( $props[ "{$mask_base_prop_name}_height" ] ) ? $props[ "{$mask_base_prop_name}_height" ] : '';
|
|
$mask_height_mode = $helper->get_raw_value( "{$mask_base_prop_name}_height", $props, $mask_height_desktop );
|
|
|
|
// Get Size CSS.
|
|
$mask_size_style_desktop = $this->get_background_size_css( $mask_size_desktop, $mask_width_desktop, $mask_height_desktop, $mask_size_default, 'mask' );
|
|
$mask_size_style_mode = $this->get_background_size_css( $mask_size_mode, $mask_width_mode, $mask_height_mode, $mask_size_default, 'mask' );
|
|
|
|
$is_same_mask_size_style = $mask_size_style_mode === $mask_size_style_desktop;
|
|
|
|
if ( ! empty( $mask_size_style_mode ) && ! $is_same_mask_size_style ) {
|
|
if ( isset( $mask_size_style_mode['size'] ) && $mask_size_style_mode['size'] ) {
|
|
$style_mask_mode .= sprintf(
|
|
'background-size: %1$s; ',
|
|
esc_html( $mask_size_style_mode['size'] )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Set background mask style only it's different compared to the larger device.
|
|
$mask_color_mode = $helper->get_raw_value( "{$mask_base_prop_name}_color", $props );
|
|
$mask_color_desktop = isset( $props[ "{$mask_base_prop_name}_color" ] ) ? $props[ "{$mask_base_prop_name}_color" ] : '';
|
|
|
|
if ( empty( $mask_color_mode ) && ! empty( $mask_color_desktop ) ) {
|
|
$mask_color_mode = $mask_color_desktop;
|
|
}
|
|
|
|
$mask_ratio_mode = $helper->get_raw_value( "{$mask_base_prop_name}_aspect_ratio", $props );
|
|
$mask_ratio_desktop = isset( $props[ "{$mask_base_prop_name}_aspect_ratio" ] ) ? $props[ "{$mask_base_prop_name}_aspect_ratio" ] : '';
|
|
|
|
if ( empty( $mask_ratio_mode ) && ! empty( $mask_ratio_desktop ) ) {
|
|
$mask_ratio_mode = $mask_ratio_desktop;
|
|
}
|
|
|
|
$mask_style_svg_mode = et_pb_background_mask_options()->get_svg( $mask_style_name_mode, $mask_color_mode, $mask_ratio_mode, $mask_is_rotated_mode, $mask_is_inverted_mode, $mask_size_mode );
|
|
|
|
$style_mask_mode .= sprintf(
|
|
'background-image: %1$s; ',
|
|
esc_html( $mask_style_svg_mode )
|
|
);
|
|
|
|
// Mask Position.
|
|
$mask_position_mode = $helper->get_raw_value( "{$mask_base_prop_name}_position", $props );
|
|
$mask_position_desktop = isset( $props[ "{$mask_base_prop_name}_position" ] ) ? $props[ "{$mask_base_prop_name}_position" ] : '';
|
|
|
|
if ( empty( $mask_position_mode ) && ! empty( $mask_position_desktop ) ) {
|
|
$mask_position_mode = $mask_position_desktop;
|
|
}
|
|
|
|
if ( ! empty( $mask_position_mode ) && ! empty( $mask_size_mode ) && 'stretch' !== $mask_size_mode ) {
|
|
$mask_horizontal_offset_desktop = isset( $props[ "{$mask_base_prop_name}_horizontal_offset" ] ) ? $props[ "{$mask_base_prop_name}_horizontal_offset" ] : '';
|
|
$mask_horizontal_offset_mode = $helper->get_raw_value( "{$mask_base_prop_name}_horizontal_offset", $props, $mask_horizontal_offset_desktop );
|
|
$mask_vertical_offset_desktop = isset( $props[ "{$mask_base_prop_name}_vertical_offset" ] ) ? $props[ "{$mask_base_prop_name}_vertical_offset" ] : '';
|
|
$mask_vertical_offset_mode = $helper->get_raw_value( "{$mask_base_prop_name}_vertical_offset", $props, $mask_vertical_offset_desktop );
|
|
|
|
// Get Position CSS.
|
|
$mask_position_style_desktop = $this->get_background_position_css( $mask_position_desktop, $mask_horizontal_offset_desktop, $mask_vertical_offset_desktop );
|
|
$mask_position_style_mode = $this->get_background_position_css( $mask_position_mode, $mask_horizontal_offset_mode, $mask_vertical_offset_mode );
|
|
|
|
$is_same_mask_position_style = $mask_position_style_mode === $mask_position_style_desktop;
|
|
|
|
if ( ! empty( $mask_position_style_mode ) && ! $is_same_mask_position_style ) {
|
|
$style_mask_mode .= sprintf(
|
|
'background-position: %1$s; ',
|
|
esc_html( $mask_position_style_mode['position'] )
|
|
);
|
|
}
|
|
}
|
|
|
|
// Mask Blend Mode.
|
|
$mask_blend_mode = $helper->get_raw_value( "{$mask_base_prop_name}_blend_mode", $props );
|
|
$mask_blend_desktop = isset( $props[ "{$mask_base_prop_name}_blend_mode" ] ) ? $props[ "{$mask_base_prop_name}_blend_mode" ] : '';
|
|
|
|
if ( empty( $mask_blend_mode ) && ! empty( $mask_blend_desktop ) ) {
|
|
$mask_blend_mode = $mask_blend_desktop;
|
|
}
|
|
|
|
$is_same_mask_blend_style = $mask_blend_mode === $mask_blend_desktop;
|
|
|
|
// Don't print the same mask blend mode.
|
|
if ( ! empty( $mask_blend_mode ) && ! $is_same_mask_blend_style ) {
|
|
$style_mask_mode .= sprintf(
|
|
'mix-blend-mode: %1$s; ',
|
|
esc_html( $mask_blend_mode )
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Render background mode styles.
|
|
if ( '' !== $style_mode ) {
|
|
$el_style = array(
|
|
'selector' => $selector_mode,
|
|
'declaration' => rtrim( $style_mode ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, $el_style );
|
|
}
|
|
|
|
// Render pattern mode styles.
|
|
if ( '' !== $style_pattern_mode ) {
|
|
$el_pattern_style = array(
|
|
'selector' => $selector_pattern_mode,
|
|
'declaration' => rtrim( $style_pattern_mode ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, $el_pattern_style );
|
|
}
|
|
|
|
// Render mask mode styles.
|
|
if ( '' !== $style_mask_mode ) {
|
|
$el_mask_style = array(
|
|
'selector' => $selector_mask_mode,
|
|
'declaration' => rtrim( $style_mask_mode ),
|
|
'priority' => $module->get_style_priority(),
|
|
);
|
|
ET_Builder_Element::set_style( $function_name, $el_mask_style );
|
|
}
|
|
}
|
|
}
|
|
|
|
// Cleanup.
|
|
$args = null;
|
|
$attrs_unprocessed = null;
|
|
$feature_manager = null;
|
|
$module = null;
|
|
$props = null;
|
|
$responsive = null;
|
|
}
|
|
|
|
/**
|
|
* Return default status for device modes.
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @return array
|
|
*/
|
|
public function get_default_mode_status() {
|
|
return array(
|
|
'desktop' => false,
|
|
'tablet' => false,
|
|
'phone' => false,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns real color value by the global color ID, if any.
|
|
*
|
|
* @param string $color Raw Color Value.
|
|
*
|
|
* @since 4.16.0 Refactored to perform a substring find/replace (for compound settings like in Gradient Builder).
|
|
*
|
|
* @return string
|
|
*/
|
|
public function get_color_value( $color ) {
|
|
if ( false === strpos( $color, 'gcid-' ) ) {
|
|
return $color;
|
|
}
|
|
|
|
$global_colors = et_builder_get_all_global_colors();
|
|
|
|
// If there are no matching Global Colors, return null.
|
|
if ( ! is_array( $global_colors ) ) {
|
|
return null;
|
|
}
|
|
|
|
foreach ( $global_colors as $gcid => $details ) {
|
|
if ( false !== strpos( $color, $gcid ) ) {
|
|
// Match substring (needed for attrs like gradient stops).
|
|
$color = str_replace( $gcid, $details['color'], $color );
|
|
}
|
|
}
|
|
|
|
return $color;
|
|
}
|
|
|
|
/**
|
|
* Get array of attributes which have dynamic content enabled.
|
|
*
|
|
* @param mixed[] $attrs Module attributes.
|
|
*
|
|
* @see ET_Builder_Element::_get_enabled_dynamic_attributes()
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @return string[]
|
|
*/
|
|
protected function _get_enabled_dynamic_attributes( $attrs ) {
|
|
$enabled_dynamic_attributes = isset( $attrs['_dynamic_attributes'] ) ? $attrs['_dynamic_attributes'] : '';
|
|
$enabled_dynamic_attributes = array_filter( explode( ',', $enabled_dynamic_attributes ) );
|
|
|
|
return $enabled_dynamic_attributes;
|
|
}
|
|
|
|
/**
|
|
* Check if an attribute value is dynamic or not.
|
|
*
|
|
* @param string $attribute Attribute name.
|
|
* @param string $value Attribute value.
|
|
* @param array $enabled_dynamic_attributes Attributes which have dynamic content enabled.
|
|
*
|
|
* @see ET_Builder_Element::_is_dynamic_value()
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @return bool
|
|
*/
|
|
protected function _is_dynamic_value( $attribute, $value, $enabled_dynamic_attributes ) {
|
|
if ( ! in_array( $attribute, $enabled_dynamic_attributes, true ) ) {
|
|
return false;
|
|
}
|
|
|
|
return et_builder_parse_dynamic_content( $value )->is_dynamic();
|
|
}
|
|
|
|
/**
|
|
* Get whether third party post interference should be respected.
|
|
* Current use case is for plugins like Toolset that render a
|
|
* loop within a layout which renders another layout for
|
|
* each post - in this case we must NOT override the
|
|
* current post so the loop works as expected.
|
|
*
|
|
* @see ET_Builder_Element::_should_respect_post_interference()
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @return boolean
|
|
*/
|
|
protected static function _should_respect_post_interference() {
|
|
$post = ET_Post_Stack::get();
|
|
|
|
return null !== $post && get_the_ID() !== $post->ID;
|
|
}
|
|
|
|
/**
|
|
* Retrieve the main query post id.
|
|
* Accounts for third party interference with the current post.
|
|
*
|
|
* @see ET_Builder_Element::_get_main_post_id()
|
|
*
|
|
* @since 4.15.0
|
|
*
|
|
* @return integer|boolean
|
|
*/
|
|
protected static function _get_main_post_id() {
|
|
if ( self::_should_respect_post_interference() ) {
|
|
return get_the_ID();
|
|
}
|
|
|
|
return ET_Post_Stack::get_main_post_id();
|
|
}
|
|
}
|