*/ protected $attrs_unprocessed = array(); /** * Unprocessed content. * * @since 3.17.2 * * @var string */ protected $content_unprocessed = ''; /** * Settings used to render the module's output. * * @since 3.1 Renamed from `$shortcode_atts` to `$props`. * @since 1.0 * * @var array */ public $props = array(); /** * What appears inside the element. For structure elements, this will contain children * elements. For parent modules, this will include child modules. * * @since 3.1 Renamed from `$shortcode_content` to `$content`. * @since 1.0 * * @var string */ public $content; /** * Configuration for module's wrapper and inner wrapper * * @since 3.1 * * @var array */ public $wrapper_settings = array(); public $fields_unprocessed = array(); public $main_css_element; public $custom_css_fields = array(); public $child_title_var; public $child_title_fallback_var; public $post_types = array(); public $main_tabs = array(); public $used_tabs = array(); public $custom_css_tab; public $vb_support = 'off'; public $dbl_quote_exception_options = array( 'et_pb_font_icon', 'et_pb_button_one_icon', 'et_pb_button_two_icon', 'et_pb_button_icon', 'et_pb_content' ); public $settings_modal_tabs = array(); public $settings_modal_toggles = array(); public $featured_image_background = false; public $classname = array(); public $help_videos = array(); public static $settings_migrations_initialized = false; public static $setting_advanced_styles = false; public static $uses_module_classname = array(); private static $_current_section_index = -1; private static $_current_row_index = -1; private static $_current_row_inner_index = -1; private static $_current_column_index = -1; private static $_current_column_inner_index = -1; private static $_current_module_index = -1; private static $_current_module_item_index = -1; private static $_unique_bb_keys_map = array(); private static $_unique_bb_keys_values = array(); private static $_unique_bb_strip = array( "\t", "\r", "\n" ); /** * Number of times {@see self::render()} has been executed. * * @var int */ private $_render_count; /** * Number of times {@see self::render()} has been executed for the shop module. * * @var int */ private static $_shop_render_count = 0; /** * Slug of a module whose render count should also be bumped when this module's is bumped. * * @var string */ protected $_bumps_render_count; /** * Priority number applied to some CSS rules. * * @var int */ protected $_style_priority; // only needed for BB + hover protected $is_background = false; private $_is_official_module; /** * Holds module styles for the current request. * * @var array */ private static $styles = array(); private static $internal_modules_styles = array(); private static $prepare_internal_styles = false; private static $internal_modules_counter = 10000; private static $media_queries = array(); private static $modules_order; private static $inner_modules_order; private static $modules = array(); private static $parent_modules = array(); private static $child_modules = array(); private static $current_module_index = 0; private static $structure_modules = array(); private static $structure_module_slugs = array(); private static $_module_slugs_by_post_type = array(); private static $module_icons = array(); private static $module_help_videos = array(); private static $loading_backbone_templates = false; /** * @var ET_Core_Data_Utils */ protected static $_ = null; /** * @var ET_Core_PageResource */ public static $advanced_styles_manager = null; /** * @var ET_Core_Data_Utils */ public static $data_utils = null; public static $field_dependencies = array(); public static $can_reset_element_indexes = true; const DEFAULT_PRIORITY = 10; const HIDE_ON_MOBILE = 'et-hide-mobile'; protected $module_credits; function __construct() { self::$current_module_index++; if ( ! self::$_deprecations ) { self::$_deprecations = require ET_BUILDER_DIR . 'deprecations.php'; self::$_deprecations = self::$_deprecations['classes']['\ET_Builder_Module_Blurb']; } if ( ! self::$settings_migrations_initialized ) { self::$settings_migrations_initialized = true; require_once 'module/settings/Migration.php'; ET_Builder_Module_Settings_Migration::init(); add_filter( 'the_content', array( get_class( $this ), 'reset_element_indexes' ), 9999 ); } if ( self::$loading_backbone_templates || et_admin_backbone_templates_being_loaded() ) { if ( ! self::$loading_backbone_templates ) { self::$loading_backbone_templates = true; } $start_from = (int) sanitize_text_field( $_POST['et_templates_start_from'] ); $post_type = sanitize_text_field( $_POST['et_post_type'] ); if ( 'layout' === $post_type ) { // need - 2 to include the et_pb_section and et_pb_row modules $start_from = ET_Builder_Element::get_modules_count( 'page' ) - 2; } $current_module_index = self::$current_module_index - 1; if ( ! ( $current_module_index >= $start_from && $current_module_index < ( ET_BUILDER_AJAX_TEMPLATES_AMOUNT + $start_from ) ) ) { return; } } if ( null === self::$advanced_styles_manager && ! is_admin() && ! et_fb_is_enabled() ) { self::_setup_advanced_styles_manager(); } if ( null === self::$data_utils ) { self::$_ = self::$data_utils = ET_Core_Data_Utils::instance(); } $this->init(); $this->settings_modal_tabs = $this->get_settings_modal_tabs(); $this->settings_modal_toggles = $this->get_settings_modal_toggles(); $this->custom_css_fields = $this->get_custom_css_fields_config(); $this->_set_advanced_fields_config(); $this->_is_official_module = self::_is_official_module( get_class( $this ) ); $this->make_options_filterable(); $this->set_fields(); $this->set_factory_objects(); $this->_additional_fields_options = array(); $this->_add_additional_fields(); $this->_add_custom_css_fields(); $this->_maybe_add_global_defaults(); $this->_finalize_all_fields(); if ( ! isset( $this->main_css_element ) ) { $this->main_css_element = '%%order_class%%'; } $this->_render_count = 0; $this->type = isset( $this->type ) ? $this->type : ''; $this->_style_priority = (int) self::DEFAULT_PRIORITY; if ( isset( $this->type ) && 'child' === $this->type ) { $this->_style_priority = $this->_style_priority + 1; } else { // add default toggles $default_general_toggles = array( 'admin_label' => array( 'title' => esc_html__( 'Admin Label', 'et_builder' ), 'priority' => 99, ), ); $default_advanced_toggles = array( 'visibility' => array( 'title' => esc_html__( 'Visibility', 'et_builder' ), 'priority' => 99, ), ); $this->_add_settings_modal_toggles( 'general', $default_general_toggles ); $this->_add_settings_modal_toggles( 'custom_css', $default_advanced_toggles ); } $this->main_tabs = $this->get_main_tabs(); $this->custom_css_tab = isset( $this->custom_css_tab ) ? $this->custom_css_tab : true; self::$modules[ $this->slug ] = $this; $post_types = ! empty( $this->post_types ) ? $this->post_types : et_builder_get_builder_post_types(); // all modules should be assigned for et_pb_layout post type to work in the library if ( ! in_array( 'et_pb_layout', $post_types ) ) { $post_types[] = 'et_pb_layout'; } $this->post_types = apply_filters( 'et_builder_module_post_types', $post_types, $this->slug, $this->post_types ); foreach ( $this->post_types as $post_type ) { if ( ! in_array( $post_type, $this->post_types ) ) { $this->register_post_type( $post_type ); } if ( ! isset( self::$_module_slugs_by_post_type[ $post_type ] ) ) { self::$_module_slugs_by_post_type[ $post_type ] = array(); } if ( ! in_array( $this->slug, self::$_module_slugs_by_post_type[ $post_type ] ) ) { self::$_module_slugs_by_post_type[ $post_type ][] = $this->slug; } if ( isset( $this->additional_shortcode ) && ! in_array( $this->additional_shortcode, self::$_module_slugs_by_post_type[ $post_type ] ) ) { self::$_module_slugs_by_post_type[ $post_type ][] = $this->additional_shortcode; } if ( isset( $this->additional_shortcode_slugs ) ) { foreach ( $this->additional_shortcode_slugs as $additional_shortcode_slug ) { if ( ! in_array( $additional_shortcode_slug, self::$_module_slugs_by_post_type[ $post_type ] ) ) { self::$_module_slugs_by_post_type[ $post_type ][] = $additional_shortcode_slug; } } } if ( 'child' === $this->type ) { self::$child_modules[ $post_type ][ $this->slug ] = $this; } else { self::$parent_modules[ $post_type ][ $this->slug ] = $this; } } if ( ! isset( $this->no_render ) ) { $shortcode_slugs = array( $this->slug ); if ( ! empty( $this->additional_shortcode_slugs ) ) { $shortcode_slugs = array_merge( $shortcode_slugs, $this->additional_shortcode_slugs ); } foreach ( $shortcode_slugs as $shortcode_slug ) { add_shortcode( $shortcode_slug, array( $this, '_render' ) ); } if ( isset( $this->additional_shortcode ) ) { add_shortcode( $this->additional_shortcode, array( $this, 'additional_render' ) ); } } if ( isset( $this->icon ) ) { self::$_->array_set( self::$module_icons, "{$this->slug}.icon", $this->icon ); } if ( isset( $this->icon_path ) ) { self::$_->array_set( self::$module_icons, "{$this->slug}.icon_path", $this->icon_path ); } // Push module's help videos to all help videos array if there's any if ( ! empty( $this->help_videos ) ) { // Automatically add design tab and library tutorial. DRY if ( 'et_pb_column' !== $this->slug ) { // Adding next tabs (design & tab) helps $next_tabs_help = array( 'id' => esc_html__( '1iqjhnHVA9Y', 'et_builder' ), 'name' => esc_html__( 'Design Settings and Advanced Module Settings', 'et_builder' ), ); // Adjust row name if ( in_array( $this->slug, array( 'et_pb_row', 'et_pb_row_inner' ) ) ) { $next_tabs_help['name'] = esc_html__( 'Design Settings and Advanced Row Settings', 'et_builder' ); } // Adjust section name if ( 'et_pb_section' === $this->slug ) { $next_tabs_help['name'] = esc_html__( 'Design Settings and Advanced Section Settings', 'et_builder' ); } $this->help_videos[] = $next_tabs_help; // Adding Divi Library helps $this->help_videos[] = array( 'id' => esc_html( 'boNZZ0MYU0E' ), 'name' => esc_html__( 'Saving and loading from the library', 'et_builder' ), ); } self::$module_help_videos[ $this->slug ] = $this->help_videos; } } public function __call( $name, $args ) { $class = get_class( $this ); $message = "You're Doing It Wrong!"; $is_deprecated = array_key_exists( $name, self::$_deprecations['methods'] ); $value = null; $old_method_exists = method_exists( $this, $name ); if ( $old_method_exists && ! $is_deprecated ) { // Inaccessible method (protected or private) that isn't deprecated et_debug( "{$message} Attempted to call {$class}::{$name}() from out of scope.", 4, false ); return $value; } $message .= " {$class}::{$name}()"; if ( ! $is_deprecated ) { $message .= " doesn't exist."; } else { $message .= " is deprecated."; $new_method = self::$_deprecations['methods'][ $name ]; if ( ! is_string( $new_method ) ) { // Default value for a method that has no replacement. $value = $new_method; } else if ( method_exists( $this, $new_method ) && ! $old_method_exists ) { $message .= " Use {$class}::{$new_method}() instead."; $value = call_user_func_array( array( $this, $new_method ), $args ); } else if ( $old_method_exists ) { // Ensure that our current caller is not the same as the method we're about to call. // as that would cause an infinite recursion situation. It happens when a child class // method which has been deprecated calls itself on the parent class (using parent::) $trace = debug_backtrace(); $callers = array( self::$_->array_get( $trace, '1.function' ), self::$_->array_get( $trace, '2.function' ), ); if ( ! in_array( $name, $callers ) ) { // We've used $this->__call() to call a deprecated method from its replacement // method so that a deprecation notice will be output. $message .= " Use {$class}::{$new_method}() instead."; $value = call_user_func_array( array( $this, $name ), $args ); } } } et_debug( $message, 4, false ); return $value; } public function &__get( $name ) { $class = get_class( $this ); $message = "You're Doing It Wrong!"; $is_deprecated = array_key_exists( $name, self::$_deprecations['properties'] ); $value = null; if ( property_exists( $this, $name ) && ! $is_deprecated ) { // Inaccessible property (protected or private) that isn't deprecated et_debug( "{$message} Attempted to access {$class}::\${$name} from out of scope.", 4, false ); return $value; } $message .= " {$class}::\${$name}"; if ( ! $is_deprecated ) { $message .= " doesn't exist."; $should_set_value = true; } else { $message .= " is deprecated."; $new_prop = self::$_deprecations['properties'][ $name ]; if ( $new_prop && is_string( $new_prop ) && property_exists( $this, $new_prop ) ) { $message .= " Use {$class}::\${$new_prop} instead."; $value = &$this->$new_prop; } else if ( ! is_string( $new_prop ) || ! $new_prop ) { // Default value $value = $new_prop; $should_set_value = true; } } if ( isset( $should_set_value ) ) { // Create the property so we can return a reference to it which allows it to be // used like this: $this->name[] = 'something' $this->$name = $value; $value = &$this->$name; } et_debug( $message, 4, false ); return $value; } public function __isset( $name ) { $prop_name = array_key_exists( $name, self::$_deprecations['properties'] ) ? self::$_deprecations['properties'][ $name ] : $name; if ( ! $prop_name || ! is_string( $prop_name ) ) { return false; } return property_exists( $this, $prop_name ); } public function __set( $name, $value ) { $class = get_class( $this ); $message = "You're Doing It Wrong!"; $is_deprecated = array_key_exists( $name, self::$_deprecations['properties'] ); $property_exists = property_exists( $this, $name ); $has_replacement = $property_exists && is_string( self::$_deprecations['properties'][ $name ] ) && self::$_deprecations['properties'][ $name ]; if ( $property_exists && ! $is_deprecated ) { // Inaccessible property (protected or private) that isn't deprecated et_debug( "{$message} Attempted to access {$class}::\${$name} from out of scope.", 4, false ); return; } if ( ( ! $property_exists && ! $is_deprecated ) || ! $has_replacement ) { // Always allow setting values for properties that are undeclared $this->$name = $value; } if ( ! $is_deprecated ) { return; } $message = " {$class}::\${$name} is deprecated."; $replacement = self::$_deprecations['properties'][ $name ]; if ( $replacement && is_string( $replacement ) ) { $message .= " Use {$class}::\${$replacement} instead."; $this->$replacement = $value; // Unset deprecated property so next time it's updated we process it again unset( $this->$name ); } et_debug( $message, 4, false ); } private static function _is_official_module( $class_name ) { try { $reflection = new ReflectionClass( $class_name ); $is_official = self::$_->includes( $reflection->getFileName(), ET_BUILDER_DIR_RESOLVED_PATH ); } catch( Exception $err ) { $is_official = false; } return $is_official; } protected function _set_advanced_fields_config() { $this->advanced_fields = $this->get_advanced_fields_config(); // 3rd-Party Backwards Compatability if ( isset( $this->advanced_fields['custom_margin_padding'] ) ) { $this->advanced_fields['margin_padding'] = $this->advanced_fields['custom_margin_padding']; unset( $this->advanced_fields['custom_margin_padding'] ); } } /** * Retrieve Post ID from 1 of 3 sources depending on which exists: * - $_POST['et_post_id'] * - $_GET['post'] * - get_the_ID() * Similar to get_the_ID() but in reverse order and statically callable. * * @since 3.17.2 * * @return int|bool */ public static function get_current_post_id() { if ( wp_doing_ajax() && isset( $_POST['et_post_id'] ) ) { return absint( $_POST['et_post_id'] ); } if ( isset( $_POST['post'] ) ) { return absint( $_POST['post'] ); } return get_the_ID(); } /** * Get the current ID depending on the current request. * * @return int|bool */ public function get_the_ID() { $post_id = get_the_ID(); // try to get post id from get_post_ID() if ( false !== $post_id ) { return $post_id; } if ( wp_doing_ajax() ) { // get the post ID if loading data for VB return isset( $_POST['et_post_id'] ) ? absint( $_POST['et_post_id'] ) : false; // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification } // fallback to $_GET['post'] to cover the BB data loading return isset( $_GET['post'] ) ? absint( $_GET['post'] ) : false; // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification } /** * Setup the advanced styles manager * * {@internal * Before the styles manager was implemented, the advanced styles were output inline in the footer. * That resulted in them being the last styles parsed by the browser, thus giving them higher * priority than other styles on the page. With the styles manager, the advanced styles are * enqueued at the very end of the . This is for backwards compatibility (to maintain * the same priority for the styles as before).}} */ private static function _setup_advanced_styles_manager() { if ( et_core_page_resource_is_singular() ) { $post_id = et_core_page_resource_get_the_ID(); } else { $post_id = 0; // It doesn't matter because we're going to force inline styles. } $is_preview = is_preview() || is_et_pb_preview(); $forced_in_footer = $post_id && et_builder_setting_is_on( 'et_pb_css_in_footer', $post_id ); $forced_inline = ! $post_id || $is_preview || $forced_in_footer || et_builder_setting_is_off( 'et_pb_static_css_file', $post_id ); $unified_styles = ! $forced_inline && ! $forced_in_footer; $resource_owner = $unified_styles ? 'core' : 'builder'; $resource_slug = $unified_styles ? 'unified' : 'module-design'; $resource_slug .= $unified_styles && et_builder_post_is_of_custom_post_type( $post_id ) ? '-cpt' : ''; // If the post is password protected and a password has not been provided yet, // no content (including any custom style) will be printed. // When static css file option is enabled this will result in missing styles. if ( ! $forced_inline && post_password_required() ) { $forced_inline = true; } if ( $is_preview ) { // Don't let previews cause existing saved static css files to be modified. $resource_slug .= '-preview'; } self::$advanced_styles_manager = et_core_page_resource_get( $resource_owner, $resource_slug, $post_id, 40 ); if ( ! $forced_inline && ! $forced_in_footer && self::$advanced_styles_manager->has_file() ) { // This post currently has a fully configured styles manager. return; } self::$advanced_styles_manager->forced_inline = $forced_inline; self::$advanced_styles_manager->write_file_location = 'footer'; if ( $forced_in_footer || $forced_inline ) { // Restore legacy behavior--output inline styles in the footer. self::$advanced_styles_manager->set_output_location( 'footer' ); } // Schedule callback to run in the footer so we can pass the module design styles to the page resource. add_action( 'wp_footer', array( 'ET_Builder_Element', 'set_advanced_styles' ), 19 ); // Add filter for the resource data so we can prevent theme customizer css from being // included with the builder css inline on first-load (since its in the head already). add_filter( 'et_core_page_resource_get_data', array( 'ET_Builder_Element', 'filter_page_resource_data' ), 10, 3 ); } /** * Passes the module design styles for the current page to the advanced styles manager. * {@see 'wp_footer' (19) Must run before the style manager's footer callback} */ public static function set_advanced_styles() { $styles = self::get_style() . self::get_style( true ); if ( et_core_is_builder_used_on_current_request() ) { $styles .= et_pb_get_page_custom_css(); } if ( ! $styles ) { return; } // Pass styles to page resource which will handle their output self::$advanced_styles_manager->set_data( $styles, 40 ); } /** * Filters the unified page resource data. The data is an array of arrays of strings keyed by * priority. The builder's styles are set with a priority of 40. Here we want to make sure * only the builder's styles are output in the footer on first-page load so we aren't * duplicating the customizer and custom css styles which are already in the . * {@see 'et_core_page_resource_get_data'} */ public static function filter_page_resource_data( $data, $context, $resource ) { global $wp_current_filter; if ( 'inline' !== $context || ! in_array( 'wp_footer', $wp_current_filter ) ) { return $data; } if ( false === strpos( $resource->slug, 'unified' ) ) { return $data; } if ( 'footer' !== $resource->location ) { // This is the first load of a page that doesn't currently have a unified static css file. // The theme customizer and custom css have already been inlined in the using the // unified resource's ID. It's invalid HTML to have duplicated IDs on the page so we'll // fix that here since it only applies to this page load anyway. $resource->slug = $resource->slug . '-2'; } return isset( $data[40] ) ? array( 40 => $data[40] ) : array(); } /** * Get the slugs for all current builder modules. * * @since 3.0.85 * * @param string $post_type Get module slugs for this post type. If falsy, all slugs are returned. * * @return array */ public static function get_module_slugs_by_post_type( $post_type = 'post' ) { if ( $post_type ) { if ( ! isset( self::$_module_slugs_by_post_type[ $post_type ] ) ) { // We get all modules when post type is not enabled so that posts that have // had their post type support disabled still load all necessary modules. return array_keys( self::get_modules() ); } return self::$_module_slugs_by_post_type[ $post_type ]; } return self::$_module_slugs_by_post_type; } /** * Get whether the module has Visual Builder support or not * * @since 3.1 * * @return bool */ function has_vb_support() { return 'off' !== $this->vb_support; } /** * Create Factory objects * * @return void */ function set_factory_objects() { // Load features fields. $this->text_shadow = ET_Builder_Module_Fields_Factory::get( 'TextShadow' ); } /** * Populates {@see self::$fields_unprocessed}. */ function set_fields() { $this->fields_unprocessed = $this->get_complete_fields(); // Add _builder_version field to all modules $this->fields_unprocessed['_builder_version'] = array( 'type' => 'skip' ); // Add _dynamic_attributes field to all modules. $this->fields_unprocessed['_dynamic_attributes'] = array( 'type' => 'skip' ); if ( $this->_is_official_module ) { return; } // 3rd-Party module backwards compatability starts here foreach ( $this->fields_unprocessed as $field => $info ) { if ( isset( $info['depends_to'] ) ) { $this->fields_unprocessed[ $field ]['depends_on'] = $info['depends_to']; } if ( isset( $info['depends_default'] ) && $info['depends_default'] && ! isset( $info['depends_show_if'] ) ) { $this->fields_unprocessed[ $field ]['depends_show_if'] = 'on'; $message = "You're Doing It Wrong! Setting definition for {$field} includes deprecated parameter: 'depends_default'. Use 'show_if' instead."; et_debug( $message ); } // Process renderer of string type only. if ( isset( $info['renderer'] ) && is_string( $info['renderer'] ) ) { $original_renderer = $info['renderer']; $updated_field_type = $info['renderer']; // convert renderer into type switch ( $info['renderer'] ) { case 'et_builder_include_categories_option' : case 'et_builder_include_categories_shop_option' : $updated_field_type = 'categories'; break; case 'et_builder_get_widget_areas' : $updated_field_type = 'select_sidebar'; break; case 'et_pb_get_font_icon_list' : case 'et_pb_get_font_down_icon_list' : $updated_field_type = 'select_icon'; break; case 'et_builder_get_gallery_settings' : $updated_field_type = 'upload_gallery'; break; case 'et_builder_generate_center_map_setting' : $updated_field_type = 'center_map'; break; } $this->fields_unprocessed[ $field ]['type'] = $updated_field_type; if ( 'et_pb_get_font_down_icon_list' === $info['renderer'] ) { $this->fields_unprocessed[ $field ]['renderer_options'] = array( 'icons_list' => 'icon_down', ); } // Output developer warning if renderer was converted to type if ( $original_renderer !== $updated_field_type ) { $message = "You're Doing It Wrong! Module setting definition for {$field} has a deprecated value: "; $message .= "'{$original_renderer}' for parameter 'renderer'. Use '{$updated_field_type}' instead."; et_debug( $message ); } } // Normalize `affects` field names if needed. if ( isset( $info['affects'] ) ) { $affects_original = $this->fields_unprocessed[ $field ]['affects']; $this->fields_unprocessed[ $field ]['affects'] = array(); // BB supports comma separated list of affected fields, convert it to array of fields if this is the case. // Some plugins use combination of various lists, handle all of them foreach( $affects_original as $affect_item ) { if ( strpos( $affect_item, ',' ) !== false ) { $this->fields_unprocessed[ $field ]['affects'] = array_merge( $this->fields_unprocessed[ $field ]['affects'], explode( ',', str_replace( ' ', '', $affect_item ) ) ); } else { $this->fields_unprocessed[ $field ]['affects'][] = $affect_item; } } array_walk( $this->fields_unprocessed[ $field ]['affects'], array( $this, 'normalize_affect_fields' ) ); } if ( 'content_new' === $field ) { $this->fields_unprocessed['content'] = $this->fields_unprocessed['content_new']; unset( $this->fields_unprocessed['content_new'] ); $message = "You're Doing It Wrong! Setting definition for {$field} includes deprecated parameter: 'content_new'. Use 'content' instead."; et_debug( $message ); } // convert old color pickers to the new ones supporting alpha channel if ( 'color' === self::$_->array_get( $info, 'type' ) ) { $info['type'] = 'color-alpha'; $this->fields_unprocessed[ $field ] = $info; $message = "You're Doing It Wrong! You're using wrong type for the '" . $field . "'. It should be 'color-alpha' instead of 'color'."; et_debug( $message, 4, false ); } // convert input type to text if ( 'input' === self::$_->array_get( $info, 'type' ) ) { $info['type'] = 'text'; $this->fields_unprocessed[ $field ] = $info; $message = "You're Doing It Wrong! Setting definition for {$field} has a deprecated value: 'input' for parameter: 'type'. Use 'text' instead."; et_debug( $message ); } // Normalize default values if ( isset( $info['default'] ) ) { $this->fields_unprocessed[ $field ]['default'] = $this->_normalize_field_default( $field, $info['default'] ); } } // Set default values in field definitions based on the legacy defaults "rules" if ( isset( $this->fields_defaults ) ) { foreach ( $this->fields_defaults as $field => $value ) { if ( ! isset( $this->fields_unprocessed[ $field ] ) ) { continue; } $condition = is_array( $value ) ? self::$_->array_get( $value, '1' ) : false; $set_default_on_front = 'only_default_setting' !== $condition; $default = $this->_normalize_field_default( $field, $value ); // Always set default value if exists. Only default_on_front should be conditional $this->fields_unprocessed[ $field ]['default'] = $default; if ( ! $set_default_on_front ) { continue; } $has_default = isset( $this->fields_unprocessed[ $field ]['default'] ); if ( ! $has_default || $this->fields_unprocessed[ $field ]['default'] !== $default ) { $this->fields_unprocessed[ $field ]['default_on_front'] = $default; } } } // Legacy Defaults Rule #4 (AKA: longest-running undetected bug in the codebase): // Fields listed in whitelisted_fields that aren't in fields_defaults lose their definitions if ( isset( $this->whitelisted_fields ) ) { $disable_whitelisted_fields = isset( $this->force_unwhitelisted_fields ) && $this->force_unwhitelisted_fields; if ( ! $disable_whitelisted_fields && ! is_admin() && ! et_fb_is_enabled() ) { foreach ( $this->whitelisted_fields as $field ) { if ( isset( $this->fields_defaults ) && array_key_exists( $field, $this->fields_defaults ) ) { continue; } $this->fields_unprocessed[ $field ] = array(); } } } } protected function _normalize_field_default( $field, $default_value) { $normalized_value = is_array( $default_value ) ? $default_value[0] : $default_value; // normalize default value depends on field type switch ( $this->fields_unprocessed[ $field ]['type'] ) { case 'yes_no_button': if ( is_numeric( $normalized_value ) ) { $normalized_value = (bool) $normalized_value ? 'on' : 'off'; $message = "You're Doing It Wrong! You're using wrong value for '{$field}' default value. It should be either 'on' or 'off'."; et_debug( $message, 4 , false ); } break; case 'color-alpha': if ( is_numeric( $normalized_value ) ) { $normalized_value = ''; $message = "You're Doing It Wrong! You're using wrong value for '{$field}' default value. It should be string value."; et_debug( $message, 4 , false ); } // Make sure provided HEX code is a valid color code if ( strpos( $normalized_value, '#' ) === 0 && ! in_array( strlen( $normalized_value ), array( 4, 7 ) ) ) { $normalized_value = ''; $message = "You're Doing It Wrong! You're using wrong value for '{$field}' default value. It should be valid hex color code."; et_debug( $message, 4 , false ); } break; } return $normalized_value; } /** * Normalize `affects` fields name if needed. * Some 3rd party modules use `#et_pb_` format which is wrong and doesn't work in VB, but works in BB. * Convert it to correct format and output notice for developer * * @return void */ function normalize_affect_fields( &$field_name ) { if ( strpos( $field_name, '#et_pb_' ) !== false ) { // Truncate field name from the string wherever it's placed $new_field_name = substr( $field_name, strpos( $field_name, '#et_pb_' ) + 7 ); $message = "You're Doing It Wrong! You're using wrong name for 'affects' attribute. It should be '" . $new_field_name . "' instead of '" . $field_name . "'"; $field_name = $new_field_name; et_debug( $message, 4, false ); } // content_new renamed to content, so rename it in affected fields list as well if ( $field_name === 'content_new' ) { $field_name = 'content'; } } /** * Finalizes the configuration of {@see self::$fields_unprocessed}. * Includes filter and fields processing for Visual Builder * * @return void */ protected function _finalize_all_fields() { $fields_before_filter = $this->fields_unprocessed; /** * Filters module fields. * * @since 3.1 * * @param array $fields_unprocessed See {@see self::$fields_unprocessed}. */ $this->fields_unprocessed = apply_filters( "et_pb_all_fields_unprocessed_{$this->slug}", $this->fields_unprocessed ); // Check if this is an AJAX request since this is how VB and BB loads the initial module data // et_fb_enabled() always returns `false` here if ( ! wp_doing_ajax() ) { return; } foreach ( array_keys( $this->fields_unprocessed ) as $field_name ) { $field_info = $this->fields_unprocessed[ $field_name ]; $affected_fields = self::$_->array_get( $field_info, 'affects', array() ); foreach ( $affected_fields as $affected_field ) { if ( ! isset( $this->fields_unprocessed[ $affected_field ] ) ) { continue; } if ( ! isset( $this->fields_unprocessed[ $affected_field ]['depends_on'] ) ) { $this->fields_unprocessed[ $affected_field ]['depends_on'] = array(); } $this->fields_unprocessed[ $affected_field ]['depends_on'][] = $field_name; // Set `depends_show_if = on` if no condition defined for the affected field for backward compatibility with old plugins if ( ! isset( $this->fields_unprocessed[ $affected_field ]['depends_show_if'] ) && ! isset( $this->fields_unprocessed[ $affected_field ]['depends_show_if_not'] ) ) { // Deprecation notice has already been logged for this. $this->fields_unprocessed[ $affected_field ]['depends_show_if'] = 'on'; } } // Unset renderer to avoid errors in VB because of errors in 3rd party plugins // BB compat. Still need this data, so leave it for BB if ( self::is_loading_vb_data() && isset( $this->fields_unprocessed[ $field_name ]['renderer'] ) ) { unset( $this->fields_unprocessed[ $field_name ]['renderer'] ); } } // determine custom fields added via filter and add specific flag to identify them in VB $keys_before_filter = array_keys( $fields_before_filter ); $keys_after_filter = array_keys( $this->fields_unprocessed ); $added_fields = array_diff( $keys_after_filter, $keys_before_filter ); if ( ! empty( $added_fields ) ) { foreach ( $added_fields as $key ) { $this->fields_unprocessed[ $key ]['vb_support'] = false; } } } /** * Determine if current request is VB Data Request by checking $_POST['action'] value * * @return bool */ private function is_loading_vb_data() { return isset( $_POST['action'] ) && 'et_fb_retrieve_builder_data' === $_POST['action']; // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification } private function register_post_type( $post_type ) { $this->post_types[] = $post_type; self::$parent_modules[ $post_type ] = array(); self::$child_modules[ $post_type ] = array(); } /** * Double quote are saved as "%22" in shortcode attributes. * Decode them back into " * * @param array $enabled_dynamic_attributes * * @return void */ private function _decode_double_quotes( $enabled_dynamic_attributes ) { if ( ! isset( $this->props ) ) { return; } // need to encode HTML entities in Admin Area( for BB ) if Visual Editor disabled for the user. $need_html_entities_decode = is_admin() && ! user_can_richedit(); $shortcode_attributes = array(); $font_icon_options = array( 'font_icon', 'button_icon', 'button_one_icon', 'button_two_icon', 'hover_icon' ); foreach ( $this->props as $attribute_key => $attribute_value ) { // decode HTML entities and remove trailing and leading quote if needed $processed_attr_value = $need_html_entities_decode ? trim( htmlspecialchars_decode( $attribute_value, ENT_QUOTES ), '"' ) : $attribute_value; // the icon shortcodes are fine. if ( in_array( $attribute_key, $font_icon_options, true ) ) { $shortcode_attributes[ $attribute_key ] = $processed_attr_value; // icon attributes must not be str_replaced continue; } // Set empty TinyMCE content '<br />
' as empty string. $field_type = self::$_->array_get( $this->fields_unprocessed, "{$attribute_key}.type" ); if ( 'tiny_mce' === $field_type && 'ltbrgtbr' === preg_replace( '/[^a-z]/', '', $processed_attr_value ) ) { $processed_attr_value = ''; } // URLs are weird since they can allow non-ascii characters so we escape those separately. // Also make sure the attribute is not powered by dynamic content so we do not escape // the JSON value as if it is a raw url. $is_dynamic_content_attribute = $this->_is_dynamic_value( $attribute_key, $attribute_value, $enabled_dynamic_attributes ); if ( ! $is_dynamic_content_attribute && in_array( $attribute_key, array( 'url', 'button_link', 'button_url' ), true ) ) { $shortcode_attributes[ $attribute_key ] = esc_url_raw( $processed_attr_value ); } else { $shortcode_attributes[ $attribute_key ] = str_replace( array( '%22', '%92', '%91', '%93' ), array( '"', '\\', '[', ']' ), $processed_attr_value ); } } $this->props = $shortcode_attributes; } /** * Provide a way for sub-class to access $this->_render_count without a chance to alter its value * * @return int */ protected function render_count() { return $this->_render_count; } /** * Bumps the render count for this module instance and the module instance whose slug is * set as {@see self::$_bumps_render_count} (if any). * * @since 3.10 */ protected function _bump_render_count() { $this->_render_count++; if ( $this->_bumps_render_count ) { $module = self::get_module( $this->_bumps_render_count, $this->get_post_type() ); $module->_render_count++; } } /** * check whether ab testing enabled for current module and calculate whether it should be displayed currently or not * * @return bool */ private function _is_display_module( $shortcode_atts ) { $ab_subject_id = isset( $shortcode_atts['ab_subject_id'] ) && '' !== $shortcode_atts['ab_subject_id'] ? $shortcode_atts['ab_subject_id'] : false; // return true if testing is disabled or current module has no subject id. if ( ! $ab_subject_id ) { return true; } return $this->_check_ab_test_subject( $ab_subject_id ); } /** * check whether the current module should be displayed or not * * @return bool */ private function _check_ab_test_subject( $ab_subject_id = false ) { global $et_pb_ab_subject; if ( ! $ab_subject_id ) { return true; } return $ab_subject_id === $et_pb_ab_subject; } /** * Resets indexes used when generating element addresses. * * @param string $content * @param bool $force * * @return string */ public static function reset_element_indexes( $content = '', $force = false ) { if ( ! $force && ( ! self::$can_reset_element_indexes || ! is_main_query() ) ) { return $content; } $slugs = self::get_parent_slugs_regex(); if ( $content && ! preg_match( "/{$slugs}/", $content ) ) { // At least one builder element should be present. return $content; } global $wp_current_filter; if ( in_array( 'the_content', $wp_current_filter ) ) { $call_counts = array_count_values( $wp_current_filter ); if ( $call_counts['the_content'] > 1 ) { // This is a nested call. We only want to reset indexes after the top-most call. return $content; } } self::$_current_section_index = -1; self::$_current_row_index = -1; self::$_current_row_inner_index = -1; self::$_current_column_index = -1; self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; if ( $force ) { // Reset module order classes self::$modules_order = array(); self::$inner_modules_order = array(); } return $content; } /** * Generates the element's address. Every builder element on the page is assigned an address * based on it's index and those of it's parents using the following format: * * `$section.$row.$column.$module[.$module_item]` * * For example, if a module is the forth module in the first column in the third row in the * second section on the page, it's address would be: `1.2.0.3` (indexes are zero-based). * * @since 3.1 Renamed from `_get_current_shortcode_address()` to `generate_element_address()` * @since 3.0.60 * * @param string render slug * * @return string */ public function generate_element_address( $render_slug = '' ) { // Flag child module. $this->type isn't accurate in this context since some modules reuse other // modules' render() method for rendering their output (ie. accordion item). $is_child_module = in_array( $render_slug, self::get_child_slugs( $this->get_post_type() ) ); if ( false !== strpos( $render_slug, '_section' ) ) { self::$_current_section_index++; // Reset every module index inside section self::$_current_row_index = -1; self::$_current_row_inner_index = -1; self::$_current_column_index = -1; self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_row_inner' ) ) { self::$_current_row_inner_index++; // Reset every module index inside row inner self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_row' ) ) { self::$_current_row_index++; // Reset every module index inside row self::$_current_column_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_column_inner' ) ) { self::$_current_column_inner_index++; // Reset every module index inside column inner self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_column' ) && -1 === self::$_current_row_index ) { self::$_current_column_index++; // Reset every module index inside column of specialty section self::$_current_row_inner_index = -1; self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_column' ) ) { self::$_current_column_index++; // Reset every module index inside column of regular section self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( $is_child_module ) { self::$_current_module_item_index++; } else { self::$_current_module_index++; // Reset module item index inside module self::$_current_module_item_index = -1; } $address = self::$_current_section_index; if ( -1 === self::$_current_row_index && -1 === self::$_current_row_inner_index ) { // Fullwidth & Specialty (without column inner) Section's module $parts = array( self::$_current_column_index, self::$_current_module_index ); } else if ( 0 <= self::$_current_row_inner_index ) { // Specialty (inside column inner) Section's module $parts = array( self::$_current_column_index, self::$_current_row_inner_index, self::$_current_column_inner_index, self::$_current_module_index ); } else { // Regular section's module $parts = array( self::$_current_row_index, self::$_current_column_index, self::$_current_module_index ); } foreach ( $parts as $part ) { if ( $part > -1 ) { $address .= ".{$part}"; } } if ( $is_child_module ) { $address .= '.' . self::$_current_module_item_index; } return $address; } /** * Resolves conditional defaults * * @param array $values Fields. * @param string $render_slug * * @return array */ function resolve_conditional_defaults( $values, $render_slug = '' ) { // Resolve conditional defaults for the FE $resolved = $this->get_default_props(); if ( $render_slug && $render_slug !== $this->slug ) { if ( $module = self::get_module( $render_slug, $this->get_post_type() ) ) { $resolved = array_merge( $resolved, $module->get_default_props() ); } } foreach ( $resolved as $field_name => $field_default ) { if ( is_array( $field_default ) && 2 === count( $field_default ) && ! empty( $field_default[0] ) && is_array( $field_default[1] ) ) { // Looks like we have a conditional default // Get $depend_field value or use the first default if undefined. list ( $depend_field, $conditional_defaults ) = $field_default; reset( $conditional_defaults ); $default_key = isset( $values[ $depend_field ] ) ? $values[ $depend_field ] : key( $conditional_defaults ); // Set the resolved default $resolved[ $field_name ] = isset( $conditional_defaults[ $default_key ] ) ? $conditional_defaults[ $default_key ] : null; } } // Add hover attributes if ( ! is_array( $values ) ) { return $resolved; } foreach ( $values as $attr => $value ) { if ( ! preg_match('~_hover(_enabled)?$~', $attr ) ) { continue; } $resolved[$attr] = $value; } return $resolved; } /** * Get wrapper settings. Combining module-defined wrapper settings with default wrapper settings * * @since 3.1 * * @param string $render_slug module slug * * @return array */ protected function get_wrapper_settings( $render_slug = '' ) { global $et_fb_processing_shortcode_object; // The following defaults are used on both frontend & builder $defaults = array( 'parallax_background' => '', 'video_background' => '', 'attrs' => array(), 'inner_attrs' => array( 'class' => 'et_pb_module_inner', ), ); // The following defaults are only used on frontend. VB handles these on ETBuilderInjectedComponent based on live props // Note: get_parallax_image_background() and video_background() have to be called before module_classname() if ( ! $et_fb_processing_shortcode_object ) { $use_background_image = self::$_->array_get( $this->advanced_fields, 'background.use_background_image', false ); $use_background_video = self::$_->array_get( $this->advanced_fields, 'background.use_background_video', false ); $use_module_id = self::$_->array_get( $this->props, 'module_id', '' ); // Module might disable image background if ( $use_background_image ) { $defaults['parallax_background'] = $this->get_parallax_image_background(); } // Module might disable video background if ( $use_background_video ) { $defaults['video_background'] = $this->video_background(); } // Module might intentionally has custom id fields (ie. Module items) if ( $use_module_id ) { $defaults['attrs']['id'] = $this->module_id( false ); } $defaults['attrs']['class'] = $this->module_classname( $render_slug ); } if ( ! $defaults['attrs'] ) { // Make sure we get an empty object when this is output as JSON later. $defaults['attrs'] = new stdClass; } // Fill empty argument attributes by default values return wp_parse_args( $this->wrapper_settings, $defaults ); } /** * Wrap module's rendered output with proper module wrapper. Ensuring module has consistent * wrapper output which compatible with module attribute and background insertion. * * @since 3.1 * * @param string $output Module's rendered output * @param string $render_slug Slug of module that is used for rendering output * * @return string */ protected function _render_module_wrapper( $output = '', $render_slug = '' ) { $wrapper_settings = $this->get_wrapper_settings( $render_slug ); $slug = $render_slug; $outer_wrapper_attrs = $wrapper_settings['attrs']; $inner_wrapper_attrs = $wrapper_settings['inner_attrs']; /** * Filters the HTML attributes for the module's outer wrapper. The dynamic portion of the * filter name, '$slug', corresponds to the module's slug. * * @since 3.1 * * @param string[] $outer_wrapper_attrs * @param ET_Builder_Element $module_instance */ $outer_wrapper_attrs = apply_filters( "et_builder_module_{$slug}_outer_wrapper_attrs", $outer_wrapper_attrs, $this ); /** * Filters the HTML attributes for the module's inner wrapper. The dynamic portion of the * filter name, '$slug', corresponds to the module's slug. * * @since 3.1 * * @param string[] $inner_wrapper_attrs * @param ET_Builder_Element $module_instance */ $inner_wrapper_attrs = apply_filters( "et_builder_module_{$slug}_inner_wrapper_attrs", $inner_wrapper_attrs, $this ); return sprintf( ' %2$s %3$s %5$s ', et_html_attrs( $outer_wrapper_attrs ), $wrapper_settings['parallax_background'], $wrapper_settings['video_background'], et_html_attrs( $inner_wrapper_attrs ), $output ); } /** * Resolves the values for dynamic attributes. * * @since 3.17.2 * * @param array $attrs List of attributes * * @return array Processed attributes with resolved dynamic values. */ function process_dynamic_attrs( $original_attrs ) { global $et_fb_processing_shortcode_object; $attrs = $original_attrs; $enabled_dynamic_attributes = $this->_get_enabled_dynamic_attributes( $attrs ); if ( is_array( $attrs ) ) { foreach ( $attrs as $key => $value ) { $attrs[ $key ] = $this->_resolve_value( $this->get_the_ID(), $key, $value, $enabled_dynamic_attributes, $et_fb_processing_shortcode_object ); } } return $attrs; } /** * Prepares for and then calls the module's {@see self::render()} method. * * @since 3.1 Renamed from `_shortcode_callback()` to `_render()`. * @since 1.0 * * @param array $attrs List of attributes * @param string $content Content being processed * @param string $render_slug Slug of module that is used for rendering output * @param string $parent_address [description] * @param string $global_parent [description] * @param string $global_parent_type [description] * * @return string The module's HTML output. */ function _render( $attrs, $content = null, $render_slug, $parent_address = '', $global_parent = '', $global_parent_type = '' ) { global $et_fb_processing_shortcode_object; $this->attrs_unprocessed = $attrs; $enabled_dynamic_attributes = $this->_get_enabled_dynamic_attributes( $attrs ); $attrs = $this->process_dynamic_attrs( $attrs ); $this->props = shortcode_atts( $this->resolve_conditional_defaults($attrs, $render_slug), $attrs ); $this->_decode_double_quotes( $enabled_dynamic_attributes ); $this->_maybe_remove_global_default_values_from_props(); // Some module items need to inherit value from its module parent // This inheritance needs to be done before migration to make it compatible with migration process $this->maybe_inherit_values(); $_address = $this->generate_element_address( $render_slug ); /** * Filters Module Props. * * @param array $props Array of processed props. * @param array $attrs Array of original shortcode attrs * @param string $slug Module slug * @param string $_address Module Address * @param string $content Module content */ $this->props = apply_filters( 'et_pb_module_shortcode_attributes', $this->props, $attrs, $render_slug, $_address, $content ); $global_content = false; $ab_testing_enabled = et_is_ab_testing_active(); $hide_subject_module_cached = $hide_subject_module = false; $post_id = apply_filters( 'et_is_ab_testing_active_post_id', get_the_ID() ); $global_module_id = $this->props['global_module']; // If the section/row/module is disabled, hide it if ( isset( $this->props['disabled'] ) && 'on' === $this->props['disabled'] && ! $et_fb_processing_shortcode_object ) { return; } // need to perform additional check and some modifications in case AB testing enabled if ( $ab_testing_enabled ) { // check if ab testing enabled for this module and if it shouldn't be displayed currently $hide_subject_module = ! $et_fb_processing_shortcode_object && ! $this->_is_display_module( $this->props ) && ! et_pb_detect_cache_plugins(); // add class to the AB testing subject if needed if ( isset( $this->props['ab_subject_id'] ) && '' !== $this->props['ab_subject_id'] ) { $subject_class = sprintf( ' et_pb_ab_subject et_pb_ab_subject_id-%1$s_%2$s', esc_attr( $post_id ), esc_attr( $this->props['ab_subject_id'] ) ); $this->props['module_class'] = isset( $this->props['module_class'] ) && '' !== $this->props['module_class'] ? $this->props['module_class'] . $subject_class : $subject_class; if ( et_pb_detect_cache_plugins() ) { $hide_subject_module_cached = true; } } // add class to the AB testing goal if needed if ( isset( $this->props['ab_goal'] ) && 'on' === $this->props['ab_goal'] ) { $goal_class = sprintf( ' et_pb_ab_goal et_pb_ab_goal_id-%1$s', esc_attr( $post_id ) ); $this->props['module_class'] = isset( $this->props['module_class'] ) && '' !== $this->props['module_class'] ? $this->props['module_class'] . $goal_class : $goal_class; } } //override module attributes for global module. Skip that step while processing Frontend Builder object if ( ! empty( $global_module_id ) && ! $et_fb_processing_shortcode_object ) { $global_module_data = et_pb_load_global_module( $global_module_id ); if ( '' !== $global_module_data ) { $unsynced_global_attributes = get_post_meta( $global_module_id, '_et_pb_excluded_global_options' ); $use_updated_global_sync_method = ! empty( $unsynced_global_attributes ); $unsynced_options = ! empty( $unsynced_global_attributes[0] ) ? json_decode( $unsynced_global_attributes[0], true ) : array(); $content_synced = $use_updated_global_sync_method && ! in_array( 'et_pb_content_field', $unsynced_options ); // support legacy selective sync system if ( ! $use_updated_global_sync_method ) { $content_synced = ! isset( $this->props['saved_tabs'] ) || false !== strpos( $this->props['saved_tabs'], 'general' ) || 'all' === $this->props['saved_tabs']; } if ( $content_synced ) { $global_content = et_pb_get_global_module_content( $global_module_data, $render_slug ); } if ( in_array($render_slug, array('et_pb_code', 'et_pb_fullwidth_code')) ) { $global_content = _et_pb_code_module_prep_content($global_content); } // cleanup the shortcode string to avoid the attributes messing with content $global_content_processed = false !== $global_content ? str_replace( $global_content, '', $global_module_data ) : $global_module_data; $global_atts = shortcode_parse_atts( et_pb_remove_shortcode_content( $global_content_processed, $this->slug ) ); // reset module addresses because global items will be processed once again and address will be incremented wrongly if ( false !== strpos( $render_slug, '_section' ) ) { self::$_current_section_index--; self::$_current_row_index = -1; self::$_current_row_inner_index = -1; self::$_current_column_index = -1; self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_row_inner' ) ) { self::$_current_row_index--; self::$_current_column_inner_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else if ( false !== strpos( $render_slug, '_row' ) ) { self::$_current_row_index--; self::$_current_column_index = -1; self::$_current_module_index = -1; self::$_current_module_item_index = -1; } else { self::$_current_module_index--; self::$_current_module_item_index = -1; } // Always unsync 'next_background_color' and 'prev_background_color' options for global sections // They should be dynamic and reflect color of top and bottom sections if ( $render_slug === 'et_pb_section' ) { $unsynced_options = array_merge( $unsynced_options, array( 'next_background_color', 'prev_background_color' ) ); } foreach( $this->props as $single_attr => $value ) { if ( isset( $global_atts[$single_attr] ) && ! in_array( $single_attr, $unsynced_options ) ) { // replace %22 with double quotes in options to make sure it's rendered correctly $this->props[ $single_attr] = is_string( $global_atts[ $single_attr] ) && ! array_intersect( array( "et_pb_{$single_attr}", $single_attr ), $this->dbl_quote_exception_options ) ? str_replace( '%22', '"', $global_atts[ $single_attr] ) : $global_atts[ $single_attr]; } } $enabled_dynamic_attributes_global = $this->_get_enabled_dynamic_attributes( $this->props ); $this->props = $this->process_dynamic_attrs( $this->props ); $this->_decode_double_quotes( $enabled_dynamic_attributes_global ); } } self::set_order_class( $render_slug ); $this->before_render(); $this->content_unprocessed = (false !== $global_content ? $global_content : $content); $content = $this->_resolve_value( $this->get_the_ID(), 'content', $this->content_unprocessed, $enabled_dynamic_attributes, $et_fb_processing_shortcode_object ); $content = apply_filters( 'et_pb_module_content', $content, $this->props, $attrs, $render_slug, $_address, $global_content ); // Set empty TinyMCE content '<br />
' as empty string. if ( 'ltbrgtbr' === preg_replace( '/[^a-z]/', '', $content ) ) { $content = ''; } if ( $et_fb_processing_shortcode_object ) { $this->content = et_pb_fix_shortcodes( $content, $this->use_raw_content ); } else { // Line breaks should be converted before do_shortcode to avoid legit rendered shortcode // line breaks being trimmed into one line and causing issue like broken javascript code if ( $this->use_raw_content ) { $content = et_builder_convert_line_breaks( et_builder_replace_code_content_entities( $content ) ); } $this->props['content'] = $this->content = ! ( isset( $this->is_structure_element ) && $this->is_structure_element ) ? do_shortcode( et_pb_fix_shortcodes( $content, $this->use_raw_content ) ) : ''; } // Restart classname on shortcode callback. Module class is only called once, not on every // shortcode module appearance. Thus classname construction need to be restarted on each // module callback $this->classname = array(); if ( method_exists( $this, 'shortcode_atts' ) ) { // Deprecated. Do not use this! $this->shortcode_atts(); } $this->process_additional_options( $render_slug ); $this->process_custom_css_fields( $render_slug ); // load inline fonts if needed if ( isset( $this->props['inline_fonts'] ) ) { $this->process_inline_fonts_option( $this->props['inline_fonts'] ); } // Automatically add slug as classname for module that uses other module's shortcode callback // This has to be added first because some classname is position-sensitive and used for // JS-based calculation (i.e. .et_pb_column in column inner) if ( $this->slug !== $render_slug ) { $this->add_classname( $this->slug ); } // Automatically add default classnames $this->add_classname( array( 'et_pb_module', $render_slug, ET_Builder_Element::get_module_order_class( $render_slug ), ) ); // Automatically added user-defined classname if there's any if ( isset( $this->props['module_class'] ) && '' !== $this->props['module_class'] ) { $this->add_classname( explode( ' ', $this->props['module_class'] ) ); } $animation_style = isset( $this->props['animation_style'] ) ? $this->props['animation_style'] : false; $animation_repeat = isset( $this->props['animation_repeat'] ) ? $this->props['animation_repeat'] : 'once'; $animation_direction = isset( $this->props['animation_direction'] ) ? $this->props['animation_direction'] : 'center'; $animation_duration = isset( $this->props['animation_duration'] ) ? $this->props['animation_duration'] : '500ms'; $animation_delay = isset( $this->props['animation_delay'] ) ? $this->props['animation_delay'] : '0ms'; $animation_intensity = isset( $this->props["animation_intensity_{$animation_style }"] ) ? $this->props["animation_intensity_{$animation_style }"] : '50%'; $animation_starting_opacity = isset( $this->props['animation_starting_opacity'] ) ? $this->props['animation_starting_opacity'] : '0%'; $animation_speed_curve = isset( $this->props['animation_speed_curve'] ) ? $this->props['animation_speed_curve'] : 'ease-in-out'; // Check if this is an AJAX request since this is how VB loads the initial module data // et_fb_enabled() always returns `false` here if ( $animation_style && 'none' !== $animation_style && ! wp_doing_ajax() ) { // Fade doesn't have direction if ( 'fade' === $animation_style ) { $animation_direction = ''; } if ( in_array( $animation_direction, array( 'top', 'right', 'bottom', 'left' ) ) ) { $animation_style .= ucfirst( $animation_direction ); } $module_class = ET_Builder_Element::get_module_order_class( $render_slug ); if ( $module_class ) { et_builder_handle_animation_data( array( 'class' => esc_attr( trim( $module_class ) ), 'style' => esc_html( $animation_style ), 'repeat' => esc_html( $animation_repeat ), 'duration' => esc_html( $animation_duration ), 'delay' => esc_html( $animation_delay ), 'intensity' => esc_html( $animation_intensity ), 'starting_opacity' => esc_html( $animation_starting_opacity ), 'speed_curve' => esc_html( $animation_speed_curve ), ) ); } // Try to apply old method for plugins without vb support if ( 'on' !== $this->vb_support ) { add_filter( "{$render_slug}_shortcode_output", array( $this, 'add_et_animated_class' ), 10, 2 ); } $this->add_classname( 'et_animated' ); } // Add "et_hover_enabled" class to elements that have at least one hover prop enabled if ( et_has_hover_enabled( $this->props ) ) { $this->add_classname( 'et_hover_enabled' ); } // Setup link options $link_option_url = isset( $this->props['link_option_url'] ) ? $this->props['link_option_url'] : ''; $link_option_url_new_window = isset( $this->props['link_option_url_new_window'] ) ? $this->props['link_option_url_new_window'] : false; if ( '' !== $link_option_url ) { $module_class = ET_Builder_Element::get_module_order_class( $render_slug ); if ( $module_class ) { et_builder_handle_link_options_data( array( 'class' => trim( $module_class ), 'url' => esc_url( $link_option_url ), 'target' => 'on' === $link_option_url_new_window ? '_blank' : '_self', ) ); } $this->add_classname( 'et_clickable' ); } // Hide module on specific screens if needed if ( isset( $this->props['disabled_on'] ) && '' !== $this->props['disabled_on'] ) { $disabled_on_array = explode( '|', $this->props['disabled_on'] ); $i = 0; $current_media_query = 'max_width_767'; foreach( $disabled_on_array as $value ) { if ( 'on' === $value ) { ET_Builder_Module::set_style( $render_slug, array( 'selector' => '%%order_class%%', 'declaration' => 'display: none !important;', 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } $i++; $current_media_query = 1 === $i ? '768_980' : 'min_width_981'; } } $render_method = $et_fb_processing_shortcode_object ? 'render_as_builder_data' : 'render'; $output = $this->{$render_method}( $attrs, $content, $render_slug, $parent_address, $global_parent, $global_parent_type ); // Wrap 3rd party module rendered output with proper module wrapper // @TODO implement module wrapper on official module if ( 'on' === $this->vb_support && 'render' === $render_method && ! $this->_is_official_module ) { $output = $this->_render_module_wrapper( $output, $render_slug ); } /** * Filters every builder modules shortcode output. * * @since 3.1 * * @param string $output * @param string $module_slug * @param object $this */ $output = apply_filters( 'et_module_shortcode_output', $output, $render_slug, $this ); /** * Filters builder module shortcode output. The dynamic portion of the filter name, `$render_slug`, * refers to the slug of the module for which the shortcode output was generated. * * @since 3.0.87 * * @param string $output * @param string $module_slug */ $output = apply_filters( "{$render_slug}_shortcode_output", $output, $render_slug ); $this->_bump_render_count(); if ( $hide_subject_module ) { return ''; } if ( $hide_subject_module_cached ) { $previous_subjects_cache = get_post_meta( $post_id, 'et_pb_subjects_cache', true ); if ( empty( $previous_subjects_cache ) ) { $previous_subjects_cache = array(); } if ( empty( $this->template_name ) ) { $previous_subjects_cache[ $this->props['ab_subject_id'] ] = $output; } else { $previous_subjects_cache[ $this->props['ab_subject_id'] ] = $this->output(); } // update the subjects cache in post meta to use it later update_post_meta( $post_id, 'et_pb_subjects_cache', $previous_subjects_cache ); // generate the placeholder to output on front-end instead of actual content $subject_placeholder = sprintf( '', esc_attr( $this->props['ab_subject_id'] ) ); return $subject_placeholder; } // Do not use `template_name` while processing object for VB if ( $et_fb_processing_shortcode_object || empty( $this->template_name ) ) { return $output; } return $this->output(); } /** * Add "et_animated" class using filter. Obsolete method and only applied to old 3rd party modules without `modules_classname()` method * * @param string $output * @param string $module_slug * * @return string */ function add_et_animated_class( $output, $module_slug ) { if ( in_array( $module_slug, ET_Builder_Element::$uses_module_classname ) ) { return $output; } remove_filter( "{$module_slug}_shortcode_output", array( $this, 'add_et_animated_class' ), 10 ); return preg_replace( "/class=\"(.*?{$module_slug}_\d+.*?)\"/", 'class="$1 et_animated"', $output, 1 ); } /** * Delete attribute values that are equal to the global default value (if one exists). * * @return void */ protected function _maybe_remove_global_default_values_from_props() { $fields = $this->fields_unprocessed; $must_print_fields = array( 'text_orientation' ); /** * Filters Must Print attributes array. * Must Print attributes - attributes which defaults should always be printed on Front End * * @deprecated * * @param array $must_print_fields Array of attribute names. */ $must_print_fields = apply_filters( $this->slug . '_must_print_attributes', $must_print_fields ); foreach ( $fields as $field_key => $field_settings ) { $global_setting_name = $this->get_global_setting_name( $field_key ); $global_setting_value = ET_Global_Settings::get_value( $global_setting_name ); if ( ! $global_setting_value || in_array( $field_key, $must_print_fields ) ) { continue; } $attr_value = self::$_->array_get( $this->props, $field_key, '' ); if ( $attr_value && $attr_value === $global_setting_value ) { $this->props[ $field_key ] = ''; } } } // intended to be overridden as needed function maybe_inherit_values() {} /** * Like {@see self::render()}, but sources the output from a template file. The template name * should be set in {@see self::$template_name}. * * Note: this functionality is not currently supported by the Visual Builder. Pages containing * modules that use this method to render their output cannot be edited using the Visual Builder * at this time. However, full support will be added in the coming months. * * @since 3.1 Renamed from `shortcode_output()` to `output()` * @since 2.4.6 * * @return string */ function output() { if ( empty( $this->template_name ) ) { return ''; } if ( method_exists( $this, 'shortcode_output' ) ) { // Backwards compatibility return $this->__call( 'shortcode_output', array() ); } $this->props['content'] = $this->content; extract( $this->props ); ob_start(); require( locate_template( $this->template_name . '.php' ) ); return ob_get_clean(); } /** * Generates HTML data attributes from an array of props. * * @since 3.1 Rename from `shortcode_atts_to_data_atts()` to `props_to_html_data_attrs()` * @since 1.0 * * @param array $props * * @return string */ public function props_to_html_data_attrs( $props = array() ) { if ( empty( $props ) ) { return ''; } $output = array(); foreach ( $props as $attr ) { $output[] = 'data-' . esc_attr( $attr ) . '="' . esc_attr( $this->props[ $attr ] ) . '"'; } return implode( ' ', $output ); } /** * This method is called before {@self::_render()} for rows, columns, and modules. It can * be overridden by elements that need to perform any tasks before rendering begins. * * @since 3.1 Renamed from `pre_shortcode_content()` to `before_render()`. * @since 1.0 */ public function before_render() { if ( method_exists( $this, 'pre_shortcode_content' ) ) { // Backwards compatibility $this->__call( 'pre_shortcode_content', array() ); } } /** * Generates the module's HTML output based on {@see self::$props}. This method should be * overridden in module classes. * * @since 3.1 Renamed from `shortcode_callback()` to `render()`. * @since 1.0 * * @param array $attrs List of unprocessed attributes * @param string $content Content being processed * @param string $render_slug Slug of module that is used for rendering output * * @return string The module's HTML output. */ public function render( $attrs, $content = null, $render_slug ) { if ( method_exists( $this, 'shortcode_callback' ) ) { // Backwards compatibility return $this->__call( 'shortcode_callback', array( $attrs, $content, $render_slug ) ); } return ''; } /** * Generates data used to render the module in the builder. * See {@see self::render()} for parameter info. * * @since 3.1 Renamed from `_shortcode_passthru_callback()` to `render_as_builder_data()` * @since 3.0.0 * * @return array|string An array when called during AJAX request, an empty string otherwise. */ public function render_as_builder_data( $atts, $content = null, $render_slug, $parent_address = '', $global_parent = '', $global_parent_type = '' ) { global $post; // this is called during pageload, but we want to ignore that round, as this data will be built and returned on separate ajax request instead et_core_nonce_verified_previously(); if ( ! isset( $_POST['action'] ) ) { return ''; } $attrs = array(); $fields = $this->process_fields( $this->fields_unprocessed ); $global_content = false; $function_name_processed = et_fb_prepare_tag( $render_slug ); $unsynced_global_attributes = array(); $use_updated_global_sync_method = false; $global_module_id = isset( $atts['global_module'] ) ? $atts['global_module'] : false; $is_global_template = false; if ( $render_slug && $render_slug !== $this->slug ) { if ( $rendering_module = self::get_module( $render_slug, $this->get_post_type() ) ) { $fields = array_merge( $fields, $this->process_fields( $rendering_module->fields_unprocessed ) ); } } // Add support of new selective sync feature for library modules in VB if ( isset( $_POST['et_post_type'], $_POST['et_post_id'], $_POST['et_layout_type'] ) && 'et_pb_layout' === $_POST['et_post_type'] && 'module' === $_POST['et_layout_type'] ) { $template_scope = wp_get_object_terms( $_POST['et_post_id'], 'scope' ); $is_global_template = ! empty( $template_scope[0] ) && 'global' === $template_scope[0]->slug; if ( $is_global_template ) { $global_module_id = $_POST['et_post_id']; } } //override module attributes for global module if ( ! empty( $global_module_id ) ) { if ( ! in_array( $render_slug, array( 'et_pb_section', 'et_pb_row', 'et_pb_row_inner', 'et_pb_column', 'et_pb_column_inner' ) ) ) { $processing_global_module = $global_module_id; $unsynced_global_attributes = get_post_meta( $processing_global_module, '_et_pb_excluded_global_options' ); $use_updated_global_sync_method = ! empty( $unsynced_global_attributes ); } $global_module_data = et_pb_load_global_module( $global_module_id ); if ( '' !== $global_module_data ) { $unsynced_options = ! empty( $unsynced_global_attributes[0] ) ? json_decode( $unsynced_global_attributes[0], true ) : array() ; $content_synced = $use_updated_global_sync_method && ! in_array( 'et_pb_content_field', $unsynced_options ); $is_module_fully_global = $use_updated_global_sync_method && empty( $unsynced_options ); $unsynced_legacy_options = array(); // support legacy selective sync system if ( ! $use_updated_global_sync_method ) { $content_synced = ! isset( $atts['saved_tabs'] ) || false !== strpos( $atts['saved_tabs'], 'general' ) || 'all' === $atts['saved_tabs']; $is_module_fully_global = ! isset( $atts['saved_tabs'] ) || 'all' === $atts['saved_tabs']; } if ( $content_synced && ! $is_global_template ) { $global_content = et_pb_get_global_module_content( $global_module_data, $function_name_processed ); // When saving global rows from specialty sections, they get saved as et_pb_row instead of et_pb_row_inner. // Handle this special case when parsing to avoid empty global row content. if ( empty( $global_content ) && 'et_pb_row_inner' === $function_name_processed ) { $global_content = et_pb_get_global_module_content( $global_module_data, 'et_pb_row' ); } } // remove the shortcode content to avoid conflicts of parent attributes with similar attrs from child modules if ( false !== $global_content ) { $global_content_processed = str_replace( $global_content, '', $global_module_data ); } else { $global_content_processed = $global_module_data; } // Ensuring that all possible attributes exist to avoid remaining child attributes being used by global parents' attributes // Do that only in case the module is fully global if ( $is_module_fully_global ) { $global_atts = wp_parse_args( shortcode_parse_atts( et_pb_remove_shortcode_content( $global_content_processed, $this->slug ) ), array_map( '__return_empty_string', $this->whitelisted_fields ) ); } else { $global_atts = shortcode_parse_atts( $global_content_processed ); } // Run et_pb_module_shortcode_attributes filter to apply migration system on attributes of global module $global_atts = apply_filters( 'et_pb_module_shortcode_attributes', $global_atts, $atts, $this->slug, $this->generate_element_address( $render_slug ), $content ); foreach( $this->props as $single_attr => $value ) { if ( isset( $global_atts[$single_attr] ) && ! in_array( $single_attr, $unsynced_options ) ) { // replace %22 with double quotes in options to make sure it's rendered correctly if ( ! $is_global_template ) { $this->props[ $single_attr ] = is_string( $global_atts[ $single_attr ] ) && ! array_intersect( array( "et_pb_{$single_attr}", $single_attr ), $this->dbl_quote_exception_options ) ? str_replace( '%22', '"', $global_atts[ $single_attr ] ) : $global_atts[ $single_attr ]; } } else if ( ! $use_updated_global_sync_method ) { // prepare array of unsynced options to migrate the legacy modules to new system $unsynced_legacy_options[] = $single_attr; } else { $unsynced_global_attributes[0] = $unsynced_options; } } // migrate unsynced options to the new selective sync method if ( ! $use_updated_global_sync_method ) { $unsynced_global_attributes[0] = $unsynced_legacy_options; // check the content and add it into list if needed. if ( ! $content_synced ) { $unsynced_global_attributes[0][] = 'et_pb_content_field'; } } else { $unsynced_global_attributes[0] = $unsynced_options; } } else { // remove global_module attr if it doesn't exist in DB $this->props['global_module'] = ''; $global_parent = ''; } } foreach( $this->props as $shortcode_attr_key => $shortcode_attr_value ) { if ( isset( $fields[ $shortcode_attr_key ]['type'] ) && 'computed' === $fields[ $shortcode_attr_key ]['type'] ) { $field = $fields[ $shortcode_attr_key ]; $depends_on = array(); if ( isset( $field['computed_depends_on'] ) ) { foreach ( $field['computed_depends_on'] as $depends_on_field ) { $dependency_value = $this->props[ $depends_on_field ]; if ( '' === $dependency_value ) { if ( isset( $this->fields_unprocessed[ $depends_on_field]['default'] ) ) { $dependency_value = $this->fields_unprocessed[ $depends_on_field ]['default']; } } $depends_on[ $depends_on_field ] = $dependency_value; } } if ( isset( $field['computed_variables'] ) ) { $depends_on['computed_variables'] = $field['computed_variables']; } if ( ! is_callable( $field['computed_callback'] ) ) { wp_die( esc_html( $shortcode_attr_key . ' Callback:' . $field['computed_callback'] . ' is not callable.... ' ) ); } $value = call_user_func( $field['computed_callback'], $depends_on ); } else { $value = $shortcode_attr_value; } // dont set the default, unless, lol, the value is literally 'default' if ( isset( $fields[ $shortcode_attr_key ]['default'] ) && $value === $fields[ $shortcode_attr_key ]['default'] && $value !== 'default' ) { $value = ''; } // generic override, disabled=off is an unspoken default if ( $shortcode_attr_key === 'disabled' && $shortcode_attr_value === 'off' ) { $value = ''; } // this override is necessary becuase et_pb_column and et_pb_column_inner type default is 4_4 and will get stomped // above since its default, but we need it explicitly set anyways, so we force set it if ( in_array( $render_slug, array( 'et_pb_column', 'et_pb_column_inner' ) ) && $shortcode_attr_key === 'type' ) { $value = $shortcode_attr_value; } if ( '' !== $value ) { $attrs[$shortcode_attr_key] = is_string($value) ? html_entity_decode($value) : $value; } } // Format FB component path // TODO, move this to class method and property, and allow both to be overridden $component_path = str_replace( 'et_pb_' , '', $function_name_processed ); $component_path = str_replace( '_', '-', $component_path ); $_i = isset( $atts['_i'] ) ? $atts['_i'] : 0; $address = isset( $atts['_address'] ) ? $atts['_address'] : '0'; // set the global parent if exists if ( ( ! isset( $attrs['global_module'] ) || '' === $attrs['global_module'] ) && '' !== $global_parent ) { $attrs['global_parent'] = $global_parent; } if ( isset( $this->is_structure_element ) && $this->is_structure_element ) { $this->vb_support = 'on'; } $processed_content = false !== $global_content ? $global_content : $this->content; $content = array_key_exists( 'content', $this->fields_unprocessed ) || 'et_pb_code' === $function_name_processed || 'et_pb_fullwidth_code' === $function_name_processed ? $processed_content : et_fb_process_shortcode( $processed_content, $address, $global_parent, $global_parent_type ); // Global Code module content should be decoded before passing to VB. $is_global_code = in_array( $function_name_processed, array( 'et_pb_code', 'et_pb_fullwidth_code' ) ); $prepared_content = $content; if ( ( ! is_array( $content ) && $this->vb_support !== 'on' && ! $this->has_line_breaks( $content ) ) || $is_global_code ) { $prepared_content = html_entity_decode( $content, ENT_COMPAT, 'UTF-8' ); } if ( empty( $attrs ) ) { // Visual Builder expects $attrs to be an object. // Associative array converted to an object by wp_json_encode correctly, but empty array is not and it causes issues. $attrs = new stdClass(); } $module_type = $this->type; $render_count = $this->_render_count; $child_title_var = isset( $this->child_title_var ) ? $this->child_title_var : ''; $child_title_fallback_var = isset( $this->child_title_fallback_var ) ? $this->child_title_fallback_var : ''; $advanced_setting_title_text = isset( $this->advanced_setting_title_text ) ? $this->advanced_setting_title_text : ''; // If this is a shop module use the Shop module render count // Shop module creates a new class instance which resets the $_render_count value // ( see get_shop_html() method of ET_Builder_Module_Shop class in main-modules.php ) // so we use a static property to track its proper render count if ( 'et_pb_shop' === $render_slug ) { $render_count = self::$_shop_render_count; self::$_shop_render_count++; } // Ensuring that module which uses another module's template (i.e. accordion item uses toggle's // component) has correct values for class properties where it makes a difference. This is covered on front-end, but it causes inheriting // module uses its template's value on render_as_builder_data() if ( isset( $rendering_module, $rendering_module->type ) ) { $module_type = $rendering_module->type; $child_title_var = isset( $rendering_module->child_title_var ) ? $rendering_module->child_title_var : $child_title_var; $child_title_fallback_var = isset( $rendering_module->child_title_fallback_var ) ? $rendering_module->child_title_fallback_var : $child_title_fallback_var; $advanced_setting_title_text = isset( $rendering_module->advanced_setting_title_text ) ? $rendering_module->advanced_setting_title_text : $advanced_setting_title_text; } // Build object. $object = array( '_i' => $_i, '_order' => $_i, // TODO make address be _address, its conflicting with 'address' prop in map module... (not sure how though, they are in diffent places...) 'address' => $address, 'child_slug' => $this->child_slug, 'vb_support' => $this->vb_support, 'parent_address' => $parent_address, 'shortcode_index' => $render_count, 'type' => $render_slug, 'component_path' => $component_path, 'main_css_element' => $this->main_css_element, 'attrs' => $attrs, 'content' => $prepared_content, 'is_module_child' => 'child' === $module_type, 'is_official_module' => $this->_is_official_module, 'child_title_var' => $child_title_var, 'child_title_fallback_var' => $child_title_fallback_var, 'advanced_setting_title_text' => $advanced_setting_title_text, 'wrapper_settings' => $this->get_wrapper_settings( $render_slug ), ); if ( ! empty( $unsynced_global_attributes ) ) { $object['unsyncedGlobalSettings'] = $unsynced_global_attributes[0]; } if ( $is_global_template ) { $object['libraryModuleScope'] = 'global'; } if ( isset( $this->module_items_config ) ) { $object['module_items_config'] = $this->module_items_config; } return $object; } /** * Determine if provided string contain line-breaks (`\r\n`) * * @param string $content String to check * * @return bool */ function has_line_breaks( $content ) { return count( preg_split('/\r\n*\n/', trim( $content ), -1, PREG_SPLIT_NO_EMPTY ) ) > 1; } // intended to be overridden as needed function additional_render( $attrs, $content = null, $render_slug ) { if ( method_exists( $this, 'additional_shortcode_callback' ) ) { // Backwards compatibility $this->__call( 'additional_shortcode_callback', array( $attrs, $content, $render_slug ) ); } } // intended to be overridden as needed function predefined_child_modules(){} /** * Generate global setting name * * @param string $option_slug Option slug * * @return string Global setting name in the following format: "module_slug-option_slug" */ public function get_global_setting_name( $option_slug ) { $global_setting_name = sprintf( '%1$s-%2$s', isset( $this->global_settings_slug ) ? $this->global_settings_slug : $this->slug, $option_slug ); return $global_setting_name; } /** * Add global default values to all fields, if they don't have defaults set * * @return void */ protected function _maybe_add_global_defaults() { // Don't add default settings to "child" modules if ( 'child' === $this->type ) { return; } $fields = $this->fields_unprocessed; $ignored_keys = array( 'custom_margin', 'custom_padding', ); // Font color settings have custom_color set to true, so add them to ignored keys array if ( isset( $this->advanced_fields['fonts'] ) && is_array( $this->advanced_fields['fonts'] ) ) { foreach ( $this->advanced_fields['fonts'] as $font_key => $font_settings ) { $ignored_keys[] = sprintf( '%1$s_text_color', $font_key ); } } $ignored_keys = apply_filters( 'et_builder_add_defaults_ignored_keys', $ignored_keys ); foreach ( $fields as $field_key => $field_settings ) { if ( in_array( $field_key, $ignored_keys ) ) { continue; } $global_setting_name = $this->get_global_setting_name( $field_key ); $global_setting_value = ET_Global_Settings::get_value( $global_setting_name ); if ( ! isset( $field_settings['default'] ) && $global_setting_value ) { $fields[ $field_key ]['default'] = $global_setting_value; // Mark this default as global so VB won't print it to replicate FE behaviour $fields[ $field_key ]['is_global_default'] = true; } } $this->fields_unprocessed = $fields; } protected function _add_additional_fields() { // Setup has_advanced_fields property to adjust advanced options visibility on // module that has no VB support to avoid sudden advanced options appearances $this->has_advanced_fields = isset( $this->advanced_fields ); // Advanced options are added by default unless module explicitly disabled it $this->advanced_fields = $this->has_advanced_fields ? $this->advanced_fields : array(); // Advanced options have to be array if ( ! is_array( $this->advanced_fields ) ) { return; } $this->_add_font_fields(); $this->_add_background_fields(); $this->_add_borders_fields(); $this->_add_button_fields(); $this->_add_box_shadow_fields(); $this->_add_text_fields(); $this->_add_max_width_fields(); $this->_add_margin_padding_fields(); // Add filter fields to modules $this->_add_filter_fields(); // Add divider fields to section modules. $this->_add_divider_fields(); // Add animation fields to all modules $this->_add_animation_fields(); $this->_add_additional_transition_fields(); // Add text shadow fields to all modules $this->_add_text_shadow_fields(); // Add link options to all modules $this->_add_link_options_fields(); if ( ! isset( $this->_additional_fields_options ) ) { return false; } $additional_options = $this->_additional_fields_options; // Add hover field indication $additional_options['hover_enabled'] = array( 'type' => 'skip', 'default' => 0, ); if ( ! empty( $additional_options ) ) { // delete second level advanced options default values if ( isset( $this->type ) && 'child' === $this->type && apply_filters( 'et_pb_remove_child_module_defaults', true ) ) { foreach ( $additional_options as $name => $settings ) { if ( isset( $additional_options[ $name ]['default'] ) && ! isset( $additional_options[ $name ]['default_on_child'] ) ) { $additional_options[ $name ]['default'] = ''; } } } $this->fields_unprocessed = array_merge( $this->fields_unprocessed, $additional_options ); } } protected function _add_font_fields() { // Font fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['fonts'] = self::$_->array_get( $this->advanced_fields, 'fonts', array( 'module' => array( 'label' => esc_html__( 'Module', 'custom_module' ), 'line_height' => array( 'default' => floatval( et_get_option( 'body_font_height', '1.7' ) ) . 'em', ), 'font_size' => array( 'default' => absint( et_get_option( 'body_font_size', '14' ) ) . 'px', ), ), ) ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Font settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'fonts' ) ) ) { return; } $advanced_font_options = $this->advanced_fields['fonts']; $additional_options = array(); $defaults = array( 'all_caps' => 'off', ); foreach ( $advanced_font_options as $option_name => $option_settings ) { $advanced_font_options[ $option_name ]['defaults'] = $defaults; } $this->advanced_fields['fonts'] = $advanced_font_options; $font_options_count = 0; foreach ( $advanced_font_options as $option_name => $option_settings ) { $font_options_count++; $option_settings = wp_parse_args( $option_settings, array( 'label' => '', 'font_size' => array(), 'letter_spacing' => array(), 'font' => array(), 'text_align' => array(), ) ); $toggle_disabled = isset( $option_settings['disable_toggle'] ) && $option_settings['disable_toggle']; $tab_slug = isset( $option_settings['tab_slug'] ) ? $option_settings['tab_slug'] : 'advanced'; $toggle_slug = ''; if ( ! $toggle_disabled ) { $toggle_slug = isset( $option_settings['toggle_slug'] ) ? $option_settings['toggle_slug'] : $option_name; $sub_toggle = isset( $option_settings['sub_toggle'] ) ? $option_settings['sub_toggle'] : ''; if ( ! isset( $option_settings['toggle_slug'] ) ) { $font_toggle = array( $option_name => array( 'title' => sprintf( '%1$s %2$s', esc_html( $option_settings['label'] ), esc_html__( 'Text', 'et_builder' ) ), 'priority' => 50 + $font_options_count, ), ); $this->_add_settings_modal_toggles( $tab_slug, $font_toggle ); } } if ( isset( $option_settings['header_level'] ) ) { $additional_options["{$option_name}_level"] = array( 'label' => sprintf( esc_html__( '%1$s Heading Level', 'et_builder' ), $option_settings['label'] ), 'type' => 'multiple_buttons', 'option_category' => 'font_option', 'options' => array( 'h1' => array( 'title' => 'H1', 'icon' => 'text-h1', ), 'h2' => array( 'title' => 'H2', 'icon' => 'text-h2', ), 'h3' => array( 'title' => 'H3', 'icon' => 'text-h3', ), 'h4' => array( 'title' => 'H4', 'icon' => 'text-h4', ), 'h5' => array( 'title' => 'H5', 'icon' => 'text-h5', ), 'h6' => array( 'title' => 'H6', 'icon' => 'text-h6', ), ), 'default' => isset( $option_settings['header_level']['default'] ) ? $option_settings['header_level']['default'] : 'h2', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'advanced_fields' => true, ); if ( isset( $option_settings['header_level']['computed_affects'] ) ) { $additional_options["{$option_name}_level"]['computed_affects'] = $option_settings['header_level']['computed_affects']; } } if ( ! isset( $option_settings['hide_font'] ) || ! $option_settings['hide_font'] ) { $additional_options["{$option_name}_font"] = wp_parse_args( $option_settings['font'], array( 'label' => sprintf( esc_html__( '%1$s Font', 'et_builder' ), $option_settings['label'] ), 'type' => 'font', 'group_label' => esc_html__( $option_settings['label'] ), 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, ) ); // add reference to the obsolete "all caps" option if needed if ( isset( $option_settings['use_all_caps'] ) && $option_settings['use_all_caps'] ) { $additional_options["{$option_name}_font"]['attributes'] = array( 'data-old-option-ref' => "{$option_name}_all_caps" ); } // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_font"]['depends_show_if'] = $option_settings['depends_show_if']; } } if ( ! isset( $option_settings['hide_text_align'] ) || ! $option_settings['hide_text_align'] ) { $additional_options["{$option_name}_text_align"] = wp_parse_args( $option_settings['text_align'], array( 'label' => sprintf( esc_html__( '%1$s Text Alignment', 'et_builder' ), $option_settings['label'] ), 'type' => 'text_align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( array( 'justified' ), array( 'justify' => 'Justified' ) ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'advanced_fields' => true, ) ); } if ( ! isset( $option_settings['hide_text_color'] ) || ! $option_settings['hide_text_color'] ) { $additional_options["{$option_name}_text_color"] = array( 'label' => sprintf( esc_html__( '%1$s Text Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'color-alpha', 'option_category' => 'font_option', 'custom_color' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, ); // add reference to the obsolete color option if needed if ( self::$_->array_get( $option_settings, 'text_color.old_option_ref' ) ) { $additional_options["{$option_name}_text_color"]['attributes'] = array( 'data-old-option-ref' => "{$option_settings['text_color']['old_option_ref']}" ); } // set default value if defined if ( self::$_->array_get( $option_settings, 'text_color.default' ) ) { $additional_options["{$option_name}_text_color"]['default'] = $option_settings['text_color']['default']; } // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_text_color"]['depends_show_if'] = $option_settings['depends_show_if']; } } if ( ! isset( $option_settings['hide_font_size'] ) || ! $option_settings['hide_font_size'] ) { $additional_options["{$option_name}_font_size"] = wp_parse_args( $option_settings['font_size'], array( 'label' => sprintf( esc_html__( '%1$s Text Size', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'default_unit' => 'px', 'mobile_options' => true, 'range_settings' => array( 'min' => '1', 'max' => '100', 'step' => '1', ), 'hover' => 'tabs', ) ); // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_font_size"]['depends_show_if'] = $option_settings['depends_show_if']; } if ( isset( $option_settings['header_level'] ) ) { $header_level_default = isset( $option_settings['header_level']['default'] ) ? $option_settings['header_level']['default'] : 'h2'; $additional_options["{$option_name}_font_size"]['default_value_depends'] = "{$option_name}_level"; $additional_options["{$option_name}_font_size"]['default_values_mapping'] = array( 'h1' => '30px', 'h2' => '26px', 'h3' => '22px', 'h4' => '18px', 'h5' => '16px', 'h6' => '14px', ); // remove default font-size for default header level to use option default unset( $additional_options["{$option_name}_font_size"]['default_values_mapping'][ $header_level_default ] ); } $additional_options["{$option_name}_font_size_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_font_size_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_font_size_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } if ( ! isset( $option_settings['hide_text_color'] ) || ! $option_settings['hide_text_color'] ) { $additional_options["{$option_name}_text_color"] = array( 'label' => sprintf( esc_html__( '%1$s Text Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'color-alpha', 'option_category' => 'font_option', 'custom_color' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'hover' => 'tabs', ); // add reference to the obsolete color option if needed if (self::$_->array_get($option_settings, 'text_color.old_option_ref')) { $additional_options["{$option_name}_text_color"]['attributes'] = array( 'data-old-option-ref' => "{$option_settings['text_color']['old_option_ref']}" ); } // set default value if defined if (self::$_->array_get($option_settings, 'text_color.default')) { $additional_options["{$option_name}_text_color"]['default'] = $option_settings['text_color']['default']; } // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_text_color"]['depends_show_if'] = $option_settings['depends_show_if']; } } if ( ! isset( $option_settings['hide_letter_spacing'] ) || ! $option_settings['hide_letter_spacing'] ) { $additional_options["{$option_name}_letter_spacing"] = wp_parse_args( $option_settings['letter_spacing'], array( 'label' => sprintf( esc_html__( '%1$s Letter Spacing', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'mobile_options' => true, 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'default' => '0px', 'default_unit' => 'px', 'range_settings' => array( 'min' => '0', 'max' => '100', 'step' => '1', ), 'hover' => 'tabs', ) ); // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_letter_spacing"]['depends_show_if'] = $option_settings['depends_show_if']; } $additional_options["{$option_name}_letter_spacing_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } if ( ! isset( $option_settings['hide_line_height'] ) || ! $option_settings['hide_line_height'] ) { $default_option_line_height = array( 'label' => sprintf( esc_html__( '%1$s Line Height', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'mobile_options' => true, 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, 'default_unit' => 'em', 'range_settings' => array( 'min' => '1', 'max' => '3', 'step' => '0.1', ), 'hover' => 'tabs', ); if ( isset( $option_settings['line_height'] ) ) { $additional_options["{$option_name}_line_height"] = wp_parse_args( $option_settings['line_height'], $default_option_line_height ); } else { $additional_options["{$option_name}_line_height"] = $default_option_line_height; } // set the depends_show_if parameter if needed if ( isset( $option_settings['depends_show_if'] ) ) { $additional_options["{$option_name}_line_height"]['depends_show_if'] = $option_settings['depends_show_if']; } $additional_options["{$option_name}_line_height_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_line_height_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_line_height_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } // Add text-shadow to font options if ( ! isset( $option_settings['hide_text_shadow'] ) || ! $option_settings['hide_text_shadow'] ) { $option = $this->text_shadow->get_fields(array( // Don't use an additional label for 'text' or else we'll end up with 'Text Text Shadow....' 'label' => 'text' === $option_name ? '' : $option_settings['label'], 'prefix' => $option_name, 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, )); $additional_options = array_merge( $additional_options, $option ); }; // The below option is obsolete. This code is for backward compatibility if ( isset( $option_settings['use_all_caps'] ) && $option_settings['use_all_caps'] ) { $additional_options["{$option_name}_all_caps"] = array( 'type' => 'hidden', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'sub_toggle' => $sub_toggle, ); } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } protected function _add_background_fields() { // Background fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['background'] = self::$_->array_get( $this->advanced_fields, 'background', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Background settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'background' ) ) ) { return; } $toggle_disabled = self::$_->array_get( $this->advanced_fields, 'background.settings.disable_toggle', false ); $tab_slug = self::$_->array_get( $this->advanced_fields, 'background.settings.tab_slug', 'general' ); $toggle_slug = ''; if ( ! $toggle_disabled ) { $toggle_slug = self::$_->array_get( $this->advanced_fields, 'background.settings.toggle_slug', 'background' ); $background_toggle = array( 'background' => array( 'title' => esc_html__( 'Background', 'et_builder' ), 'priority' => 80, ), ); $this->_add_settings_modal_toggles( $tab_slug, $background_toggle ); } $background_field_name = "background"; // Possible values for use_* attributes: true, false, or 'fields_only' $defaults = array( 'has_background_color_toggle' => false, 'use_background_color' => true, 'use_background_color_gradient' => true, 'use_background_image' => true, 'use_background_video' => true, ); $this->advanced_fields['background'] = wp_parse_args( $this->advanced_fields['background'], $defaults ); $additional_options = array(); if ( $this->advanced_fields['background']['use_background_color'] ) { $additional_options = array_merge( $additional_options, $this->generate_background_options( 'background', 'color', $tab_slug, $toggle_slug ) ); } // Use background color toggle was added on pre color-alpha era. Added for backward // compatibility. This option's output is printed manually on render() if ( $this->advanced_fields['background']['has_background_color_toggle'] ) { $additional_options['use_background_color'] = array( 'label' => esc_html__( 'Use Background Color', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'color_option', 'options' => array( 'on' => esc_html__( 'Yes', 'et_builder' ), 'off' => esc_html__( 'No', 'et_builder' ), ), 'affects' => array( 'background_color', ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'description' => esc_html__( 'Here you can choose whether background color setting above should be used or not.', 'et_builder' ), ); } if ( $this->advanced_fields['background']['use_background_color_gradient'] ) { $additional_options = array_merge( $additional_options, $this->generate_background_options( 'background', 'gradient', $tab_slug, $toggle_slug ) ); } if ( $this->advanced_fields['background']['use_background_image'] ) { $additional_options = array_merge( $additional_options, $this->generate_background_options( 'background', 'image', $tab_slug, $toggle_slug ) ); } if ( $this->advanced_fields['background']['use_background_video'] ) { $additional_options = array_merge( $additional_options, $this->generate_background_options( 'background', 'video', $tab_slug, $toggle_slug ) ); } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); // Allow module to configure specific options $background_options = self::$_->array_get( $this->advanced_fields, 'background.options', false ); if ( $background_options ) { foreach ( $background_options as $option_slug => $options ) { if ( ! is_array( $options ) ) { continue; } foreach ( $options as $option_name => $option_value ) { $additional_options[ $option_slug ][ $option_name ] = $option_value; } } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } protected function _add_text_fields() { // Text fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['text'] = self::$_->array_get( $this->advanced_fields, 'text', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Text settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'text' ) ) ) { return; } $text_settings = $this->advanced_fields['text']; $tab_slug = isset( $text_settings['tab_slug'] ) ? $text_settings['tab_slug'] : 'advanced'; $toggle_slug = isset( $text_settings['toggle_slug'] ) ? $text_settings['toggle_slug'] : 'text'; $sub_toggle = isset( $text_settings['sub_toggle'] ) ? $text_settings['sub_toggle'] : ''; $orientation_exclude_options = isset( $text_settings['text_orientation'] ) && isset( $text_settings['text_orientation']['exclude_options'] ) ? $text_settings['text_orientation']['exclude_options'] : array(); // Make sure we can exclude text_orientation from Advanced/Text $setting_defaults = array( 'use_text_orientation' => true, 'use_background_layout' => false, ); $text_settings = wp_parse_args( $text_settings, $setting_defaults ); $this->_add_settings_modal_toggles( $tab_slug, array( $toggle_slug => array( 'title' => esc_html__( 'Text', 'et_builder' ), 'priority' => 49, ), ) ); $additional_options = array(); if ( $text_settings['use_text_orientation'] ) { $default_on_front = self::$_->array_get( $text_settings, 'options.text_orientation.default_on_front', '' ); $additional_options = array( 'text_orientation' => array( 'label' => esc_html__( 'Text Orientation', 'et_builder' ), 'type' => 'text_align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( $orientation_exclude_options ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'description' => esc_html__( 'This controls how your text is aligned within the module.', 'et_builder' ), 'advanced_fields' => true, 'default' => self::$_->array_get( $text_settings, 'options.text_orientation.default', $default_on_front ), ), ); if ( '' !== $sub_toggle ) { $additional_options['text_orientation']['sub_toggle'] = $sub_toggle; } } // Background layout works by setting text to light/dark color. This was added before text // color has its own colorpicker as a simple mechanism for picking color. // New module should not use this option. This is kept for backward compatibility if ( $text_settings['use_background_layout'] ) { $additional_options['background_layout'] = array( 'label' => esc_html__( 'Text Color', 'et_builder' ), 'type' => 'select', 'option_category' => 'color_option', 'options' => array( 'dark' => esc_html__( 'Light', 'et_builder' ), 'light' => esc_html__( 'Dark', 'et_builder' ), ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'hover' => 'tabs', 'description' => esc_html__( 'Here you can choose whether your text should be light or dark. If you are working with a dark background, then your text should be light. If your background is light, then your text should be set to dark.', 'et_builder' ), ); if ( '' !== $sub_toggle ) { $additional_options['background_layout']['sub_toggle'] = $sub_toggle; } } // Allow module to configure specific options if ( isset( $text_settings['options'] ) && is_array( $text_settings['options'] ) ) { foreach ( $text_settings['options'] as $option_slug => $options ) { if ( ! is_array( $options ) ) { continue; } foreach ( $options as $option_name => $option_value ) { if ( isset( $additional_options[ $option_slug ] ) ) { $additional_options[ $option_slug ][ $option_name ] = $option_value; } } } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } /** * Add Border & Border Radius fields to each module. Default borders option are added on with * Borders fields group on Design tab. However, module can add more borders field by adding * more settings on $this->advanced_fields['borders'] * * @since 3.1 * * {@internal * border options are initially defined via _add_additional_border_fields() method and adding * more border options require overwriting it on module's class. This is repetitive so * the fields registration mechanics were simplified mimicing advanced fonts field mechanism.} */ protected function _add_borders_fields() { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } // Get borders settings. Fallback to default if needed. Borders are added to all modules by default // unless the module explicitly disabled it // Backward compatibility. Use `border` settings as default if exist $legacy_border = self::$_->array_get( $this->advanced_fields, 'border', array() ); $borders_fields = self::$_->array_get( $this->advanced_fields, 'borders', array( 'default' => $legacy_border, ) ); // Borders settings have to be array if ( ! is_array( $borders_fields ) ) { return; } // Loop border settings, enable multiple border fields declaration in one place foreach ( $borders_fields as $border_fields_name => $border_fields ) { // Enable module to disable border options by setting it to false if ( false === $border_fields ) { continue; } // Make sure that border fields has minimum attribute required $border_fields_defaults = array( 'tab_slug' => 'advanced', 'toggle_slug' => 'border', ); $border_fields = wp_parse_args( $border_fields, $border_fields_defaults ); // Check for default border options $is_default_border_options = 'default' === $border_fields_name; if ( $is_default_border_options ) { // Default border fields doesn't have toggle for itself, thus register new toggle $this->_add_settings_modal_toggles( $border_fields['tab_slug'], array( $border_fields['toggle_slug'] => array( 'title' => esc_html__( 'Border', 'et_builder' ), 'priority' => 95, ), ) ); } // Add suffix to border fields settings $suffix = $is_default_border_options ? '' : "_{$border_fields_name}"; $border_fields['suffix'] = $suffix; // Assign CSS setting to advanced options if ( isset( $border_fields['css'] ) ) { $this->advanced_fields["border{$suffix}"]['css'] = $border_fields['css']; } // Add border fields to advanced_fields. Each border fields (style + radii) has its own attribute // registered on $this->advanced_fields self::$_->array_set( $this->advanced_fields, "border{$suffix}", $border_fields ); $this->_additional_fields_options = array_merge( $this->_additional_fields_options, ET_Builder_Module_Fields_Factory::get( 'Border' )->get_fields( $border_fields ) ); // Add module defined fields that needs to be added after existing border options if ( isset( $border_fields['fields_after'] ) ) { $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $border_fields['fields_after'] ); } // Loop radii and styles and add fields to advanced_fields foreach ( array( 'border_radii', 'border_styles' ) as $border_key ) { $border_key_name = $border_key . $suffix; if ( isset( $this->advanced_fields["border{$suffix}"][ $border_key_name ] ) ) { // Backward compatibility. Properly handle existing 3rd party module that // directly defines border via direct $this->advanced_fields["border{$suffix}"] $this->advanced_fields["border{$suffix}"][ $border_key_name ] = array_merge( $this->advanced_fields["border{$suffix}"][ $border_key_name ], $this->_additional_fields_options[ $border_key_name ] ); $message = "You're Doing It Wrong! You shouldn't define border settings in 'advanced_fields' directly. All the Border settings should be defined via provided API"; et_debug( $message ); } else { // Add border options to advanced_fields $this->advanced_fields["border{$suffix}"][ $border_key_name ] = $this->_additional_fields_options[ $border_key_name ]; } } } if ( method_exists( $this, '_add_additional_border_fields' ) ) { // Backwards compatibility should go after all the fields added to emulate behavior of old version $this->_add_additional_border_fields(); $message = "You're Doing It Wrong! '_add_additional_border_fields' is deprecated. All the Border settings should be defined via provided API"; et_debug( $message ); } } protected function _add_max_width_fields() { // Max width fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['max_width'] = self::$_->array_get( $this->advanced_fields, 'max_width', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Max width settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'max_width' ) ) ) { return; } $max_width_settings = $this->advanced_fields['max_width']; $tab_slug = isset( $max_width_settings['tab_slug'] ) ? $max_width_settings['tab_slug'] : 'advanced'; $toggle_slug = isset( $max_width_settings['toggle_slug'] ) ? $max_width_settings['toggle_slug'] : 'width'; $toggle_title = isset( $max_width_settings['toggle_title'] ) ? $max_width_settings['toggle_title'] : esc_html__( 'Sizing', 'et_builder' ); $toggle_priority = isset( $max_width_settings['toggle_priority'] ) ? $max_width_settings['toggle_priority'] : 80; $setting_defaults = array( 'use_max_width' => true, 'use_module_alignment' => true, ); $this->advanced_fields['max_width'] = wp_parse_args( $this->advanced_fields['max_width'], $setting_defaults ); $this->_add_settings_modal_toggles( $tab_slug, array( $toggle_slug => array( 'title' => $toggle_title, 'priority' => $toggle_priority, ), ) ); // Added max width option if ( $this->advanced_fields['max_width']['use_max_width'] ) { $additional_options = array( 'max_width' => array( 'label' => esc_html__( 'Width', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'mobile_options' => true, 'default_on_child' => true, 'validate_unit' => true, 'default' => '100%', 'default_tablet' => '100%', 'default_unit' => '%', 'allow_empty' => true, 'range_settings' => array( 'min' => '0', 'max' => '100', 'step' => '1', ), 'hover' => 'tabs', ), 'max_width_tablet' => array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ), 'max_width_phone' => array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ), 'max_width_last_edited' => array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ), ); } // Added module alignment option $allowed_children = array( 'et_pb_counter', 'et_pb_accordion_item' ); $is_excluded = isset( $this->type ) && 'child' === $this->type && ! in_array( $this->slug, $allowed_children ); if ( $this->advanced_fields['max_width']['use_module_alignment'] && ! $is_excluded ) { $additional_options['module_alignment'] = array( 'label' => esc_html__( 'Module Alignment', 'et_builder' ), 'type' => 'text_align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( array( 'justified' ) ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); // Added max width & module alignment attributes which only make sense if both field exist if ( $this->advanced_fields['max_width']['use_max_width'] ) { $additional_options['max_width']['responsive_affects'] = array( 'module_alignment', ); $additional_options['module_alignment']['depends_on'] = array( 'max_width', et_pb_hover_options()->get_hover_field( 'max_width' ), ); $additional_options['module_alignment']['depends_on_responsive'] = array( 'max_width', ); $additional_options['module_alignment']['depends_show_if_not'] = array( '', '100%', ); } } // Allow module to configure specific options if ( isset( $max_width_settings['options'] ) && is_array( $max_width_settings['options'] ) ) { foreach ( $max_width_settings['options'] as $option_slug => $options ) { if ( ! is_array( $options ) ) { continue; } foreach ( $options as $option_name => $option_value ) { $additional_options[ $option_slug ][ $option_name ] = $option_value; } } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } protected function _add_margin_padding_fields() { // Margin-Padding fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['margin_padding'] = self::$_->array_get( $this->advanced_fields, 'margin_padding', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Margin settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'margin_padding' ) ) ) { return; } $additional_options = array(); $defaults = array( 'use_margin' => true, 'use_padding' => true, ); $this->advanced_fields['margin_padding'] = wp_parse_args( $this->advanced_fields['margin_padding'], $defaults ); $tab_slug = isset( $this->advanced_fields['margin_padding']['tab_slug'] ) ? $this->advanced_fields['margin_padding']['tab_slug'] : 'advanced'; $toggle_disabled = isset( $this->advanced_fields['margin_padding']['disable_toggle'] ) && $this->advanced_fields['margin_padding']['disable_toggle']; $toggle_slug = isset( $this->advanced_fields['margin_padding']['toggle_slug'] ) ? $this->advanced_fields['margin_padding']['toggle_slug'] : 'margin_padding'; if ( ! $toggle_disabled ) { $margin_toggle = array( $toggle_slug => array( 'title' => esc_html__( 'Spacing', 'et_builder' ), 'priority' => 90, ), ); $this->_add_settings_modal_toggles( $tab_slug, $margin_toggle ); } if ( $this->advanced_fields['margin_padding']['use_margin'] ) { $additional_options['custom_margin'] = array( 'label' => esc_html__( 'Custom Margin', 'et_builder' ), 'type' => 'custom_margin', 'mobile_options' => true, 'option_category' => 'layout', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'hover' => 'tabs', ); $additional_options['custom_margin_tablet'] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, ); $additional_options['custom_margin_phone'] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); // make it possible to override/add options if ( ! empty( $this->advanced_fields['margin_padding']['custom_margin'] ) ) { $additional_options['custom_margin'] = array_merge( $additional_options['custom_margin'], $this->advanced_fields['margin_padding']['custom_margin'] ); } $additional_options["custom_margin_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["padding_1_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["padding_2_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["padding_3_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["padding_4_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } if ( $this->advanced_fields['margin_padding']['use_padding'] ) { $additional_options['custom_padding'] = array( 'label' => esc_html__( 'Custom Padding', 'et_builder' ), 'type' => 'custom_padding', 'mobile_options' => true, 'option_category' => 'layout', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'hover' => 'tabs', ); $additional_options['custom_padding_tablet'] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options['custom_padding_phone'] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); // make it possible to override/add options if ( ! empty( $this->advanced_fields['margin_padding']['custom_padding'] ) ) { $additional_options['custom_padding'] = array_merge( $additional_options['custom_padding'], $this->advanced_fields['margin_padding']['custom_padding'] ); } $additional_options["custom_padding_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } protected function _add_button_fields() { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_advanced_fields ) { return; } // Button settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'button' ) ) ) { return; } // Auto-add attributes toggle $toggles_custom_css_tab = isset( $this->settings_modal_toggles['custom_css'] ) ? $this->settings_modal_toggles['custom_css'] : array(); if ( ! isset( $toggles_custom_css_tab['toggles'] ) || ! isset( $toggles_custom_css_tab['toggles']['attributes'] ) ) { $this->_add_settings_modal_toggles( 'custom_css', array( 'attributes' => array( 'title' => esc_html__( 'Attributes', 'et_builder' ), 'priority' => 95, ), ) ); } $additional_options = array(); $hover = et_pb_hover_options(); foreach ( $this->advanced_fields['button'] as $option_name => $option_settings ) { $tab_slug = isset( $option_settings['tab_slug'] ) ? $option_settings['tab_slug'] : 'advanced'; $toggle_disabled = isset( $option_settings['disable_toggle'] ) && $option_settings['disable_toggle']; $toggle_slug = ''; if ( ! $toggle_disabled ) { $toggle_slug = isset( $option_settings['toggle_slug'] ) ? $option_settings['toggle_slug'] : $option_name; $button_toggle = array( $option_name => array( 'title' => esc_html( $option_settings['label'] ), 'priority' => 70, ), ); $this->_add_settings_modal_toggles( $tab_slug, $button_toggle ); } $additional_options["custom_{$option_name}"] = array( 'label' => sprintf( esc_html__( 'Use Custom Styles for %1$s ', 'et_builder' ), $option_settings['label'] ), 'type' => 'yes_no_button', 'option_category' => 'button', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'affects' => array( "{$option_name}_text_color", "{$option_name}_text_size", "{$option_name}_border_width", "{$option_name}_border_radius", "{$option_name}_letter_spacing", "{$option_name}_spacing", "{$option_name}_bg_color", "{$option_name}_border_color", "{$option_name}_use_icon", "{$option_name}_font", $hover->get_hover_field( "{$option_name}_text_color" ), $hover->get_hover_field( "{$option_name}_border_color" ), $hover->get_hover_field( "{$option_name}_border_radius" ), $hover->get_hover_field( "{$option_name}_letter_spacing" ), "{$option_name}_text_shadow_style", // Add Text Shadow to button options "box_shadow_style_{$option_name}", ), 'default_on_front' => 'off', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_text_size"] = array( 'label' => sprintf( esc_html__( '%1$s Text Size', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'range_settings' => array( 'min' => '1', 'max' => '100', 'step' => '1', ), 'option_category' => 'button', 'default' => ET_Global_Settings::get_value( 'all_buttons_font_size' ), 'default_unit' => 'px', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'mobile_options' => true, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_text_color"] = array( 'label' => sprintf( esc_html__( '%1$s Text Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'color-alpha', 'option_category' => 'button', 'custom_color' => true, 'default' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_bg_color"] = array( 'label' => sprintf( esc_html__( '%1$s Background Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'background-field', 'base_name' => "{$option_name}_bg", 'context' => "{$option_name}_bg", 'option_category' => 'button', 'custom_color' => true, 'default' => ET_Global_Settings::get_value( 'all_buttons_bg_color' ), 'default_on_front' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', 'background_fields' => $this->generate_background_options( "{$option_name}_bg", 'button', $tab_slug, $toggle_slug, "{$option_name}_bg_color" ), 'hover' => 'tabs', ); $additional_options["{$option_name}_bg_color"]['background_fields']["{$option_name}_bg_color"]['default'] = ET_Global_Settings::get_value( 'all_buttons_bg_color' ); $additional_options = array_merge( $additional_options, $this->generate_background_options( "{$option_name}_bg", 'skip', $tab_slug, $toggle_slug, "{$option_name}_bg_color" ) ); $additional_options["{$option_name}_border_width"] = array( 'label' => sprintf( esc_html__( '%1$s Border Width', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'option_category' => 'button', 'default' => ET_Global_Settings::get_value( 'all_buttons_border_width' ), 'default_unit' => 'px', 'default_on_front' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_border_color"] = array( 'label' => sprintf( esc_html__( '%1$s Border Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'color-alpha', 'option_category' => 'button', 'custom_color' => true, 'default' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_border_radius"] = array( 'label' => sprintf( esc_html__( '%1$s Border Radius', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'option_category' => 'button', 'default' => ET_Global_Settings::get_value( 'all_buttons_border_radius' ), 'default_unit' => 'px', 'default_on_front' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_letter_spacing"] = array( 'label' => sprintf( esc_html__( '%1$s Letter Spacing', 'et_builder' ), $option_settings['label'] ), 'type' => 'range', 'option_category' => 'button', 'default' => ET_Global_Settings::get_value( 'all_buttons_spacing' ), 'default_unit' => 'px', 'default_on_front' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'mobile_options' => true, 'depends_show_if' => 'on', 'hover' => 'tabs', ); $additional_options["{$option_name}_font"] = array( 'label' => sprintf( esc_html__( '%1$s Font', 'et_builder' ), $option_settings['label'] ), 'type' => 'font', 'option_category' => 'button', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', ); $additional_options["{$option_name}_use_icon"] = array( 'label' => sprintf( esc_html__( 'Show %1$s Icon', 'et_builder' ), $option_settings['label'] ), 'type' => 'yes_no_button', 'option_category' => 'button', 'default' => 'on', 'options' => array( 'on' => esc_html__( 'Yes', 'et_builder' ), 'off' => esc_html__( 'No', 'et_builder' ), ), 'affects' => array( "{$option_name}_icon_color", "{$option_name}_icon_placement", "{$option_name}_on_hover", "{$option_name}_icon", ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', ); $additional_options["{$option_name}_icon"] = array( 'label' => sprintf( esc_html__( '%1$s Icon', 'et_builder' ), $option_settings['label'] ), 'type' => 'select_icon', 'option_category' => 'button', 'class' => array( 'et-pb-font-icon' ), 'default' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if_not' => 'off', ); $additional_options["{$option_name}_icon_color"] = array( 'label' => sprintf( esc_html__( '%1$s Icon Color', 'et_builder' ), $option_settings['label'] ), 'type' => 'color-alpha', 'option_category' => 'button', 'custom_color' => true, 'default' => '', 'hover' => 'tabs', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if_not' => 'off', ); $additional_options["{$option_name}_icon_placement"] = array( 'label' => sprintf( esc_html__( '%1$s Icon Placement', 'et_builder' ), $option_settings['label'] ), 'type' => 'select', 'option_category' => 'button', 'options' => array( 'right' => esc_html__( 'Right', 'et_builder' ), 'left' => esc_html__( 'Left', 'et_builder' ), ), 'default' => 'right', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if_not' => 'off', ); $additional_options["{$option_name}_on_hover"] = array( 'label' => sprintf( esc_html__( 'Only Show Icon On Hover for %1$s', 'et_builder' ), $option_settings['label'] ), 'type' => 'yes_no_button', 'option_category' => 'button', 'default' => 'on', 'options' => array( 'on' => esc_html__( 'Yes', 'et_builder' ), 'off' => esc_html__( 'No', 'et_builder' ), ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if_not' => 'off', ); $additional_options["{$option_name}_text_size_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_text_size_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_hover_tablet"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_hover_phone"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_text_size_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options["{$option_name}_letter_spacing_last_edited"] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); $additional_options[$hover->get_hover_field( "{$option_name}_letter_spacing_last_edited" )] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); if ( isset( $option_settings['use_alignment'] ) && $option_settings['use_alignment'] ) { $additional_options["{$option_name}_alignment"] = array( 'label' => esc_html__( 'Button Alignment', 'et_builder' ), 'type' => 'text_align', 'option_category' => 'layout', 'options' => et_builder_get_text_orientation_options( array( 'justified' ) ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } // The configurable rel attribute field is added by default if ( ! isset( $option_settings['no_rel_attr'] ) ) { $additional_options["{$option_name}_rel"] = array( 'label' => sprintf( esc_html__( '%1$s Relationship', 'et_builder' ), $option_settings['label'] ), 'type' => 'multiple_checkboxes', 'option_category' => 'configuration', 'options' => $this->get_rel_values(), 'description' => et_get_safe_localization( __( "Specify the value of your link's rel attribute. The rel attribute specifies the relationship between the current document and the linked document.
Tip: Search engines can use this attribute to get more information about a link.", 'et_builder' ) ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'attributes', 'shortcut_index' => $option_name, ); } // Add text-shadow to button options $option = $this->text_shadow->get_fields(array( 'label' => $option_settings['label'], 'prefix' => $option_name, 'option_category' => 'font_option', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', )); $additional_options = array_merge( $additional_options, $option ); // Conditionally add box-shadow options to button options. Get box shadow settings for advanced button fields. $button_box_shadow_options = self::$_->array_get( $option_settings, 'box_shadow', array() ); // Enable module to remove box shadow from advanced button fields by declaring false value to box // shadow attribute (i.e. button module) if ( false !== $button_box_shadow_options ) { $button_box_shadow_options = wp_parse_args( $button_box_shadow_options, array( 'label' => esc_html__( 'Button Box Shadow', 'et_builder' ), 'option_category' => 'layout', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'depends_show_if' => 'on', ) ); // Only print box shadow styling if custom_* attribute is equal to "on" by adding show_iff attribute $button_visibility_condition = array( "custom_{$option_name}" => 'on' ); self::$_->array_set( $button_box_shadow_options, 'css.show_if', $button_visibility_condition ); // Automatically add default box shadow fields if box shadow attribute hasn't even defined yet. // No attribute found is considered true for default thus if this about to add the first advanced // box shadow, add the default first if ( ! isset( $this->advanced_fields['box_shadow'] ) ) { $button_box_shadow_options_default = array(); self::$_->array_set( $this->advanced_fields, "box_shadow.default", $button_box_shadow_options_default ); } // Box shadow fields are generated after button fields being added. Thus, adding $this->advanced_fields // is sufficient to insert the box shadow fields self::$_->array_set( $this->advanced_fields, "box_shadow.{$option_name}", $button_box_shadow_options ); } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } protected function _add_animation_fields() { // Animation fields are added by default on all module $this->advanced_fields['animation'] = self::$_->array_get( $this->advanced_fields, 'animation', array() ); // Animation Disabled if ( false === $this->advanced_fields['animation'] ) { return; } $classname = get_class( $this ); if ( isset( $this->type ) && 'child' === $this->type ) { return; } $this->settings_modal_toggles['advanced']['toggles']['animation'] = array( 'title' => esc_html__( 'Animation', 'et_builder' ), 'priority' => 110, ); $additional_options = array(); $animations_intensity_fields = array( 'animation_intensity_slide', 'animation_intensity_zoom', 'animation_intensity_flip', 'animation_intensity_fold', 'animation_intensity_roll', ); $additional_options['animation_style'] = array( 'label' => esc_html__( 'Animation Style', 'et_builder' ), 'type' => 'select_animation', 'option_category' => 'configuration', 'default' => 'none', 'description' => esc_html__( 'Pick an animation style to enable animations for this element. Once enabled, you will be able to customize your animation style further. To disable animations, choose the None option.' ), 'options' => array( 'none' => esc_html__( 'None', 'et_builder' ), 'fade' => esc_html__( 'Fade', 'et_builder' ), 'slide' => esc_html__( 'Slide', 'et_builder' ), 'bounce' => esc_html__( 'Bounce', 'et_builder' ), 'zoom' => esc_html__( 'Zoom', 'et_builder' ), 'flip' => esc_html__( 'Flip', 'et_builder' ), 'fold' => esc_html__( 'Fold', 'et_builder' ), 'roll' => esc_html__( 'Roll', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'affects' => array_merge( array( 'animation_repeat', 'animation_direction', 'animation_duration', 'animation_delay', 'animation_starting_opacity', 'animation_speed_curve', ), $animations_intensity_fields ), ); $additional_options['animation_repeat'] = array( 'label' => esc_html__( 'Animation Repeat', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'default' => 'once', 'description' => esc_html__( 'By default, animations will only play once. If you would like to loop your animation continuously you can choose the Loop option here.' ), 'options' => array( 'once' => esc_html__( 'Once', 'et_builder' ), 'loop' => esc_html__( 'Loop', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => 'none', ); $additional_options['animation_direction'] = array( 'label' => esc_html__( 'Animation Direction', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'default' => 'center', 'description' => esc_html__( 'Pick from up to five different animation directions, each of which will adjust the starting and ending position of your animated element.' ), 'options' => array( 'center' => esc_html__( 'Center', 'et_builder' ), 'left' => esc_html__( 'Right', 'et_builder' ), 'right' => esc_html__( 'Left', 'et_builder' ), 'bottom' => esc_html__( 'Up', 'et_builder' ), 'top' => esc_html__( 'Down', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => array( 'none', 'fade' ), ); $additional_options['animation_duration'] = array( 'label' => esc_html__( 'Animation Duration', 'et_builder' ), 'type' => 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 2000, 'step' => 50, ), 'default' => '1000ms', 'description' => esc_html__( 'Speed up or slow down your animation by adjusting the animation duration. Units are in milliseconds and the default animation duration is one second.' ), 'validate_unit' => true, 'fixed_unit' => 'ms', 'fixed_range' => true, 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => 'none', 'reset_animation' => true, ); $additional_options['animation_delay'] = array( 'label' => esc_html__( 'Animation Delay', 'et_builder' ), 'type' => 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 3000, 'step' => 50, ), 'default' => '0ms', 'description' => esc_html__( 'If you would like to add a delay before your animation runs you can designate that delay here in milliseconds. This can be useful when using multiple animated modules together.' ), 'validate_unit' => true, 'fixed_unit' => 'ms', 'fixed_range' => true, 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => 'none', 'reset_animation' => true, ); foreach ( $animations_intensity_fields as $animations_intensity_field ) { $animation_style = str_replace( 'animation_intensity_', '', $animations_intensity_field ); $additional_options[ $animations_intensity_field ] = array( 'label' => esc_html__( 'Animation Intensity', 'et_builder' ), 'type' => 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '50%', 'description' => esc_html__( 'Intensity effects how subtle or aggressive your animation will be. Lowering the intensity will create a smoother and more subtle animation while increasing the intensity will create a snappier more aggressive animation.' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if' => $animation_style, 'reset_animation' => true, ); } $additional_options['animation_starting_opacity'] = array( 'label' => esc_html__( 'Animation Starting Opacity', 'et_builder' ), 'type' => 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '0%', 'description' => esc_html__( 'By increasing the starting opacity, you can can reduce or remove the fade effect that is applied to all animation styles.' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => 'none', 'reset_animation' => true, ); $additional_options['animation_speed_curve'] = array( 'label' => esc_html__( 'Animation Speed Curve', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'default' => 'ease-in-out', 'description' => esc_html__( 'Here you can adjust the easing method of your animation. Easing your animation in and out will create a smoother effect when compared to a linear speed curve.' ), 'options' => array( 'ease-in-out' => esc_html__( 'Ease-In-Out', 'et_builder' ), 'ease' => esc_html__( 'Ease', 'et_builder' ), 'ease-in' => esc_html__( 'Ease-In', 'et_builder' ), 'ease-out' => esc_html__( 'Ease-Out', 'et_builder' ), 'linear' => esc_html__( 'Linear', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'depends_show_if_not' => 'none', ); if ( isset( $this->slug ) && 'et_pb_fullwidth_menu' === $this->slug ) { $additional_options['dropdown_menu_animation'] = array( 'label' => esc_html__( 'Dropdown Menu Animation', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'fade' => esc_html__( 'Fade', 'et_builder' ), 'expand' => esc_html__( 'Expand', 'et_builder' ), 'slide' => esc_html__( 'Slide', 'et_builder' ), 'flip' => esc_html__( 'Flip', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'default' => 'fade', ); } // Move existing "Animation" section fields under the new animations UI if ( isset( $this->slug ) && 'et_pb_fullwidth_portfolio' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Carousel Rotation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', ), 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you the carousel layout option is chosen and you would like the carousel to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Carousel Rotation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the carousel rotates, if 'Automatic Carousel Rotation' option is enabled above. The higher the number the longer the pause between each rotation. (Ex. 1000 = 1 sec)", 'et_builder' ), 'default' => '7000', ); } if ( isset( $this->slug ) && 'et_pb_fullwidth_slider' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Animation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', 'auto_ignore_hover', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you would like the slider to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Animation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the slider fades between each slide, if 'Automatic Animation' option is enabled above. The higher the number the longer the pause between each rotation.", 'et_builder' ), 'default' => '7000', ); $additional_options['auto_ignore_hover'] = array( 'label' => esc_html__( 'Continue Automatic Slide on Hover', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'Turning this on will allow automatic sliding to continue on mouse hover.', 'et_builder' ), 'default' => 'off', ); } if ( isset( $this->slug ) && 'et_pb_fullwidth_post_slider' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Animation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', 'auto_ignore_hover', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you would like the slider to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Animation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the slider fades between each slide, if 'Automatic Animation' option is enabled above. The higher the number the longer the pause between each rotation.", 'et_builder' ), 'default' => '7000', ); $additional_options['auto_ignore_hover'] = array( 'label' => esc_html__( 'Continue Automatic Slide on Hover', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'Turning this on will allow automatic sliding to continue on mouse hover.', 'et_builder' ), 'default' => 'off', ); } if ( isset( $this->slug ) && 'et_pb_gallery' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Animation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', ), 'depends_show_if' => 'on', 'depends_on' => array( 'fullwidth', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you would like the slider to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Animation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the slider fades between each slide, if 'Automatic Animation' option is enabled above. The higher the number the longer the pause between each rotation.", 'et_builder' ), 'default' => '7000', ); } if ( isset( $this->slug ) && 'et_pb_blurb' === $this->slug ) { $additional_options['animation'] = array( 'label' => esc_html__( 'Image/Icon Animation', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'top' => esc_html__( 'Top To Bottom', 'et_builder' ), 'left' => esc_html__( 'Left To Right', 'et_builder' ), 'right' => esc_html__( 'Right To Left', 'et_builder' ), 'bottom' => esc_html__( 'Bottom To Top', 'et_builder' ), 'off' => esc_html__( 'No Animation', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'This controls the direction of the lazy-loading animation.', 'et_builder' ), 'default' => 'top', ); } if ( isset( $this->slug ) && 'et_pb_slider' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Animation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', 'auto_ignore_hover', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you would like the slider to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Animation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the slider fades between each slide, if 'Automatic Animation' option is enabled above. The higher the number the longer the pause between each rotation.", 'et_builder' ), 'default' => '7000', ); $additional_options['auto_ignore_hover'] = array( 'label' => esc_html__( 'Continue Automatic Slide on Hover', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'Turning this on will allow automatic sliding to continue on mouse hover.', 'et_builder' ), 'default' => 'off', ); } if ( isset( $this->slug ) && 'et_pb_post_slider' === $this->slug ) { $additional_options['auto'] = array( 'label' => esc_html__( 'Automatic Animation', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'affects' => array( 'auto_speed', 'auto_ignore_hover', ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'If you would like the slider to slide automatically, without the visitor having to click the next button, enable this option and then adjust the rotation speed below if desired.', 'et_builder' ), 'default' => 'off', ); $additional_options['auto_speed'] = array( 'label' => esc_html__( 'Automatic Animation Speed (in ms)', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( "Here you can designate how fast the slider fades between each slide, if 'Automatic Animation' option is enabled above. The higher the number the longer the pause between each rotation.", 'et_builder' ), 'default' => '7000', ); $additional_options['auto_ignore_hover'] = array( 'label' => esc_html__( 'Continue Automatic Slide on Hover', 'et_builder' ), 'type' => 'yes_no_button', 'option_category' => 'configuration', 'depends_show_if' => 'on', 'options' => array( 'off' => esc_html__( 'Off', 'et_builder' ), 'on' => esc_html__( 'On', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'Turning this on will allow automatic sliding to continue on mouse hover.', 'et_builder' ), 'default' => 'off', ); } if ( isset( $this->slug ) && 'et_pb_team_member' === $this->slug ) { $additional_options['animation'] = array( 'label' => esc_html__( 'Animation', 'et_builder' ), 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No Animation', 'et_builder' ), 'fade_in' => esc_html__( 'Fade In', 'et_builder' ), 'left' => esc_html__( 'Left To Right', 'et_builder' ), 'right' => esc_html__( 'Right To Left', 'et_builder' ), 'top' => esc_html__( 'Top To Bottom', 'et_builder' ), 'bottom' => esc_html__( 'Bottom To Top', 'et_builder' ), ), 'tab_slug' => 'advanced', 'toggle_slug' => 'animation', 'description' => esc_html__( 'This controls the direction of the lazy-loading animation.', 'et_builder' ), 'default' => 'off', ); } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } private function _add_additional_transition_fields() { $this->settings_modal_toggles['custom_css']['toggles']['hover_transitions'] = array( 'title' => esc_html__( 'Transitions', 'et_builder' ), 'priority' => 120, ); $additional_options = array(); $additional_options['hover_transition_duration'] = array( 'label' => esc_html__( 'Transition Duration', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 2000, 'step' => 50, ), 'default' => '300ms', 'default_on_child' => true, 'validate_unit' => true, 'fixed_unit' => 'ms', 'fixed_range' => true, 'tab_slug' => 'custom_css', 'toggle_slug' => 'hover_transitions', 'depends_default' => null, 'description' => esc_html__( 'This controls the transition duration of the hover animation.', 'et_builder' ), ); $additional_options['hover_transition_delay'] = array( 'label' => esc_html__( 'Transition Delay', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 300, 'step' => 50, ), 'default' => '0ms', 'default_on_child' => true, 'validate_unit' => true, 'fixed_unit' => 'ms', 'fixed_range' => true, 'tab_slug' => 'custom_css', 'toggle_slug' => 'hover_transitions', 'depends_default' => null, 'description' => esc_html__( 'This controls the transition delay of the hover animation.', 'et_builder' ), ); $additional_options['hover_transition_speed_curve'] = array( 'label' => esc_html__( 'Transition Speed Curve', 'et_builder' ), 'type' => 'select', 'option_category' => 'layout', 'default' => 'ease', 'default_on_child' => true, 'description' => esc_html__( 'This controls the transition speed curve of the hover animation.', 'et_builder' ), 'options' => array( 'ease-in-out' => esc_html__( 'Ease-In-Out', 'et_builder' ), 'ease' => esc_html__( 'Ease', 'et_builder' ), 'ease-in' => esc_html__( 'Ease-In', 'et_builder' ), 'ease-out' => esc_html__( 'Ease-Out', 'et_builder' ), 'linear' => esc_html__( 'Linear', 'et_builder' ), ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'hover_transitions', 'depends_default' => null, ); $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } /** * Add CSS filter controls (i.e. saturation, brightness, opacity) to the `_additional_fields_options` array. * * @return void */ protected function _add_filter_fields() { // Filter fields are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['filters'] = self::$_->array_get( $this->advanced_fields, 'filters', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Module has to explicitly set false to disable filters options if ( false === self::$_->array_get( $this->advanced_fields, 'filters', false ) ) { return; } $filter_settings = self::$_->array_get( $this->advanced_fields, 'filters' ); $tab_slug = self::$_->array_get( $filter_settings, 'tab_slug', 'advanced' ); $toggle_slug = self::$_->array_get( $filter_settings, 'toggle_slug','filters' ); $toggle_name = self::$_->array_get( $filter_settings, 'toggle_name', esc_html__( 'Filters', 'et_builder' ) ); $this->_add_settings_modal_toggles( $tab_slug, array( $toggle_slug => array( 'title' => $toggle_name, 'priority' => 105, ), ) ); $additional_options = array(); $additional_options['filter_hue_rotate'] = array( 'label' => esc_html__( 'Hue', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 359, 'step' => 1, ), 'default' => '0deg', 'default_on_child' => true, 'description' => esc_html__( 'Shift all colors by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => 'deg', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_saturate'] = array( 'label' => esc_html__( 'Saturation', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how intense the color saturation should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_brightness'] = array( 'label' => esc_html__( 'Brightness', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how bright the colors should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_contrast'] = array( 'label' => esc_html__( 'Contrast', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how distinct bright and dark areas should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_invert'] = array( 'label' => esc_html__( 'Invert', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '0%', 'default_on_child' => true, 'description' => esc_html__( 'Invert the hue, saturation, and brightness by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_sepia'] = array( 'label' => esc_html__( 'Sepia', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '0%', 'default_on_child' => true, 'description' => esc_html__( 'Travel back in time by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_opacity'] = array( 'label' => esc_html__( 'Opacity', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how transparent or opaque this should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['filter_blur'] = array( 'label' => esc_html__( 'Blur', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 50, 'step' => 1, ), 'default' => '0px', 'default_unit' => 'px', 'default_on_child' => true, 'description' => esc_html__( 'Blur by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => 'px', 'fixed_range' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, 'hover' => 'tabs', ); $additional_options['mix_blend_mode'] = array( 'label' => esc_html__( 'Blend Mode', 'et_builder' ), 'type' => 'select', 'option_category' => 'layout', 'default' => 'normal', 'default_on_child' => true, 'description' => esc_html__( 'Modify how this element blends with any layers beneath it. To reset, choose the "Normal" option.' ), 'options' => array( 'normal' => esc_html__( 'Normal', 'et_builder' ), 'multiply' => esc_html__( 'Multiply', 'et_builder' ), 'screen' => esc_html__( 'Screen', 'et_builder' ), 'overlay' => esc_html__( 'Overlay', 'et_builder' ), 'darken' => esc_html__( 'Darken', 'et_builder' ), 'lighten' => esc_html__( 'Lighten', 'et_builder' ), 'color-dodge' => esc_html__( 'Color Dodge', 'et_builder' ), 'color-burn' => esc_html__( 'Color Burn', 'et_builder' ), 'hard-light' => esc_html__( 'Hard Light', 'et_builder' ), 'soft-light' => esc_html__( 'Soft Light', 'et_builder' ), 'difference' => esc_html__( 'Difference', 'et_builder' ), 'exclusion' => esc_html__( 'Exclusion', 'et_builder' ), 'hue' => esc_html__( 'Hue', 'et_builder' ), 'saturation' => esc_html__( 'Saturation', 'et_builder' ), 'color' => esc_html__( 'Color', 'et_builder' ), 'luminosity' => esc_html__( 'Luminosity', 'et_builder' ), ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'reset_animation' => false, ); $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); // Maybe add child filters (i.e. targeting only images within a module) if ( ! isset( $this->advanced_fields['filters']['child_filters_target'] ) ) { return; } $child_filter = $this->advanced_fields['filters']['child_filters_target']; $additional_child_options = array( 'child_filter_hue_rotate' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Hue', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 359, 'step' => 1, ), 'default' => '0deg', 'default_on_child' => true, 'description' => esc_html__( 'Shift all colors by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => 'deg', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_saturate' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Saturation', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how intense the color saturation should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_brightness' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Brightness', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how bright the colors should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_contrast' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Contrast', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 200, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how distinct bright and dark areas should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_invert' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Invert', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '0%', 'default_on_child' => true, 'description' => esc_html__( 'Invert the hue, saturation, and brightness by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_sepia' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Sepia', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '0%', 'default_on_child' => true, 'description' => esc_html__( 'Travel back in time by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_opacity' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Opacity', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => '100%', 'default_on_child' => true, 'description' => esc_html__( 'Define how transparent or opaque this should be.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_filter_blur' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Blur', 'et_builder' ), 'type' => 'range', 'option_category' => 'layout', 'range_settings' => array( 'min' => 0, 'max' => 50, 'step' => 1, ), 'default' => '0px', 'default_on_child' => true, 'description' => esc_html__( 'Blur by this amount.', 'et_builder' ), 'validate_unit' => true, 'fixed_unit' => 'px', 'fixed_range' => true, 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), 'child_mix_blend_mode' => array( 'label' => esc_html__( 'Image', 'et_builder' ) . ' ' . esc_html__( 'Blend Mode', 'et_builder' ), 'type' => 'select', 'option_category' => 'layout', 'default' => 'normal', 'default_on_child' => true, 'description' => esc_html__( 'Modify how this element blends with any layers beneath it. To reset, choose the "Normal" option.' ), 'options' => array( 'normal' => esc_html__( 'Normal', 'et_builder' ), 'multiply' => esc_html__( 'Multiply', 'et_builder' ), 'screen' => esc_html__( 'Screen', 'et_builder' ), 'overlay' => esc_html__( 'Overlay', 'et_builder' ), 'darken' => esc_html__( 'Darken', 'et_builder' ), 'lighten' => esc_html__( 'Lighten', 'et_builder' ), 'color-dodge' => esc_html__( 'Color Dodge', 'et_builder' ), 'color-burn' => esc_html__( 'Color Burn', 'et_builder' ), 'hard-light' => esc_html__( 'Hard Light', 'et_builder' ), 'soft-light' => esc_html__( 'Soft Light', 'et_builder' ), 'difference' => esc_html__( 'Difference', 'et_builder' ), 'exclusion' => esc_html__( 'Exclusion', 'et_builder' ), 'hue' => esc_html__( 'Hue', 'et_builder' ), 'saturation' => esc_html__( 'Saturation', 'et_builder' ), 'color' => esc_html__( 'Color', 'et_builder' ), 'luminosity' => esc_html__( 'Luminosity', 'et_builder' ), ), 'tab_slug' => $child_filter['tab_slug'], 'toggle_slug' => $child_filter['toggle_slug'], 'reset_animation' => false, 'hover' => 'tabs', ), ); if ( isset( $child_filter['depends_show_if'] ) ) { foreach ( $additional_child_options as $option => $value ) { $additional_child_options[ $option ]['depends_show_if'] = $child_filter['depends_show_if']; } } $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_child_options ); } /** * Add the divider options to the additional_fields_options array. */ protected function _add_divider_fields() { if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } // Make sure we only add this to sections. if ( 'et_pb_section' !== $this->slug ) { return; } $tab_slug = 'advanced'; $toggle_slug = 'dividers'; $divider_toggle = array( $toggle_slug => array( 'title' => esc_html__( 'Dividers', 'et_builder' ), 'priority' => 65, ), ); // Add the toggle sections. $this->_add_settings_modal_toggles( $tab_slug, $divider_toggle ); if ( ! isset( $this->advanced_fields['dividers'] ) ) { $this->advanced_fields['dividers'] = array(); } $additional_options = ET_Builder_Module_Fields_Factory::get( 'Divider' )->get_fields( array( 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ) ); // Return our merged options and toggles. $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } /** * Add additional Text Shadow fields to all modules */ protected function _add_text_shadow_fields() { // Get text shadow settings. Fallback to default if needed $this->advanced_fields['text_shadow'] = self::$_->array_get( $this->advanced_fields, 'text_shadow', array( 'default' => array(), ) ); // Text shadow settings have to be array if ( ! is_array( $this->advanced_fields['text_shadow'] ) ) { return; } // Loop test settings, do multiple text shadow field declaration in one palce foreach ( $this->advanced_fields['text_shadow'] as $text_shadow_name => $text_shadow_fields ) { // Enable module to disable text shadow. Also disable text shadow if no text group is // found because default text shadow lives on text group if ( 'default' === $text_shadow_name && ( false === $text_shadow_fields || empty( $this->settings_modal_toggles['advanced']['toggles']['text'] ) ) ) { return; } if ( 'default' !== $text_shadow_name ) { // Automatically add prefix and toggle slug $text_shadow_fields['prefix'] = $text_shadow_name; $text_shadow_fields['toggle_slug'] = $text_shadow_name; } // Add text shadow fields $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $this->text_shadow->get_fields( $text_shadow_fields ) ); } } /** * Add box shadow fields based on configuration on $this->advanced_fields['box_shadow'] * * @since 3.1 */ protected function _add_box_shadow_fields() { // Box shadow fields are added by default to all modules $this->advanced_fields['box_shadow'] = self::$_->array_get( $this->advanced_fields, 'box_shadow', array( 'default' => array(), ) ); // Box shadow settings have to be array if ( ! is_array( $this->advanced_fields['box_shadow'] ) ) { return; } // Loop box shadow settings foreach ( $this->advanced_fields['box_shadow'] as $fields_name => $settings ) { // Enable module to disable box shadow if ( false === $settings ) { continue; } $is_box_shadow_default = 'default' === $fields_name; // Add Box Shadow toggle for default Box Shadow fields if ( $is_box_shadow_default ) { $this->settings_modal_toggles['advanced']['toggles']['box_shadow'] = array( 'title' => esc_html__( 'Box Shadow', 'et_builder' ), 'priority' => 100, ); } // Ensure box settings has minimum settings required $settings = wp_parse_args( $settings, array( 'option_category' => 'layout', 'tab_slug' => 'advanced', 'toggle_slug' => 'box_shadow', ) ); // Automatically add suffix attribute $settings['suffix'] = $is_box_shadow_default ? '' : "_{$fields_name}"; // Add default Box Shadow fields $this->_additional_fields_options = array_merge( $this->_additional_fields_options, ET_Builder_Module_Fields_Factory::get( 'BoxShadow' )->get_fields( $settings ) ); } } public function get_transition_box_shadow_fields_css_props( $module = 'default' ) { /** * @var ET_Builder_Module_Field_BoxShadow $box_shadow */ $box_shadow = ET_Builder_Module_Fields_Factory::get( 'BoxShadow' ); $selector = self::$_->array_get( $this->advanced_fields, "box_shadow.$module.css.main", '%%order_class%%' ); $overlay = self::$_->array_get( $this->advanced_fields, "box_shadow.$module.css.overlay", false ); $suffix = 'default' == $module ? '' : "_$module"; if ( in_array( $overlay, array( 'inset', 'always' ) ) ) { $selector .= ', ' . $box_shadow->get_overlay_selector( $selector ); } return array( "box_shadow_horizontal{$suffix}" => array( 'box-shadow' => $selector, ), "box_shadow_vertical{$suffix}" => array( 'box-shadow' => $selector, ), "box_shadow_blur{$suffix}" => array( 'box-shadow' => $selector, ), "box_shadow_spread{$suffix}" => array( 'box-shadow' => $selector, ), "box_shadow_color{$suffix}" => array( 'box-shadow' => $selector, ), ); } public function get_transition_text_shadow_fields_css_props( $module = null ) { $source = null == $module ? 'text.css' : "fonts.$module.css"; $default = self::$_->array_get( $this->advanced_fields, "$source.main", '%%order_class%%' ); $selector = self::$_->array_get( $this->advanced_fields, "$source.text_shadow", $default ); $prefix = null == $module ? '' : "{$module}_"; return array( "{$prefix}text_shadow_horizontal_length" => array( 'text-shadow' => $selector, ), "{$prefix}text_shadow_vertical_length" => array( 'text-shadow' => $selector, ), "{$prefix}text_shadow_blur_strength" => array( 'text-shadow' => $selector, ), "{$prefix}text_shadow_color" => array( 'text-shadow' => $selector, ), ); } public function get_transition_filters_fields_css_props( $module = null ) { $slug = empty( $module ) ? 'filter' : 'child_filter'; $source = empty( $module ) ? 'filters.css.main' : "$module.css.main"; $filters = array( 'hue_rotate', 'saturate', 'brightness', 'contrast', 'invert', 'sepia', 'opacity', 'blur', ); $fields = array(); $main = self::$_->array_get( $this->advanced_fields, $source, '%%order_class%%' ); $selector = $module ? self::$_->array_get( $this->advanced_fields, 'filters.child_filters_target.css.main', $main ) : $main; foreach ( $filters as $filter ) { $fields[ "{$slug}_{$filter}" ] = array( 'filter' => $selector, ); } return $fields; } public function get_transition_borders_fields_css_props( $module = 'default' ) { $suffix = 'default' == $module ? '' : "_$module"; $radius = self::$_->array_get( $this->advanced_fields, "borders.$module.css.main.border_radii", '%%order_class%%' ); $style = self::$_->array_get( $this->advanced_fields, "borders.$module.css.main.border_styles", '%%order_class%%' ); return array( "border_radii{$suffix}" => array( 'border-radius' => implode( ', ', array( $radius, ) ) ), "border_width_all{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_color_all{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_width_top{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_color_top{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_width_right{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_color_right{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_width_bottom{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_color_bottom{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_width_left{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), "border_color_left{$suffix}" => array( 'border' => implode( ', ', array( $style, ) ), ), ); } public function get_transition_margin_padding_fields_css_props( $module = null ) { $key = empty($module) ? '' : "$module."; $suffix = empty($module) ? '' : "_$module"; $margin = self::$_->array_get( $this->advanced_fields, "margin_padding.{$key}css.margin", '%%order_class%%' ); $padding = self::$_->array_get( $this->advanced_fields, "margin_padding.{$key}css.padding", '%%order_class%%' ); return array( "custom_margin{$suffix}" => array( 'margin' => implode( ', ', array( $margin, ) ) ), "custom_padding{$suffix}" => array( 'padding' => implode( ', ', array( $padding, ) ), ), ); } public function get_transition_font_fields_css_props() { $items = self::$_->array_get( $this->advanced_fields, 'fonts' ); if ( !is_array( $items ) ) { return array(); } $font_options = array( array( 'option' => 'text_color', 'slug' => 'color', 'prop' => 'color', ), array( 'option' => 'font_size', 'slug' => 'font_size', 'prop' => 'font-size', ), array( 'option' => 'line_height', 'slug' => 'line_height', 'prop' => 'line-height', ), array( 'option' => 'letter_spacing', 'slug' => 'letter_spacing', 'prop' => 'letter-spacing', ), array( 'option' => 'text_shadow_horizontal_length', 'slug' => 'text_shadow', 'prop' => 'text-shadow', ), array( 'option' => 'text_shadow_vertical_length', 'slug' => 'text_shadow', 'prop' => 'text-shadow', ), array( 'option' => 'text_shadow_blur_strength', 'slug' => 'text_shadow', 'prop' => 'text-shadow', ), array( 'option' => 'text_shadow_color', 'slug' => 'text_shadow', 'prop' => 'text-shadow', ), ); $fields = array(); foreach ( $items as $item => $field ) { foreach ( $font_options as $key ) { $fields["{$item}_{$key['option']}"] = array( $key['prop'] => self::$_->array_get( $field, "css.{$key['slug']}", self::$_->array_get( $field, 'css.main', '%%order_class%%' ) ) ); } } return $fields; } public function get_transition_image_fields_css_props() { $fields = array(); $fields = array_merge( $this->get_transition_filters_fields_css_props( 'image' ), $fields ); $fields = array_merge( $this->get_transition_borders_fields_css_props( 'image' ), $fields ); $fields = array_merge( $this->get_transition_box_shadow_fields_css_props( 'image' ), $fields ); return $fields; } public function get_transition_button_fields_css_props() { $buttons = self::$_->array_get( $this->advanced_fields, 'button', array() ); $fields = array(); if ( empty( $buttons ) ) { return array(); } foreach ( $buttons as $key => $button ) { $selector = self::$_->array_get( $button, 'css.main', '%%order_class%%' ); $field = array( "{$key}_text_color" => array( 'color' => $selector, ), "{$key}_text_size" => array( 'font-size' => $selector, 'line-height' => $selector, 'padding' => $selector, ), "{$key}_bg_color" => array( 'background-color' => $selector, ), "{$key}_border_width" => array( 'border' => $selector, ), "{$key}_border_color" => array( 'border' => $selector, ), "{$key}_border_radius" => array( 'border-radius' => $selector, ), "{$key}_letter_spacing" => array( 'letter-spacing' => $selector, ), "{$key}text_shadow_horizontal_length" => array( 'text-shadow' => $selector, ), "{$key}text_shadow_vertical_length" => array( 'text-shadow' => $selector, ), "{$key}text_shadow_blur_strength" => array( 'text-shadow' => $selector, ), "{$key}text_shadow_color" => array( 'text-shadow' => $selector, ), "box_shadow_style_$key" => array( 'box-shadow' => implode( ', ', array( $selector, $this->add_suffix_to_selectors( ' > .box-shadow-overlay', $selector ), ) ), ), ); $fields = array_merge( $fields, $field ); } return $fields; } public function get_transition_gutter_fields_css_props() { $gutter_selector = 'et_pb_section' === $this->slug ? '%%order_class%% .et_pb_gutter_hover *' : '%%order_class%%.et_pb_gutter_hover *'; // animate width, padding and margin if gutter width has hover options return array( 'gutter_width' => array( 'width' => $gutter_selector, 'margin' => $gutter_selector, 'padding' => $gutter_selector, ) ); } public function get_transition_fields_css_props() { $default = $this->main_css_element; $text_main = self::$_->array_get( $this->advanced_fields, 'text.css.main', $default ); $fields = array( 'background_layout' => array( 'color' => $text_main, ), 'background' => array( 'background-color' => self::$_->array_get( $this->advanced_fields, 'background.css.main', $default ), ), 'max_width' => array( 'max-width' => $default, ), 'text_color' => array( 'color' => self::$_->array_get( $this->advanced_fields, 'text.css.color', $text_main ), ), ); $fields = array_merge( $this->get_transition_filters_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_box_shadow_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_text_shadow_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_image_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_borders_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_margin_padding_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_button_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_font_fields_css_props(), $fields ); $fields = array_merge( $this->get_transition_gutter_fields_css_props(), $fields ); return apply_filters( 'et_builder_hover_transitions_map', $fields ); } /** * Add link options fields to all modules * * @since 3.15.1 */ protected function _add_link_options_fields() { // Link Options are added by default if module has partial or full VB support if ( $this->has_vb_support() ) { $this->advanced_fields['link_options'] = self::$_->array_get( $this->advanced_fields, 'link_options', array() ); } else if ( ! $this->has_advanced_fields ) { // Disable if module doesn't set advanced_fields property and has no VB support return; } // Link options settings have to be array if ( ! is_array( self::$_->array_get( $this->advanced_fields, 'link_options' ) ) ) { return; } $this->settings_modal_toggles['general']['toggles']['link_options'] = array( 'title' => esc_html__( 'Link', 'et_builder' ), 'priority' => 70, ); $additional_options = array(); // Translate the whole label as a phrase instead of replacing placeholder with section / row / module translation // Less error prone for translator and the translation. Phrase might be structured differently in some language switch ( $this->slug ) { case 'et_pb_section': $url_label = esc_html__( 'Section Link URL', 'et_builder' ); $target_label = esc_html__( 'Section Link Target', 'et_builder' ); break; case 'et_pb_row': case 'et_pb_row_inner': $url_label = esc_html__( 'Row Link URL', 'et_builder' ); $target_label = esc_html__( 'Row Link Target', 'et_builder' ); break; default: $url_label = esc_html__( 'Module Link URL', 'et_builder' ); $target_label = esc_html__( 'Module Link Target', 'et_builder' ); break; } $additional_options['link_option_url'] = array( 'label' => $url_label, 'type' => 'text', 'toggle_slug' => 'link_options', 'description' => esc_html__( 'When clicked the module will link to this URL.', 'et_builder' ), 'dynamic_content' => 'url', ); $additional_options['link_option_url_new_window'] = array( 'label' => $target_label, 'type' => 'select', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'In The Same Window', 'et_builder' ), 'on' => esc_html__( 'In The New Tab', 'et_builder' ), ), 'toggle_slug' => 'link_options', 'description' => esc_html__( 'Here you can choose whether or not your link opens in a new window', 'et_builder' ), 'default_on_front' => 'off', ); $this->_additional_fields_options = array_merge( $this->_additional_fields_options, $additional_options ); } function setup_hover_transitions( $function_name ) { // List of all property names and their respective CSS property names $transitions_map = $this->get_transition_fields_css_props(); $selectors = array(); $transitions = array(); $hover = et_pb_hover_options(); // We need to loop transitions array so cases of prefixed prop names can also be caught foreach ( $transitions_map as $prop_name => $css_props ) { // To build a proper regex "{prefix}" is replaced with ".*?" as it might not always be present $prop_name_regexed = str_replace( '{slug}', '.*?', $prop_name ); $match_regex = "~^{$prop_name_regexed}{$hover->get_enabled_suffix()}$~"; // Get a list of props matching the pattern above (should never be more than one match actually) $prop_matches = preg_grep( $match_regex, array_keys( $this->props ) ); if ( empty( $prop_matches ) ) { continue; } // Reset the array keys to make sure the first (and only) match is $prop_matches[0] $prop_matches = array_values( $prop_matches ); // Continue if somehow {property_name}__hover_enabled is not "on" if ( 'on' !== $this->props[ $prop_matches[0] ] ) { continue; } // Add the CSS property for the transition $transitions = array_merge( $transitions, array_keys( $css_props ) ); foreach ( $css_props as $selector ) { $selector = is_array( $selector ) ? $selector : array( $selector ); $selectors = array_merge( $selectors, $selector ); } } // Don't apply transitions if none are needed if ( empty( $transitions ) ) { return; } // Create a separate transition definition for each needed transition to avoid using "all" $transition_css = array(); $duration = et_pb_transition_options()->get_duration( $this->props ); $easing = et_pb_transition_options()->get_easing( $this->props ); $delay = et_pb_transition_options()->get_delay( $this->props ); foreach ( array_unique( $transitions ) as $transition ) { $transition_css[] = "{$transition} {$duration} {$easing} {$delay}"; $transition_css[] = sprintf( '%1$s %2$s %3$s %4$s', esc_attr($transition), esc_attr($duration), esc_attr($easing), esc_attr($delay) ); } $transition_declaration = 'transition: ' . implode( ', ', $transition_css ) . ';'; self::set_style( $function_name, array( 'selector' => implode( ', ', array_unique( $selectors ) ), 'declaration' => esc_html( $transition_declaration ) ) ); } protected function _add_custom_css_fields() { if ( isset( $this->custom_css_tab ) && ! $this->custom_css_tab ) { return; } $custom_css_fields_processed = array(); $current_module_unique_class = '.' . $this->slug . '_' . "<%= typeof( module_order ) !== 'undefined' ? module_order : '' %>"; $main_css_element_output = isset( $this->main_css_element ) ? $this->main_css_element : '%%order_class%%'; $main_css_element_output = str_replace( '%%order_class%%', $current_module_unique_class, $main_css_element_output ); $custom_css_default_options = array( 'before' => array( 'label' => esc_html__( 'Before', 'et_builder' ), 'selector' => ':before', 'no_space_before_selector' => true, ), 'main_element' => array( 'label' => esc_html__( 'Main Element', 'et_builder' ), ), 'after' => array( 'label' => esc_html__( 'After', 'et_builder' ), 'selector' => ':after', 'no_space_before_selector' => true, ), ); $custom_css_fields = apply_filters( 'et_default_custom_css_fields', $custom_css_default_options ); if ( $this->custom_css_fields = $this->get_custom_css_fields_config() ) { $custom_css_fields = array_merge( $custom_css_fields, $this->custom_css_fields ); } $this->custom_css_fields = apply_filters( 'et_custom_css_fields_' . $this->slug, $custom_css_fields ); // optional settings names in custom css options $additional_option_slugs = array( 'description', 'priority' ); foreach ( $custom_css_fields as $slug => $option ) { $selector_value = isset( $option['selector'] ) ? $option['selector'] : ''; $selector_contains_module_class = false !== strpos( $selector_value, '%%order_class%%' ) ? true : false; $selector_output = '' !== $selector_value ? str_replace( '%%order_class%%', $current_module_unique_class, $option['selector'] ) : ''; $custom_css_fields_processed[ "custom_css_{$slug}" ] = array( 'label' => sprintf( '%1$s:%2$s%3$s%4$s', $option['label'], ! $selector_contains_module_class ? $main_css_element_output : '', ! isset( $option['no_space_before_selector'] ) && isset( $option['selector'] ) ? ' ' : '', $selector_output ), 'type' => 'custom_css', 'tab_slug' => 'custom_css', 'toggle_slug' => 'custom_css', 'no_colon' => true, ); // update toggle slug for $this->custom_css_fields $this->custom_css_fields[ $slug ]['toggle_slug'] = 'custom_css'; // add optional settings if needed foreach ( $additional_option_slugs as $option_slug ) { if ( isset( $option[ $option_slug ] ) ) { $custom_css_fields_processed[ "custom_css_{$slug}" ][ $option_slug ] = $option[ $option_slug ]; } } } if ( ! empty( $custom_css_fields_processed ) ) { $this->fields_unprocessed = array_merge( $this->fields_unprocessed, $custom_css_fields_processed ); } $default_custom_css_toggles = array( 'classes' => esc_html__( 'CSS ID & Classes', 'et_builder' ), 'custom_css' => esc_html__( 'Custom CSS', 'et_builder' ), ); $this->_add_settings_modal_toggles( 'custom_css', $default_custom_css_toggles ); } protected function _add_settings_modal_toggles( $tab_slug, $toggles_array ) { if ( ! isset( $this->settings_modal_toggles[ $tab_slug ] ) ) { $this->settings_modal_toggles[ $tab_slug ] = array(); } if ( ! isset( $this->settings_modal_toggles[ $tab_slug ]['toggles'] ) ) { $this->settings_modal_toggles[ $tab_slug ]['toggles'] = array(); } // get the only toggles which do not exist. $processed_toggles = array_diff_key( $toggles_array, $this->settings_modal_toggles[ $tab_slug ]['toggles'] ); $this->settings_modal_toggles[ $tab_slug ]['toggles'] = array_merge( $this->settings_modal_toggles[ $tab_slug ]['toggles'], $processed_toggles ); } private function _get_fields() { $this->fields = array(); $this->fields = $this->fields_unprocessed; $this->fields = $this->process_fields( $this->fields ); $this->fields = apply_filters( 'et_builder_module_fields_' . $this->slug, $this->fields ); foreach ( $this->fields as $field_name => $field ) { $this->fields[ $field_name ] = apply_filters('et_builder_module_fields_' . $this->slug . '_field_' . $field_name, $field ); $this->fields[ $field_name ]['name'] = $field_name; } return $this->fields; } /** * Checks if the field value equals its default value * * @param string $name Field name. * @param mixed $value Field value. * * @return bool */ protected function _is_field_default( $name, $value ) { if ( ! isset( $this->fields_unprocessed[ $name ] ) ) { // field does not exist return false; } $field = $this->fields_unprocessed[ $name ]; $default = self::$_->array_get( $field, 'default', '' ); $default_on_front = self::$_->array_get( $field, 'default_on_front', 'not_found' ); if ( 'not_found' !== $default_on_front ) { return $default_on_front === $value; } if ( is_array( $default ) && ! empty( $default[0] ) && is_array( $default[1] ) ) { // This is a conditional default. Let's try to resolve it. list ( $depend_field, $conditional_defaults ) = $default; $default_key = self::$_->array_get( $this->props, $depend_field, key( $conditional_defaults ) ); $default = self::$_->array_get( $conditional_defaults, $default_key, null ); } return $default === $value; } // intended to be overridden as needed function process_fields( $fields ) { return apply_filters( 'et_pb_module_processed_fields', $fields, $this->slug ); } /** * Get the settings fields data for this element. * * @since 1.0 * @todo Finish documenting return value's structure. * * @return array[] { * Settings Fields * * @type mixed[] $setting_field_key { * Setting Field Data * * @type string $type Setting field type. * @type string $id CSS id for the setting. * @type string $label Text label for the setting. Translatable. * @type string $description Description for the settings. Translatable. * @type string $class Optional. Css class for the settings. * @type string[] $affects Optional. The keys of all settings that depend on this setting. * @type string[] $depends_on Optional. The keys of all settings that this setting depends on. * @type string $depends_show_if Optional. Only show this setting when the settings * on which it depends has a value equal to this. * @type string $depends_show_if_not Optional. Only show this setting when the settings * on which it depends has a value that is not equal to this. * ... * } * ... * } */ function get_fields() { return array(); } /** * Get module defined fields + automatically generated fields * * @internal Added to make get_fields() lighter. Initially added during BFB's 3rd party support * * @return array */ function get_complete_fields() { $fields = $this->get_fields(); $responsive_suffixes = array( 'tablet', 'phone', 'last_edited' ); // Loop fields and modify it if needed foreach ( $fields as $field_name => $field ) { // Automatically generate responsive fields if ( isset( $field['responsive'] ) && $field['responsive'] ) { // Get tab and toggle slugs value $tab_slug = isset( $field['tab_slug'] ) ? $field['tab_slug'] : ''; $toggle_slug = isset( $field['toggle_slug'] ) ? $field['toggle_slug'] : ''; foreach ( $responsive_suffixes as $responsive_suffix ) { $responsive_field_name = "{$field_name}_{$responsive_suffix}"; $fields[ $responsive_field_name ] = array( 'type' => 'skip', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, ); } } } // Add general fields for modules. Don't add them to module item and column if ( ( ! isset( $this->type ) || 'child' !== $this->type ) && 'et_pb_column' !== $this->slug ) { $fields = array_merge( $fields, apply_filters( 'et_builder_module_general_fields', array( 'disabled_on' => array( 'label' => esc_html__( 'Disable on', 'et_builder' ), 'type' => 'multiple_checkboxes', 'options' => array( 'phone' => esc_html__( 'Phone', 'et_builder' ), 'tablet' => esc_html__( 'Tablet', 'et_builder' ), 'desktop' => esc_html__( 'Desktop', 'et_builder' ), ), 'additional_att' => 'disable_on', 'option_category' => 'configuration', 'description' => esc_html__( 'This will disable the module on selected devices', 'et_builder' ), 'tab_slug' => 'custom_css', 'toggle_slug' => 'visibility', ), 'admin_label' => array( 'label' => esc_html__( 'Admin Label', 'et_builder' ), 'type' => 'text', 'description' => esc_html__( 'This will change the label of the module in the builder for easy identification.', 'et_builder' ), 'toggle_slug' => 'admin_label', ), 'module_id' => array( 'label' => esc_html__( 'CSS ID', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'tab_slug' => 'custom_css', 'toggle_slug' => 'classes', 'option_class' => 'et_pb_custom_css_regular', ), 'module_class' => array( 'label' => esc_html__( 'CSS Class', 'et_builder' ), 'type' => 'text', 'option_category' => 'configuration', 'tab_slug' => 'custom_css', 'toggle_slug' => 'classes', 'option_class' => 'et_pb_custom_css_regular', ), ) ) ); } return $fields; } /** * Get configuration for module's advanced fields. This method is meant to be overridden in module classes. * * @since 3.1 * * @return array[] {@see self::$advanced_fields} */ public function get_advanced_fields_config() { return $this->advanced_fields; } /** * Get configuration for module's custom css fields. This method is meant to be overridden in module classes. * * @since 3.1 * * @return array[] {@see self::$custom_css_fields} */ public function get_custom_css_fields_config() { return $this->custom_css_fields; } /** * Get custom tabs for the module's settings modal. This method is meant to be overridden in module classes. * * @since 3.1 * * @return array[] {@see self::$settings_modal_tabs} */ public function get_settings_modal_tabs() { return $this->settings_modal_tabs; } /** * Get toggles for the module's settings modal. This method is meant to be overridden in module classes. * * @since 3.1 * * @return array[] {@see self::$settings_modal_toggles} */ public function get_settings_modal_toggles() { return $this->settings_modal_toggles; } /** * Generate column fields. * * @param number $column_number number of column * @param array $base_fields base fields for column * * @return array column fields */ function get_column_fields( $column_number = 1, $base_fields = array() ) { $fields = array(); // Loop column's base fields foreach ( $base_fields as $field_name => $field ) { // Loop (number of column) times for ( $index = 1; $index <= $column_number; $index++ ) { // Some attribute's id is not located at the bottom of the attribute name if ( isset( $field['has_custom_index_location'] ) && $field['has_custom_index_location'] ) { $column_name = str_replace( '%column_index%', $index, $field_name ); } else { $column_name = "{$field_name}_{$index}"; } $fields[ $column_name ] = array( 'type' => 'skip', ); // Most column field is an empty-type attribute. Non-empty attribute are likely // attribute for computed field which needs to have suffix ID if ( ! empty( $field ) ) { // Append suffix to the module variable foreach ( $field as $attr_name => $attr_value ) { if ( 'has_custom_index_location' === $attr_name ) { continue; } if ( is_array( $attr_value ) && 'computed_callback' !== $attr_name ) { $attr_value = $this->_append_suffix( $attr_value, $index ); } $fields[ $column_name ][ $attr_name ] = $attr_value; } } } } return $fields; } /** * Append suffix to simple array value * * @param array $values array value * @param string $suffix intended suffix for output's array * * @return array suffixed value */ function _append_suffix( $values, $suffix ) { $output = array(); foreach ( $values as $value ) { $output[] = "{$value}_{$suffix}"; } return $output; } /** * Returns module style priority. * * @return int */ function get_style_priority() { return $this->_style_priority; } function get_post_type() { global $post, $et_builder_post_type; if ( isset( $_POST['et_post_type'] ) && ! $et_builder_post_type ) { // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification $et_builder_post_type = sanitize_text_field( $_POST['et_post_type'] ); } if ( is_a( $post, 'WP_POST' ) && ( is_admin() || ! isset( $et_builder_post_type ) ) ) { return $post->post_type; } else { return isset( $et_builder_post_type ) ? $et_builder_post_type : 'post'; } } static function optimize_bb_chunk( $content ) { if ( ! ET_BUILDER_OPTIMIZE_TEMPLATES ) { return $content; } return str_replace( self::$_unique_bb_strip, '', $content ); } static function get_unique_bb_key( $content ) { if ( ! ET_BUILDER_OPTIMIZE_TEMPLATES ) { return $content; } $content = self::optimize_bb_chunk( $content ); if ( isset( self::$_unique_bb_keys_map[ $content ] ) ) { $key = self::$_unique_bb_keys_map[ $content ]; } else { self::$_unique_bb_keys_values[] = $content; $key = count( self::$_unique_bb_keys_values ) - 1; self::$_unique_bb_keys_map[ $content ] = $key; } $content = ""; return $content; } function wrap_settings_option( $option_output, $field, $name = '' ) { $depends = false; $new_depends = isset( $field['show_if'] ) || isset( $field['show_if_not'] ); $depends_attr = ''; if ( isset( $field['depends_show_if'] ) || isset( $field['depends_show_if_not'] ) ) { $depends = true; if ( isset( $field['depends_show_if_not'] ) ) { $depends_show_if_not = is_array( $field['depends_show_if_not'] ) ? implode( ',', $field['depends_show_if_not'] ) : $field['depends_show_if_not']; $depends_attr = sprintf( ' data-depends_show_if_not="%s"', esc_attr( $depends_show_if_not ) ); } else { $depends_attr = sprintf( ' data-depends_show_if="%s"', esc_attr( $field['depends_show_if'] ) ); } } if ( isset( $field['depends_on_responsive'] ) ) { $depends_attr .= sprintf( ' data-depends_on_responsive="%s"', esc_attr( implode( ',', $field['depends_on_responsive'] ) ) ); } // Overriding background color's attribute, turning it into appropriate background attributes if ( isset( $field['type'] ) && isset( $field['name' ] ) && 'background_color' === $field['name'] && ! self::$_->array_get( $field, 'skip_background_ui' ) ) { $field['type'] = 'background'; // Removing depends default variable which hides background color for unified background field UI if ( isset( $field['depends_show_if'] ) ) { unset( $field['depends_show_if'] ); } } $output = sprintf( '%6$s
%5$s
%7$s', ( ! empty( $field['type'] ) && 'tiny_mce' === $field['type'] ? ' et-pb-option-main-content' : '' ), $depends || $new_depends ? ' et-pb-depends' : '', ( ! empty( $field['type'] ) && 'hidden' === $field['type'] ? ' et_pb_hidden' : '' ), ( $depends ? $depends_attr : '' ), "\n\t\t\t\t" . $option_output . "\n\t\t\t", "\t", "\n\n\t\t", ( ! empty( $field['type'] ) && 'hidden' === $field['type'] ? esc_attr( sprintf( ' et-pb-option-%1$s', $field['name'] ) ) : '' ), ( ! empty( $field['option_class'] ) ? ' ' . $field['option_class'] : '' ), isset( $field['type'] ) ? esc_attr( $field['type'] ) : '', esc_attr( $field['name'] ), isset( $field['specialty_only'] ) && 'yes' === $field['specialty_only'] ? ' et-pb-specialty-only-option' : '' ); if ( ! empty( $field['hover'] ) ) { if ( 'tabs' === $field['hover'] ) { $this->last_hover_tab_field = $name; } $hover = $this->last_hover_tab_field; if ( $hover ) { $begin = '
includes( $field['taxonomy_name'], 'product' ) ) { $renderer_method = 'et_builder_include_categories_shop_option'; } else { $renderer_method = 'et_builder_include_categories_option'; } break; case 'select_sidebar' : $renderer_method = 'et_builder_get_widget_areas'; break; case 'select_icon' : if ( isset( $field['renderer_options'] ) && isset( $field['renderer_options']['icons_list'] ) && 'icon_down' === $field['renderer_options']['icons_list'] ) { $renderer_method = 'et_pb_get_font_down_icon_list'; } else { $renderer_method = 'et_pb_get_font_icon_list'; } $renderer_with_field = true; break; case 'upload_gallery' : $renderer_method = 'et_builder_get_gallery_settings'; break; case 'center_map' : $renderer_method = 'et_builder_generate_center_map_setting'; break; case 'border-radius' : $renderer_method = array( 'class' => 'ET_Builder_Module_Field_Template_Border_Radius', ); break; case 'composite' : if ( isset( $field['composite_type'] ) && 'default' === $field['composite_type'] ) { $renderer_method = array( 'class' => 'ET_Builder_Module_Field_Template_Tabbed', ); } else if ( isset( $field['composite_type'] ) && 'tabbed' === $field['composite_type'] && 'border' === $field['option_category'] ) { $renderer_method = array( 'class' => 'ET_Builder_Module_Field_Template_Border_Styles', ); } break; } } if ( '' !== $renderer_method ) { $renderer_data = array( 'renderer' => $renderer_method, 'renderer_options' => isset( $field['renderer_options'] ) ? $field['renderer_options'] : array(), 'renderer_with_field' => $renderer_with_field, ); } return apply_filters( 'et_bb_field_renderer_data', $renderer_data, $field ); } /** * Prepare module field (option) for use within BB microtemplates. * The own field renderer can be used. * @param $field Module field * * @return mixed|string Html code of the field */ public function wrap_settings_option_field( $field, $name = '' ) { $use_container_wrapper = isset( $field['use_container_wrapper'] ) && ! $field['use_container_wrapper'] ? false : true; $field_renderer = $this->get_field_renderer( $field ); if ( ! empty( $field_renderer ) && is_array( $field_renderer['renderer'] ) && ! empty( $field_renderer['renderer']['class'] ) ) { //cut off 'ET_Builder_Module_Field_Template_' part from renderer definition $class_name_without_prefix = strtolower ( str_replace ("ET_Builder_Module_Field_Template_", "", $field_renderer['renderer']['class'] ) ); //split class name string by underscore symbol $file_name_parts = explode( '_', $class_name_without_prefix ); if ( ! empty( $file_name_parts ) ) { //the first symbol of class name must be uppercase $last_index = count( $file_name_parts ) - 1; $file_name_parts[$last_index] = ucwords( $file_name_parts[$last_index] ); //load renderer class from 'module/field/template/' directory accordingly class name and class directory hierarchy require_once ET_BUILDER_DIR . 'module/field/template/' . implode( DIRECTORY_SEPARATOR, $file_name_parts ) . '.php'; $renderer = new $field_renderer['renderer']['class']; //before calling the 'render' method make sure the instantiated class is child of 'ET_Builder_Module_Field_Template_Base' if ( is_subclass_of( $field_renderer['renderer']['class'], "ET_Builder_Module_Field_Template_Base" ) ) { $field_el = call_user_func( array( $renderer, "render" ), $field, $this ); } } } else if ( ! empty( $field_renderer ) ) { $renderer_options = ! empty( $field_renderer['renderer_options'] ) ? $field_renderer['renderer_options'] : $field; $field_el = is_callable( $field_renderer['renderer'] ) ? call_user_func( $field_renderer['renderer'], $renderer_options ) : $field_renderer['renderer']; if ( ! empty( $field_renderer['renderer_with_field'] ) && $field_renderer['renderer_with_field'] ) { $field_el .= $this->render_field( $field, $name ); } } else { $field_el = $this->render_field( $field, $name ); } $description = ! empty( $field['description'] ) ? sprintf( '%2$s

%1$s

', $field['description'], "\n\t\t\t\t\t" ) : ''; if ( '' === $description && ! $use_container_wrapper ) { $output = $field_el; } else { $output = sprintf( '%3$s
%1$s %2$s %4$s
', $field_el, $description, "\n\n\t\t\t\t", "\t", ( isset( $field['type'] ) && 'custom_css' === $field['type'] ? ' et-pb-custom-css-option' : '' ), isset( $field['type'] ) ? esc_attr( $field['type'] ) : '' ); } $dynamic_content_notice = et_get_safe_localization( sprintf( __( 'This field contains a dynamic value which requires the Visual Builder. Open Visual Builder', 'et_builder' ), 'et-pb-dynamic-content-fb-switch' ) ); // Conditionally wrap fields depending on whether their values represent dynamic content or not. $output = sprintf( '<%% var isDynamic = typeof %1$s !== \'undefined\' && ET_PageBuilder.isDynamicContent(%1$s); %%> <%% if (isDynamic) { %%>
%2$s
<%% } %%> %3$s <%% if (isDynamic) { %%>
<%% } %%>', et_core_intentionally_unescaped( $this->get_field_variable_name( $field ), 'underscore_template' ), et_core_intentionally_unescaped( $this->get_icon( 'lock' ) . $dynamic_content_notice, 'underscore_template'), et_core_intentionally_unescaped( $output, 'underscore_template' ) ); return $output; } function wrap_settings_option_label( $field ) { if ( ! empty( $field['label'] ) ) { $label = $field['label']; } else { return ''; } $field_name = $this->get_field_name( $field ); if ( isset( $field['type'] ) && 'font' === $field['type'] ) { $field_name .= '_select'; } $required = ! empty( $field['required'] ) ? '*' : ''; $attributes = ! ( isset( $field['type'] ) && in_array( $field['type'], array( 'custom_margin', 'custom_padding' ) ) ) ? sprintf( ' for="%1$s"', esc_attr( $field_name ) ) : ' class="et_custom_margin_label"'; $label = sprintf( '%2$s%4$s %3$s', et_core_esc_previously( $attributes ), et_core_intentionally_unescaped( $label, 'html' ), et_core_intentionally_unescaped( $required, 'fixed_string' ), isset( $field['no_colon'] ) && true === $field['no_colon'] ? '' : ':' ); return $label; } /** * Get svg icon as string * * @param string icon name * * @return string div-wrapped svg icon */ function get_icon( $icon_name ) { $all_svg_icons = et_pb_get_svg_icons_list(); $icon = isset( $all_svg_icons[ $icon_name ] ) ? $all_svg_icons[ $icon_name ] : ''; if ( '' === $icon ) { return ''; } return '
' . $icon . '
'; } /** * Get structure of background UI tabs * * @return array */ function get_background_fields_structure( $base_name = 'background') { $is_background_attr = 'background' === $base_name; $use_background_color_gradient = $is_background_attr ? 'use_background_color_gradient' : "{$base_name}_use_color_gradient"; $prefix = $is_background_attr ? '' : "{$base_name}_"; $structure = array( 'color' => array( "{$base_name}_color", ), 'gradient' => array( "{$base_name}_color_gradient_start", "{$base_name}_color_gradient_end", $use_background_color_gradient, "{$base_name}_color_gradient_type", "{$base_name}_color_gradient_direction", "{$base_name}_color_gradient_direction_radial", "{$base_name}_color_gradient_start_position", "{$base_name}_color_gradient_end_position", "{$base_name}_color_gradient_overlays_image", ), 'image' => array( "{$base_name}_image", "{$prefix}parallax", "{$prefix}parallax_method", "{$base_name}_size", "{$base_name}_position", "{$base_name}_repeat", "{$base_name}_blend", ), 'video' => array( "{$base_name}_video_mp4", "{$base_name}_video_webm", "{$base_name}_video_width", "{$base_name}_video_height", "{$prefix}allow_player_pause", "{$base_name}_video_pause_outside_viewport", ), ); if ( $is_background_attr ) { $structure['color'][] = 'use_background_color'; $structure['image'][] = 'bg_img'; // Column } return $structure; } /** * Get list of background fields names in one dimensional array * * @return array */ function get_background_fields_names() { $background_structure = $this->get_background_fields_structure(); $fields_names = array(); foreach ( $background_structure as $tab_name ) { foreach ( $tab_name as $field_name ) { $fields_names[] = $field_name; } } return $fields_names; } /** * Get / extract background fields from all modules fields * * @param array all modules fields * * @return array background fields multidimensional array grouped based on its tab */ function get_background_fields( $all_fields, $base_name = 'background' ) { $background_fields_structure = $this->get_background_fields_structure( $base_name ); $background_tab_names = array_keys( $background_fields_structure ); $background_fields = array_fill_keys( $background_tab_names, array() ); foreach ( $all_fields as $field_name => $field ) { // Multiple foreaches seem overkill. Use single foreach with little bit if conditions // redundancy to get background fields grouped into multi-dimensional tab-based array if ( in_array( $field_name, $background_fields_structure['color'] ) ) { $background_fields['color'][$field_name] = $field; } if ( in_array( $field_name, $background_fields_structure['gradient'] ) ) { $background_fields['gradient'][$field_name] = $field; } if ( in_array( $field_name, $background_fields_structure['image'] ) ) { $background_fields['image'][$field_name] = $field; } if ( in_array( $field_name, $background_fields_structure['video'] ) ) { $background_fields['video'][$field_name] = $field; } } return $background_fields; } /** * Generate background fields based on base name * * @param string background base name * @param string background tab name * @param string field's tab slug * @param string field's toggle slug * * @return array of background fields */ function generate_background_options( $base_name = 'background', $background_tab, $tab_slug, $toggle_slug, $context = null ) { $baseless_prefix = 'background' === $base_name ? '' : "{$base_name}_"; $options = array(); // Not included on skip background tab because background-field is expected to be registered under "background_color" field if ( in_array( $background_tab, array( 'all', 'button', 'color' ) ) ) { $options["{$base_name}_color"] = array( 'label' => esc_html__( 'Background Color', 'et_builder' ), 'type' => 'color-alpha', 'option_category' => 'configuration', 'custom_color' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color', 'hover' => 'tabs', ); } if ( in_array( $background_tab, array( 'all', 'button', 'skip', 'gradient' ) ) ) { $use_background_color_gradient_name = 'background' === $base_name ? 'use_background_color_gradient' : "{$base_name}_use_color_gradient"; $options[ $use_background_color_gradient_name ] = array( 'label' => esc_html__( 'Use Background Color Gradient', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'default' => 'off', 'default_on_child' => true, 'affects' => array( "{$base_name}_color_gradient_start", "{$base_name}_color_gradient_end", "{$base_name}_color_gradient_start_position", "{$base_name}_color_gradient_end_position", "{$base_name}_color_gradient_type", "{$base_name}_color_gradient_overlays_image", ), 'description' => '', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'use_color_gradient', ); $options["{$base_name}_color_gradient_start"] = array( 'label' => esc_html__( 'Gradient Start', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'color-alpha', 'option_category' => 'configuration', 'description' => '', 'depends_show_if' => 'on', 'default' => ET_Global_Settings::get_value( 'all_background_gradient_start' ), 'default_on_child' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_start', ); $options["{$base_name}_color_gradient_end"] = array( 'label' => esc_html__( 'Gradient End', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'color-alpha', 'option_category' => 'configuration', 'description' => '', 'depends_show_if' => 'on', 'default' => ET_Global_Settings::get_value( 'all_background_gradient_end' ), 'default_on_child' => true, 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_end', ); $options["{$base_name}_color_gradient_type"] = array( 'label' => esc_html__( 'Gradient Type', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'configuration', 'options' => array( 'linear' => esc_html__( 'Linear', 'et_builder' ), 'radial' => esc_html__( 'Radial', 'et_builder' ), ), 'affects' => array( "{$base_name}_color_gradient_direction", "{$base_name}_color_gradient_direction_radial" ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_type' ), 'default_on_child' => true, 'description' => '', 'depends_show_if' => 'on', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_type', ); $options["{$base_name}_color_gradient_direction"] = array( 'label' => esc_html__( 'Gradient Direction', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 1, 'max' => 360, 'step' => 1, ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_direction' ), 'default_on_child' => true, 'validate_unit' => true, 'fixed_unit' => 'deg', 'fixed_range' => true, 'depends_show_if' => 'linear', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_direction', ); $options["{$base_name}_color_gradient_direction_radial"] = array( 'label' => esc_html__( 'Radial Direction', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'configuration', 'options' => array( 'center' => esc_html__( 'Center', 'et_builder' ), 'top left' => esc_html__( 'Top Left', 'et_builder' ), 'top' => esc_html__( 'Top', 'et_builder' ), 'top right' => esc_html__( 'Top Right', 'et_builder' ), 'right' => esc_html__( 'Right', 'et_builder' ), 'bottom right' => esc_html__( 'Bottom Right', 'et_builder' ), 'bottom' => esc_html__( 'Bottom', 'et_builder' ), 'bottom left' => esc_html__( 'Bottom Left', 'et_builder' ), 'left' => esc_html__( 'Left', 'et_builder' ), ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_direction_radial' ), 'default_on_child' => true, 'description' => '', 'depends_show_if' => 'radial', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_direction_radial', ); $options["{$base_name}_color_gradient_start_position"] = array( 'label' => esc_html__( 'Start Position', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_start_position' ), 'default_on_child' => true, 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'depends_show_if' => 'on', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_start_position', ); $options["{$base_name}_color_gradient_end_position"] = array( 'label' => esc_html__( 'End Position', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'range', 'option_category' => 'configuration', 'range_settings' => array( 'min' => 0, 'max' => 100, 'step' => 1, ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_end_position' ), 'default_on_child' => true, 'validate_unit' => true, 'fixed_unit' => '%', 'fixed_range' => true, 'depends_show_if' => 'on', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_end_position', ); $options["${base_name}_color_gradient_overlays_image"] = array( 'label' => esc_html__( 'Place Gradient Above Background Image', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'default' => ET_Global_Settings::get_value( 'all_background_gradient_overlays_image' ), 'default_on_child' => true, 'description' => esc_html__( 'If enabled, gradient will be positioned on top of background-image', 'et_builder' ), 'depends_show_if' => 'on', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'color_gradient_overlays_image', ); } if ( in_array( $background_tab, array( 'all', 'button', 'skip', 'image' ) ) ) { $options["{$base_name}_image"] = array( 'label' => esc_html__( 'Background Image', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'upload', 'option_category' => 'configuration', 'upload_button_text' => esc_attr__( 'Upload an image', 'et_builder' ), 'choose_text' => esc_attr__( 'Choose a Background Image', 'et_builder' ), 'update_text' => esc_attr__( 'Set As Background', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'image', ); if ( 'button' !== $background_tab ) { $options["${baseless_prefix}parallax"] = array( 'label' => esc_html__( 'Use Parallax Effect', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'default' => 'off', 'default_on_child' => true, 'affects' => array( "${baseless_prefix}parallax_method", "{$base_name}_size", "{$base_name}_position", "{$base_name}_repeat", "{$base_name}_blend", ), 'description' => esc_html__( 'If enabled, your background image will stay fixed as your scroll, creating a fun parallax-like effect.', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'parallax', ); $options["${baseless_prefix}parallax_method"] = array( 'label' => esc_html__( 'Parallax Method', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'configuration', 'options' => array( 'on' => esc_html__( 'True Parallax', 'et_builder' ), 'off' => esc_html__( 'CSS', 'et_builder' ), ), 'default' => self::$_->array_get( $this->advanced_fields, "background.options.{$baseless_prefix}parallax_method.default", 'on' ), 'default_on_child' => true, 'depends_show_if' => 'on', 'description' => esc_html__( 'Define the method, used for the parallax effect.', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'parallax_method', ); } $options["{$base_name}_size"] = array( 'label' => esc_html__( 'Background Image Size', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'layout', 'options' => array( 'cover' => esc_html__( 'Cover', 'et_builder' ), 'contain' => esc_html__( 'Fit', 'et_builder' ), 'initial' => esc_html__( 'Actual Size', 'et_builder' ), ), 'default' => 'cover', 'default_on_child'=> true, 'depends_show_if' => 'off', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'size', ); $options["{$base_name}_position"] = array( 'label' => esc_html__( 'Background Image Position', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'layout', 'options' => array( 'top_left' => esc_html__( 'Top Left', 'et_builder' ), 'top_center' => esc_html__( 'Top Center', 'et_builder' ), 'top_right' => esc_html__( 'Top Right', 'et_builder' ), 'center_left' => esc_html__( 'Center Left', 'et_builder' ), 'center' => esc_html__( 'Center', 'et_builder' ), 'center_right' => esc_html__( 'Center Right', 'et_builder' ), 'bottom_left' => esc_html__( 'Bottom Left', 'et_builder' ), 'bottom_center' => esc_html__( 'Bottom Center', 'et_builder' ), 'bottom_right' => esc_html__( 'Bottom Right', 'et_builder' ), ), 'default' => 'center', 'default_on_child' => true, 'depends_show_if' => 'off', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'position', ); $options["{$base_name}_repeat"] = array( 'label' => esc_html__( 'Background Image Repeat', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'layout', 'options' => array( 'no-repeat' => esc_html__( 'No Repeat', 'et_builder' ), 'repeat' => esc_html__( 'Repeat', 'et_builder' ), 'repeat-x' => esc_html__( 'Repeat X (horizontal)', 'et_builder' ), 'repeat-y' => esc_html__( 'Repeat Y (vertical)', 'et_builder' ), 'space' => esc_html__( 'Space', 'et_builder' ), 'round' => esc_html__( 'Round', 'et_builder' ), ), 'default' => 'no-repeat', 'default_on_child' => true, 'depends_show_if' => 'off', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'repeat', ); $options["{$base_name}_blend"] = array( 'label' => esc_html__( 'Background Image Blend', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'select', 'option_category' => 'layout', 'options' => array( 'normal' => esc_html__( 'Normal', 'et_builder' ), 'multiply' => esc_html__( 'Multiply', 'et_builder' ), 'screen' => esc_html__( 'Screen', 'et_builder' ), 'overlay' => esc_html__( 'Overlay', 'et_builder' ), 'darken' => esc_html__( 'Darken', 'et_builder' ), 'lighten' => esc_html__( 'Lighten', 'et_builder' ), 'color-dodge' => esc_html__( 'Color Dodge', 'et_builder' ), 'color-burn' => esc_html__( 'Color Burn', 'et_builder' ), 'hard-light' => esc_html__( 'Hard Light', 'et_builder' ), 'soft-light' => esc_html__( 'Soft Light', 'et_builder' ), 'difference' => esc_html__( 'Difference', 'et_builder' ), 'exclusion' => esc_html__( 'Exclusion', 'et_builder' ), 'hue' => esc_html__( 'Hue', 'et_builder' ), 'saturation' => esc_html__( 'Saturation', 'et_builder' ), 'color' => esc_html__( 'Color', 'et_builder' ), 'luminosity' => esc_html__( 'Luminosity', 'et_builder' ), ), 'default' => 'normal', 'default_on_child' => true, 'depends_show_if' => 'off', 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'blend', ); } if ( in_array( $background_tab, array( 'all', 'skip', 'video' ) ) ) { $options["{$base_name}_video_mp4"] = array( 'label' => esc_html__( 'Background Video MP4', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'upload', 'option_category' => 'configuration', 'data_type' => 'video', 'upload_button_text' => esc_attr__( 'Upload a video', 'et_builder' ), 'choose_text' => esc_attr__( 'Choose a Background Video MP4 File', 'et_builder' ), 'update_text' => esc_attr__( 'Set As Background Video', 'et_builder' ), 'description' => et_get_safe_localization( __( 'All videos should be uploaded in both .MP4 .WEBM formats to ensure maximum compatibility in all browsers. Upload the .MP4 version here. Important Note: Video backgrounds are disabled from mobile devices. Instead, your background image will be used. For this reason, you should define both a background image and a background video to ensure best results.', 'et_builder' ) ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'computed_affects' => array( "__video_{$base_name}", ), 'field_template' => 'video_mp4', ); $options["{$base_name}_video_webm"] = array( 'label' => esc_html__( 'Background Video Webm', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'upload', 'option_category' => 'configuration', 'data_type' => 'video', 'upload_button_text' => esc_attr__( 'Upload a video', 'et_builder' ), 'choose_text' => esc_attr__( 'Choose a Background Video WEBM File', 'et_builder' ), 'update_text' => esc_attr__( 'Set As Background Video', 'et_builder' ), 'description' => et_get_safe_localization( __( 'All videos should be uploaded in both .MP4 .WEBM formats to ensure maximum compatibility in all browsers. Upload the .WEBM version here. Important Note: Video backgrounds are disabled from mobile devices. Instead, your background image will be used. For this reason, you should define both a background image and a background video to ensure best results.', 'et_builder' ) ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'computed_affects' => array( "__video_{$base_name}", ), 'field_template' => 'video_webm', ); $options["{$base_name}_video_width"] = array( 'label' => esc_html__( 'Background Video Width', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'text', 'option_category' => 'configuration', 'description' => esc_html__( 'In order for videos to be sized correctly, you must input the exact width (in pixels) of your video here.', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'computed_affects' => array( "__video_{$base_name}", ), 'field_template' => 'video_width', ); $options["{$base_name}_video_height"] = array( 'label' => esc_html__( 'Background Video Height', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'text', 'option_category' => 'configuration', 'description' => esc_html__( 'In order for videos to be sized correctly, you must input the exact height (in pixels) of your video here.', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'computed_affects' => array( "__video_{$base_name}", ), 'field_template' => 'video_height', ); $options["${baseless_prefix}allow_player_pause"] = array( 'label' => esc_html__( 'Pause Video When Another Video Plays', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'default' => 'off', 'default_on_child' => true, 'description' => esc_html__( 'Allow video to be paused by other players when they begin playing', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'allow_player_pause', ); $options["${base_name}_video_pause_outside_viewport"] = array( 'label' => esc_html__( 'Pause Video While Not In View', 'et_builder' ), 'type' => 'skip' === $background_tab ? 'skip' : 'yes_no_button', 'option_category' => 'configuration', 'options' => array( 'off' => esc_html__( 'No', 'et_builder' ), 'on' => esc_html__( 'Yes', 'et_builder' ), ), 'default' => 'on', 'default_on_child' => true, 'description' => esc_html__( 'Allow video to be paused while it is not in the visible area.', 'et_builder' ), 'tab_slug' => $tab_slug, 'toggle_slug' => $toggle_slug, 'field_template' => 'video_pause_outside_viewport', ); $options["__video_{$base_name}"] = array( 'type' => 'computed', 'computed_callback' => array( 'ET_Builder_Element', "get_video_background" ), 'computed_depends_on' => array( "{$base_name}_video_mp4", "{$base_name}_video_webm", "{$base_name}_video_width", "{$base_name}_video_height", ), 'computed_minimum' => array( "{$base_name}_video_mp4", "{$base_name}_video_webm", ), 'computed_variables' => array( 'base_name' => $base_name, ), ); } foreach ( $options as &$option ) { $option['context'] = null == $context ? $base_name : $context;; } return $options; } /** * Get string of background fields UI. Used in place of background_color fields UI * * @param array list of all module fields * * @return string background fields UI */ function wrap_settings_background_fields( $all_fields, $base_name = 'background' ) { $tab_structure = $this->get_background_fields_structure( $base_name ); $tab_names = array_keys( $tab_structure ); $background_fields = $this->get_background_fields( $all_fields, $base_name ); // Concatenate background fields UI $background = ''; // Label $background .= sprintf( '', esc_html__( 'Background:', 'et_builder' ) ); // Field wrapper $background .= sprintf( '
', esc_attr( $base_name ) ); $tab_names_processed = array(); foreach ( $tab_names as $tab_nav_name ) { if ( ! empty( $background_fields[ $tab_nav_name ] ) ) { $tab_names_processed[] = sanitize_text_field( $tab_nav_name ); } } // Apply background UI if the module has more than one backgroundFields to avoid 3rd party module's field which uses `background_color` field and incorrectly rendered as background UI if ( count( $tab_names_processed ) < 2 ) { return ''; } // Tab Nav $background .= sprintf( '<%%= window.et_builder.options_template_output("background_tabs_nav",%1$s) %%>', wp_json_encode( $tab_names_processed ) ); // Tabs foreach ( $tab_names as $tab_name ) { $background .= sprintf( '
', esc_attr( $tab_name ) ); // Get tab's fields $tab_fields = $background_fields[ $tab_name ]; // Render gradient tab's preview if ( 'gradient' === $tab_name ) { $background .= '<%= window.et_builder.options_template_output("background_gradient_buttons") %>'; } // Tab's fields foreach ( $tab_fields as $tab_field_name => $tab_field ) { if ( 'skip' === $tab_field['type'] ) { continue; } $preview_class = ''; // Append field name $tab_field['name'] = $tab_field_name; // Append preview class name if ( in_array( $tab_field['name'], array( "{$base_name}_color", "{$base_name}_image", "{$base_name}_url", "{$base_name}_video_mp4", "{$base_name}_video_webm" ) ) ) { $tab_field['has_preview'] = true; $preview_class = ' et-pb-option--has-preview'; } // Prepare field list attribute $depends = false; $depends_attr = ''; if ( isset( $tab_field['depends_show_if'] ) || isset( $tab_field['depends_show_if_not'] ) ) { $depends = true; if ( isset( $tab_field['depends_show_if_not'] ) ) { $depends_show_if_not = is_array( $tab_field['depends_show_if_not'] ) ? implode( ',', $tab_field['depends_show_if_not'] ) : $tab_field['depends_show_if_not']; $depends_attr = sprintf( ' data-depends_show_if_not="%s"', esc_attr( $depends_show_if_not ) ); } else { $depends_attr = sprintf( ' data-depends_show_if="%s"', esc_attr( $tab_field['depends_show_if'] ) ); } } // Append fields UI $background .= sprintf( '
', esc_attr( $tab_field_name ), esc_attr( $preview_class ), $depends_attr, esc_attr( $tab_field['name'] ), $tab_field['name'] === "{$base_name}_color" && 'background' !== $base_name ? 'et-pb-option-main' : 'et-pb-option', isset( $tab_field['field_template'] ) ? esc_attr( $tab_field['field_template'] ) : '' ); // This adds a CSS class based on whether it is `true` or `false` $this->is_background = true; $background .= $this->wrap_settings_option_label( $tab_field ); $background .= $this->wrap_settings_option_field( $tab_field ); $this->is_background = false; $background .= '
'; } $background .= '
'; } // End of field wrapper $background .= '
'; return $background; } function get_field_name( $field ) { $prefix = 'et_pb_'; // Don't add 'et_pb_' prefix to the "Admin Label" field. if ( 'admin_label' === $field['name'] ) { return $field['name']; } // Make sure the prefix is not doubled. if ( strpos( $field['name'], $prefix ) === 0 ) { return $field['name']; } return $prefix . $field['name']; } /** * Get field name for use in underscore templates. * * @since 3.17.2 * * @param array $field * * @return string */ function get_field_variable_name( $field ) { $name = $this->get_field_name( $field ); if ( isset( $this->type ) && 'child' === $this->type ) { $name = "data.{$name}"; } $name = str_replace( '-', '_', $name ); return $name; } function process_html_attributes( $field, &$attributes ) { if ( is_array( $field['attributes'] ) ) { foreach( $field['attributes'] as $attribute_key => $attribute_value ) { $attributes .= ' ' . esc_attr( $attribute_key ) . '="' . esc_attr( $attribute_value ) . '"'; } } else { $attributes = ' '.$field['attributes']; } } /** * Returns an underscore template for the options settings. * @param array $field Associative array. * array( 'id' => (int), 'label' => (string), 'description' => (string), 'class' => (string), 'type' => (string), 'validate_input' => (bool), 'name' => (string), 'default' => (string), 'defaults' => (array), 'options' => (array), 'option_category' => (string), 'attributes' => (string), 'affects' => (string), 'before' => (string), 'after' => (string), 'display_if' => (string), 'depends_on' => (string), 'depends_show_if' => (string), 'depends_show_if_not' => (string), 'show_if' => (string), 'show_if_not' => (string), 'tab_slug' => (string), 'toggle_slug' => (string), 'composite_type' => (string), 'composite_structure' => (array), ) * @return string HTML underscore template. */ function render_field( $field, $name = '' ) { $classes = array(); $hidden_field = ''; $field_el = ''; $is_custom_color = isset( $field['custom_color'] ) && $field['custom_color']; $reset_button_html = ''; $need_mobile_options = isset( $field['mobile_options'] ) && $field['mobile_options'] ? true : false; $only_options = isset( $field['only_options'] ) ? $field['only_options'] : false; $is_child = isset( $this->type ) && 'child' === $this->type; // Make sure 'type' is always set to prevent PHP notices if ( empty( $field['type'] ) ) { $field['type'] = 'no-type'; } if ( $need_mobile_options ) { $mobile_settings_tabs = et_pb_generate_mobile_settings_tabs(); } if ( 0 !== strpos( $field['type'], 'select' ) ) { $classes = array( 'regular-text' ); } foreach( $this->get_validation_class_rules() as $rule ) { if ( ! empty( $field[ $rule ] ) ) { $this->validation_in_use = true; $classes[] = $rule; } } if ( isset( $field['validate_unit'] ) && $field['validate_unit'] ) { $classes[] = 'et-pb-validate-unit'; } if ( ! empty( $field['class'] ) ) { if ( is_string( $field['class'] ) ) { $field['class'] = array( $field['class'] ); } $classes = array_merge( $classes, $field['class'] ); } $field['class'] = implode(' ', $classes ); $field_name = $this->get_field_name( $field ); $field['id'] = ! empty( $field['id'] ) ? $field['id'] : $field_name; $field['name'] = $field_name; if ( $is_child ) { $field_name = "data.{$field_name}"; } $field_var_name = $this->get_field_variable_name( $field ); $default_on_front = self::$_->array_get( $field, 'default_on_front', '' ); $default_arr = self::$_->array_get( $field, 'default', $default_on_front ); if ( is_array( $default_arr ) && isset( $default_arr[1] ) && is_array( $default_arr[1] ) ) { list($default_parent_id, $defaults_list) = $default_arr; $default_parent_id = sprintf( '%1$set_pb_%2$s', $is_child ? 'data.' : '', $default_parent_id ); $default = esc_attr( wp_json_encode( $default_arr ) ); $default_value = sprintf( '(typeof(%1$s) !== \'undefined\' ? ( typeof(%1$s) === \'object\' ? (%2$s)[jQuery(%1$s).val()] : (%2$s)[%1$s] ) : \'\')', $default_parent_id, wp_json_encode( $defaults_list ) ); $default_is_arr = true; } else { $default = $default_value = $default_arr; $default_is_arr = false; } if ( 'font' === $field['type'] ) { $default = '' === $default ? '||||||||' : $default; $default_value = '' === $default_value ? '||||||||' : $default_value; } $font_icon_options = array( 'et_pb_font_icon', 'et_pb_button_icon', 'et_pb_button_one_icon', 'et_pb_button_two_icon', 'et_pb_hover_icon' ); if ( in_array( $field_name, $font_icon_options ) ) { $field_value = esc_attr( $field_var_name ); } else { $field_value = esc_attr( $field_var_name ) . '.replace(/%91/g, "[").replace(/%93/g, "]").replace(/%22/g, "\"")'; } $value_html = $default_is_arr ? ' value="<%%- typeof( %1$s ) !== \'undefined\' ? %2$s : %3$s %%>" ' : ' value="<%%- typeof( %1$s ) !== \'undefined\' ? %2$s : \'%3$s\' %%>" '; $value = sprintf( $value_html, esc_attr( $field_var_name ), $field_value, $default_value ); $attributes = ''; if ( ! empty( $field['attributes'] ) ) { $this->process_html_attributes( $field, $attributes ); } if ( ! empty( $field['affects'] ) ) { $field['class'] .= ' et-pb-affects'; $attributes .= sprintf( ' data-affects="%s"', esc_attr( implode( ', ', $field['affects'] ) ) ); } if ( ! empty( $field['responsive_affects'] ) ) { $field['class'] .= ' et-pb-responsive-affects'; $attributes .= sprintf( ' data-responsive-affects="%1$s" data-responsive-desktop-name="%2$s"', esc_attr( implode( ', ', $field['responsive_affects'] ) ), esc_attr( $field['name'] ) ); } if ( 'font' === $field['type'] ) { $field['class'] .= ' et-pb-font-select'; } if ( in_array( $field['type'], array( 'font', 'hidden', 'multiple_checkboxes', 'select_with_option_groups', 'select_animation', 'presets', 'presets_shadow', 'select_box_shadow' ) ) && ! $only_options ) { $hidden_field = sprintf( '', esc_attr( $field['name'] ), esc_attr( $field['id'] ), esc_attr( $field['class'] ), esc_attr( $default ), $value, $attributes ); if ( 'select_with_option_groups' === $field['type'] ) { // Since we are using a hidden field to manage the value, we need to clear the data-affects attribute so that // it doesn't appear on both the `$field` AND the hidden field. This should probably be done for all of these // field types but don't want to risk breaking anything :-/ $attributes = preg_replace( '/data-affects="[\w\s-,]*"/', 'data-affects=""', $attributes ); } } foreach ( $this->get_validation_attr_rules() as $rule ) { if ( ! empty( $field[ $rule ] ) ) { $this->validation_in_use = true; $attributes .= ' data-rule-' . esc_attr( $rule ). '="' . esc_attr( $field[ $rule ] ) . '"'; } } if ( isset( $field['before'] ) && ! $only_options ) { $field_el .= $this->render_field_before_after_element( $field['before'] ); } switch( $field['type'] ) { case 'upload-gallery' : $field_el .= sprintf( '' . '', esc_attr__( 'Update Gallery', 'et_builder' ), $value, esc_attr( $field['name'] ), esc_attr( $field['id'] ) ); break; case 'background-field': $field_el .= $this->wrap_settings_background_fields( $field['background_fields'], $field['base_name'] ); break; case 'warning': $field_el .= sprintf( '
%1$s
', html_entity_decode( esc_html( $field['message'] ) ), esc_attr( $field['name'] ), esc_attr( $field['display_if'] ) ); break; case 'tiny_mce': if ( ! empty( $field['tiny_mce_html_mode'] ) ) { $field['class'] .= ' html_mode'; } $main_content_property_name = $main_content_field_name = 'et_pb_content'; if ( isset( $this->type ) && 'child' === $this->type ) { $main_content_property_name = "data.{$main_content_property_name}"; } if ( 'et_pb_signup' === $this->slug ) { $main_content_property_name = $main_content_field_name = $field['name']; } $field_el .= sprintf( '
<%%= typeof( %2$s ) !== \'undefined\' ? %2$s : \'\' %%>
', esc_attr( $main_content_field_name ), esc_html( $main_content_property_name ) ); break; case 'codemirror': case 'textarea': case 'custom_css': case 'options_list': case 'sortable_list': $field_custom_value = esc_html( $field_var_name ); if ( in_array( $field['type'], array( 'custom_css', 'options_list', 'sortable_list' ) ) ) { $field_custom_value .= '.replace( /\|\|/g, "\n" ).replace( /%22/g, """ ).replace( /%92/g, "\\\" )'; $field_custom_value .= '.replace( /%91/g, "[" ).replace( /%93/g, "]" )'; } if ( in_array( $field_name, array( 'et_pb_custom_message' ) ) ) { // escape html to make sure it's not rendered inside the Textarea field in Settings Modal. $field_custom_value = sprintf( '_.escape( %1$s )', $field_custom_value ); } $field_el .= sprintf( '', esc_attr( $field['class'] ), esc_attr( $field['id'] ), esc_html( $field_var_name ), et_core_esc_previously( $field_custom_value ) ); if ( 'options_list' === $field['type'] || 'sortable_list' === $field['type'] ) { $radio_check = ''; $row_class = 'et_options_list_row'; if ( isset( $field['checkbox'] ) && true === $field['checkbox'] ) { $radio_check = ''; $row_class .= ' et_options_list_row_checkbox'; } if ( isset( $field['radio'] ) && true === $field['radio'] ) { $radio_check = ''; $row_class .= ' et_options_list_row_radio'; } $field_el = sprintf( '
%6$s
%7$s
', esc_attr( $field['class'] ), esc_attr( $field['id'] ), esc_html( $field_var_name ), et_core_esc_previously( $field_custom_value ), esc_attr( $row_class ), $radio_check, esc_html__( 'Add New Item', 'et_builder' ) ); } break; case 'conditional_logic': $field_custom_value = esc_html( $field_var_name ); $field_custom_value .= '.replace( /\|\|/g, "\n" ).replace( /%22/g, """ ).replace( /%92/g, "\\\" )'; $field_custom_value .= '.replace( /%91/g, "[" ).replace( /%93/g, "]" )'; $field_selects = sprintf( ' ', esc_html__( 'equals', 'et_builder' ), esc_html__( 'does not equal', 'et_builder' ), esc_html__( 'is greater than', 'et_builder' ), esc_html__( 'is less than', 'et_builder' ), esc_html__( 'contains', 'et_builder' ), esc_html__( 'does not contain', 'et_builder' ), esc_html__( 'is empty', 'et_builder' ), esc_html__( 'is not empty', 'et_builder' ) ); $field_el = sprintf( '
%5$s
%8$s
', esc_attr( $field['class'] ), esc_attr( $field['id'] ), esc_html( $field_var_name ), et_core_esc_previously( $field_custom_value ), $field_selects, esc_html__( 'checked', 'et_builder' ), esc_html__( 'not checked', 'et_builder' ), esc_html__( 'Add New Rule', 'et_builder' ) ); break; case 'text_align': case 'select': case 'divider': case 'yes_no_button': case 'multiple_buttons': case 'font': case 'select_with_option_groups': if ( 'font' === $field['type'] ) { $field['id'] .= '_select'; $field_name .= '_select'; $field['class'] .= ' et-pb-helper-field'; $field['options'] = array(); } if ( 'text_align' === $field['type'] ) { $field['class'] = 'et-pb-text-align-select'; } $button_options = array(); if ( 'yes_no_button' === $field['type'] ) { $button_options = isset( $field['button_options'] ) ? $field['button_options'] : array(); } if ( $default ) { $attributes .= sprintf( ' data-default="%1$s"', esc_attr( $default ) ); } //If default is an array, then $default_value value is an js expression, so it doesn't need to be encoded //In other case it needs to be encoded $select_default = $default_is_arr ? $default_value : wp_json_encode( $default_value ); if ( 'font' === $field['type'] ) { $group_label = isset( $field['group_label'] ) ? $field['group_label'] : ''; $select = $this->render_font_select( $field_name, $field['id'], $group_label ); } else if ( 'multiple_buttons' === $field['type'] ) { if ( isset( $field['toggleable'] ) && $field['toggleable'] ) { $attributes .= ' data-toggleable="yes"'; } if ( isset( $field['multi_selection'] ) && $field['multi_selection'] ) { $attributes .= ' data-multi="yes"'; } $select = $this->render_multiple_buttons( $field_name, $field['options'], $field['id'], $field['class'], $attributes, $value, $default_value ); } else { $select = $this->render_select( $field_name, $field['options'], $field['id'], $field['class'], $attributes, $field['type'], $button_options, $select_default, $only_options ); } if ( $only_options ) { $field_el = $select; } else { $field_el .= $select; } if ( 'font' === $field['type'] ) { $font_style_button_html = sprintf( '<%%= window.et_builder.options_template_output("font_buttons",%1$s) %%>', wp_json_encode( array( 'italic', 'uppercase', 'capitalize', 'underline', 'line_through' ) ) ); $field_el .= sprintf( '
%1$s
', $font_style_button_html ); $field_el .= '<%= window.et_builder.options_template_output("font_line_styles") %>'; $field_el .= $hidden_field; } if ( 'text_align' === $field['type'] ) { $text_align_options = ! empty( $field[ 'options' ] ) ? array_keys( $field[ 'options' ] ) : array( 'left', 'center', 'right', 'justified' ); $is_module_alignment = in_array( $field['name'], array( 'et_pb_module_alignment', 'et_pb_button_alignment' ) ) || ( isset( $field['options_icon'] ) && 'module_align' === $field['options_icon'] ); $text_align_style_button_html = sprintf( '<%%= window.et_builder.options_text_align_buttons_output(%1$s, "%2$s") %%>', wp_json_encode( $text_align_options ), $is_module_alignment ? 'module' : 'text' ); $field_el .= sprintf( '
%1$s
', $text_align_style_button_html ); $field_el .= $hidden_field; } if ( 'select_with_option_groups' === $field['type'] ) { $field_el .= $hidden_field; } break; case 'select_animation': $options = $field['options']; $animation_buttons_array = array(); foreach ( $options as $option_name => $option_title ) { $animation_buttons_array[ $option_name ] = sanitize_text_field( $option_title ); } $animation_buttons = sprintf( '<%%= window.et_builder.options_template_output("animation_buttons",%1$s) %%>', wp_json_encode( $animation_buttons_array ) ); $field_el = sprintf( '
%1$s %2$s
', $animation_buttons, $hidden_field ); break; case 'presets_shadow': case 'select_box_shadow': case 'presets': $presets = $field['presets']; $presets_buttons = ''; foreach ( $presets as $preset ) { $fields = isset( $preset['fields'] ) ? htmlspecialchars( wp_json_encode( $preset['fields'] ), ENT_QUOTES, 'UTF-8' ) : '[]'; $presets_buttons .= sprintf( '
', esc_attr( $preset['value'] ), esc_attr( $fields ) ); if ( isset( $preset['title'] ) && ! empty( $preset['title'] ) ) { $presets_buttons .= sprintf( '%1$s', $preset['title'] ); } if ( isset( $preset['icon'] ) && ! empty( $preset['icon'] ) ) { $presets_buttons .= sprintf( '%1$s', $this->get_icon( $preset['icon'] ) ); } if ( isset( $preset['content'] ) && ! empty( $preset['content'] ) ) { if ( is_array( $preset['content'] ) ) { $content = isset( $preset['content']['content'] ) ? $preset['content']['content'] : ''; $class = isset( $preset['content']['class'] ) ? ' ' . $preset['content']['class'] : ''; } else { $content = $preset['content']; $class = ''; } $presets_buttons .= sprintf( '%1$s', $content, $class ); } $presets_buttons .= '
'; } $field_el = sprintf( '
%1$s %2$s
', $presets_buttons, $hidden_field, esc_attr( $field['type'] ) ); break; case 'color': case 'color-alpha': $field['default'] = ! empty( $field['default'] ) ? $field['default'] : ''; if ( $is_custom_color && ( ! isset( $field['default'] ) || '' === $field['default'] ) ) { $field['default'] = ''; } $default = ! empty( $field['default'] ) ? sprintf( ' data-default-color="%1$s" data-default="%1$s"', esc_attr( $field['default'] ) ) : ''; $color_id = sprintf( ' id="%1$s"', esc_attr( $field['id'] ) ); $color_value_html = '<%%- typeof( %1$s ) !== \'undefined\' && %1$s !== \'\' ? %1$s : \'%2$s\' %%>'; $main_color_value = sprintf( $color_value_html, esc_attr( $field_var_name ), $field['default'] ); $hidden_color_value = sprintf( $color_value_html, esc_attr( $field_var_name ), '' ); $has_preview = isset( $field['has_preview'] ) && $field['has_preview']; $field_el = sprintf( ' %4$s', ( ! $is_custom_color || $has_preview ? $color_id : '' ), $main_color_value, $default, ( ! empty( $field['additional_code'] ) ? $field['additional_code'] : '' ), ( 'color-alpha' === $field['type'] ? ' et-pb-color-picker-hex-alpha' : '' ), ( 'color-alpha' === $field['type'] ? ' data-alpha="true"' : '' ), ( 'color' === $field['type'] ? ' maxlength="7"' : '' ), ( ! $is_custom_color ? ' et-pb-main-setting' : '' ), esc_attr__( 'Hex Value', 'et_builder' ), $has_preview ? esc_attr( ' et-pb-color-picker-hex-has-preview' ) : '' ); if ( $is_custom_color && ! $has_preview ) { $field_el = sprintf( '%1$s
%2$s %5$s
', esc_html__( 'Choose Custom Color', 'et_builder' ), $field_el, $color_id, $hidden_color_value, $reset_button_html, $attributes ); } break; case 'upload': $field_data_type = ! empty( $field['data_type'] ) ? $field['data_type'] : 'image'; $field['upload_button_text'] = ! empty( $field['upload_button_text'] ) ? $field['upload_button_text'] : esc_attr__( 'Upload', 'et_builder' ); $field['choose_text'] = ! empty( $field['choose_text'] ) ? $field['choose_text'] : esc_attr__( 'Choose image', 'et_builder' ); $field['update_text'] = ! empty( $field['update_text'] ) ? $field['update_text'] : esc_attr__( 'Set image', 'et_builder' ); $field['class'] = ! empty( $field['class'] ) ? ' ' . $field['class'] : ''; $field_additional_button = ! empty( $field['additional_button'] ) ? "\n\t\t\t\t\t" . $field['additional_button'] : ''; $field_el .= sprintf( ' %7$s', esc_attr( $field['id'] ), esc_attr( $field_var_name ), esc_attr( $field['upload_button_text'] ), esc_attr( $field['choose_text'] ), esc_attr( $field['update_text'] ), esc_attr( $field_data_type ), $field_additional_button, esc_attr( $field['class'] ), $attributes ); break; case 'checkbox': $field_el .= sprintf( '>', esc_attr( $field['name'] ), esc_attr( $field['id'] ), esc_attr( str_replace( '-', '_', $field['name'] ) ) ); break; case 'multiple_checkboxes' : $checkboxes_set = '
'; if ( ! empty( $field['options'] ) ) { foreach( $field['options'] as $option_value => $option_label ) { $checkboxes_set .= sprintf( '%3$s
', esc_attr( $option_value ), esc_html( $option_label ), "\n\t\t\t\t\t" ); } } // additional option for disable_on option for backward compatibility if ( isset( $field['additional_att'] ) && 'disable_on' === $field['additional_att'] ) { $et_pb_disabled_value = sprintf( $value_html, esc_attr( 'et_pb_disabled' ), esc_attr( 'et_pb_disabled' ), '' ); $checkboxes_set .= sprintf( '', $et_pb_disabled_value ); } $field_el .= $checkboxes_set . $hidden_field . '
'; break; case 'hidden': $field_el .= $hidden_field; break; case 'custom_margin': case 'custom_padding': $custom_margin_class = ""; // Fill the array of values for tablet and phone if ( $need_mobile_options ) { $mobile_values_array = array(); $has_saved_value = array(); $mobile_desktop_class = ' et_pb_setting_mobile et_pb_setting_mobile_desktop et_pb_setting_mobile_active'; $mobile_desktop_data = ' data-device="desktop"'; foreach( array( 'tablet', 'phone' ) as $device ) { $mobile_values_array[] = sprintf( $value_html, esc_attr( $field_var_name . '_' . $device ), esc_attr( $field_var_name . '_' . $device ), $default_value ); $has_saved_value[] = sprintf( ' data-has_saved_value="<%%- typeof( %1$s ) !== \'undefined\' ? \'yes\' : \'no\' %%>" ', esc_attr( $field_var_name . '_' . $device ) ); } $value_last_edited = sprintf( $value_html, esc_attr( $field_var_name . '_last_edited' ), esc_attr( $field_var_name . '_last_edited' ), '' ); // additional field to save the last edited field which will be opened automatically $additional_mobile_fields = sprintf( '', esc_attr( $field_name . '_last_edited' ), $value_last_edited ); } // Add auto_important class to field which automatically append !important tag if ( isset( $this->advanced_fields['margin_padding']['css']['important'] ) ) { $custom_margin_class .= " auto_important"; } $has_responsive_affects = isset( $field['responsive_affects'] ); $single_fields_settings = array( 'side' => '', 'label' => '', 'need_mobile' => $need_mobile_options ? 'need_mobile' : '', 'class' => esc_attr( $custom_margin_class ), ); $field_el .= sprintf( '
%6$s %7$s %8$s %9$s %10$s %13$s
', esc_attr( $field['name'] ), esc_attr( $field['id'] ), $value, $attributes, esc_attr( $default ), // #5 ! isset( $field['sides'] ) || ( ! empty( $field['sides'] ) && in_array( 'top', $field['sides'] ) ) ? sprintf( '<%%= window.et_builder.options_template_output("padding",%1$s) %%>', wp_json_encode( array_merge( $single_fields_settings, array( 'side' => 'top', 'label' => esc_html__( 'Top', 'et_builder' ), ) ) ) ) : '', ! isset( $field['sides'] ) || ( ! empty( $field['sides'] ) && in_array( 'right', $field['sides'] ) ) ? sprintf( '<%%= window.et_builder.options_template_output("padding",%1$s) %%>', wp_json_encode( array_merge( $single_fields_settings, array( 'side' => 'right', 'label' => esc_html__( 'Right', 'et_builder' ), ) ) ) ) : '', ! isset( $field['sides'] ) || ( ! empty( $field['sides'] ) && in_array( 'bottom', $field['sides'] ) ) ? sprintf( '<%%= window.et_builder.options_template_output("padding",%1$s) %%>', wp_json_encode( array_merge( $single_fields_settings, array( 'side' => 'bottom', 'label' => esc_html__( 'Bottom', 'et_builder' ), ) ) ) ) : '', ! isset( $field['sides'] ) || ( ! empty( $field['sides'] ) && in_array( 'left', $field['sides'] ) ) ? sprintf( '<%%= window.et_builder.options_template_output("padding",%1$s) %%>', wp_json_encode( array_merge( $single_fields_settings, array( 'side' => 'left', 'label' => esc_html__( 'Left', 'et_builder' ), ) ) ) ) : '', $need_mobile_options ? sprintf( ' ', esc_attr( $field['name'] ), esc_attr( $field['id'] ), $attributes, esc_attr( $default ), $mobile_values_array[0], $mobile_values_array[1], $has_saved_value[0], $has_saved_value[1], $has_responsive_affects ? ' et-pb-responsive-affects' : '' ) : '', // #10 $need_mobile_options ? esc_attr( $mobile_desktop_class ) : '', $need_mobile_options ? $mobile_desktop_data : '', $need_mobile_options ? $additional_mobile_fields : '', $has_responsive_affects ? ' et-pb-responsive-affects' : '' // #14 ); break; case 'text': case 'number': case 'date_picker': case 'range': default: $validate_number = isset( $field['number_validation'] ) && $field['number_validation'] ? true : false; if ( 'date_picker' === $field['type'] ) { $field['class'] .= ' et-pb-date-time-picker'; } $field['class'] .= 'range' === $field['type'] ? ' et-pb-range-input' : ' et-pb-main-setting'; $type = in_array( $field['type'], array( 'text', 'number' ) ) ? $field['type'] : 'text'; $field_el .= sprintf( '%7$s', esc_attr( $field['id'] ), esc_attr( $field['class'] ), $value, $attributes, ( $validate_number ? ' et-validate-number' : '' ), ( $validate_number ? ' maxlength="3"' : '' ), ( ! empty( $field['additional_button'] ) ? $field['additional_button'] : '' ), ( '' !== $default ? sprintf( ' data-default="%1$s"', esc_attr( $default ) ) : '' ), $need_mobile_options ? ' et_pb_setting_mobile et_pb_setting_mobile_active et_pb_setting_mobile_desktop' : '', $need_mobile_options ? ' data-device="desktop"' : '', $type ); // generate additional fields for mobile settings switcher if needed if ( $need_mobile_options ) { $additional_fields = ''; foreach( array( 'tablet', 'phone' ) as $device_type ) { $value_mobile = sprintf( $value_html, esc_attr( $field_var_name . '_' . $device_type ), esc_attr( $field_var_name . '_' . $device_type ), $default_value ); // additional data attribute to handle default values for the responsive options $has_saved_value = sprintf( ' data-has_saved_value="<%%- typeof( %1$s ) !== \'undefined\' ? \'yes\' : \'no\' %%>" ', esc_attr( $field_var_name . '_' . $device_type ) ); $additional_fields .= sprintf( '%7$s', $value_mobile, esc_attr( $field['id'] ) . '_' . $device_type, esc_attr( $field['class'] ), $attributes, ( $validate_number ? ' et-validate-number' : '' ), // #5 ( $validate_number ? ' maxlength="3"' : '' ), ( ! empty( $field['additional_button'] ) ? $field['additional_button'] : '' ), ( '' !== $default ? sprintf( ' data-default="%1$s"', esc_attr( $default ) ) : '' ), esc_attr( $device_type ), $has_saved_value, // #10, $type ); } $value_last_edited = sprintf( $value_html, esc_attr( $field_var_name . '_last_edited' ), esc_attr( $field_var_name . '_last_edited' ), '' ); $class_last_edited = array( 'et_pb_mobile_last_edited_field', ); $attrs = ''; if ( ! empty( $field['responsive_affects'] ) ) { $class_last_edited[] = 'et-pb-responsive-affects'; $attrs .= sprintf( ' data-responsive-affects="%1$s" data-responsive-desktop-name="%2$s"', esc_attr( implode( ', ', $field['responsive_affects'] ) ), esc_attr( $field['name'] ) ); } // additional field to save the last edited field which will be opened automatically $additional_fields .= sprintf( '', esc_attr( $field_name . '_last_edited' ), $value_last_edited, esc_attr( implode( ' ', $class_last_edited ) ), $attrs ); } if ( 'range' === $field['type'] ) { $range_value_html = $default_is_arr ? ' value="<%%- typeof( %1$s ) !== \'undefined\' ? %2$s :parseFloat(%3$s) %%>" ' : ' value="<%%- typeof( %1$s ) !== \'undefined\' ? %2$s : parseFloat(\'%3$s\') %%>" '; $value = sprintf( $range_value_html, esc_attr( $field_var_name ), esc_attr( sprintf( 'parseFloat( %1$s )', $field_var_name ) ), $default_value ); $fixed_range = isset($field['fixed_range']) && $field['fixed_range']; $range_settings_html = ''; $range_properties = apply_filters( 'et_builder_range_properties', array( 'min', 'max', 'step' ) ); foreach ( $range_properties as $property ) { if ( isset( $field['range_settings'][ $property ] ) ) { $range_settings_html .= sprintf( ' %2$s="%1$s"', esc_attr( $field['range_settings'][ $property ] ), esc_html( $property ) ); } } $range_el = sprintf( '', $value, esc_attr( $default ), $range_settings_html, $need_mobile_options ? ' et_pb_setting_mobile et_pb_setting_mobile_desktop et_pb_setting_mobile_active' : '', $need_mobile_options ? ' data-device="desktop"' : '', $fixed_range ? ' et-pb-fixed-range' : '', esc_attr( $field['name'] ) ); if ( $need_mobile_options ) { foreach( array( 'tablet', 'phone' ) as $device_type ) { // additional data attribute to handle default values for the responsive options $has_saved_value = sprintf( ' data-has_saved_value="<%%- typeof( %1$s ) !== \'undefined\' ? \'yes\' : \'no\' %%>" ', esc_attr( $field_var_name . '_' . $device_type ) ); $value_mobile_range = sprintf( $value_html, esc_attr( $field_var_name . '_' . $device_type ), esc_attr( sprintf( 'parseFloat( %1$s )', $field_var_name . '_' . $device_type ) ), $default_value ); $range_el .= sprintf( '', esc_attr( $default ), $range_settings_html, esc_attr( $device_type ), $value_mobile_range, $has_saved_value, $fixed_range ? ' et-pb-fixed-range' : '' ); } } $field_el = $range_el . "\n" . $field_el; } if ( $need_mobile_options ) { $field_el = $field_el . $additional_fields; } break; } if ( isset( $field['has_preview'] ) && $field['has_preview'] ) { $field_el = sprintf( '<%%= window.et_builder.options_template_output("option_preview_buttons") %%> %1$s', $field_el ); } if ( $need_mobile_options ) { $field_el = $mobile_settings_tabs . "\n" . $field_el; $field_el .= ''; } if ( isset( $field['type'] ) && isset( $field['tab_slug'] ) && 'advanced' === $field['tab_slug'] && ! $is_custom_color ) { $field_el .= $reset_button_html; } if ( isset( $field['after'] ) && ! $only_options ) { $field_el .= $this->render_field_before_after_element( $field['after'] ); } return "\t" . $field_el; } public function render_field_before_after_element( $elements ) { $field_el = ''; $elements = is_array( $elements ) ? $elements : array( $elements ); foreach ( $elements as $element ) { $attributes = ''; if ( ! empty( $element['attributes'] ) ) { $this->process_html_attributes( $element, $attributes ); } switch ( $element['type'] ) { case 'button': $class = isset( $element['class'] ) ? esc_attr( $element['class'] ) : ''; $text = isset( $element['text'] ) ? et_core_esc_previously( $element['text'] ) : ''; $field_el .= sprintf( '', $class, $attributes, $text ); break; } } return $field_el; } function render_font_select( $name, $id = '', $group_label ) { $options_output = '<%= window.et_builder.fonts_template() %>'; $font_weight_output = '<%= window.et_builder.fonts_weight_template() %>'; $output = sprintf( '

  • %4$s

    • %3$s
%5$s', esc_attr( $name ), ( ! empty( $id ) ? sprintf(' id="%s"', esc_attr( $id ) ) : '' ), $options_output . "\n\t\t\t\t\t", esc_html__( 'Recent', 'et_builder' ), $font_weight_output, esc_attr( $group_label ) ); return $output; } function render_select( $name, $options, $id = '', $class = '', $attributes = '', $field_type = '', $button_options = array(), $default = '', $only_options = false ) { $options_output = ''; $processed_options = $options; if ( 'select_with_option_groups' === $field_type ) { foreach ( $processed_options as $option_group_name => $option_group ) { $option_group_name = esc_attr( $option_group_name ); $options_output .= '0' !== $option_group_name ? "" : ''; $options_output .= sprintf( '<%%= window.et_builder.options_template_output("select",%1$s,this.model.toJSON()) %%>', sprintf( '{select_name: "%1$s", list: %2$s, default: %3$s, }', $name, wp_json_encode( $option_group ), $default ) ); $options_output .= '0' !== $option_group_name ? '' : ''; } $class = rtrim( $class ); $name = $id = ''; } else { $class = rtrim( 'et-pb-main-setting ' . $class ); $options_output .= sprintf( '<%%= window.et_builder.options_template_output("select",%1$s,this.model.toJSON()) %%>', sprintf( '{select_name: "%1$s", list: %2$s, default: %3$s, }', $name, wp_json_encode( $options ), $default ) ); } $output = sprintf( '%6$s %7$s', esc_attr( $name ), ( ! empty( $id ) ? sprintf(' id="%s"', esc_attr( $id ) ) : '' ), ( ! empty( $class ) ? esc_attr( $class ) : '' ), ( ! empty( $attributes ) ? $attributes : '' ), $options_output . "\n\t\t\t\t\t", 'yes_no_button' === $field_type ? sprintf( '
%1$s', sprintf( '<%%= window.et_builder.options_template_output("yes_no_button",%1$s) %%>', wp_json_encode( array( 'on' => esc_html( $processed_options['on'] ), 'off' => esc_html( $processed_options['off'] ), ) ) ), ( ! empty( $button_options['button_type'] ) && 'equal' === $button_options['button_type'] ? ' et_pb_button_equal_sides' : '' ) ) : '', 'yes_no_button' === $field_type ? '
' : '', esc_attr( $field_type ), '' !== $name ? sprintf( ' data-saved_value="<%%= typeof( %1$s ) !== \'undefined\' ? %1$s : \'\' %%>"', esc_attr( str_replace( '-', '_', $name ) ) ) : '' ); return $only_options ? $options_output : $output; } function render_multiple_buttons( $name, $options, $id = '', $class = '', $attributes = '', $value = '', $default = '' ) { $class = rtrim( 'et-pb-main-setting ' . $class ); $output = sprintf( '
%6$s
', esc_attr( $id ), esc_attr( $class ), $value, $attributes, ( '' !== $default ? sprintf( ' data-default=%1$s', esc_attr( $default ) ) : '' ), sprintf( '<%%= window.et_builder.options_template_output("multiple_buttons",%1$s) %%>', wp_json_encode( $options ) ), esc_attr( $name ) ); return $output; } /** * @deprecated */ function get_main_tabs() { $tabs = array( 'general' => esc_html__( 'Content', 'et_builder' ), 'advanced' => esc_html__( 'Design', 'et_builder' ), 'custom_css' => esc_html__( 'Advanced', 'et_builder' ), ); return apply_filters( 'et_builder_main_tabs', $tabs ); } function get_validation_attr_rules() { return array( 'minlength', 'maxlength', 'min', 'max', ); } function get_validation_class_rules() { return array( 'required', 'email', 'url', 'date', 'dateISO', 'number', 'digits', 'creditcard', ); } function sort_fields( $fields ) { $tabs_fields = array(); $sorted_fields = array(); $i = 0; // Sort fields array by tab name foreach ( $fields as $field_slug => $field_options ) { $field_options['_order_number'] = $i; $tab_slug = ! empty( $field_options['tab_slug'] ) ? $field_options['tab_slug'] : 'general'; $tabs_fields[ $tab_slug ][ $field_slug ] = $field_options; $i++; } // Sort fields within tabs by priority foreach ( $tabs_fields as $tab_fields ) { uasort( $tab_fields, array( 'self', 'compare_by_priority' ) ); $sorted_fields = array_merge( $sorted_fields, $tab_fields ); } return $sorted_fields; } function get_options() { $output = ''; $toggle_all_options_slug = 'all_options'; $toggles_used = isset( $this->settings_modal_toggles ); $tabs_output = array( 'general' => array() ); $all_fields = $this->sort_fields( $this->_get_fields() ); $all_fields_keys = array_keys( $all_fields ); $background_fields_names = $this->get_background_fields_names(); $module_has_background_color_field = in_array( 'background_color', $all_fields_keys ); $all_toggles = self::get_toggles( 'post' ); foreach( $all_fields as $field_name => $field ) { if ( ! empty( $field['type'] ) && ( 'skip' === $field['type'] || 'computed' === $field['type'] ) ) { continue; } if ( ! self::$_->array_get( $field, 'bb_support', true ) ) { continue; } // add only options allowed for current user if ( ( ! et_pb_is_allowed( 'edit_colors' ) && ( ! empty( $field['type'] ) && in_array( $field['type'], array( 'color', 'color-alpha' ) ) || ( ! empty( $field['option_category'] ) && 'color_option' === $field['option_category'] ) ) ) || ( ! et_pb_is_allowed( 'edit_content' ) && ! empty( $field['option_category'] ) && 'basic_option' === $field['option_category'] ) || ( ! et_pb_is_allowed( 'edit_layout' ) && ! empty( $field['option_category'] ) && 'layout' === $field['option_category'] ) || ( ! et_pb_is_allowed( 'edit_configuration' ) && ! empty( $field['option_category'] ) && 'configuration' === $field['option_category'] ) || ( ! et_pb_is_allowed( 'edit_fonts' ) && ! empty( $field['option_category'] ) && ( 'font_option' === $field['option_category'] || ( 'button' === $field['option_category'] && ! empty( $field['type'] ) && 'font' === $field['type'] ) ) ) || ( ! et_pb_is_allowed( 'edit_buttons' ) && ! empty( $field['option_category'] ) && 'button' === $field['option_category'] ) ) { continue; } // check for allowed 3rd party custom options categories if ( ! empty( $field['option_category'] ) && ! et_pb_is_allowed( $field['option_category'] ) ) { continue; } $option_output = ''; if ( 'background_color' === $field_name ) { $background_fields_ui = $this->wrap_settings_background_fields( $all_fields ); // Append background fields UI if applicable. Append standard option otherwise if ( '' !== $background_fields_ui ) { // unset depends_show_if because background fields visibility handled in Background UI. unset( $field['depends_show_if'] ); // append background UI $option_output .= $background_fields_ui; } else { $field['skip_background_ui'] = true; $option_output .= $this->wrap_settings_option_label( $field ); $option_output .= $this->wrap_settings_option_field( $field ); } } elseif ( $module_has_background_color_field && in_array( $field_name , $background_fields_names ) ) { // remove background-related fields from setting modals since it'll be printed by background UI continue; } else { // append normal fields $option_output .= $this->wrap_settings_option_label( $field ); $option_output .= $this->wrap_settings_option_field( $field ); } $tab_slug = ! empty( $field['tab_slug'] ) ? $field['tab_slug'] : 'general'; $is_toggle_option = isset( $field['toggle_slug'] ) && $toggles_used && isset( $this->settings_modal_toggles[ $tab_slug ] ); $toggle_slug = $is_toggle_option ? $field['toggle_slug'] : $toggle_all_options_slug; $sub_toggle_slug = 'all_options' !== $toggle_slug && isset( $field['sub_toggle'] ) && '' !== $field['sub_toggle'] ? $field['sub_toggle'] : 'main'; $tabs_output[ $tab_slug ][ $toggle_slug ][ $sub_toggle_slug ][] = $this->wrap_settings_option( $option_output, $field, $field_name ); if ( isset( $field['toggle_slug'] ) && ! isset( $this->settings_modal_toggles[ $tab_slug ]['toggles'][ $toggle_slug ] ) ) { if ( $toggle = self::$_->array_get( $all_toggles, "{$this->slug}.{$tab_slug}.toggles.{$field['toggle_slug']}" ) ) { self::$_->array_set( $this->settings_modal_toggles, "{$tab_slug}.toggles.{$toggle_slug}", $toggle ); } } } $default_tabs_keys = array_keys( $this->main_tabs ); $module_tabs_keys = array_keys( $tabs_output ); $module_default_tabs = array_intersect( $default_tabs_keys, $module_tabs_keys ); $module_custom_tabs = array_diff( $module_tabs_keys, $default_tabs_keys ); // Make sure tabs order is correct for BB, i.e. custom tabs goes after default tabs and default tabs in following order: // `Content`, `Design`, `Advanced` $module_tabs_sorted = array_merge( $module_default_tabs, $module_custom_tabs ); $tabs_output_processed = array(); // reorder tabs to be sure they're correct foreach( $module_tabs_sorted as $tab_slug ) { $tabs_output_processed[ $tab_slug ] = $tabs_output[ $tab_slug ]; } foreach ( $tabs_output_processed as $tab_slug => $tab_settings ) { // Add only tabs allowed for current user if ( ! et_pb_is_allowed( $tab_slug . '_settings' ) ) { continue; } $tab_output = ''; $this->used_tabs[] = $tab_slug; $i = 0; if ( isset( $tabs_output_processed[ $tab_slug ] ) ) { // Group field with no explicit toggle_slug then append it on top of other toggles if ( isset( $tabs_output_processed[ $tab_slug ][ $toggle_all_options_slug ] ) ) { $toggle_unclassified_output = ''; foreach ( $tabs_output_processed[ $tab_slug ][ $toggle_all_options_slug ] as $no_toggle_option_data ) { foreach( $no_toggle_option_data as $subtoggle_id => $no_toggle_option_output ) { $toggle_unclassified_output .= $no_toggle_option_output; } } $tab_output .= sprintf( '

%1$s

%2$s
', esc_html__( $this->name, 'et_builder' ), et_core_esc_previously( $toggle_unclassified_output ), 'et-pb-options-toggle-disabled' ); } if ( isset( $this->settings_modal_toggles[ $tab_slug ] ) ) { $this->settings_modal_toggles[ $tab_slug ]['toggles'] = self::et_pb_order_toggles_by_priority( $this->settings_modal_toggles[ $tab_slug ]['toggles'] ); foreach ( $this->settings_modal_toggles[ $tab_slug ]['toggles'] as $toggle_slug => $toggle_data ) { $toggle_heading = is_array( $toggle_data ) ? $toggle_data['title'] : $toggle_data; if ( ! isset( $tabs_output_processed[ $tab_slug ][ $toggle_slug ] ) ) { continue; } $i++; $toggle_output = ''; $is_accordion_enabled = isset( $this->settings_modal_toggles[ $tab_slug ]['settings']['bb_toggles_enabeld'] ) && $this->settings_modal_toggles[ $tab_slug ]['settings']['bb_toggles_enabled'] ? true : false; $is_tabbed_subtoggles = isset( $toggle_data['tabbed_subtoggles'] ); $is_bb_icons_support = isset( $toggle_data['bb_icons_support'] ); $subtoggle_tabs_nav = ''; if ( is_array( $toggle_data ) && ! empty( $toggle_data ) ) { if ( ! isset( $toggle_data['sub_toggles'] ) ) { $toggle_data['sub_toggles'] = array( 'main' => '' ); } foreach( $toggle_data['sub_toggles'] as $sub_toggle_id => $sub_toggle_data ) { if ( ! isset( $tabs_output_processed[ $tab_slug ][ $toggle_slug ][ $sub_toggle_id ] ) ) { continue; } if ( $is_tabbed_subtoggles ) { $subtoggle_tabs_nav .= sprintf( '
  • %2$s
    • ', $sub_toggle_id, $is_bb_icons_support ? '' : esc_html( $sub_toggle_data['name'] ), $is_bb_icons_support ? sprintf( ' subtoggle_tabs_nav_icon subtoggle_tabs_nav_icon-%1$s', esc_attr( $sub_toggle_data['icon'] ) ) : '' ); } $subtoggle_options = ''; foreach ( $tabs_output_processed[ $tab_slug ][ $toggle_slug ][ $sub_toggle_id ] as $toggle_option_output ) { $subtoggle_options .= $toggle_option_output; } if ( 'main' === $sub_toggle_id ) { $toggle_output .= $subtoggle_options; } else { $toggle_output .= sprintf( '
    %1$s
    ', $subtoggle_options, $is_tabbed_subtoggles ? ' et_pb_tabbed_subtoggle' : '', $is_tabbed_subtoggles ? sprintf( ' data-tab_id="%1$s"', esc_attr( $sub_toggle_id ) ) : '' ); } } } else { foreach ( $tabs_output_processed[ $tab_slug ][ $toggle_slug ] as $toggle_option_id => $toggle_option_data ) { foreach( $toggle_option_data as $toggle_option_output ) { $toggle_output .= $toggle_option_output; } } } if ( '' === $toggle_output ) { continue; } $toggle_output = sprintf( '

    %1$s

    %6$s
    %2$s
    ', esc_html( $toggle_heading ), $toggle_output, ( $is_accordion_enabled ? ' et-pb-options-toggle-enabled' : ' et-pb-options-toggle-disabled' ), ( 1 === $i && $is_accordion_enabled ? ' et-pb-option-toggle-content-open' : '' ), $is_tabbed_subtoggles ? ' et_pb_contains_tabbed_subtoggle' : '', $is_tabbed_subtoggles && '' !== $subtoggle_tabs_nav ? sprintf( '
      %1$s
    ', $subtoggle_tabs_nav ) : '' ); $tab_output .= $toggle_output; } } } $output .= sprintf( '
    %3$s %2$s
    ', esc_attr( $tab_slug ), $tab_output, ( 'general' === $tab_slug ? $this->children_settings() : '' ) ); } // return error message if no tabs allowed for current user if ( '' === $output ) { $output = esc_html__( "You don't have sufficient permissions to access the settings", 'et_builder' ); } return $output; } function children_settings() { $output = ''; if ( ! empty( $this->child_slug ) ) { $child_module = self::get_module( $this->child_slug ); if ( isset( $child_module->bb_support ) && ! $child_module->bb_support ) { return $output; } $output = sprintf( '%6$s
    %2$s
    <%%= typeof( et_pb_content )!== \'undefined\' && \'\' !== et_pb_content.trim() ? et_pb_content : \'%7$s\' %%>

    %4$s

    %5$s', esc_attr( $this->child_slug ), esc_html( $this->add_new_child_text() ), esc_html__( 'Content', 'et_builder' ), esc_html__( 'Here you can define the content that will be placed within the current tab.', 'et_builder' ), "\n\n", "\t", $this->predefined_child_modules() ); } return $output; } function add_new_child_text() { $child_slug = ! empty( $this->child_item_text ) ? $this->child_item_text : ''; $child_slug = '' === $child_slug ? esc_html__( 'Add New Item', 'et_builder' ) : sprintf( esc_html__( 'Add New %s', 'et_builder' ), $child_slug ); return $child_slug; } function wrap_settings( $output ) { $tabs_output = ''; $i = 0; $tabs = array(); // General Settings Tab should be added to all modules if allowed if ( et_pb_is_allowed( 'general_settings' ) ) { $tabs['general'] = isset( $this->main_tabs['general'] ) ? $this->main_tabs['general'] : esc_html__( 'General Settings', 'et_builder' ); } foreach ( $this->used_tabs as $tab_slug ) { if ( 'general' === $tab_slug ) { continue; } // Add only tabs allowed for current user if ( et_pb_is_allowed( $tab_slug . '_settings' ) ) { if ( isset( $this->main_tabs[ $tab_slug ] ) ) { // if it's one of 3 default tabs $tabs[ $tab_slug ] = $this->main_tabs[ $tab_slug ]; } else { // Use tab name if it's properly registered custom tab. Fallback to tab slug otherwise $tabs[ $tab_slug ] = isset( $this->settings_modal_tabs ) && isset( $this->settings_modal_tabs[ $tab_slug ] ) ? $this->settings_modal_tabs[ $tab_slug ]['name'] : $tab_slug; } } } $tabs_array = array(); $tabs_json = ''; foreach ( $tabs as $tab_slug => $tab_name ) { $i++; $tabs_array[$i] = array( 'slug' => $tab_slug, 'label' => $tab_name, ); $tabs_json = wp_json_encode( $tabs_array ); } $tabs_output = sprintf( '<%%= window.et_builder.settings_tabs_output(%1$s) %%>', $tabs_json ); $preview_tabs_output = '<%= window.et_builder.preview_tabs_output() %>'; $output = sprintf( '%2$s %3$s
    %1$s
    ', $output, $tabs_output, $preview_tabs_output ); return sprintf( '%2$s
    %1$s
    %3$s', "\n\t\t" . $output, "\n\t\t", "\n" ); } function wrap_validation_form( $output ) { return '
    ' . $output . '
    '; } /** * Get the module's props mapped to their default values. * * @since 3.1 Renamed from `get_shortcode_fields()` to `get_default_props()`. * @since 1.0 * * @return array */ public function get_default_props() { if ( method_exists( $this, 'get_shortcode_fields' ) ) { // Backwards compatibility return $this->__call( 'get_shortcode_fields', array() ); } $fields = array(); foreach( $this->process_fields( $this->fields_unprocessed ) as $field_name => $field ) { $value = ''; if ( isset( $field['composite_type'], $field['composite_structure'] ) ) { require_once ET_BUILDER_DIR . 'module/field/attribute/composite/Parser.php'; $composite_atts = ET_Builder_Module_Field_Attribute_Composite_Parser::parse( $field['composite_type'], $field['composite_structure'] ); $fields = array_merge( $fields, $composite_atts ); } else { if ( isset( $field['default_on_front'] ) ) { $value = $field['default_on_front']; } else if ( isset( $field['default'] ) ) { $value = $field['default']; } $fields[ $field_name ] = $value; } } $fields['disabled'] = 'off'; $fields['disabled_on'] = ''; $fields['global_module'] = ''; $fields['temp_global_module'] = ''; $fields['global_parent'] = ''; $fields['temp_global_parent'] = ''; $fields['saved_tabs'] = ''; $fields['ab_subject'] = ''; $fields['ab_subject_id'] = ''; $fields['ab_goal'] = ''; $fields['locked'] = ''; $fields['template_type'] = ''; $fields['inline_fonts'] = ''; $fields['collapsed'] = ''; return $fields; } function get_module_data_attributes() { $attributes = apply_filters( "{$this->slug}_data_attributes", array(), $this->props, $this->render_count() ); $data_attributes = ''; if ( ! empty( $attributes ) ) { foreach ( $attributes as $name => $value ) { $data_attributes .= sprintf( ' data-%1$s="%2$s"', sanitize_title( $name ), esc_attr( $value ) ); } } return $data_attributes; } function build_microtemplate() { $this->validation_in_use = false; $template_output = ''; if ( 'child' === $this->type ) { $id_attr = sprintf( 'et-builder-advanced-setting-%s', $this->slug ); } else { $id_attr = sprintf( 'et-builder-%s-module-template', $this->slug ); } if ( ! isset( $this->settings_text ) ) { $settings_text = sprintf( __( '%1$s %2$s Settings', 'et_builder' ), esc_html( $this->name ), 'child' === $this->type ? esc_html__( 'Item', 'et_builder' ) : esc_html__( 'Module', 'et_builder' ) ); } else { $settings_text = $this->settings_text; } if ( file_exists( ET_BUILDER_DIR . 'microtemplates/' . $this->slug . '.php' ) ) { ob_start(); include ET_BUILDER_DIR . 'microtemplates/' . $this->slug . '.php'; $output = ob_get_clean(); } else { $output = $this->get_options(); } $output = $this->wrap_settings( $output ); if ( $this->validation_in_use ) { $output = $this->wrap_validation_form( $output ); } $template_output = sprintf( '', esc_attr( $id_attr ), esc_html( $settings_text ), et_core_intentionally_unescaped( $output, 'html' ) ); if ( 'child' === $this->type ) { $title_var = esc_js( $this->child_title_var ); $title_var = false === strpos( $title_var, 'et_pb_' ) ? 'et_pb_'. $title_var : $title_var; $title_fallback_var = esc_js( $this->child_title_fallback_var ); $title_fallback_var = false === strpos( $title_fallback_var, 'et_pb_' ) ? 'et_pb_'. $title_fallback_var : $title_fallback_var; $add_new_text = isset( $this->advanced_setting_title_text ) ? $this->advanced_setting_title_text : $this->add_new_child_text(); $template_output .= sprintf( '%6$s%5$s', esc_attr( $this->slug ), esc_html( $title_var ), esc_html( $title_fallback_var ), esc_html( $add_new_text ), "\n\n", "\t", $this->get_icon( 'lock' ) . esc_html__( 'Dynamic Content', 'et_builder' ) ); } return $template_output; } function get_gradient( $args ) { $defaults = apply_filters( 'et_pb_default_gradient', array( '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' ), 'color_start' => ET_Global_Settings::get_value( 'all_background_gradient_start' ), 'color_end' => ET_Global_Settings::get_value( 'all_background_gradient_end' ), 'start_position' => ET_Global_Settings::get_value( 'all_background_gradient_start_position' ), 'end_position' => ET_Global_Settings::get_value( 'all_background_gradient_end_position' ), ) ); $args = wp_parse_args( array_filter( $args ), $defaults ); $direction = $args['type'] === 'linear' ? $args['direction'] : "circle at {$args['radial_direction']}"; $start_position = et_sanitize_input_unit( $args['start_position'], false, '%' ); $end_Position = et_sanitize_input_unit( $args['end_position'], false, '%'); return esc_html( "{$args['type']}-gradient( {$direction}, {$args['color_start']} ${start_position}, {$args['color_end']} ${end_Position} )" ); } function get_rel_values() { return array( 'bookmark', 'external', 'nofollow', 'noreferrer', 'noopener', ); } function get_rel_attributes( $saved_value, $add_tag = true ) { $rel_attributes = array(); if ( $saved_value ) { $rel_values = $this->get_rel_values(); $selected_rels = explode( '|', $saved_value ); foreach ( $selected_rels as $index => $selected_rel ) { if ( ! $selected_rel || 'off' === $selected_rel ) { continue; } $rel_attributes[] = $rel_values[ $index ]; } } $attr = empty( $rel_attributes ) ? '' : implode( ' ', $rel_attributes ); return ( $add_tag && '' !== $attr ) ? sprintf( ' rel="%1$s"', esc_attr( $attr ) ) : $attr; } function get_text_orientation() { $text_orientation = isset( $this->props['text_orientation'] ) ? $this->props['text_orientation'] : ''; return et_pb_get_alignment( $text_orientation ); } function get_text_orientation_classname( $print_default = false ) { $text_orientation = $this->get_text_orientation(); // Should be `justified` instead of justify in classname. $text_orientation = 'justify' === $text_orientation ? 'justified' : $text_orientation; $default_classname = $print_default ? ' et_pb_text_align_left' : ''; return '' !== $text_orientation ? " et_pb_text_align_{$text_orientation}" : $default_classname; } // intended to be overridden as needed function get_max_width_additional_css() { return ''; } /** * Get type of element */ public function get_type() { return $this->type; } /** * Remove suffix of a string */ function remove_suffix( $string, $separator = '_' ) { $stringAsArray = explode( $separator, $string ); array_pop( $stringAsArray ); return implode( $separator, $stringAsArray ); } /** * process the fields. * @param string $function_name String of the function_name * @return void */ function process_additional_options( $function_name ) { $module = $this; if ( $function_name && $function_name !== $this->slug ) { if ( ! $module = self::get_module( $function_name, $this->get_post_type() ) ) { $module = $this; } else { $module->props = $this->props; } } if ( ! isset( $module->advanced_fields ) || false === $module->advanced_fields ) { return; } $module->process_advanced_fonts_options( $function_name ); // Process Text Shadow CSS $module->text_shadow->process_advanced_css( $module, $function_name ); $module->process_advanced_background_options( $function_name ); $module->process_advanced_text_options( $function_name ); $module->process_advanced_borders_options( $function_name ); $module->process_advanced_filter_options( $function_name ); $module->process_max_width_options( $function_name ); $module->process_advanced_custom_margin_options( $function_name ); $module->process_advanced_button_options( $function_name ); $this->process_box_shadow( $function_name ); $this->setup_hover_transitions( $function_name ); } function process_inline_fonts_option( $fonts_list ) { if ( '' === $fonts_list ) { return; } $fonts_list_array = explode( ',', $fonts_list ); foreach( $fonts_list_array as $font_name ) { et_builder_enqueue_font( $font_name ); } } function process_advanced_fonts_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'fonts', false ) ) { return; } $font_options = array(); $slugs = array( 'font', 'font_size', 'text_color', 'letter_spacing', 'line_height', 'text_align', ); $mobile_options_slugs = array( 'font_size_tablet', 'font_size_phone', 'line_height_tablet', 'line_height_phone', 'letter_spacing_tablet', 'letter_spacing_phone', ); $slugs = array_merge( $slugs, $mobile_options_slugs ); // merge all slugs into single array to define them in one place // Separetely defined and merged *_last_edited slugs. It needs to be merged as reference but shouldn't be looped for calling mobile attributes $mobile_options_last_edited_slugs = array( 'font_size_last_edited', 'line_height_last_edited', 'letter_spacing_last_edited', ); $slugs = array_merge( $slugs, $mobile_options_last_edited_slugs ); foreach ( $this->advanced_fields['fonts'] as $option_name => $option_settings ) { $style = ''; $hover_style = ''; $important_options = array(); $is_important_set = isset( $option_settings['css']['important'] ); $is_placeholder = isset( $option_settings['css']['placeholder'] ); $use_global_important = $is_important_set && 'all' === $option_settings['css']['important']; if ( ! $use_global_important && $is_important_set && 'plugin_only' === $option_settings['css']['important'] && et_is_builder_plugin_active() ) { $use_global_important = true; } if ( $is_important_set && is_array( $option_settings['css']['important'] ) ) { $important_options = $option_settings['css']['important']; if ( et_is_builder_plugin_active() && in_array( 'plugin_all', $option_settings['css']['important'] ) ) { $use_global_important = true; } } foreach ( $slugs as $font_option_slug ) { if ( isset( $this->props["{$option_name}_{$font_option_slug}"] ) ) { $font_options["{$option_name}_{$font_option_slug}"] = $this->props["{$option_name}_{$font_option_slug}"]; } } $field_key = "{$option_name}_{$slugs[0]}"; $global_setting_name = $this->get_global_setting_name( $field_key ); $global_setting_value = ET_Global_Settings::get_value( $global_setting_name ); $field_option_value = isset( $font_options[ $field_key ] ) ? $font_options[ $field_key ] : ''; if ( '' !== $field_option_value || ! $global_setting_value ) { $important = in_array( 'font', $important_options ) || $use_global_important ? ' !important' : ''; $font_styles = et_builder_set_element_font( $field_option_value, ( '' !== $important ), $global_setting_value ); if ( isset( $option_settings['css']['font'] ) ) { self::set_style( $function_name, array( 'selector' => $option_settings['css']['font'], 'declaration' => rtrim( $font_styles ), 'priority' => $this->_style_priority, ) ); } else { $style .= $font_styles; } } $size_option_name = "{$option_name}_{$slugs[1]}"; $default_size = isset( $this->fields_unprocessed[ $size_option_name ]['default'] ) ? $this->fields_unprocessed[ $size_option_name ]['default'] : ''; if ( isset( $font_options[ $size_option_name ] ) && ! in_array( trim( $font_options[ $size_option_name ] ), array( '', 'px', $default_size ) ) ) { $important = in_array( 'size', $important_options ) || $use_global_important ? ' !important' : ''; $style .= sprintf( 'font-size: %1$s%2$s; ', esc_html( et_builder_process_range_value( $font_options[ $size_option_name ] ) ), esc_html( $important ) ); } // Hover font size $size_hover = trim( et_pb_hover_options()->get_value( $size_option_name, $this->props, '' ) ); if ( ! in_array( $size_hover, array( '', 'px', $default_size ) ) ) { $important = in_array( 'size', $important_options ) || $use_global_important ? ' !important' : ''; $hover_style .= sprintf( 'font-size: %1$s%2$s; ', esc_html( et_builder_process_range_value( $size_hover ) ), esc_html( $important ) ); } $text_color_option_name = "{$option_name}_{$slugs[2]}"; // handle the value from old option $old_option_ref = isset( $option_settings['text_color'] ) && isset( $option_settings['text_color']['old_option_ref'] ) ? $option_settings['text_color']['old_option_ref'] : ''; $old_option_val = '' !== $old_option_ref && isset( $this->props[ $old_option_ref ] ) ? $this->props[ $old_option_ref ] : ''; $default_value = '' !== $old_option_val && isset( $option_settings['text_color'] ) && isset( $option_settings['text_color']['default'] ) ? $option_settings['text_color']['default'] : ''; if ( isset( $font_options[ $text_color_option_name ] ) && '' !== $font_options[ $text_color_option_name ] ) { $important = ' !important'; if ( $default_value !== $font_options[ $text_color_option_name ] ) { if ( isset( $option_settings['css']['color'] ) ) { self::set_style( $function_name, array( 'selector' => $option_settings['css']['color'], 'declaration' => sprintf( 'color: %1$s%2$s;', esc_html( $font_options[ $text_color_option_name ] ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } else { $style .= sprintf( 'color: %1$s%2$s; ', esc_html( $font_options[ $text_color_option_name ] ), esc_html( $important ) ); } } } $text_color_hover = et_pb_hover_options()->get_value( $text_color_option_name, $this->props ); if ( $default_value !== $text_color_hover && ! empty( $text_color_hover ) ) { $important = ' !important'; if ( isset( $option_settings['css']['color'] ) ) { $sel = et_pb_hover_options()->add_hover_to_order_class( $option_settings['css']['color'] ); self::set_style( $function_name, array( 'selector' => self::$_->array_get( $option_settings, 'css.color_hover', $sel ), 'declaration' => sprintf( 'color: %1$s%2$s;', esc_html( $text_color_hover ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } else { $hover_style .= sprintf( 'color: %1$s%2$s; ', esc_html( $text_color_hover ), esc_html( $important ) ); } } $letter_spacing_option_name = "{$option_name}_{$slugs[3]}"; $default_letter_spacing = isset( $this->fields_unprocessed[ $letter_spacing_option_name ]['default'] ) ? $this->fields_unprocessed[ $letter_spacing_option_name ]['default'] : ''; if ( isset( $font_options[ $letter_spacing_option_name ] ) && ! in_array( trim( $font_options[ $letter_spacing_option_name ] ), array( '', 'px', $default_letter_spacing ) ) ) { $important = in_array( 'letter-spacing', $important_options ) || $use_global_important ? ' !important' : ''; $style .= sprintf( 'letter-spacing: %1$s%2$s; ', esc_html( et_builder_process_range_value( $font_options[ $letter_spacing_option_name ] ) ), esc_html( $important ) ); if ( isset( $option_settings['css']['letter_spacing'] ) ) { self::set_style( $function_name, array( 'selector' => $option_settings['css']['letter_spacing'], 'declaration' => sprintf( 'letter-spacing: %1$s%2$s;', esc_html( et_builder_process_range_value( $font_options[ $letter_spacing_option_name ], 'letter_spacing' ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } } // Hover letter spacing $letter_spacing_hover = trim( et_pb_hover_options()->get_value( $letter_spacing_option_name, $this->props, '' ) ); if ( ! in_array( $letter_spacing_hover, array( '', 'px', $default_letter_spacing ) ) ) { $important = in_array( 'letter-spacing', $important_options ) || $use_global_important ? ' !important' : ''; if ( et_builder_is_hover_enabled( $letter_spacing_option_name, $this->props ) ) { $hover_style .= sprintf( 'letter-spacing: %1$s%2$s; ', esc_html( et_builder_process_range_value( $letter_spacing_hover ) ), esc_html( $important ) ); } if ( isset( $option_settings['css']['letter_spacing'] ) ) { if ( et_builder_is_hover_enabled( $letter_spacing_option_name, $this->props ) ) { $letter_spacing_hover = $this->props[ $letter_spacing_option_name_hover ]; if ( $default_letter_spacing !== $letter_spacing_hover ) { if ( isset( $option_settings['css']['color'] ) ) { $sel = et_pb_hover_options()->add_hover_to_order_class( $option_settings['css']['letter_spacing'] ); self::set_style( $function_name, array( 'selector' => self::$_->array_get( $option_settings, 'css.letter_spacing_hover', $sel ), 'declaration' => sprintf( 'color: %1$s%2$s;', esc_html( $letter_spacing_hover ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } } } } } $line_height_option_name = "{$option_name}_{$slugs[4]}"; if ( isset( $font_options[ $line_height_option_name ] ) ) { $default_line_height = isset( $this->fields_unprocessed[ $line_height_option_name ]['default'] ) ? $this->fields_unprocessed[ $line_height_option_name ]['default'] : ''; if ( ! in_array( trim( $font_options[ $line_height_option_name ] ), array( '', 'px', $default_line_height ) ) ) { $important = in_array( 'line-height', $important_options ) || $use_global_important ? ' !important' : ''; $style .= sprintf( 'line-height: %1$s%2$s; ', esc_html( et_builder_process_range_value( $font_options[ $line_height_option_name ], 'line_height' ) ), esc_html( $important ) ); if ( isset( $option_settings['css']['line_height'] ) ) { self::set_style( $function_name, array( 'selector' => $option_settings['css']['line_height'], 'declaration' => sprintf( 'line-height: %1$s%2$s;', esc_html( et_builder_process_range_value( $font_options[ $line_height_option_name ], 'line_height' ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } } } // Hover line height $line_height_hover = trim( et_pb_hover_options()->get_value( $line_height_option_name, $this->props, '' ) ); if ( ! in_array( $line_height_hover, array( '', 'px', $default_line_height ) ) ) { $important = in_array( 'line-height', $important_options ) || $use_global_important ? ' !important' : ''; if ( et_builder_is_hover_enabled( $line_height_option_name, $this->props ) ) { $hover_style .= sprintf( 'line-height: %1$s%2$s; ', esc_html( et_builder_process_range_value( $line_height_hover, 'line_height' ) ), esc_html( $important ) ); } if ( isset( $option_settings['css']['line_height'] ) ) { if ( et_builder_is_hover_enabled( $line_height_option_name, $this->props ) ) { if ( $default_line_height !== $line_height_hover ) { if ( isset( $option_settings['css']['color'] ) ) { $sel = et_pb_hover_options()->add_hover_to_order_class( $option_settings['css']['line_height'] ); self::set_style( $function_name, array( 'selector' => self::$_->array_get( $option_settings, 'css.line_height_hover', $sel ), 'declaration' => sprintf( 'color: %1$s%2$s;', esc_html( $line_height_hover ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } } } } } $text_align_option_name = "{$option_name}_{$slugs[5]}"; if ( isset( $font_options[ $text_align_option_name ] ) && '' !== $font_options[ $text_align_option_name ] ) { $important = in_array( 'text-align', $important_options ) || $use_global_important ? ' !important' : ''; $text_align = et_pb_get_alignment( $font_options[ $text_align_option_name ] ); if ( isset( $option_settings['css']['text_align'] ) ) { self::set_style( $function_name, array( 'selector' => $option_settings['css']['text_align'], 'declaration' => sprintf( 'text-align: %1$s%2$s;', esc_html( $text_align ), esc_html( $important ) ), 'priority' => $this->_style_priority, ) ); } else { $style .= sprintf( 'text-align: %1$s%2$s; ', esc_html( $text_align ), esc_html( $important ) ); } } if ( isset( $option_settings['use_all_caps'] ) && $option_settings['use_all_caps'] && 'on' === $this->props["{$option_name}_all_caps"] ) { $important = in_array( 'all_caps', $important_options ) || $use_global_important ? ' !important' : ''; $style .= sprintf( 'text-transform: uppercase%1$s; ', esc_html( $important ) ); } // apply both default and hover styles $style_states = array( 'default', 'hover' ); foreach ( $style_states as $style_state ) { $is_hover = 'hover' === $style_state; $style = $is_hover ? $hover_style : $style; if ( '' !== $style ) { $css_element = ! empty( $option_settings['css']['main'] ) ? $option_settings['css']['main'] : $this->main_css_element; // use different selector for plugin if defined if ( et_is_builder_plugin_active() && ! empty( $option_settings['css']['plugin_main'] ) ) { $css_element = $option_settings['css']['plugin_main']; } // $css_element might be an array, for example to apply the css for placeholders if ( is_array( $css_element ) ) { foreach( $css_element as $selector ) { if ( $is_hover ) { $selector = self::$_->array_get( $option_settings, 'css.hover', $this->add_hover_to_order_class( $selector, $is_hover ) ); } self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); } } else { if ( $is_hover ) { $css_element = self::$_->array_get( $option_settings, 'css.hover', $this->add_hover_to_order_class( $css_element, $is_hover ) ); } self::set_style( $function_name, array( 'selector' => $css_element, 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); if ( $is_placeholder ) { self::set_style( $function_name, array( 'selector' => $this->_maybe_add_hover_to_order_class( $css_element . '::-webkit-input-placeholder', $is_hover ), 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); self::set_style( $function_name, array( 'selector' => $this->_maybe_add_hover_to_order_class( $css_element . '::-moz-placeholder', $is_hover ), 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); self::set_style( $function_name, array( 'selector' => $this->_maybe_add_hover_to_order_class( $css_element . '::-ms-input-placeholder', $is_hover ), 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); } } } } // process mobile options foreach( $mobile_options_slugs as $mobile_option ) { $current_option_name = "{$option_name}_{$mobile_option}"; if ( isset( $font_options[ $current_option_name ] ) && '' !== $font_options[ $current_option_name ] ) { $current_desktop_option = $this->remove_suffix($mobile_option); $current_last_edited_slug = "{$option_name}_{$current_desktop_option}_last_edited"; $current_last_edited = isset( $font_options[ $current_last_edited_slug ] ) ? $font_options[ $current_last_edited_slug ] : ''; $current_responsive_status = et_pb_get_responsive_status( $current_last_edited ); // Don't print mobile styles if responsive UI isn't toggled on if ( ! $current_responsive_status ) { continue; } $current_media_query = false === strpos( $mobile_option, 'phone' ) ? 'max_width_980' : 'max_width_767'; $main_option_name = str_replace( array( '_tablet', '_phone' ), '', $mobile_option ); $css_property = str_replace( '_', '-', $main_option_name ); $css_option_name = 'font-size' === $css_property ? 'size' : $css_property; $important = in_array( $css_option_name, $important_options ) || $use_global_important ? ' !important' : ''; // Allow specific selector tablet and mobile, simply add _tablet or _phone suffix if ( isset( $option_settings['css'][ $mobile_option ] ) && "" !== $option_settings['css'][ $mobile_option ] ) { $selector = $option_settings['css'][ $mobile_option ]; } elseif ( isset( $option_settings['css'][ $main_option_name ] ) || isset( $option_settings['css']['main'] ) ) { $selector = isset( $option_settings['css'][ $main_option_name ] ) ? $option_settings['css'][ $main_option_name ] : $option_settings['css']['main']; } elseif ( et_is_builder_plugin_active() && ! empty( $option_settings['css']['plugin_main'] ) ) { $selector = $option_settings['css']['plugin_main']; } else { $selector = $this->main_css_element; } // $selector might be an array, for example to apply the css for placeholders if ( is_array( $selector ) ) { foreach( $selector as $selector_item ) { self::set_style( $function_name, array( 'selector' => $selector_item, 'declaration' => sprintf( '%1$s: %2$s%3$s;', esc_html( $css_property ), esc_html( et_builder_process_range_value( $font_options[ $current_option_name ] ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } } else { self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => sprintf( '%1$s: %2$s%3$s;', esc_html( $css_property ), esc_html( et_builder_process_range_value( $font_options[ $current_option_name ] ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); if ( $is_placeholder ) { self::set_style( $function_name, array( 'selector' => $selector . '::-webkit-input-placeholder', 'declaration' => sprintf( '%1$s: %2$s%3$s;', esc_html( $css_property ), esc_html( et_builder_process_range_value( $font_options[ $current_option_name ] ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); self::set_style( $function_name, array( 'selector' => $selector . '::-moz-placeholder', 'declaration' => sprintf( '%1$s: %2$s%3$s;', esc_html( $css_property ), esc_html( et_builder_process_range_value( $font_options[ $current_option_name ] ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); self::set_style( $function_name, array( 'selector' => $selector . '::-ms-input-placeholder', 'declaration' => sprintf( '%1$s: %2$s%3$s;', esc_html( $css_property ), esc_html( et_builder_process_range_value( $font_options[ $current_option_name ] ) ), esc_html( $important ) ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } } } } } } function process_advanced_background_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'background', false ) ) { return; } $style = ''; $settings = $this->advanced_fields['background']; $important = isset( $settings['css']['important'] ) && $settings['css']['important'] ? ' !important' : ''; // Possible values for use_background_* variables are true, false, or 'fields_only' $use_background_color_gradient_options = $this->advanced_fields['background']['use_background_color_gradient']; $use_background_image_options = $this->advanced_fields['background']['use_background_image']; $use_background_color_options = $this->advanced_fields['background']['use_background_color']; $background_images = array(); if ( $use_background_color_gradient_options && 'fields_only' !== $use_background_color_gradient_options ) { $use_background_color_gradient = $this->props['use_background_color_gradient']; $background_color_gradient_type = $this->props['background_color_gradient_type']; $background_color_gradient_direction = $this->props['background_color_gradient_direction']; $background_color_gradient_direction_radial = $this->props['background_color_gradient_direction_radial']; $background_color_gradient_start = $this->props['background_color_gradient_start']; $background_color_gradient_end = $this->props['background_color_gradient_end']; $background_color_gradient_start_position = $this->props['background_color_gradient_start_position']; $background_color_gradient_end_position = $this->props['background_color_gradient_end_position']; $background_color_gradient_overlays_image = $this->props['background_color_gradient_overlays_image']; if ( 'on' === $use_background_color_gradient ) { $has_background_color_gradient = true; $background_images[] = $this->get_gradient( array( 'type' => $background_color_gradient_type, 'direction' => $background_color_gradient_direction, 'radial_direction' => $background_color_gradient_direction_radial, 'color_start' => $background_color_gradient_start, 'color_end' => $background_color_gradient_end, 'start_position' => $background_color_gradient_start_position, 'end_position' => $background_color_gradient_end_position, ) ); } } if ( $use_background_image_options && 'fields_only' !== $use_background_image_options ) { $background_image = $this->props['background_image']; $background_size_default = isset( $this->fields_unprocessed[ 'background_size' ]['default'] ) ? $this->fields_unprocessed[ 'background_size' ]['default'] : ''; $background_size = $this->props['background_size']; $background_position_default = isset( $this->fields_unprocessed[ 'background_position' ]['default'] ) ? $this->fields_unprocessed[ 'background_position' ]['default'] : ''; $background_position = $this->props['background_position']; $background_repeat_default = isset( $this->fields_unprocessed[ 'background_repeat' ]['default'] ) ? $this->fields_unprocessed[ 'background_repeat' ]['default'] : ''; $background_repeat = $this->props['background_repeat']; $background_blend_default = isset( $this->fields_unprocessed[ 'background_blend' ]['default'] ) ? $this->fields_unprocessed[ 'background_blend' ]['default'] : ''; $background_blend = $this->props['background_blend']; $parallax = $this->props['parallax']; if ( $this->featured_image_background ) { $featured_image = isset( $this->props['featured_image'] ) ? $this->props['featured_image'] : ''; $featured_placement = isset( $this->props['featured_placement'] ) ? $this->props['featured_placement'] : ''; $featured_image_src_obj = wp_get_attachment_image_src( get_post_thumbnail_id( get_the_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 ) { $background_image = $featured_image_src; } } if ( '' !== $background_image && 'on' !== $parallax ) { $has_background_image = true; $background_images[] = sprintf( 'url(%1$s)', esc_html( $background_image ) ); if ( '' !== $background_size && $background_size_default !== $background_size ) { $style .= sprintf( 'background-size: %1$s; ', esc_html( $background_size ) ); } if ( '' !== $background_position && $background_position_default !== $background_position ) { $style .= sprintf( 'background-position: %1$s; ', esc_html( str_replace( '_', ' ', $background_position ) ) ); } if ( '' !== $background_repeat && $background_repeat_default !== $background_repeat ) { $style .= sprintf( 'background-repeat: %1$s; ', esc_html( $background_repeat ) ); } if ( '' !== $background_blend && $background_blend_default !== $background_blend ) { $style .= sprintf( 'background-blend-mode: %1$s; ', esc_html( $background_blend ) ); // Force background-color: initial; if ( isset( $has_background_color_gradient, $has_background_image ) ) { $style .= sprintf( 'background-color: initial%1$s; ', esc_html( $important ) ); } } } } if ( ! empty( $background_images ) ) { // The browsers stack the images in the opposite order to what you'd expect. if ( 'on' !== $background_color_gradient_overlays_image ) { $background_images = array_reverse( $background_images ); } $style .= sprintf( 'background-image: %1$s%2$s;', esc_html( join( ', ', $background_images ) ), $important ); } if ( $use_background_color_options && 'fields_only' !== $use_background_color_options ) { if ( ! isset( $has_background_color_gradient, $has_background_image ) && 'off' !== self::$_->array_get( $this->props, 'use_background_color', false ) ) { $background_color = $this->props['background_color']; if ( '' !== $background_color ) { $style .= sprintf( 'background-color: %1$s%2$s; ', esc_html( $background_color ), esc_html( $important ) ); } } } if ( '' !== $style ) { $css_element = ! empty( $settings['css']['main'] ) ? $settings['css']['main'] : $this->main_css_element; self::set_style( $function_name, array( 'selector' => $css_element, 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); } // Background hover options $background_color_hover = et_pb_hover_options()->get_value( 'background_color', $this->props ); if ( ! $background_color_hover || ! et_builder_is_hover_enabled( 'background', $this->props ) ) { return; } if ( $use_background_color_options && 'fields_only' !== $use_background_color_options ) { if ( ! isset( $has_background_color_gradient, $has_background_image ) && 'off' !== self::$_->array_get( $this->props, 'use_background_color', false ) ) { if ( '' !== $background_color_hover ) { $style .= sprintf( 'background-color: %1$s%2$s; ', esc_html( $background_color_hover ), esc_html( $important ) ); } } } if ( '' !== $style ) { $main = self::$_->array_get( $settings, 'css.main', $this->main_css_element ); $css_element = self::$_->array_get( $settings, 'css.hover', et_pb_hover_options()->add_hover_to_order_class( $main ) ); self::set_style( $function_name, array( 'selector' => $css_element, 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); } } function process_advanced_text_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'text', false ) ) { return; } $text_options = $this->advanced_fields['text']; if ( isset( $text_options['css'] ) && is_array( $text_options['css'] ) ) { $text_css = $text_options['css']; $text_orientation_default = isset( $this->fields_unprocessed['text_orientation']['default'] ) ? $this->fields_unprocessed['text_orientation']['default'] : ''; $text_orientation = $this->get_text_orientation() !== $text_orientation_default ? $this->get_text_orientation() : ''; // Normally, text orientation attr adds et_pb_text_align_* class name to its module wrapper // In some cases, it needs to target particular children inside the module. Thus, only prints // styling if selector is given if ( isset( $text_css['text_orientation'] ) && '' !== $text_orientation ) { self::set_style( $function_name, array( 'selector' => $text_css['text_orientation'], 'declaration' => sprintf( 'text-align: %1$s;', esc_attr( $text_orientation ) ), 'priority' => $this->_style_priority, ) ); } } } /** * Output border and border radius styling */ function process_advanced_borders_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } global $et_fb_processing_shortcode_object; $borders = self::$_->array_get( $this->advanced_fields, 'borders', array( 'default' => array() ) ); $border_field = ET_Builder_Module_Fields_Factory::get( 'Border' ); if ( is_array( $borders ) && ! empty( $borders ) ) { foreach ( $borders as $border_name => $border ) { // Enable module to disable border options if ( false === $border ) { continue; } // Blurb image specific adjustment if ( 'image' === $border_name && 'et_pb_blurb' === $this->slug && 'on' === self::$_->array_get( $this->props, 'use_icon' ) ) { continue; } // Blog specific adjustment if ( 'fullwidth' === $border_name && 'et_pb_blog' === $this->slug && 'on' !== self::$_->array_get( $this->props, 'fullwidth' ) ) { continue; } // Login & signup specific adjustment if ( 'fields_focus' === $border_name && in_array( $this->slug, array( 'et_pb_login', 'et_pb_signup' ) ) && 'on' !== self::$_->array_get( $this->props, 'use_focus_border_color' ) ) { continue; } $is_border_default = 'default' === $border_name; $suffix = $is_border_default ? '' : "_{$border_name}"; if ( $is_border_default && $this->slug !== $function_name ) { // This module's shortcode callback is being used to render another module (like accordion item // uses toggle ) so we need to make sure border option overrides are taken from the other module // instead of this one. $fields = self::get_advanced_fields( $this->get_post_type(), 'all', $function_name ); $border = self::$_->array_get( $fields, 'advanced_common.border', array() ); } // Backward compatibility. For 3rd party modules which define `_add_additional_border_fields` and do not have `process_advanced_border_options` if ( $is_border_default && method_exists( $this, '_add_additional_border_fields' ) ) { $border = self::$_->array_get( $this->advanced_fields, 'border', array() ); } // Do not add overflow:hidden for some modules. $no_overflow_module = array( 'et_pb_social_media_follow', 'et_pb_social_media_follow_network', 'et_pb_fullwidth_menu', ); $overflow = ! in_array( $function_name, $no_overflow_module ); self::set_style( $function_name, array( 'selector' => self::$_->array_get( $border, 'css.main.border_radii', $this->main_css_element ), 'declaration' => $border_field->get_radii_style( $this->props, $this->advanced_fields, $suffix, $overflow ), 'priority' => $this->_style_priority, ) ); if ( et_builder_is_hover_enabled( "border_radii$suffix", $this->props ) ) { $main = self::$_->array_get( $border, 'css.hover', $this->main_css_element ); $main = self::$data_utils->array_get( $border, 'css.main.border_radii', $main ); $main = 'default' !== $border_name ? et_pb_hover_options()->add_hover_to_selectors( $main ) : et_pb_hover_options()->add_hover_to_order_class( $main ); $selector = self::$data_utils->array_get( $border, 'css.main.border_radii_hover', $main ); self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => $border_field->get_radii_style( $this->props, $this->advanced_fields, $suffix, $overflow, true ), 'priority' => $this->_style_priority, ) ); } self::set_style( $function_name, array( 'selector' => self::$_->array_get( $border, 'css.main.border_styles', $this->main_css_element ), 'declaration' => $border_field->get_borders_style( $this->props, $this->advanced_fields, $suffix ), 'priority' => $this->_style_priority, ) ); $main = self::$_->array_get( $border, 'css.hover', $this->main_css_element ); $main = self::$data_utils->array_get( $border, 'css.main.border_styles', $main ); $main = 'default' !== $border_name ? et_pb_hover_options()->add_hover_to_selectors( $main ) : et_pb_hover_options()->add_hover_to_order_class( $main ); $selector = self::$data_utils->array_get( $border, 'css.main.border_styles_hover', $main ); self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => $border_field->get_borders_style( $this->props, $this->advanced_fields, $suffix, true ), 'priority' => $this->_style_priority, ) ); } } if ( ! $et_fb_processing_shortcode_object && $border_field->needs_border_reset_class( $function_name, $this->props ) ) { // Try to apply old method for plugins without vb support if ( 'on' !== $this->vb_support ) { add_filter( "{$function_name}_shortcode_output", array( $border_field, 'add_border_reset_class' ), 10, 2 ); } $this->add_classname( 'et_pb_with_border' ); } if ( method_exists( $this, 'process_advanced_border_options' ) ) { // Backwards Compatibility // Call it after processing default fields because it's additional processing and is not replacement. $this->process_advanced_border_options( $function_name ); } } /** * Adds Filter styles to the page custom css code * * Wrapper for `generate_css_filters` used for module defaults */ function process_advanced_filter_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } // Module has to explicitly set false to disable filters options if ( false === self::$_->array_get( $this->advanced_fields, 'filters', false ) ) { return; } return $this->generate_css_filters( $function_name ); } function process_max_width_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'max_width', false ) ) { return; } // Usage setting $setting_defaults = array( 'use_max_width' => true, 'use_module_alignment' => true, ); $this->advanced_fields['max_width'] = wp_parse_args( $this->advanced_fields['max_width'], $setting_defaults ); $is_max_width_customized = false; $hover = et_pb_hover_options(); // Max width if ( $this->advanced_fields['max_width']['use_max_width'] ) { $max_width_default = $this->fields_unprocessed['max_width']['default']; $desktop_default = $max_width_default; $max_width = self::$_->array_get( $this->props, 'max_width', '' ); $max_width_tablet = self::$_->array_get( $this->props, 'max_width_tablet', '' ); $max_width_phone = self::$_->array_get( $this->props, 'max_width_phone', '' ); $max_width_hover = $hover->get_value( 'max_width', $this->props, '' ); $max_width_last_edited = $this->props['max_width_last_edited']; $max_width_responsive_active = et_pb_get_responsive_status( $max_width_last_edited ); if ( $max_width_responsive_active ) { foreach ( array( 'max_width', 'max_width_tablet', 'max_width_phone' ) as $value ) { if ( $$value === $max_width_default ) { $$value = ''; } else { // Set current value is smaller breakpoint's default $max_width_default = $$value; } } } else if( $max_width === $max_width_default ) { $max_width = ''; } if ( '' !== $max_width_tablet || '' !== $max_width_phone || '' !== $max_width ) { $max_width_options = $this->advanced_fields['max_width']; $max_width_options_css = isset( $max_width_options['css'] ) ? $max_width_options['css'] : array(); $selector = isset( $max_width_options_css['main'] ) ? $max_width_options_css['main'] : '%%order_class%%'; $additional_css = $this->get_max_width_additional_css(); $max_width_attrs = array( 'max_width' ); // Append !important tag if ( isset( $max_width_options_css['important'] ) ) { $additional_css = ' !important;'; } if ( $max_width_responsive_active ) { $max_width_values = array( 'desktop_only' => $max_width, 'tablet' => $max_width_tablet, 'phone' => $max_width_phone, ); $max_width_attrs = array_merge( $max_width_attrs, array( 'max_width_tablet', 'max_width_phone' ) ); } else { $max_width_values = array( 'desktop' => $max_width, ); } // Update $is_max_width_customized if one of max_width* value is modified foreach ( $max_width_attrs as $max_width_attr ) { if ( $is_max_width_customized ) { break; } if ( ! in_array( self::$_->array_get($this->props, $max_width_attr ), array( '', $max_width_default ) ) ) { $is_max_width_customized = true; } } et_pb_generate_responsive_css( $max_width_values, $selector, 'max-width', $function_name, $additional_css ); } // Hover styles if ( '' !== $max_width_hover ) { // Apply 100% max-width if there is only hover max-width set so that transiton works $selector = isset( $max_width_options_css['main'] ) ? $max_width_options_css['main'] : '%%order_class%%'; $is_max_width_customized = true; if ( '' === $max_width ) { $hover_max_width = $desktop_default ? $desktop_default : '100%'; $hover_base = array( 'selector' => $selector, 'declaration' => esc_html( "max-width: $hover_max_width;" ), ); ET_Builder_Element::set_style( $function_name, $hover_base ); } $selector_hover = et_pb_hover_options()->add_hover_to_order_class( $selector ); $additional_css = $this->get_max_width_additional_css(); $hover_style = array( 'selector' => $selector_hover, 'declaration' => esc_html( "max-width: {$max_width_hover}{$additional_css};" ) ); ET_Builder_Element::set_style( $function_name, $hover_style ); } } // Module Alignment if ( $this->advanced_fields['max_width']['use_module_alignment'] ) { $module_alignment_styles = array( 'left' => 'margin-left: 0px !important; margin-right: auto !important;', 'center' => 'margin-left: auto !important; margin-right: auto !important;', 'right' => 'margin-left: auto !important; margin-right: 0px !important;', ); $module_alignment = isset( $this->props['module_alignment'] ) ? $this->props['module_alignment'] : ''; if ( ( $is_max_width_customized || ! $this->advanced_fields['max_width']['use_max_width'] ) && isset( $module_alignment_styles[ $module_alignment ] ) ) { $module_alignment_selector = self::$_->array_get( $this->advanced_fields, 'max_width.css.module_alignment', '%%order_class%%.et_pb_module' ); self::set_style( $function_name, array( 'selector' => $module_alignment_selector, 'declaration' => $module_alignment_styles[ $module_alignment ], 'priority' => 20, ) ); } } } function process_advanced_custom_margin_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_vb_support() && ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'margin_padding', false ) ) { return; } $hover = et_pb_hover_options(); $style = ''; $style_padding = ''; $style_margin = ''; $style_mobile = array(); $style_mobile_padding = array(); $style_mobile_margin = array(); $important_options = array(); $is_important_set = isset( $this->advanced_fields['margin_padding']['css']['important'] ); $use_global_important = $is_important_set && 'all' === $this->advanced_fields['margin_padding']['css']['important']; $css = isset( $this->advanced_fields['margin_padding']['css'] ) ? $this->advanced_fields['margin_padding']['css'] : array(); $item_mappings = array( 'top' => 0, 'right' => 1, 'bottom' => 2, 'left' => 3, ); if ( $is_important_set && is_array( $this->advanced_fields['margin_padding']['css']['important'] ) ) { $important_options = $this->advanced_fields['margin_padding']['css']['important']; } $custom_margin = $this->advanced_fields['margin_padding']['use_margin'] ? $this->props['custom_margin'] : ''; $custom_padding = $this->advanced_fields['margin_padding']['use_padding'] ? $this->props['custom_padding'] : ''; $custom_margin_responsive_active = isset( $this->props['custom_margin_last_edited'] ) ? et_pb_get_responsive_status( $this->props['custom_margin_last_edited'] ) : false; $custom_margin_mobile = $custom_margin_responsive_active && $this->advanced_fields['margin_padding']['use_margin'] && ( isset( $this->props['custom_margin_tablet'] ) || isset( $this->props['custom_margin_phone'] ) ) ? array ( 'tablet' => isset( $this->props['custom_margin_tablet'] ) ? $this->props['custom_margin_tablet'] : '', 'phone' => isset( $this->props['custom_margin_phone'] ) ? $this->props['custom_margin_phone'] : '', ) : ''; $custom_padding_responsive_active = isset( $this->props['custom_padding_last_edited'] ) ? et_pb_get_responsive_status( $this->props['custom_padding_last_edited'] ) : false; $custom_padding_mobile = $custom_padding_responsive_active && $this->advanced_fields['margin_padding']['use_padding'] && ( isset( $this->props['custom_padding_tablet'] ) || isset( $this->props['custom_padding_phone'] ) ) ? array ( 'tablet' => isset( $this->props['custom_padding_tablet'] ) ? $this->props['custom_padding_tablet'] : '', 'phone' => isset( $this->props['custom_padding_phone'] ) ? $this->props['custom_padding_phone'] : '', ) : ''; if ( '' !== $custom_padding || ! empty( $custom_padding_mobile ) ) { $important = in_array( 'custom_padding', $important_options ) || $use_global_important ? true : false; $has_padding_selector = isset( $this->advanced_fields['margin_padding']['css'] ) && isset( $this->advanced_fields['margin_padding']['css']['padding'] ); $padding_styling = '' !== $custom_padding ? et_builder_get_element_style_css( $custom_padding, 'padding', $important ) : ''; if ( $has_padding_selector ) { $style_padding .= $padding_styling; } else { $style .= $padding_styling; } if ( ! empty( $custom_padding_mobile ) ) { foreach ( $custom_padding_mobile as $device => $settings ) { $padding_mobile_styling = '' !== $settings ? et_builder_get_element_style_css( $settings, 'padding', $important ) : ''; if ( $has_padding_selector ) { $style_mobile_padding[ $device ][] = $padding_mobile_styling; } else { $style_mobile[ $device ][] = $padding_mobile_styling; } } } // Selective Paddings $selective_paddings = array_filter( array( 'top' => isset( $css['padding-top'] ) ? $css['padding-top'] : false, 'right' => isset( $css['padding-right'] ) ? $css['padding-right'] : false, 'bottom' => isset( $css['padding-bottom'] ) ? $css['padding-bottom'] : false, 'left' => isset( $css['padding-left'] ) ? $css['padding-left'] : false, ) ); // Only run the following if selective-padding selector is defined if ( ! empty( $selective_paddings ) ) { // Loop each padding sides. Selective padding works by creating filtered custom_margin value on the fly, then pass it to existin declaration builder // Ie custom_padding = 10px|10px|10px|10px. Selective padding for padding-top works by creating 10px||| value on the fly then pass it to declaration builder foreach ( $selective_paddings as $corner => $selective_padding_selectors ) { // Default selective padding value: empty on all sides $selective_padding = array( '', '', '', '' ); // Get padding order key. Expected order: top|right|bottom|left $selective_padding_key = $item_mappings[ $corner ]; // Explode custom padding value into array $selective_padding_array = explode( '|', $custom_padding ); // Pick current padding side's value $selective_padding_value = isset( $selective_padding_array[ $selective_padding_key ] ) ? $selective_padding_array[ $selective_padding_key ] : ''; // Set selective padding value to $selective_padding $selective_padding[ $selective_padding_key ] = $selective_padding_value; // If selective padding for current side is found, set style for it $selective_padding_filtered = array_filter( $selective_padding ); if ( ! empty( $selective_padding_filtered ) ) { self::set_style( $function_name, array( 'selector' => $selective_padding_selectors, 'declaration' => rtrim( et_builder_get_element_style_css( implode( '|', $selective_padding ), 'padding' ) ), 'priority' => $this->_style_priority, ) ); } // Check wheter responsive padding is activated and padding has mobile value if ( $custom_padding_responsive_active && is_array( $custom_padding_mobile ) ) { // Assume no mobile padding value first $has_selective_padding_mobile = false; // Set default selective padding mobile $selective_padding_mobile = array( 'tablet' => array( '', '', '', '' ), 'phone' => array( '', '', '', '' ), ); // Loop padding mobile. This results per-breakpoint padding value foreach ( $custom_padding_mobile as $breakpoint => $custom_padding_device ) { // Explode per-breakpoint padding value into array $custom_padding_device_array = explode( '|', $custom_padding_device ); // Get current padding side value on current breakpoint $selective_padding_mobile_value = isset( $custom_padding_device_array[ $selective_padding_key ] ) ? $custom_padding_device_array[ $selective_padding_key ] : ''; // Set picked value into current padding side on current breakpoint $selective_padding_mobile[ $breakpoint ][ $selective_padding_key ] = $selective_padding_mobile_value; // If the side of padding on current breakpoint has value, build CSS declaration for it mark selective padding mobile as exist $selective_padding_mobile[ $breakpoint ] = array_filter( $selective_padding_mobile[ $breakpoint ] ); if ( ! empty( $selective_padding_mobile[ $breakpoint ] ) ) { $selective_padding_mobile[ $breakpoint ] = array( et_builder_get_element_style_css( implode( '|', $selective_padding_mobile[ $breakpoint ] ), 'padding' ) ); $has_selective_padding_mobile = true; } } // Set style for selective padding on mobile if ( $has_selective_padding_mobile ) { $this->process_advanced_mobile_margin_options( $function_name, $selective_padding_mobile, $selective_padding_selectors ); } } } } } if ( '' !== $custom_margin || ! empty( $custom_margin_mobile ) ) { $important = in_array( 'custom_margin', $important_options ) || $use_global_important ? true : false; $has_margin_selector = isset( $this->advanced_fields['margin_padding']['css'] ) && isset( $this->advanced_fields['margin_padding']['css']['margin'] ); $margin_styling = '' !== $custom_margin ? et_builder_get_element_style_css( $custom_margin, 'margin', $important ) : ''; if ( $has_margin_selector ) { $style_margin .= $margin_styling; } else { $style .= $margin_styling; } if ( ! empty( $custom_margin_mobile ) ) { foreach ( $custom_margin_mobile as $device => $settings ) { $margin_mobile_styling = '' !== $settings ? et_builder_get_element_style_css( $settings, 'margin', $important ) : ''; if ( $has_margin_selector ) { $style_mobile_margin[ $device ][] = $margin_mobile_styling; } else { $style_mobile[ $device ][] = $margin_mobile_styling; } } } } if ( '' !== $style_padding ) { $css_element_padding = $this->advanced_fields['margin_padding']['css']['padding']; self::set_style( $function_name, array( 'selector' => $css_element_padding, 'declaration' => rtrim( $style_padding ), 'priority' => $this->_style_priority, ) ); } if ( '' !== $style_margin ) { $css_element_margin = $this->advanced_fields['margin_padding']['css']['margin']; self::set_style( $function_name, array( 'selector' => $css_element_margin, 'declaration' => rtrim( $style_margin ), 'priority' => $this->_style_priority, ) ); } if ( '' !== $style ) { $css_element = ! empty( $this->advanced_fields['margin_padding']['css']['main'] ) ? $this->advanced_fields['margin_padding']['css']['main'] : $this->main_css_element; self::set_style( $function_name, array( 'selector' => $css_element, 'declaration' => rtrim( $style ), 'priority' => $this->_style_priority, ) ); } if ( ! empty( $style_mobile_padding ) ) { $this->process_advanced_mobile_margin_options( $function_name, $style_mobile_padding, $this->advanced_fields['margin_padding']['css']['padding'] ); } if ( ! empty( $style_mobile_margin ) ) { $this->process_advanced_mobile_margin_options( $function_name, $style_mobile_margin, $this->advanced_fields['margin_padding']['css']['margin'] ); } if ( ! empty( $style_mobile ) ) { $css_element = ! empty( $this->advanced_fields['margin_padding']['css']['main'] ) ? $this->advanced_fields['margin_padding']['css']['main'] : $this->main_css_element; $this->process_advanced_mobile_margin_options( $function_name, $style_mobile, $css_element ); } // Hover styles $custom_margin_hover = $hover->get_value( 'custom_margin', $this->props ); if ( '' !== $custom_margin_hover && et_builder_is_hover_enabled( 'custom_margin', $this->props ) ) { $css_element_margin = self::$_->array_get( $this->advanced_fields, 'margin_padding.css.margin', $this->main_css_element ); self::set_style( $function_name, array( 'selector' => $this->add_hover_to_order_class( $css_element_margin ), 'declaration' => rtrim( et_builder_get_element_style_css( $custom_margin_hover, 'margin', true ) ), 'priority' => 20, ) ); } $custom_padding_hover = $hover->get_value( 'custom_padding', $this->props, '' ); if ( '' !== $custom_padding_hover && et_builder_is_hover_enabled( 'custom_padding', $this->props ) ) { $css_element_padding = self::$_->array_get( $this->advanced_fields, 'margin_padding.css.padding', $this->main_css_element ); self::set_style( $function_name, array( 'selector' => $this->add_hover_to_order_class( $css_element_padding ), 'declaration' => rtrim( et_builder_get_element_style_css( $custom_padding_hover, 'padding', true ) ), 'priority' => 20, ) ); } } function process_advanced_mobile_margin_options( $function_name, $style_mobile, $css_element ) { foreach( $style_mobile as $device => $style ) { if ( ! empty( $style ) ) { $current_media_query = 'tablet' === $device ? 'max_width_980' : 'max_width_767'; $current_media_css = ''; foreach( $style as $css_code ) { $current_media_css .= $css_code; } if ( '' === $current_media_css ) { continue; } self::set_style( $function_name, array( 'selector' => $css_element, 'declaration' => rtrim( $current_media_css ), 'priority' => $this->_style_priority, 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } } } protected function get_hover_value( $option ) { $enabled_option = $option === 'background_color' ? 'background' : $option; $original_value = self::$_->array_get( $this->props, $option ); $hover_enabled = et_pb_hover_options()->is_enabled( $enabled_option, $this->props ); $value = et_pb_hover_options()->get_value( $option, $this->props ); return ( ! $hover_enabled || $original_value === $value ) ? null : $value; } function process_advanced_button_options( $function_name ) { // Disable if module doesn't set advanced_fields property and has no VB support if ( ! $this->has_advanced_fields ) { return; } if ( ! self::$_->array_get( $this->advanced_fields, 'button', false ) ) { return; } $hover = et_pb_hover_options(); foreach ( $this->advanced_fields['button'] as $option_name => $option_settings ) { $button_custom = $this->props["custom_{$option_name}"]; $button_text_size = $this->props["{$option_name}_text_size"]; $button_text_size_tablet = $this->props["{$option_name}_text_size_tablet"]; $button_text_size_phone = $this->props["{$option_name}_text_size_phone"]; $button_text_size_last_edited = $this->props["{$option_name}_text_size_last_edited"]; $button_text_color = $this->props["{$option_name}_text_color"]; $button_bg_color = $this->props["{$option_name}_bg_color"]; $button_border_width = $this->props["{$option_name}_border_width"]; $button_border_color = $this->props["{$option_name}_border_color"]; $button_border_radius = $this->props["{$option_name}_border_radius"]; $button_font = $this->props["{$option_name}_font"]; $button_letter_spacing = $this->props["{$option_name}_letter_spacing"]; $button_letter_spacing_tablet = $this->props["{$option_name}_letter_spacing_tablet"]; $button_letter_spacing_phone = $this->props["{$option_name}_letter_spacing_phone"]; $button_letter_spacing_last_edited = $this->props["{$option_name}_letter_spacing_last_edited"]; $button_use_icon = $this->props["{$option_name}_use_icon"]; $button_icon = $this->props["{$option_name}_icon"]; $button_icon_color = $this->props["{$option_name}_icon_color"]; $button_icon_color_hover = et_pb_hover_options()->get_value( "{$option_name}_icon_color", $this->props ); $button_icon_placement = $this->props["{$option_name}_icon_placement"]; $button_on_hover = $this->props["{$option_name}_on_hover"]; $button_text_size_hover = $this->get_hover_value("{$option_name}_text_size" ); $button_text_color_hover = $this->get_hover_value("{$option_name}_text_color" ); $button_border_width_hover = $this->get_hover_value("{$option_name}_border_width" ); $button_bg_color_hover = $this->get_hover_value("{$option_name}_bg_color" ); $button_border_color_hover = $this->get_hover_value("{$option_name}_border_color" ); $button_border_radius_hover = $this->get_hover_value("{$option_name}_border_radius" ); $button_letter_spacing_hover = $this->get_hover_value("{$option_name}_letter_spacing" ); $button_letter_spacing_hover_tablet = isset( $this->props["{$option_name}_letter_spacing_hover_tablet"] ) ? $this->props["{$option_name}_letter_spacing_hover_tablet"] : ''; $button_letter_spacing_hover_phone = isset( $this->props["{$option_name}_letter_spacing_hover_phone"] ) ? $this->props["{$option_name}_letter_spacing_hover_phone"] : ''; $button_letter_spacing_hover_last_edited = isset( $this->props["{$option_name}_letter_spacing_hover_last_edited"] ) ? $this->props["{$option_name}_letter_spacing_hover_last_edited"] : ''; $button_icon_pseudo_selector = $button_icon_placement === 'left' ? ':before' : ':after'; // Specific selector needs to be explicitly defined to make button alignment works if ( isset( $option_settings['use_alignment'] ) && $option_settings['use_alignment'] && isset( $option_settings['css'] ) && isset( $option_settings['css']['alignment'] ) ) { $button_alignment = $this->props["{$option_name}_alignment"]; $button_alignment_selector = $option_settings['css']['alignment']; if ( '' !== $button_alignment && '' !== $button_alignment_selector ) { self::set_style( $function_name, array( 'selector' => $button_alignment_selector, 'declaration' => esc_html( "text-align: {$button_alignment};" ), ) ); } } if ( 'on' === $button_custom ) { $is_default_button_text_size = $this->_is_field_default( 'button_text_size', $button_text_size ); $is_default_button_icon_placement = $this->_is_field_default( 'button_icon_placement', $button_icon_placement ); $is_default_button_on_hover = $this->_is_field_default( 'button_on_hover', $button_on_hover ); $is_default_button_icon = $this->_is_field_default( 'button_icon', $button_icon ); $is_default_hover_placement = $is_default_button_on_hover && $is_default_button_icon_placement; $button_text_size_processed = $is_default_button_text_size ? '20px' : et_builder_process_range_value( $button_text_size ); $button_text_size_hover_processed = strlen( $button_text_size_hover ) && $button_text_size !== $button_text_size_hover ? et_builder_process_range_value( $button_text_size_hover ) : ''; $button_border_radius_processed = '' !== $button_border_radius && 'px' !== $button_border_radius ? et_builder_process_range_value( $button_border_radius ) : ''; $button_border_radius_hover_processed = null !== $button_border_radius_hover && 'px' !== $button_border_radius_hover && $button_border_radius_hover !== $button_border_radius ? et_builder_process_range_value( $button_border_radius_hover ) : ''; $button_use_icon = '' === $button_use_icon ? 'on' : $button_use_icon; $css_element = ! empty( $option_settings['css']['main'] ) ? $option_settings['css']['main'] : $this->main_css_element . ' .et_pb_button'; $css_element_processed = $css_element; $is_dbp = et_is_builder_plugin_active(); if ( $is_dbp && ! empty( $option_settings['css']['plugin_main'] ) ) { $css_element_processed = $option_settings['css']['plugin_main']; } else if ( ! $is_dbp ) { $css_element_processed = "body #page-container {$css_element}"; } if ( $is_dbp ) { $button_bg_color .= '' !== $button_bg_color ? ' !important' : ''; $button_border_radius_processed .= '' !== $button_border_radius_processed ? ' !important' : ''; $button_border_radius_hover_processed .= '' !== $button_border_radius_hover_processed ? ' !important' : ''; } $global_use_icon_value = et_builder_option( 'all_buttons_icon' ); $main_element_styles_padding_important = 'no' === $global_use_icon_value && 'off' !== $button_use_icon; $main_element_styles = sprintf( '%1$s %2$s %3$s %4$s %5$s %6$s %7$s %8$s %9$s', '' !== $button_text_color ? sprintf( 'color:%1$s !important;', $button_text_color ) : '', '' !== $button_bg_color && 'et_pb_button' !== $this->slug ? sprintf( 'background:%1$s;', $button_bg_color ) : '', '' !== $button_border_width && 'px' !== $button_border_width ? sprintf( 'border-width:%1$s !important;', et_builder_process_range_value( $button_border_width ) ) : '', '' !== $button_border_color ? sprintf( 'border-color:%1$s;', $button_border_color ) : '', '' !== $button_border_radius_processed ? sprintf( 'border-radius:%1$s;', $button_border_radius_processed ) : '', '' !== $button_letter_spacing && 'px' !== $button_letter_spacing ? sprintf( 'letter-spacing:%1$s;', et_builder_process_range_value( $button_letter_spacing ) ) : '', ! $is_default_button_text_size ? sprintf( 'font-size:%1$s;', $button_text_size_processed ) : '', '' !== $button_font ? et_builder_set_element_font( $button_font, true ) : '', 'off' === $button_on_hover ? sprintf( 'padding-left:%1$s%3$s; padding-right: %2$s%3$s;', 'left' === $button_icon_placement ? '2em' : '0.7em', 'left' === $button_icon_placement ? '0.7em' : '2em', $main_element_styles_padding_important ? ' !important' : '' ) : '' ); self::set_style( $function_name, array( 'selector' => $css_element_processed, 'declaration' => rtrim( $main_element_styles ), ) ); // if button has default icon position or disabled globally and not enabled in module then no padding css should be generated. $on_hover_padding = $is_default_button_icon_placement || ('default' === $button_use_icon && 'no' === $global_use_icon_value) ? '' : sprintf( 'padding-left:%1$s%3$s; padding-right: %2$s%3$s;', 'left' === $button_icon_placement ? '2em' : '0.7em', 'left' === $button_icon_placement ? '0.7em' : '2em', $main_element_styles_padding_important ? ' !important' : '' ); // Avoid adding useless style when value equals its default $button_letter_spacing_hover = $this->_is_field_default( $hover->get_hover_field( 'button_letter_spacing' ), $button_letter_spacing_hover) ? '' : $button_letter_spacing_hover; $main_element_styles_hover = sprintf( '%1$s %2$s %3$s %4$s %5$s %6$s %7$s %8$s', null !== $button_text_color_hover ? sprintf( 'color:%1$s !important;', $button_text_color_hover ) : '', null !== $button_bg_color_hover ? sprintf( 'background:%1$s !important;', $button_bg_color_hover ) : '', null !== $button_border_color_hover ? sprintf( 'border-color:%1$s !important;', $button_border_color_hover ) : '', '' !== $button_border_radius_hover_processed ? sprintf( 'border-radius:%1$s;', $button_border_radius_hover_processed ) : '', null !== $button_letter_spacing_hover && 'px' !== $button_letter_spacing_hover && $button_letter_spacing_hover !== $button_letter_spacing ? sprintf( 'letter-spacing:%1$s;', et_builder_process_range_value( $button_letter_spacing_hover ) ) : '', 'off' === $button_on_hover ? '' : $on_hover_padding, '' !== $button_text_size_hover_processed ? sprintf( 'font-size:%1$s !important;', $button_text_size_hover_processed ) : '', null !== $button_border_width_hover ? sprintf( 'border-width:%1$s !important;', $button_border_width_hover ) : '' ); self::set_style( $function_name, array( 'selector' => $css_element_processed . ':hover', 'declaration' => rtrim( $main_element_styles_hover ), ) ); $main_element_styles_after_hover = ''; if ( 'off' === $button_use_icon ) { $main_element_styles_after = 'display:none !important;'; $selector = sprintf( '%1$s:before, %1$s:after', $css_element_processed ); $custom_padding = $this->props['custom_padding']; $no_icon_styles = ''; if ( empty( $custom_padding ) ) { $no_icon_styles .= 'padding: 0.3em 1em !important;'; } else { $padding_array = explode( '|', $custom_padding ); if ( empty( $padding_array[1] ) ) { $no_icon_styles .= 'padding-right: 1em !important;'; } if ( empty( $padding_array[3] ) ) { $no_icon_styles .= 'padding-left: 1em !important;'; } } if ( ! empty( $no_icon_styles ) ) { self::set_style( $function_name, array( 'selector' => $css_element_processed . ',' . $css_element_processed . ':hover', 'declaration' => rtrim( $no_icon_styles ), ) ); } } else { $button_icon_code = '' !== $button_icon ? str_replace( ';', '', str_replace( '&#x', '', html_entity_decode( et_pb_process_font_icon( $button_icon ) ) ) ) : ''; $button_icon_size_hover = $button_icon_size = ''; if ( '' !== $button_text_size_processed ) { $button_icon_size = '35' !== $button_icon_code ? '1em' : '1.6em'; } if ( '' !== $button_text_size_hover_processed ) { $button_icon_size_hover = '35' !== $button_icon_code ? '1em' : '1.6em'; } $main_element_styles_after = sprintf( '%1$s %2$s %3$s %4$s %5$s %6$s %7$s', '' !== $button_icon_color ? sprintf( 'color:%1$s;', $button_icon_color ) : '', '' !== $button_icon_code ? sprintf( 'line-height:%1$s;', '35' !== $button_icon_code ? '1.7em' : '1em' ) : '', '' !== $button_icon_code ? sprintf( 'font-size:%1$s !important;', $button_icon_size ) : '', $is_default_hover_placement ? '' : sprintf( 'opacity:%1$s;', 'off' !== $button_on_hover ? '0' : '1' ), 'off' !== $button_on_hover && '' !== $button_icon_code ? sprintf( 'margin-left: %1$s; %2$s: auto;', 'left' === $button_icon_placement ? '-1.3em' : '-1em', 'left' === $button_icon_placement ? 'right' : 'left' ) : '', 'off' === $button_on_hover ? sprintf( 'margin-left: %1$s; %2$s:auto;', 'left' === $button_icon_placement ? '-1.3em' : '.3em', 'left' === $button_icon_placement ? 'right' : 'left' ) : '', ( ! $is_default_button_icon_placement && in_array( $button_use_icon , array( 'default', 'on' ) ) ? 'display: inline-block;' : '' ) ); if ( '' !== $button_icon_size_hover && $button_icon_size_hover !== $button_icon_size ) { $main_element_styles_after_hover = sprintf( 'font-size: %1$s', $button_icon_size_hover ); } if ( '' !== $button_icon_color_hover && $button_icon_color_hover !== $button_icon_color ) { $main_element_styles_after_hover = sprintf( 'color: %1$s', $button_icon_color_hover ); } // Reverse icon position if ( 'left' === $button_icon_placement ) { $button_icon_left_content = '' !== $button_icon_code ? 'content: attr(data-icon);' : ''; self::set_style( $function_name, array( 'selector' => $css_element_processed . ':after', 'declaration' => 'display: none;', ) ); if ( et_is_builder_plugin_active() ) { self::set_style( $function_name, array( 'selector' => '.et_pb_row ' . $css_element_processed . ':hover', 'declaration' => 'padding-right: 1em; padding-left: 2em;', ) ); } self::set_style( $function_name, array( 'selector' => $css_element_processed . ':before', 'declaration' => $button_icon_left_content . ' ; font-family: "ETmodules" !important;', ) ); } // if button has default icon/hover/placement and disabled globally or not enabled in module then no :after:hover css should be generated. if ( ! ( $is_default_button_icon && $is_default_hover_placement ) && ( 'default' !== $button_use_icon || 'no' !== $global_use_icon_value ) ) { $hover_after_styles = sprintf( '%1$s %2$s %3$s', '' !== $button_icon_code ? sprintf( 'margin-left:%1$s;', '35' !== $button_icon_code ? '.3em' : '0' ) : '', '' !== $button_icon_code ? sprintf( '%1$s: auto; margin-left: %2$s;', 'left' === $button_icon_placement ? 'right' : 'left', 'left' === $button_icon_placement ? '-1.3em' : '.3em' ) : '', 'off' !== $button_on_hover ? 'opacity: 1;' : '' ); self::set_style( $function_name, array( 'selector' => $css_element_processed . ':hover' . $button_icon_pseudo_selector, 'declaration' => rtrim( $hover_after_styles ), ) ); } if ( '' === $button_icon && ! $is_default_button_text_size ) { $default_icons_size = '1.6em'; $custom_icon_size = $button_text_size_processed; self::set_style( $function_name, array( 'selector' => $css_element_processed . $button_icon_pseudo_selector, 'declaration' => sprintf( 'font-size:%1$s;', $default_icons_size ), ) ); self::set_style( $function_name, array( 'selector' => 'body.et_button_custom_icon #page-container ' . $css_element . $button_icon_pseudo_selector, 'declaration' => sprintf( 'font-size:%1$s;', $custom_icon_size ), ) ); } if ( '' === $button_icon && '' !== $button_text_size_hover_processed ) { $default_icons_size = '1.6em'; $custom_icon_size = $button_text_size_hover_processed; self::set_style( $function_name, array( 'selector' => $css_element_processed . ':hover' . $button_icon_pseudo_selector, 'declaration' => sprintf( 'font-size:%1$s;', $default_icons_size ), ) ); self::set_style( $function_name, array( 'selector' => 'body.et_button_custom_icon #page-container ' . $css_element . ':hover' . $button_icon_pseudo_selector, 'declaration' => sprintf( 'font-size:%1$s;', $custom_icon_size ), ) ); } $selector = $css_element_processed . $button_icon_pseudo_selector; } foreach( array( 'tablet', 'phone' ) as $device ) { $current_media_query = 'tablet' === $device ? 'max_width_980' : 'max_width_767'; $current_text_size = 'tablet' === $device ? et_builder_process_range_value( $button_text_size_tablet ) : et_builder_process_range_value( $button_text_size_phone ); $current_letter_spacing = 'tablet' === $device ? et_builder_process_range_value( $button_letter_spacing_tablet ) : et_builder_process_range_value( $button_letter_spacing_phone ); $current_letter_spacing_hover = 'tablet' === $device ? et_builder_process_range_value( $button_letter_spacing_hover_tablet ) : et_builder_process_range_value( $button_letter_spacing_hover_phone ); $current_text_size_responsive_active = et_pb_get_responsive_status( $button_text_size_last_edited ); $current_letter_spacing_responsive_active = et_pb_get_responsive_status( $button_letter_spacing_last_edited ); $current_letter_spacing_hover_responsive_active = et_pb_get_responsive_status( $button_letter_spacing_hover_last_edited ); if ( ( '' !== $current_text_size && '0px' !== $current_text_size ) || '' !== $current_letter_spacing ) { self::set_style( $function_name, array( 'selector' => $css_element_processed . ',' . $css_element_processed . $button_icon_pseudo_selector, 'declaration' => sprintf( '%1$s %2$s', $current_text_size_responsive_active && '' !== $current_text_size && '0px' !== $current_text_size ? sprintf( 'font-size:%1$s !important;', $current_text_size ) : '', $current_letter_spacing_responsive_active && '' !== $current_letter_spacing ? sprintf( 'letter-spacing:%1$s;', $current_letter_spacing ) : '' ), 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } if ( $current_letter_spacing_hover_responsive_active && '' !== $current_letter_spacing_hover ) { self::set_style( $function_name, array( 'selector' => $css_element_processed . ':hover', 'declaration' => sprintf( 'letter-spacing:%1$s;', $current_letter_spacing_hover ), 'media_query' => ET_Builder_Element::get_media_query( $current_media_query ), ) ); } } self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => rtrim( $main_element_styles_after ), ) ); self::set_style( $function_name, array( 'selector' => et_pb_hover_options()->add_hover_to_selectors( $selector ), 'declaration' => rtrim( $main_element_styles_after_hover ), ) ); // Background Options Styling $background_base_name = "{$option_name}_bg"; $background_images = array(); $background_prefix = "{$background_base_name}_"; $background_style = ''; // Background Gradient $use_background_color_gradient = $this->props["{$background_prefix}use_color_gradient"]; $background_color_gradient_type = $this->props["{$background_prefix}color_gradient_type"]; $background_color_gradient_direction = $this->props["{$background_prefix}color_gradient_direction"]; $background_color_gradient_direction_radial = $this->props["{$background_prefix}color_gradient_direction_radial"]; $background_color_gradient_start = $this->props["{$background_prefix}color_gradient_start"]; $background_color_gradient_end = $this->props["{$background_prefix}color_gradient_end"]; $background_color_gradient_start_position = $this->props["{$background_prefix}color_gradient_start_position"]; $background_color_gradient_end_position = $this->props["{$background_prefix}color_gradient_end_position"]; $background_color_gradient_overlays_image = $this->props["{$background_prefix}color_gradient_overlays_image"]; if ( 'on' === $use_background_color_gradient ) { $has_background_color_gradient = true; $background_images[] = $this->get_gradient( array( 'type' => $background_color_gradient_type, 'direction' => $background_color_gradient_direction, 'radial_direction' => $background_color_gradient_direction_radial, 'color_start' => $background_color_gradient_start, 'color_end' => $background_color_gradient_end, 'start_position' => $background_color_gradient_start_position, 'end_position' => $background_color_gradient_end_position, ) ); } // Background Image $background_image = $this->props["{$background_prefix}image"]; $background_size_default = isset( $this->fields_unprocessed["{$background_prefix}size"]["default"] ) ? $this->fields_unprocessed[ "{$background_prefix}size" ]["default"] : ""; $background_size = $this->props["{$background_prefix}size"]; $background_position_default = isset( $this->fields_unprocessed["{$background_prefix}position"]["default"] ) ? $this->fields_unprocessed[ "{$background_prefix}position" ]["default"] : ""; $background_position = $this->props["{$background_prefix}position"]; $background_repeat_default = isset( $this->fields_unprocessed["{$background_prefix}repeat"]["default"] ) ? $this->fields_unprocessed[ "{$background_prefix}repeat" ]["default"] : ""; $background_repeat = $this->props["{$background_prefix}repeat"]; $background_blend_default = isset( $this->fields_unprocessed["{$background_prefix}blend"]["default"] ) ? $this->fields_unprocessed[ "{$background_prefix}blend" ]["default"] : ""; $background_blend = $this->props["{$background_prefix}blend"]; $parallax = $this->props["{$background_prefix}parallax"]; if ( '' !== $background_image && 'on' !== $parallax ) { $has_background_image = true; $background_images[] = sprintf( 'url(%1$s)', esc_html( $background_image ) ); if ( '' !== $background_size && $background_size_default !== $background_size ) { $background_style .= sprintf( 'background-size: %1$s; ', esc_html( $background_size ) ); } if ( '' !== $background_position && $background_position_default !== $background_position ) { $background_style .= sprintf( 'background-position: %1$s; ', esc_html( str_replace( '_', ' ', $background_position ) ) ); } if ( '' !== $background_repeat && $background_repeat_default !== $background_repeat ) { $background_style .= sprintf( 'background-repeat: %1$s; ', esc_html( $background_repeat ) ); } if ( '' !== $background_blend && $background_blend_default !== $background_blend ) { $background_style .= sprintf( 'background-blend-mode: %1$s; ', esc_html( $background_blend ) ); // Force background-color: initial; if ( isset( $has_background_color_gradient, $has_background_image ) ) { $background_style .= sprintf( 'background-color: initial%1$s; ', esc_html( ' !important' ) ); } } } if ( ! empty( $background_images ) ) { // The browsers stack the images in the opposite order to what you'd expect. if ( 'on' !== $background_color_gradient_overlays_image ) { $background_images = array_reverse( $background_images ); } $background_style .= sprintf( 'background-image: %1$s !important;', esc_html( join( ', ', $background_images ) ) ); } // Reset color if gradient and image is used together if ( ! isset( $has_background_color_gradient, $has_background_image ) ) { $background_color = $this->props["{$background_prefix}color"]; if ( '' !== $background_color ) { $background_style .= sprintf( 'background-color: %1$s; ', esc_html( $background_color ) ); } } if ( '' !== $background_style ) { self::set_style( $function_name, array( 'selector' => $css_element_processed, 'declaration' => rtrim( $background_style ), 'priority' => $this->_style_priority, ) ); } } } } function process_custom_css_fields( $function_name ) { if ( empty( $this->custom_css_fields ) ) { return false; } foreach ( $this->custom_css_fields as $slug => $option ) { $css = $this->props["custom_css_{$slug}"]; $hover_css = self::get_hover_value("custom_css_{$slug}"); $order_class = isset( $this->main_css_element ) && count( explode( ' ', $this->main_css_element ) ) === 1 ? $selector = $this->main_css_element : '%%order_class%%'; $selector = ! empty( $option['selector'] ) ? $option['selector'] : ''; if ( false === strpos( $selector, '%%order_class%%' ) ) { if ( ! ( isset( $option['no_space_before_selector'] ) && $option['no_space_before_selector'] ) && '' !== $selector ) { $selector = " {$selector}"; } $selector = "{$order_class}{$selector}"; } if ( '' !== $css ) { self::set_style( $function_name, array( 'selector' => $selector, 'declaration' => trim( $css ), ) ); } if ( ! empty( $hover_css ) ) { self::set_style( $function_name, array( 'selector' => $this->add_hover_to_selectors( $selector ), 'declaration' => trim( $hover_css ), ) ); } } } function process_box_shadow( $function_name ) { /** * @var ET_Builder_Module_Field_BoxShadow $box_shadow */ $box_shadow = ET_Builder_Module_Fields_Factory::get( 'BoxShadow' ); $advanced_fields = self::$_->array_get( $this->advanced_fields, 'box_shadow', array( 'default' => array() ) ); if ( ! $advanced_fields ) { return ''; } // A module can have multiple advanced box shadow fields (i.e. default + button's box shadow) which are // generated by advanced button fields foreach ( $advanced_fields as $option_name => $option_settings ) { // Enable module to explicitly disable box shadow fields (box shadow is automatically) // added to all module by default if ( false === $option_settings ) { continue; } // Prepare attribute for getting box shadow's css declaration $declaration_args = array( 'suffix' => $option_name === 'default' ? '' : "_{$option_name}", 'important' => self::$_->array_get( $option_settings, 'css.important', false ), ); // Enable module to conditionally print box shadow styling if particular attribute(s) have specific value. // This works in 'OR' logic. Once an attribute doesn't match the value, this box shadow styling is skipped $show_if = self::$_->array_get( $option_settings, 'css.show_if', array() ); if ( ! empty( $show_if ) ) { $show_if_skip = false; foreach ( $show_if as $show_if_attr_name => $show_if_attr_value ) { $attr_value = self::$_->array_get( $this->props, $show_if_attr_name, '' ); // Skip printing this box shadow value once one of the attribute value doesn't // match with given value if ( $attr_value !== $show_if_attr_value ) { $show_if_skip = true; break; } } if ( $show_if_skip ) { continue; } } // Enable module to conditionally print box shadow styling if particular attribute(s) doesn't have // specific value. This works on 'OR' logic. Once an attribute matches the supplied value, this // box shadow styling is skipped $show_if_not = self::$_->array_get( $option_settings, 'css.show_if_not', array() ); if ( ! empty( $show_if_not ) ) { $show_if_not_skip = false; foreach ( $show_if_not as $show_if_not_attr_name => $show_if_not_attr_value ) { $attr_value = self::$_->array_get( $this->props, $show_if_not_attr_name, '' ); // Skip printing this box value once this attribute value matches the given value if ( $attr_value === $show_if_not_attr_value ) { $show_if_not_skip = true; break; } } if ( $show_if_not_skip ) { continue; } } $overlay = self::$_->array_get( $option_settings, 'css.overlay', false ); $has_video_bg = ! empty( $atts['background_video_mp4'] ) || ! empty( $atts['background_video_webm'] ); $inset = $box_shadow->is_inset( $box_shadow->get_value( $this->props, $declaration_args ) ); $inset_hover = $box_shadow->is_inset( $box_shadow->get_value( $this->props, array_merge( $declaration_args, array( 'hover' => true ) ) ) ); $selector = self::$_->array_get( $option_settings, 'css.main', '%%order_class%%' ); // Default box shadow affects module while other affects group element it belongs to (ie image, button, etc) $hover_selector = 'default' === $option_name ? $this->add_hover_to_order_class( $selector ) : $this->add_hover_to_selectors( $selector ); if ( ( $inset && 'inset' == $overlay ) || 'always' == $overlay || $has_video_bg ) { self::set_style( $function_name, $box_shadow->get_overlay_style( $function_name, $selector, $this->props, $declaration_args ) ); } else { self::set_style( $function_name, $box_shadow->get_style( $selector, $this->props, $declaration_args ) ); } if ( ( $inset_hover && 'inset' == $overlay ) || 'always' == $overlay || $has_video_bg ) { self::set_style( $function_name, $box_shadow->get_overlay_style( $function_name, $hover_selector, $this->props, array_merge( $declaration_args, array( 'hover' => true ) ) ) ); } else { self::set_style( $function_name, $box_shadow->get_style( $hover_selector, $this->props, array_merge( $declaration_args, array( 'hover' => true ) ) ) ); } } } function make_options_filterable() { if ( isset( $this->advanced_fields ) ) { $this->advanced_fields = apply_filters( "{$this->slug}_advanced_fields", $this->advanced_fields, $this->slug, $this->main_css_element ); } if ( isset( $this->custom_css_fields ) ) { $this->custom_css_fields = apply_filters( "{$this->slug}_custom_css_fields", $this->custom_css_fields, $this->slug, $this->main_css_element ); } } function disable_wptexturize( $shortcodes ) { $shortcodes[] = $this->slug; return $shortcodes; } static function compare_by_priority( $a, $b ) { $a_priority = ! empty( $a['priority'] ) ? (int) $a['priority'] : self::DEFAULT_PRIORITY; $b_priority = ! empty( $b['priority'] ) ? (int) $b['priority'] : self::DEFAULT_PRIORITY; if ( isset( $a['_order_number'], $b['_order_number'] ) && ( $a_priority === $b_priority ) ) { return $a['_order_number'] - $b['_order_number']; } return $a_priority - $b_priority; } /* * Reorder toggles based on the priority with respect to manually ordered items with no priority * */ static function et_pb_order_toggles_by_priority( $toggles_array ) { if ( empty( $toggles_array ) ) { return array(); } $high_priority_toggles = array(); $low_priority_toggles = array(); $manually_ordered_toggles = array(); // fill 3 arrays based on priority foreach ( $toggles_array as $toggle_id => $toggle_data ) { if ( isset( $toggle_data['priority'] ) ) { if ( $toggle_data['priority'] < 10 ) { $high_priority_toggles[ $toggle_id ] = $toggle_data; } else { $low_priority_toggles[ $toggle_id ] = $toggle_data; } } else { // keep the original order of options without priority defined $manually_ordered_toggles[ $toggle_id ] = $toggle_data; } } // order high and low priority toggles uasort( $high_priority_toggles, array( 'self', 'compare_by_priority' ) ); uasort( $low_priority_toggles, array( 'self', 'compare_by_priority' ) ); // merge 3 arrays to get the correct order of toggles. return array_merge( $high_priority_toggles, $manually_ordered_toggles, $low_priority_toggles ); } static function compare_by_name( $a, $b ) { return strcasecmp( $a->name, $b->name ); } static function get_modules_count( $post_type ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); $overall_count = count( $parent_modules ) + count( $child_modules ); return $overall_count; } static function get_modules_js_array( $post_type ) { $modules = array(); $parent_modules = self::get_parent_modules( $post_type ); if ( ! empty( $parent_modules ) ) { /** * Sort modules alphabetically by name. */ $sorted_modules = $parent_modules; uasort( $sorted_modules, array( 'self', 'compare_by_name' ) ); foreach( $sorted_modules as $module ) { /** * Replace single and double quotes with %% and || respectively * to avoid js conflicts */ $module_name = str_replace( array( '"', '"', '"', '"' ) , '%%', $module->name ); $module_name = str_replace( array( "'", ''', ''' ) , '||', $module_name ); $modules[] = sprintf( '{ "title" : "%1$s", "label" : "%2$s"%3$s}', esc_js( $module_name ), esc_js( $module->slug ), ( isset( $module->fullwidth ) && $module->fullwidth ? ', "fullwidth_only" : "on"' : '' ) ); } } return '[' . implode( ',', $modules ) . ']'; } static function get_modules_array( $post_type = '', $include_child = false ) { $modules = array(); $module_icons = self::get_module_icons(); if ( ! empty( $post_type ) ) { $parent_modules = self::get_parent_modules( $post_type ); if ( $include_child ) { $parent_modules = array_merge( $parent_modules, self::get_child_modules( $post_type )); } if ( ! empty( $parent_modules ) ) { $sorted_modules = $parent_modules; } } else { $parent_modules = self::get_parent_modules(); if ( $include_child ) { $parent_modules = array_merge( $parent_modules, self::get_child_modules()); } if ( ! empty( $parent_modules ) ) { $all_modules = array(); foreach( $parent_modules as $post_type => $post_type_modules ) { foreach ( $post_type_modules as $module_slug => $module ) { $all_modules[ $module_slug ] = $module; } } $sorted_modules = $all_modules; } } if ( ! empty( $sorted_modules ) ) { /** * Sort modules alphabetically by name. */ uasort( $sorted_modules, array( 'self', 'compare_by_name' ) ); foreach( $sorted_modules as $module ) { /** * Replace single and double quotes with %% and || respectively * to avoid js conflicts */ $module_name = str_replace( '"', '%%', $module->name ); $module_name = str_replace( "'", '||', $module_name ); $module_name_plural = str_replace( '"', '%%', empty( $module->plural ) ? $module->name : $module->plural ); $module_name_plural = str_replace( "'", '||', $module_name_plural ); $_module = array( 'title' => esc_attr( $module_name ), 'plural' => esc_attr( $module_name_plural ), 'label' => esc_attr( $module->slug ), 'is_parent' => $module->type === 'child' ? 'off' : 'on', 'is_official_module' => $module->_is_official_module, 'vb_support' => isset( $module->vb_support ) ? $module->vb_support : 'off', ); if ( isset( $module->fullwidth ) && $module->fullwidth ) { $_module['fullwidth_only'] = 'on'; } // Get module icon character (font-icon) $icon = self::$_->array_get( $module_icons, "{$module->slug}.icon"); if ( $icon ) { $_module['icon'] = $icon; } // Get module icon svg from fetched svg content $icon_svg = self::$_->array_get( $module_icons, "{$module->slug}.icon_svg"); if ( $icon_svg ) { $_module['icon_svg'] = $icon_svg; } $modules[] = $_module; } } return $modules; } static function get_fb_unsupported_modules() { $parent_modules = self::get_parent_modules(); $unsupported_modules_array = array(); foreach( $parent_modules as $post_type => $post_type_modules ) { foreach ( $post_type_modules as $module_slug => $module ) { if ( ! isset( $module->vb_support ) || 'off' === $module->vb_support ) { $unsupported_modules_array[] = $module_slug; } } } return array_unique( $unsupported_modules_array ); } /** * Returns a regex pattern that includes all parent module slugs. * * @since 3.1 Renamed from `get_parent_shortcodes()` to `get_parent_slugs_regex()` * @since 1.0 * * @param string $post_type * * @return string */ public static function get_parent_slugs_regex( $post_type = 'page' ) { $slugs = array(); $parent_modules = self::get_parent_modules( $post_type ); if ( ! empty( $parent_modules ) ) { foreach( $parent_modules as $module ) { $slugs[] = $module->slug; } } return implode( '|', $slugs ); } /** * Returns a regex pattern that includes all child module slugs. * * @since 3.1 Renamed from `get_child_shortcodes()` to `get_child_slugs_regex()` * @since 1.0 * * @param string $post_type * * @return string */ public static function get_child_slugs_regex( $post_type = 'page' ) { $slugs = array(); $child_modules = self::get_child_modules( $post_type ); if ( ! empty( $child_modules ) ) { foreach( $child_modules as $module ) { if ( ! empty( $module->slug ) ) { $slugs[] = $module->slug; } } } return implode( '|', $slugs ); } static function get_child_slugs( $post_type ) { $child_slugs = array(); $child_modules = self::get_parent_modules( $post_type ); if ( ! empty( $child_modules ) ) { foreach( $child_modules as $module ) { if ( ! empty( $module->child_slug ) ) { $child_slugs[ $module->slug ] = $module->child_slug; } } } return $child_slugs; } public static function get_raw_content_slugs( $post_type ) { $shortcodes = array(); $parent_modules = self::get_parent_modules( $post_type ); if ( ! empty( $parent_modules ) ) { foreach( $parent_modules as $module ) { if ( isset( $module->use_raw_content ) && $module->use_raw_content ) { $shortcodes[] = $module->slug; } } } $child_modules = self::get_child_modules( $post_type ); if ( ! empty( $child_modules ) ) { foreach( $child_modules as $module ) { if ( isset( $module->use_raw_content ) && $module->use_raw_content ) { $shortcodes[] = $module->slug; } } } return implode( '|', $shortcodes ); } static function get_modules_templates( $post_type, $slugs_array ) { $all_modules = self::get_parent_and_child_modules( $post_type ); $templates_array = array(); if ( empty( $slugs_array ) ) { return; } foreach ( $slugs_array as $slug ) { if ( ! isset( $all_modules[ $slug ] ) ) { return ''; } $module = $all_modules[ $slug ]; $templates_array[] = array( 'slug' => $slug, 'template' => $module->build_microtemplate(), ); } if ( ET_BUILDER_OPTIMIZE_TEMPLATES ) { $templates_array = array( 'templates' => $templates_array, 'unique' => self::$_unique_bb_keys_values, ); } return $templates_array; } static function output_templates( $post_type = '', $start_from = 0, $amount = 999 ) { $all_modules = self::get_parent_and_child_modules( $post_type ); $modules_names = array_keys( $all_modules ); $output = array(); $output['templates'] = array(); if ( ! empty( $all_modules ) ) { for ( $i = 0; $i < ET_BUILDER_AJAX_TEMPLATES_AMOUNT; $i++ ) { if ( isset( $modules_names[ $i ] ) ) { $module = $all_modules[ $modules_names[ $i ] ]; $output['templates'][ $module->slug ] = self::optimize_bb_chunk( $module->build_microtemplate() ); } else { break; } } } if ( ET_BUILDER_OPTIMIZE_TEMPLATES ) { $output['unique'] = self::$_unique_bb_keys_values; } return $output; } static function get_structure_module_slugs() { if ( ! empty( self::$structure_module_slugs ) ) { return self::$structure_module_slugs; } $structure_modules = self::get_structure_modules(); self::$structure_module_slugs = array(); foreach( $structure_modules as $structural_module ) { self::$structure_module_slugs[] = $structural_module->slug; } return self::$structure_module_slugs; } static function get_structure_modules() { if ( ! empty( self::$structure_modules ) ) { return self::$structure_modules; } $parent_modules = self::get_parent_modules( 'et_pb_layout' ); self::$structure_modules = array(); foreach ( $parent_modules as $parent_module ) { if ( isset( $parent_module->is_structure_element ) && $parent_module->is_structure_element ) { $parent_module->plural = empty( $parent_module->plural ) ? $parent_module->name : $parent_module->plural; self::$structure_modules[] = $parent_module; } } return self::$structure_modules; } /** * Get a filtered list of modules. * * @since 3.10 * * @param string $post_type Leave empty for any. * @param string $type 'parent' or 'child'. Leave empty for any. * * @return array */ static function get_modules( $post_type = '', $type = '' ) { $modules = array(); foreach ( self::$modules as $slug => $module ) { if ( '' !== $post_type && ! in_array( $post_type, $module->post_types ) ) { continue; } if ( '' !== $type && ! $module->type !== $type ) { continue; } $modules[ $slug ] = $module; } return $modules; } static function get_custom_post_type_fallback_modules( $type = 'parent' ) { $modules = 'child' === $type ? self::$child_modules : self::$parent_modules; // Most of the time, page module is expected to be used as disabled post type fallback if ( isset( $modules['page'] ) ) { return $modules['page']; } // Post module is also expected to be used if ( isset( $modules['post'] ) ) { return $modules['post']; } // If all else fail, use all modules return self::get_modules(); } static function get_parent_modules( $post_type = '' ) { if ( ! empty( $post_type ) ) { // We get all modules when post type is not enabled so that posts that have // had their post type support disabled still load all necessary modules. $parent_modules = ! empty( self::$parent_modules[ $post_type ] ) ? self::$parent_modules[ $post_type ] : self::get_custom_post_type_fallback_modules( 'parent' ); } else { $parent_modules = self::$parent_modules; } return apply_filters( 'et_builder_get_parent_modules', $parent_modules, $post_type ); } static function get_child_modules( $post_type = '' ) { if ( ! empty( $post_type ) ) { // We get all modules when post type is not enabled so that posts that have // had their post type support disabled still load all necessary modules. $child_modules = ! empty( self::$child_modules[ $post_type ] ) ? self::$child_modules[ $post_type ] : self::get_custom_post_type_fallback_modules( 'child' ); } else { $child_modules = self::$child_modules; } return apply_filters( 'et_builder_get_child_modules', $child_modules, $post_type ); } /** * Get registered module icons * * @since 3.1 * * @return array */ static function get_module_icons() { /** * Filters Module Icons displayed in Add Module modals. * * @param array $module_icons Array of all registered module icons. */ $module_icons = apply_filters( 'et_builder_module_icons', self::$module_icons ); // Loop module icons foreach ( $module_icons as $key => $icons ) { if ( isset( $icons['icon_path'] ) ) { // Get svg content based on given svg's path $icon_svg = file_exists( $icons['icon_path'] ) ? file_get_contents( $icons['icon_path'] ) : false; if ( $icon_svg ) { $module_icons[ $key ]['icon_svg'] = $icon_svg; // Remove icon path attribute since it's no longer used unset( $module_icons[ $key ]['icon_path'] ); } } } return $module_icons; } /** * Get combined array of child and parent modules for provided post_type * * @since 3.1 * * @return array */ static function get_parent_and_child_modules( $post_type = '' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); return array_merge( $parent_modules, $child_modules ); } /** * Get a module instance for provided post type by its slug. * * @since 3.10 * * @param string $slug * @param string $post_type * * @return ET_Builder_Element|null */ public static function get_module( $slug, $post_type = 'post' ) { $modules = self::get_parent_and_child_modules( $post_type ); return self::$_->array_get( $modules, $slug ); } /** * Outputs list of all module help videos array * * @since 3.1 * * @return array */ static function get_help_videos() { return self::$module_help_videos; } static function get_featured_image_background_modules( $post_type = '' ) { $parent_modules = self::get_parent_modules( $post_type ); $featured_image_background_modules = array(); foreach ( $parent_modules as $slug => $parent_module ) { if ( ! empty( $parent_module->featured_image_background ) ) { $featured_image_background_modules[] = $slug; } } /** * Filters list of modules with support of featured image as background. * * @since 3.1 * * @param array[] $featured_image_background_modules List of modules with support of featured image as background. */ return apply_filters( 'et_pb_featured_image_background_modules', $featured_image_background_modules ); } public static function get_toggles( $post_type ) { static $toggles_array = array(); if ( $toggles_array ) { return $toggles_array; } $modules = self::get_parent_and_child_modules( $post_type ); $custom_modules = array(); foreach ( $modules as $module_slug => $module ) { if ( ! $module->_is_official_module ) { $custom_modules[ $module_slug ] = $module; } foreach ( $module->settings_modal_toggles as $tab_slug => &$tab_data ) { if ( ! isset( $tab_data['toggles'] ) ) { continue; } $tab_data['toggles'] = self::et_pb_order_toggles_by_priority( $tab_data['toggles'] ); } $toggles_array[ $module_slug ] = $module->settings_modal_toggles; } if ( $custom_modules ) { // Add missing toggle definitions for any existing toggles used in custom modules foreach ( $custom_modules as $module_slug => $module ) { foreach ( $module->get_complete_fields() as $field_name => $field_info ) { $tab_slug = self::$_->array_get( $field_info, 'tab_slug', 'general' ); $toggle_slug = self::$_->array_get( $field_info, 'toggle_slug' ); if ( ! $toggle_slug || isset( $toggles_array[ $module_slug ][ $tab_slug ]['toggles'][ $toggle_slug ] ) ) { continue; } // Find existing definition foreach ( $toggles_array as $_module_slug => $tabs ) { foreach ( $tabs as $tab => $toggles ) { if ( isset( $toggles['toggles'][ $toggle_slug ] ) ) { self::$_->array_set( $toggles_array, "{$module_slug}.{$tab_slug}.toggles.{$toggle_slug}", $toggles['toggles'][ $toggle_slug ] ); $toggles_array[ $module_slug ][ $tab_slug ]['toggles'] = self::et_pb_order_toggles_by_priority( $toggles_array[ $module_slug ][ $tab_slug ]['toggles'] ); break 2; } } } // Add missing unregistered toggles to the list if ( ! isset( $toggles_array[ $module_slug ][ $tab_slug ]['toggles'][ $toggle_slug ] ) ) { if ( ! isset( $toggles_array[ $module_slug ][ $tab_slug ] ) ) { $toggles_array[ $module_slug ][ $tab_slug ] = array( 'toggles' => array( $toggle_slug ) ); } else { $toggles_array[ $module_slug ][ $tab_slug ]['toggles'][] = $toggle_slug; } } } } } return $toggles_array; } public static function get_tabs( $post_type = '' ) { $official_tabs = array( 'general' => '', 'advanced' => '', 'custom_css' => '' ); $tabs_array = array(); $modules = self::get_parent_and_child_modules( $post_type ); foreach( $modules as $module_slug => $module ) { if ( '' === $post_type ) { foreach( $module as $_module_slug => $_module ) { // Backward compatibility with custom tabs registered via `et_builder_main_tabs` filter. $bb_custom_tabs = array_diff_key( $_module->get_main_tabs(), $official_tabs ); $bb_custom_tabs_formatted = array(); // Prepare properly formatted array of tabs data foreach ( $bb_custom_tabs as $tab_id => $tab_name ) { $bb_custom_tabs_formatted[ $tab_id ] = array( 'name' => $tab_name ); } // Add BB custom tabs to all modules $tabs_array[ $_module_slug ] = $bb_custom_tabs_formatted; if ( ! isset( $_module->settings_modal_tabs ) ) { continue; } $tabs_array[ $_module_slug ] = array_merge( $tabs_array[ $_module_slug ], $_module->settings_modal_tabs ); } } else { // Backward compatibility with custom tabs registered via `et_builder_main_tabs` filter. $bb_custom_tabs = array_diff_key( $module->get_main_tabs(), $official_tabs ); $bb_custom_tabs_formatted = array(); // Prepare properly formatted array of tabs data foreach ( $bb_custom_tabs as $tab_id => $tab_name ) { $bb_custom_tabs_formatted[ $tab_id ] = array( 'name' => $tab_name ); } // Add BB custom tabs to all modules $tabs_array[ $module_slug ] = $bb_custom_tabs_formatted; if ( ! isset( $module->settings_modal_tabs ) ) { continue; } $tabs_array[ $module_slug ] = array_merge( $tabs_array[ $module_slug ], $module->settings_modal_tabs ); } } return $tabs_array; } static function get_options_categories() { $options_categories = array( 'edit_colors' => array( 'name' => esc_html__( 'Edit Colors', 'et_builder' ), ), 'edit_content' => array( 'name' => esc_html__( 'Edit Content', 'et_builder' ), ), 'edit_fonts' => array( 'name' => esc_html__( 'Edit Fonts', 'et_builder' ), ), 'edit_buttons' => array( 'name' => esc_html__( 'Edit Buttons', 'et_builder' ), ), 'edit_layout' => array( 'name' => esc_html__( 'Edit Layout', 'et_builder' ), ), 'edit_configuration' => array( 'name' => esc_html__( 'Edit Configuration', 'et_builder' ), ), ); $options_categories = array_merge( $options_categories, self::get_custom_options_categories() ); return $options_categories; } static function get_custom_options_categories( $post_type = '' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); $custom_options_categories = array(); $_modules = array_merge_recursive( $parent_modules, $child_modules ); foreach( $_modules as $_module_slug => $_module ) { if ( '' === $post_type ) { foreach( $_module as $__module_slug => $__module ) { if ( ! isset( $__module->options_categories ) ) { continue; } $custom_options_categories = array_merge( $custom_options_categories, $__module->options_categories ); } } else { if ( ! isset( $_module->options_categories ) ) { continue; } $custom_options_categories = array_merge( $custom_options_categories, $_module->options_categories ); } } return $custom_options_categories; } static function get_all_fields( $post_type = '' ) { $_modules = self::get_parent_and_child_modules( $post_type ); $module_fields = array(); foreach( $_modules as $_module_slug => $_module ) { // skip modules without fb support if ( ! isset( $_module->vb_support ) || 'off' === $_module->vb_support ) { continue; } $_module->set_fields(); $_module->_add_additional_fields(); $_module->_add_custom_css_fields(); $_module->_maybe_add_defaults(); $_module->_finalize_all_fields(); foreach ( $_module->fields_unprocessed as $field_key => $field ) { // do not add the fields with 'skip' type. These fields used for rendering shortcode on Front End only if ( isset( $field['type'] ) && 'skip' === $field['type'] ) { continue; } $field['name'] = $field_key; $module_fields[ $_module_slug ][ $field_key ] = $field; } } return $module_fields; } static function get_general_fields( $post_type = '', $mode = 'all', $module_type = 'all' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } $module_fields = array(); foreach( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } foreach ( $_module->fields_unprocessed as $field_key => $field ) { if ( isset( $field['tab_slug'] ) && 'general' !== $field['tab_slug'] ) { continue; } $field['name'] = $field_key; $module_fields[ $_module_slug ][ $field_key ] = $field; } } if ( 'all' !== $module_type ) { return $module_fields[ $module_type ]; } return $module_fields; } static function get_settings_modal_tabs_fields( $post_type = '', $mode = 'all', $module_type = 'all' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } $module_fields = array(); foreach( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } foreach ( $_module->fields_unprocessed as $field_key => $field ) { $this_tab_slug = isset( $field['tab_slug'] ) ? $field['tab_slug'] : false; if ( ! $this_tab_slug || in_array( $this_tab_slug, array( 'general', 'advanced', 'custom_css' ) ) ) { continue; } $field['name'] = $field_key; $module_fields[ $_module_slug ][ $this_tab_slug ][ $field_key ] = $field; } } if ( 'all' !== $module_type ) { return $module_fields[ $module_type ]; } return $module_fields; } static function get_child_module_titles( $post_type ) { $child_modules = self::get_child_modules( $post_type ); $child_modules_titles = array(); $child_modules_titles_fields = array( 'advanced_setting_title_text', 'child_title_fallback_var', 'child_title_var' ); foreach( $child_modules as $_module_slug => $_module ) { foreach( $child_modules_titles_fields as $single_field ) { if ( isset( $_module->$single_field ) ) { $child_modules_titles[ $_module_slug ][ $single_field ] = $_module->$single_field ; } } } return $child_modules_titles; } static function get_advanced_fields( $post_type = '', $mode = 'all', $module_type = 'all' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } $module_fields = array(); foreach( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } foreach ( $_module->fields_unprocessed as $field_key => $field ) { if ( ! isset( $field['tab_slug'] ) || 'advanced' !== $field['tab_slug'] ) { continue; } if ( isset( $field['default'] ) ) { $module_fields[ $_module_slug ]['advanced_defaults'][ $field_key ] = $field['default']; } $field['name'] = $field_key; $module_fields[ $_module_slug ][ $field_key ] = $field; } if ( ! empty( $_module->advanced_fields ) ) { $module_fields[ $_module_slug ]['advanced_common'] = $_module->advanced_fields; if ( isset( $_module->advanced_fields['border']['border_styles'] ) ) { $module_fields[ $_module_slug ]['border_styles'] = array_merge( $module_fields[ $_module_slug ]['border_styles'], $_module->advanced_fields['border']['border_styles'] ); } if ( isset( $_module->advanced_fields['border']['border_radii'] ) ) { $module_fileds[ $_module_slug ]['border_radii'] = array_merge( $module_fields[ $_module_slug ]['border_radii'], $_module->advanced_fields['border']['border_radii'] ); } } } if ( 'all' !== $module_type ) { return $module_fields[ $module_type ]; } return $module_fields; } static function get_custom_css_fields( $post_type = '', $mode = 'all', $module_type = 'all' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } $module_fields = array(); $custom_css_unwanted_types = array( 'custom_css', 'column_settings_css', 'column_settings_css_fields', 'column_settings_custom_css' ); foreach( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } $module_fields[ $_module_slug ] = $_module->custom_css_fields; foreach ( $module_fields[ $_module_slug ] as &$item ) { $item['hover'] = self::$_->array_get( $item, 'hover', 'tabs' ); } // Automatically added module ID and module class fields to setting modal's CSS tab if ( ! empty( $_module->fields_unprocessed ) ) { foreach ( $_module->fields_unprocessed as $field_unprocessed_key => $field_unprocessed ) { if ( isset( $field_unprocessed['tab_slug'] ) && 'custom_css' === $field_unprocessed['tab_slug'] && isset( $field_unprocessed['type'] ) && ! in_array( $field_unprocessed['type'], $custom_css_unwanted_types ) ) { $module_fields[ $_module_slug ][ $field_unprocessed_key ] = $field_unprocessed; } } } } if ( 'all' !== $module_type ) { return $module_fields[ $module_type ]; } return $module_fields; } static function get_modules_i10n( $post_type = '', $mode = 'all', $module_type = 'all' ) { $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } $fields = array(); foreach( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } $fields[$_module_slug] = array( 'addNew' => $_module->add_new_child_text() ); } if ( 'all' !== $module_type ) { return $fields[ $module_type ]; } return $fields; } public static function get_modules_transitions( $post_type = '', $mode = 'all', $module_type = 'all' ) { /** * @var ET_Builder_Element[] $_modules */ $parent_modules = self::get_parent_modules( $post_type ); $child_modules = self::get_child_modules( $post_type ); $fields = array(); switch ( $mode ) { case 'parent': $_modules = $parent_modules; break; case 'child': $_modules = $child_modules; break; default: $_modules = array_merge( $parent_modules, $child_modules ); break; } foreach ( $_modules as $_module_slug => $_module ) { // filter modules by slug if needed if ( 'all' !== $module_type && $module_type !== $_module_slug ) { continue; } $fields[ $_module_slug ] = $_module->get_transition_fields_css_props(); } return $fields; } public static function get_module_items_configs( $post_type ) { $modules = self::get_parent_and_child_modules( $post_type ); $configs = array(); foreach ( $modules as $slug => $module ) { if ( isset( $module->module_items_config ) ) { $configs[ $slug ] = $module->module_items_config; } } return $configs; } static function get_module_fields( $post_type, $module ) { $_modules = self::get_parent_and_child_modules( $post_type ); if ( ! empty( $_modules[ $module ] ) ) { return $_modules[ $module ]->fields_unprocessed; } return false; } static function get_parent_module_fields( $post_type, $module ) { if ( ! empty( self::$parent_modules[ $post_type ][ $module ] ) ) { return self::$parent_modules[ $post_type ][ $module ]->get_complete_fields(); } return false; } static function get_child_module_fields( $post_type, $module ) { if ( ! empty( self::$child_modules[ $post_type ][ $module ] ) ) { return self::$child_modules[ $post_type ][ $module ]->get_complete_fields(); } return false; } static function get_parent_module_field( $post_type, $module, $field ) { $fields = self::get_parent_module_fields( $post_type, $module ); if ( ! empty( $fields[ $field ] ) ) { return $fields[ $field ]; } return false; } static function get_font_icon_fields( $post_type = '' ) { $_modules = self::get_parent_and_child_modules( $post_type ); $module_fields = array(); foreach ( $_modules as $module_name => $module ) { foreach ($module->fields_unprocessed as $module_field_name => $module_field) { if ( isset( $module_field['type'] ) && 'select_icon' === $module_field['type'] ) { $module_fields[ $module_name ][ $module_field_name ] = true; } } } return $module_fields; } /** * Retrieves credits of custom modules for VB * * @return array of credits info by module slug */ public static function get_custom_modules_credits( $post_type = '' ) { $result = array(); $modules = self::get_parent_and_child_modules( $post_type ); /** * @var $module_slug string * @var $module ET_Builder_Module */ foreach ( $modules as $module_slug => $module ) { // Include custom module credits for displaying them within VB if ( $module->_is_official_module ) { continue; } else { if ( isset( $module->module_credits ) && is_array( $module->module_credits ) ) { $result[ $module_slug ] = $module->module_credits; } } } return $result; } static function get_media_quries( $for_js=false ) { $media_queries = array( 'min_width_1405' => '@media only screen and ( min-width: 1405px )', '1100_1405' => '@media only screen and ( min-width: 1100px ) and ( max-width: 1405px)', '981_1405' => '@media only screen and ( min-width: 981px ) and ( max-width: 1405px)', '981_1100' => '@media only screen and ( min-width: 981px ) and ( max-width: 1100px )', 'min_width_981' => '@media only screen and ( min-width: 981px )', 'max_width_980' => '@media only screen and ( max-width: 980px )', '768_980' => '@media only screen and ( min-width: 768px ) and ( max-width: 980px )', 'max_width_767' => '@media only screen and ( max-width: 767px )', 'max_width_479' => '@media only screen and ( max-width: 479px )', ); $media_queries['mobile'] = $media_queries['max_width_767']; $media_queries = apply_filters( 'et_builder_media_queries', $media_queries ); if ( 'for_js' === $for_js ) { $processed_queries = array(); foreach ( $media_queries as $key => $value ) { $processed_queries[] = array( $key, $value ); } } else { $processed_queries = $media_queries; } return $processed_queries; } static function set_media_queries() { self::$media_queries = self::get_media_quries(); } static function get_media_query( $name ) { if ( ! isset( self::$media_queries[ $name ] ) ) { return false; } return self::$media_queries[ $name ]; } static function get_style( $internal = false ) { // use appropriate array depending on which styles we need $styles_array = $internal ? self::$internal_modules_styles : self::$styles; if ( empty( $styles_array ) ) { return ''; } global $et_user_fonts_queue; $output = ''; if ( ! empty( $et_user_fonts_queue ) ) { $output .= et_builder_enqueue_user_fonts( $et_user_fonts_queue ); } $styles_by_media_queries = $styles_array; $styles_count = (int) count( $styles_by_media_queries ); $media_queries_order = array_merge( array( 'general' ), array_values( self::$media_queries ) ); // make sure styles in the array ordered by media query correctly from bigger to smaller screensize $styles_by_media_queries_sorted = array_merge( array_flip( $media_queries_order ), $styles_by_media_queries ); foreach ( $styles_by_media_queries_sorted as $media_query => $styles ) { // skip wrong values which were added during the array sorting if ( ! is_array( $styles ) ) { continue; } $media_query_output = ''; $wrap_into_media_query = 'general' !== $media_query; // sort styles by priority uasort( $styles, array( 'self', 'compare_by_priority' ) ); // get each rule in a media query foreach ( $styles as $selector => $settings ) { $media_query_output .= sprintf( '%3$s%4$s%1$s { %2$s }', $selector, $settings['declaration'], "\n", ( $wrap_into_media_query ? "\t" : '' ) ); } // All css rules that don't use media queries are assigned to the "general" key. // Wrap all non-general settings into media query. if ( $wrap_into_media_query ) { $media_query_output = sprintf( '%3$s%3$s%1$s {%2$s%3$s}', $media_query, $media_query_output, "\n" ); } $output .= $media_query_output; } return $output; } static function get_column_video_background( $args = array(), $conditional_tags = array(), $current_page = array() ) { if ( empty( $args ) ) { return false; } $formatted_args = array(); foreach ( $args as $key => $value) { $key_length = strlen( $key ); $formatted_args[ substr( $key, 0, ( $key_length - 2 ) ) ] = $value; } return self::get_video_background( $formatted_args, $conditional_tags, $current_page ); } static function get_video_background( $args = array(), $conditional_tags = array(), $current_page = array() ) { $base_name = isset( $args['computed_variables'] ) && isset( $args['computed_variables']['base_name'] ) ? $args['computed_variables']['base_name'] : 'background'; $defaults = array( "{$base_name}_video_mp4" => '', "{$base_name}_video_webm" => '', "{$base_name}_video_width" => '', "{$base_name}_video_height" => '', ); $args = wp_parse_args( $args, $defaults ); if ( '' === $args["{$base_name}_video_mp4"] && '' === $args["{$base_name}_video_webm"] ) { return false; } return do_shortcode( sprintf( ' ', ( '' !== $args["{$base_name}_video_mp4"] ? sprintf( '', esc_url( $args["{$base_name}_video_mp4"] ) ) : '' ), ( '' !== $args["{$base_name}_video_webm"] ? sprintf( '', esc_url( $args["{$base_name}_video_webm"] ) ) : '' ), ( '' !== $args["{$base_name}_video_width"] ? sprintf( ' width="%s"', esc_attr( intval( $args["{$base_name}_video_width"] ) ) ) : '' ), ( '' !== $args["{$base_name}_video_height"] ? sprintf( ' height="%s"', esc_attr( intval( $args["{$base_name}_video_height"] ) ) ) : '' ) ) ); } static function clean_internal_modules_styles( $need_internal_styles = true ) { // clean the styles array self::$internal_modules_styles = array(); // set the flag to make sure new styles will be saved to the correct place self::$prepare_internal_styles = $need_internal_styles; // generate unique number to make sure module classes will be unique if shortcode is generated via ajax self::$internal_modules_counter = rand( 10000, 99999 ); } /** * Set the field dependencies based on the `show_if` or `show_if_not` key from the * field. * @param string $slug The module's slug. ie `et_pb_section` * @param string $field_id The field id. id `background_color` * @param array $field_info Associative array of the field's data. */ protected static function set_field_dependencies( $slug, $field_id, $field_info ) { // bail if the field_info is not an array. if ( ! is_array( $field_info ) || ! self::$_->array_get( $field_info, 'bb_support', true ) ) { return; } // otherwise we keep going. foreach ( array( 'show_if', 'show_if_not' ) as $dependency_type ) { if ( ! isset( $field_info[ $dependency_type ] ) ) { continue; } if ( ! self::$data_utils->is_assoc_array( $field_info[ $dependency_type ] ) ) { continue; } foreach ( $field_info[ $dependency_type ] as $dependency => $value ) { // dependency -> dependent (eg. et_pb_signup.provider.affects.first_name_field.show_if: mailchimp) $address = self::$_->esc_array( array( $slug, $dependency, 'affects', $field_id, $dependency_type ), 'esc_attr' ); self::$data_utils->array_set( self::$field_dependencies, $address, self::$_->esc_array( $value, 'esc_attr' ) ); // dependent -> dependency (eg. et_pb_signup.first_name_field.show_if.provider: mailchimp) $address = self::$_->esc_array( array( $slug, $field_id, $dependency_type, $dependency ), 'esc_attr' ); self::$data_utils->array_set( self::$field_dependencies, $address, self::$_->esc_array( $value, 'esc_attr' ) ); } } } public static function get_field_dependencies( $post_type ) { if ( self::$field_dependencies ) { return self::$field_dependencies; } $all_modules = self::get_parent_and_child_modules( $post_type ); foreach ( $all_modules as $module_slug => $module ) { // Get all the fields. $all_fields = $module->sort_fields( $module->_get_fields() ); foreach ( $all_fields as $field_id => $field_info ) { if ( isset( $field_info['type'] ) && 'composite' === $field_info['type'] ) { foreach ( $field_info['composite_structure'] as $field ) { foreach ( $field['controls'] as $control => $data ) { self::set_field_dependencies( $module_slug, $control, $data ); } } } self::set_field_dependencies( $module_slug, $field_id, $field_info ); } } return self::$field_dependencies; } static function set_style( $function_name, $style ) { $selectors = is_array( $style['selector'] ) ? $style['selector'] : array( $style['selector'] ); foreach ( $selectors as $item ) { foreach ( self::$_->sanitize_css_placeholders( $item ) as $selector ) { self::_set_style( $function_name, array_merge( $style, array( 'selector' => $selector ) ) ); } } } protected static function _set_style( $function_name, $style ) { $declaration = rtrim($style['declaration']); if ( empty($declaration) ) { // Do not add empty declarations return; } $builder_post_types = et_builder_get_builder_post_types(); $allowed_post_types = apply_filters( 'et_builder_set_style_allowed_post_types', $builder_post_types ); if ( $builder_post_types !== $allowed_post_types ) { $matches = array_intersect( $allowed_post_types, array_keys( self::$_module_slugs_by_post_type ) ); $allowed = false; foreach ( $matches as $post_type ) { if ( ! isset( self::$_module_slugs_by_post_type[ $post_type ] ) ) { continue; } if ( in_array( $function_name, self::$_module_slugs_by_post_type[ $post_type ] ) ) { $allowed = true; break; } } if ( ! $allowed ) { return; } } global $et_pb_rendering_column_content; // do not process all the styles if FB enabled. Only those for modules without fb support and styles for the internal modules from Blog/Slider if ( et_fb_is_enabled() && ! in_array( $function_name, self::get_fb_unsupported_modules() ) && ! $et_pb_rendering_column_content ) { return; } $order_class_name = self::get_module_order_class( $function_name ); $selector = str_replace( '%%order_class%%', ".{$order_class_name}", $style['selector'] ); $selector = str_replace( '%order_class%', ".{$order_class_name}", $selector ); if ( false !== strpos( $selector, '%%parent_class%%' ) ) { $parent_class = str_replace( '_item', '', $function_name ); $selector = str_replace( '%%parent_class%%', ".{$parent_class}", $selector ); } $selector = strip_tags( apply_filters( 'et_pb_set_style_selector', $selector, $function_name ) ); $selector = et_builder_maybe_wrap_css_selectors( $selector, false ); // New lines are saved as || in CSS Custom settings, remove them $declaration = preg_replace( '/(\|\|)/i', '', $declaration ); $media_query = isset( $style[ 'media_query' ] ) ? $style[ 'media_query' ] : 'general'; // prepare styles for internal content. Used in Blog/Slider modules if they contain Divi modules if ( $et_pb_rendering_column_content && self::$prepare_internal_styles ) { if ( isset( self::$internal_modules_styles[ $media_query ][ $selector ]['declaration'] ) ) { self::$internal_modules_styles[ $media_query ][ $selector ]['declaration'] = sprintf( '%1$s %2$s', self::$internal_modules_styles[ $media_query ][ $selector ]['declaration'], $declaration ); } else { self::$internal_modules_styles[ $media_query ][ $selector ]['declaration'] = $declaration; } if ( isset( $style['priority'] ) ) { self::$internal_modules_styles[ $media_query ][ $selector ]['priority'] = (int) $style['priority']; } } else { if ( isset( self::$styles[ $media_query ][ $selector ]['declaration'] ) ) { self::$styles[ $media_query ][ $selector ]['declaration'] = sprintf( '%1$s %2$s', self::$styles[ $media_query ][ $selector ]['declaration'], $declaration ); } else { self::$styles[ $media_query ][ $selector ]['declaration'] = $declaration; } if ( isset( $style['priority'] ) ) { self::$styles[ $media_query ][ $selector ]['priority'] = (int) $style['priority']; } } } static function get_module_order_class( $function_name ) { global $et_pb_rendering_column_content, $et_pb_predefined_module_index; // determine whether we need to get the internal module class or regular $get_inner_module_class = $et_pb_rendering_column_content; if ( $get_inner_module_class ) { if ( ! isset( self::$inner_modules_order[ $function_name ] ) ) { return false; } } else { if ( ! isset( self::$modules_order[ $function_name ] ) ) { return false; } } if ( isset( $et_pb_predefined_module_index ) && $et_pb_predefined_module_index ) { $shortcode_order_num = $et_pb_predefined_module_index; } else { $shortcode_order_num = $get_inner_module_class ? self::$inner_modules_order[ $function_name ] : self::$modules_order[ $function_name ]; } $order_class_name = sprintf( '%1$s_%2$s', $function_name, $shortcode_order_num ); return $order_class_name; } static function set_order_class( $function_name ) { global $et_pb_rendering_column_content; // determine whether we need to update the internal module class or regular $process_inner_module_class = $et_pb_rendering_column_content; if ( $process_inner_module_class ) { if ( ! isset( self::$inner_modules_order ) ) { self::$inner_modules_order = array(); } self::$inner_modules_order[ $function_name ] = isset( self::$inner_modules_order[ $function_name ] ) ? (int) self::$inner_modules_order[ $function_name ] + 1 : self::$internal_modules_counter; } else { if ( ! isset( self::$modules_order ) ) { self::$modules_order = array(); } self::$modules_order[ $function_name ] = isset( self::$modules_order[ $function_name ] ) ? (int) self::$modules_order[ $function_name ] + 1 : 0; } } static function add_module_order_class( $module_class, $function_name ) { $order_class_name = self::get_module_order_class( $function_name ); return "{$module_class} {$order_class_name}"; } function video_background( $args = array(), $base_name = 'background' ) { $attr_prefix = "{$base_name}_"; $custom_prefix = 'background' === $base_name ? '' : "{$base_name}_"; if ( ! empty( $args ) ) { $background_video = self::get_video_background( $args ); $pause_outside_viewport = isset( $args[ "{$attr_prefix}video_pause_outside_viewport" ] ) ? $args[ "{$attr_prefix}video_pause_outside_viewport" ] : ''; $allow_player_pause = isset( $args[ "{$custom_prefix}allow_player_pause" ] ) ? $args[ "{$custom_prefix}allow_player_pause" ] : 'off'; } else { $background_video = self::get_video_background( array( "{$attr_prefix}video_mp4" => isset( $this->props["{$attr_prefix}video_mp4"] ) ? $this->props["{$attr_prefix}video_mp4"] : '', "{$attr_prefix}video_webm" => isset( $this->props["{$attr_prefix}video_webm"] ) ? $this->props["{$attr_prefix}video_webm"] : '', "{$attr_prefix}video_width" => isset( $this->props["{$attr_prefix}video_width"] ) ? $this->props["{$attr_prefix}video_width"] : '', "{$attr_prefix}video_height" => isset( $this->props["{$attr_prefix}video_height"] ) ? $this->props["{$attr_prefix}video_height"] : '', 'computed_variables' => array( 'base_name' => $base_name, ), ) ); $pause_outside_viewport = isset( $this->props["{$attr_prefix}video_pause_outside_viewport"] ) ? $this->props["{$attr_prefix}video_pause_outside_viewport"] : ''; $allow_player_pause = isset( $this->props["{$custom_prefix}allow_player_pause"] ) ? $this->props["{$custom_prefix}allow_player_pause"] : 'off'; } $video_background = ''; if ( $background_video ) { $video_background = sprintf( ' %1$s ', $background_video, ( 'on' === $allow_player_pause ? ' et_pb_allow_player_pause' : '' ), ( 'off' === $pause_outside_viewport ? ' et_pb_video_play_outside_viewport' : '' ) ); wp_enqueue_style( 'wp-mediaelement' ); wp_enqueue_script( 'wp-mediaelement' ); } // Added classname for module wrapper if ( '' !== $video_background ) { $this->add_classname( array( 'et_pb_section_video', 'et_pb_preload' ) ); } return $video_background; } function get_parallax_image_background( $base_name = 'background' ) { $attr_prefix = "{$base_name}_"; $custom_prefix = 'background' === $base_name ? '' : "{$base_name}_"; $background_image = $this->props["{$attr_prefix}image"]; $parallax = $this->props["{$custom_prefix}parallax"]; $parallax_method = $this->props["{$custom_prefix}parallax_method"]; $parallax_background = ''; if ( $this->featured_image_background ) { $featured_image = isset( $this->props['featured_image'] ) ? $this->props['featured_image'] : ''; $featured_placement = isset( $this->props['featured_placement'] ) ? $this->props['featured_placement'] : ''; $featured_image_src_obj = wp_get_attachment_image_src( get_post_thumbnail_id( get_the_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 ) { $background_image = $featured_image_src; } } if ( '' !== $background_image && 'on' === $parallax ) { $parallax_classname = array( 'et_parallax_bg' ); if ( 'off' === $parallax_method ) { $parallax_classname[] = 'et_pb_parallax_css'; } $parallax_background = sprintf( '', esc_attr( implode( ' ', $parallax_classname ) ), esc_url( $background_image ) ); } // Added classname for module wrapper if ( '' !== $parallax_background ) { $this->add_classname( 'et_pb_section_parallax' ); } return $parallax_background; } /** * Generate CSS Filters * Check our shortcode arguments for CSS `filter` properties. If found, set the style rules for this block. (This * function reads options set by the 'Filters' and 'Image Filters' builder menu fields.) * * @param string $function_name Builder module's function name (keeps the CSS rules straight) * @param string $prefix Optional string prepended to the field name (i.e., `filter_saturate` -> `child_filter_saturate`) * @param mixed $selectors Array or string containing all target DOM element(s), ID(s), and/or class(es) * * @return string Any additional CSS classes (added if filters were applied). */ function generate_css_filters( $function_name = '', $prefix = '', $selectors = array('%%order_class%%') ) { if ( '' === $function_name ) { ET_Core_Logger::error( '$function_name is required.' ); return; } // If `$selectors` is a string, convert to an array before we continue $selectors_prepared = $selectors; if ( ! is_array( $selectors ) ) { $selectors_prepared = explode( ',', et_core_intentionally_unescaped( $selectors, 'fixed_string' ) ); } $additional_classes = ''; // If we don't have a target selector, get out now if ( ! $selectors_prepared ) { return $additional_classes; } $hover_suffix = et_pb_hover_options()->get_suffix(); $field_suffixes = array( '', $hover_suffix ); foreach ( $field_suffixes as $suffix ) { if ( $hover_suffix === $suffix ) { $selectors_prepared = array_map( array( $this, 'add_hover_to_selectors' ), $selectors_prepared ); } // Some web browser glitches with filters and blend modes can be improved this way // see https://bugs.chromium.org/p/chromium/issues/detail?id=157218 for more info $backfaceVisibility = 'backface-visibility:hidden;'; $backfaceVisibilityAdded = array(); $additional_classes = ''; // Blend Mode $mix_blend_mode = self::$data_utils->array_get( $this->props, "{$prefix}mix_blend_mode", '' ); // Filters $filter = array( 'hue_rotate' => self::$data_utils->array_get( $this->props, "{$prefix}filter_hue_rotate{$suffix}", ''), 'saturate' => self::$data_utils->array_get( $this->props, "{$prefix}filter_saturate{$suffix}", ''), 'brightness' => self::$data_utils->array_get( $this->props, "{$prefix}filter_brightness{$suffix}", ''), 'contrast' => self::$data_utils->array_get( $this->props, "{$prefix}filter_contrast{$suffix}", ''), 'invert' => self::$data_utils->array_get( $this->props, "{$prefix}filter_invert{$suffix}", ''), 'sepia' => self::$data_utils->array_get( $this->props, "{$prefix}filter_sepia{$suffix}", ''), 'opacity' => self::$data_utils->array_get( $this->props, "{$prefix}filter_opacity{$suffix}", ''), 'blur' => self::$data_utils->array_get( $this->props, "{$prefix}filter_blur{$suffix}", ''), ); // Remove any filters with null or default values $filter = array_filter( $filter, 'strlen' ); // Optional: CSS `mix-blend-mode` rule $mix_blend_mode_default = ET_Global_Settings::get_value( 'all_mix_blend_mode', 'default' ); if ( $mix_blend_mode && $mix_blend_mode !== $mix_blend_mode_default ) { foreach ( $selectors_prepared as $selector ) { ET_Builder_Element::set_style( $function_name, array( 'selector' => $selector, 'declaration' => sprintf( 'mix-blend-mode: %1$s;', esc_html( $mix_blend_mode ) ) . $backfaceVisibility, ) ); $backfaceVisibilityAdded[] = $selector; } $additional_classes .= ' et_pb_css_mix_blend_mode'; } else if ( 'et_pb_column' === $function_name ) { // Columns need to pass through $additional_classes .= ' et_pb_css_mix_blend_mode_passthrough'; } // Optional: CSS `filter` rule if ( empty( $filter ) ) { return $additional_classes; } $css_value = ''; $css_value_fb_hover = ''; foreach ( $filter as $label => $value ) { // Check against our default settings, and only append the rule if it differs // (only for default state since hover might be equal to default, ie. no filter on hover only) if ( ET_Global_Settings::get_value( 'all_filter_' . $label, 'default' ) === $value && $hover_suffix !== $suffix ) { continue; } // Don't apply hover filter if it is not enabled if ( $hover_suffix === $suffix && ! et_pb_hover_options()->is_enabled( "{$prefix}filter_{$label}{$suffix}", $this->props ) ) { continue; } $value = et_sanitize_input_unit( $value, false, 'deg' ); $label_css_format = str_replace( '_', '-', $label ); // Construct string of all CSS Filter values $css_value .= esc_html( " ${label_css_format}(${value})" ); // Construct Visual Builder hover rules if ( ! in_array( $label, array( 'opacity', 'blur' ) ) ) { // Skip those, because they mess with VB controls $css_value_fb_hover .= esc_html( " ${label_css_format}(${value})" ); } } // Append our new CSS rules if ( trim( $css_value ) ) { foreach ( $selectors_prepared as $selector ) { $backfaceVisibilityDeclaration = in_array( $selector, $backfaceVisibilityAdded ) ? '' : $backfaceVisibility; ET_Builder_Element::set_style( $function_name, array( 'selector' => $selector, 'declaration' => sprintf( 'filter: %1$s;', $css_value ) . $backfaceVisibilityDeclaration, ) ); } $additional_classes .= ' et_pb_css_filters'; } // If we have VB hover-friendly CSS rules, we'll gather those and append them here if ( trim( $css_value_fb_hover ) ) { foreach ( $selectors_prepared as $selector ) { $selector_hover = str_replace( '%%order_class%%', 'html:not(.et_fb_edit_enabled) #et-fb-app %%order_class%%:hover', $selector ); ET_Builder_Element::set_style( $function_name, array( 'selector' => $selector_hover, 'declaration' => esc_html( sprintf( 'filter: %1$s;', $css_value_fb_hover ) ), ) ); } $additional_classes .= ' et_pb_css_filters_hover'; } } return $additional_classes; } /** * Convert classes array to a string. Also removes any duplicate classes * * @param array $classes A list of CSS classnames * * @return array */ function stringify_css_filter_classes( $classes ) { // Remove repeating classes $classes = array_unique( $classes ); // Transform classes to a string $classes = ' ' . implode( ' ', $classes ); return $classes; } /** * Adds a suffix at the end of the selector * E.g: add_suffix_to_selectors(':hover', '%%order_class%%% .image') >>> '%%order_class%%% .image:hover' * * @param string $suffix * @param string $selector * * @return string */ public function add_suffix_to_selectors( $suffix, $selector ) { $selectors = explode( ',', $selector ); $selectors = array_map( 'trim', $selectors ); foreach ( $selectors as &$selector ) { $selector .= $suffix; } return implode( ', ', $selectors ); } /** * 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 * * @deprecated Use et_pb_hover_options()->add_hover_to_selectors( $selector ); */ public function add_hover_to_selectors( $selector ) { return et_pb_hover_options()->add_hover_to_selectors( $selector ); } /** * Adds `:hover` in selector at the end of the selector if $add_hover is true * otherwise returns the original selector * * @param string $selector * @param bool $add_hover * * @return string */ protected function _maybe_add_hover_to_selectors( $selector, $add_hover = false ) { return $add_hover ? et_pb_hover_options()->add_hover_to_selectors( $selector ) : $selector; } /** * 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 * * @deprecated Use et_pb_hover_options()->add_hover_to_order_class( $selector ); */ public function add_hover_to_order_class( $selector ) { return et_pb_hover_options()->add_hover_to_order_class( $selector ); } /** * Adds `:hover` to order class only if is specified, in other cse returns original selector * otherwise returns the original selector * * @param string $selector * @param bool $add_hover * * @return string */ protected function _maybe_add_hover_to_order_class( $selector, $add_hover = false ) { return $add_hover ? et_pb_hover_options()->add_hover_to_order_class( $selector ) : $selector; } /** * Convert smart quotes and & entity to their applicable characters * * @param string $text Input text * * @return string */ static function convert_smart_quotes_and_amp( $text ) { $smart_quotes = array( '“', '”', '″', '‘', '’', ''', '&', ); $replacements = array( '"', '"', '"', ''', ''', ''', '&', ); if ( 'fr_FR' === get_locale() ) { $french_smart_quotes = array( ' »', '″>', ); $french_replacements = array( '"', '">', ); $smart_quotes = array_merge( $smart_quotes, $french_smart_quotes ); $replacements = array_merge( $replacements, $french_replacements ); } $text = str_replace( $smart_quotes, $replacements, $text ); return $text; } public function process_multiple_checkboxes_field_value( $value_map, $value ) { $result = array(); $index = 0; foreach ( explode( '|', $value ) as $checkbox_value ) { if ( 'on' === $checkbox_value ) { $result[] = $value_map[ $index ]; } $index++; } return implode( '|', $result ); } /** * Adds one or more CSS classes to the module on the frontend. * * @since 3.1 * * @param string|array $to_add classname(s) to be added * @param number|bool $position position of added classname (0-based). Some class need to be placed * at exact position. i.e. .et_pb_column_{$type} on column inner */ function add_classname( $to_add, $position = false ) { if ( empty( $to_add ) ) { return; } $classname = is_array( $to_add ) ? $to_add : array( $to_add ); if ( is_numeric( $position ) ) { array_splice($this->classname, intval( $position ), 0, $classname ); } else { $this->classname = array_merge( $this->classname, $classname ); } } /** * Removes one ore more CSS classes to the module on the frontend * * @since 3.1 * * @param string|array $to_remove classname(s) to be removed */ function remove_classname( $to_remove ) { $this->classname = array_filter( $this->classname ); if ( is_string( $to_remove ) && '' !== $to_remove ) { $this->classname = array_diff( $this->classname, array( $to_remove ) ); } elseif ( is_array( $to_remove ) ) { $to_remove = array_filter( $to_remove ); $this->classname = array_diff( $this->classname, $to_remove ); } } /** * Outputs module class * * @since 3.1 * * @return string escaped class */ function module_classname( $function_name = '' ) { if ( ! in_array( $function_name, ET_Builder_Element::$uses_module_classname ) ) { // Add module slug to array of modules where `module_classname()` used ET_Builder_Element::$uses_module_classname[] = $function_name; } $module_name = str_replace( 'et_pb_', '', $this->slug ); /** * Filters module classes. * * @since 3.1 * * @param array $classname Array of classnames. * @param int $render_count Number of times render function has been executed */ $classname = (array) array_unique( apply_filters( "et_builder_{$module_name}_classes", $this->classname, $this->render_count() ) ); return implode( ' ', array_map( 'esc_attr', $classname ) ); } /** * Outputs module id * * @since 3.1 * * @param bool $include_attribute wrap module id with id attribute name or not (to be used directly on module div) * * @return string module id / module id wrapped by id attribute */ function module_id( $include_attribute = true ) { $module_id = esc_attr( $this->props['module_id'] ); $output = $include_attribute ? sprintf( ' id="%1$s"', $module_id ) : $module_id; return '' !== $module_id ? $output : ''; } /** * Helper method for rendering button markup which works compatible with advanced options' button * * @since 3.1 * * @param array $args button settings * * @return string rendered button HTML */ function render_button( $args = array() ) { // Prepare arguments $defaults = array( 'button_id' => '', 'button_classname' => array(), 'button_custom' => '', 'button_rel' => '', 'button_text' => '', 'button_text_escaped' => false, 'button_url' => '', 'custom_icon' => '', 'display_button' => true, 'has_wrapper' => true, 'url_new_window' => '', ); $args = wp_parse_args( $args, $defaults ); $button_text = $args['button_text_escaped'] ? $args['button_text'] : esc_html( $args['button_text'] ); // Do not proceed if no button URL or text found if ( ! $args['display_button'] || '' === $button_text ) { return ''; } // Button classname $button_classname = array( 'et_pb_button' ); if ( '' !== $args['custom_icon'] && 'on' === $args['button_custom'] ) { $button_classname[] = 'et_pb_custom_button_icon'; } if ( ! empty( $args['button_classname'] ) ) { $button_classname = array_merge( $button_classname, $args['button_classname'] ); } // Custom icon data attribute $use_data_icon = '' !== $args['custom_icon'] && 'on' === $args['button_custom']; $data_icon = $use_data_icon ? sprintf( ' data-icon="%1$s"', esc_attr( et_pb_process_font_icon( $args['custom_icon'] ) ) ) : ''; // Render button return sprintf( '%7$s%2$s%8$s', esc_url( $args['button_url'] ), et_core_esc_previously( $button_text ), ( 'on' === $args['url_new_window'] ? ' target="_blank"' : '' ), et_core_esc_previously( $data_icon ), esc_attr( implode( ' ', array_unique( $button_classname ) ) ), // #5 et_core_esc_previously( $this->get_rel_attributes( $args['button_rel'] ) ), $args['has_wrapper'] ? '
    ' : '', $args['has_wrapper'] ? '
    ' : '', '' !== $args['button_id'] ? sprintf( ' id="%1$s"', esc_attr( $args['button_id'] ) ) : '' ); } /* ================================================================= * ------>>> Class-level (static) deprecations begin here! <<<------ * ================================================================= */ /** * @deprecated See {@see self::get_parent_slugs_regex()} */ public static function get_parent_shortcodes( $post_type ) { $method = __METHOD__; $replacement = __CLASS__ . '::get_parent_slugs_regex()'; et_error( "You're Doing It Wrong! {$method} is deprecated. Use {$replacement} instead." ); return self::get_parent_slugs_regex( $post_type ); } /** * @deprecated See {@see self::get_child_slugs_regex()} */ public static function get_child_shortcodes( $post_type ) { $method = __METHOD__; $replacement = __CLASS__ . '::get_child_slugs_regex()'; et_error( "You're Doing It Wrong! {$method} is deprecated. Use {$replacement} instead." ); return self::get_child_slugs_regex( $post_type ); } /** * Deprecated. * * @deprecated * * @param string $post_type * @param string $mode * * @return array */ public static function get_defaults( $post_type = '', $mode = 'all' ) { et_error( "You're Doing It Wrong! " . __METHOD__ . ' is deprecated and should not be used.' ); return array(); } /** * Deprecated. * * @deprecated * * @param string $post_type * @param string $mode * * @return array */ public static function get_fields_defaults( $post_type = '', $mode = 'all' ) { et_error( "You're Doing It Wrong! " . __METHOD__ . ' is deprecated and should not be used.' ); return array(); } /** * @deprecated */ public static function get_slugs_with_children( $post_type ) { $parent_modules = self::get_parent_modules( $post_type ); $slugs = array(); foreach ( $parent_modules as $module ) { if ( ! empty( $module->child_slug ) ) { $slugs[] = sprintf( '"%1$s":"%2$s"', esc_js( $module->slug ), esc_js( $module->child_slug ) ); } } return '{' . implode( ',', $slugs ) . '}'; } /** * Get array of attributes which have dynamic content enabled. * * @since 3.17.2 * * @param array $attrs * * @return array */ 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. * * @since 3.17.2 * * @param string $attribute * @param string $value * @param array $enabled_dynamic_attributes * * @return bool */ protected function _is_dynamic_value( $attribute, $value, $enabled_dynamic_attributes ) { if ( ! in_array( $attribute, $enabled_dynamic_attributes ) ) { return false; } return et_builder_parse_dynamic_content( $value )->is_dynamic(); } /** * Resolve a value, be it static or dynamic to a static one. * * @since 3.17.2 * * @param integer $post_id * @param string $field * @param string $value * @param array $enabled_dynamic_attributes * @param boolean $serialize * * @return string */ protected function _resolve_value( $post_id, $field, $value, $enabled_dynamic_attributes, $serialize ) { if ( ! in_array( $field, $enabled_dynamic_attributes ) ) { return $value; } $builder_value = et_builder_parse_dynamic_content( $value ); if ( $serialize ) { return $builder_value->serialize(); } return $builder_value->resolve( $post_id ); } /** * Escape an attribute's value. * * @since 3.17.2 * * @param string $attribute * @param string $html 'limited', 'full', 'none' * * @return string */ protected function _esc_attr( $attribute, $html = 'none' ) { $html = in_array( $html, array( 'limited', 'full' ), true ) ? $html : 'none'; $raw = isset( $this->attrs_unprocessed[ $attribute ] ) ? $this->attrs_unprocessed[ $attribute ] : ''; $formatted = isset( $this->props[ $attribute ] ) ? $this->props[ $attribute ] : ''; $dynamic_attributes = $this->_get_enabled_dynamic_attributes( $this->props ); // More often than not content is not an attribute so we need to handle that special case. if ( 'content' === $attribute && ! isset( $this->attrs_unprocessed[ $attribute ] ) ) { $raw = $this->content_unprocessed; $formatted = $this->content; } if ( ! $this->_is_dynamic_value( $attribute, $raw, $dynamic_attributes ) ) { if ( 'full' === $html ) { return $formatted; } return esc_html( $formatted ); } if ( 'limited' === $html ) { return wp_kses( $formatted, array( 'strong' => array( 'id' => array(), 'class' => array(), 'style' => array() ), 'em' => array( 'id' => array(), 'class' => array(), 'style' => array() ), 'i' => array( 'id' => array(), 'class' => array(), 'style' => array() ), ) ); } // Dynamic content values are escaped when they are resolved so we do not want to // double-escape them when using them in the frontend, for example. return et_core_esc_previously( $formatted ); } } do_action( 'et_pagebuilder_module_init' ); class ET_Builder_Module extends ET_Builder_Element {} class ET_Builder_Structure_Element extends ET_Builder_Element { public $is_structure_element = true; function wrap_settings_option( $option_output, $field, $name = '' ) { $field_type = ! empty( $field['type'] ) ? $field['type'] : ''; switch( $field_type ) { case 'column_settings_background' : $output = $this->generate_columns_settings_background(); $field['hover'] = 'tabs'; break; case 'column_settings_padding' : $output = $this->generate_columns_settings_padding(); break; case 'column_settings_css_fields' : $output = $this->generate_columns_settings_css_fields(); break; case 'column_settings_css' : $output = $this->generate_columns_settings_css(); break; default: $depends = false; if ( isset( $field['depends_show_if'] ) || isset( $field['depends_show_if_not'] ) ) { $depends = true; if ( isset( $field['depends_show_if_not'] ) ) { $depends_show_if_not = is_array( $field['depends_show_if_not'] ) ? implode( ',', $field['depends_show_if_not'] ) : $field['depends_show_if_not']; $depends_attr = sprintf( ' data-depends_show_if_not="%s"', esc_attr( $depends_show_if_not ) ); } else { $depends_attr = sprintf( ' data-depends_show_if="%s"', esc_attr( $field['depends_show_if'] ) ); } } // Overriding background color's attribute, turning it into appropriate background attributes if ( isset( $field['type'] ) && isset( $field['name' ] ) && in_array( $field['name'], array( 'background_color' ) ) ) { $field['type'] = 'background'; // Appending background class if ( isset( $field['option_class'] ) ) { $field['option_class'] .= ' et-pb-option--background'; } else { $field['option_class'] = 'et-pb-option--background'; } // Removing depends default variable which hides background color for unified background field UI $depends = false; if ( isset( $field['depends_show_if'] ) ) { unset( $field['depends_show_if'] ); } } $output = sprintf( '%6$s
    %5$s
    %7$s', ( ! empty( $field['type'] ) && 'tiny_mce' === $field['type'] ? ' et-pb-option-main-content' : '' ), $depends ? ' et-pb-depends' : '', ( ! empty( $field['type'] ) && 'hidden' === $field['type'] ? ' et_pb_hidden' : '' ), ( $depends ? $depends_attr : '' ), "\n\t\t\t\t" . $option_output . "\n\t\t\t", "\t", "\n\n\t\t", ( ! empty( $field['type'] ) && 'hidden' === $field['type'] ? esc_attr( sprintf( ' et-pb-option-%1$s', $field['name'] ) ) : '' ), ( ! empty( $field['option_class'] ) ? ' ' . $field['option_class'] : '' ), isset( $field['specialty_only'] ) && 'yes' === $field['specialty_only'] ? ' et-pb-specialty-only-option' : '', isset( $field['type'] ) ? esc_attr( $field['type'] ) : '', esc_attr( $field['name'] ) ); break; } if ( ! empty( $field['hover'] ) ) { if ( 'tabs' === $field['hover'] ) { $name = ( 'columns_background' === $name ) ? 'background_color_<%= counter %>' : $name; $this->last_hover_tab_field = $name; } $hover = $this->last_hover_tab_field; if ( $hover ) { $begin = '
    ', $this->generate_column_vars_bg() ); $tab_navs = sprintf( '', esc_html__( 'Color', 'et_builder' ), esc_html__( 'Gradient', 'et_builder' ), esc_html__( 'Image', 'et_builder' ), esc_html__( 'Video', 'et_builder' ), $this->get_icon( 'background-color' ), $this->get_icon( 'background-gradient' ), $this->get_icon( 'background-image' ), $this->get_icon( 'background-video' ) ); $tab_color = sprintf( '
    ', esc_html__( 'Background Color', 'et_builder' ), $this->get_icon( 'add' ), $this->get_icon( 'setting' ), $this->get_icon( 'delete' ), esc_html__( 'Hex Value', 'et_builder' ) ); $tab_gradient = sprintf( '
    %5$s %6$s
    %5$s %6$s
    ', $this->get_icon( 'add' ), $this->get_icon( 'swap' ), $this->get_icon( 'delete' ), esc_html__( 'Background Gradient', 'et_builder' ), esc_html__( 'On', 'et_builder' ), // #5 esc_html__( 'Off', 'et_builder' ), esc_html__( 'Gradient Start', 'et_builder' ), esc_html__( 'Hex Value', 'et_builder' ), esc_html__( 'Gradient End', 'et_builder' ), esc_html__( 'Gradient Type', 'et_builder' ), // #10 esc_html__( 'Linear', 'et_builder' ), esc_html__( 'Radial', 'et_builder' ), esc_html__( 'Gradient Direction', 'et_builder' ), esc_html__( 'Radial Direction', 'et_builder' ), esc_html__( 'Center', 'et_builder' ), // #15 esc_html__( 'Top Left', 'et_builder' ), esc_html__( 'Top', 'et_builder' ), esc_html__( 'Top Right', 'et_builder' ), esc_html__( 'Right', 'et_builder' ), esc_html__( 'Bottom Right', 'et_builder' ), // #20 esc_html__( 'Bottom', 'et_builder' ), esc_html__( 'Bottom Left', 'et_builder' ), esc_html__( 'Left', 'et_builder' ), esc_html__( 'Start Position', 'et_builder' ), esc_html__( 'End Position', 'et_builder' ), // #25 esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_start' ) ), esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_end' ) ), esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_type' ) ), esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_direction' ) ), esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_direction_radial' ) ), // #30 esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_start_position' ) ), esc_attr( intval( ET_Global_Settings::get_value( 'all_background_gradient_start_position' ) ) ), esc_attr( ET_Global_Settings::get_value( 'all_background_gradient_end_position' ) ), esc_attr( intval( ET_Global_Settings::get_value( 'all_background_gradient_end_position' ) ) ), esc_html__( 'Place Gradient Above Background Image', 'et_builder' ) // #35 ); $select_background_size = sprintf( '', esc_html__( 'Cover', 'et_builder' ), esc_html__( 'Fit', 'et_builder' ), esc_html__( 'Actual Size', 'et_builder' ) ); $select_background_position = sprintf( '', esc_html__( 'Top Left', 'et_builder' ), esc_html__( 'Top Center', 'et_builder' ), esc_html__( 'Top Right', 'et_builder' ), esc_html__( 'Center Left', 'et_builder' ), esc_html__( 'Center', 'et_builder' ), esc_html__( 'Center Right', 'et_builder' ), esc_html__( 'Bottom Left', 'et_builder' ), esc_html__( 'Bottom Center', 'et_builder' ), esc_html__( 'Bottom Right', 'et_builder' ) ); $select_background_repeat = sprintf( '', esc_html__( 'No Repeat', 'et_builder' ), esc_html__( 'Repeat', 'et_builder' ), esc_html__( 'Repeat X (horizontal)', 'et_builder' ), esc_html__( 'Repeat Y (vertical)', 'et_builder' ), esc_html__( 'Space', 'et_builder' ), esc_html__( 'Round', 'et_builder' ) ); $select_background_blend = sprintf( '', esc_html__( 'Normal', 'et_builder' ), esc_html__( 'Multiply', 'et_builder' ), esc_html__( 'Screen', 'et_builder' ), esc_html__( 'Overlay', 'et_builder' ), esc_html__( 'Darken', 'et_builder' ), esc_html__( 'Lighten', 'et_builder' ), esc_html__( 'Color Dodge', 'et_builder' ), esc_html__( 'Color Burn', 'et_builder' ), esc_html__( 'Hard Light', 'et_builder' ), esc_html__( 'Soft Light', 'et_builder' ), esc_html__( 'Difference', 'et_builder' ), esc_html__( 'Exclusion', 'et_builder' ), esc_html__( 'Hue', 'et_builder' ), esc_html__( 'Saturation', 'et_builder' ), esc_html__( 'Color', 'et_builder' ), esc_html__( 'Luminosity', 'et_builder' ) ); $tab_image = sprintf( '
    %9$s %10$s
    %15$s
    %17$s
    %19$s
    %21$s
    ', esc_html__( 'Background Image', 'et_builder' ), $this->get_icon( 'add' ), $this->get_icon( 'setting' ), $this->get_icon( 'delete' ), esc_html__( 'Upload an image', 'et_builder' ), // #5 esc_html__( 'Choose a Background Image', 'et_builder' ), esc_html__( 'Set As Background', 'et_builder' ), esc_html__( 'Use Parallax Effect', 'et_builder' ), esc_html__( 'On', 'et_builder' ), esc_html__( 'Off', 'et_builder' ), // #10 esc_html__( 'Parallax Method', 'et_builder' ), esc_html__( 'True Parallax', 'et_builder' ), esc_html__( 'CSS', 'et_builder' ), esc_html__( 'Background Image Size', 'et_builder' ), $select_background_size, // #15 esc_html__( 'Background Image Position', 'et_builder' ), $select_background_position, esc_html__( 'Background Image Repeat', 'et_builder' ), $select_background_repeat, esc_html__( 'Background Image Blend', 'et_builder' ), // #20 $select_background_blend ); $tab_video = sprintf( '
    %13$s %14$s
    %13$s %14$s
    ', esc_html__( 'Background Video MP4', 'et_builder' ), $this->get_icon( 'add' ), $this->get_icon( 'setting' ), $this->get_icon( 'delete' ), esc_html__( 'Upload a video', 'et_builder' ), // #5 esc_html__( 'Choose a Background Video MP4 File', 'et_builder' ), esc_html__( 'Set As Background Video', 'et_builder' ), esc_html__( 'Background Video Webm', 'et_builder' ), esc_html__( 'Choose a Background Video WEBM File', 'et_builder' ), esc_html__( 'Background Video Width', 'et_builder' ), // #10 esc_html__( 'Background Video Height', 'et_builder' ), esc_html__( 'Pause Video When Another Video Plays', 'et_builder' ), esc_html__( 'On', 'et_builder' ), esc_html__( 'Off', 'et_builder' ), esc_html__( 'Pause Video While Not In View', 'et_builder' ) // #15 ); $output .= sprintf( '
    %3$s %4$s %5$s %6$s %7$s
    <%% counter++; }); %%>', esc_html__( 'Column', 'et_builder' ), esc_html__( 'Background', 'et_builder' ), $tab_navs, $tab_color, $tab_gradient, // #5 $tab_image, $tab_video ); return $output; } function generate_columns_settings_padding() { $output = sprintf( '<%% var columns = typeof columns_layout !== \'undefined\' ? columns_layout.split(",") : [], counter = 1; _.each( columns, function ( column_type ) { var current_value_pt, current_value_pr, current_value_pb, current_value_pl, current_value_padding_tablet, current_value_padding_phone, has_tablet_padding, has_phone_padding; switch ( counter ) { %1$s } %%>', $this->generate_column_vars_padding() ); $output .= sprintf( '
    %7$s
    <%% counter++; }); %%>', esc_html__( 'Column', 'et_builder' ), esc_html__( 'Padding', 'et_builder' ), esc_html__( 'Top', 'et_builder' ), esc_html__( 'Right', 'et_builder' ), esc_html__( 'Bottom', 'et_builder' ), // #5 esc_html__( 'Left', 'et_builder' ), et_pb_generate_mobile_settings_tabs() // #7 ); return $output; } function generate_columns_settings_css() { $output = sprintf( '<%% var columns_css = typeof columns_layout !== \'undefined\' ? columns_layout.split(",") : [], counter_css = 1; _.each( columns_css, function ( column_type ) { var current_module_id_value, current_module_class_value, current_custom_css_before_value, current_custom_css_main_value, current_custom_css_after_value; switch ( counter_css ) { %1$s } %%>
    <%% counter_css++; }); %%>', $this->generate_column_vars_css(), esc_html__( 'Column', 'et_builder' ), esc_html__( 'Before', 'et_builder' ), esc_html__( 'Main Element', 'et_builder' ), esc_html__( 'After', 'et_builder' ) ); return $output; } function generate_columns_settings_css_fields() { $output = sprintf( '<%% var columns_css = typeof columns_layout !== \'undefined\' ? columns_layout.split(",") : [], counter_css = 1; _.each( columns_css, function ( column_type ) { var current_module_id_value, current_module_class_value; switch ( counter_css ) { %1$s } %%>
    <%% counter_css++; }); %%>', $this->generate_column_vars_css(), esc_html__( 'Column', 'et_builder' ), esc_html__( 'CSS ID', 'et_builder' ), esc_html__( 'CSS Class', 'et_builder' ) ); return $output; } }