File Editor
Directories:
.. (Back)
ai-app
cloud
common
core
css
dashboard
images
includes
js
lang
theme-compat
Files:
changelog.txt
divi-builder.php
functions.php
theme-compat.php
Create New File
Create
Edit File: functions.php
<?php /** * Gets option value from the single theme option, stored as an array in the database * if all options stored in one row. * Stores the serialized array with theme options into the global variable on the first function run on the page. * * If options are stored as separate rows in database, it simply uses get_option() function. * * @param string $option_name Theme option name. * @param string $default_value Default value that should be set if the theme option isn't set. * @param string $used_for_object "Object" name that should be translated into corresponding "object" if WPML is activated. * @return mixed Theme option value or false if not found. */ if ( ! function_exists( 'et_get_option' ) ) : /** * Gets option value from the single theme option, stored as an array in the database * if all options stored in one row. * Stores the serialized array with theme options into the global variable on the first function run on the page. * * If options are stored as separate rows in database, it simply uses get_option() function. * * @param string $option_name Theme option name. * @param string $default_value Default value that should be set if the theme option isn't set. * @param string $used_for_object "Object" name that should be translated into corresponding "object" if WPML is activated. * @param bool $force_default_value Is return provided default. * @param bool $is_global_setting Is Global Setting. * @param string $global_setting_main_name Global Setting name. * @param string $global_setting_sub_name Global Setting sub name. * @param bool $is_product_setting Product setting flag. * @return mixed Theme option value or false if not found. */ function et_get_option( $option_name, $default_value = '', $used_for_object = '', $force_default_value = false, $is_global_setting = false, $global_setting_main_name = '', $global_setting_sub_name = '', $is_product_setting = false ) { global $et_divi_builder_plugin_options; $shortname = 'divi_builder_plugin'; if ( $is_product_setting ) { $et_product_setting_name = 'et_' . $shortname . '_' . $option_name; $option_value = $force_default_value ? get_option( $et_product_setting_name, $default_value ) : get_option( $et_product_setting_name ); } else { $et_theme_options_name = 'et_' . $shortname; if ( ! isset( $et_divi_builder_plugin_options ) ) { $et_divi_builder_plugin_options = get_option( $et_theme_options_name ); } $option_value = isset( $et_divi_builder_plugin_options[ $option_name ] ) ? $et_divi_builder_plugin_options[ $option_name ] : false; // option value might be equal to false, so check if the option is not set in the database. if ( ! isset( $et_divi_builder_plugin_options[ $option_name ] ) && ( '' !== $default_value || $force_default_value ) ) { $option_value = $default_value; } } if ( '' !== $used_for_object && in_array( $used_for_object, array( 'page', 'category' ), true ) && is_array( $option_value ) ) { $option_value = et_generate_wpml_ids( $option_value, $used_for_object ); } return $option_value; } endif; if ( ! function_exists( 'et_update_option' ) ) : /** * Update option value in theme option, stored as an array in the database * if all options stored in one row. * * If options are stored as separate rows in database, it simply uses update_option() function. * * @param string $option_name Theme option name. * @param string $new_value Theme option value. * @param bool $is_new_global_setting Global setting flag. * @param string $global_setting_main_name Global setting name. * @param string $global_setting_sub_name Global setting sub name. * @param bool $is_product_setting Product setting flag. */ function et_update_option( $option_name, $new_value, $is_new_global_setting = false, $global_setting_main_name = '', $global_setting_sub_name = '', $is_product_setting = false ) { global $et_divi_builder_plugin_options; if ( $is_new_global_setting && '' !== $global_setting_main_name && '' !== $global_setting_sub_name ) { $global_setting = get_option( $global_setting_main_name, array() ); $global_setting[ $global_setting_sub_name ] = $new_value; update_option( $global_setting_main_name, $global_setting ); } elseif ( $is_product_setting ) { $et_product_setting_name = 'et_divi_builder_plugin_' . $option_name; update_option( $et_product_setting_name, $new_value, false ); } else { $shortname = 'divi_builder_plugin'; $et_theme_options_name = 'et_' . $shortname; if ( ! isset( $et_divi_builder_plugin_options ) ) { $et_divi_builder_plugin_options = get_option( $et_theme_options_name ); } $et_divi_builder_plugin_options[ $option_name ] = $new_value; $option_name = $et_theme_options_name; $new_value = $et_divi_builder_plugin_options; update_option( $option_name, $new_value ); } } endif; if ( ! function_exists( 'et_delete_option' ) ) : function et_delete_option( $option_name ){ global $et_divi_builder_plugin_options; $shortname = 'divi_builder_plugin'; $et_theme_options_name = 'et_' . $shortname; if ( ! isset( $et_divi_builder_plugin_options ) ) $et_divi_builder_plugin_options = get_option( $et_theme_options_name ); unset( $et_divi_builder_plugin_options[$option_name] ); update_option( $et_theme_options_name, $et_divi_builder_plugin_options ); } endif; /* this function gets thumbnail from Post Thumbnail or Custom field or First post image */ if ( ! function_exists( 'get_thumbnail' ) ) : function get_thumbnail($width=100, $height=100, $class='', $alttext='', $titletext='', $fullpath=false, $custom_field='', $post='') { if ( $post == '' ) global $post; global $shortname; $thumb_array['thumb'] = ''; $thumb_array['use_timthumb'] = true; if ($fullpath) $thumb_array['fullpath'] = ''; //full image url for lightbox $new_method = true; if ( has_post_thumbnail( $post->ID ) ) { $thumb_array['use_timthumb'] = false; $et_fullpath = wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'full' ); $thumb_array['fullpath'] = $et_fullpath[0]; $thumb_array['thumb'] = $thumb_array['fullpath']; } if ($thumb_array['thumb'] == '') { if ($custom_field == '') $thumb_array['thumb'] = esc_attr( get_post_meta($post->ID, 'Thumbnail', $single = true) ); else { $thumb_array['thumb'] = esc_attr( get_post_meta($post->ID, $custom_field, $single = true) ); if ($thumb_array['thumb'] == '') $thumb_array['thumb'] = esc_attr( get_post_meta($post->ID, 'Thumbnail', $single = true) ); } #if custom field used for small pre-cropped image, open Thumbnail custom field image in lightbox if ($fullpath) { $thumb_array['fullpath'] = $thumb_array['thumb']; if ($custom_field == '') $thumb_array['fullpath'] = apply_filters('et_fullpath', et_path_reltoabs(esc_attr($thumb_array['thumb']))); elseif ( $custom_field <> '' && get_post_meta($post->ID, 'Thumbnail', $single = true) ) $thumb_array['fullpath'] = apply_filters( 'et_fullpath', et_path_reltoabs(esc_attr(get_post_meta($post->ID, 'Thumbnail', $single = true))) ); } } return $thumb_array; } endif; /* this function prints thumbnail from Post Thumbnail or Custom field or First post image */ if ( ! function_exists( 'print_thumbnail' ) ) : function print_thumbnail($thumbnail = '', $use_timthumb = true, $alttext = '', $width = 100, $height = 100, $class = '', $echoout = true, $forstyle = false, $resize = true, $post='', $et_post_id = '' ) { if ( is_array( $thumbnail ) ){ extract( $thumbnail ); } if ( $post == '' ) global $post, $et_theme_image_sizes; $output = ''; $et_post_id = '' != $et_post_id ? (int) $et_post_id : $post->ID; if ( has_post_thumbnail( $et_post_id ) ) { $thumb_array['use_timthumb'] = false; $image_size_name = $width . 'x' . $height; $et_size = isset( $et_theme_image_sizes ) && array_key_exists( $image_size_name, $et_theme_image_sizes ) ? $et_theme_image_sizes[$image_size_name] : array( $width, $height ); $et_attachment_image_attributes = wp_get_attachment_image_src( get_post_thumbnail_id( $et_post_id ), $et_size ); $thumbnail = $et_attachment_image_attributes[0]; } if ( false === $forstyle ) { $output = '<img src="' . esc_url( $thumbnail ) . '"'; if ($class <> '') $output .= " class='" . esc_attr( $class ) . "' "; $dimensions = apply_filters( 'et_print_thumbnail_dimensions', " width='" . esc_attr( $width ) . "' height='" .esc_attr( $height ) . "'" ); $output .= " alt='" . esc_attr( strip_tags( $alttext ) ) . "'{$dimensions} />"; if ( ! $resize ) $output = $thumbnail; } else { $output = $thumbnail; } if ($echoout) echo $output; else return $output; } endif; if ( ! function_exists( 'et_path_reltoabs' ) ) : function et_path_reltoabs( $imageurl ){ if ( strpos(strtolower($imageurl), 'http://') !== false || strpos(strtolower($imageurl), 'https://') !== false ) return $imageurl; if ( strpos( strtolower($imageurl), $_SERVER['HTTP_HOST'] ) !== false ) return $imageurl; else { $imageurl = esc_url( apply_filters( 'et_path_relative_image', site_url() . '/' ) . $imageurl ); } return $imageurl; } endif; /*this function allows for the auto-creation of post excerpts*/ if ( ! function_exists( 'truncate_post' ) ) : function truncate_post( $amount, $echo = true, $post = '' ) { if ( '' == $post ) { global $post; } if ( post_password_required( $post ) ) { $post_excerpt = get_the_password_form(); if ( $echo ) { echo $post_excerpt; return; } return $post_excerpt; } $post_excerpt = apply_filters( 'the_excerpt', $post->post_excerpt ); // get the post content $truncate = $post->post_content; // remove caption shortcode from the post content $truncate = preg_replace('@\[caption[^\]]*?\].*?\[\/caption]@si', '', $truncate); /** * Filter automatically generated post excerpt before it gets truncated. * * @since 2.17 * * @param string $excerpt * @param integer $post_id */ $truncate = apply_filters( 'et_truncate_post', $truncate, $post->ID ); // apply content filters $truncate = apply_filters( 'the_content', $truncate ); // decide if we need to append dots at the end of the string if ( strlen( $truncate ) <= $amount ) { $echo_out = ''; } else { $echo_out = '...'; // $amount = $amount - 3; } // trim text to a certain number of characters, also remove spaces from the end of a string ( space counts as a character ) $truncate = rtrim( et_wp_trim_words( $truncate, $amount, '' ) ); // remove the last word to make sure we display all words correctly if ( '' != $echo_out ) { $new_words_array = (array) explode( ' ', $truncate ); array_pop( $new_words_array ); $truncate = implode( ' ', $new_words_array ); // append dots to the end of the string $truncate .= $echo_out; } if ( $echo ) { echo $truncate; } else { return $truncate; } } endif; if ( ! function_exists( 'et_wp_trim_words' ) ) : function et_wp_trim_words( $text, $num_words = 55, $more = null ) { if ( null === $more ) $more = esc_html__( '…' ); $original_text = $text; $text = wp_strip_all_tags( $text ); $text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' ); preg_match_all( '/./u', $text, $words_array ); $words_array = array_slice( $words_array[0], 0, $num_words + 1 ); $sep = ''; if ( count( $words_array ) > $num_words ) { array_pop( $words_array ); $text = implode( $sep, $words_array ); $text = $text . $more; } else { $text = implode( $sep, $words_array ); } return apply_filters( 'wp_trim_words', $text, $num_words, $more, $original_text ); } endif; if ( ! function_exists( 'et_get_safe_localization' ) ) : function et_get_safe_localization( $string ) { return wp_kses( $string, et_get_allowed_localization_html_elements() ); } endif; if ( ! function_exists( 'et_get_allowed_localization_html_elements' ) ) : function et_get_allowed_localization_html_elements() { $allowlisted_attributes = array( 'id' => array(), 'class' => array(), 'style' => array(), ); $elements = array( 'a' => array( 'href' => array(), 'title' => array(), 'target' => array(), ), 'b' => array(), 'em' => array(), 'p' => array(), 'span' => array(), 'div' => array(), 'strong' => array(), ); foreach ( $elements as $tag => $attributes ) { $elements[ $tag ] = array_merge( $attributes, $allowlisted_attributes ); } return $elements; } endif; if ( ! function_exists( 'et_sanitize_alpha_color' ) ) : /** * Sanitize RGBA color * @param string * @return string|bool */ function et_sanitize_alpha_color( $color ) { // Trim unneeded whitespace $color = str_replace( ' ', '', $color ); // If this is hex color, validate and return it if ( 1 === preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) { return $color; } // If this is rgb, validate and return it elseif ( 'rgb(' === substr( $color, 0, 4 ) ) { sscanf( $color, 'rgb(%d,%d,%d)', $red, $green, $blue ); if ( ( $red >= 0 && $red <= 255 ) && ( $green >= 0 && $green <= 255 ) && ( $blue >= 0 && $blue <= 255 ) ) { return "rgb({$red},{$green},{$blue})"; } } // If this is rgba, validate and return it elseif ( 'rgba(' === substr( $color, 0, 5 ) ) { sscanf( $color, 'rgba(%d,%d,%d,%f)', $red, $green, $blue, $alpha ); if ( ( $red >= 0 && $red <= 255 ) && ( $green >= 0 && $green <= 255 ) && ( $blue >= 0 && $blue <= 255 ) && $alpha >= 0 && $alpha <= 1 ) { return "rgba({$red},{$green},{$blue},{$alpha})"; } } return false; } endif; if ( ! function_exists( 'et_pb_get_google_api_key' ) ) : function et_pb_get_google_api_key() { $google_api_option = get_option( 'et_google_api_settings' ); $google_api_key = isset( $google_api_option['api_key'] ) ? $google_api_option['api_key'] : ''; return $google_api_key; } endif; if ( function_exists( 'woocommerce_get_product_thumbnail' ) ) { add_action( 'et_pb_shop_before_print_shop', 'et_divi_builder_add_shop_thumbnail' ); // Include Overlay in Related Products when using DBP since it is not included by default. remove_action( 'woocommerce_before_shop_loop_item_title', 'woocommerce_template_loop_product_thumbnail', 10 ); add_action( 'woocommerce_before_shop_loop_item_title', 'et_divi_builder_template_loop_product_thumbnail' ); /** * Remove WooCommerce's default product thumbnail on shop module and add Divi's product thumbnail */ function et_divi_builder_add_shop_thumbnail() { global $wp_filter; $item_title_hook = isset( $wp_filter['woocommerce_before_shop_loop_item_title'] ) ? $wp_filter['woocommerce_before_shop_loop_item_title'] : false; // If default product thumbnail is registered, deregister and register Divi's product thumbnail // Theme which has modified WooCommerce's product thumbnail should be modified via theme compatibility file if ( isset( $item_title_hook ) && isset( $item_title_hook[10] ) && isset( $item_title_hook[10]['woocommerce_template_loop_product_thumbnail'] ) ) { remove_action( 'woocommerce_before_shop_loop_item_title', 'woocommerce_template_loop_product_thumbnail' ); add_action( 'woocommerce_before_shop_loop_item_title', 'et_divi_builder_template_loop_product_thumbnail', 10 ); } } function et_divi_builder_template_loop_product_thumbnail() { printf( '<span class="et_shop_image">%1$s<span class="et_overlay"></span></span>', woocommerce_get_product_thumbnail() ); } } /** * Modify toggle module options * @param array $options default toggle module option * @param string $slug module slug * @param string $main_css_element main css selector * @return array modified option */ function et_divi_builder_fix_toggle_advanced_options( $options, $slug, $main_css_element ) { $options['fonts']['body']['css']['letter_spacing'] = "{$main_css_element} *"; return $options; } add_filter( 'et_pb_toggle_advanced_options', 'et_divi_builder_fix_toggle_advanced_options', 10, 3 ); /** * Append the current theme name to the body class */ if ( ! function_exists( 'et_pb_append_theme_class' ) ) : function et_pb_append_theme_class( $body_class ) { $theme_data = wp_get_theme(); if ( empty( $theme_data ) || '' === $theme_data->Name ) { return $body_class; } $body_class[] = sprintf( 'et-pb-theme-%1$s', strtolower( esc_attr( $theme_data->Name ) ) ); return $body_class; } endif; add_filter( 'body_class', 'et_pb_append_theme_class' ); /** * DBP implementation for BFB enabled check. * * @since 2.18 * * @return bool */ function dbp_filter_bfb_enabled() { global $pagenow; $bfb_settings = get_option( 'et_bfb_settings' ); $enabled = isset( $bfb_settings['enable_bfb'] ) && 'on' === $bfb_settings['enable_bfb']; if ( is_admin() && ! in_array( $pagenow, array( 'post.php', 'post-new.php', 'admin-ajax.php' ) ) ) { $enabled = false; } else if ( ! is_admin() && ! isset( $_GET['et_bfb'] ) ) { $enabled = false; } return $enabled; } add_filter( 'et_builder_bfb_enabled', 'dbp_filter_bfb_enabled' ); /** * DBP implementation for fresh install check. * * @since 2.18 * * @return bool */ function dbp_filter_is_fresh_install() { $options = get_option( 'et_pb_builder_options', array() ); return empty( $options ); } add_filter( 'et_builder_is_fresh_install', 'dbp_filter_is_fresh_install' ); /** * DBP implementation for BFB toggle. * * @since 2.18 * * @param bool $enable * * @return void */ function dbp_action_toggle_bfb( $enable ) { $bfb_value = $enable ? 'on' : 'off'; et_update_option( '', $bfb_value, true, 'et_bfb_settings', 'enable_bfb' ); } add_action( 'et_builder_toggle_bfb', 'dbp_action_toggle_bfb' ); /** * Filter the list of post types the Divi Builder is enabled on based on plugin options. * * @since 2.10 * * @param array<string, string> $options * * @return array<string, string> */ if ( ! function_exists( 'et_divi_builder_filter_enabled_builder_post_type_options' ) ) : function et_divi_builder_filter_enabled_builder_post_type_options( $options ) { // Cache results to avoid unnecessary option fetching multiple times per request. static $stored_options = null; if ( null === $stored_options ) { $stored_options = et_get_option( 'et_pb_post_type_integration', array() ); } return $stored_options; } endif; add_filter( 'et_builder_enabled_builder_post_type_options', 'et_divi_builder_filter_enabled_builder_post_type_options' ); /** * Check if posts of given wp_query has builder or not. This check is optimized for speed and not * accuracy so as long as one of the post contains `[et_pb_section`, this check will consider it * use builder * * @since ?? * * @param WP_Query $wp_query * * @return bool */ function et_dbp_is_query_has_builder( $wp_query ) { // Cache result static $et_dbp_is_query_has_builder = array(); // No posts found, return early. Can't use have_posts() here because it causes infinite loop if ( empty( $wp_query->posts ) ) { return false; } // Populate ids of current wp_query $ids = implode( '-', wp_list_pluck( $wp_query->posts, 'ID' ) ); // This search has been done before; return from static var if ( isset( $et_dbp_is_query_has_builder[ $ids ] ) ) { return $et_dbp_is_query_has_builder[ $ids ]; } // Loop posts, and look for section module shortcode's substring $has = false; foreach ( $wp_query->posts as $post ) { if ( false !== strpos( $post->post_content, '[et_pb_section' ) ) { $has = true; // If have been found, no need to look further break; } } // Save result on static var to speed up next search $et_dbp_is_query_has_builder[ $ids ] = $has; return $has; } /** * Check if posts on given wp_query needs to be wrapped so the styling is correctly assigned * Singular page's wrapper has been correctly assigned by builder; what hasn't been correctly * assigned is non-singular posts query * * @since ?? * * @param WP_Query $wp_query * * @return bool */ function et_dbp_should_wrap_content_has_builder( $wp_query ) { // Do not wrap if not main query, is singular, no section shortcode found on posts content $do_not_wrap = ! is_main_query() || is_singular() || ! et_dbp_is_query_has_builder( $wp_query ); return ! $do_not_wrap; } /** * Wrap main loop of non singular page if one of the post has builder content * * @since ?? * * @param WP_Query $wp_query */ function et_dbp_main_loop_start( $wp_query ) { // If TB's template already used, no need to wrap loops since the entire page is already wrapped $override_header = et_theme_builder_overrides_layout( ET_THEME_BUILDER_HEADER_LAYOUT_POST_TYPE ); $override_body = et_theme_builder_overrides_layout( ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ); $override_footer = et_theme_builder_overrides_layout( ET_THEME_BUILDER_FOOTER_LAYOUT_POST_TYPE ); if ( $override_header || $override_body || $override_footer ) { return; } if ( ! et_dbp_should_wrap_content_has_builder( $wp_query ) ) { return; } if ( wp_doing_ajax() || is_admin() || is_feed() ) { return; } echo et_builder_get_builder_content_opening_wrapper(); } add_action( 'loop_start', 'et_dbp_main_loop_start'); /** * (close) Wrap main loop of non singular page if one of the post has builder content * * @since ?? * * @param WP_Query $wp_query */ function et_dbp_main_loop_end( $wp_query ) { // If TB's template already used, no need to wrap loops since the entire page is already wrapped $override_header = et_theme_builder_overrides_layout( ET_THEME_BUILDER_HEADER_LAYOUT_POST_TYPE ); $override_body = et_theme_builder_overrides_layout( ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ); $override_footer = et_theme_builder_overrides_layout( ET_THEME_BUILDER_FOOTER_LAYOUT_POST_TYPE ); if ( $override_header || $override_body || $override_footer ) { return; } if ( ! et_dbp_should_wrap_content_has_builder( $wp_query ) ) { return; } if ( wp_doing_ajax() || is_admin() || is_feed() ) { return; } echo et_builder_get_builder_content_closing_wrapper(); } add_action( 'loop_end', 'et_dbp_main_loop_end'); /** * Wrap the content of non singular page with layout wrapper if one of the post has builder content. * NOTE: layout content wrapper can't be added righ after builder wrapper because it might affect * main loops' content such as post title, etc * * @since ?? * * @param string $content * * @return string modified content */ function et_dbp_main_loop_content( $content ) { global $wp_query; if ( ! et_dbp_should_wrap_content_has_builder( $wp_query ) ) { return $content; } return et_builder_get_layout_opening_wrapper() . $content . et_builder_get_layout_closing_wrapper(); } add_filter( 'the_content', 'et_dbp_main_loop_content' );
Save Changes
Rename File
Rename