array_get( $list, $key, $default ); } /** * Returns `__hover` * * @return string */ public function get_suffix() { return '__hover'; } /** * Return `__hover_enabled` * * @return string */ public function get_enabled_suffix() { return '__hover_enabled'; } /** * Returns the field original name by removing the `__hover` or `__hover_enabled` suffix if it exists. * * @param string $name * * @return string */ public function get_field_base_name( $name ) { // Do not use rtim as it removes by character not by string // So cases like `key__hoveree` will be reduced to `key` $regex = "/(.*)({$this->get_suffix()}|{$this->get_enabled_suffix()})$/"; $replace = '${1}'; return preg_replace( $regex, $replace, $name ); } /** * Check if the setting has enabled hover options * * @param string $setting * @param array $attrs * * @return bool */ public function is_enabled( $setting, $attrs ) { $name = $setting === 'background_color' ? 'background' : $setting; return 'on' == $this->util_get( $this->get_hover_enabled_field( $name ), $attrs ); } /** * Returns the hover setting field name * E.g.: get_hover_enabled_field('test') => 'test__hover' * * @param string $setting * * @return string */ public function get_hover_field( $setting ) { return "{$this->get_field_base_name($setting)}{$this->get_suffix()}"; } /** * Returns the hover enabled setting field name * E.g.: get_hover_enabled_field('test') => 'test__hover_enabled' * * @param string $setting * * @return string */ public function get_hover_enabled_field( $setting ) { return "{$this->get_field_base_name($setting)}{$this->get_enabled_suffix()}"; } /** * Returns setting hover value if hover is enabled; * If it does not exist, return $default specified value * * @param string $setting * @param array $attrs * @param mixed $default * * @return mixed */ public function get_value( $setting, $attrs, $default = null ) { return $this->is_enabled( $setting, $attrs ) ? $this->get_raw_value( $setting, $attrs, $default ) : $default; } /** * Returns setting hover value if hover is enabled for a compose option; * If it does not exist, return $default specified value * * @param string $setting * @param string $option * @param array $attrs * @param mixed $default * * @return mixed */ public function get_compose_value( $setting, $option, $attrs, $default = null ) { return $this->is_enabled( $option, $attrs ) ? $this->get_raw_value( $setting, $attrs, $default ) : $default; } /** * Returns setting hover value; * If it does not exist, return $default specified value * * @param string $setting * @param array $attrs * @param mixed $default * * @return mixed */ public function get_raw_value( $setting, $attrs, $default = null ) { return $this->util_get( $this->get_hover_field( $setting ), $attrs, $default ); } /** * Adds `:hover` in selector at the end of the selector * E.g: add_hover_to_selectors('%%order_class%%% .image') >>> '%%order_class%%% .image:hover' * * @param string $selector * * @return string */ public function add_hover_to_selectors( $selector ) { $selectors = explode( ',', $selector ); $selectors = array_map( 'trim', $selectors ); // Add hover to the end of the selector, but prevent specific situations like this: // .my-class:after => .my-class:after:hover, should be .my-class:hover:after $selectors = preg_replace( '/(.+\s)*([^\::?]+)((::?[a-z|-|\(|\)|\[|\]]+)+)?$/i', '$1$2:hover$3', $selectors ); return implode( ', ', $selectors ); } /** * Adds `:hover` in selector after `%%order_class%%` * E.g: add_hover_to_order_class('%%order_class%%% .image') >>> '%%order_class%%%:hover .image' * * @param string $selector * * @return string */ public function add_hover_to_order_class( $selector ) { $selectors = explode( ',', $selector ); $selectors = array_map( 'trim', $selectors ); // Add hover to the end of the selector, but prevent specific situations like this: // .my-class:after => .my-class:after:hover, should be .my-class:hover:after $selectors = preg_replace( '/(.*%%order_class%%[^\s|^:]*)(.*)/i', '$1:hover$2', $selectors ); return implode( ', ', $selectors ); } } function et_pb_hover_options() { return ET_Builder_Module_Hover_Options::get(); }