Edit File by line

<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Multi View Options helper class file

[2] Fix | Delete

[3] Fix | Delete

* @package ET/Builder

[4] Fix | Delete

[5] Fix | Delete

* @since 3.27.1

[6] Fix | Delete

[7] Fix | Delete

[8] Fix | Delete

if ( ! defined( 'ABSPATH' ) ) {

[9] Fix | Delete

die( 'Direct access forbidden.' );

[10] Fix | Delete

}

[11] Fix | Delete

[12] Fix | Delete

/**

[13] Fix | Delete

* Multi View Options helper class

[14] Fix | Delete

[15] Fix | Delete

* Class ET_Builder_Module_Helper_MultiViewOptions

[16] Fix | Delete

[17] Fix | Delete

* @since 3.27.1

[18] Fix | Delete

[19] Fix | Delete

class ET_Builder_Module_Helper_MultiViewOptions {

[20] Fix | Delete

[21] Fix | Delete

/**

[22] Fix | Delete

* HTML data attribute key.

[23] Fix | Delete

[24] Fix | Delete

* @since 3.27.1

[25] Fix | Delete

[26] Fix | Delete

* @var string

[27] Fix | Delete

[28] Fix | Delete

protected $data_attr_key = 'data-et-multi-view';

[29] Fix | Delete

[30] Fix | Delete

/**

[31] Fix | Delete

* Find and replace data regex pattern.

[32] Fix | Delete

[33] Fix | Delete

* @since 3.27.1

[34] Fix | Delete

[35] Fix | Delete

* @var string

[36] Fix | Delete

[37] Fix | Delete

protected $pattern = '/\{\{(.+)\}\}/';

[38] Fix | Delete

[39] Fix | Delete

/**

[40] Fix | Delete

* Module slug.

[41] Fix | Delete

[42] Fix | Delete

* @since 3.27.1

[43] Fix | Delete

[44] Fix | Delete

* @var string

[45] Fix | Delete

[46] Fix | Delete

protected $module;

[47] Fix | Delete

[48] Fix | Delete

/**

[49] Fix | Delete

* Module props data.

[50] Fix | Delete

[51] Fix | Delete

* @since 3.27.1

[52] Fix | Delete

[53] Fix | Delete

* @var array

[54] Fix | Delete

[55] Fix | Delete

protected $props = array();

[56] Fix | Delete

[57] Fix | Delete

/**

[58] Fix | Delete

* Module slug.

[59] Fix | Delete

[60] Fix | Delete

* @since 3.27.1

[61] Fix | Delete

[62] Fix | Delete

* @var string

[63] Fix | Delete

[64] Fix | Delete

protected $slug = '';

[65] Fix | Delete

[66] Fix | Delete

/**

[67] Fix | Delete

* Custom props data.

[68] Fix | Delete

[69] Fix | Delete

* @since 3.27.1

[70] Fix | Delete

[71] Fix | Delete

* @var array

[72] Fix | Delete

[73] Fix | Delete

protected $custom_props = array();

[74] Fix | Delete

[75] Fix | Delete

/**

[76] Fix | Delete

* Conditional values data.

[77] Fix | Delete

[78] Fix | Delete

* @since 3.27.1

[79] Fix | Delete

[80] Fix | Delete

* @var array

[81] Fix | Delete

[82] Fix | Delete

protected $conditional_values = array();

[83] Fix | Delete

[84] Fix | Delete

/**

[85] Fix | Delete

* Default values data.

[86] Fix | Delete

[87] Fix | Delete

* @since 3.27.1

[88] Fix | Delete

[89] Fix | Delete

* @var array

[90] Fix | Delete

[91] Fix | Delete

protected $default_values = array();

[92] Fix | Delete

[93] Fix | Delete

/**

[94] Fix | Delete

* Cached values data.

[95] Fix | Delete

[96] Fix | Delete

* @since 3.27.1

[97] Fix | Delete

[98] Fix | Delete

* @var array

[99] Fix | Delete

[100] Fix | Delete

protected $cached_values = array();

[101] Fix | Delete

[102] Fix | Delete

/**

[103] Fix | Delete

* Set list of props keys that need to inherit the value

[104] Fix | Delete

[105] Fix | Delete

* @since 4.0.2

[106] Fix | Delete

[107] Fix | Delete

* @var array

[108] Fix | Delete

[109] Fix | Delete

protected $inherited_values = array();

[110] Fix | Delete

[111] Fix | Delete

/**

[112] Fix | Delete

* Hover enabled option name suffix

[113] Fix | Delete

[114] Fix | Delete

* @since 3.27.1

[115] Fix | Delete

[116] Fix | Delete

* @var array

[117] Fix | Delete

[118] Fix | Delete

public static $hover_enabled_suffix = '__hover_enabled';

[119] Fix | Delete

[120] Fix | Delete

/**

[121] Fix | Delete

* Responsive enabled option name suffix

[122] Fix | Delete

[123] Fix | Delete

* @since 3.27.1

[124] Fix | Delete

[125] Fix | Delete

* @var array

[126] Fix | Delete

[127] Fix | Delete

public static $responsive_enabled_suffix = '_last_edited';

[128] Fix | Delete

[129] Fix | Delete

/**

[130] Fix | Delete

* Hover option name suffix

[131] Fix | Delete

[132] Fix | Delete

* @since 3.27.1

[133] Fix | Delete

[134] Fix | Delete

* @var array

[135] Fix | Delete

[136] Fix | Delete

public static $hover_suffix = '__hover';

[137] Fix | Delete

[138] Fix | Delete

/**

[139] Fix | Delete

* Tablet option name suffix

[140] Fix | Delete

[141] Fix | Delete

* @since 3.27.1

[142] Fix | Delete

[143] Fix | Delete

* @var array

[144] Fix | Delete

[145] Fix | Delete

public static $tablet_suffix = '_tablet';

[146] Fix | Delete

[147] Fix | Delete

/**

[148] Fix | Delete

* Phone option name suffix

[149] Fix | Delete

[150] Fix | Delete

* @since 3.27.1

[151] Fix | Delete

[152] Fix | Delete

* @var array

[153] Fix | Delete

[154] Fix | Delete

public static $phone_suffix = '_phone';

[155] Fix | Delete

[156] Fix | Delete

/**

[157] Fix | Delete

* Class constructor

[158] Fix | Delete

[159] Fix | Delete

* @since 3.27.1

[160] Fix | Delete

[161] Fix | Delete

* @param ET_Builder_Element $module Module object.

[162] Fix | Delete

* @param array $custom_props Defined custom props data.

[163] Fix | Delete

* @param array $conditional_values Defined options conditional values.

[164] Fix | Delete

* @param array $default_values Defined options default values.

[165] Fix | Delete

[166] Fix | Delete

public function __construct( $module = false, $custom_props = array(), $conditional_values = array(), $default_values = array() ) {

[167] Fix | Delete

$this->set_module( $module );

[168] Fix | Delete

$this->set_custom_props( $custom_props );

[169] Fix | Delete

$this->set_conditional_values( $conditional_values );

[170] Fix | Delete

$this->set_default_values( $default_values );

[171] Fix | Delete

}

[172] Fix | Delete

[173] Fix | Delete

/**

[174] Fix | Delete

* Get props name by mode

[175] Fix | Delete

[176] Fix | Delete

* @since 3.27.1

[177] Fix | Delete

[178] Fix | Delete

* @param string $name Props name.

[179] Fix | Delete

* @param string $mode Selected view mode.

[180] Fix | Delete

[181] Fix | Delete

* @return string

[182] Fix | Delete

[183] Fix | Delete

public static function get_name_by_mode( $name, $mode ) {

[184] Fix | Delete

if ( 'tablet' === $mode || 'phone' === $mode ) {

[185] Fix | Delete

return "{$name}_{$mode}";

[186] Fix | Delete

}

[187] Fix | Delete

[188] Fix | Delete

if ( 'hover' === $mode ) {

[189] Fix | Delete

return "{$name}__hover";

[190] Fix | Delete

}

[191] Fix | Delete

[192] Fix | Delete

return $name;

[193] Fix | Delete

}

[194] Fix | Delete

[195] Fix | Delete

/**

[196] Fix | Delete

* Get regex field name suffix

[197] Fix | Delete

[198] Fix | Delete

* @since 4.0.1

[199] Fix | Delete

[200] Fix | Delete

* @return string

[201] Fix | Delete

[202] Fix | Delete

public static function get_regex_suffix() {

[203] Fix | Delete

return '/(__hover|__hover_enabled|_last_edited|_tablet|_phone)$/';

[204] Fix | Delete

}

[205] Fix | Delete

[206] Fix | Delete

/**

[207] Fix | Delete

* Get props name base

[208] Fix | Delete

[209] Fix | Delete

* @since 4.0.1

[210] Fix | Delete

[211] Fix | Delete

* @param string $name Props name.

[212] Fix | Delete

[213] Fix | Delete

* @return string

[214] Fix | Delete

[215] Fix | Delete

public static function get_name_base( $name ) {

[216] Fix | Delete

return preg_replace( self::get_regex_suffix(), '', $name );

[217] Fix | Delete

}

[218] Fix | Delete

[219] Fix | Delete

/**

[220] Fix | Delete

* Get view modes

[221] Fix | Delete

[222] Fix | Delete

* @since 3.27.1

[223] Fix | Delete

[224] Fix | Delete

* @return array

[225] Fix | Delete

[226] Fix | Delete

public static function get_modes() {

[227] Fix | Delete

return array( 'desktop', 'tablet', 'phone', 'hover' );

[228] Fix | Delete

}

[229] Fix | Delete

[230] Fix | Delete

/**

[231] Fix | Delete

* Check if mode is enabled

[232] Fix | Delete

[233] Fix | Delete

* @since 3.27.1

[234] Fix | Delete

[235] Fix | Delete

* @param string $name Props name.

[236] Fix | Delete

* @param string $mode Selected view mode.

[237] Fix | Delete

[238] Fix | Delete

* @return bool

[239] Fix | Delete

[240] Fix | Delete

public function mode_is_enabled( $name, $mode ) {

[241] Fix | Delete

switch ( $mode ) {

[242] Fix | Delete

case 'hover':

[243] Fix | Delete

return $this->hover_is_enabled( $name );

[244] Fix | Delete

[245] Fix | Delete

case 'tablet':

[246] Fix | Delete

case 'phone':

[247] Fix | Delete

return $this->responsive_is_enabled( $name );

[248] Fix | Delete

[249] Fix | Delete

default:

[250] Fix | Delete

return true;

[251] Fix | Delete

}

[252] Fix | Delete

}

[253] Fix | Delete

[254] Fix | Delete

/**

[255] Fix | Delete

* Get responsive options filed suffixes

[256] Fix | Delete

[257] Fix | Delete

* @since 3.27.1

[258] Fix | Delete

[259] Fix | Delete

* @param bool $include_enabled_suffix Whether to include the responsive enabled suffix or not.

[260] Fix | Delete

[261] Fix | Delete

* @return array

[262] Fix | Delete

[263] Fix | Delete

public static function responsive_suffixes( $include_enabled_suffix = true ) {

[264] Fix | Delete

$suffixes = array( self::$tablet_suffix, self::$phone_suffix );

[265] Fix | Delete

[266] Fix | Delete

if ( $include_enabled_suffix ) {

[267] Fix | Delete

$suffixes[] = self::$responsive_enabled_suffix;

[268] Fix | Delete

}

[269] Fix | Delete

[270] Fix | Delete

return $suffixes;

[271] Fix | Delete

}

[272] Fix | Delete

[273] Fix | Delete

/**

[274] Fix | Delete

* Get hover options filed suffixes

[275] Fix | Delete

[276] Fix | Delete

* @since 3.27.1

[277] Fix | Delete

[278] Fix | Delete

* @param bool $include_enabled_suffix Whether to include the hover enabled suffix or not.

[279] Fix | Delete

[280] Fix | Delete

* @return array

[281] Fix | Delete

[282] Fix | Delete

public static function hover_suffixes( $include_enabled_suffix = true ) {

[283] Fix | Delete

$suffixes = array( self::$hover_suffix );

[284] Fix | Delete

[285] Fix | Delete

if ( $include_enabled_suffix ) {

[286] Fix | Delete

$suffixes[] = self::$hover_enabled_suffix;

[287] Fix | Delete

}

[288] Fix | Delete

[289] Fix | Delete

return $suffixes;

[290] Fix | Delete

}

[291] Fix | Delete

[292] Fix | Delete

/**

[293] Fix | Delete

* Check whether an option is responsive enabled.

[294] Fix | Delete

[295] Fix | Delete

* @since 3.27.1

[296] Fix | Delete

[297] Fix | Delete

* @param string $name options name.

[298] Fix | Delete

[299] Fix | Delete

* @return bool

[300] Fix | Delete

[301] Fix | Delete

public function responsive_is_enabled( $name ) {

[302] Fix | Delete

return et_pb_responsive_options()->is_enabled( $name, $this->props );

[303] Fix | Delete

}

[304] Fix | Delete

[305] Fix | Delete

/**

[306] Fix | Delete

* Check whether an option is hover enabled.

[307] Fix | Delete

[308] Fix | Delete

* @since 3.27.1

[309] Fix | Delete

[310] Fix | Delete

* @param string $name options name.

[311] Fix | Delete

[312] Fix | Delete

* @return bool

[313] Fix | Delete

[314] Fix | Delete

public function hover_is_enabled( $name ) {

[315] Fix | Delete

return et_pb_hover_options()->is_enabled( $name, $this->props );

[316] Fix | Delete

}

[317] Fix | Delete

[318] Fix | Delete

/**

[319] Fix | Delete

* Get module props desktop mode value.

[320] Fix | Delete

[321] Fix | Delete

* @since 3.27.1

[322] Fix | Delete

[323] Fix | Delete

* @param string $name Props name.

[324] Fix | Delete

* @param mixed $default_value Default value as fallback data.

[325] Fix | Delete

[326] Fix | Delete

* @return mixed Value of selected mode.

[327] Fix | Delete

[328] Fix | Delete

public function get_value_desktop( $name, $default_value = null ) {

[329] Fix | Delete

return $this->get_value( $name, 'desktop', $default_value );

[330] Fix | Delete

}

[331] Fix | Delete

[332] Fix | Delete

/**

[333] Fix | Delete

* Get module props tablet mode value.

[334] Fix | Delete

[335] Fix | Delete

* @since 3.27.1

[336] Fix | Delete

[337] Fix | Delete

* @param string $name Props name.

[338] Fix | Delete

* @param mixed $default_value Default value as fallback data.

[339] Fix | Delete

[340] Fix | Delete

* @return mixed Value of selected mode.

[341] Fix | Delete

[342] Fix | Delete

public function get_value_tablet( $name, $default_value = null ) {

[343] Fix | Delete

return $this->get_value( $name, 'tablet', $default_value );

[344] Fix | Delete

}

[345] Fix | Delete

[346] Fix | Delete

/**

[347] Fix | Delete

* Get module props phone mode value.

[348] Fix | Delete

[349] Fix | Delete

* @since 3.27.1

[350] Fix | Delete

[351] Fix | Delete

* @param string $name Props name.

[352] Fix | Delete

* @param mixed $default_value Default value as fallback data.

[353] Fix | Delete

[354] Fix | Delete

* @return mixed Value of selected mode.

[355] Fix | Delete

[356] Fix | Delete

public function get_value_phone( $name, $default_value = null ) {

[357] Fix | Delete

return $this->get_value( $name, 'phone', $default_value );

[358] Fix | Delete

}

[359] Fix | Delete

[360] Fix | Delete

/**

[361] Fix | Delete

* Get module props hover mode value.

[362] Fix | Delete

[363] Fix | Delete

* @since 3.27.1

[364] Fix | Delete

[365] Fix | Delete

* @param string $name Props name.

[366] Fix | Delete

* @param mixed $default_value Default value as fallback data.

[367] Fix | Delete

[368] Fix | Delete

* @return mixed Value of selected mode.

[369] Fix | Delete

[370] Fix | Delete

public function get_value_hover( $name, $default_value = null ) {

[371] Fix | Delete

return $this->get_value( $name, 'hover', $default_value );

[372] Fix | Delete

}

[373] Fix | Delete

[374] Fix | Delete

/**

[375] Fix | Delete

* Get module props value.

[376] Fix | Delete

[377] Fix | Delete

* @since 3.27.1

[378] Fix | Delete

[379] Fix | Delete

* @param string $name Props name.

[380] Fix | Delete

* @param string $mode Select only specified modes: desktop, tablet, phone, hover.

[381] Fix | Delete

* @param mixed $default_value Default value as fallback data.

[382] Fix | Delete

[383] Fix | Delete

* @return mixed Value of selected mode.

[384] Fix | Delete

[385] Fix | Delete

public function get_value( $name, $mode = 'desktop', $default_value = null ) {

[386] Fix | Delete

return et_()->array_get( $this->get_values( $name ), $mode, $default_value );

[387] Fix | Delete

}

[388] Fix | Delete

[389] Fix | Delete

/**

[390] Fix | Delete

* Get module props values.

[391] Fix | Delete

[392] Fix | Delete

* @since 3.27.1

[393] Fix | Delete

[394] Fix | Delete

* @param string $name Props name.

[395] Fix | Delete

* @param bool $distinct Wether to distinct the values or not.

[396] Fix | Delete

[397] Fix | Delete

* @return array Values of all view modes: desktop, tablet, phone, hover.

[398] Fix | Delete

[399] Fix | Delete

public function get_values( $name, $distinct = true ) {

[400] Fix | Delete

if ( ! isset( $this->cached_values[ $name ] ) ) {

[401] Fix | Delete

$values = array();

[402] Fix | Delete

[403] Fix | Delete

if ( isset( $this->custom_props[ $name ] ) ) {

[404] Fix | Delete

foreach ( self::get_modes() as $mode ) {

[405] Fix | Delete

$value = et_()->array_get( $this->custom_props[ $name ], $mode, '' );

[406] Fix | Delete

[407] Fix | Delete

if ( '' === $value && isset( $this->default_values[ $name ][ $mode ] ) ) {

[408] Fix | Delete

$value = $this->default_values[ $name ][ $mode ];

[409] Fix | Delete

}

[410] Fix | Delete

[411] Fix | Delete

if ( ! $this->is_props_inherited( self::get_name_by_mode( $name, $mode ), $value ) ) {

[412] Fix | Delete

$values[ $mode ] = $value;

[413] Fix | Delete

}

[414] Fix | Delete

}

[415] Fix | Delete

} else {

[416] Fix | Delete

foreach ( self::get_modes() as $mode ) {

[417] Fix | Delete

if ( ! $this->mode_is_enabled( $name, $mode ) ) {

[418] Fix | Delete

continue;

[419] Fix | Delete

}

[420] Fix | Delete

[421] Fix | Delete

$value = et_()->array_get( $this->props, self::get_name_by_mode( $name, $mode ), '' );

[422] Fix | Delete

[423] Fix | Delete

if ( '' === $value && isset( $this->default_values[ $name ][ $mode ] ) ) {

[424] Fix | Delete

$value = $this->default_values[ $name ][ $mode ];

[425] Fix | Delete

}

[426] Fix | Delete

[427] Fix | Delete

if ( ! $this->is_props_inherited( self::get_name_by_mode( $name, $mode ), $value ) ) {

[428] Fix | Delete

$values[ $mode ] = $value;

[429] Fix | Delete

}

[430] Fix | Delete

}

[431] Fix | Delete

}

[432] Fix | Delete

[433] Fix | Delete

// Normalize the values to make to all the view modes has own data.

[434] Fix | Delete

$this->cached_values[ $name ] = $this->normalize_values( $values );

[435] Fix | Delete

}

[436] Fix | Delete

[437] Fix | Delete

// Distinct the values to omit duplicate values across modes.

[438] Fix | Delete

if ( $distinct ) {

[439] Fix | Delete

return $this->distinct_values( $this->cached_values[ $name ] );

[440] Fix | Delete

}

[441] Fix | Delete

[442] Fix | Delete

return $this->cached_values[ $name ];

[443] Fix | Delete

}

[444] Fix | Delete

[445] Fix | Delete

/**

[446] Fix | Delete

* Compare values

[447] Fix | Delete

[448] Fix | Delete

* @since 3.27.1

[449] Fix | Delete

[450] Fix | Delete

* @param string $value Source value.

[451] Fix | Delete

* @param [type] $value_compare Target value to compare.

[452] Fix | Delete

[453] Fix | Delete

* @return bool

[454] Fix | Delete

[455] Fix | Delete

protected static function compare_value( $value, $value_compare = null ) {

[456] Fix | Delete

$match = false;

[457] Fix | Delete

[458] Fix | Delete

if ( is_null( $value_compare ) ) {

[459] Fix | Delete

$match = is_string( $value ) || is_numeric( $value ) ? strlen( $value ) : ! empty( $value );

[460] Fix | Delete

} elseif ( is_bool( $value_compare ) ) {

[461] Fix | Delete

$match = $value_compare === $value;

[462] Fix | Delete

} elseif ( is_array( $value_compare ) ) {

[463] Fix | Delete

$match = in_array( $value, $value_compare, true );

[464] Fix | Delete

} elseif ( '__empty' === $value_compare ) {

[465] Fix | Delete

$match = empty( $value );

[466] Fix | Delete

} elseif ( '__not_empty' === $value_compare ) {

[467] Fix | Delete

$match = ! empty( $value );

[468] Fix | Delete

} else {

[469] Fix | Delete

$match = strtolower( strval( $value_compare ) ) === strtolower( strval( $value ) );

[470] Fix | Delete

}

[471] Fix | Delete

[472] Fix | Delete

return $match ? true : false;

[473] Fix | Delete

}

[474] Fix | Delete

[475] Fix | Delete

/**

[476] Fix | Delete

* Check if module props has value in any of data breakpoint: desktop, tablet, phone, hover.

[477] Fix | Delete

[478] Fix | Delete

* @since 3.27.1

[479] Fix | Delete

[480] Fix | Delete

* @param string $name Field key.

[481] Fix | Delete

* @param string|callable $value_compare The value to compare.

[482] Fix | Delete

* @param string $selected_mode Selected view mode.

[483] Fix | Delete

* @param bool $inherit Should the value inherited from previous breakpoint.

[484] Fix | Delete

[485] Fix | Delete

* @return bool

[486] Fix | Delete

[487] Fix | Delete

public function has_value( $name, $value_compare = null, $selected_mode = false, $inherit = false ) {

[488] Fix | Delete

$has_value = false;

[489] Fix | Delete

[490] Fix | Delete

if ( $selected_mode && is_string( $selected_mode ) ) {

[491] Fix | Delete

$selected_mode = false !== strpos( $selected_mode, ',' ) ? explode( ',', $selected_mode ) : array( $selected_mode );

[492] Fix | Delete

}

[493] Fix | Delete

[494] Fix | Delete

if ( $selected_mode && ! is_array( $selected_mode ) ) {

[495] Fix | Delete

$selected_mode = array( $selected_mode );

[496] Fix | Delete

}

[497] Fix | Delete

[498] Fix | Delete

$values = $this->get_values( $name, false );

[499] Fix | Delete

12 3 4 5