File Editor
Directories:
.. (Back)
admin
components
languages
Files:
_et_core_version.php
_metadata.php
functions.php
init.php
updates_init.php
wp_functions.php
Create New File
Create
Edit File: functions.php
<?php if ( ! function_exists( 'et_allow_ampersand' ) ) : /** * Convert & into & * Escaped ampersand by wp_kses() which is used by et_get_safe_localization() * can be a troublesome in some cases, ie.: when string is sent in an email. * * @param string $string original string * * @return string modified string */ function et_allow_ampersand( $string ) { return str_replace('&', '&', $string); } endif; if ( ! function_exists( 'et_core_autoloader' ) ): /** * Callback for {@link spl_autoload_register()}. * * @param $class_name */ function et_core_autoloader( $class_name ) { if ( 0 !== strpos( $class_name, 'ET_Core' ) ) { return; } static $components = null; static $groups_loaded = array(); if ( null === $components ) { $components = et_core_get_components_metadata(); } if ( ! isset( $components[ $class_name ] ) ) { return; } $file = ET_CORE_PATH . $components[ $class_name ]['file']; $groups = $components[ $class_name ]['groups']; $slug = $components[ $class_name ]['slug']; if ( ! file_exists( $file ) ) { return; } // Load component class require_once $file; /** * Fires when a Core Component is loaded. * * The dynamic portion of the hook name, $slug, refers to the slug of the Core Component that was loaded. * * @since 1.0.0 */ do_action( "et_core_component_{$slug}_loaded" ); if ( empty( $groups ) ) { return; } foreach( $groups as $group_name ) { if ( in_array( $group_name, $groups_loaded ) ) { continue; } $groups_loaded[] = $group_name; $slug = $components['groups'][ $group_name ]['slug']; $init_file = $components['groups'][ $group_name ]['init']; $init_file = empty( $init_file ) ? null : ET_CORE_PATH . $init_file; et_core_initialize_component_group( $slug, $init_file ); } } endif; if ( ! function_exists( 'et_core_clear_transients' ) ): function et_core_clear_transients() { delete_site_transient( 'et_core_path' ); delete_site_transient( 'et_core_version' ); delete_site_transient( 'et_core_needs_old_theme_patch' ); } add_action( 'upgrader_process_complete', 'et_core_clear_transients', 10, 0 ); add_action( 'switch_theme', 'et_core_clear_transients' ); add_action( 'update_option_active_plugins', 'et_core_clear_transients', 10, 0 ); add_action( 'update_site_option_active_plugins', 'et_core_clear_transients', 10, 0 ); endif; if ( ! function_exists( 'et_core_cron_schedules_cb' ) ): function et_core_cron_schedules_cb( $schedules ) { if ( isset( $schedules['monthly'] ) ) { return $schedules; } $schedules['monthly'] = array( 'interval' => MONTH_IN_SECONDS, 'display' => __( 'Once Monthly' ) ); return $schedules; } add_action( 'cron_schedules', 'et_core_cron_schedules_cb' ); endif; if ( ! function_exists( 'et_core_die' ) ): function et_core_die( $message = '' ) { if ( wp_doing_ajax() ) { $message = '' !== $message ? $message : esc_html__( 'Configuration Error', 'et_core' ); wp_send_json_error( array( 'error' => $message ) ); } die(-1); } endif; if ( ! function_exists( 'et_core_get_components_metadata' ) ): function et_core_get_components_metadata() { static $metadata = null; if ( null === $metadata ) { require_once '_metadata.php'; $metadata = json_decode( $metadata, true ); } return $metadata; } endif; if ( ! function_exists( 'et_core_get_component_names' ) ): /** * Returns the names of all available components, optionally filtered by type and/or group. * * @param string $include The type of components to include (official|third-party|all). Default is 'official'. * @param string $group Only include components in $group. Optional. * * @return array */ function et_core_get_component_names( $include = 'official', $group = '' ) { static $official_components = null; if ( null === $official_components ) { $official_components = et_core_get_components_metadata(); } if ( 'official' === $include ) { return empty( $group ) ? $official_components['names'] : $official_components['groups'][ $group ]['members']; } $third_party_components = et_core_get_third_party_components(); if ( 'third-party' === $include ) { return array_keys( $third_party_components ); } return array_merge( array_keys( $third_party_components ), empty( $group ) ? $official_components['names'] : $official_components['groups'][ $group ]['members'] ); } endif; if ( ! function_exists( 'et_core_get_ip_address' ) ): /** * Returns the IP address of the client that initiated the current HTTP request. * * @return string */ function et_core_get_ip_address() { if ( ! empty( $_SERVER['HTTP_CLIENT_IP'] ) ) { $ip = $_SERVER['HTTP_CLIENT_IP']; } else if ( ! empty( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) { $ip = $_SERVER['HTTP_X_FORWARDED_FOR']; } else { $ip = $_SERVER['REMOTE_ADDR']; } return sanitize_text_field( $ip ); } endif; if ( ! function_exists( 'et_core_use_google_fonts' ) ) : function et_core_use_google_fonts() { $utils = ET_Core_Data_Utils::instance(); $google_api_options = get_option( 'et_google_api_settings' ); return 'on' === $utils->array_get( $google_api_options, 'use_google_fonts', 'on' ); } endif; if ( ! function_exists( 'et_core_get_main_fonts' ) ) : function et_core_get_main_fonts() { global $wp_version; if ( version_compare( $wp_version, '4.6', '<' ) || ( ! is_admin() && ! et_core_use_google_fonts() ) ) { return ''; } $fonts_url = ''; /* Translators: If there are characters in your language that are not * supported by Open Sans, translate this to 'off'. Do not translate * into your own language. */ $open_sans = _x( 'on', 'Open Sans font: on or off', 'Divi' ); if ( 'off' !== $open_sans ) { $font_families = array(); if ( 'off' !== $open_sans ) $font_families[] = 'Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800'; $protocol = is_ssl() ? 'https' : 'http'; $query_args = array( 'family' => implode( '%7C', $font_families ), 'subset' => 'latin,latin-ext', ); $fonts_url = add_query_arg( $query_args, "$protocol://fonts.googleapis.com/css" ); } return $fonts_url; } endif; if ( ! function_exists( 'et_core_get_theme_info' ) ): function et_core_get_theme_info( $key ) { static $theme_info = null; if ( ! $theme_info ) { $theme_info = wp_get_theme(); if ( defined( 'STYLESHEETPATH' ) && is_child_theme() ) { $theme_info = wp_get_theme( $theme_info->parent_theme ); } } return $theme_info->display( $key ); } endif; if ( ! function_exists( 'et_core_get_third_party_components' ) ): function et_core_get_third_party_components( $group = '' ) { static $third_party_components = null; if ( null !== $third_party_components ) { return $third_party_components; } /** * 3rd-party components can be registered by adding the class instance to this array using it's name as the key. * * @since 1.1.0 * * @param array $third_party { * An array mapping third party component names to a class instance reference. * * @type ET_Core_3rdPartyComponent $name The component class instance. * ... * } * @param string $group If not empty, only components classified under this group should be included. */ return $third_party_components = apply_filters( 'et_core_get_third_party_components', array(), $group ); } endif; if ( ! function_exists( 'et_core_get_memory_limit' ) ): /** * Returns the current php memory limit in megabytes as an int. * * @return int */ function et_core_get_memory_limit() { // Do NOT convert value to the integer, because wp_convert_hr_to_bytes() expects raw value from php_ini like 128M, 256M, 512M, etc $limit = @ini_get( 'memory_limit' ); $mb_in_bytes = 1024*1024; $bytes = max( wp_convert_hr_to_bytes( $limit ), $mb_in_bytes ); return ceil( $bytes / $mb_in_bytes ); } endif; if ( ! function_exists( 'et_core_initialize_component_group' ) ): function et_core_initialize_component_group( $slug, $init_file = null ) { $slug = strtolower( $slug ); if ( null !== $init_file && file_exists( $init_file ) ) { // Load and run component group's init function require_once $init_file; $init = "et_core_{$slug}_init"; $init(); } /** * Fires when a Core Component Group is loaded. * * The dynamic portion of the hook name, `$group`, refers to the name of the Core Component Group that was loaded. * * @since 1.0.0 */ do_action( "et_core_{$slug}_loaded" ); } endif; if ( ! function_exists( 'et_core_is_builder_used_on_current_request' ) ) : function et_core_is_builder_used_on_current_request() { static $builder_used = null; if ( null !== $builder_used ) { return $builder_used; } global $wp_query; if ( ! $wp_query ) { ET_Core_Logger::error( 'Called too early! $wp_query is not available.' ); return false; } $builder_used = false; if ( ! empty( $wp_query->posts ) ) { foreach ( $wp_query->posts as $post ) { if ( 'on' === get_post_meta( $post->ID, '_et_pb_use_builder', true ) ) { $builder_used = true; break; } } } else if ( ! empty( $wp_query->post ) ) { if ( 'on' === get_post_meta( $wp_query->post->ID, '_et_pb_use_builder', true ) ) { $builder_used = true; } } return $builder_used = apply_filters( 'et_core_is_builder_used_on_current_request', $builder_used ); } endif; if ( ! function_exists( 'et_core_is_fb_enabled' ) ): function et_core_is_fb_enabled() { return function_exists( 'et_fb_is_enabled' ) && et_fb_is_enabled(); } endif; /** * Is Gutenberg active? * * @since 3.19.2 Renamed from {@see et_is_gutenberg_active()} and moved to core. * @since 3.18 * * @return bool True - if the plugin is active */ if ( ! function_exists( 'et_core_is_gutenberg_active' ) ): function et_core_is_gutenberg_active() { global $wp_version; static $has_wp5_plus = null; if ( is_null( $has_wp5_plus ) ) { $has_wp5_plus = version_compare( $wp_version, '5.0-alpha1', '>=' ); } return $has_wp5_plus || function_exists( 'is_gutenberg_page' ); } endif; /** * Is Gutenberg active and enabled for the current post * WP 5.0 WARNING - don't use before global post has been set * * @since 3.19.2 Renamed from {@see et_is_gutenberg_enabled()} and moved to core. * @since 3.18 * * @return bool True - if the plugin is active and enabled. */ if ( ! function_exists( 'et_core_is_gutenberg_enabled' ) ): function et_core_is_gutenberg_enabled() { if ( function_exists( 'is_gutenberg_page' ) ) { return et_core_is_gutenberg_active() && is_gutenberg_page() && has_filter( 'replace_editor', 'gutenberg_init' ); } return et_core_is_gutenberg_active() && function_exists( 'use_block_editor_for_post' ) && use_block_editor_for_post( null ); } endif; if ( ! function_exists( 'et_core_load_main_fonts' ) ) : function et_core_load_main_fonts() { $fonts_url = et_core_get_main_fonts(); if ( empty( $fonts_url ) ) { return; } wp_enqueue_style( 'et-core-main-fonts', esc_url_raw( $fonts_url ), array(), null ); } endif; if ( ! function_exists( 'et_core_load_main_styles' ) ) : function et_core_load_main_styles( $hook ) { if ( ! in_array( $hook, array( 'post.php', 'post-new.php' ) ) ) { return; } wp_enqueue_style( 'et-core-admin' ); } endif; if ( ! function_exists( 'et_core_maybe_set_updated' ) ): function et_core_maybe_set_updated() { // TODO: Move et_{*}_option() functions to core. $last_core_version = get_option( 'et_core_version', '' ); if ( ET_CORE_VERSION === $last_core_version ) { return; } update_option( 'et_core_version', ET_CORE_VERSION ); define( 'ET_CORE_UPDATED', true ); } endif; if ( ! function_exists( 'et_core_maybe_patch_old_theme' ) ): function et_core_maybe_patch_old_theme() { if ( ! ET_Core_Logger::php_notices_enabled() ) { return; } if ( get_site_transient( 'et_core_needs_old_theme_patch' ) ) { add_action( 'after_setup_theme', 'ET_Core_Logger::disable_php_notices', 9 ); add_action( 'after_setup_theme', 'ET_Core_Logger::enable_php_notices', 11 ); return; } $themes = array( 'Divi' => '3.0.41', 'Extra' => '2.0.40' ); $current_theme = et_core_get_theme_info( 'Name' ); if ( ! in_array( $current_theme, array_keys( $themes ) ) ) { return; } $theme_version = et_core_get_theme_info( 'Version' ); if ( version_compare( $theme_version, $themes[ $current_theme ], '<' ) ) { add_action( 'after_setup_theme', 'ET_Core_Logger::disable_php_notices', 9 ); add_action( 'after_setup_theme', 'ET_Core_Logger::enable_php_notices', 11 ); set_site_transient( 'et_core_needs_old_theme_patch', true, DAY_IN_SECONDS ); } } endif; if ( ! function_exists( 'et_core_patch_core_3061' ) ): function et_core_patch_core_3061() { if ( '3.0.61' !== ET_CORE_VERSION ) { return; } if ( ! ET_Core_PageResource::can_write_to_filesystem() ) { return; // Should we display a notice in the dashboard? } $old_file = ET_CORE_PATH . 'init.php'; $new_file = dirname( __FILE__ ) . '/init.php'; ET_Core_PageResource::startup(); if ( ! ET_Core_PageResource::$wpfs ) { return; } ET_Core_PageResource::$wpfs->copy( $new_file, $old_file, true, 0644 ); et_core_clear_transients(); } endif; if ( ! function_exists( 'et_core_register_admin_assets' ) ) : /** * Register Core admin assets. * * @since 1.0.0 * * @private */ function et_core_register_admin_assets() { wp_register_style( 'et-core-admin', ET_CORE_URL . 'admin/css/core.css', array(), ET_CORE_VERSION ); wp_register_script( 'et-core-admin', ET_CORE_URL . 'admin/js/core.js', array(), ET_CORE_VERSION ); wp_localize_script( 'et-core-admin', 'etCore', array( 'ajaxurl' => is_ssl() ? admin_url( 'admin-ajax.php' ) : admin_url( 'admin-ajax.php', 'http' ), 'text' => array( 'modalTempContentCheck' => esc_html__( 'Got it, thanks!', ET_CORE_TEXTDOMAIN ), ), ) ); // enqueue common scripts as well et_core_register_common_assets(); } endif; add_action( 'admin_enqueue_scripts', 'et_core_register_admin_assets' ); if ( ! function_exists( 'et_core_register_common_assets' ) ) : /** * Register and Enqueue Common Core assets. * * @since 1.0.0 * * @private */ function et_core_register_common_assets() { // common.js needs to be located at footer after waypoint, fitvid, & magnific js to avoid broken javascript on Facebook in-app browser wp_register_script( 'et-core-common', ET_CORE_URL . 'admin/js/common.js', array( 'jquery' ), ET_CORE_VERSION, true ); wp_enqueue_script( 'et-core-common' ); } endif; // common.js needs to be loaded after waypoint, fitvid, & magnific js to avoid broken javascript on Facebook in-app browser, hence the 15 priority add_action( 'wp_enqueue_scripts', 'et_core_register_common_assets', 15 ); if ( ! function_exists( 'et_core_security_check' ) ): /** * Check if current user can perform an action and/or verify a nonce value. die() if not authorized. * * @examples: * - Check if user can 'manage_options': `et_core_security_check();` * - Verify a nonce value: `et_core_security_check( '', 'nonce_name' );` * - Check if user can 'something' and verify a nonce value: `self::do_security_check( 'something', 'nonce_name' );` * * @param string $user_can The name of the capability to check with `current_user_can()`. * @param string $nonce_action The name of the nonce action to check (excluding '_nonce'). * @param string $nonce_key The key to use to lookup nonce value in `$nonce_location`. Default * is the value of `$nonce_action` with '_nonce' appended to it. * @param string $nonce_location Where the nonce is stored (_POST|_GET|_REQUEST). Default: _POST. * @param bool $die Whether or not to `die()` on failure. Default is `true`. * * @return bool|null Whether or not the checked passed if `$die` is `false`. */ function et_core_security_check( $user_can = 'manage_options', $nonce_action = '', $nonce_key = '', $nonce_location = '_POST', $die = true ) { if ( empty( $nonce_key ) && false === strpos( $nonce_action, '_nonce' ) ) { $nonce_key = $nonce_action . '_nonce'; } else if ( empty( $nonce_key ) ) { $nonce_key = $nonce_action; } // phpcs:disable WordPress.Security.NonceVerification.NoNonceVerification switch( $nonce_location ) { case '_POST': $nonce_location = $_POST; break; case '_GET': $nonce_location = $_GET; break; case '_REQUEST': $nonce_location = $_REQUEST; break; default: return $die ? et_core_die() : false; } // phpcs:enable $passed = true; if ( '' !== $nonce_action && ! isset( $nonce_location[ $nonce_key ] ) ) { $passed = false; } else if ( '' === $user_can && '' === $nonce_action ) { $passed = false; } else if ( '' !== $user_can && ! current_user_can( $user_can ) ) { $passed = false; } else if ( '' !== $nonce_action && ! wp_verify_nonce( $nonce_location[ $nonce_key ], $nonce_action ) ) { $passed = false; } if ( $die && ! $passed ) { et_core_die(); } return $passed; } endif; if ( ! function_exists( 'et_core_security_check_passed' ) ): /** * Wrapper for {@see et_core_security_check()} that disables `die()` on failure. * * @see et_core_security_check() for parameter documentation. * * @return bool Whether or not the security check passed. */ function et_core_security_check_passed( $user_can = 'manage_options', $nonce_action = '', $nonce_key = '', $nonce_location = '_POST' ) { return et_core_security_check( $user_can, $nonce_action, $nonce_key, $nonce_location, false ); } endif; if ( ! function_exists( 'et_core_setup' ) ) : /** * Setup Core. * * @since 1.0.0 * @since 3.0.60 The `$url` param is deprecated. * * @param string $deprecated Deprecated parameter. */ function et_core_setup( $deprecated = '' ) { if ( defined( 'ET_CORE_PATH' ) ) { return; } $core_path = _et_core_normalize_path( trailingslashit( dirname( __FILE__ ) ) ); $theme_dir = _et_core_normalize_path( realpath( get_template_directory() ) ); if ( 0 === strpos( $core_path, $theme_dir ) ) { $url = get_template_directory_uri() . '/core/'; } else { $url = plugin_dir_url( __FILE__ ); } define( 'ET_CORE_PATH', $core_path ); define( 'ET_CORE_URL', $url ); define( 'ET_CORE_TEXTDOMAIN', 'et-core' ); load_theme_textdomain( 'et-core', ET_CORE_PATH . 'languages/' ); et_core_maybe_set_updated(); et_new_core_setup(); register_shutdown_function( 'ET_Core_PageResource::shutdown' ); if ( is_admin() || ! empty( $_GET['et_fb'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification add_action( 'admin_enqueue_scripts', 'et_core_load_main_styles' ); } et_core_maybe_patch_old_theme(); } endif; if ( ! function_exists( 'et_force_edge_compatibility_mode' ) ) : function et_force_edge_compatibility_mode() { echo '<meta http-equiv="X-UA-Compatible" content="IE=edge">'; } endif; add_action( 'et_head_meta', 'et_force_edge_compatibility_mode' ); if ( ! function_exists( 'et_get_allowed_localization_html_elements' ) ) : function et_get_allowed_localization_html_elements() { $whitelisted_attributes = array( 'id' => array(), 'class' => array(), 'style' => array(), ); $whitelisted_attributes = apply_filters( 'et_allowed_localization_html_attributes', $whitelisted_attributes ); $elements = array( 'a' => array( 'href' => array(), 'title' => array(), 'target' => array(), 'rel' => array(), ), 'b' => array(), 'br' => array(), 'em' => array(), 'p' => array(), 'span' => array(), 'div' => array(), 'strong' => array(), ); $elements = apply_filters( 'et_allowed_localization_html_elements', $elements ); foreach ( $elements as $tag => $attributes ) { $elements[ $tag ] = array_merge( $attributes, $whitelisted_attributes ); } return $elements; } endif; if ( ! function_exists( 'et_get_safe_localization' ) ) : function et_get_safe_localization( $string ) { return apply_filters( 'et_get_safe_localization', wp_kses( $string, et_get_allowed_localization_html_elements() ) ); } endif; if ( ! function_exists( 'et_get_theme_version' ) ) : function et_get_theme_version() { $theme_info = wp_get_theme(); if ( is_child_theme() ) { $theme_info = wp_get_theme( $theme_info->parent_theme ); } $theme_version = $theme_info->display( 'Version' ); return $theme_version; } endif; if ( ! function_exists( 'et_new_core_setup') ): function et_new_core_setup() { $has_php_52x = -1 === version_compare( PHP_VERSION, '5.3' ); require_once ET_CORE_PATH . 'components/Updates.php'; require_once ET_CORE_PATH . 'components/init.php'; require_once ET_CORE_PATH . 'wp_functions.php'; if ( $has_php_52x ) { spl_autoload_register( 'et_core_autoloader', true ); } else { spl_autoload_register( 'et_core_autoloader', true, true ); } // Initialize top-level components "group" $hook = did_action( 'plugins_loaded' ) ? 'after_setup_theme' : 'plugins_loaded'; add_action( $hook, 'et_core_init', 9999999 ); } endif; if ( ! function_exists( 'et_core_add_crossorigin_attribute' ) ): function et_core_add_crossorigin_attribute( $tag, $handle, $src ) { if ( ! $handle || ! in_array( $handle, array( 'react', 'react-dom' ) ) ) { return $tag; } return sprintf( '<script src="%1$s" crossorigin></script>', esc_attr( $src ) ); // phpcs:ignore WordPress.WP.EnqueuedResources.NonEnqueuedScript } endif; if ( ! function_exists( 'et_core_get_version_from_filesystem' ) ): /** * Get the core version from the filesystem. * This is necessary in cases such as Version Rollback where you cannot use * a constant from memory as it is outdated or you wish to get the version * not from the active (latest) core but from a different one. * * @param string $core_directory * * @return string */ function et_core_get_version_from_filesystem( $core_directory ) { $version_file = $core_directory . DIRECTORY_SEPARATOR . '_et_core_version.php'; if ( ! file_exists( $version_file ) ) { return ''; } include $version_file; return $ET_CORE_VERSION; } endif; if ( ! function_exists( 'et_core_replace_enqueued_style' ) ): /** * Replace a style's src if it is enqueued. * * @since 3.10 * * @param string $old_src * @param string $new_src * @param boolean $regex Use regex to match and replace the style src. * * @return void */ function et_core_replace_enqueued_style( $old_src, $new_src, $regex = false ) { $styles = wp_styles(); if ( empty( $styles->registered ) ) { return; } foreach ( $styles->registered as $style_handle => $style ) { $match = $regex ? preg_match( $old_src, $style->src ) : $old_src === $style->src; if ( ! $match ) { continue; } $style_src = $regex ? preg_replace( $old_src, $new_src, $style->src ) : $new_src; $style_deps = isset( $style->deps ) ? $style->deps : array(); $style_ver = isset( $style->ver ) ? $style->ver : false; $style_media = isset( $style->args ) ? $style->args : 'all'; // Deregister first, so the handle can be re-enqueued. wp_deregister_style( $style_handle ); // Enqueue the same handle with the new src. wp_enqueue_style( $style_handle, $style_src, $style_deps, $style_ver, $style_media ); } } endif; if ( ! function_exists( 'et_core_load_component' ) ) : /** * ============================= * ----->>> DEPRECATED! <<<----- * ============================= * Load Core components. * * This function loads Core components. Components are only loaded once, even if they are called many times. * Admin components/functions are automatically wrapped in an is_admin() check. * * @deprecated Component classes are now loaded automatically upon first use. Portability was the only component * ever loaded by this function, so it now only handles that single use-case (for backwards compatibility). * * @param string|array $components Name of the Core component(s) to include as and indexed array. * * @return bool Always return true. */ function et_core_load_component( $components ) { static $portability_loaded = false; if ( $portability_loaded || empty( $components ) ) { return true; } $is_jetpack = isset( $_SERVER['HTTP_USER_AGENT'] ) && false !== strpos( $_SERVER['HTTP_USER_AGENT'], 'Jetpack' ); if ( ! $is_jetpack && ! is_admin() && empty( $_GET['et_fb'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification return true; } if ( ! class_exists( 'ET_Core_Portability', false ) ) { include_once ET_CORE_PATH . 'components/Cache.php'; include_once ET_CORE_PATH . 'components/Portability.php'; } return $portability_loaded = true; } endif;
Save Changes
Rename File
Rename