', et_core_esc_previously( $output ) );
return $output;
}
endif;
if ( ! function_exists( 'et_pb_get_font_down_icon_list_items' ) ) :
/**
* Return font down icon list items.
*/
function et_pb_get_font_down_icon_list_items() {
$output = '';
$symbols = et_pb_get_font_down_icon_symbols();
foreach ( $symbols as $symbol ) {
$output .= sprintf( '', esc_attr( html_entity_decode( $symbol, ENT_QUOTES, 'UTF-8' ) ) );
}
return $output;
}
endif;
if ( ! function_exists( 'et_pb_font_down_icon_list' ) ) :
/**
* Return icon to display for the scroll down button.
*/
function et_pb_font_down_icon_list() {
echo et_core_esc_previously( et_pb_get_font_down_icon_list() );
}
endif;
if ( ! function_exists( 'et_pb_process_font_icon' ) ) :
/**
* Processes font icon value for use on front-end
*
* @param string $font_icon Font Icon ( exact value or in %%index_number%% format ).
* @param string $symbols_function Optional. Name of the function that gets an array of font icon values.
* et_pb_get_font_icon_symbols function is used by default.
* @return string $font_icon Font Icon value
*/
function et_pb_process_font_icon( $font_icon, $symbols_function = 'default' ) {
// Return empty string if $font_icon is null to prevent PHP 8.1+ deprecation warning when trim() is called on null.
if ( null === $font_icon ) {
return $font_icon;
}
// Do it if $font_icon is an extended icon.
if ( et_pb_maybe_extended_icon( $font_icon ) ) {
return et_pb_get_extended_font_icon_value( $font_icon );
}
// the exact font icon value is saved.
if ( 1 !== preg_match( '/^%%/', trim( $font_icon ) ) ) {
return $font_icon;
}
// the font icon value is saved in the following format: %%index_number%%.
$icon_index = (int) str_replace( '%', '', $font_icon );
$icon_symbols = 'default' === $symbols_function ? et_pb_get_font_icon_symbols() : call_user_func( $symbols_function );
$font_icon = isset( $icon_symbols[ $icon_index ] ) ? $icon_symbols[ $icon_index ] : '';
return $font_icon;
}
endif;
if ( ! function_exists( 'et_builder_accent_color' ) ) :
/**
* Return an accent color.
*
* @param string $default_color Default color.
*/
function et_builder_accent_color( $default_color = '#7EBEC5' ) {
// Accent color option exists in Divi theme only. Use default color in plugin.
$accent_color = ! et_is_builder_plugin_active() ? et_get_option( 'accent_color', $default_color ) : $default_color;
return apply_filters( 'et_builder_accent_color', $accent_color );
}
endif;
if ( ! function_exists( 'et_pb_process_header_level' ) ) :
/**
* Process header level.
*
* @param string $new_level Header level.
* @param string $default Default header level.
*
* @return string
*/
function et_pb_process_header_level( $new_level, $default ) {
$valid_header_levels = array( 'h1', 'h2', 'h3', 'h4', 'h5', 'h6' );
// return the new header level if exists in the list of valid header levels.
if ( in_array( $new_level, $valid_header_levels, true ) ) {
return $new_level;
}
// return default if defined. Fallback to h2 otherwise.
return isset( $default ) ? $default : 'h2';
}
endif;
if ( ! function_exists( 'et_pb_get_alignment' ) ) {
/**
* Return an alignment value from alignment key.
*
* @param string $key Alignment key.
*
* @return string
*/
function et_pb_get_alignment( $key ) {
if ( is_rtl() && 'left' === $key ) {
$key = 'right';
}
switch ( $key ) {
case 'force_left':
return 'left';
case 'justified':
return 'justify';
default:
return $key;
}
}
}
if ( ! function_exists( 'et_builder_get_text_orientation_options' ) ) :
/**
* Return text orientation options to use in dropdown.
*
* @param array $exclude_options Options to be excluded.
* @param array $include_options Options to be included.
*/
function et_builder_get_text_orientation_options( $exclude_options = array(), $include_options = array() ) {
$text_orientation_options = array(
'left' => et_builder_i18n( 'Left' ),
'center' => et_builder_i18n( 'Center' ),
'right' => et_builder_i18n( 'Right' ),
'justified' => et_builder_i18n( 'Justified' ),
);
if ( is_rtl() ) {
$text_orientation_options = array(
'right' => et_builder_i18n( 'Right' ),
'center' => et_builder_i18n( 'Center' ),
'force_left' => et_builder_i18n( 'Left' ),
);
}
// Exclude some options if needed.
if ( ! empty( $exclude_options ) ) {
foreach ( $exclude_options as $exclude ) {
unset( $text_orientation_options[ $exclude ] );
}
}
// Include some options if needed.
if ( ! empty( $include_options ) ) {
$text_orientation_options = wp_parse_args( $include_options, $text_orientation_options );
}
return apply_filters( 'et_builder_text_orientation_options', $text_orientation_options );
}
endif;
if ( ! function_exists( 'et_builder_get_gallery_settings' ) ) :
/**
* Return gallery button.
*/
function et_builder_get_gallery_settings() {
$output = sprintf(
'',
esc_attr__( 'Update Gallery', 'et_builder' )
);
return $output;
}
endif;
if ( ! function_exists( 'et_builder_get_nav_menus_options' ) ) :
/**
* Return navigation menus options.
*/
function et_builder_get_nav_menus_options() {
$nav_menus_options = array( 'none' => esc_html__( 'Default', 'et_builder' ) );
$nav_menus = wp_get_nav_menus( array( 'orderby' => 'name' ) );
foreach ( (array) $nav_menus as $_nav_menu ) {
$nav_menus_options[ $_nav_menu->term_id ] = $_nav_menu->name;
}
return apply_filters( 'et_builder_nav_menus_options', $nav_menus_options );
}
endif;
if ( ! function_exists( 'et_builder_generate_center_map_setting' ) ) :
/**
* Return center map div.
*/
function et_builder_generate_center_map_setting() {
return '';
}
endif;
if ( ! function_exists( 'et_builder_generate_pin_zoom_level_input' ) ) :
/**
* Return map's pin zoom level input element.
*/
function et_builder_generate_pin_zoom_level_input() {
return '';
}
endif;
/**
* Define conditional tags needed for component's backend parser. This is used for FB's public facing update
* mechanism to pass conditional tag to admin-ajax.php for component which relies to backend parsing. Backend
* uses this conditional tags' key as well for sanitization
*
* @return array
*/
function et_fb_conditional_tag_params() {
global $post;
$post_type = isset( $post->post_type ) ? $post->post_type : false;
$conditional_tags = array(
'is_limited_mode' => et_builder_is_limited_mode(),
'is_bfb' => et_builder_bfb_enabled(),
'is_bfb_activated' => et_builder_bfb_activated(),
'is_tb' => et_builder_tb_enabled(),
'is_front_page' => is_front_page(),
'is_home_page' => is_home() || is_front_page(),
'is_search' => is_search(),
'is_single' => is_single(),
'is_singular' => is_singular(),
'is_singular_project' => is_singular( 'project' ),
'is_rtl' => is_rtl(),
'is_no_rtl' => 'on' === et_get_option( 'divi_disable_translations', 'off' ),
'et_is_builder_plugin_active' => et_is_builder_plugin_active(),
'is_user_logged_in' => is_user_logged_in(),
'et_is_ab_testing_active' => et_is_ab_testing_active() ? 'yes' : 'no',
'is_wrapped_styles' => et_builder_has_limitation( 'use_wrapped_styles' ),
'is_gutenberg' => et_core_is_gutenberg_active(),
'is_custom_post_type' => et_builder_is_post_type_custom( $post_type ),
'is_layout_post_type' => et_theme_builder_is_layout_post_type( $post_type ),
'is_rich_editor' => user_can_richedit() ? 'yes' : 'no',
// Pass falsey as empty string so it remains falsey when conditionalTags is fetched and
// passed string as AJAX payload (on AJAX string, false bool becomes 'false' string).
'is_layout_block' => ET_GB_Block_Layout::is_layout_block_preview() ? true : '',
);
return apply_filters( 'et_fb_conditional_tag_params', $conditional_tags );
}
if ( ! function_exists( 'et_builder_page_creation_options' ) ) :
/**
* Get Page Creation flow options
*
* @since 4.2
*
* @return array
*/
function et_builder_page_creation_options() {
return array(
'build_from_scratch' => array(
'className' => 'accent-blue',
'imgSrc' => 'scratch.png',
'imgSrcHover' => 'scratch.gif',
'titleText' => esc_html__( 'Build From Scratch', 'et_builder' ),
'descriptionText' => esc_html__( 'Build your page from the ground up. Don’t worry, you can access our premade layouts at any time.', 'et_builder' ),
'buttonText' => esc_html__( 'Start Building', 'et_builder' ),
'permission' => array( 'add_module' ),
'setting' => array(
'value_index' => 1,
),
),
'use_existing_content' => array(
'className' => 'accent-blue',
'imgSrc' => 'existing.png',
'imgSrcHover' => 'existing.gif',
'titleText' => esc_html__( 'Use Existing Content', 'et_builder' ),
'descriptionText' => esc_html__( 'Use the Divi Builder while retaining your existing page content.', 'et_builder' ),
'buttonText' => esc_html__( 'Start Building', 'et_builder' ),
'permission' => array( 'edit_module' ),
'setting' => false,
),
'choose_premade_layout' => array(
'className' => 'accent-purple',
'imgSrc' => 'premade.png',
'imgSrcHover' => 'premade.gif',
'titleText' => esc_html__( 'Choose a premade Layout', 'et_builder' ),
'descriptionText' => esc_html__( 'Choose from hundreds of premade layouts, start from any of your saved layouts, or clone an existing page.', 'et_builder' ),
'buttonText' => esc_html__( 'Browse Layouts', 'et_builder' ),
'permission' => array( 'load_layout', 'divi_library' ),
'setting' => array(
'label' => esc_html__( 'Load Premade Layout', 'et_builder' ),
'value_index' => 2,
),
),
'build_with_ai' => array(
'className' => 'accent-dark-blue',
'imgSrc' => 'layout-insert-build-with-ai.svg',
'imgSrcHover' => 'layout-insert-build-with-ai.svg',
'titleText' => esc_html__( 'Build With AI', 'et_builder' ),
'bannerText' => esc_html__( 'Brand New', 'et_builder' ),
'descriptionText' => esc_html__( 'Simply describe your page content, sit back, relax, and let Divi AI build your page with the click of a button.', 'et_builder' ),
'buttonText' => esc_html__( 'Generate Layout', 'et_builder' ),
'permission' => array( 'divi_ai' ),
'setting' => array(
'value_index' => 3,
),
),
);
}
endif;
if ( ! function_exists( 'et_builder_page_creation_settings' ) ) :
/**
* Get Page Creation flow setting options
*
* @since 4.2
*
* @param bool $value_as_index Flag to set the options value as numeric index.
*
* @return array
*/
function et_builder_page_creation_settings( $value_as_index = false ) {
$default_label = esc_html__( 'Give Me A Choice', 'et_builder' );
if ( $value_as_index ) {
$settings = array(
$default_label,
);
} else {
$settings = array(
'default' => $default_label,
);
}
foreach ( et_builder_page_creation_options() as $key => $option ) {
if ( ! et_()->array_get( $option, 'setting' ) ) {
continue;
}
if ( isset( $option['permission'] ) ) {
$capabilities = is_array( $option['permission'] ) ? $option['permission'] : explode( ',', $option['permission'] );
$allowed = array_filter( $capabilities, 'et_pb_is_allowed' );
if ( ! $allowed || count( $capabilities ) !== count( $allowed ) ) {
continue;
}
}
$value = $value_as_index ? $option['setting']['value_index'] : $key;
$label = et_()->array_get( $option, 'setting.label', $option['titleText'] );
$settings[ $value ] = $label;
}
return $settings;
}
endif;
/**
* Return an app preferences.
*
* @return mixed|void
*/
function et_fb_app_preferences_settings() {
$app_preferences = array(
'settings_bar_location' => array(
'type' => 'string',
'default' => 'bottom',
'options' => array(
'top-left',
'top',
'top-right',
'right',
'bottom-right',
'bottom',
'bottom-left',
'left',
),
),
'builder_animation' => array(
'type' => 'bool',
'default' => true,
),
'builder_display_modal_settings' => array(
'type' => 'bool',
'default' => false,
),
'builder_enable_dummy_content' => array(
'type' => 'bool',
'default' => true,
),
'builder_enable_visual_theme_builder' => array(
'type' => 'bool',
'default' => true,
),
'event_mode' => array(
'type' => 'string',
'default' => 'hover',
'options' => array(
'hover' => esc_html__( 'Hover Mode', 'et_builder' ),
'click' => esc_html__( 'Click Mode', 'et_builder' ),
'grid' => esc_html__( 'Grid Mode', 'et_builder' ),
),
),
'view_mode' => array(
'type' => 'string',
'default' => et_builder_bfb_enabled() ? 'wireframe' : 'desktop',
'options' => array(
'desktop' => esc_html__( 'Desktop View', 'et_builder' ),
'tablet' => esc_html__( 'Tablet View', 'et_builder' ),
'phone' => esc_html__( 'Phone View', 'et_builder' ),
'wireframe' => esc_html__( 'Wireframe View', 'et_builder' ),
),
),
'hide_disabled_modules' => array(
'type' => 'bool',
'default' => false,
),
'history_intervals' => array(
'type' => 'int',
'default' => 1,
'options' => array(
'1' => esc_html__( 'After Every Action', 'et_builder' ),
'10' => esc_html__( 'After Every 10th Action', 'et_builder' ),
'20' => esc_html__( 'After Every 20th Action', 'et_builder' ),
'30' => esc_html__( 'After Every 30th Action', 'et_builder' ),
'40' => esc_html__( 'After Every 40th Action', 'et_builder' ),
),
),
'page_creation_flow' => array(
'type' => 'string',
'default' => 'default',
'options' => et_builder_page_creation_settings(),
),
'quick_actions_always_start_with' => array(
'type' => 'string',
'default' => 'nothing',
),
'quick_actions_show_recent_queries' => array(
'type' => 'string',
'default' => 'off',
),
'quick_actions_recent_queries' => array(
'type' => 'string',
'default' => '',
'max_length' => 100,
),
'quick_actions_recent_category' => array(
'type' => 'string',
'default' => '',
'max_length' => 100,
),
'modal_preference' => array(
'type' => 'string',
'default' => 'default',
'options' => array(
'default' => esc_html__( 'Last Used Position', 'et_builder' ),
'minimum' => esc_html__( 'Floating Minimum Size', 'et_builder' ),
'fullscreen' => esc_html__( 'Fullscreen', 'et_builder' ),
'left' => esc_html__( 'Fixed Left Sidebar', 'et_builder' ),
'right' => esc_html__( 'Fixed Right Sidebar', 'et_builder' ),
'bottom' => esc_html__( 'Fixed Bottom Panel', 'et_builder' ),
// TODO, disabled until further notice (Issue #3930 & #5859)
// 'top' => esc_html__( 'Fixed Top Panel', 'et_builder' ),.
),
),
'modal_snap_location' => array(
'type' => 'string',
'default' => '',
),
'modal_snap' => array(
'type' => 'bool',
'default' => false,
),
'modal_fullscreen' => array(
'type' => 'bool',
'default' => false,
),
'modal_dimension_width' => array(
'type' => 'int',
'default' => 400,
),
'modal_dimension_height' => array(
'type' => 'int',
'default' => 400,
),
'modal_position_x' => array(
'type' => 'int',
'default' => 30,
),
'modal_position_y' => array(
'type' => 'int',
'default' => 50,
),
'toolbar_click' => array(
'type' => 'bool',
'default' => false,
),
'toolbar_desktop' => array(
'type' => 'bool',
'default' => true,
),
'toolbar_grid' => array(
'type' => 'bool',
'default' => false,
),
'toolbar_hover' => array(
'type' => 'bool',
'default' => false,
),
'toolbar_phone' => array(
'type' => 'bool',
'default' => true,
),
'toolbar_tablet' => array(
'type' => 'bool',
'default' => true,
),
'toolbar_wireframe' => array(
'type' => 'bool',
'default' => true,
),
'toolbar_zoom' => array(
'type' => 'bool',
'default' => true,
),
'lv_modal_dimension_height' => array(
'type' => 'int',
'default' => 0,
),
'lv_modal_dimension_width' => array(
'type' => 'int',
'default' => 0,
),
'lv_modal_position_x' => array(
'type' => 'int',
'default' => 0,
),
'lv_modal_position_y' => array(
'type' => 'int',
'default' => 0,
),
// Re: "width/height": responsive dimensions presume portrait orientation.
'responsive_tablet_width' => array(
'type' => 'int',
'default' => 768,
),
'responsive_tablet_height' => array(
'type' => 'int',
'default' => 0,
),
'responsive_phone_width' => array(
'type' => 'int',
'default' => 400,
),
'responsive_phone_height' => array(
'type' => 'int',
'default' => 0,
),
'responsive_minimum_width' => array(
'type' => 'int',
'default' => 320,
),
'responsive_maximum_width' => array(
'type' => 'int',
'default' => 980,
),
);
return apply_filters( 'et_fb_app_preferences_defaults', $app_preferences );
}
/**
* Return the preferences list which should not be synced between Visual Builder and Backend Visual Builder.
*
* @return mixed|void
*/
function et_fb_unsynced_preferences() {
/**
* Filters the preferences list which should not be synced between Visual Builder and Backend Visual Builder.
*
* @since 3.18
*
* @param array
*/
return apply_filters( 'et_fb_app_preferences_unsynced', array( 'view_mode', 'toolbar_click', 'toolbar_desktop', 'toolbar_grid', 'toolbar_hover', 'toolbar_phone', 'toolbar_tablet', 'toolbar_wireframe', 'toolbar_zoom', 'modal_preference' ) );
}
/**
* Return app preferences.
*
* @return mixed|void
*/
function et_fb_app_preferences() {
$app_preferences = et_fb_app_preferences_settings();
if ( et_is_builder_plugin_active() ) {
// Since Divi Builder Plugin is always 'limited', need to use a different
// condition to prefix the options when BFB is used.
$limited_prefix = et_builder_bfb_enabled() ? 'limited_' : '';
} else {
$limited_prefix = et_builder_is_limited_mode() ? 'limited_' : '';
}
foreach ( $app_preferences as $preference_key => $preference ) {
$option_name = 'et_fb_pref_' . $preference_key;
// Some preferences should not be synced between VB and Limited VB.
if ( in_array( $preference_key, et_fb_unsynced_preferences(), true ) ) {
$option_name = 'et_fb_pref_' . $limited_prefix . $preference_key;
}
$option_value = et_get_option( $option_name, $preference['default'], '', true );
// If options available, verify returned value against valid options. Return default if fails.
if ( isset( $preference['options'] ) ) {
$options = $preference['options'];
$valid_options = isset( $options[0] ) ? $options : array_keys( $options );
// phpcs:ignore WordPress.PHP.StrictInArray -- $valid_options array has strings and numbers values.
if ( ! in_array( (string) $option_value, $valid_options ) ) {
$option_value = $preference['default'];
}
}
// Exceptional preference. Snap left is not supported in Limited mode, so replace it with default.
if ( '' !== $limited_prefix && 'modal_snap_location' === $preference_key && 'left' === $option_value ) {
$option_value = $preference['default'];
}
$app_preferences[ $preference_key ]['value'] = $option_value;
}
return apply_filters( 'et_fb_app_preferences', $app_preferences );
}
/**
* Woocommerce Components for visual builder
*
* @since 4.0.1
*
* @return array
*/
function et_fb_current_page_woocommerce_components() {
$is_product_cpt = 'product' === get_post_type();
$is_tb = et_builder_tb_enabled();
$cpt_has_wc_components = $is_product_cpt || $is_tb;
$has_wc_components = et_is_woocommerce_plugin_active() && $cpt_has_wc_components;
if ( $has_wc_components && $is_tb ) {
// Set upsells ID for upsell module in TB.
ET_Theme_Builder_Woocommerce_Product_Variable_Placeholder::set_tb_upsells_ids();
// Force set product's class to ET_Theme_Builder_Woocommerce_Product_Variable_Placeholder in TB.
add_filter( 'woocommerce_product_class', 'et_theme_builder_wc_product_class' );
// Set product categories and tags in TB.
add_filter( 'get_the_terms', 'et_theme_builder_wc_terms', 10, 3 );
// Use Divi's image placeholder in TB.
add_filter( 'woocommerce_single_product_image_thumbnail_html', 'et_builder_wc_placeholder_img' );
}
$woocommerce_components = ! $has_wc_components ? array() : array(
'et_pb_wc_add_to_cart' => ET_Builder_Module_Woocommerce_Add_To_Cart::get_add_to_cart(),
'et_pb_wc_additional_info' => ET_Builder_Module_Woocommerce_Additional_Info::get_additional_info(),
'et_pb_wc_breadcrumb' => ET_Builder_Module_Woocommerce_Breadcrumb::get_breadcrumb(),
'et_pb_wc_cart_notice' => ET_Builder_Module_Woocommerce_Cart_Notice::get_cart_notice(),
'et_pb_wc_description' => ET_Builder_Module_Woocommerce_Description::get_description(),
'et_pb_wc_images' => ET_Builder_Module_Woocommerce_Images::get_images(),
'et_pb_wc_meta' => ET_Builder_Module_Woocommerce_Meta::get_meta(),
'et_pb_wc_price' => ET_Builder_Module_Woocommerce_Price::get_price(),
'et_pb_wc_rating' => ET_Builder_Module_Woocommerce_Rating::get_rating(),
'et_pb_wc_reviews' => ET_Builder_Module_Woocommerce_Reviews::get_reviews_html(),
'et_pb_wc_stock' => ET_Builder_Module_Woocommerce_Stock::get_stock(),
'et_pb_wc_tabs' => ET_Builder_Module_Woocommerce_Tabs::get_tabs(),
'et_pb_wc_title' => ET_Builder_Module_Woocommerce_Title::get_title(),
'et_pb_wc_related_products' => ET_Builder_Module_Woocommerce_Related_Products::get_related_products(),
'et_pb_wc_upsells' => ET_Builder_Module_Woocommerce_Upsells::get_upsells(),
);
return $woocommerce_components;
}
/**
* Before & after components for builder.
*
* This method should not be used for anything other than to determine whether a module
* has before & after components on builder load.
*
* @since 4.14.5
*
* @return array Components (HTML).
*/
function et_fb_current_page_before_after_components() {
$modules_components = array();
// Bail early if current request comes from any Ajax request.
if ( wp_doing_ajax() ) {
return $modules_components;
}
// Bail early if Module Shortcode Manager class doesn't exist.
if ( ! class_exists( 'ET_Builder_Module_Shortcode_Manager' ) ) {
return $modules_components;
}
static $modules_map = null;
if ( null === $modules_map ) {
/**
* Filters modules list.
*
* The modules list comes from Shortcode Manager only contains built-in modules
* intentionally. 3rd-party modules need to include their module slug and class name
* via `et_fb_fetch_before_after_modules_map` filter.
*
* @param array Modules list.
*/
$modules_map = apply_filters( 'et_fb_fetch_before_after_modules_map', ET_Builder_Module_Shortcode_Manager::get_modules_map() );
}
// Bail early if components map is empty.
if ( empty( $modules_map ) ) {
return $modules_components;
}
foreach ( $modules_map as $module_slug => $module_data ) {
$module_class = et_()->array_get( $module_data, 'classname' );
// Skip if module class name is not found.
if ( empty( $module_class ) || ! class_exists( $module_class, false ) ) {
continue;
}
$module_components = $module_class::get_component_before_after_module( $module_slug, array() );
// Skip if there is no before & after components.
$has_components = et_()->array_get( $module_components, 'has_components' );
if ( true !== $has_components ) {
continue;
}
$modules_components[ $module_slug ] = $module_components;
}
return $modules_components;
}
/**
* Array of WooCommerce Tabs.
*
* @since 4.4.2 Fixed fatal error @link https://github.com/elegantthemes/Divi/issues/19404
* @since 4.4.2 Added Custom Tabs support.
*
* @used-by et_fb_current_page_params()
*
* @return array
*/
function et_fb_woocommerce_tabs() {
global $product, $post;
$old_product = $product;
$old_post = $post;
$is_product = isset( $product ) && is_a( $product, 'WC_Product' );
if ( ! $is_product && et_is_woocommerce_plugin_active() ) {
$product = ET_Builder_Module_Helper_Woocommerce_Modules::get_product( 'latest' );
if ( $product ) {
$post = get_post( $product->get_id() ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride -- Overriding global post is safe as original $post has been restored at the end.
} else {
$product = $old_product;
return ET_Builder_Module_Helper_Woocommerce_Modules::get_default_tab_options();
}
}
// On non-product post types, the filter will cause fatal error
// unless we have global $product set.
$tabs = apply_filters( 'woocommerce_product_tabs', array() );
$options = array();
foreach ( $tabs as $name => $tab ) {
$options[ $name ] = array(
'value' => $name,
'label' => $tab['title'],
);
}
// Reset global $product.
$product = $old_product;
$post = $old_post; // phpcs:ignore WordPress.WP.GlobalVariablesOverride -- Restoring original global $post data.
return $options;
}
/**
* Get the category taxonomy associated with a given post type.
*
* @since 4.0.6
*
* @param string $post_type Post type.
*
* @return string|bool
*/
function et_builder_get_category_taxonomy( $post_type ) {
static $cache = array();
// Address common cases.
switch ( $post_type ) {
case 'page':
return false;
case 'post':
return 'category';
case 'project':
return 'project_category';
case 'product':
return 'product_cat';
}
if ( isset( $cache[ $post_type ] ) ) {
// Use cached value.
return $cache[ $post_type ];
}
// Unknown post_type, guess the taxonomy.
$taxonomies = get_object_taxonomies( $post_type, 'names' );
foreach ( array( 'category', 'cat' ) as $pattern ) {
$matches = preg_grep( '/' . $pattern . '$/', $taxonomies );
if ( ! empty( $matches ) ) {
$cache[ $post_type ] = reset( $matches );
return $cache[ $post_type ];
}
}
// Tough luck.
$cache[ $post_type ] = false;
return $cache[ $post_type ];
}
/**
* Retrieve a post's category terms as a list with specified format.
*
* @since 4.0.6
*
* @param string $separator Optional. Separate items using this.
*
* @return string|false|WP_Error A list of terms on success, false if there are no terms, WP_Error on failure.
*/
function et_builder_get_the_term_list( $separator = '' ) {
$id = get_the_ID();
$taxonomy = et_builder_get_category_taxonomy( get_post_type( $id ) );
return $taxonomy ? get_the_term_list( $id, $taxonomy, $before = '', $separator ) : false;
}
/**
* Define current-page related data that are needed by frontend builder. Backend parser also uses this
* to sanitize updated value for computed data
*
* @return array
*/
function et_fb_current_page_params() {
global $post, $authordata, $paged;
// Get current page url.
$current_url = ( isset( $_SERVER['HTTP_HOST'] ) && isset( $_SERVER['REQUEST_URI'] ) ) ? ( is_ssl() ? 'https://' : 'http://' ) . sanitize_text_field( $_SERVER['HTTP_HOST'] ) . sanitize_text_field( $_SERVER['REQUEST_URI'] ) : '';
// Fallback for preview.
if ( empty( $authordata ) && isset( $post->post_author ) ) {
// phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- A fallback to set global $authordata.
$authordata = get_userdata( $post->post_author );
}
// Get comment count.
$comment_count = isset( $post->ID ) ? get_comments_number( $post->ID ) : 0;
// WordPress' _n() only supports singular n plural, thus we do comment count to text manually.
if ( 0 === $comment_count ) {
$comment_count_text = __( 'No Comments', 'et_builder' );
} elseif ( 1 === $comment_count ) {
$comment_count_text = __( '1 Comment', 'et_builder' );
} else {
// translators: comments count.
$comment_count_text = sprintf( __( '%d Comments', 'et_builder' ), $comment_count );
}
// Get current page paginated data.
$et_paged = is_front_page() ? get_query_var( 'page' ) : get_query_var( 'paged' );
// Get thumbnail size.
$thumbnail_size = isset( $post->ID ) && 'post' === get_post_type( $post->ID ) && 'et_full_width_page' === get_post_meta( $post->ID, '_et_pb_page_layout', true ) ? 'et-pb-post-main-image-fullwidth-large' : 'large';
// Get the ID from post-object, if not found, use the utils.
$post_id = $post->ID ?? (int) DynamicAssetsUtils::get_current_post_id();
$default_categories = array( get_term_by( 'name', 'Uncategorized', 'category' ) );
$categories = et_pb_get_post_categories( $post_id, $default_categories );
// Get post type object.
$post_type_object = isset( $post->post_type ) ? get_post_type_object( $post->post_type ) : null;
// Check if post type is public.
$is_post_type_public = $post_type_object ? $post_type_object->public : false;
// Get post type label.
$post_type_label = $post_type_object ? get_post_type_labels( $post_type_object )->singular_name : ( $post_type_object
? ucfirst( $post->post_type ) : '' );
$current_page = array(
'url' => esc_url( $current_url ),
'permalink' => esc_url_raw(
remove_query_arg(
[
'et_fb',
'app_window',
'PageSpeed',
],
$current_url
)
),
'backendBuilderUrl' => esc_url( sprintf( admin_url( '/post.php?post=%d&action=edit' ), get_the_ID() ) ),
'id' => isset( $post->ID ) ? $post->ID : false,
'title' => esc_html( get_the_title() ),
'thumbnailUrl' => isset( $post->ID ) ? esc_url( get_the_post_thumbnail_url( $post->ID, $thumbnail_size ) ) : '',
'thumbnailId' => isset( $post->ID ) ? get_post_thumbnail_id( $post->ID ) : '',
'authorName' => esc_html( get_the_author() ),
'authorUrl' => isset( $authordata->ID ) && isset( $authordata->user_nicename ) ? esc_html( get_author_posts_url( $authordata->ID, $authordata->user_nicename ) ) : false,
// translators: post author name.
'authorUrlTitle' => sprintf( esc_html__( 'Posts by %s', 'et_builder' ), get_the_author() ),
'date' => intval( get_the_time( 'U' ) ),
'categories' => $categories,
'isPostTypePublic' => $is_post_type_public,
'postTypeLabel' => $post_type_label,
'commentsPopup' => esc_html( $comment_count_text ),
'commentsCount' => esc_html( $comment_count ),
'comments_popup_tb' => esc_html__( '12 Comments', 'et_builder' ),
'paged' => is_front_page() ? $et_paged : $paged,
'post_modified' => isset( $post->ID ) ? esc_attr( $post->post_modified ) : '',
'lang' => get_locale(),
'blockId' => ET_GB_Block_Layout::is_layout_block_preview() ? sanitize_title( et_()->array_get( $_GET, 'blockId', '' ) ) : '', // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
'langCode' => get_locale(),
'page_layout' => $post_id ? get_post_meta( $post_id, '_et_pb_page_layout', true ) : '',
'woocommerce' => array(
'inactive_module_notice' => esc_html__(
'WooCommerce must be active for this module to appear',
'et_builder'
),
),
'beforeAfterComponents' => et_fb_current_page_before_after_components(),
);
return apply_filters( 'et_fb_current_page_params', $current_page );
}
/**
* Ajax Callback :: Process computed property.
*/
function et_pb_process_computed_property() {
if ( ! isset( $_POST['et_pb_process_computed_property_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_pb_process_computed_property_nonce'] ), 'et_pb_process_computed_property_nonce' ) ) {
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
if ( ! isset( $_POST['depends_on'], $_POST['conditional_tags'], $_POST['current_page'] ) ) {
// Shouldn't even be a possibility, but...
// Since computing `__page` can exit here too, we need to json_encode the reponse.
// This is needed in case jQuery migrate is disabled (eg via plugin) otherwise the AJAX success callback
// won't be executed (because json is malformed).
die( wp_json_encode( null ) );
}
$utils = ET_Core_Data_Utils::instance();
// phpcs:disable ET.Sniffs.ValidatedSanitizedInput -- Sanitization of following arrays is done at the time of accessing an array values.
$depends_on = isset( $_POST['depends_on'] ) ? $_POST['depends_on'] : array();
$conditional_tags = isset( $_POST['conditional_tags'] ) ? $_POST['conditional_tags'] : array();
$current_page = isset( $_POST['current_page'] ) ? $_POST['current_page'] : array();
// phpcs:enable
// allowlist keys.
$conditional_tags = array_intersect_key( $conditional_tags, et_fb_conditional_tag_params() );
$current_page = array_intersect_key( $current_page, et_fb_current_page_params() );
// sanitize values.
$conditional_tags = $utils->sanitize_text_fields( $conditional_tags );
$current_page = $utils->sanitize_text_fields( $current_page );
$module_slug = isset( $_POST['module_type'] ) ? sanitize_text_field( $_POST['module_type'] ) : '';
$request_type = isset( $_POST['request_type'] ) ? sanitize_text_field( $_POST['request_type'] ) : '';
if ( in_array( $request_type, array( '404', 'archive', 'home' ), true ) ) {
// On non-singular page, we do not have $current_page id, so we will check if user has theme_builder capability.
if ( ! et_pb_is_allowed( 'theme_builder' ) ) {
die( -1 );
}
} else {
// For other pages, we will check if user can edit specific post.
if ( ! current_user_can( 'edit_post', $current_page['id'] ) ) {
die( -1 );
}
}
// Check if there is page id.
if ( empty( $current_page['id'] ) && '404' !== $request_type ) {
die( -1 );
}
// $_POST['depends_on'] is a single dimensional assoc array created by jQuery.ajax data param, sanitize each key and value, they will both be strings
foreach ( $depends_on as $key => $value ) {
if ( et_()->includes( $value, '%' ) ) {
// `sanitize_text_fields` removes octets `%[a-f0-9]{2}` and would zap icon values / `%date`
// so we prefix octets with `_` to protected them and remove the prefix after sanitization.
$prepared_value = preg_replace( '/%([a-f0-9]{2})/', '%_$1', $value );
$sanitized_value = preg_replace( '/%_([a-f0-9]{2})/', '%$1', sanitize_text_field( $prepared_value ) );
} else {
$sanitized_value = sanitize_text_field( $value );
}
$depends_on[ sanitize_text_field( $key ) ] = $sanitized_value;
}
// Since VB performance, it is introduced single ajax request for several property
// in that case, computed_property posted data can be as an array
// hence we get the raw post data value, then sanitize it afterward either as array or string.
// @phpcs:ignore ET.Sniffs.ValidatedSanitizedInput.InputNotSanitized -- Will be sanitized conditionally as string or array afterward.
$computed_property = isset( $_POST['computed_property'] ) ? $_POST['computed_property'] : '';
$computed_property = is_array( $computed_property ) ? array_map( 'sanitize_text_field', $computed_property ) : sanitize_text_field( $computed_property );
// get all fields for module.
$fields = ET_Builder_Element::get_module_fields( $request_type, $module_slug );
// make sure only valid fields are being passed through.
$depends_on = array_intersect_key( $depends_on, $fields );
if ( is_array( $computed_property ) ) {
$results = array();
foreach ( $computed_property as $property ) {
if ( ! isset( $fields[ $property ], $fields[ $property ]['computed_callback'] ) ) {
continue;
}
$callback = $fields[ $property ]['computed_callback'];
if ( is_callable( $callback ) ) {
// @phpcs:ignore Generic.PHP.ForbiddenFunctions.Found -- The callback is hard-coded in module fields configuration.
$results[ $property ] = call_user_func( $callback, $depends_on, $conditional_tags, $current_page );
}
}
if ( empty( $results ) ) {
die( -1 );
}
die( wp_json_encode( $results ) );
}
// computed property field.
$field = $fields[ $computed_property ];
$callback = $field['computed_callback'];
if ( is_callable( $callback ) ) {
// @phpcs:ignore Generic.PHP.ForbiddenFunctions.Found -- The callback is hard-coded in module fields configuration.
die( wp_json_encode( call_user_func( $callback, $depends_on, $conditional_tags, $current_page ) ) );
} else {
die( -1 );
}
}
add_action( 'wp_ajax_et_pb_process_computed_property', 'et_pb_process_computed_property' );
/**
* Fetch before or after components.
*
* @since 4.14.5
*
* @return string Components outputs.
*/
function et_fb_fetch_before_after_components() {
// Bail early if the nonce is incorrect or current user can't edit posts.
$nonce = ! empty( $_POST['et_fb_fetch_before_after_components_nonce'] ) ? sanitize_text_field( $_POST['et_fb_fetch_before_after_components_nonce'] ) : '';
if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'et_fb_fetch_before_after_components_nonce' ) ) {
wp_send_json_error();
}
if ( ! current_user_can( 'edit_posts' ) ) {
wp_send_json_error();
}
// Bail early if Module Shortcode Manager class doesn't exist.
if ( ! class_exists( 'ET_Builder_Module_Shortcode_Manager' ) ) {
wp_send_json_error();
}
/**
* Filters modules list.
*
* The modules list comes from Shortcode Manager only contains built-in modules
* intentionally. 3rd-party modules need to include their module slug and class name
* via `et_fb_fetch_before_after_modules_map` filter.
*
* @param array Modules list.
*/
$modules_map = apply_filters( 'et_fb_fetch_before_after_modules_map', ET_Builder_Module_Shortcode_Manager::get_modules_map() );
// Bail early if components map is empty.
if ( empty( $modules_map ) ) {
return $modules_components;
}
$module_type = ! empty( $_POST['module_type'] ) ? sanitize_text_field( $_POST['module_type'] ) : '';
$module_class = et_()->array_get( $modules_map, array( $module_type, 'classname' ) );
// Bail early if module class name is not found.
if ( empty( $module_class ) || ! class_exists( $module_class ) ) {
wp_send_json_error();
}
// phpcs:disable ET.Sniffs.ValidatedSanitizedInput -- Sanitization of following arrays is done on Sanitize values section below.
$conditional_tags = isset( $_POST['conditional_tags'] ) ? $_POST['conditional_tags'] : array();
$current_page = isset( $_POST['current_page'] ) ? $_POST['current_page'] : array();
$module_attrs = isset( $_POST['module_attrs'] ) ? $_POST['module_attrs'] : array();
// phpcs:enable
// Allow list keys.
$conditional_tags = array_intersect_key( $conditional_tags, et_fb_conditional_tag_params() );
$current_page = array_intersect_key( $current_page, et_fb_current_page_params() );
// Sanitize values.
$conditional_tags = et_()->sanitize_text_fields( $conditional_tags );
$current_page = et_()->sanitize_text_fields( $current_page );
$module_attrs = et_()->sanitize_text_fields( $module_attrs );
$render_mode = isset( $_POST['render_mode'] ) ? sanitize_text_field( $_POST['render_mode'] ) : '';
$post_type = isset( $_POST['post_type'] ) ? sanitize_text_field( $_POST['post_type'] ) : '';
$action = isset( $_POST['action'] ) ? sanitize_text_field( $_POST['action'] ) : '';
// Bail early if current user can't edit this post.
if ( empty( $current_page['id'] ) || ! current_user_can( 'edit_post', $current_page['id'] ) ) {
wp_send_json_error();
}
// Setup module data.
$module_data = array(
'conditional_tags' => $conditional_tags,
'current_page' => $current_page,
'module_attrs' => $module_attrs,
'render_mode' => $render_mode,
'post_type' => $post_type,
'action' => $action,
);
/**
* Fires before processing before & after components.
*
* @since 4.14.5
*
* @param string $module_type Module slug.
* @param array $module_data Module data passed from the request.
*/
do_action( 'et_fb_pre_fetch_before_after_components', $module_type, $module_data );
$output = $module_class::get_component_before_after_module( $module_type, $module_data );
wp_send_json_success( $output );
}
add_action( 'wp_ajax_et_fb_fetch_before_after_components', 'et_fb_fetch_before_after_components' );
/**
* Process shortcode json.
*
* @since 4.11.4 Added $inject_responsive_hover param.
*
* @param array $object Shortcodes object.
* @param array $options Options.
* @param string $library_item_type Library item type.
* @param bool $escape_content_slashes Whether escape content slashes.
* @param bool $inject_responsive_hover Flag to inject missing responsive and hover mode attributes.
*
* @return string
*/
function et_fb_process_to_shortcode( $object, $options = array(), $library_item_type = '', $escape_content_slashes = true, $inject_responsive_hover = false ) {
$output = '';
$_object = array();
$default_options = array(
'force_valid_slugs' => false,
'post_type' => false,
'apply_global_presets' => false,
);
$options = wp_parse_args( $options, $default_options );
// Load shortcode framework to proceed with the import.
et_load_shortcode_framework();
$global_presets_manager = ET_Builder_Global_Presets_Settings::instance();
// do not proceed if $object is empty.
if ( empty( $object ) ) {
return '';
}
$font_icon_fields = ! empty( $options['post_type'] ) ? ET_Builder_Element::get_font_icon_fields( $options['post_type'] ) : false;
$structure_types = ET_Builder_Element::get_structure_module_slugs();
if ( in_array( $library_item_type, array( 'module', 'row' ), true ) ) {
$excluded_elements = array();
switch ( $library_item_type ) {
case 'module':
$excluded_elements = array( 'et_pb_section', 'et_pb_row', 'et_pb_column' );
break;
case 'row':
$excluded_elements = array( 'et_pb_section' );
break;
}
foreach ( $object as $item ) {
// do not proceed if $item is empty.
if ( empty( $item ) ) {
continue;
}
// Skip non-array items (e.g., strings from third-party shortcodes that weren't normalized).
// This defensive check prevents fatal errors when processing malformed shortcode objects.
if ( ! is_array( $item ) ) {
continue;
}
while ( in_array( $item['type'], $excluded_elements, true ) ) {
$item = $item['content'][0];
}
$_object[] = $item;
}
} else {
$_object = $object;
}
if ( $options['force_valid_slugs'] ) {
// we need to supply a reasonable default post type to get a simple list of slugs,
// otherwise the function will return an array of arrays of slugs for every possible post_type.
$slug_post_type = ! empty( $options['post_type'] ) ? $options['post_type'] : 'page';
$valid_slugs = ET_Builder_Element::get_module_slugs_by_post_type( $slug_post_type );
}
foreach ( $_object as $item ) {
// do not proceed if $item is empty.
if ( empty( $item ) ) {
continue;
}
// Skip non-array items (e.g., strings from third-party shortcodes that weren't normalized).
// This defensive check prevents fatal errors when processing malformed shortcode objects.
if ( ! is_array( $item ) ) {
continue;
}
$attributes = '';
$content = '';
$type = sanitize_text_field( $item['type'] );
$type = esc_attr( $type );
// if option enabled, reject invalid slugs.
if ( $options['force_valid_slugs'] ) {
if ( ! in_array( $type, $valid_slugs, true ) ) {
continue;
}
}
if ( ! empty( $item['raw_child_content'] ) ) {
$content = stripslashes( $item['raw_child_content'] );
}
if ( $options['apply_global_presets'] ) {
$module_type = $global_presets_manager->maybe_convert_module_type( $type, $item['attrs'] );
$module_global_presets = $global_presets_manager->get_module_presets_settings( $module_type, $item['attrs'] );
$item['attrs'] = array_merge( $module_global_presets, $item['attrs'] );
}
// Inject responsive/hover attribute value to inherit from desktop
// when the responsive/hover setting is "on" but the responsive/hover attribute is not exist.
// This can happen when responsive/hover mode values reset in the builder.
if ( $inject_responsive_hover ) {
foreach ( $item['attrs'] as $attribute => $value ) {
// Inject responsive mode attribute value.
if ( '_last_edited' === substr( $attribute, -12 ) && 0 === strpos( $value, 'on' ) ) {
$attr_key_base = str_replace( '_last_edited', '', $attribute );
$attr_key_tablet = $attr_key_base . '_tablet';
$attr_key_phone = $attr_key_base . '_phone';
$attr_is_content = 'content' === $attr_key_base && isset( $item['content'] ) && is_string( $item['content'] );
// Inject tablet mode attribute value.
if ( ! isset( $item['attrs'][ $attr_key_tablet ] ) ) {
if ( $attr_is_content ) {
$item['attrs'][ $attr_key_tablet ] = $item['content'];
} elseif ( isset( $item['attrs'][ $attr_key_base ] ) ) {
$item['attrs'][ $attr_key_tablet ] = $item['attrs'][ $attr_key_base ];
}
}
// Inject phone mode attribute value.
if ( ! isset( $item['attrs'][ $attr_key_phone ] ) ) {
if ( isset( $item['attrs'][ $attr_key_tablet ] ) ) {
$item['attrs'][ $attr_key_phone ] = $item['attrs'][ $attr_key_tablet ];
} else {
if ( $attr_is_content ) {
$item['attrs'][ $attr_key_phone ] = $content;
} elseif ( isset( $values[ $attr_key_base ] ) ) {
$item['attrs'][ $attr_key_phone ] = $values[ $attr_key_base ];
}
}
}
}
// Inject hover mode attribute value.
if ( '__hover_enabled' === substr( $attribute, -15 ) && 0 === strpos( $value, 'on' ) ) {
$attr_key_base = str_replace( '__hover_enabled', '', $attribute );
$attr_key_hover = $attr_key_base . '__hover';
if ( ! isset( $item['attrs'][ $attr_key_hover ] ) ) {
$attr_is_content = 'content' === $attr_key_base && isset( $item['content'] ) && is_string( $item['content'] );
if ( $attr_is_content ) {
$item['attrs'][ $attr_key_hover ] = $item['content'];
} elseif ( isset( $item['attrs'][ $attr_key_base ] ) ) {
$item['attrs'][ $attr_key_hover ] = $item['attrs'][ $attr_key_base ];
}
}
}
}
}
foreach ( $item['attrs'] as $attribute => $value ) {
// ignore computed fields.
if ( '__' === substr( $attribute, 0, 2 ) ) {
continue;
}
// Ignore post_content_module_attrs. They are needed only during editing.
if ( 'post_content_module_attrs' === $attribute ) {
continue;
}
// Sanitize attribute.
$attribute = sanitize_text_field( $attribute );
// Sanitize input properly.
if ( isset( $font_icon_fields[ $item['type'] ][ $attribute ] ) ) {
$value = esc_attr( $value );
}
// handle content.
if ( in_array( $attribute, array( 'content', 'raw_content' ), true ) ) {
// do not override the content if item has raw_child_content.
if ( empty( $item['raw_child_content'] ) ) {
$content = $value;
$content = trim( $content );
if ( ! empty( $content ) && 'content' === $attribute ) {
$content = "\n\n" . $content . "\n\n";
}
}
} else {
// Since WordPress version 5.1, any links in the content that
// has "target" attribute will be automatically added
// rel="noreferrer noopener" attribute. This attribute added
// after the shortcode processed in et_fb_process_to_shortcode
// function. This become an issue for the builder while parsing the shortcode attributes
// because the double quote that wrapping the "rel" attribute value is not encoded.
// So we need to manipulate "target" attribute here before storing the content by renaming
// is as "data-et-target-link". Later in "et_pb_fix_shortcodes" function
// we will turn it back as "target".
$value = str_replace( ' target=', ' data-et-target-link=', $value );
$is_include_attr = false;
if ( '' === $value
&& et_pb_hover_options()->get_field_base_name( $attribute ) !== $attribute
&& et_pb_hover_options()->is_enabled( et_pb_hover_options()->get_field_base_name( $attribute ), $item['attrs'] ) ) {
$is_include_attr = true;
}
if ( '' === $value
&& et_pb_responsive_options()->get_field_base_name( $attribute ) !== $attribute
&& et_pb_responsive_options()->is_enabled( et_pb_responsive_options()->get_field_base_name( $attribute ), $item['attrs'] ) ) {
$is_include_attr = true;
}
if ( '' !== $value ) {
$is_include_attr = true;
}
if ( $is_include_attr ) {
// TODO, should we check for and handle default here? probably done in FB alredy...
// Make sure double quotes are encoded, before adding values to shortcode.
$value = str_ireplace( '"', '%22', $value );
// Make sure single backslash is encoded, before adding values to Shortcode.
if ( 'breadcrumb_separator' === $attribute ) {
$value = str_ireplace( '\\', '%5c', $value );
}
// Encode backslash for custom CSS-related and json attributes.
$json_attributes = array( 'checkbox_options', 'radio_options', 'select_options', 'conditional_logic_rules' );
if ( 0 === strpos( $attribute, 'custom_css_' ) || in_array( $attribute, $json_attributes, true ) ) {
$value = str_ireplace( '\\', '%92', $value );
} elseif ( et_builder_parse_dynamic_content( $value )->is_dynamic() ) {
$value = str_replace( '\\', '%92', $value );
}
// Encode backslash for custom date format attributes.
$modules_and_attr_with_custom_date = array(
'et_pb_blog' => 'meta_date',
'et_pb_fullwidth_post_title' => 'date_format',
'et_pb_post_title' => 'date_format',
);
if ( ! empty( $modules_and_attr_with_custom_date[ $type ] ) && $modules_and_attr_with_custom_date[ $type ] === $attribute ) {
$value = str_replace( '\\', '%92', $value );
}
$attributes .= ' ' . esc_attr( $attribute ) . '="' . et_core_esc_previously( $value ) . '"';
}
}
}
$attributes = str_replace( array( '[', ']' ), array( '%91', '%93' ), $attributes );
// prefix sections with a fb_built attr flag.
if ( 'et_pb_section' === $type ) {
$attributes = ' fb_built="1"' . $attributes;
}
// build shortcode
// start the opening tag.
$output .= '[' . $type . $attributes;
// close the opening tag, depending on self closing.
if ( empty( $content ) && ! isset( $item['content'] ) && ! in_array( $type, $structure_types, true ) ) {
$open_tag_only = true;
$output .= ' /]';
} else {
$open_tag_only = false;
$output .= ']';
}
// if applicable, add inner content and close tag.
if ( ! $open_tag_only ) {
if ( 'et_pb_section' === $type && isset( $item['attrs'] ) && isset( $item['attrs']['fullwidth'] ) && 'on' !== $item['attrs']['fullwidth'] && isset( $item['attrs']['specialty'] ) && 'on' !== $item['attrs']['specialty'] && ( ! isset( $item['content'] ) || ! is_array( $item['content'] ) ) ) {
// insert empty row if saving empty Regular section to make it work correctly in BB.
$output .= '[et_pb_row admin_label="Row"][/et_pb_row]';
} elseif ( isset( $item['content'] ) && is_array( $item['content'] ) ) {
$output .= et_fb_process_to_shortcode( $item['content'], $options, '', $escape_content_slashes, $inject_responsive_hover );
} else {
if ( ! empty( $content ) ) {
if ( et_is_builder_plugin_active() && in_array( $type, ET_Builder_Element::get_has_content_modules(), true ) ) {
// Wrap content in autop to avoid tagless content on FE due to content is edited on html editor and only
// have one-line without newline wrap which prevent `the_content`'s wpautop filter to properly wrap it.
/**
* Filter whether to apply wpautop to content.
*
* This filter allows customization of whether the wpautop filter should be applied to
* the content of a shortcode. It helps in wrapping content in
tags automatically when necessary.
*
* @since 4.11.4
*
* @param bool $should_wpautop Whether to apply wpautop. Default true.
* @param string $type The shortcode or module type.
* @param string $content The content to be filtered.
* @param array $item The current shortcode being processed.
*/
$should_wpautop = apply_filters( 'et_fb_should_apply_wpautop', true, $type, $content, $item );
$content = $should_wpautop ? wpautop( $content ) : $content;
}
$output .= $content;
} else {
if ( isset( $item['content'] ) ) {
$_content = $item['content'];
if ( $escape_content_slashes ) {
$_content = str_replace( '\\', '\\\\', $_content );
}
if ( et_is_builder_plugin_active() && in_array( $type, ET_Builder_Element::get_has_content_modules(), true ) ) {
// Wrap content in autop to avoid tagless content on FE due to content is edited on html editor and only
// have one-line without newline wrap which prevent `the_content`'s wpautop filter to properly wrap it.
/**
* Filter whether to apply wpautop to content.
*
* This filter allows customization of whether the wpautop filter should be applied to
* the content of a shortcode. It helps in wrapping content in
tags automatically when necessary.
*
* @since 4.11.4
*
* @param bool $should_wpautop Whether to apply wpautop. Default true.
* @param string $type The shortcode or module type.
* @param string $content The content to be filtered.
* @param array $item The current shortcode being processed.
*/
$should_wpautop = apply_filters( 'et_fb_should_apply_wpautop', true, $type, $_content, $item );
$_content = $should_wpautop ? wpautop( $_content ) : $_content;
}
$output .= $_content;
} else {
$output .= '';
}
}
}
// add the closing tag.
$output .= '[/' . $type . ']';
}
}
return $output;
}
/**
* Ajax Callback :: Render shortcode output.
*/
function et_fb_ajax_render_shortcode() {
if ( ! isset( $_POST['et_pb_render_shortcode_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_pb_render_shortcode_nonce'] ), 'et_pb_render_shortcode_nonce' ) ) {
wp_send_json_error();
}
if ( ! current_user_can( 'edit_posts' ) ) {
wp_send_json_error();
}
$utils = ET_Core_Data_Utils::instance();
global $et_pb_predefined_module_index;
$et_pb_predefined_module_index = isset( $_POST['et_fb_module_index'] ) && 'default' !== $_POST['et_fb_module_index'] ? sanitize_text_field( $_POST['et_fb_module_index'] ) : false;
$options = isset( $_POST['options'] ) ? $utils->sanitize_text_fields( $_POST['options'] ) : array(); // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- sanitize_text_fields sanitize the options.
// enforce valid module slugs only
// shortcode slugs need to be allowlisted so as to prevent malicious shortcodes from being generated and run through do_shortcode().
$options['force_valid_slugs'] = true;
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['object'] will not be stored in db.
$object = isset( $_POST['object'] ) ? $_POST['object'] : array();
// convert shortcode array to shortcode string.
$shortcode = et_fb_process_to_shortcode( $object, $options );
// take shortcode string and ensure it's properly sanitized for the purposes of this function.
$shortcode = et_pb_enforce_builder_shortcode( $shortcode );
$output = do_shortcode( $shortcode );
$styles = ET_Builder_Element::get_style();
if ( ! empty( $styles ) ) {
$output .= sprintf(
'',
$styles
);
}
wp_send_json_success( $output );
}
add_action( 'wp_ajax_et_fb_ajax_render_shortcode', 'et_fb_ajax_render_shortcode' );
/**
* Determine current user can save the post.
*
* @param int $post_id Post id.
* @param string $status Post status.
*
* @return bool
*/
function et_fb_current_user_can_save( $post_id, $status = '' ) {
if ( 'page' === get_post_type( $post_id ) ) {
if ( ! current_user_can( 'edit_pages' ) ) {
return false;
}
if ( ! current_user_can( 'publish_pages' ) && 'publish' === $status ) {
return false;
}
if ( ! current_user_can( 'edit_published_pages' ) && 'publish' === get_post_status( $post_id ) ) {
return false;
}
if ( ! current_user_can( 'edit_others_pages' ) && ! current_user_can( 'edit_page', $post_id ) ) {
return false;
}
} else {
if ( ! current_user_can( 'edit_posts' ) ) {
return false;
}
if ( ! current_user_can( 'publish_posts' ) && 'publish' === $status ) {
return false;
}
if ( ! current_user_can( 'edit_published_posts' ) && 'publish' === get_post_status( $post_id ) ) {
return false;
}
if ( ! current_user_can( 'edit_others_posts' ) && ! current_user_can( 'edit_post', $post_id ) ) {
return false;
}
}
// If this is a theme builder layout post type, check divi roles for that capability.
if ( in_array( get_post_type( $post_id ), et_theme_builder_get_layout_post_types(), true ) && ! et_pb_is_allowed( 'theme_builder' ) ) {
return false;
}
return true;
}
/**
* Ajax Callback :: Drop backup/autosave depending on exit type.
*/
function et_fb_ajax_drop_autosave() {
if ( ! isset( $_POST['et_fb_drop_autosave_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_fb_drop_autosave_nonce'] ), 'et_fb_drop_autosave_nonce' ) ) {
wp_send_json_error();
}
$post_id = isset( $_POST['post_id'] ) ? absint( $_POST['post_id'] ) : 0;
if ( ! et_fb_current_user_can_save( $post_id ) ) {
wp_send_json_error();
}
$post_author = get_current_user_id();
$autosave = wp_get_post_autosave( $post_id, $post_author );
$autosave_deleted = false;
// delete builder settings autosave.
delete_post_meta( $post_id, "_et_builder_settings_autosave_{$post_author}" );
if ( ! empty( $autosave ) ) {
wp_delete_post_revision( $autosave->ID );
$autosave = wp_get_post_autosave( $post_id, $post_author );
if ( empty( $autosave ) ) {
$autosave_deleted = true;
}
} else {
$autosave_deleted = true;
}
if ( $autosave_deleted ) {
wp_send_json_success();
} else {
wp_send_json_error();
}
}
add_action( 'wp_ajax_et_fb_ajax_drop_autosave', 'et_fb_ajax_drop_autosave' );
/**
* Ajax Callback :: Save layout.
*/
function et_fb_ajax_save() {
if ( ! isset( $_POST['et_fb_save_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_fb_save_nonce'] ), 'et_fb_save_nonce' ) ) {
wp_send_json_error();
}
$utils = ET_Core_Data_Utils::instance();
$post_id = isset( $_POST['post_id'] ) ? absint( $_POST['post_id'] ) : 0;
$options = isset( $_POST['options'] ) ? $_POST['options'] : array(); // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['options'] is an array, it's value sanitization is done at the time of accessing value.
$layout_type = isset( $_POST['layout_type'] ) ? sanitize_text_field( $_POST['layout_type'] ) : '';
$is_theme_builder_layout = in_array( get_post_type( $post_id ), et_theme_builder_get_layout_post_types(), true );
// For post content check if user can save post.
if ( ! et_fb_current_user_can_save( $post_id, $utils->array_get_sanitized( $options, 'status' ) ) ) {
wp_send_json_error();
}
$update = false;
if ( ! isset( $_POST['skip_post_update'] ) ) {
$is_layout_block_preview = sanitize_text_field( $utils->array_get( $_POST, 'options.conditional_tags.is_layout_block', '' ) );
$block_id = sanitize_title( $utils->array_get( $_POST, 'options.current_page.blockId', '' ) );
$shortcode_data = isset( $_POST['modules'] ) ? json_decode( stripslashes( $_POST['modules'] ), true ) : array(); // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- modules string will be sanitized at the time of saving in the db.
// Cast as bool if falsey; blockId is retrieved from ajax request, and
// already return empty string (falsey) if no value found. Nevertheless let's be more safe.
if ( ! $block_id ) {
$block_id = false;
}
// Cast as bool if falsey; is_layout_block_preview is retrieved from ajax request, and
// already return empty string (falsey) if no value found. Nevertheless let's be more safe.
if ( ! $is_layout_block_preview ) {
$is_layout_block_preview = false;
}
$built_for_type = get_post_meta( $post_id, '_et_pb_built_for_post_type', true );
if ( ! $built_for_type && ! $is_layout_block_preview ) {
update_post_meta( $post_id, '_et_pb_built_for_post_type', 'page' );
}
// If Default Editor is used for Post Content, and Post Content is not edited,
// handleAjaxSave will pass return_to_default_editor,
// and in that case we need reactivate the default editor for the post.
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput.InputNotSanitized -- input is inside isset() function so its value is not used
if ( isset( $_POST['return_to_default_editor'] ) && rest_sanitize_boolean( $_POST['return_to_default_editor'] ) ) {
update_post_meta( $post_id, '_et_pb_use_builder', 'off' );
update_post_meta( $post_id, '_et_pb_show_page_creation', 'on' );
// Get old content and if we should return to the Default Editor.
$post_content = get_post_meta( $post_id, '_et_pb_old_content', true );
} else {
if ( ! $is_layout_block_preview ) {
update_post_meta( $post_id, '_et_pb_use_builder', 'on' );
}
$post_content = et_fb_process_to_shortcode( $shortcode_data, $options, $layout_type, true, true );
}
// Store a copy of the sanitized post content in case wpkses alters it since that
// would cause our check at the end of this function to fail.
$sanitized_content = sanitize_post_field( 'post_content', $post_content, $post_id, 'db' );
// Exit early for layout block update; builder should not actually save post content in this scenario
// Update post meta and let it is being used to update layoutContent on editor.
if ( $is_layout_block_preview && $block_id ) {
$layout_preview_meta_key = "_et_block_layout_preview_{$block_id}";
$saved_layout = get_post_meta( $post_id, $layout_preview_meta_key, true );
// If saved layout is identical to the the layout sent via AJAX, return send json success;
// this is needed because update_post_meta() returns false if the saved layout is identical
// to the the one given as param.
if ( ! empty( $saved_layout ) && $saved_layout === $post_content ) {
wp_send_json_success(
array(
'save_verification' => true,
)
);
wp_die();
}
$update = update_post_meta( $post_id, $layout_preview_meta_key, $post_content );
if ( $update ) {
wp_send_json_success(
array(
'save_verification' => true,
)
);
} else {
wp_send_json_error();
}
wp_die();
}
$update = wp_update_post(
array(
'ID' => $post_id,
'post_content' => $post_content,
'post_status' => $utils->array_get_sanitized( $options, 'status' ),
)
);
}
// update Global modules with selective sync.
if ( 'module' === $layout_type && isset( $_POST['unsyncedGlobalSettings'] ) && 'none' !== $_POST['unsyncedGlobalSettings'] ) {
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['unsyncedGlobalSettings'] will be sanitized before storing in db.
$unsynced_options = stripslashes( $_POST['unsyncedGlobalSettings'] );
update_post_meta( $post_id, '_et_pb_excluded_global_options', sanitize_text_field( $unsynced_options ) );
}
// check if there is an autosave that is newer.
$post_author = get_current_user_id();
// Store one autosave per author. If there is already an autosave, overwrite it.
$autosave = wp_get_post_autosave( $post_id, $post_author );
if ( ! empty( $autosave ) ) {
wp_delete_post_revision( $autosave->ID );
}
if ( isset( $_POST['settings'] ) && is_array( $_POST['settings'] ) ) {
et_builder_update_settings( $_POST['settings'], $post_id ); // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['settings'] is an array, it's value sanitization is done inside function at the time of accessing value.
}
if ( isset( $_POST['preferences'] ) && is_array( $_POST['preferences'] ) && ! $is_theme_builder_layout ) {
$app_preferences = et_fb_app_preferences_settings();
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['et_builder_mode'] value used in the comparision.
$limited_prefix = ! empty( $_POST['et_builder_mode'] ) && 'limited' === $_POST['et_builder_mode'] ? 'limited_' : '';
foreach ( $app_preferences as $preference_key => $preference_data ) {
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $preference_value will be sanitized before saving in db.
$preference_value = isset( $_POST['preferences'][ $preference_key ] ) && isset( $_POST['preferences'][ $preference_key ]['value'] ) ? $_POST['preferences'][ $preference_key ]['value'] : $preference_data['default'];
// sanitize based on type.
switch ( $preference_data['type'] ) {
case 'int':
$preference_value = absint( $preference_value );
break;
case 'bool':
$preference_value = 'true' === $preference_value ? 'true' : 'false';
break;
default:
$preference_value = sanitize_text_field( $preference_value );
break;
}
$preference_value_max_length = et_()->array_get( $preference_data, 'max_length', 0 );
if ( $preference_value && is_numeric( $preference_value_max_length ) && $preference_value_max_length > 0 ) {
$preference_value = substr( $preference_value, 0, $preference_value_max_length );
}
$option_name = 'et_fb_pref_' . $preference_key;
if ( in_array( $preference_key, et_fb_unsynced_preferences(), true ) ) {
$option_name = 'et_fb_pref_' . $limited_prefix . $preference_key;
}
et_update_option( $option_name, $preference_value );
}
}
// Clear AB Testing stats & transient data.
if ( isset( $_POST['ab_testing'] ) && isset( $_POST['ab_testing']['is_clear_stats'] ) && 'true' === $_POST['ab_testing']['is_clear_stats'] && et_pb_is_allowed( 'ab_testing' ) ) {
et_pb_ab_remove_stats( $post_id );
et_pb_ab_clear_cache_handler( $post_id );
}
do_action( 'et_save_post', $post_id );
if ( $update ) {
if ( ! empty( $_POST['et_builder_version'] ) ) {
update_post_meta( $post_id, '_et_builder_version', sanitize_text_field( $_POST['et_builder_version'] ) );
}
// Get saved post, verify its content against the one that is being sent.
$saved_post = get_post( $update );
$saved_post_content = $saved_post->post_content;
$builder_post_content = stripslashes( $sanitized_content );
// Get rendered post content only if it's needed.
$return_rendered_content = sanitize_text_field( $utils->array_get( $_POST, 'options.return_rendered_content', 'false' ) );
$rendered_post_content = 'true' === $return_rendered_content ? do_shortcode( $saved_post_content ) : '';
// If `post_content` column on wp_posts table doesn't use `utf8mb4` charset, the saved post
// content's emoji will be encoded which means the check of saved post_content vs
// builder's post_content will be false; Thus check the charset of `post_content` column
// first then encode the builder's post_content if needed
// @see https://make.wordpress.org/core/2015/04/02/omg-emoji-%f0%9f%98%8e/
// @see https://make.wordpress.org/core/2015/04/02/the-utf8mb4-upgrade/.
global $wpdb;
if ( 'utf8' === $wpdb->get_col_charset( $wpdb->posts, 'post_content' ) ) {
$builder_post_content = wp_encode_emoji( $builder_post_content );
}
$saved_verification = $saved_post_content === $builder_post_content;
if ( $saved_verification ) {
// Strip non-printable characters to ensure preg_match_all operation work properly.
$post_content_cleaned = preg_replace( '/[\x00-\x1F\x7F]/u', '', $saved_post->post_content );
preg_match_all( '/\[et_pb_section(.*?)?\]\[et_pb_row(.*?)?\]\[et_pb_column(.*?)?\](.+?)\[\/et_pb_column\]\[\/et_pb_row\]\[\/et_pb_section\]/m', $post_content_cleaned, $matches );
if ( isset( $matches[4] ) && ! empty( $matches[4] ) ) {
// Set page creation flow to off.
update_post_meta( $post_id, '_et_pb_show_page_creation', 'off' );
} else {
delete_post_meta( $post_id, '_et_pb_show_page_creation' );
}
}
/**
* Hook triggered when the Post is updated.
*
* @param int $post_id Post ID.
*
* @since 3.29
*/
do_action( 'et_update_post', $post_id );
wp_send_json_success(
array(
'status' => get_post_status( $update ),
'save_verification' => apply_filters( 'et_fb_ajax_save_verification_result', $saved_verification ),
'rendered_content' => $rendered_post_content,
)
);
} elseif ( isset( $_POST['skip_post_update'] ) ) {
wp_send_json_success();
} else {
wp_send_json_error();
}
}
add_action( 'wp_ajax_et_fb_ajax_save', 'et_fb_ajax_save' );
/**
* Ajax Callback :: Convert fb object into shortcode.
*/
function et_fb_get_shortcode_from_fb_object() {
if ( ! et_core_security_check( 'edit_posts', 'et_fb_convert_to_shortcode_nonce', 'et_fb_convert_to_shortcode_nonce', '_POST', false ) ) {
wp_send_json_error();
}
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['modules'] will not be stored in db.
$shortcode_data = isset( $_POST['modules'] ) ? json_decode( stripslashes( $_POST['modules'] ), true ) : array();
$layout_type = isset( $_POST['layout_type'] ) ? sanitize_text_field( $_POST['layout_type'] ) : '';
$post_content = et_fb_process_to_shortcode( $shortcode_data, array(), $layout_type );
// Get rendered post content only if it's needed.
$utils = ET_Core_Data_Utils::instance();
$return_rendered_content = sanitize_text_field( $utils->array_get( $_POST, 'options.return_rendered_content', 'false' ) );
$rendered_post_content = 'true' === $return_rendered_content ? do_shortcode( $post_content ) : '';
wp_send_json_success(
array(
'processed_content' => $post_content,
'rendered_content' => $rendered_post_content,
)
);
}
add_action( 'wp_ajax_et_fb_get_shortcode_from_fb_object', 'et_fb_get_shortcode_from_fb_object' );
/**
* Ajax Callback :: Convert shortcode into HTML.
*/
function et_fb_get_html_from_shortcode() {
if ( ! et_core_security_check( 'edit_posts', 'et_fb_shortcode_to_html_nonce', 'et_fb_shortcode_to_html_nonce', '_POST', false ) ) {
wp_send_json_error();
}
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- $_POST['modules'] will not be stored in db.
$post_content = isset( $_POST['content'] ) ? stripslashes( $_POST['content'] ) : '';
// Get rendered post content by shortcode.
$rendered_post_content = do_shortcode( $post_content );
wp_send_json_success(
array(
'rendered_content' => $rendered_post_content,
)
);
}
add_action( 'wp_ajax_et_fb_get_html_from_shortcode', 'et_fb_get_html_from_shortcode' );
/**
* Ajax Callback :: Save library modules.
*/
function et_fb_save_layout() {
if ( ! isset( $_POST['et_fb_save_library_modules_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_fb_save_library_modules_nonce'] ), 'et_fb_save_library_modules_nonce' ) ) {
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
if ( empty( $_POST['et_layout_name'] ) ) {
die( -1 );
}
$post_type = sanitize_text_field( et_()->array_get( $_POST, 'et_post_type', 'page' ) );
if ( et_theme_builder_is_layout_post_type( $post_type ) ) {
// Treat TB layouts as normal posts when storing layouts from the library.
$post_type = 'page';
}
$args = array(
'layout_type' => isset( $_POST['et_layout_type'] ) ? sanitize_text_field( $_POST['et_layout_type'] ) : 'layout',
'layout_selected_cats' => isset( $_POST['et_layout_cats'] ) ? sanitize_text_field( $_POST['et_layout_cats'] ) : '',
'layout_selected_tags' => isset( $_POST['et_layout_tags'] ) ? sanitize_text_field( $_POST['et_layout_tags'] ) : '',
'built_for_post_type' => $post_type,
'layout_new_cat' => isset( $_POST['et_layout_new_cat'] ) ? sanitize_text_field( $_POST['et_layout_new_cat'] ) : '',
'layout_new_tag' => isset( $_POST['et_layout_new_tag'] ) ? sanitize_text_field( $_POST['et_layout_new_tag'] ) : '',
'columns_layout' => isset( $_POST['et_columns_layout'] ) ? sanitize_text_field( $_POST['et_columns_layout'] ) : '0',
'module_type' => isset( $_POST['et_module_type'] ) ? sanitize_text_field( $_POST['et_module_type'] ) : 'et_pb_unknown',
'layout_scope' => isset( $_POST['et_layout_scope'] ) ? sanitize_text_field( $_POST['et_layout_scope'] ) : 'not_global',
'module_width' => isset( $_POST['et_module_width'] ) ? sanitize_text_field( $_POST['et_module_width'] ) : 'regular',
'layout_content' => isset( $_POST['et_layout_content'] ) ? et_fb_process_to_shortcode( json_decode( stripslashes( $_POST['et_layout_content'] ), true ) ) : '', // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The `$_POST['et_layout_content']` will be sanitized before saving into db.
'layout_name' => isset( $_POST['et_layout_name'] ) ? sanitize_text_field( $_POST['et_layout_name'] ) : '',
);
$new_layout_meta = et_pb_submit_layout( $args );
$updated_terms = array();
foreach ( [ 'layout_category', 'layout_tag' ] as $taxonomy ) {
$raw_terms_array = apply_filters( 'et_pb_new_layout_cats_array', get_terms( $taxonomy, array( 'hide_empty' => false ) ) );
$clean_terms_array = array();
if ( is_array( $raw_terms_array ) && ! empty( $raw_terms_array ) ) {
foreach ( $raw_terms_array as $term ) {
$clean_terms_array[] = array(
'name' => html_entity_decode( $term->name ),
'id' => $term->term_id,
'slug' => $term->slug,
);
}
}
$updated_terms[ $taxonomy ] = $clean_terms_array;
}
$data = array(
'layout_data' => json_decode( $new_layout_meta, true ),
'updated_terms' => $updated_terms,
);
die( wp_json_encode( et_core_esc_previously( $data ) ) );
}
add_action( 'wp_ajax_et_fb_save_layout', 'et_fb_save_layout' );
/**
* Ajax Callback :: Process shortcode to exported layout object.
*/
function et_fb_get_cloud_item_content() {
if ( ! isset( $_POST['et_fb_save_cloud_item_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_fb_save_cloud_item_nonce'] ), 'et_fb_save_cloud_item_nonce' ) ) {
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
$layout_type = isset( $_POST['et_layout_type'] ) ? sanitize_text_field( $_POST['et_layout_type'] ) : '';
$layout_content = isset( $_POST['et_layout_content'] ) ? et_fb_process_to_shortcode( json_decode( stripslashes( $_POST['et_layout_content'] ), true ), array(), $layout_type ) : ''; // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The `$_POST['et_layout_content']` will be sanitized before saving into db.
$exported_shortcode = get_exported_content( $layout_content );
die( wp_json_encode( array( 'shortcode' => $exported_shortcode ) ) );
}
add_action( 'wp_ajax_et_fb_get_cloud_item_content', 'et_fb_get_cloud_item_content' );
/**
* Prepare shortcode for exporting.
*
* @since 4.17.0
*
* @param string $shortcode Shortcode to process.
*
* @return array
*/
function get_exported_content( $shortcode ) {
// Set faux $_POST value that is required by portability.
$_POST['post'] = '1';
$_POST['content'] = $shortcode;
// Remove page value if it is equal to `false`, avoiding paginated images not accidentally triggered.
if ( isset( $_POST['page'] ) && false === $_POST['page'] ) { // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
unset( $_POST['page'] ); // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
}
$portability = et_core_portability_load( 'et_builder' );
// Export the content.
return $portability->export( true, true );
}
/**
* Ajax Callback :: Process shortcode.
*/
function et_fb_prepare_shortcode() {
if ( ! isset( $_POST['et_fb_prepare_shortcode_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['et_fb_prepare_shortcode_nonce'] ), 'et_fb_prepare_shortcode_nonce' ) ) {
wp_send_json_error();
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
// phpcs:disable ET.Sniffs.ValidatedSanitizedInput -- The `$_POST['et_page_content']` and `$_POST['apply_global_presets']` will not be stored on db.
$content = isset( $_POST['et_page_content'] ) ? json_decode( stripslashes( $_POST['et_page_content'] ), true ) : '';
$apply_global_presets = isset( $_POST['apply_global_presets'] ) ? wp_validate_boolean( $_POST['apply_global_presets'] ) : false;
// phpcs:enable
$options = array(
'apply_global_presets' => $apply_global_presets,
);
$result = $content ? et_fb_process_to_shortcode( $content, $options, '', false ) : '';
die( wp_json_encode( array( 'shortcode' => $result ) ) );
}
add_action( 'wp_ajax_et_fb_prepare_shortcode', 'et_fb_prepare_shortcode' );
/**
* Ajax Callback :: Save library module.
*/
function et_fb_update_layout() {
if ( ! isset( $_POST['et_fb_save_library_modules_nonce'] ) || ! wp_verify_nonce( $_POST['et_fb_save_library_modules_nonce'], 'et_fb_save_library_modules_nonce' ) ) { // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The nonce value is used only for comparision in the `wp_verify_nonce`.
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
$post_id = isset( $_POST['et_template_post_id'] ) ? absint( $_POST['et_template_post_id'] ) : '';
if ( ! current_user_can( 'edit_post', $post_id ) ) {
die( -1 );
}
// phpcs:disable ET.Sniffs.ValidatedSanitizedInput -- Following $_POST values will be sanitized before storing in db.
$post_content = isset( $_POST['et_layout_content'] ) ? json_decode( stripslashes( $_POST['et_layout_content'] ), true ) : array();
$new_content = isset( $_POST['et_layout_content'] ) ? et_fb_process_to_shortcode( $post_content ) : '';
$excluded_global_options = isset( $_POST['et_excluded_global_options'] ) ? stripslashes( $_POST['et_excluded_global_options'] ) : array();
$is_saving_global_module = isset( $_POST['et_saving_global_module'] ) ? sanitize_text_field( $_POST['et_saving_global_module'] ) : '';
// phpcs:enable
if ( '' !== $post_id ) {
$update = array(
'ID' => $post_id,
'post_content' => $new_content,
);
$result = wp_update_post( $update );
if ( ! $result || is_wp_error( $result ) ) {
wp_send_json_error();
}
ET_Core_PageResource::remove_static_resources( 'all', 'all' );
// update list of unsynced options for global module.
if ( 'true' === $is_saving_global_module ) {
update_post_meta( $post_id, '_et_pb_excluded_global_options', sanitize_text_field( $excluded_global_options ) );
}
}
die();
}
add_action( 'wp_ajax_et_fb_update_layout', 'et_fb_update_layout' );
/**
* Ajax Callback :: Return requested attachments from media library.
*/
function et_fb_fetch_attachments() {
et_core_security_check( 'edit_posts', 'et_fb_fetch_attachments', 'et_fb_fetch_attachments' );
$ids = ET_Core_Data_Utils::instance()->array_get( $_POST, 'ids' );
if ( empty( $ids ) ) {
wp_send_json( null );
} else {
$attachments = get_posts(
array(
'posts_per_page' => - 1,
'include' => $ids,
'post_type' => 'attachment',
)
);
foreach ( $attachments as $index => $attachment ) {
$metadata = array();
foreach ( get_intermediate_image_sizes() as $size ) {
$metadata[ $size ] = wp_get_attachment_image_src( $attachment->ID, $size );
}
$attachments[ $index ] = array_merge(
get_object_vars( $attachment ),
array(
'metadata' => $metadata,
)
);
}
wp_send_json( $attachments );
}
die();
}
add_action( 'wp_ajax_et_fb_fetch_attachments', 'et_fb_fetch_attachments' );
if ( ! function_exists( 'et_fb_disable_product_tour' ) ) :
/**
* Saving User Specific Tour status.
*/
function et_fb_disable_product_tour() {
do_action( 'et_fb_disable_product_tour' );
if ( ! et_core_security_check_passed( 'edit_posts' ) ) {
ET_Core_Logger::debug( 'Unable to disable product tour. Security check failed!' );
return;
}
$user_id = (int) get_current_user_id();
$product_tour_status = et_get_option( 'product_tour_status', [] );
$all_product_settings = is_array( $product_tour_status ) ? $product_tour_status : [];
$all_product_settings[ $user_id ] = 'off';
et_update_option( 'product_tour_status', $all_product_settings );
}
endif;
if ( ! function_exists( 'et_builder_include_categories_option' ) ) :
/**
* Generate output string for `include_categories` option used in backbone template.
*
* @param array $args Arguments to get project categories.
* @param string $default_category @todo Add parameter doc.
* @return string
*/
function et_builder_include_categories_option( $args = array(), $default_category = '' ) {
$custom_items = array();
if ( ! empty( $args['custom_items'] ) ) {
$custom_items = $args['custom_items'];
unset( $args['custom_items'] );
}
$defaults = array(
'use_terms' => true,
'term_name' => 'project_category',
'field_name' => 'et_pb_include_categories',
);
$defaults = apply_filters( 'et_builder_include_categories_defaults', $defaults );
$args = wp_parse_args( $args, $defaults );
$args['field_name'] = esc_attr( $args['field_name'] );
$term_args = apply_filters( 'et_builder_include_categories_option_args', array( 'hide_empty' => false ) );
$output = "\t<% var {$args['field_name']}_temp = typeof data !== 'undefined' && typeof data.{$args['field_name']} !== 'undefined' ? data.{$args['field_name']}.split( ',' ) : ['" . esc_html( $default_category ) . "']; {$args['field_name']}_temp = typeof data === 'undefined' && typeof {$args['field_name']} !== 'undefined' ? {$args['field_name']}.split( ',' ) : {$args['field_name']}_temp; %>\n";
if ( $args['use_terms'] ) {
$cats_array = get_terms( $args['term_name'], $term_args );
} else {
$cats_array = get_categories( apply_filters( 'et_builder_get_categories_args', 'hide_empty=0' ) );
}
$cats_array = array_merge( $custom_items, $cats_array );
if ( empty( $cats_array ) ) {
$taxonomy_type = $args['use_terms'] ? $args['term_name'] : 'category';
$taxonomy = get_taxonomy( $taxonomy_type );
$labels = get_taxonomy_labels( $taxonomy );
$output = sprintf( '
';
}
/**
* Setup Divi Builder in BFB.
*/
function et_pb_setup_main_editor() {
if ( ! et_core_is_gutenberg_enabled() ) {
add_action( 'edit_form_after_title', 'et_pb_before_main_editor' );
add_action( 'edit_form_after_editor', 'et_pb_after_main_editor' );
}
}
add_action( 'add_meta_boxes', 'et_pb_setup_main_editor', 11 );
/**
* Load scripts and styles in admin.
*
* @param string $hook The current admin page.
*/
function et_pb_admin_scripts_styles( $hook ) {
global $typenow, $pagenow;
// load css file for the Divi menu.
wp_enqueue_style( 'library-menu-styles', ET_BUILDER_URI . '/styles/library_menu.css', array(), ET_BUILDER_VERSION );
if ( 'widgets.php' === $hook ) {
wp_enqueue_script( 'et_pb_widgets_js', ET_BUILDER_URI . '/scripts/ext/widgets.js', array( 'jquery' ), ET_BUILDER_VERSION, true );
$et_pb_options_admin = array(
'ajaxurl' => admin_url( 'admin-ajax.php' ),
'et_admin_load_nonce' => wp_create_nonce( 'et_admin_load_nonce' ),
'widget_info' => sprintf(
'
%1$s.
%2$s.
',
esc_html__( 'Here you can create new widget areas for use in the Sidebar module', 'et_builder' ),
esc_html__( 'Note: Naming your widget area "sidebar 1", "sidebar 2", "sidebar 3", "sidebar 4" or "sidebar 5" will cause conflicts with this theme', 'et_builder' ),
esc_html__( 'Widget Name', 'et_builder' ),
esc_html__( 'Create', 'et_builder' )
),
'delete_string' => esc_html__( 'Delete', 'et_builder' ),
);
wp_localize_script( 'et_pb_widgets_js', 'et_pb_options', apply_filters( 'et_pb_options_admin', $et_pb_options_admin ) );
wp_enqueue_style( 'et_pb_widgets_css', ET_BUILDER_URI . '/styles/widgets.css', array(), ET_BUILDER_VERSION );
return;
}
// Do not enqueue BB assets if GB is active on this page.
if ( et_core_is_gutenberg_enabled() ) {
return;
}
if ( ! in_array( $hook, array( 'post-new.php', 'post.php' ), true ) ) {
return;
}
/*
* Load the builder javascript and css files for custom post types
* custom post types can be added using et_builder_post_types filter
*/
$post_types = et_builder_get_builder_post_types();
$on_enabled_post_type = isset( $typenow ) && in_array( $typenow, $post_types, true );
$on_enabled_post = isset( $pagenow ) && 'post.php' === $pagenow && isset( $_GET['post'] ) && et_builder_enabled_for_post( intval( $_GET['post'] ) ); // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
if ( $on_enabled_post_type || $on_enabled_post ) {
wp_enqueue_style( 'et_bb_bfb_common', ET_BUILDER_URI . '/styles/bb_bfb_common.css', array(), ET_BUILDER_VERSION );
// Boot the Enable Divi Builder button scripts.
et_bfb_enqueue_scripts();
}
}
add_action( 'admin_enqueue_scripts', 'et_pb_admin_scripts_styles', 10, 1 );
/**
* Disable emoji detection script on edit page which has Backend Builder on it.
* WordPress automatically replaces emoji with plain image for backward compatibility
* on older browsers. This causes issue when emoji is used on header or other input
* text field because (when the modal is saved, shortcode is generated, and emoji
* is being replaced with plain image) it creates incorrect attribute markup
* such as `title="I WP"` and causes
* the whole input text value to be disappeared
*
* @return void
*/
function et_pb_remove_emoji_detection_script() {
// phpcs:disable WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
global $pagenow;
$disable_emoji_detection = false;
// Disable emoji detection script on editing page which has Backend Builder
// global $post isn't available at admin_init, so retrieve $post data manually.
if ( 'post.php' === $pagenow && isset( $_GET['post'] ) ) {
$post_id = (int) $_GET['post'];
$post = get_post( $post_id );
if ( is_a( $post, 'WP_POST' ) && et_builder_enabled_for_post( $post->ID ) ) {
$disable_emoji_detection = true;
}
}
// Disable emoji detection script on post new page which has Backend Builder.
$has_post_type_query = isset( $_GET['post_type'] );
if ( 'post-new.php' === $pagenow && ( ! $has_post_type_query || ( $has_post_type_query && in_array( $_GET['post_type'], et_builder_get_builder_post_types(), true ) ) ) ) {
$disable_emoji_detection = true;
}
if ( $disable_emoji_detection ) {
remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
}
// phpcs:enable
}
add_action( 'admin_init', 'et_pb_remove_emoji_detection_script' );
/**
* Disable emoji detection script on visual builder
* WordPress automatically replaces emoji with plain image for backward compatibility
* on older browsers. This causes issue when emoji is used on header or other input
* text field because the staticize emoji creates HTML markup which appears to be
* invalid on input[type="text"] field such as `title="I WP"` and causes the input text value to be escaped and
* disappeared
*
* @return void
*/
function et_fb_remove_emoji_detection_script() {
global $post;
// Disable emoji detection script on visual builder. React's auto escaping will
// remove all staticized emoji when being opened on modal's input field.
if ( isset( $post->ID ) && et_fb_is_enabled( $post->ID ) ) {
remove_action( 'wp_head', 'print_emoji_detection_script', 7 );
}
}
add_action( 'wp', 'et_fb_remove_emoji_detection_script' );
/**
* If the builder is used for the page, get rid of random p tags.
*
* @since 5.0.0 Deprecated. Please use \ET\Builder\Framework\Utility\HTMLUtility::fix_builder_shortcodes() instead.
*
* @param string $content content.
*
* @return string|string[]|null
*
* @deprecated
*/
function et_pb_fix_builder_shortcodes( $content ) {
et_debug( "You're Doing It Wrong! Attempted to call " . __FUNCTION__ . '(), use \ET\Builder\Framework\Utility::fix_builder_shortcodes() instead.' );
// Ensure HTMLUtility is loaded before using it.
require_once get_template_directory() . '/includes/builder-5/server/Framework/Utility/HTMLUtility.php';
return \ET\Builder\Framework\Utility\HTMLUtility::fix_builder_shortcodes();
}
/**
* Prepare code module for wpautop.
*
* @param string $content content.
*
* @return string|string[]|null
*/
function et_pb_the_content_prep_code_module_for_wpautop( $content ) {
if ( 'on' === get_post_meta( get_the_ID(), '_et_pb_use_builder', true ) ) {
$content = et_pb_prep_code_module_for_wpautop( $content );
}
return $content;
}
if ( ! function_exists( 'et_pb_generate_new_layout_modal' ) ) {
/**
* Generate the html for "Add new template" Modal in Library.
*
* @return mixed|void
*/
function et_pb_generate_new_layout_modal() {
$template_type_option_output = '';
$layout_cat_option_output = '';
$layout_cats_list = '';
$layout_tags_list = '';
$template_type_options_list = '';
$new_layout_template_types = array(
'module' => esc_html__( 'Module', 'et_builder' ),
'row' => esc_html__( 'Row', 'et_builder' ),
'section' => esc_html__( 'Section', 'et_builder' ),
'layout' => et_builder_i18n( 'Layout' ),
);
$template_type_options = apply_filters( 'et_pb_new_layout_template_types', $new_layout_template_types );
// construct output for the template type option.
if ( ! empty( $template_type_options ) ) {
foreach ( $template_type_options as $option_id => $option_name ) {
$template_type_options_list .= sprintf(
'',
esc_attr( $option_id ),
esc_html( $option_name )
);
}
$template_type_option_output = sprintf(
'
',
esc_html__( 'Layout Type', 'et_builder' ),
$template_type_options_list
);
}
$template_global_option_output = apply_filters(
'et_pb_new_layout_global_option',
sprintf(
'',
esc_html__( 'Save as Global', 'et_builder' )
)
);
$layout_categories = apply_filters( 'et_pb_new_layout_cats_array', get_terms( 'layout_category', array( 'hide_empty' => false ) ) );
if ( is_array( $layout_categories ) && ! empty( $layout_categories ) ) {
foreach ( $layout_categories as $category ) {
$layout_cats_list .= sprintf(
'',
esc_html( $category->name ),
esc_attr( $category->term_id )
);
}
}
$layout_tags = apply_filters( 'et_pb_new_layout_tags_array', get_terms( 'layout_tag', array( 'hide_empty' => false ) ) );
if ( is_array( $layout_tags ) && ! empty( $layout_tags ) ) {
foreach ( $layout_tags as $tag ) {
$layout_tags_list .= sprintf(
'',
esc_html( $tag->name ),
esc_attr( $tag->term_id )
);
}
}
// Construct output for the layout Tag option.
$layout_cat_option_output = sprintf(
'
%3$s
',
esc_html__( 'Add To Categories', 'et_builder' ),
esc_html__( 'Create new Category', 'et_builder' ),
$layout_cats_list
);
// Construct output for the layout Tag option.
$layout_tag_option_output = sprintf(
'
%3$s
',
esc_html__( 'Add To Tags', 'et_builder' ),
esc_html__( 'Create new Tag', 'et_builder' ),
$layout_tags_list
);
$output = sprintf(
'
%1$s
%6$s
%3$s
%4$s
%5$s
%8$s
%7$s
',
esc_html__( 'Add New Layout', 'et_builder' ),
esc_html__( 'Layout Name', 'et_builder' ),
$template_type_option_output,
$template_global_option_output,
$layout_cat_option_output, // #5
apply_filters( 'et_pb_new_layout_before_options', '' ),
apply_filters( 'et_pb_new_layout_after_options', '' ),
$layout_tag_option_output
);
return apply_filters( 'et_pb_new_layout_modal_output', $output );
}
}
if ( ! function_exists( 'et_pb_get_layout_type' ) ) :
/**
* Get layout type of given post ID.
*
* @param int $post_id post id.
*
* @return string|bool
*/
function et_pb_get_layout_type( $post_id ) {
// Get taxonomies.
$layout_type_data = wp_get_post_terms( $post_id, 'layout_type' );
if ( empty( $layout_type_data ) ) {
return false;
}
// Pluck name out of taxonomies.
$layout_type_array = wp_list_pluck( $layout_type_data, 'name' );
// Logically, a layout only have one layout type.
$layout_type = implode( '|', $layout_type_array );
return $layout_type;
}
endif;
if ( ! function_exists( 'et_pb_is_wp_old_version' ) ) :
/**
* Determine current wp version is less than 4.5.
*/
function et_pb_is_wp_old_version() {
global $wp_version;
$wp_major_version = substr( $wp_version, 0, 3 );
if ( version_compare( $wp_major_version, '4.5', '<' ) ) {
return true;
}
return false;
}
endif;
if ( ! function_exists( 'et_builder_theme_or_plugin_updated_cb' ) ) :
/**
* Delete cached definitions/helpers after theme or plugin update.
*/
function et_builder_theme_or_plugin_updated_cb() {
// Delete cached definitions / helpers.
et_fb_delete_builder_assets();
et_update_option( 'et_pb_clear_templates_cache', true );
}
add_action( 'after_switch_theme', 'et_builder_theme_or_plugin_updated_cb' );
add_action( 'activated_plugin', 'et_builder_theme_or_plugin_updated_cb', 10, 0 );
add_action( 'deactivated_plugin', 'et_builder_theme_or_plugin_updated_cb', 10, 0 );
add_action( 'upgrader_process_complete', 'et_builder_theme_or_plugin_updated_cb', 10, 0 );
add_action( 'et_support_center_toggle_safe_mode', 'et_builder_theme_or_plugin_updated_cb', 10, 0 );
endif;
if ( ! function_exists( 'et_bfb_enqueue_scripts' ) ) :
/**
* Register BFB scripts.
*/
function et_bfb_enqueue_scripts() {
global $post;
$bfb_options = array(
'ajaxurl' => admin_url( 'admin-ajax.php' ),
'et_enable_bfb_nonce' => wp_create_nonce( 'et_enable_bfb_nonce' ),
'default_initial_column_type' => apply_filters( 'et_builder_default_initial_column_type', '4_4' ),
'default_initial_text_module' => apply_filters( 'et_builder_default_initial_text_module', 'et_pb_text' ),
'skip_default_content_adding' => apply_filters( 'et_builder_skip_content_activation', false, $post ) ? 'skip' : '',
);
wp_localize_script( 'et_bfb_admin_js', 'et_bfb_options', apply_filters( 'et_bfb_options', $bfb_options ) );
}
endif;
/**
* List of history meta.
*
* @return array History meta.
*/
function et_pb_history_localization() {
return array(
'verb' => array(
'did' => esc_html__( 'Did', 'et_builder' ),
'added' => esc_html__( 'Added', 'et_builder' ),
'edited' => esc_html__( 'Edited', 'et_builder' ),
'removed' => esc_html__( 'Removed', 'et_builder' ),
'moved' => esc_html__( 'Moved', 'et_builder' ),
'expanded' => esc_html__( 'Expanded', 'et_builder' ),
'collapsed' => esc_html__( 'Collapsed', 'et_builder' ),
'locked' => esc_html__( 'Locked', 'et_builder' ),
'unlocked' => esc_html__( 'Unlocked', 'et_builder' ),
'cloned' => esc_html__( 'Cloned', 'et_builder' ),
'cleared' => esc_html__( 'Cleared', 'et_builder' ),
'enabled' => esc_html__( 'Enabled', 'et_builder' ),
'disabled' => esc_html__( 'Disabled', 'et_builder' ),
'copied' => esc_html__( 'Copied', 'et_builder' ),
'reset' => esc_html__( 'Reset', 'et_builder' ),
'cut' => esc_html__( 'Cut', 'et_builder' ),
'pasted' => esc_html__( 'Pasted', 'et_builder' ),
'pasted_styles' => esc_html__( 'Pasted Styles', 'et_builder' ),
'renamed' => esc_html__( 'Renamed', 'et_builder' ),
'loaded' => esc_html__( 'Loaded', 'et_builder' ),
'turnon' => esc_html__( 'Turned On', 'et_builder' ),
'turnoff' => esc_html__( 'Turned Off', 'et_builder' ),
'globalon' => esc_html__( 'Made Global', 'et_builder' ),
'globaloff' => esc_html__( 'Disabled Global', 'et_builder' ),
'configured' => esc_html__( 'Configured', 'et_builder' ),
'find_replace' => esc_html__( 'Find & Replace', 'et_builder' ),
'extend_styles' => esc_html__( 'Extend Styles', 'et_builder' ),
'imported' => esc_html__( 'Imported From Layout', 'et_builder' ),
'presetCreated' => esc_html__( 'Preset Created For', 'et_builder' ),
'presetNameChanged' => esc_html__( 'Preset Name Changed For', 'et_builder' ),
'presetDeleted' => esc_html__( 'Preset Deleted For', 'et_builder' ),
'presetAssignedAsDefault' => esc_html__( 'Preset Assigned As Default For', 'et_builder' ),
),
'noun' => array(
'section' => esc_html__( 'Section', 'et_builder' ),
'saved_section' => esc_html__( 'Saved Section', 'et_builder' ),
'fullwidth_section' => esc_html__( 'Fullwidth Section', 'et_builder' ),
'specialty_section' => esc_html__( 'Specialty Section', 'et_builder' ),
'column' => esc_html__( 'Column', 'et_builder' ),
'row' => esc_html__( 'Row', 'et_builder' ),
'saved_row' => esc_html__( 'Saved Row', 'et_builder' ),
'module' => esc_html__( 'Module', 'et_builder' ),
'saved_module' => esc_html__( 'Saved Module', 'et_builder' ),
'page' => esc_html__( 'Page', 'et_builder' ),
'layout' => et_builder_i18n( 'Layout' ),
'abtesting' => esc_html__( 'Split Testing', 'et_builder' ),
'settings' => esc_html__( 'Settings', 'et_builder' ),
),
'addition' => array(
'phone' => esc_html__( 'on Phone', 'et_builder' ),
'tablet' => esc_html__( 'on Tablet', 'et_builder' ),
'desktop' => esc_html__( 'on Desktop', 'et_builder' ),
),
);
}
if ( ! function_exists( 'et_pb_get_the_author_posts_link' ) ) :
/**
* Return a post author link markup.
*/
function et_pb_get_the_author_posts_link() {
global $authordata, $post;
// Fallback for preview.
if ( empty( $authordata ) && isset( $post->post_author ) ) {
$authordata = get_userdata( $post->post_author ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- If $authordata is not set then set it.
}
// If $authordata is empty, don't continue.
if ( empty( $authordata ) ) {
return;
}
$link = sprintf(
'%3$s',
esc_url( get_author_posts_url( $authordata->ID, $authordata->user_nicename ) ),
// translators: post author name.
esc_attr( sprintf( __( 'Posts by %s', 'et_builder' ), get_the_author() ) ),
get_the_author()
);
return apply_filters( 'the_author_posts_link', $link );
}
endif;
if ( ! function_exists( 'et_pb_get_comments_popup_link' ) ) :
/**
* Return comments link.
*
* @param bool|string $zero text to display when 0 comments.
* @param bool|string $one text to display when 1 comment.
* @param bool|string $more text to display for more than 1 comments.
*/
function et_pb_get_comments_popup_link( $zero = false, $one = false, $more = false ) {
$id = get_the_ID();
$number = get_comments_number( $id );
if ( 0 === $number && ! comments_open() && ! pings_open() ) {
return;
}
if ( $number > 1 ) {
// translators: more comments text.
$output = str_replace( '%', number_format_i18n( $number ), ( false === $more ) ? __( '% Comments', 'et_builder' ) : $more );
} elseif ( 0 === $number ) {
$output = ( false === $zero ) ? __( 'No Comments', 'et_builder' ) : $zero;
} else { // must be one.
$output = ( false === $one ) ? __( '1 Comment', 'et_builder' ) : $one;
}
do_action( 'et_builder_before_comments_number' );
$link = '' . apply_filters( 'comments_number', esc_html( $output ), esc_html( $number ) ) . '';
do_action( 'et_builder_after_comments_number' );
return $link;
}
endif;
if ( ! function_exists( 'et_pb_postinfo_meta' ) ) :
/**
* Return post meta.
*
* @param string[] $postinfo post info e.g date, author, categories.
* @param string $date_format date format.
* @param string $comment_zero text to display for 0 comments.
* @param string $comment_one text to display for 1 comments.
* @param string $comment_more text to display for more comments.
*/
function et_pb_postinfo_meta( $postinfo, $date_format, $comment_zero, $comment_one, $comment_more ) {
$postinfo_meta = array();
if ( in_array( 'author', $postinfo, true ) ) {
$postinfo_meta[] = ' ' . esc_html__( 'by', 'et_builder' ) . ' ' . et_pb_get_the_author_posts_link() . '';
}
if ( in_array( 'date', $postinfo, true ) ) {
$postinfo_meta[] = '' . esc_html( get_the_time( $date_format ) ) . '';
}
if ( in_array( 'categories', $postinfo, true ) ) {
$categories_list = get_the_category_list( ', ' );
// do not output anything if no categories retrieved.
if ( '' !== $categories_list ) {
$postinfo_meta[] = $categories_list;
}
}
if ( in_array( 'comments', $postinfo, true ) ) {
$postinfo_meta[] = et_pb_get_comments_popup_link( $comment_zero, $comment_one, $comment_more );
}
return implode( ' | ', array_filter( $postinfo_meta ) );
}
endif;
if ( ! function_exists( 'et_pb_fix_shortcodes' ) ) {
/**
* Fix shortcodes? @todo Add function doc.
*
* @param string $content post content.
* @param bool $is_raw_content whether content is row.
*
* @return string|string[]|null
*/
function et_pb_fix_shortcodes( $content, $is_raw_content = false ) {
/*
* TODO feat(D5, Refactor): Deprecate the function in the future.
*
* Before deprecating this function, we need to ensure this function is no longer being used in D5 backward
* compatibility mode.
*/
// Ensure HTMLUtility is loaded before using it.
require_once get_template_directory() . '/includes/builder-5/server/Framework/Utility/HTMLUtility.php';
return \ET\Builder\Framework\Utility\HTMLUtility::fix_shortcodes( $content, $is_raw_content );
}
}
if ( ! function_exists( 'et_pb_load_global_module' ) ) {
/**
* Return gloval module content.
*
* @param integer $global_id layout id.
* @param string $row_type row type.
* @param string $prev_bg Previous background color.
* @param string $next_bg next background color.
*
* @return string|string[]|null
*/
function et_pb_load_global_module( $global_id, $row_type = '', $prev_bg = '', $next_bg = '' ) {
$global_shortcode = '';
if ( '' !== $global_id ) {
$query = new WP_Query(
array(
'p' => (int) $global_id,
'post_type' => array(
ET_BUILDER_LAYOUT_POST_TYPE,
ET_THEME_BUILDER_HEADER_LAYOUT_POST_TYPE,
ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE,
ET_THEME_BUILDER_FOOTER_LAYOUT_POST_TYPE,
),
)
);
if ( ! empty( $query->post ) ) {
// Call the_post() to properly configure post data. Make sure to call the_post() and
// wp_reset_postdata() only if the posts result exist to avoid unexpected issues.
$query->the_post();
wp_reset_postdata();
$global_shortcode = $query->post->post_content;
if ( '' !== $row_type && 'et_pb_row_inner' === $row_type ) {
$global_shortcode = str_replace( 'et_pb_row', 'et_pb_row_inner', $global_shortcode );
$global_shortcode = str_replace( 'et_pb_column', 'et_pb_column_inner', $global_shortcode );
}
}
}
// Set provided prev_background_color.
if ( ! empty( $prev_bg ) ) {
$global_shortcode = preg_replace( '/prev_background_color="(.*?)"/', 'prev_background_color="' . $prev_bg . '"', $global_shortcode, 1 );
}
// Set provided next_background_color.
if ( ! empty( $next_bg ) ) {
$global_shortcode = preg_replace( '/next_background_color="(.*?)"/', 'next_background_color="' . $next_bg . '"', $global_shortcode, 1 );
}
return $global_shortcode;
}
}
if ( ! function_exists( 'et_pb_extract_shortcode_content' ) ) {
/**
* Return the shortcode content.
*
* @param string $content content.
* @param string $shortcode_name shortcode name.
*
* @return bool|false|string
*/
function et_pb_extract_shortcode_content( $content, $shortcode_name ) {
$start = strpos( $content, ']' ) + 1;
$end = strrpos( $content, '[/' . $shortcode_name );
if ( false !== $end ) {
$content = substr( $content, $start, $end - $start );
} else {
$content = (bool) false;
}
return $content;
}
}
if ( ! function_exists( 'et_pb_remove_shortcode_content' ) ) {
/**
* Remove the content part of the shortcode.
*
* @param string $content content.
* @param string $shortcode_name shortcode name.
*
* @return string|string[]
*/
function et_pb_remove_shortcode_content( $content, $shortcode_name ) {
$shortcode_content = et_pb_extract_shortcode_content( $content, $shortcode_name );
if ( $shortcode_content ) {
// Anchor to the ][ brackets around the content so content that appears in
// attributes does not get removed as well.
return str_replace( ']' . $shortcode_content . '[', '][', $content );
}
return $content;
}
}
if ( ! function_exists( 'et_pb_get_global_module_content' ) ) {
/**
* Return global module content.
*
* @param string $content content.
* @param string $shortcode_name shortcode slug.
* @param bool $for_inner_row whether we getting module content for inner row.
*
* @return bool|false|string|string[]|null
*/
function et_pb_get_global_module_content( $content, $shortcode_name, $for_inner_row = false ) {
/**
* Filter list of modules where we don't need to apply autop to the global module content.
*
* @param array Module slugs list.
*/
$custom_autop_ignored_modules = apply_filters( 'et_builder_global_modules_ignore_autop', array() );
$custom_autop_ignored_modules = is_array( $custom_autop_ignored_modules ) ? $custom_autop_ignored_modules : array();
$default_autop_ignored_modules = array_merge( array( 'et_pb_code', 'et_pb_fullwidth_code' ), $custom_autop_ignored_modules );
// Do not apply autop to code modules.
if ( in_array( $shortcode_name, $default_autop_ignored_modules, true ) ) {
return et_pb_extract_shortcode_content( $content, $shortcode_name );
}
$original_code_modules = array();
$shortcode_content = et_pb_extract_shortcode_content( $content, $shortcode_name );
// Getting content for Global row when it's turned to inner row in specialty section
// Need to make sure it wrapped in et_pb_column_inner, not et_pb_column.
if ( $for_inner_row && false === strpos( $shortcode_content, '[et_pb_column_inner' ) ) {
$shortcode_content = str_replace( 'et_pb_column', 'et_pb_column_inner', $shortcode_content );
}
// Get all the code and fullwidth code modules from content.
preg_match_all( '/(\[et_pb(_fullwidth_code|_code).+?\[\/et_pb(_fullwidth_code|_code)\])/s', $shortcode_content, $original_code_modules );
$global_content = et_pb_fix_shortcodes( wpautop( $shortcode_content ) );
// Replace content modified by wpautop for code and fullwidth code modules with original content.
if ( ! empty( $original_code_modules ) ) {
global $et_pb_global_code_replacements;
$et_pb_global_code_replacements = $original_code_modules[0];
$global_content = preg_replace_callback( '/(\[et_pb(_fullwidth_code|_code).+?\[\/et_pb(_fullwidth_code|_code)\])/s', 'et_builder_get_global_code_replacement', $global_content );
}
return $global_content;
}
}
if ( ! function_exists( 'et_builder_get_global_code_replacement' ) ) {
/**
* Retrieve the global code original instance to replace the modified in global code shortcode.
*
* @param array $matches found matches.
*
* @return mixed
*/
function et_builder_get_global_code_replacement( $matches ) {
global $et_pb_global_code_replacements;
return array_shift( $et_pb_global_code_replacements );
}
}
if ( ! function_exists( 'et_builder_activate_bfb_auto_draft' ) ) {
/**
* Force activate post_id which has auto-draft status
*/
function et_builder_activate_bfb_auto_draft() {
et_core_security_check( 'edit_posts', 'et_enable_bfb_nonce' );
$post_id = ! empty( $_POST['et_post_id'] ) ? absint( $_POST['et_post_id'] ) : 0;
if ( 0 === $post_id || ! current_user_can( 'edit_post', $post_id ) ) {
die();
}
// et_builder_activate_bfb_auto_draft() is executed when post title and content empty which means post_status is still lik. ely
// to be "auto-draft". "auto-draft" status returns 404 page; thus post status needs to be updated to "draft".
wp_update_post(
array(
'ID' => $post_id,
'post_status' => 'draft',
)
);
update_post_meta( $post_id, '_et_pb_use_builder', 'on' );
die();
}
}
add_action( 'wp_ajax_et_builder_activate_bfb_auto_draft', 'et_builder_activate_bfb_auto_draft' );
if ( ! function_exists( 'et_builder_ajax_toggle_bfb' ) ) {
/**
* Ajax Callback :: Switch To The New Divi Builder.
*/
function et_builder_ajax_toggle_bfb() {
et_core_security_check( 'manage_options', 'et_builder_toggle_bfb', 'nonce', '_GET' );
$enable = isset( $_GET['enable'] ) && '1' === $_GET['enable'];
$redirect = isset( $_GET['redirect'] ) ? esc_url_raw( $_GET['redirect'] ) : '';
if ( empty( $redirect ) && isset( $_SERVER['HTTP_REFERER'] ) ) {
$redirect = esc_url_raw( $_SERVER['HTTP_REFERER'] );
}
if ( empty( $redirect ) ) {
$redirect = esc_url_raw( admin_url( '/' ) );
}
et_builder_toggle_bfb( $enable );
set_transient( 'et_builder_show_bfb_welcome_modal', true, 0 );
wp_safe_redirect( $redirect );
exit;
}
}
add_action( 'wp_ajax_et_builder_toggle_bfb', 'et_builder_ajax_toggle_bfb' );
/**
* Return font weight select input element html.
*
* @return string
*/
function et_generate_font_weight_select_output() {
$all_weights = et_builder_get_font_weight_list();
$output = '';
foreach ( $all_weights as $number => $name ) {
$output .= sprintf(
'',
esc_attr( $number ),
esc_html( $name ),
esc_html( $number )
);
}
return $output;
}
/**
* Return regular and specialty layouts.
*
* @return mixed|void
*/
function et_builder_get_columns() {
$columns = array(
'specialty' => array(
'1_2,1_2' => array(
'position' => '1,0',
'columns' => '3',
),
'1_2,1_2' => array(
'position' => '0,1',
'columns' => '3',
),
'1_4,3_4' => array(
'position' => '0,1',
'columns' => '3',
),
'3_4,1_4' => array(
'position' => '1,0',
'columns' => '3',
),
'1_4,1_4,1_2' => array(
'position' => '0,0,1',
'columns' => '3',
),
'1_2,1_4,1_4' => array(
'position' => '1,0,0',
'columns' => '3',
),
'1_4,1_2,1_4' => array(
'position' => '0,1,0',
'columns' => '3',
),
'1_3,2_3' => array(
'position' => '0,1',
'columns' => '4',
),
'2_3,1_3' => array(
'position' => '1,0',
'columns' => '4',
),
),
'regular' => array(
'4_4',
'1_2,1_2',
'1_3,1_3,1_3',
'1_4,1_4,1_4,1_4',
'1_5,1_5,1_5,1_5,1_5',
'1_6,1_6,1_6,1_6,1_6,1_6',
'2_5,3_5',
'3_5,2_5',
'1_3,2_3',
'2_3,1_3',
'1_4,3_4',
'3_4,1_4',
'1_4,1_2,1_4',
'1_5,3_5,1_5',
'1_4,1_4,1_2',
'1_2,1_4,1_4',
'1_5,1_5,3_5',
'3_5,1_5,1_5',
'1_6,1_6,1_6,1_2',
'1_2,1_6,1_6,1_6',
),
);
return apply_filters( 'et_builder_get_columns', $columns );
}
/**
* Return columns layout.
*
* @return mixed|void
*/
function et_builder_get_columns_layout() {
$layout_columns =
'<% if ( typeof et_pb_specialty !== \'undefined\' && et_pb_specialty === \'on\' ) { %>
<% if ( view.model.attributes.layout === "2_3" ) { %>
<% } else { %>
<% } %>
<% } else { %>
<%
}
%>';
return apply_filters( 'et_builder_layout_columns', $layout_columns );
}
/**
* Display meta box in admin screen.
*/
function et_pb_pagebuilder_meta_box() {
global $typenow, $post;
do_action( 'et_pb_before_page_builder' );
if ( et_builder_bfb_enabled() ) {
$new_page_url = false;
$is_new_page = false;
$edit_page_id = get_the_ID();
$no_rtl_class = is_rtl() && 'on' === et_get_option( 'divi_disable_translations', 'off' ) ? 'et-fb-no-rtl' : '';
// Polylang creates copy of page and BFB should be loaded on page which is not saved yet and cannot be loaded on FE
// Therefore load the homepage and replace the content for BFB to make it load with content from other post.
if ( 'add' === get_current_screen()->action || (int) get_option( 'page_for_posts' ) === $edit_page_id ) {
$new_page_url = get_home_url();
$is_new_page = true;
}
$bfb_url = et_core_intentionally_unescaped( et_fb_get_bfb_url( $new_page_url, $is_new_page, $edit_page_id ), 'fixed_string' );
// If Admin is SSL but FE is not, we need to fix VB url or it won't work
// because trying to load insecure resource.
$bfb_url = set_url_scheme( $bfb_url, is_ssl() ? 'https' : 'http' );
// phpcs:disable WordPress.Security.EscapeOutput -- XSS safe.
echo "
";
// phpcs:enable
return;
}
$new_builder_url_args = array(
'action' => 'et_builder_toggle_bfb',
'enable' => '1',
'nonce' => wp_create_nonce( 'et_builder_toggle_bfb' ),
);
$new_builder_url = add_query_arg( $new_builder_url_args, admin_url( 'admin-ajax.php' ) );
// Disable BFB notification on Extra category builder. BFB support for Extra category builder will be added post inital launch
// This option available for admins only.
if ( apply_filters( 'et_pb_display_bfb_notification_under_bb', true ) && current_user_can( 'manage_options' ) && et_pb_is_allowed( 'use_visual_builder' ) && et_pb_is_allowed( 'divi_builder_control' ) ) {
echo '
',
esc_html( get_the_title() ),
esc_url( get_permalink() ),
esc_url( et_get_link_url() ),
esc_html( et_get_link_url() ),
esc_attr( $text_color_class ),
et_core_esc_previously( $inline_style )
);
break;
}
}
endif;
if ( ! function_exists( 'et_get_blockquote_in_content' ) ) :
/**
* Extract and return the first blockquote from content.
*/
function et_get_blockquote_in_content() {
global $more;
$more_default = $more;
$more = 1; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Disable `$more` flag to get the blockquote that may exist after tag.
remove_filter( 'the_content', 'et_remove_blockquote_from_content' );
$content = apply_filters( 'the_content', get_the_content() );
add_filter( 'the_content', 'et_remove_blockquote_from_content' );
$more = $more_default; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited -- Restore default `$more` flag.
if ( preg_match( '//is', $content, $matches ) ) {
return $matches[0];
} else {
return false;
}
}
endif;
if ( ! function_exists( 'et_get_link_url' ) ) :
/**
* Return link from the post content.
*/
function et_get_link_url() {
$link_url = get_post_meta( get_the_ID(), '_format_link_url', true );
if ( '' !== $link_url ) {
return $link_url;
}
$content = get_the_content();
$has_url = get_url_in_content( $content );
return ( $has_url ) ? $has_url : apply_filters( 'the_permalink', get_permalink() );
}
endif;
if ( ! function_exists( 'et_get_first_video' ) ) :
/**
* Fix the issue with thumbnail video player, not working, when video url is added to content without shortcode.
*/
function et_get_first_video() {
/*
* TODO feat(D5, Refactor): Deprecate the function in the future.
*
* Before deprecating this function, we need to ensure this function is no longer being used in D5 backward
* compatibility mode.
*/
// Ensure PostUtility is loaded before using it.
require_once get_template_directory() . '/includes/builder-5/server/Framework/Utility/PostUtility.php';
return \ET\Builder\Framework\Utility\PostUtility::get_first_video();
}
endif;
if ( ! function_exists( 'et_delete_post_video' ) ) :
/**
* Removes the first video shortcode from content on single pages since it is displayed
* at the top of the page. This will also remove the video shortcode url from archive pages content
*
* @param string $content post content.
*/
function et_delete_post_video( $content ) {
if ( has_post_format( 'video' ) ) :
if ( has_shortcode( $content, 'video' ) ) {
$regex = get_shortcode_regex();
preg_match_all( "/{$regex}/s", $content, $matches );
// $matches[2] holds an array of shortcodes names in the post
foreach ( $matches[2] as $key => $shortcode_match ) {
if ( 'video' === $shortcode_match ) {
$content = str_replace( $matches[0][ $key ], '', $content );
if ( is_single() && is_main_query() ) {
break;
}
}
}
} else {
// Gutenberg compatibility.
preg_match( '//', $content, $gb_video );
if ( ! empty( $gb_video[0] ) ) {
$content = str_replace( $gb_video[0], '', $content );
} else {
// Remove GB embed caption for the first video.
$content = preg_replace( '|
',
esc_html__( 'Using the Divi Role Editor, you can limit the types of actions that can be taken by WordPress users of different roles. This is a great way to limit the functionality available to your customers or guest authors to ensure that they only have the necessary options available to them.', 'et_builder' ),
esc_attr( $role ),
'administrator' === $role ? ' active-container' : '',
$form_sections // #4
);
return $output;
}
/**
* Generates the enable/disable buttons list based on provided capabilities array and role.
*
* @param array $cap_array capabilities.
* @param string $role user role.
*
* @return string
*/
function et_pb_generate_capabilities_output( $cap_array, $role ) {
$output = '';
if ( ! empty( $cap_array ) ) {
$user_has_all_capabilities = true;
$role_obj = get_role( $role );
foreach ( $cap_array as $capability => $capability_details ) {
if ( empty( $capability_details['applicability'] ) || ( ! empty( $capability_details['applicability'] ) && in_array( $role, $capability_details['applicability'], true ) ) ) {
// $capability_details['capabilities'] is an array of capabilities that are required to see this option.
if ( isset( $capability_details['capabilities'] ) ) {
if ( is_string( $capability_details['capabilities'] ) && ! $role_obj->has_cap( $capability_details['capabilities'] ) ) {
$user_has_all_capabilities = false;
} elseif ( is_array( $capability_details['capabilities'] ) ) {
foreach ( $capability_details['capabilities'] as $capability ) {
if ( ! $role_obj->has_cap( $capability ) ) {
$user_has_all_capabilities = false;
break;
}
}
}
if ( ! $user_has_all_capabilities ) {
continue;
}
}
$output .= sprintf(
'
%2$s
',
esc_attr( $capability ),
esc_html( $capability_details['name'] ),
selected( true, et_pb_is_allowed( $capability, $role ), false ),
selected( false, et_pb_is_allowed( $capability, $role ), false ),
esc_html__( 'Yes', 'et_builder' ),
esc_html__( 'No', 'et_builder' )
);
}
}
}
return $output;
}
/**
* Loads scripts and styles for Role Editor Admin page
*
* @param string $hook hook name.
*/
function et_pb_load_roles_admin( $hook ) {
// load scripts only on role editor page.
if ( apply_filters( 'et_pb_load_roles_admin_hook', 'divi_page_et_divi_role_editor' ) !== $hook ) {
return;
}
et_core_load_main_fonts();
wp_enqueue_style( 'builder-roles-editor-styles', ET_BUILDER_URI . '/styles/roles_style.css', array( 'et-core-admin' ), ET_BUILDER_VERSION );
wp_enqueue_script( 'builder-roles-editor-scripts', ET_BUILDER_URI . '/scripts/roles_admin.js', array( 'jquery' ), ET_BUILDER_VERSION, true );
$pb_roles_options = array(
'ajaxurl' => admin_url( 'admin-ajax.php' ),
'et_roles_nonce' => wp_create_nonce( 'et_roles_nonce' ),
'modal_title' => esc_html__( 'Reset Roles', 'et_builder' ),
'modal_message' => esc_html__( 'All of your current role settings will be set to defaults. Do you wish to proceed?', 'et_builder' ),
'modal_yes' => et_builder_i18n( 'Yes' ),
'modal_no' => et_builder_i18n( 'No' ),
);
wp_localize_script( 'builder-roles-editor-scripts', 'et_pb_roles_options', $pb_roles_options );
}
add_action( 'admin_enqueue_scripts', 'et_pb_load_roles_admin' );
/**
* Generates the array of allowed modules in jQuery Array format.
*
* @param string $role the user role.
*
* @return string
*/
function et_pb_allowed_modules_list( $role = '' ) {
global $typenow;
// always return empty array if user doesn't have the edit_posts capability.
if ( ! current_user_can( 'edit_posts' ) ) {
return '[]';
}
$saved_capabilities = et_pb_get_role_settings();
$role = '' === $role ? et_pb_get_current_user_role() : $role;
$all_modules_array = ET_Builder_Element::get_modules_array( $typenow );
$saved_modules_capabilities = isset( $saved_capabilities[ $role ] ) ? $saved_capabilities[ $role ] : array();
$alowed_modules = '[';
foreach ( $all_modules_array as $module => $module_details ) {
if ( ! in_array( $module_details['label'], array( 'et_pb_section', 'et_pb_row', 'et_pb_row_inner', 'et_pb_column' ), true ) ) {
// Add module into the list if it's not saved or if it's saved not with "off" state.
if ( ! isset( $saved_modules_capabilities[ $module_details['label'] ] ) || ( isset( $saved_modules_capabilities[ $module_details['label'] ] ) && 'off' !== $saved_modules_capabilities[ $module_details['label'] ] ) ) {
$alowed_modules .= "'" . esc_attr( $module_details['label'] ) . "',";
}
}
}
$alowed_modules .= ']';
return $alowed_modules;
}
if ( ! function_exists( 'et_divi_get_post_text_color' ) ) {
/**
* Return text color css class.
*
* @return mixed|string
*/
function et_divi_get_post_text_color() {
$text_color_class = '';
$post_format = et_pb_post_format();
if ( in_array( $post_format, array( 'audio', 'link', 'quote' ), true ) ) {
$text_color = get_post_meta( get_the_ID(), '_et_post_bg_layout', true );
$text_color_class = $text_color ? $text_color : 'light';
$text_color_class = ' et_pb_text_color_' . $text_color_class;
}
return $text_color_class;
}
}
if ( ! function_exists( 'et_divi_get_post_bg_inline_style' ) ) {
/**
* Return css style attribute that ho;d background color inline style.
*
* @return string
*/
function et_divi_get_post_bg_inline_style() {
$inline_style = '';
$post_id = get_the_ID();
$post_use_bg_color = get_post_meta( $post_id, '_et_post_use_bg_color', true ) ? true : false;
$bg_color = get_post_meta( $post_id, '_et_post_bg_color', true );
$post_bg_color = $bg_color && '' !== $bg_color ? $bg_color : '#ffffff';
if ( $post_use_bg_color ) {
$inline_style = sprintf( ' style="background-color: %1$s;"', esc_html( $post_bg_color ) );
}
return $inline_style;
}
}
/**
* Remove the blockquote from post content.
*
* @param string $content post content.
*
* @return string|string[]|null
*/
function et_remove_blockquote_from_content( $content ) {
if ( 'quote' !== et_pb_post_format() ) {
return $content;
}
if ( et_theme_builder_overrides_layout( ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ) ) {
// Do not remove quotes when TB has taken over.
return $content;
}
$content = preg_replace( '//is', '', $content, 1 );
return $content;
}
add_filter( 'the_content', 'et_remove_blockquote_from_content' );
/**
* Register rewrite rule and tag for preview page
*
* @return void
*/
function et_pb_register_preview_endpoint() {
add_rewrite_tag( '%et_pb_preview%', 'true' );
}
add_action( 'init', 'et_pb_register_preview_endpoint', 11 );
/**
* Flush rewrite rules to fix the issue "preg_match" issue with 2.5
*
* @return void
*/
function et_pb_maybe_flush_rewrite_rules() {
et_builder_maybe_flush_rewrite_rules( '2_5_flush_rewrite_rules' );
}
add_action( 'init', 'et_pb_maybe_flush_rewrite_rules', 9 );
/**
* Register template for preview page.
*
* @param string $template The path of the template to include.
*
* @return string path to template file
*/
function et_pb_register_preview_page( $template ) {
global $wp_query;
if ( 'true' === $wp_query->get( 'et_pb_preview' ) && isset( $_GET['et_pb_preview_nonce'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
show_admin_bar( false );
return ET_BUILDER_DIR . 'template-preview.php';
}
return $template;
}
add_action( 'template_include', 'et_pb_register_preview_page' );
/**
* Disable all the dynamic assets for preview page so all the styles can be rendered correctly.
*
* @return void
*/
function et_pb_preview_page_disable_dynamic_assets() {
global $wp_query;
if ( 'true' === $wp_query->get( 'et_pb_preview' ) && isset( $_GET['et_pb_preview_nonce'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
// Instruct Shortcode Manager to register/load all modules/shortcodes.
add_filter( 'et_builder_should_load_all_module_data', '__return_true' );
// Disable Feature: D5/Dynamic Assets.
add_filter( 'divi_frontend_assets_dynamic_assets_utils_disable_js_on_demand', '__return_true' );
add_filter( 'divi_frontend_assets_dynamic_assets_utils_use_dynamic_assets', '__return_false' );
add_filter( 'divi_frontend_assets_dynamic_assets_utils_should_generate_dynamic_assets', '__return_false' );
// Disable Feature: D5/Critical CSS.
add_filter( 'divi_frontend_assets_critical_css_should_generate_critical_css', '__return_false' );
// Disable Cache in Feature Manager.
add_filter( 'et_builder_post_feature_cache_enabled', '__return_false' );
}
}
add_action( 'wp', 'et_pb_preview_page_disable_dynamic_assets' );
if ( ! function_exists( 'et_builder_replace_code_content_entities' ) ) :
/**
* The do_shortcode() replaces square brackers with html entities,
* convert them back to make sure js code works ok
*
* @param string $content post content.
*/
function et_builder_replace_code_content_entities( $content ) {
$content = str_replace( '[', '[', $content );
$content = str_replace( ']', ']', $content );
$content = str_replace( '×', 'x', $content );
return $content;
}
endif;
if ( ! function_exists( 'et_builder_convert_line_breaks' ) ) :
/**
* We use placeholders to preserve the line-breaks, convert them back to "\n".
*
* @param string $content content.
* @param string $line_breaks_format line break format e.g \n or .
*/
function et_builder_convert_line_breaks( $content, $line_breaks_format = "\n" ) {
// before we swap out the placeholders,
// remove all the
tags and \n that wpautop added!
$content = preg_replace( '/\n/smi', '', $content );
$content = preg_replace( '/
comment_count ) ? $post->comment_count : $count;
}
return $count;
}
add_filter( 'get_comments_number', 'et_pb_preview_comment_count', 10, 2 );
/**
* List of shortcodes that triggers error if being used in admin
*
* @return array shortcode tag
*/
function et_pb_admin_excluded_shortcodes() {
$shortcodes = array();
// Triggers issue if Sensei and YOAST SEO are activated.
if ( et_is_yoast_seo_plugin_active() && function_exists( 'Sensei' ) ) {
$shortcodes[] = 'usercourses';
}
// WPL real estate prints unwanted on-page JS that caused an issue on BB.
if ( class_exists( 'wpl_extensions' ) ) {
$shortcodes[] = 'WPL';
}
// [submit_job_form] shortcode prints wp_editor this creating problems post edit page render
if ( et_is_wp_job_manager_plugin_active() ) {
$shortcodes[] = 'submit_job_form';
}
// [shop_messages] shortcode causes a fatal error when rendered too soon
if ( et_is_woocommerce_plugin_active() ) {
$shortcodes[] = 'shop_messages';
}
return apply_filters( 'et_pb_admin_excluded_shortcodes', $shortcodes );
}
/**
* Get GMT offset string that can be used for parsing date into correct timestamp
*
* @return string
*/
function et_pb_get_gmt_offset_string() {
$gmt_offset = get_option( 'gmt_offset' );
$gmt_divider = '-' === substr( $gmt_offset, 0, 1 ) ? '-' : '+';
$gmt_offset_hour = str_pad( abs( intval( $gmt_offset ) ), 2, '0', STR_PAD_LEFT );
$gmt_offset_minute = str_pad( ( ( abs( $gmt_offset ) * 100 ) % 100 ) * ( 60 / 100 ), 2, '0', STR_PAD_LEFT );
$gmt_offset_string = "GMT{$gmt_divider}{$gmt_offset_hour}{$gmt_offset_minute}";
return $gmt_offset_string;
}
/**
* Get post's category label and permalink to be used on frontend
*
* @param int $post_id post id.
* @param WP_Term[] $default term objects.
*
* @return array categories
*/
function et_pb_get_post_categories( $post_id, $default = array() ) {
$categories = get_the_category( $post_id );
$post_categories = array();
if ( $default && ! $categories ) {
$categories = array_values( $default );
foreach ( array_keys( $categories ) as $key ) {
_make_cat_compat( $categories[ $key ] );
}
}
// Filter out any falsy values that may appear due from $default.
$categories = array_filter( $categories );
if ( ! empty( $categories ) ) {
foreach ( $categories as $category ) {
$post_categories[ $category->cat_ID ] = array(
'id' => $category->cat_ID,
'label' => $category->cat_name,
'permalink' => get_category_link( $category->cat_ID ),
);
}
}
return $post_categories;
}
/**
* Generates "Use Visual Builder" button url
*
* @return string
*/
function et_fb_get_page_url() {
global $wp;
$post_id = get_the_ID();
$is_divi_library = 'et_pb_layout' === get_post_type( $post_id );
if ( $is_divi_library ) {
return get_edit_post_link( $post_id );
} elseif ( is_singular() ) {
return get_permalink( $post_id );
}
return add_query_arg( $wp->query_string, '', home_url( $wp->request ) );
}
/**
* Add "Use Visual Builder" link to WP-Admin bar
*
* @return void
*/
function et_fb_add_admin_bar_link() {
$is_not_builder_enabled_single = ! is_singular() || ! et_builder_fb_enabled_for_post( get_the_ID() );
$is_not_in_wc_shop = ! et_builder_used_in_wc_shop();
$not_allowed_fb_access = ! et_pb_is_allowed( 'use_visual_builder' );
$app_preferences = et_fb_app_preferences_settings();
$default_visual_theme_builder = et_()->array_get( $app_preferences, 'enable_visual_theme_builder.default' );
$is_visual_theme_builder_enabled = et_get_option( 'et_fb_pref_builder_enable_visual_theme_builder', $default_visual_theme_builder );
$is_not_theme_builder_used = is_admin() || ! et_fb_is_theme_builder_used_on_page() || ! et_pb_is_allowed( 'theme_builder' ) || ! filter_var( $is_visual_theme_builder_enabled, FILTER_VALIDATE_BOOLEAN );
$is_enabled_for_post_type = ! is_singular() || et_builder_enabled_for_post_type( get_post_type( get_the_ID() ) );
// Return if builder is not allowed for the user.
if ( $not_allowed_fb_access ) {
return;
}
// Return if builder is not enabled for the post type.
if ( ! $is_enabled_for_post_type && $is_not_builder_enabled_single ) {
return;
}
// Return for non-singular pages if they are not WC shop page and Theme Builder is not used.
if ( $is_not_builder_enabled_single && $is_not_in_wc_shop && $is_not_theme_builder_used ) {
return;
}
global $wp_admin_bar, $wp_the_query;
$post_id = get_the_ID();
// WooCommerce Shop Page replaces main query, thus it has to be normalized.
if ( et_builder_used_in_wc_shop() && method_exists( $wp_the_query, 'get_queried_object' ) && isset( $wp_the_query->get_queried_object()->ID ) ) {
$post_id = $wp_the_query->get_queried_object()->ID;
}
$page_url = et_fb_get_page_url();
// Don't add the link, if Frontend Builder has been loaded already.
if ( et_fb_is_enabled() || et_fb_is_enabled_on_any_template() ) {
if ( function_exists( 'et_builder_d5_enabled' ) && et_builder_d5_enabled() ) {
return;
}
$wp_admin_bar->add_menu(
array(
'id' => 'et-disable-visual-builder',
'title' => esc_html__( 'Exit Visual Builder', 'et_builder' ),
'href' => esc_url( $page_url ),
)
);
return;
}
$current_object = $wp_the_query->get_queried_object();
$user_is_allowed_to_edit = isset( $current_object->ID ) ? current_user_can( 'edit_post', $current_object->ID ) : ( et_fb_is_theme_builder_used_on_page() && et_pb_is_allowed( 'theme_builder' ) );
if ( is_admin() || ! $user_is_allowed_to_edit || ! et_pb_is_allowed( 'divi_builder_control' ) ) {
return;
}
$use_visual_builder_url = et_pb_is_pagebuilder_used( $post_id ) || ( et_fb_is_theme_builder_used_on_page() && ! is_singular() ) ?
et_fb_get_builder_url( $page_url ) :
add_query_arg(
array(
'et_fb_activation_nonce' => wp_create_nonce( 'et_fb_activation_nonce_' . $post_id ),
),
$page_url
);
$wp_admin_bar->add_menu(
array(
'id' => 'et-use-visual-builder',
'title' => esc_html__( 'Edit With Divi', 'et_builder' ),
'href' => esc_url( $use_visual_builder_url ),
)
);
}
add_action( 'admin_bar_menu', 'et_fb_add_admin_bar_link', 999 );
/**
* Retrieve and process saved Layouts.
* It different than the function which retrieves saved Sections, Rows and Modules from library because layouts require different processing
*/
function et_fb_get_saved_layouts() {
if ( ! isset( $_POST['et_fb_retrieve_library_modules_nonce'] ) || ! wp_verify_nonce( $_POST['et_fb_retrieve_library_modules_nonce'], 'et_fb_retrieve_library_modules_nonce' ) ) { // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The nonce value is used only for comparision in the `wp_verify_nonce`.
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
// Reduce number of results per page if we're hosted on wpengine to avoid 500 error due to memory allocation.
// This is caused by one of their custom mu-plugins doing additional stuff but we have no control over there.
$page_size = function_exists( 'is_wpe' ) || function_exists( 'is_wpe_snapshot' ) ? 25 : 50;
$post_type = ! empty( $_POST['et_post_type'] ) ? sanitize_text_field( $_POST['et_post_type'] ) : 'post';
$layouts_type = ! empty( $_POST['et_load_layouts_type'] ) ? sanitize_text_field( $_POST['et_load_layouts_type'] ) : 'all';
$start_from = ! empty( $_POST['et_templates_start_page'] ) ? sanitize_text_field( $_POST['et_templates_start_page'] ) : 0;
$post_type = apply_filters( 'et_pb_show_all_layouts_built_for_post_type', $post_type, $layouts_type );
$all_layouts_data = et_pb_retrieve_templates( 'layout', '', 'false', '0', $post_type, $layouts_type, array( $start_from, $page_size ) );
$all_layouts_data_processed = $all_layouts_data;
$next_page = 'none';
if ( 0 !== $start_from && empty( $all_layouts_data ) ) {
$all_layouts_data_processed = array();
} else {
if ( empty( $all_layouts_data ) ) {
$all_layouts_data_processed = array( 'error' => esc_html__( 'You have not saved any items to your Divi Library yet. Once an item has been saved to your library, it will appear here for easy use.', 'et_builder' ) );
} else {
foreach ( $all_layouts_data as $index => $data ) {
$all_layouts_data_processed[ $index ]['shortcode'] = et_fb_process_shortcode( $data['shortcode'] );
}
$next_page = $start_from + $page_size;
}
}
$json_templates = wp_json_encode(
array(
'templates_data' => $all_layouts_data_processed,
'next_page' => $next_page,
)
);
die( et_core_intentionally_unescaped( $json_templates, 'html' ) );
}
add_action( 'wp_ajax_et_fb_get_saved_layouts', 'et_fb_get_saved_layouts' );
/**
* Ajax Callback: Process imported content.
*/
function et_fb_process_imported_content() {
if ( ! isset( $_POST['et_fb_process_imported_data_nonce'] ) || ! wp_verify_nonce( $_POST['et_fb_process_imported_data_nonce'], 'et_fb_process_imported_data_nonce' ) ) { // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The nonce value is used only for comparision in the `wp_verify_nonce`.
die( -1 );
}
if ( ! current_user_can( 'edit_posts' ) ) {
die( -1 );
}
// phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- Value in `$_POST['et_raw_shortcode']` is processed by `et_fb_process_shortcode` and being returned in ajax response.
$processed_shortcode = isset( $_POST['et_raw_shortcode'] ) ? et_fb_process_shortcode( stripslashes( $_POST['et_raw_shortcode'] ) ) : '';
die( wp_json_encode( $processed_shortcode ) );
}
add_action( 'wp_ajax_et_fb_process_imported_content', 'et_fb_process_imported_content' );
/**
* Builder initial content.
*
* @param string $content post content.
* @param integer $post_id post id.
*
* @return string
*/
function et_fb_maybe_get_bfb_initial_content( $content, $post_id ) {
$from_post = isset( $_GET['from_post'] ) ? sanitize_text_field( $_GET['from_post'] ) : ''; // phpcs:ignore WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
if ( ! empty( $from_post ) && 'empty' !== $from_post ) {
$copy_content_from = get_post( $from_post );
$existing_content = $copy_content_from->post_content;
if ( '' !== $existing_content && has_shortcode( $existing_content, 'et_pb_section' ) ) {
return $existing_content;
}
}
// process the content only for BFB.
if ( ! et_builder_bfb_enabled() ) {
return $content;
}
// If content already has a section, it means builder is active and activation has to be
// skipped to avoid nested and unwanted builder structure.
if ( has_shortcode( $content, 'et_pb_section' ) ) {
return $content;
}
// Save old content.
$saved_old_content = get_post_meta( $post_id, '_et_pb_old_content', true );
$save_old_content = false;
$post = get_post( $post_id );
if ( '' !== $content ) {
$save_old_content = update_post_meta( $post_id, '_et_pb_old_content', $content );
}
/**
* Filters the flag that sets default Content during Builder activation.
*
* @since 3.29
*
* @used-by et_builder_wc_init()
*/
if ( apply_filters( 'et_builder_skip_content_activation', false, $post ) ) {
return $content;
}
if ( true !== $save_old_content && $saved_old_content !== $content && '' !== $content ) {
return $content;
}
$text_module = '' !== $content ? '' : '';
// Re-format content.
$updated_content =
'
' . $text_module . '
';
return $updated_content;
}
/**
* Called via async AJAX call after the builder rendered. It will regenerate both helper/definitions files.
* If their content changed, the builder will trigger a page reload to use the updated cached files.
*/
function et_fb_update_builder_assets() {
if ( ! isset( $_POST['et_fb_helper_nonce'] ) || ! wp_verify_nonce( $_POST['et_fb_helper_nonce'], 'et_fb_update_helper_assets_nonce' ) ) { // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The nonce value is used only for comparision in the `wp_verify_nonce`.
die( -1 );
}
$post_id = ! empty( $_POST['et_post_id'] ) ? sanitize_text_field( $_POST['et_post_id'] ) : '';
if ( ! current_user_can( 'edit_post', $post_id ) ) {
die( -1 );
}
// Set current post as global $post.
$post = get_post( $post_id ); // phpcs:ignore WordPress.Variables.GlobalVariables.OverrideProhibited
$post_type = ! empty( $_POST['et_post_type'] ) ? sanitize_text_field( $_POST['et_post_type'] ) : 'post';
// Update helpers cached js file.
$helpers = et_fb_get_dynamic_asset( 'helpers', $post_type, true );
// Update definitions cached js file.
$definitions = et_fb_get_dynamic_asset( 'definitions', $post_type, true );
// When either definitions or helpers needs an update, also clear modules cache.
if ( $definitions['updated'] || $helpers['updated'] ) {
$modules_cache = ET_Builder_Element::get_cache_filename( $post_type );
if ( file_exists( $modules_cache ) ) {
@unlink( $modules_cache ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- `unlink` may fail with the permissions denied error.
}
}
die(
wp_json_encode(
array(
'helpers' => $helpers,
'definitions' => $definitions,
)
)
);
}
add_action( 'wp_ajax_et_fb_update_builder_assets', 'et_fb_update_builder_assets' );
/**
* Returns builder definitions.
*
* @deprecated This function is no longer used. see
*
* @param string $post_type post type.
*
* @return array
*/
function et_fb_get_builder_definitions( $post_type ) {
// This is a legacy function that needs the shortcode framework to be loaded.
et_load_shortcode_framework();
// force render builder data when retrieving builder definition to ensure definitions retrieved via ajax call
// equal to definitions retrieved on wp_footer when no dynamic asset cache found.
add_filter( 'et_builder_module_force_render', '__return_true' );
$fields_data = array();
$fields_data['custom_css'] = ET_Builder_Element::get_custom_css_fields( $post_type );
$fields_data['advanced_fields'] = ET_Builder_Element::get_advanced_fields( $post_type );
$fields_data['general_fields'] = ET_Builder_Element::get_general_fields( $post_type );
$fields_data['childModuleTitles'] = ET_Builder_Element::get_child_module_titles( $post_type );
$fields_data['optionsToggles'] = ET_Builder_Element::get_toggles( $post_type );
$fields_data['customTabs'] = ET_Builder_Element::get_tabs( $post_type );
$fields_data['customTabsFields'] = ET_Builder_Element::get_settings_modal_tabs_fields( $post_type );
$fields_data['customLayoutsTabs'] = ET_Builder_Library::builder_library_modal_custom_tabs( $post_type );
$fields_data['moduleItemsConfig'] = ET_Builder_Element::get_module_items_configs( $post_type );
$fields_data['moduleTransitions'] = ET_Builder_Element::get_modules_transitions( $post_type );
$fields_data['contact_form_input_defaults'] = et_fb_process_shortcode(
sprintf(
'[et_pb_contact_field field_title="%1$s" field_type="input" field_id="Name" required_mark="on" fullwidth_field="off" /][et_pb_contact_field field_title="%2$s" field_type="email" field_id="Email" required_mark="on" fullwidth_field="off" /][et_pb_contact_field field_title="%3$s" field_type="text" field_id="Message" required_mark="on" fullwidth_field="on" /]',
esc_attr__( 'Name', 'et_builder' ),
esc_attr__( 'Email Address', 'et_builder' ),
esc_attr__( 'Message', 'et_builder' )
)
);
// Remove duplicates from field definitions.
$map = array();
$unique_fields = array();
$unique_count = 0;
foreach ( array( 'custom_css', 'general_fields', 'advanced_fields' ) as $source ) {
$definitions = &$fields_data[ $source ];
$module_names = array_keys( $definitions );
foreach ( $module_names as $module_name ) {
$module = &$definitions[ $module_name ];
$setting_names = array_keys( $module );
foreach ( $setting_names as $setting_name ) {
$setting = &$module[ $setting_name ];
if ( 'advanced_defaults' === $setting_name ) {
// advanced_defaults are just duplicated data, we can rebuilt them later.
$setting = false;
continue;
}
$key = wp_json_encode( $setting );
if ( ! isset( $map[ $key ] ) ) {
// Found a duplicate here.
$unique_fields[] = $setting;
$map[ $key ] = $unique_count++;
}
$setting = $map[ $key ];
}
}
}
// Remove force builder data render.
remove_filter( 'et_builder_module_force_render', '__return_true' );
// No longer needed.
unset( $map );
// Include the unique fields in the AJAX payload.
$fields_data['unique_fields'] = $unique_fields;
return $fields_data;
}
/**
* Returns builder shortcode object.
*
* @param string $post_type the post type.
* @param integer $post_id the post id.
* @param string $layout_type layout type.
*
* @return array
*/
function et_fb_get_builder_shortcode_object( $post_type, $post_id, $layout_type ) {
// We need to store the current post when this function is executed in a wp-admin page
// to prevent post based modules included in the shortcode from altering the loop.
global $post;
$backup = $post;
$fields_data = array();
add_filter( 'et_builder_module_force_render', '__return_true' );
$post_data = get_post( $post_id );
$post_data_post_modified = is_object( $post_data ) ? gmdate( 'U', strtotime( $post_data->post_modified ) ) : 0;
$post_content = is_object( $post_data ) ? $post_data->post_content : '';
$is_theme_builder = et_builder_tb_enabled();
$is_backend_builder = et_builder_bfb_enabled();
$theme_builder_layouts = et_theme_builder_get_template_layouts();
// Unset main template from Theme Builder layouts to avoid PHP Notices.
if ( isset( $theme_builder_layouts['et_template'] ) ) {
unset( $theme_builder_layouts['et_template'] );
}
// Get the content for all theme builder posts.
foreach ( $theme_builder_layouts as $key => $theme_builder_layout ) {
if ( 0 !== $theme_builder_layout['id'] && $theme_builder_layout['enabled'] && $theme_builder_layout['override'] ) {
$post_data = get_post( $theme_builder_layout['id'] );
$theme_builder_layouts[ $key ]['post_content'] = $post_data->post_content;
}
}
// if autosave exists here, return it with the real content, autosave.js and getServerSavedPostData() will look for it.
$current_user_id = get_current_user_id();
// Store one autosave per author. If there is already an autosave, overwrite it.
$autosave = wp_get_post_autosave( $post_id, $current_user_id );
if ( ! empty( $autosave ) ) {
$autosave_post_modified = gmdate( 'U', strtotime( $autosave->post_modified ) );
if ( $autosave_post_modified > $post_data_post_modified ) {
$fields_data['autosave_shortcode_object'] = et_fb_process_shortcode( $autosave->post_content );
$fields_data['has_newer_autosave'] = true;
} else {
$fields_data['has_newer_autosave'] = false;
}
// Delete the autosave, becuase we will present the option to use the autosave to the user, and they will use it or not
// we need to delete the db copy now.
wp_delete_post_revision( $autosave->ID );
}
switch ( $layout_type ) {
case 'module':
$use_fullwidth_section = false !== strpos( $post_content, '[et_pb_fullwidth_' ) ? true : false;
// Remove module placeholders.
$post_content = false !== strpos( $post_content, 'et_pb_fullwidth_module_placeholder' ) || false !== strpos( $post_content, 'et_pb_module_placeholder' ) ? '' : $post_content;
if ( ! $use_fullwidth_section ) {
$post_content = sprintf( '[et_pb_row][et_pb_column type="4_4"]%1$s[/et_pb_column][/et_pb_row]', $post_content );
}
$post_content = sprintf(
'[et_pb_section%2$s]%1$s[/et_pb_section]',
$post_content,
$use_fullwidth_section ? ' fullwidth="on"' : ''
);
break;
case 'row':
$post_content = '[et_pb_section]' . $post_content . '[/et_pb_section]';
break;
}
$post_content = et_fb_maybe_get_bfb_initial_content( $post_content, $post_id );
/**
* Filters the raw post content when the Builder is loaded.
*
* @since 3.29
*
* @param string $post_content The raw/unprocessed post content.
* @param int $post_id Post ID.
*/
$post_content = apply_filters( 'et_fb_load_raw_post_content', $post_content, $post_id );
$fields_data['shortcode_object'] = array();
// Process main post content fields data.
$post_fields_data = et_fb_process_shortcode( $post_content );
$fields_data['shortcode_object'] = array();
// In Visual Builder get All Theme Builder Areas.
if ( et_pb_is_allowed( 'theme_builder' ) && ! $is_theme_builder && ! $is_backend_builder && ! empty( $theme_builder_layouts ) ) {
// Process Theme Builder Header area fields data.
if ( isset( $theme_builder_layouts['et_header_layout']['post_content'] ) ) {
$theme_builder_header = apply_filters( 'et_fb_load_raw_post_content', $theme_builder_layouts['et_header_layout']['post_content'], $theme_builder_layouts['et_header_layout']['id'] );
$tb_header_fields_data = et_fb_process_shortcode( $theme_builder_header, '', '', '', '', 'et_header_layout' );
$processed_fields_data[] = $tb_header_fields_data;
}
// Process Theme Builder Body area.
if ( isset( $theme_builder_layouts['et_body_layout']['post_content'] ) ) {
$theme_builder_body = apply_filters( 'et_fb_load_raw_post_content', $theme_builder_layouts['et_body_layout']['post_content'], $theme_builder_layouts['et_body_layout']['id'] );
$tb_body_fields_data = et_fb_process_shortcode( $theme_builder_body, '', '', '', '', 'et_body_layout' );
$theme_builder_post_content_selector = et_fb_generate_post_content_module_selector( $tb_body_fields_data, 'theme_builder_content' );
if ( $theme_builder_post_content_selector && ! is_home() && ! is_archive() && ! is_404() ) {
// If Theme Builder Body contains Post Content Module, replace it with real post content.
$post_content_fields_data = et_fb_process_shortcode( $post_content, '', '', '', '', 'post_content' );
$processed_fields_data[] = et_fb_generate_tb_body_area_with_post_content( $tb_body_fields_data, $theme_builder_post_content_selector, $post_content_fields_data );
} else {
// if not, just add Theme Builder Body area content.
$processed_fields_data[] = $tb_body_fields_data;
// Add Post content too, so it can be loaded when post content module is added.
if ( ! is_home() && ! is_archive() && ! is_404() ) {
$initial_post_content_fields_data = et_fb_process_shortcode( $post_content, '', '', '', '', 'initial_post_content' );
$processed_fields_data[] = $initial_post_content_fields_data;
}
}
} elseif ( ! is_home() && et_pb_is_pagebuilder_used( $post_id ) ) {
// If there is no Theme Builder Body, load post content.
$processed_fields_data[] = $post_fields_data;
}
// Process Theme Builder Header area fields data.
if ( isset( $theme_builder_layouts['et_footer_layout']['post_content'] ) ) {
$theme_builder_footer = apply_filters( 'et_fb_load_raw_post_content', $theme_builder_layouts['et_footer_layout']['post_content'], $theme_builder_layouts['et_footer_layout']['id'] );
$tb_footer_fields_data = et_fb_process_shortcode( $theme_builder_footer, '', '', '', '', 'et_footer_layout' );
$processed_fields_data[] = $tb_footer_fields_data;
}
// Build the shortcode_object from Theme Builder Areas.
foreach ( $processed_fields_data as $processed_field_data ) {
if ( is_array( $processed_field_data ) ) {
$fields_data['shortcode_object'] = array_merge( $fields_data['shortcode_object'], $processed_field_data );
}
}
} else {
// In Theme Builder and Backend Builder show only main post.
$fields_data['shortcode_object'] = $post_fields_data;
}
remove_filter( 'et_builder_module_force_render', '__return_true' );
// Restore post.
$post = $backup; // phpcs:ignore WordPress.WP.GlobalVariablesOverride -- This is legit way of setting global $post.
setup_postdata( $post );
return $fields_data;
}
/**
* This function searches the multidimensional array of post content fields for post content module
* and generates array of keys that are used to select post content module.
*
* @param array $array Array of post fields data.
* @param string $element_type Type of an element that is analyzes at the moment.
*
* @return array
*/
function et_fb_generate_post_content_module_selector( array $array, $element_type ) {
global $current_section;
global $current_row;
global $current_row_inner;
global $current_column;
global $current_column_inner;
global $current_module;
global $post_content_module_selector;
if ( 'theme_builder_content' === $element_type ) {
// Loop through Theme Builder Area sections.
foreach ( $array as $key => $value ) {
if ( isset( $array[ $key ]['content'] ) && is_array( $array[ $key ]['content'] ) ) {
$current_section = $key;
et_fb_generate_post_content_module_selector( $array[ $key ]['content'], $array[ $key ]['type'] );
}
}
} elseif ( 'et_pb_section' === $element_type ) {
// Loop through rows.
foreach ( $array as $key => $value ) {
if ( 'et_pb_fullwidth_post_content' === $array[ $key ]['type'] ) {
et_fb_generate_post_content_module_selector( $array, 'et_pb_column' );
} elseif ( isset( $array[ $key ]['content'] ) && is_array( $array[ $key ]['content'] ) ) {
$current_row = $key;
et_fb_generate_post_content_module_selector( $array[ $key ]['content'], $array[ $key ]['type'] );
}
}
} elseif ( 'et_pb_row' === $element_type ) {
// Loop through columns.
foreach ( $array as $key => $value ) {
if ( isset( $array[ $key ]['content'] ) && is_array( $array[ $key ]['content'] ) ) {
$current_column = $key;
et_fb_generate_post_content_module_selector( $array[ $key ]['content'], $array[ $key ]['type'] );
}
}
} elseif ( 'et_pb_row_inner' === $element_type ) {
// Loop through columns.
foreach ( $array as $key => $value ) {
if ( isset( $array[ $key ]['content'] ) && is_array( $array[ $key ]['content'] ) ) {
$current_column_inner = $key;
et_fb_generate_post_content_module_selector( $array[ $key ]['content'], $array[ $key ]['type'] );
}
}
} elseif ( 'et_pb_column' === $element_type || 'et_pb_column_inner' === $element_type ) {
// Loop through modules.
foreach ( $array as $key => $value ) {
if ( 'et_pb_row_inner' === $array[ $key ]['type'] ) {
foreach ( $array as $key => $value ) {
if ( isset( $array[ $key ]['content'] ) && is_array( $array[ $key ]['content'] ) ) {
$current_row_inner = $key;
et_fb_generate_post_content_module_selector( $array[ $key ]['content'], $array[ $key ]['type'] );
}
}
} elseif ( 'et_pb_post_content' === $array[ $key ]['type'] ) {
// If Post Content Module is Found build the selector from current Section, Row, and Column.
$current_module = $key;
$is_column_inner = 'et_pb_column_inner' === $array[ $key ]['parent_slug'];
$post_content_module_selector = $is_column_inner ? array(
'section' => $current_section,
'row_inner' => $current_row_inner,
'column' => $current_row,
'column_inner' => $current_column_inner,
'module' => $current_module,
) : array(
'section' => $current_section,
'row' => $current_row,
'column' => $current_column,
'module' => $current_module,
);
} elseif ( 'et_pb_fullwidth_post_content' === $array[ $key ]['type'] ) {
// If Post Content Module is FullWidth create selector with section and module id.
$current_module = $key;
$post_content_module_selector = array(
'section' => $current_section,
'module' => $current_module,
);
}
}
}
return $post_content_module_selector;
}
/**
* This function is used to generate the Theme Builder Body area that has Post
* Content module inside. It replaces Post Content module with sections of a
* post that is being currently edited.
*
* @param array $theme_builder_body_fields Theme Builder Body area fields data.
* @param array $selector Array of keys for selecting Post Content Module.
* @param array $post_content_fields Post Content fields data that should
* replace the Post Content Module.
*
* @return array
*/
function et_fb_generate_tb_body_area_with_post_content( $theme_builder_body_fields, $selector, $post_content_fields ) {
if ( ! isset( $selector['row'] ) && ! isset( $selector['column'] ) ) {
$original_post_content_module = $theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['module'] ];
$theme_builder_body_fields[ $selector['section'] ]['attrs']['post_content_module_attrs'] = $original_post_content_module['attrs'];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['module'] ]['content'] = $post_content_fields;
} elseif ( null === $selector['column'] ) {
$original_post_content_module = $theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['content'][ $selector['module'] ];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['attrs']['post_content_module_attrs'] = $original_post_content_module['attrs'];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['content'][ $selector['module'] ]['content'] = $post_content_fields;
} elseif ( isset( $selector['row_inner'] ) ) {
$original_post_content_module = $theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['column'] ]['content'][ $selector['row_inner'] ]['content'][ $selector['column_inner'] ]['content'][ $selector['module'] ];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['column'] ]['content'][ $selector['row_inner'] ]['content'][ $selector['column_inner'] ]['attrs']['post_content_module_attrs'] = $original_post_content_module['attrs'];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['column'] ]['content'][ $selector['row_inner'] ]['content'][ $selector['column_inner'] ]['content'][ $selector['module'] ]['content'] = $post_content_fields;
} else {
$original_post_content_module = $theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['content'][ $selector['column'] ]['content'][ $selector['module'] ];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['content'][ $selector['column'] ]['attrs']['post_content_module_attrs'] = $original_post_content_module['attrs'];
$theme_builder_body_fields[ $selector['section'] ]['content'][ $selector['row'] ]['content'][ $selector['column'] ]['content'][ $selector['module'] ]['content'] = $post_content_fields;
}
return $theme_builder_body_fields;
}
/**
* Ajax Callback: Retrieve builder data on frontend app load.
*/
function et_fb_retrieve_builder_data() {
if ( ! isset( $_POST['et_fb_helper_nonce'] ) || ! wp_verify_nonce( $_POST['et_fb_helper_nonce'], 'et_fb_load_helper_assets_nonce' ) ) { // phpcs:ignore ET.Sniffs.ValidatedSanitizedInput -- The nonce value is used only for comparision in the `wp_verify_nonce`.
die( -1 );
}
$post_id = ! empty( $_POST['et_post_id'] ) ? sanitize_text_field( $_POST['et_post_id'] ) : '';
if ( ! current_user_can( 'edit_posts' ) || ! current_user_can( 'edit_post', $post_id ) ) {
die( -1 );
}
$post_type = ! empty( $_POST['et_post_type'] ) ? sanitize_text_field( $_POST['et_post_type'] ) : 'post';
$layout_type = ! empty( $_POST['et_layout_type'] ) ? sanitize_text_field( $_POST['et_layout_type'] ) : '';
$fields_data = array_merge(
et_fb_get_builder_definitions( $post_type ),
et_fb_get_builder_shortcode_object( $post_type, $post_id, $layout_type )
);
// Enable zlib compression.
et_builder_enable_zlib_compression();
die( wp_json_encode( $fields_data ) );
}
add_action( 'wp_ajax_et_fb_retrieve_builder_data', 'et_fb_retrieve_builder_data' );
/**
* Replaces site_url in a json string with its protocol-less version.
*
* @param string $json The json string that contain site url.
*
* @return string
*/
function et_fb_remove_site_url_protocol( $json ) {
$no_proto = str_replace( '/', '\/', preg_replace( '#^\w+:#', '', get_site_url() ) );
$from = array(
"https:$no_proto" => $no_proto,
"http:$no_proto" => $no_proto,
);
return strtr( $json, $from );
}
/**
* Used to update the content of the cached definitions js file.
*
* @deprecated This is no longer used in Divi 5.0 and will be removed in a future release.
*
* @param string $content content? @todo Add param description.
* @param string $post_type Post type? @todo Add param description.
*
* @return string
*/
function et_fb_get_asset_definitions( $content, $post_type ) {
$definitions = et_fb_get_builder_definitions( $post_type );
return sprintf(
'window.ETBuilderBackend=jQuery.extend(true,%s,window.ETBuilderBackend)',
et_fb_remove_site_url_protocol( wp_json_encode( $definitions, ET_BUILDER_JSON_ENCODE_OPTIONS ) )
);
}
// This is deprecated and no longer used in Divi 5.0 and will be removed in a future release.
// add_filter( 'et_fb_get_asset_definitions', 'et_fb_get_asset_definitions', 10, 2 );
/**
* Return Divi options setting page link.
*
* @return mixed|string|void
*/
function et_pb_get_options_page_link() {
// Builder plugin has different path to options page.
if ( et_is_builder_plugin_active() ) {
return admin_url( 'admin.php?page=et_divi_options#tab_et_dashboard_tab_content_api_main' );
}
return apply_filters( 'et_pb_theme_options_link', admin_url( 'admin.php?page=et_divi_options' ) );
}
/**
* Localization: Product tour text.
*
* @param integer $post_id The post id to determine the Save/Publish button text from post status.
*
* @return array
*/
function et_fb_get_product_tour_text( $post_id ) {
$post_status = get_post_status( $post_id );
$product_tour_text = array(
'start' => array(
'title' => esc_html__( 'Welcome To The Divi Builder', 'et_builder' ),
'description' => sprintf(
// translators: %10$s: Tour video overlay, %1$s: "Section" - label, %2$s: Add icon markup, %3$s: "Row" - label, %4$s: Add icon markup, %5$s: "Modules" - label, %6$s: Add icon markup, %7$s: Settings gear icon markup, %9$s: Documentation link markup.
__( '%10$sBuilding beautiful pages is a breeze using the Visual Builder. To get started, add a new %1$s to your page by pressing the %2$s button. Next, add a %3$s of columns inside your section by pressing the %4$s button. Finally, start adding some content %5$s inside your columns by pressing the %6$s button. You can customize the design and content of any element on the page by pressing the %7$s button. If you ever need help, visit our %9$s page for a full list of tutorials.', 'et_builder' ),
sprintf( '%1$s', esc_html__( 'Section' ) ),
'',
sprintf( '%1$s', esc_html__( 'Row' ) ),
'',
sprintf( '%1$s', esc_html__( 'Modules' ) ),
'',
'',
'?',
sprintf( '%1$s', esc_html__( 'Documentation' ) ),
sprintf(
'
',
esc_url( ET_BUILDER_URI . '/frontend-builder/assets/img/product-tour-intro.jpg' )
)
),
'endButtonText' => esc_html__( 'Start Building', 'et_builder' ),
'skipButtonText' => esc_html__( 'Take the Tour', 'et_builder' ),
),
'loadLayout' => array(
'title' => esc_html__( 'Load A New Layout', 'et_builder' ),
'description' => esc_html__( 'Loading pre-made layouts is a great way to jump-start your new page. The Divi Builder comes with dozens of layouts to choose from, and you can find lots of great free layouts online too. You can save your favorite layouts to the Divi Library and load them on new pages or share them with the community. Click the highlighted button to open the layouts menu and select a pre-made layout.', 'et_builder' ),
),
'selectLayoutPack' => array(
'title' => esc_html__( 'Choose A Layout Pack', 'et_builder' ),
'description' => esc_html__( 'Here you can see a list of pre-made layout packs that ship with the Divi Builder. You can also access layouts that you have saved to your Divi Library. Choose the “Divi Builder Demo” layout pack to see the layouts it includes.', 'et_builder' ),
),
'loadLayoutItem' => array(
'title' => esc_html__( 'Choose A Layout To Start With', 'et_builder' ),
'description' => esc_html__( 'Now you can see more details about the layout pack as well as a list of the layouts it includes. Click “Use Layout” to apply the layout to your page.', 'et_builder' ),
),
'addSection' => array(
'title' => esc_html__( 'Add A New Section', 'et_builder' ),
'description' => sprintf(
// translators: %1$s: "Sections" - label, %2$s: "Rows" - label.
__( 'Now that your pre-made layout has been loaded, we can start adding new content to the page. The Divi Builder organizes content using %1$s, %2$s and Modules. Sections are the largest organizational element. Click the highlighted button to add a new section to the page.', 'et_builder' ),
sprintf( '%1$s', esc_html__( 'Sections' ) ),
sprintf( '%1$s', esc_html__( 'Rows' ) )
),
),
'selectSectionType' => array(
'title' => esc_html__( 'Choose A Section Type', 'et_builder' ),
'description' => sprintf(
// translators: %1$s: "Regular" - label text, %2$s: "Specialty" - label tex, %3$s: "Fullwidth" - label tex.
__( 'The Divi Builder has three different section types. %1$s sections conform to the standard width of your page layout. %2$s Sections can be used to create advanced sidebar layouts. %3$s sections extend the full width of your page and can be used with fullwidth modules. Click the “Regular” section button to add a new section to your page.', 'et_builder' ),
sprintf( '%1$s', esc_html__( 'Regular' ) ),
sprintf( '%1$s', esc_html__( 'Specialty' ) ),
sprintf( '%1$s', esc_html__( 'Fullwidth' ) )
),
),
'selectRow' => array(
'title' => esc_html__( 'Add A New Row Of Columns', 'et_builder' ),
'description' => sprintf(
// translators: %1$s: "Rows" - label.
__( 'Every section contains one or more %1$s of columns. You can choose between various column layouts for each row you add to your page. Click the highlighted three-column layout to add a new row to your section.', 'et_builder' ),
sprintf( '%1$s', esc_html__( 'Rows' ) )
),
),
'selectModule' => array(
'title' => esc_html__( 'Add A Module To The Column', 'et_builder' ),
'description' => esc_html__( 'Within each column you can add one or more Modules. A module is basic content element. The Divi Builder comes with over 40 different content elements to choose from, such as Images, Videos, Text, and Buttons. Click the highlighted Blurb button to add a new Blurb module to the first column in your row.', 'et_builder' ),
),
'configureModule' => array(
'title' => esc_html__( 'Adjust Your Module Settings', 'et_builder' ),
'description' => esc_html__( 'Each Module comes with various settings. These settings are separated into three tabs: Content, Design and Advanced. Inside the content tab you can modify the module content elements, such as text and images. If you need more control over the appearance of your module, head over to the Design tab. For more advanced modifications, such as custom CSS and HTML attributes, explore the Advanced tab. Try adjusting the Title of your blurb by clicking into the highlighted field.', 'et_builder' ),
),
'saveModule' => array(
'title' => esc_html__( 'Accept Or Discard Your Changes', 'et_builder' ),
'description' => esc_html__( 'Whenever you make changes in the Divi Builder, these changes can be Undone, Redone, Discarded or Accepted. Now that you have adjusted your module’s title, you can click the red discard button to cancel these changes, or your can click the green button to accept them.', 'et_builder' ),
),
'duplicateModule' => array(
'title' => esc_html__( 'Hover To Access Action Buttons', 'et_builder' ),
'description' => esc_html__( 'Whenever you hover over a Section, Row or Module in the Divi Builder, action buttons will appear. These buttons can be used to move, modify, duplicate or delete your content. Click the highlighted “duplicate” icon to duplicate the blurb module that you just added to the page.', 'et_builder' ),
),
'moveModule' => array(
'title' => __( 'Drag & Drop Content', 'et_builder' ),
'description' => esc_html__( 'Every item on the page can be dragged and dropped to new locations. Using your mouse, click the highlighted move icon and hold down the mouse button. While holding down the mouse button, move your cursor over to the empty column and then release your mouse button to drop the module into the new column.', 'et_builder' ),
),
'rightClickCopy' => array(
'title' => esc_html__( 'Access Right Click Options', 'et_builder' ),
'description' => esc_html__( 'In addition to hover actions, additional options can be accessed by Right Clicking or Cmd + Clicking on any module, row or section. Using the right click menu shown, click the highlighted “Copy Module” button to copy the blurb module that you just moved.', 'et_builder' ),
),
'rightClickPaste' => array(
'title' => esc_html__( 'Paste Your Copied Module', 'et_builder' ),
'description' => esc_html__( 'Now that you have copied a module using the Right Click menu, you can Right Click in a new location to paste that module. Using the right click options shown, click the “Paste Module” button to paste the module you just copied into the empty column.', 'et_builder' ),
),
'rowOptions' => array(
'title' => esc_html__( 'Access Your Row Options', 'et_builder' ),
'description' => esc_html__( 'Every Row and Section has its own set of options that can be used to adjust the item’s appearance. You can adjust its width, padding, background and more. To access a row’s settings, hover over the row and click the highlighted options button.', 'et_builder' ),
),
'editRow' => array(
'title' => esc_html__( 'Adjust Your Row Setting', 'et_builder' ),
'description' => esc_html__( 'Just like Modules, Rows come with a lot of settings that are separated into the Content, Design and Advanced tabs. Click the highlighted button to add a new background color to your row.', 'et_builder' ),
),
'saveRow' => array(
'title' => esc_html__( 'Accept Your Changes', 'et_builder' ),
'description' => esc_html__( 'Click the highlighted green check mark button to accept your changes. ', 'et_builder' ),
),
'pageSettings' => array(
'title' => esc_html__( 'Open Your Page Settings', 'et_builder' ),
'description' => esc_html__( 'While using the Divi Builder, you can access your page settings by toggling the page settings bar at the bottom of your screen. Click the highlighted button to reveal your page settings.', 'et_builder' ),
),
'tabletPreview' => array(
'title' => esc_html__( 'Preview Your Page On Mobile', 'et_builder' ),
'description' => esc_html__( 'While editing your page, it’s easy to see what your design will look like on mobile devices. You can also make adjustments to your module, row and section settings for each mobile breakpoint. Click the highlighted “Tablet” icon to enter Tablet preview mode. ', 'et_builder' ),
),
'desktopPreview' => array(
'title' => esc_html__( 'Switch Back To Desktop Mode', 'et_builder' ),
'description' => esc_html__( 'You can switch back and forth between each preview mode freely while editing your page. Now that we have previewed our page on Tablet, let’s switch back to Desktop preview mode by clicking the highlighted button.', 'et_builder' ),
),
'openHistory' => array(
'title' => esc_html__( 'Access Your Editing History', 'et_builder' ),
'description' => esc_html__( 'Every change you make while editing your page is saved in your editing history. You can navigate backwards and forwards through time to any point during your current editing session, as well as undo and redo recent changes. Click the highlighted History button to access your editing history. ', 'et_builder' ),
),
'editHistory' => array(
'title' => esc_html__( 'Undo, Redo And Restore', 'et_builder' ),
'description' => esc_html__( 'Here you can undo, redo or restore a saved history state. If you change your mind about recent changes, simply click back in time and start building again. You can also undo and redo recent changes. Click the undo and redo buttons and then accept your changes by clicking the green check mark.', 'et_builder' ),
),
'savePage' => array(
'title' => esc_html__( 'Save Your Page', 'et_builder' ),
'description' => sprintf(
// translators: %1$s: "Save" or "Publish" - label.
esc_html__( 'When you are all done, you can save your changes by clicking the %1$s button inside of your page settings bar. You can also press Ctrl + S at any time to save your changes. Click the highlighted Save button to save your changes. Don’t worry, the page you were working on before starting this tour will not be lost!', 'et_builder' ),
in_array( $post_status, array( 'private', 'publish' ), true ) ? esc_html__( 'Save', 'et_builder' ) : esc_html__( 'Publish', 'et_builder' )
),
),
'finish' => array(
'title' => esc_html__( 'You’re Ready To Go!', 'et_builder' ),
'description' => sprintf(
// translators: %10$s: Tour video overlay, %1$s: "Section" - label, %2$s: Add icon markup, %3$s: "Row" - label, %4$s: Add icon markup, %5$s: "Modules" - label, %6$s: Add icon markup, %7$s: Settings gear icon markup, %9$s: Documentation link markup.
__( '%10$sBuilding beautiful pages is a breeze using the Visual Builder. To get started, add a new %1$s to your page by pressing the %2$s button. Next, add a %3$s of columns inside your section by pressing the %4$s button. Finally, start adding some content %5$s inside your columns by pressing the %6$s button. You can customize the design and content of any element on the page by pressing the %7$s button. If you ever need help, visit our %9$s page for a full list of tutorials.', 'et_builder' ),
sprintf( '%1$s', esc_html__( 'Section' ) ),
'',
sprintf( '%1$s', esc_html__( 'Row' ) ),
'',
sprintf( '%1$s', esc_html__( 'Modules' ) ),
'',
'',
'?',
sprintf( '%1$s', esc_html__( 'Documentation' ) ),
sprintf(
'
',
esc_url( ET_BUILDER_URI . '/frontend-builder/assets/img/product-tour-intro.jpg' )
)
),
'endButtonText' => esc_html__( 'Start Building', 'et_builder' ),
),
'endButtonTextDefault' => esc_html__( 'End the Tour', 'et_builder' ),
'skipButtonTextDefault' => esc_html__( 'Skip This Step', 'et_builder' ),
);
return $product_tour_text;
}
/**
* Process builder shortcode into object.
*
* The standard do_shortcode filter should be removed, and
* this function hooked instead.
*
* This function is very similar to `do_shortcode`,
* with the main differences being:
* - Its main design is to allow recursive array to be built out of wp shortcode
* - Allows shortcode callback to return an array rather than a string
* - It tracks the inner `index` / `_i` of each child shortcode to the passed content, which is used in the address creation as well
* - It uses and passes `$address` & `$parent_address`, which are used by FB app.
*
* @param string $content post content.
* @param string $parent_address parent shortcode address.
* @param string $global_parent ?? @todo Add param doc.
* @param string $global_parent_type ?? @todo Add param doc.
* @param string $parent_type ?? @todo Add param doc.
*
* @return mixed
*/
function et_fb_process_shortcode( $content, $parent_address = '', $global_parent = '', $global_parent_type = '', $parent_type = '', $theme_builder_area = '' ) {
global $shortcode_tags, $fb_processing_counter;
// if content is array
if ( is_array( $content ) ) {
echo '
$content: ';
print_r($content);
echo '
';
$debug = et_light_debug_backtrace();
echo '
$debug: ';
print_r($debug);
echo '
';
exit;
}
if ( false === strpos( $content, '[' ) ) {
return $content;
}
// Count started processes.
$fb_processing_counter = isset( $fb_processing_counter ) ? $fb_processing_counter + 1 : 1;
// Find all registered tag names in $content.
preg_match_all( '@\[([^<>&/\[\]\x00-\x20=]++)@', $content, $matches );
// Only need unique tag names.
$unique_matches = array_unique( $matches[1] );
$tagnames = array_intersect( array_keys( $shortcode_tags ), $unique_matches );
$pattern = get_shortcode_regex( $unique_matches );
$content = preg_match_all( "/$pattern/", $content, $matches, PREG_SET_ORDER );
$_matches = array();
$_index = 0;
foreach ( $matches as $match ) {
$tag = $match[2];
// reset global parent data to calculate it correctly for next modules.
if ( $global_parent_type === $tag && '' !== $global_parent ) {
$global_parent = '';
$global_parent_type = '';
}
$attr = shortcode_parse_atts( $match[3] );
if ( ! is_array( $attr ) ) {
$attr = array();
}
$index = $_index++;
$address = isset( $parent_address ) && '' !== $parent_address ? (string) $parent_address . '.' . (string) $index : (string) $index;
// set global parent and global parent tag if current module is global and can be a parent.
$possible_global_parents = array( 'et_pb_section', 'et_pb_row', 'et_pb_row_inner' );
if ( '' === $global_parent && in_array( $tag, $possible_global_parents, true ) ) {
$global_parent = isset( $attr['global_module'] ) ? $attr['global_module'] : '';
$global_parent_type = $tag;
}
// As responsive content attributes value might be has been encoded before saving to database,
// so we need to decode it before passing back to builder.
if ( $attr ) {
$decoded_content_fields = array(
'content__hover',
'content_tablet',
'content_phone',
'raw_content__hover',
'raw_content_tablet',
'raw_content_phone',
);
foreach ( $decoded_content_fields as $decoded_content_field ) {
if ( array_key_exists( $decoded_content_field, $attr ) ) {
$attr[ $decoded_content_field ] = str_replace( array( '%22', '%92', '%91', '%93' ), array( '"', '\\', '[', ']' ), $attr[ $decoded_content_field ] );
}
}
}
$attr['_i'] = $index;
$attr['_address'] = $address;
// Builder shortcode which exist on page but not registered in WP i.e. 3rd party shortcode when 3rd party module disabled
// Add dummy object to render it in Divi Builder.
if ( ! in_array( $tag, $tagnames, true ) ) {
$_matches[] = array(
'_i' => $index,
'_order' => $index,
'address' => $address,
'vb_support' => 'off',
'component_path' => 'et-fb-removed-component',
'type' => $tag,
'attrs' => $attr,
);
continue;
}
// Flag that the shortcode object is being built.
$GLOBALS['et_fb_processing_shortcode_object'] = true;
if ( isset( $match[5] ) ) {
// phpcs:ignore Generic.PHP.ForbiddenFunctions.Found -- `call_user_func` calls the registered shortcode callback.
$output = call_user_func( $shortcode_tags[ $tag ], $attr, $match[5], $tag, $parent_address, $global_parent, $global_parent_type, $parent_type, $theme_builder_area );
} else {
// self-closing tag.
// phpcs:ignore Generic.PHP.ForbiddenFunctions.Found -- `call_user_func` calls the registered shortcode callback.
$output = call_user_func( $shortcode_tags[ $tag ], $attr, null, $tag );
}
// Handle third-party shortcodes that return strings instead of arrays.
// Divi modules return arrays with 'attrs' key, but third-party shortcodes (e.g., WooCommerce)
// return rendered HTML strings. Convert these to a safe dummy object structure.
if ( ! is_array( $output ) || ! isset( $output['attrs'] ) ) {
// Third-party shortcode returned a string or invalid structure.
// Create a dummy object similar to unregistered shortcodes to preserve the shortcode
// during import without executing its callback.
$_matches[] = array(
'_i' => $index,
'_order' => $index,
'address' => $address,
'vb_support' => 'off',
'component_path' => 'et-fb-removed-component',
'type' => $tag,
'attrs' => $attr,
);
continue;
}
$_matches[] = et_fb_add_additional_attrs( $attr, $output );
}
// Count finished processes.
$fb_processing_counter = $fb_processing_counter - 1; // phpcs:ignore Squiz.Operators.IncrementDecrementUsage -- This is more readable.
// Make sure ALL the processes finished to avoid wrong disabling of `et_fb_processing_shortcode_object` when several concurrent instances of `et_fb_process_shortcode` running.
if ( 0 === $fb_processing_counter ) {
// Turn off the flag since the shortcode object is done being built.
et_fb_reset_shortcode_object_processing();
}
return $_matches;
}
/**
* Allowlist any additional attributes.
*
* @param array $processed_attrs Shortcode's processed attributes.
* @param array $output Shortcode output.
*
* @return mixed
*/
function et_fb_add_additional_attrs( $processed_attrs, $output ) {
if ( empty( $output['attrs'] ) ) {
return $output;
}
// A list of all the attributes that are already returned after the shortcode is processed.
$safe_attrs = array_keys( $output['attrs'] );
$allowed_attrs = array();
foreach ( $processed_attrs as $attr => $value ) {
if ( ! preg_match( '~_hover(_enabled)?$~', $attr ) ) {
continue;
}
// if color value includes `gcid-`, check for associated Global Color value.
if ( empty( $value ) || false === strpos( $value, 'gcid-' ) ) {
continue;
}
$global_color_info = et_builder_get_all_global_colors( true );
// If there are no matching Global Colors, return null.
if ( ! is_array( $global_color_info ) ) {
continue;
}
foreach ( $global_color_info as $gcid => $details ) {
if ( false !== strpos( $value, $gcid ) ) {
// Match substring (needed for attrs like gradient stops).
$value = str_replace( $gcid, $details['color'], $value );
}
}
// Finally, escape the output.
if ( ! empty( $global_color_info['color'] ) ) {
$value = esc_attr( $value );
}
$allowed_attrs[ $attr ] = $value;
}
// Extra conversion for the case with the `font_icon__hover` option.
if ( ! empty( $allowed_attrs['font_icon__hover'] ) && et_pb_maybe_old_divi_font_icon( $allowed_attrs['font_icon__hover'] ) ) {
$allowed_attrs['font_icon__hover'] = et_pb_build_extended_font_icon_value( $allowed_attrs['font_icon__hover'], null, null, true );
}
if ( $allowed_attrs ) {
$output['attrs'] = array_merge( $output['attrs'], $allowed_attrs );
}
return $output;
}
/**
* Parse builder shortcode into an array.
*
* @param string $content Builder built post content.
*
* @return array Array representation of the builder shortcode.
*/
function et_pb_parse_shortcode_to_array( $content ) {
global $shortcode_tags;
if ( false === strpos( $content, '[' ) ) {
return $content;
}
// Find all registered tag names in $content.
preg_match_all( '@\[([^<>&/\[\]\x00-\x20=]++)@', $content, $matches );
$tagnames = array_intersect( array_keys( $shortcode_tags ), $matches[1] );
$pattern = get_shortcode_regex( $matches[1] );
$content = preg_match_all( "/$pattern/", $content, $matches, PREG_SET_ORDER );
$shortcode_data = array();
foreach ( $matches as $match ) {
$tag = $match[2];
$attr = shortcode_parse_atts( $match[3] );
if ( ! is_array( $attr ) ) {
$attr = array();
}
$_shortcode_data = array(
'type' => $tag,
'attrs' => $attr,
);
if ( ! empty( $match[5] ) ) {
$_shortcode_data['content'] = et_pb_parse_shortcode_to_array( $match[5] );
}
$shortcode_data[] = $_shortcode_data;
}
return $shortcode_data;
}
/**
* Parse post content that includes builder shortcode to an array,
* then run it back through "some sanity check" and "some sanitization"
* and then form into a shortcode again.
*
* @see et_fb_process_to_shortcode() for exact sanitizations performed.
*
* @param string $content Builder built post content.
* @param bool $force_valid_builder_slugs Whether to force the shortcode to allow valid builder shortcode slugs only.
*
* @return string Sanitized builder built post content.
*/
function et_pb_sanitize_shortcode( $content, $force_valid_builder_slugs = false ) {
global $shortcode_tags;
if ( false === strpos( $content, '[' ) ) {
return $content;
}
$content_array = et_pb_parse_shortcode_to_array( $content );
$options = array(
'force_valid_slugs' => $force_valid_builder_slugs,
);
$new_content = et_fb_process_to_shortcode( $content_array, $options );
return $new_content;
}
/**
* Use shortcode tag which renders the content to correctly display its properties.
*
* @param string $tag shortcode tag.
*
* @return string
*/
function et_fb_prepare_tag( $tag ) {
// List of aliases.
$aliases = apply_filters(
'et_fb_prepare_tag_aliases',
array(
'et_pb_accordion_item' => 'et_pb_toggle',
)
);
return isset( $aliases[ $tag ] ) ? $aliases[ $tag ] : $tag;
}
if ( ! function_exists( 'et_strip_shortcodes' ) ) :
/**
* Strip builder shortcodes only, leaving default WordPress shortcodes intact.
*
* @param string $content the content.
* @param string $truncate_post_based_shortcodes_only Optional. Whether trunct only post based shortcodes.
*/
function et_strip_shortcodes( $content, $truncate_post_based_shortcodes_only = false ) {
global $shortcode_tags;
$content = trim( $content );
$strip_content_shortcodes = array(
'et_pb_code',
'et_pb_fullwidth_code',
'et_pb_social_media_follow_network',
);
// list of post-based shortcodes.
if ( $truncate_post_based_shortcodes_only ) {
$strip_content_shortcodes = array(
'et_pb_post_slider',
'et_pb_fullwidth_post_slider',
'et_pb_blog',
'et_pb_comments',
);
}
foreach ( $strip_content_shortcodes as $shortcode_name ) {
$regex = sprintf(
'(\[%1$s[^\]]*\][^\[]*\[\/%1$s\]|\[%1$s[^\]]*\])',
esc_html( $shortcode_name )
);
$content = preg_replace( $regex, '', $content );
}
// do not proceed if we need to truncate post-based shortcodes only.
if ( $truncate_post_based_shortcodes_only ) {
return $content;
}
$shortcode_tag_names = array();
foreach ( $shortcode_tags as $shortcode_tag_name => $shortcode_tag_cb ) {
if ( 0 !== strpos( $shortcode_tag_name, 'et_pb_' ) ) {
continue;
}
$shortcode_tag_names[] = $shortcode_tag_name;
}
$et_shortcodes = implode( '|', $shortcode_tag_names );
$regex_opening_shortcodes = sprintf( '(\[(%1$s)[^\]]+\])', esc_html( $et_shortcodes ) );
$regex_closing_shortcodes = sprintf( '(\[\/(%1$s)\])', esc_html( $et_shortcodes ) );
$content = preg_replace( $regex_opening_shortcodes, '', $content );
$content = preg_replace( $regex_closing_shortcodes, '', $content );
return $content;
}
endif;
/**
* Reset shortcode object processing.
*/
function et_fb_reset_shortcode_object_processing() {
$GLOBALS['et_fb_processing_shortcode_object'] = false;
}
if ( ! function_exists( 'et_builder_maybe_flush_rewrite_rules' ) ) :
/**
* Flush rewrite rules if theme option saved value and passed $value are not same.
*
* @param string $setting_name The theme option.
* @param string $value The value to be compared.
*/
function et_builder_maybe_flush_rewrite_rules( $setting_name, $value = 'done' ) {
$string_value = (string) $value;
$saved_value = et_get_option( $setting_name );
if ( $saved_value && $saved_value === $string_value ) {
return;
}
flush_rewrite_rules();
et_update_option( $setting_name, $string_value );
}
endif;
/**
* Flush rewrite rules to fix the issue Layouts, not being visible on front-end and visual builder,
* if pretty permalinks were enabled
*
* @return void
*/
function et_pb_maybe_flush_rewrite_rules_library() {
// Run flush rewrite only when et_pb_layout post type registered.
if ( post_type_exists( 'et_pb_layout' ) ) {
et_builder_maybe_flush_rewrite_rules( 'et_flush_rewrite_rules_library', ET_BUILDER_PRODUCT_VERSION );
}
}
add_action( 'init', 'et_pb_maybe_flush_rewrite_rules_library', 9 );
/**
* Remove et_builder_maybe_flush_rewrite_rules flag if flush_rewrite_rules() is called while
* `et_pb_layout` post type hasn't been registered
*
* @since 3.19.18
*
* @param string|array $old_value old option value.
* @param string|array $value new option value.
* @param string $option option name.
*/
function et_pb_maybe_remove_flush_rewrite_rules_library_flag( $old_value, $value, $option ) {
// rewrite rules for CPT that are rebuilt by flush_rewrite_rules() are based on
// get_post_types( array( '_builtin' => false ) ) value; Hence if flush_rewrite_rules() is
// executed while `et_pb_layout` CPT hasn't been registered (usually by third party plugin)
// et_pb_maybe_flush_rewrite_rules_library() flag has to be removed to trigger flush_rewrite_rules()
// via et_pb_maybe_flush_rewrite_rules_library() which contains `et_pb_layout` rewrite rules
// because et_pb_maybe_flush_rewrite_rules_library() checks for `et_pb_layout` first.
if ( '' === $value && ! post_type_exists( 'et_pb_layout' ) ) {
et_update_option( 'et_flush_rewrite_rules_library', '' );
}
}
add_action( 'update_option_rewrite_rules', 'et_pb_maybe_remove_flush_rewrite_rules_library_flag', 10, 3 );
if ( ! function_exists( 'et_builder_get_shortcuts' ) ) :
/**
* Get list of shortcut available on BB and FB
*
* @param string $on (fb|bb) shortcut mode.
* @return array shortcut list
*/
function et_builder_get_shortcuts( $on = 'fb' ) {
$shortcuts = array(
'page' => array(
'page_title' => array(
'title' => esc_html__( 'Page Shortcuts', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'undo' => array(
'kbd' => array( 'super', 'z' ),
'desc' => esc_html__( 'Undo', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'redo' => array(
'kbd' => array( 'super', 'y' ),
'desc' => esc_html__( 'Redo', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'save' => array(
'kbd' => array( 'super', 's' ),
'desc' => esc_html__( 'Save Page', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'save_as_draft' => array(
'kbd' => array( 'super', 'shift', 's' ),
'desc' => esc_html__( 'Save Page As Draft', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'exit' => array(
'kbd' => array( 'super', 'e' ),
'desc' => esc_html__( 'Exit Visual Builder', 'et_builder' ),
'on' => array(
'fb',
),
),
'exit_to_backend_builder' => array(
'kbd' => array( 'super', 'shift', 'e' ),
'desc' => esc_html__( 'Exit To Backend Builder', 'et_builder' ),
'on' => array(
'fb',
),
),
'toggle_settings_bar' => array(
'kbd' => array( 't' ),
'desc' => esc_html__( 'Toggle Settings Bar', 'et_builder' ),
'on' => array(
'fb',
),
),
'open_page_settings' => array(
'kbd' => array( 'o' ),
'desc' => esc_html__( 'Open Page Settings', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'open_history' => array(
'kbd' => array( 'h' ),
'desc' => esc_html__( 'Open History Window', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'open_portability' => array(
'kbd' => array( 'p' ),
'desc' => esc_html__( 'Open Portability Window', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'zoom_in' => array(
'kbd' => array( 'super', '+' ),
'desc' => esc_html__( 'Responsive Zoom In', 'et_builder' ),
'on' => array(
'fb',
),
),
'zoom_out' => array(
'kbd' => array( 'super', '-' ),
'desc' => esc_html__( 'Responsive Zoom Out', 'et_builder' ),
'on' => array(
'fb',
),
),
'wireframe' => array(
'kbd' => array( 'shift', 'w' ),
'desc' => esc_html__( 'Wireframe Mode', 'et_builder' ),
'on' => array(
'fb',
),
),
'click_mode' => array(
'kbd' => array( 'super', 'shift', 'c' ),
'desc' => esc_html__( 'Click Mode', 'et_builder' ),
'on' => array(
'fb',
),
),
'grid_mode' => array(
'kbd' => array( 'super', 'shift', 'g' ),
'desc' => esc_html__( 'Grid Mode', 'et_builder' ),
'on' => array(
'fb',
),
),
'hover_mode' => array(
'kbd' => array( 'super', 'shift', 'h' ),
'desc' => esc_html__( 'Hover Mode', 'et_builder' ),
'on' => array(
'fb',
),
),
'help' => array(
'kbd' => array( '?' ),
'desc' => esc_html__( 'List All Shortcuts', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
),
'inline' => array(
'inline_title' => array(
'title' => esc_html__( 'Inline Editor Shortcuts', 'et_builder' ),
'on' => array(
'fb',
),
),
'escape' => array(
'kbd' => array( 'esc' ),
'desc' => esc_html__( 'Exit Inline Editor', 'et_builder' ),
'on' => array(
'fb',
),
),
),
'module' => array(
'module_title' => array(
'title' => esc_html__( 'Module Shortcuts', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'module_copy' => array(
'kbd' => array( 'super', 'c' ),
'desc' => esc_html__( 'Copy Module', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'module_cut' => array(
'kbd' => array( 'super', 'x' ),
'desc' => esc_html__( 'Cut Module', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'module_paste' => array(
'kbd' => array( 'super', 'v' ),
'desc' => esc_html__( 'Paste Module', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'module_copy_styles' => array(
'kbd' => array( 'super', 'alt', 'c' ),
'desc' => esc_html__( 'Copy Module Styles', 'et_builder' ),
'on' => array(
'fb',
),
),
'module_paste_styles' => array(
'kbd' => array( 'super', 'alt', 'v' ),
'desc' => esc_html__( 'Paste Module Styles', 'et_builder' ),
'on' => array(
'fb',
),
),
'module_reset_styles' => array(
'kbd' => array( 'super', 'alt', 'r' ),
'desc' => esc_html__( 'Reset Module Styles', 'et_builder' ),
'on' => array(
'fb',
),
),
'module_lock' => array(
'kbd' => array( 'super', 'shift', 'l' ),
'desc' => esc_html__( 'Lock Module', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'module_disable' => array(
'kbd' => array( 'super', 'shift', 'd' ),
'desc' => esc_html__( 'Disable Module', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'drag_auto_copy' => array(
'kbd' => array( 'alt', 'module move' ),
'desc' => esc_html__( 'Move and copy module into dropped location', 'et_builder' ),
'on' => array(
'fb',
),
),
'column_change_structure' => array(
'kbd' => array( 'c', array( '1', '2', '3', '4', '5', '...' ) ),
'desc' => esc_html__( 'Change Column Structure', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'row_make_fullwidth' => array(
'kbd' => array( 'r', 'f' ),
'desc' => esc_html__( 'Make Row Fullwidth', 'et_builder' ),
'on' => array(
'fb',
),
),
'row_edit_gutter' => array(
'kbd' => array( 'g', array( '1', '2', '3', '4' ) ),
'desc' => esc_html__( 'Change Gutter Width', 'et_builder' ),
'on' => array(
'fb',
),
),
'add_new_row' => array(
'kbd' => array( 'r', array( '1', '2', '3', '4', '5', '...' ) ),
'desc' => esc_html__( 'Add New Row', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'add_new_section' => array(
'kbd' => array( 's', array( '1', '2', '3' ) ),
'desc' => esc_html__( 'Add New Section', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'resize_padding_auto_opposite' => array(
'kbd' => array( 'shift', 'Drag Padding' ),
'desc' => esc_html__( 'Restrict padding to 10px increments', 'et_builder' ),
'on' => array(
'fb',
),
),
'resize_padding_limited' => array(
'kbd' => array( 'alt', 'Drag Padding' ),
'desc' => esc_html__( 'Padding limited to opposing value', 'et_builder' ),
'on' => array(
'fb',
),
),
'resize_padding_10' => array(
'kbd' => array( 'shift', 'alt', 'Drag Padding' ),
'desc' => esc_html__( 'Mirror padding on both sides', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_row' => array(
'kbd' => array( 'r', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Row Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_row' => array(
'kbd' => array( 'r', 'alt', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Row Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_section' => array(
'kbd' => array( 's', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Section Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_section' => array(
'kbd' => array( 's', 'alt', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Section Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_module' => array(
'kbd' => array( 'm', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Module Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_module' => array(
'kbd' => array( 'm', 'alt', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Module Padding', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_row_10' => array(
'kbd' => array( 'r', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Row Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_row_10' => array(
'kbd' => array( 'r', 'alt', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Row Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_section_10' => array(
'kbd' => array( 's', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Section Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_section_10' => array(
'kbd' => array( 's', 'alt', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Section Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
'increase_padding_module_10' => array(
'kbd' => array( 'm', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Increase Module Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
'decrease_padding_module_10' => array(
'kbd' => array( 'm', 'alt', 'shift', array( 'left', 'right', 'up', 'down' ) ),
'desc' => esc_html__( 'Decrease Module Padding By 10px', 'et_builder' ),
'on' => array(
'fb',
),
),
),
'modal' => array(
'modal_title' => array(
'title' => esc_html__( 'Modal Shortcuts', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'escape' => array(
'kbd' => array( 'esc' ),
'desc' => esc_html__( 'Close Modal', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'save_changes' => array(
'kbd' => array( 'enter' ),
'desc' => esc_html__( 'Save Changes', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'undo' => array(
'kbd' => array( 'super', 'z' ),
'desc' => esc_html__( 'Undo', 'et_builder' ),
'on' => array(
'fb',
),
),
'redo' => array(
'kbd' => array( 'super', 'shift', 'z' ),
'desc' => esc_html__( 'Redo', 'et_builder' ),
'on' => array(
'fb',
),
),
'switch_tabs' => array(
'kbd' => array( 'shift', 'tab' ),
'desc' => esc_html__( 'Switch Tabs', 'et_builder' ),
'on' => array(
'fb',
'bb',
),
),
'toggle_expand' => array(
'kbd' => array( 'super', 'enter' ),
'desc' => esc_html__( 'Expand Modal Fullscreen', 'et_builder' ),
'on' => array(
'fb',
),
),
'toggle_snap' => array(
'kbd' => array( 'super', array( 'left', 'right' ) ),
'desc' => esc_html__( 'Snap Modal Left / Right', 'et_builder' ),
'on' => array(
'fb',
),
),
'quick_actions' => array(
'kbd' => array( 'shift', 'space' ),
'desc' => esc_html__( 'Quick Actions', 'et_builder' ),
'on' => array(
'fb',
),
),
'layers_view' => array(
'kbd' => array( 'super', 'l' ),
'desc' => esc_html__( 'Layers View', 'et_builder' ),
'on' => array(
'fb',
),
),
),
);
$shortcuts = apply_filters( 'et_builder_get_shortcuts', $shortcuts );
// Filter shortcuts.
$filtered_shortcuts = array();
foreach ( $shortcuts as $group_key => $group ) {
foreach ( $group as $shortcut_key => $shortcut ) {
if ( in_array( $on, $shortcut['on'], true ) ) {
$filtered_shortcuts[ $group_key ][ $shortcut_key ] = $shortcut;
}
}
}
return $filtered_shortcuts;
}
endif;
if ( ! function_exists( 'et_pb_get_responsive_status' ) ) :
/**
* Parsed *_last_edited value and determine wheter the passed string means it has responsive value or not
* *_last_edited holds two values (responsive status and last opened tabs) in the following format: status|last_opened_tab
*
* @param string $last_edited last_edited data.
* @return bool
*/
function et_pb_get_responsive_status( $last_edited ) {
$parsed_last_edited = is_string( $last_edited ) ? explode( '|', $last_edited ) : array( 'off', 'desktop' );
return isset( $parsed_last_edited[0] ) ? 'on' === $parsed_last_edited[0] : false;
}
endif;
if ( ! function_exists( 'et_pb_get_value_unit' ) ) :
/**
* Get unit of given value
*
* @param string $value string with unit.
* @param string $default_unit default unit.
*
* @return string unit name
*/
function et_pb_get_value_unit( $value, $default_unit = 'px' ) {
$value = isset( $value ) ? $value : '';
$valid_one_char_units = array( '%', 'x' );
$valid_two_chars_units = array( 'em', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw', 'ms' );
$valid_three_chars_units = array( 'deg', 'rem' );
$important = '!important';
$important_length = strlen( $important );
$value_length = strlen( $value );
if ( '' === $value || is_numeric( $value ) ) {
return $default_unit;
}
if ( substr( $value, ( 0 - $important_length ), $important_length ) === $important ) {
$value_length = $value_length - $important_length;
$value = trim( substr( $value, 0, $value_length ) );
}
if ( in_array( substr( $value, -3, 3 ), $valid_three_chars_units, true ) ) {
return substr( $value, -3, 3 );
}
if ( in_array( substr( $value, -2, 2 ), $valid_two_chars_units, true ) ) {
return substr( $value, -2, 2 );
}
if ( in_array( substr( $value, -1, 1 ), $valid_one_char_units, true ) ) {
return substr( $value, -1, 1 );
}
return $default_unit;
}
endif;
if ( ! function_exists( 'et_sanitize_input_unit' ) ) :
/**
* Sanitized value and its unit
*
* @param mixed $value Input value.
* @param string $auto_important Whether add !important specificity. Default false.
* @param string|bool $default_unit The default unit.
*
* @return string sanitized input and its unit
*/
function et_sanitize_input_unit( $value = '', $auto_important = false, $default_unit = false ) {
$value = (string) $value;
$valid_one_char_units = array( '%', 'x' );
$valid_two_chars_units = array( 'em', 'px', 'cm', 'mm', 'in', 'pt', 'pc', 'ex', 'vh', 'vw', 'ms' );
$valid_three_chars_units = array( 'deg', 'rem' );
$important = '!important';
$important_length = strlen( $important );
$has_important = false;
$value_length = strlen( $value );
$unit_value;
// Check for important.
if ( substr( $value, ( 0 - $important_length ), $important_length ) === $important ) {
$has_important = true;
$value_length = $value_length - $important_length;
$value = trim( substr( $value, 0, $value_length ) );
}
if ( in_array( substr( $value, -3, 3 ), $valid_three_chars_units, true ) ) {
$unit_value = floatval( $value ) . substr( $value, -3, 3 );
// Re-add !important tag.
if ( $has_important && ! $auto_important ) {
$unit_value = $unit_value . ' ' . $important;
}
return $unit_value;
}
if ( in_array( substr( $value, -2, 2 ), $valid_two_chars_units, true ) ) {
$unit_value = floatval( $value ) . substr( $value, -2, 2 );
// Re-add !important tag.
if ( $has_important && ! $auto_important ) {
$unit_value = $unit_value . ' ' . $important;
}
return $unit_value;
}
if ( in_array( substr( $value, -1, 1 ), $valid_one_char_units, true ) ) {
$unit_value = floatval( $value ) . substr( $value, -1, 1 );
// Re-add !important tag.
if ( $has_important && ! $auto_important ) {
$unit_value = $unit_value . ' ' . $important;
}
return $unit_value;
}
$result = floatval( $value );
if ( 'no_default_unit' === $default_unit ) {
return $result;
}
if ( $default_unit ) {
return $result . $default_unit;
}
if ( ! $default_unit ) {
$result .= 'px';
}
// Return and automatically append px (default value).
return $result;
}
endif;
if ( ! function_exists( 'et_builder_get_taxonomies' ) ) :
/**
* Get taxonomies for modules
*
* @param array $args Optional. Uses 'use_terms' argument to retrieve the terms in a given taxonomy.
* Uses 'term_name' to specify Taxonomy to retrieve terms.
*
* @return array Array of WP taxonomies splitted into the taxonomy types
*/
function et_builder_get_shop_categories( $args = array() ) {
$defaults = apply_filters(
'et_builder_include_categories_shop_defaults',
array(
'use_terms' => true,
'term_name' => 'product_cat',
)
);
$term_args = apply_filters( 'et_builder_include_categories_shop_args', array( 'hide_empty' => false ) );
$args = wp_parse_args( $args, $defaults );
$product_categories = $args['use_terms'] ? get_terms( $args['term_name'], $term_args ) : get_categories( apply_filters( 'et_builder_get_categories_shop_args', 'hide_empty=0' ) );
return $product_categories;
}
endif;
if ( ! function_exists( 'et_pb_get_spacing' ) ) :
/**
* Return spacing value.
*
* @param string $spacing spacing string.
* @param string $corner spacing corner.
* @param string $default default value.
*/
function et_pb_get_spacing( $spacing, $corner, $default = '0px' ) {
$corners = array( 'top', 'right', 'bottom', 'left' );
$corner_index = array_search( $corner, $corners, true );
$spacing_array = explode( '|', $spacing );
return isset( $spacing_array[ $corner_index ] ) && '' !== $spacing_array[ $corner_index ] ? $spacing_array[ $corner_index ] : $default;
}
endif;
if ( ! function_exists( 'et_fb_enqueue_bundle' ) ) :
/**
* Enqueue a bundle
*
* @param string $id Name of the stylesheet.
* @param string $resource Resource file name.
* @param array $deps Resource dependencies.
* @param mixed $ver Resource version number.
*/
function et_fb_enqueue_bundle( $id, $resource, $deps, $ver = false ) {
$debug = defined( 'ET_DEBUG' ) && ET_DEBUG;
$ver = false === $ver ? ET_BUILDER_VERSION : $ver;
$build = 'frontend-builder/build';
$bundle = sprintf( '%s/%s/%s', ET_BUILDER_URI, $build, $resource );
$type = pathinfo( $resource, PATHINFO_EXTENSION );
switch ( $type ) {
case 'css':
if ( file_exists( sprintf( '%s%s/%s', ET_BUILDER_DIR, $build, $resource ) ) || ! $debug ) {
wp_enqueue_style( $id, $bundle, $deps, $ver );
} elseif ( $debug ) {
// Style is already embedded in the bundle but we still need to enqueue its deps.
foreach ( $deps as $dep ) {
wp_enqueue_style( $dep );
}
}
break;
case 'js':
if ( file_exists( sprintf( '%s%s/%s', ET_BUILDER_DIR, $build, $resource ) ) || ! $debug ) {
// If the file exists on disk, enqueue it.
wp_enqueue_script( $id, $bundle, $deps, $ver, true );
} else {
// Otherwise load `hot` from webpack-dev-server.
$site_url = wp_parse_url( get_site_url() );
$hot_bundle_url = "{$site_url['scheme']}://{$site_url['host']}:31495/$resource";
wp_enqueue_script( $id, $hot_bundle_url, $deps, $ver, true );
}
wp_add_inline_script( $id, 'window.et_gb = (window.top && window.top.Cypress && window.parent === window.top && window) || (window.top && window.top.Cypress && window.parent !== window.top && window.parent) || window.top || window;', 'before' );
break;
}
}
endif;
if ( ! function_exists( 'et_builder_get_active_plugins' ) ) :
/**
* Get list of all active plugins (single, network active, and mu)
*
* @return array active plugins
*/
function et_builder_get_active_plugins() {
$active_plugins = get_option( 'active_plugins' );
// Returned format must be array.
if ( ! is_array( $active_plugins ) ) {
$active_plugins = array();
}
// Get mu-plugins (must-use)
// mu-plugins data is returned in array( "plugin/name.php" => array( 'data' => 'value' ) ) format.
$mu_plugins = get_mu_plugins();
if ( is_array( $mu_plugins ) ) {
$active_plugins = array_merge( $active_plugins, array_keys( $mu_plugins ) );
}
// Get network active plugins
// Network active plugin data is returned in array( "plugin/name.php" => active_timestamp_int format.
if ( is_multisite() ) {
$network_active_plugins = get_site_option( 'active_sitewide_plugins' );
if ( is_array( $network_active_plugins ) ) {
$active_plugins = array_merge( $active_plugins, array_keys( $network_active_plugins ) );
}
}
return apply_filters( 'et_builder_get_active_plugins', $active_plugins );
}
endif;
if ( ! function_exists( 'et_has_hover_enabled' ) ) :
/**
* Determine whether hover is enable or not.
*
* @param array $props element's props.
*/
function et_has_hover_enabled( $props ) {
$et_has_hover_enabled = false;
$prop_names = array_keys( $props );
$suffix = et_pb_hover_options()->get_enabled_suffix();
foreach ( $prop_names as $prop_name ) {
if ( preg_match( "~{$suffix}$~", $prop_name ) && 'on' === $props[ $prop_name ] ) {
$et_has_hover_enabled = true;
break;
}
}
return $et_has_hover_enabled;
}
endif;
if ( ! function_exists( 'et_builder_is_hover_enabled' ) ) :
/**
* Check if the setting has enabled hover options
*
* @param string $setting setting name.
* @param array $props element's props.
*/
function et_builder_is_hover_enabled( $setting, $props ) {
return et_pb_hover_options()->is_enabled( $setting, $props );
}
endif;
if ( ! function_exists( 'et_builder_add_prefix' ) ) {
/**
* Prefixes a string key with a prefix string using the provided delimiter
* In case the prefix is empty, original key is returned
*
* @param string $prefix prefix string.
* @param string $key string key.
* @param string $delimiter delimiter.
*
* @return string
*/
function et_builder_add_prefix( $prefix, $key, $delimiter = '_' ) {
return '' === $prefix ? $key : $prefix . $delimiter . $key;
}
}
if ( ! function_exists( 'et_builder_has_value' ) ) {
/**
* Check if value is not an empty value
* Empty values are considered:
* - null
* - ''
* - false
*
* @param string $value value to check.
*
* @return bool
*/
function et_builder_has_value( $value ) {
return null !== $value && '' !== $value && false !== $value;
}
}
if ( ! function_exists( 'et_builder_get_or' ) ) {
/**
* Returns the value in case it is not empty
* Otherwise, return the default value
*
* @param string $value the builder value.
* @param string $default default value.
*
* @return string
*/
function et_builder_get_or( $value, $default = '' ) {
return et_builder_has_value( $value ) ? $value : $default;
}
}
if ( ! function_exists( 'et_builder_module_prop' ) ) {
/**
* Returns props value by provided key, if the value is empty, returns the default value
*
* @param string $prop provided key.
* @param array $props all props.
* @param mixed $default default value.
*
* @return mixed|null
*/
function et_builder_module_prop( $prop, $props, $default ) {
return et_builder_get_or( et_()->array_get( $props, $prop ), $default );
}
}
if ( ! function_exists( 'et_pb_get_column_svg' ) ) {
/**
* Returns svg which represents the requried columns type
*
* @param string $type Column layout type.
*
* @return string svg code.
*/
function et_pb_get_column_svg( $type ) {
$svg = '';
switch ( $type ) {
case '4_4':
$svg = '';
break;
case '1_2,1_2':
$svg = '';
break;
case '1_3,1_3,1_3':
$svg = '';
break;
case '1_4,1_4,1_4,1_4':
$svg = '';
break;
case '1_5,1_5,1_5,1_5,1_5':
$svg = '';
break;
case '1_6,1_6,1_6,1_6,1_6,1_6':
$svg = '';
break;
case '2_5,3_5':
$svg = '';
break;
case '3_5,2_5':
$svg = '';
break;
case '1_3,2_3':
$svg = '';
break;
case '2_3,1_3':
$svg = '';
break;
case '1_4,3_4':
$svg = '';
break;
case '3_4,1_4':
$svg = '';
break;
case '1_4,1_2,1_4':
$svg = '';
break;
case '1_5,3_5,1_5':
$svg = '';
break;
case '1_4,1_4,1_2':
$svg = '';
break;
case '1_2,1_4,1_4':
$svg = '';
break;
case '1_5,1_5,3_5':
$svg = '';
break;
case '3_5,1_5,1_5':
$svg = '';
break;
case '1_6,1_6,1_6,1_2':
$svg = '';
break;
case '1_2,1_6,1_6,1_6':
$svg = '';
break;
}
return $svg;
}
}
/**
* Get image metadata responsive sizes
*
* @since 3.27.3
*
* @param string $image_src The 'src' of the image.
* @param array $image_meta The image meta data as returned by 'wp_get_attachment_metadata()'.
* @param array $size Array of width and height values in pixels (in that order).
*
* @return array|bool
*/
function et_builder_responsive_image_metadata( $image_src, $image_meta = null, $size = null ) {
$cache = ET_Core_Cache_File::get( 'image_responsive_metadata' );
// Normalize image URL.
$normalized_url = et_attachment_normalize_url( $image_src );
if ( isset( $cache[ $normalized_url ] ) ) {
if ( et_core_is_uploads_dir_url( $normalized_url ) ) {
return $cache[ $normalized_url ];
}
unset( $cache[ $normalized_url ] );
ET_Core_Cache_File::set( 'image_responsive_metadata', $cache );
}
$responsive_sizes = array();
$image_id = is_numeric( $image_src ) ? intval( $image_src ) : et_get_attachment_id_by_url( $image_src );
if ( ! $image_id ) {
return array();
}
if ( is_null( $image_meta ) ) {
$image_meta = wp_get_attachment_metadata( $image_id );
}
if ( ! $image_meta || empty( $image_meta['sizes'] ) ) {
return array();
}
if ( is_null( $size ) ) {
$size = et_get_attachment_size_by_url( $image_src );
}
if ( 'full' === $size && isset( $image_meta['width'] ) && isset( $image_meta['height'] ) ) {
$size = array(
absint( $image_meta['width'] ),
absint( $image_meta['height'] ),
);
} elseif ( is_string( $size ) && ! empty( $image_meta['sizes'][ $size ] ) ) {
$size = array(
absint( $image_meta['sizes'][ $size ]['width'] ),
absint( $image_meta['sizes'][ $size ]['height'] ),
);
}
if ( ! $size || ! is_array( $size ) ) {
return array();
}
foreach ( $image_meta['sizes'] as $size_key => $size_data ) {
if ( strpos( $size_key, 'et-pb-image--responsive--' ) !== 0 ) {
continue;
}
if ( is_array( $size ) && $size[0] < $size_data['width'] ) {
$responsive_sizes[ $size_data['width'] ] = false;
} else {
$responsive_sizes[ $size_data['width'] ] = $size_data;
}
}
if ( $responsive_sizes ) {
ksort( $responsive_sizes );
// Cache the responsive sizes data.
if ( et_core_is_uploads_dir_url( $normalized_url ) ) {
$cache[ $normalized_url ] = $responsive_sizes;
ET_Core_Cache_File::set( 'image_responsive_metadata', $cache );
}
}
return $responsive_sizes;
}
if ( ! function_exists( 'et_filter_wp_calculate_image_srcset' ) ) :
/**
* Filters an image's 'srcset' sources.
*
* @since 3.27
*
* @param array $sources {
* One or more arrays of source data to include in the 'srcset'.
*
* @type array $width {
* @type string $url The URL of an image source.
* @type string $descriptor The descriptor type used in the image candidate string,
* either 'w' or 'x'.
* @type int $value The source width if paired with a 'w' descriptor, or a
* pixel density value if paired with an 'x' descriptor.
* }
* }
* @param array $size_array Array of width and height values in pixels (in that order).
* @param string $image_src The 'src' of the image.
* @param array $image_meta The image meta data as returned by 'wp_get_attachment_metadata()'.
*
* @return array
*/
function et_filter_wp_calculate_image_srcset( $sources, $size_array, $image_src, $image_meta ) {
// Do not filter when in wp-admin area.
if ( is_admin() ) {
return $sources;
}
$responsive_sources = array();
if ( ! et_is_responsive_images_enabled() ) {
return $responsive_sources;
}
if ( is_string( $size_array ) ) {
$size_array = et_get_attachment_size_by_url( $image_src );
}
if ( is_string( $size_array ) && $image_meta ) {
if ( 'full' === $size_array ) {
$size_array = array(
absint( $image_meta['width'] ),
absint( $image_meta['height'] ),
);
} elseif ( ! empty( $image_meta['sizes'][ $size_array ] ) ) {
$size_array = array(
absint( $image_meta['sizes'][ $size_array ]['width'] ),
absint( $image_meta['sizes'][ $size_array ]['height'] ),
);
}
}
if ( ! is_array( $size_array ) ) {
return $responsive_sources;
}
$responsive_metadata = et_builder_responsive_image_metadata( $image_src, $image_meta, $size_array );
if ( $responsive_metadata ) {
foreach ( $responsive_metadata as $max_width => $size_data ) {
if ( ! $size_data ) {
continue;
}
// In some SVG images, the value of `$max_width` is 0, in those cases we can set `$max_width` from `$size_array`.
if ( ! $max_width ) {
$max_width = $size_array[0];
}
$responsive_sources[ $max_width ] = array(
'url' => str_replace( basename( $image_src ), $size_data['file'], $image_src ),
'descriptor' => 'w',
'value' => $max_width,
);
}
if ( $responsive_sources && $size_array[0] > $max_width ) {
$responsive_sources[ $size_array[0] ] = array(
'url' => $image_src,
'descriptor' => 'w',
'value' => $size_array[0],
);
}
if ( $responsive_sources ) {
krsort( $responsive_sources );
}
} else {
$responsive_sources = $sources;
}
return $responsive_sources;
}
endif;
add_filter( 'wp_calculate_image_srcset', 'et_filter_wp_calculate_image_srcset', 10, 4 );
if ( ! function_exists( 'et_filter_wp_calculate_image_sizes' ) ) :
/**
* Filters the output of 'wp_calculate_image_sizes()'.
*
* @since 3.27.3
*
* @param string $sizes A source size value for use in a 'sizes' attribute.
* @param array|string $size Requested size. Image size or array of width and height values
* in pixels (in that order).
* @param string|null $image_src The URL to the image file or null.
* @param array|null $image_meta The image meta data as returned by wp_get_attachment_metadata() or null.
*
* @return string|bool A valid source size value for use in a 'sizes' attribute or false.
*/
function et_filter_wp_calculate_image_sizes( $sizes, $size, $image_src, $image_meta ) {
// Do not filter when in wp-admin area.
if ( is_admin() ) {
return $sizes;
}
$responsive_sizes = '';
if ( ! et_is_responsive_images_enabled() ) {
return $responsive_sizes;
}
if ( is_string( $size ) ) {
$size = et_get_attachment_size_by_url( $image_src );
}
if ( is_string( $size ) && $image_meta ) {
if ( 'full' === $size ) {
$size = array(
absint( $image_meta['width'] ),
absint( $image_meta['height'] ),
);
} elseif ( ! empty( $image_meta['sizes'][ $size ] ) ) {
$size = array(
absint( $image_meta['sizes'][ $size ]['width'] ),
absint( $image_meta['sizes'][ $size ]['height'] ),
);
}
}
if ( ! is_array( $size ) ) {
return $responsive_sizes;
}
$responsive_metadata = et_builder_responsive_image_metadata( $image_src, $image_meta, $size );
if ( $responsive_metadata ) {
$max_width = 0;
$prev_width = 0;
$sizes_temp = array();
foreach ( $responsive_metadata as $max_width => $size_data ) {
if ( ! $size_data ) {
continue;
}
if ( $prev_width ) {
$sizes_temp[ $max_width ] = sprintf( '(min-width: %2$dpx) and (max-width: %1$dpx) %1$dpx', $max_width, ( $prev_width + 1 ) );
} else {
$sizes_temp[ $max_width ] = sprintf( '(min-width: %2$dpx) and (max-width: %1$dpx) %1$dpx', $max_width, $prev_width );
}
$prev_width = $max_width;
}
if ( $sizes_temp && $size[0] > $prev_width ) {
$sizes_temp[ $size[0] ] = sprintf( '(min-width: %2$dpx) %1$dpx', $size[0], ( $prev_width + 1 ) );
}
if ( $sizes_temp ) {
$sizes_temp[] = '100vw';
}
$responsive_sizes = implode( ', ', $sizes_temp );
} else {
$responsive_sizes = $sizes;
}
return $responsive_sizes;
}
endif;
add_filter( 'wp_calculate_image_sizes', 'et_filter_wp_calculate_image_sizes', 10, 4 );
/**
* Register and localize assets early enough to avoid conflicts
* with third party plugins that use the same assets.
*
* @since 4.0.9
*/
function et_builder_register_assets() {
global $wp_version;
$root = ET_BUILDER_URI;
$wp_major_version = substr( $wp_version, 0, 3 );
// phpcs:disable WordPress.WP.EnqueuedResourceParameters -- These scripts are inside WordPress core. In order to always load latest script, version number is set false.
wp_register_script( 'iris', admin_url( 'js/iris.min.js' ), array( 'jquery-ui-draggable', 'jquery-ui-slider', 'jquery-touch-punch' ), false, 1 );
wp_register_script( 'wp-color-picker', admin_url( 'js/color-picker.min.js' ), array( 'iris' ), false, 1 );
// phpcs:enable
$wp_color_picker_l10n = array(
'clear' => esc_html__( 'Clear', 'et_builder' ),
'defaultString' => et_builder_i18n( 'Default' ),
'pick' => esc_html__( 'Select Color', 'et_builder' ),
);
if ( version_compare( $wp_major_version, '4.9', '>=' ) ) {
wp_register_script( 'wp-color-picker-alpha', "{$root}/scripts/ext/wp-color-picker-alpha.min.js", array( 'jquery', 'wp-color-picker' ), ET_BUILDER_VERSION, true );
} else {
wp_register_script( 'wp-color-picker-alpha', "{$root}/scripts/ext/wp-color-picker-alpha-48.min.js", array( 'jquery', 'wp-color-picker' ), ET_BUILDER_VERSION, true );
$wp_color_picker_l10n['current'] = esc_html__( 'Current Color', 'et_builder' );
}
wp_localize_script( 'wp-color-picker', 'wpColorPickerL10n', $wp_color_picker_l10n );
}
add_action( 'init', 'et_builder_register_assets', 11 );
if ( ! function_exists( 'et_set_parallax_bg_wrap_border_radius' ) ) :
/**
* Set border radius to parallax background wrapper.
*
* @since 4.4.8
*
* @param array $props Module settings.
* @param string $module Module slug.
* @param string $order_class Module main css element.
*
* @return void
*/
function et_set_parallax_bg_wrap_border_radius( $props, $module, $order_class ) {
$border_radius_values = et_pb_responsive_options()->get_property_values( $props, 'border_radii' );
$border_radius_hover_enabled = et_builder_module_prop( 'border_radii__hover_enabled', $props, '' );
$border_radius_hover_values = et_builder_module_prop( 'border_radii__hover', $props, '' );
foreach ( et_pb_responsive_options()->get_modes() as $device ) {
if ( 'on||||' === $border_radius_values[ $device ] ) {
$border_radius_values[ $device ] = '';
continue;
}
$border_radius_values[ $device ] = et_format_parallax_bg_wrap_radius_values( $border_radius_values[ $device ] );
}
et_pb_responsive_options()->generate_responsive_css(
$border_radius_values,
$order_class . ' .et_parallax_bg_wrap',
'border-radius',
$module,
'',
'border'
);
if ( 'on|hover' === $border_radius_hover_enabled ) {
$radius_hover_values = et_format_parallax_bg_wrap_radius_values( $border_radius_hover_values );
} else {
$radius_hover_values = $border_radius_values['desktop'];
}
if ( $radius_hover_values ) {
$el_style = array(
'selector' => $order_class . ':hover .et_parallax_bg_wrap',
'declaration' => esc_html(
sprintf(
'border-radius: %1$s;',
$radius_hover_values
)
),
);
ET_Builder_Element::set_style( $module, $el_style );
}
}
endif;
if ( ! function_exists( 'et_format_parallax_bg_wrap_radius_values' ) ) :
/**
* Get formatted border radius of parallax background wrapper
*
* @since 4.4.8
*
* @param string $border_radius_values border radius values.
*
* @return string
*/
function et_format_parallax_bg_wrap_radius_values( $border_radius_values ) {
$radius_values = array();
$radius_array = explode( '|', $border_radius_values );
$radius_count = count( $radius_array );
for ( $i = 1; $i < $radius_count; $i++ ) {
$radius_values[] = $radius_array[ $i ] ? $radius_array[ $i ] : 0;
}
return trim( implode( ' ', $radius_values ) );
}
endif;
if ( ! function_exists( 'et_builder_generate_css' ) ) {
/**
* Generate CSS.
*
* @param array $args Styles arg.
*
* @return string|void
*/
function et_builder_generate_css( $args ) {
$defaults = array(
'prefix' => '',
'suffix' => '',
);
$args = wp_parse_args( $args, $defaults );
/*
* Bail early if we have no $selector elements or properties and $value.
*/
if ( ! $args['value'] || ! $args['selector'] ) {
return;
}
return sprintf( '%s { %s: %s; }', $args['selector'], $args['style'], $args['prefix'] . $args['value'] . $args['suffix'] );
}
}
if ( ! function_exists( 'et_builder_generate_css_style' ) ) {
/**
* Generate CSS property.
*
* @param array $args Styles arg.
*
* @return string|void
*/
function et_builder_generate_css_style( $args ) {
$defaults = array(
'prefix' => '',
'suffix' => '',
);
$args = wp_parse_args( $args, $defaults );
/*
* Bail early if we have no style and $value.
*/
if ( ! $args['value'] || ! $args['style'] ) {
return;
}
return sprintf( '%s: %s;', $args['style'], $args['prefix'] . $args['value'] . $args['suffix'] );
}
}
if ( ! function_exists( 'et_builder_default_colors_ajax_update_handler' ) ) :
/**
* Default colors AJAX update handler.
*
* @since 4.9.0
*/
function et_builder_default_colors_ajax_update_handler() {
// Get nonce from $_POST.
$nonce = isset( $_POST['et_builder_default_colors_nonce'] ) ? sanitize_text_field( $_POST['et_builder_default_colors_nonce'] ) : '';
if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'et_builder_default_colors_update' ) ) {
wp_send_json_error();
}
if ( ! current_user_can( 'edit_posts' ) ) {
wp_send_json_error();
}
// Get default_colors from $_POST.
$default_colors = isset( $_POST['default_colors'] ) ? sanitize_text_field( wp_unslash( $_POST['default_colors'] ) ) : '';
et_update_option( 'divi_color_palette', str_replace( ',', '|', $default_colors ) );
wp_send_json_success();
}
endif;
add_action( 'wp_ajax_et_builder_default_colors_update', 'et_builder_default_colors_ajax_update_handler' );
if ( ! function_exists( 'et_builder_global_colors_ajax_save_handler' ) ) :
/**
* Global colors AJAX save handler.
*
* @since 4.9.0
*/
function et_builder_global_colors_ajax_save_handler() {
// Get nonce from $_POST.
$nonce = isset( $_POST['et_builder_global_colors_save_nonce'] ) ? sanitize_text_field( $_POST['et_builder_global_colors_save_nonce'] ) : '';
if ( empty( $nonce ) || ! wp_verify_nonce( $nonce, 'et_builder_global_colors_save' ) ) {
wp_send_json_error();
}
if ( ! current_user_can( 'edit_posts' ) ) {
wp_send_json_error();
}
// Get colors from $_POST.
$post_colors = filter_input( INPUT_POST, 'global_colors', FILTER_DEFAULT, FILTER_REQUIRE_ARRAY );
$global_colors = array();
if ( is_array( $post_colors ) ) {
foreach ( $post_colors as $data_id => $data ) {
// Drop bad data.
if ( 'undefined' === $data_id || empty( $data ) ) {
continue;
}
// Sanitize data_id (e.g: gcid-3330f0vf7 ).
$global_id = sanitize_text_field( $data_id );
foreach ( $data as $type => $value ) {
// Sanitize both type (e.g: color, active) and value (color value, yes/no).
$global_colors[ $global_id ][ sanitize_text_field( $type ) ] = sanitize_text_field( $value );
}
}
}
if ( empty( $global_colors ) ) {
wp_send_json_error();
}
/**
* Fires after global colors are processed.
*
* @since 4.25.0
*/
do_action( 'et_global_colors_saved', $global_colors );
// Do not save customizer colors into Global Colors setting.
$excluded_keys = [
'gcid-primary-color',
'gcid-secondary-color',
'gcid-heading-color',
'gcid-body-color',
];
foreach ( $excluded_keys as $excluded_key ) {
unset( $global_colors[ $excluded_key ] );
}
// Global Color data has been sanitized above.
et_update_option( 'et_global_colors', $global_colors );
ET_Core_PageResource::remove_static_resources( 'all', 'all' );
wp_send_json_success();
}
endif;
add_action( 'wp_ajax_et_builder_global_colors_save', 'et_builder_global_colors_ajax_save_handler' );
if ( ! function_exists( 'et_builder_global_colors_ajax_get_handler' ) ) :
/**
* Global colors AJAX get handler.
*
* @since 4.19.2
*/
function et_builder_global_colors_ajax_get_handler() {
// Get nonce from $_GET.
et_core_security_check( 'edit_posts', 'et_builder_global_colors_get', 'et_builder_global_colors_get_nonce', '_GET' );
wp_send_json_success( [ 'global_colors' => et_builder_get_all_global_colors( true ) ] );
}
endif;
add_action( 'wp_ajax_et_builder_global_colors_get', 'et_builder_global_colors_ajax_get_handler' );
/**
* Get a global color info by id.
*
* @since 4.9.0
*
* @param string $color_id Id of global color.
*
* @return array
*/
function et_builder_get_global_color_info( $color_id ) {
$colors = et_builder_get_all_global_colors( true );
if ( empty( $colors ) || ! array_key_exists( $color_id, $colors ) ) {
return null;
}
// if replaced value exists, return color info with that replaced id.
if ( isset( $colors[ $color_id ]['replaced_with'] ) ) {
$replaced_id = $colors[ $color_id ]['replaced_with'];
return $colors[ $replaced_id ];
}
return $colors[ $color_id ];
}
/**
* Check if given value is a Global Color Id.
*
* @since 4.21.1
*
* @param string $attr_value Color value.
* @return bool
*/
function et_builder_is_global_color( $attr_value ) {
return 0 === strpos( $attr_value, 'gcid-' );
}
/**
* Get Global Color by Color Id.
*
* @since 4.21.1
*
* @param string $color_id Color ID.
* @return string
*/
function et_builder_get_global_color( $color_id ) {
$color_info = et_builder_get_global_color_info( $color_id );
return isset( $color_info['color'] ) ? $color_info['color'] : $color_id;
}
/**
* Checks if overflow CSS property should be set or not.
*
* @since 4.17.4
*
* @param bool|string $overflow_enabled If overflow is enabled (true) or disabled (false) or -x or -y.
* @param string $function_name Module slug.
* @param ET_Builder_Element $module Module object.
*
* @return bool|string
*/
function et_process_border_radii_options_overflow( $overflow_enabled, $function_name, $module ) {
if ( in_array( $function_name, [ 'et_pb_section', 'et_pb_row' ], true ) &&
ET_Builder_Element::module_contains( $module->_original_content, [ 'et_pb_menu', 'et_pb_fullwidth_menu' ] ) ) {
$overflow_enabled = false;
}
return $overflow_enabled;
}
add_filter( 'et_builder_process_advanced_borders_options_radii_overflow_enabled', 'et_process_border_radii_options_overflow', 10, 3 );
/**
* Adds `fitvidsignore` class to vimeo videos parent tags which have unusual aspect ratios.
*
* WordPress adds extra `div` tag as a parent on vimeo videos with unusual aspect ratios so
* videos would have proper aspect ratio responsively. That causes issues with jQuery `fitvids()`.
* Ref: https://github.com/elegantthemes/Divi/issues/16116
*
* @since 4.17.5
*/
add_filter(
'oembed_dataparse',
function( $html, $data ) {
if ( ! class_exists( 'DOMDocument' ) ) {
return $html;
}
if ( 'Vimeo' !== $data->provider_name ) {
return $html;
}
$doc = new DOMDocument();
$doc_load_html_state = $doc->loadHTML( $html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD );
if ( false === $doc_load_html_state ) {
return $html;
}
$extra_div_nodes = $doc->getElementsByTagName( 'div' );
if ( 0 === $extra_div_nodes->length ) {
return $html;
}
$extra_div_node = $extra_div_nodes[0];
$extra_div_node->setAttribute( 'class', 'fitvidsignore' );
$output = $doc->saveHTML();
$output = false === $output ? $html : $output;
return $output;
},
10,
2
);
if ( ! function_exists( 'et_pb_get_youtube_url_regex' ) ) :
/**
* Regex to match a YouTube URL from any known/common YouTube URL format.
*
* Expected YouTube URL Formats.
* - https://www.youtube.com/watch?v=XXXX.
* - https://www.youtube.com/embed/XXXX.
* - https://youtu.be/XXXX.
*
* To check regex, see: https://regex101.com/r/4FbeMZ/1.
*
* @since 4.18.1
*
* @return string YouTube video URL regex.
*/
function et_pb_get_youtube_url_regex() {
return '/^(?:https?:\/\/)?(?:m\.|www\.)?(?:youtu\.be\/|youtube\.com\/(?:embed\/|v\/|watch\?v=|watch\?.+&v=))((\w|-){11})(?:\S+)?$/i';
}
endif;
if ( ! function_exists( 'et_pb_normalize_youtube_url' ) ) :
/**
* Normalize a YouTube URL from any known/common YouTube URL format.
*
* Convert YouTube URL into normalized form: https://www.youtube.com/watch?v=XXXX.
* For https://www.youtube.com/watch?v=XXXX to check regex is https://regex101.com/r/B2qLJy/1.
* For https://www.youtube.com/embed/XXXX to check regex is https://regex101.com/r/oZ3iNP/1.
* For https://youtu.be/XXXX to check regex is https://regex101.com/r/5nqmhF/1.
*
* @param string $url youtube video url.
*
* @since 4.18.1
*
* @return string Normalized YouTube URL.
*/
function et_pb_normalize_youtube_url( $url ) {
preg_match( et_pb_get_youtube_url_regex(), esc_url( $url ), $youtube_embed_video );
return 'https://www.youtube.com/watch?v=' . $youtube_embed_video[1];
}
endif;
if ( ! function_exists( 'et_pb_validate_youtube_url' ) ) :
/**
* Validate a YouTube URL from any known/common YouTube URL format.
*
* For https://www.youtube.com/watch?v=XXXX to check regex is https://regex101.com/r/B2qLJy/1.
* For https://www.youtube.com/embed/XXXX to check regex is https://regex101.com/r/oZ3iNP/1.
* For https://youtu.be/XXXX to check regex is https://regex101.com/r/5nqmhF/1.
*
* @param string $url youtube video url.
*
* @since 4.18.1
*
* @return bool Whether provided URL is a valid YouTube URL or not.
*/
function et_pb_validate_youtube_url( $url ) {
preg_match( et_pb_get_youtube_url_regex(), $url, $youtube_embed_video );
return is_array( $youtube_embed_video ) && ! empty( $youtube_embed_video );
}
endif;
if ( ! function_exists( 'et_update_customizer_colors' ) ) :
/**
* Update customizer colors.
*
* @param array $global_colors Global colors.
*
* @since 4.25.0
*
* @return void
*/
function et_update_customizer_colors( $global_colors ) {
$primary_color = isset( $global_colors['gcid-primary-color']['color'] )
? $global_colors['gcid-primary-color']['color']
: '';
$secondary_color = isset( $global_colors['gcid-secondary-color']['color'] )
? $global_colors['gcid-secondary-color']['color']
: '';
$heading_color = isset( $global_colors['gcid-header-color']['color'] )
? $global_colors['gcid-header-color']['color']
: '';
$body_color = isset( $global_colors['gcid-font-color']['color'] )
? $global_colors['gcid-font-color']['color']
: '';
if ( ! empty( $primary_color ) ) {
et_update_option( 'accent_color', $primary_color );
}
if ( ! empty( $secondary_color ) ) {
et_update_option( 'secondary_accent_color', $secondary_color );
}
if ( ! empty( $heading_color ) ) {
et_update_option( 'header_color', $heading_color );
}
if ( ! empty( $body_color ) ) {
et_update_option( 'font_color', $body_color );
}
}
endif;
add_action( 'et_global_colors_saved', 'et_update_customizer_colors' );
/**
* Ajax Callback :: Update cusomizer fonts.
*/
function et_update_customizer_fonts() {
if ( ! isset( $_POST['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( $_POST['nonce'] ), 'et_pb_save_customizer_fonts_nonce' ) ) {
die( -1 );
}
if ( ! current_user_can( 'edit_theme_options' ) ) {
die( -1 );
}
$new_heading_font = isset( $_POST['et_pb_heading_font'] ) ? sanitize_text_field( $_POST['et_pb_heading_font'] ) : '';
$new_body_font = isset( $_POST['et_pb_body_font'] ) ? sanitize_text_field( $_POST['et_pb_body_font'] ) : '';
if ( $new_heading_font ) {
et_update_option( 'heading_font', $new_heading_font );
}
if ( $new_body_font ) {
et_update_option( 'body_font', $new_body_font );
}
}
add_action( 'wp_ajax_et_update_customizer_fonts', 'et_update_customizer_fonts' );
WP"` and causes
* the whole input text value to be disappeared
*
* @return void
*/
function et_pb_remove_emoji_detection_script() {
// phpcs:disable WordPress.Security.NonceVerification -- This function does not change any state, and is therefore not susceptible to CSRF.
global $pagenow;
$disable_emoji_detection = false;
// Disable emoji detection script on editing page which has Backend Builder
// global $post isn't available at admin_init, so retrieve $post data manually.
if ( 'post.php' === $pagenow && isset( $_GET['post'] ) ) {
$post_id = (int) $_GET['post'];
$post = get_post( $post_id );
if ( is_a( $post, 'WP_POST' ) && et_builder_enabled_for_post( $post->ID ) ) {
$disable_emoji_detection = true;
}
}
// Disable emoji detection script on post new page which has Backend Builder.
$has_post_type_query = isset( $_GET['post_type'] );
if ( 'post-new.php' === $pagenow && ( ! $has_post_type_query || ( $has_post_type_query && in_array( $_GET['post_type'], et_builder_get_builder_post_types(), true ) ) ) ) {
$disable_emoji_detection = true;
}
if ( $disable_emoji_detection ) {
remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
}
// phpcs:enable
}
add_action( 'admin_init', 'et_pb_remove_emoji_detection_script' );
/**
* Disable emoji detection script on visual builder
* WordPress automatically replaces emoji with plain image for backward compatibility
* on older browsers. This causes issue when emoji is used on header or other input
* text field because the staticize emoji creates HTML markup which appears to be
* invalid on input[type="text"] field such as `title="I