Weak hands cannot be planted, meager skills have no foundation. Shallow wisdom is futile, how can one hope for a good name?扰扰从役倦，屑屑身事微。少壮轻年月，迟暮惜光辉。 _dependency_tree = $dependency_tree; } /** * Loads and initializes the Frontend for the application. * * This function ensures the proper setup and configuration required for the Frontend to * function correctly. This includes loading of resources, setting up routes, and initializing * necessary classes or traits. * * @since ?? * * @return void */ public function initialize(): void { if ( ! Conditions::is_d5_enabled() ) { return; } if ( ! Conditions::is_vb_enabled() ) { // Some 3P plugins will break if DiviExtensions class is not loaded this early. $this->maybe_init_divi_4_exensions(); // Check again later because D4-only hooks might be registered after this point. add_action( 'et_head_meta', [ $this, 'maybe_init_divi_4_exensions' ] ); add_action( 'wp_enqueue_scripts', [ $this, 'register_fe_styles' ] ); add_action( 'wp_enqueue_scripts', [ $this, 'register_fe_scripts' ] ); // The priority needs to be 11 so that Dynamic Assets run first. add_action( 'wp_footer', [ $this, 'enqueue_footer_script_data' ], 11 ); // D5: Enqueue fonts earlier (priority 9) so they are in the queue when et_builder_print_font runs (priority 10). add_action( 'wp_footer', [ $this, 'enqueue_footer_fonts' ], 9 ); add_action( 'wp_footer', [ $this, 'maybe_enqueue_global_colors_style' ] ); add_action( 'wp_footer', [ $this, 'enqueue_global_numeric_and_fonts_vars' ] ); add_action( 'show_admin_bar', [ $this, 'preview_hide_admin_bar' ], 10, 1 ); } add_action( 'wp_enqueue_scripts', [ $this, 'register_global_scripts' ] ); add_action( 'wp_enqueue_scripts', [ $this, 'override_d4_fe_scripts' ], 100 ); add_filter( 'the_content', [ $this, 'fix_code_module_wptexturize' ], 15 ); // Prevent wptexturize from converting straight quotes to curly quotes in D5 content. // This runs at priority 8 (before do_blocks at 9 and wptexturize at 10) to detect D5 blocks // before they are processed, then restores wptexturize for any subsequent content. // This is the safe approach - preventing the conversion rather than undoing it after. add_filter( 'et_builder_render_layout', [ $this, 'maybe_disable_wptexturize_for_divi5' ], 8 ); add_filter( 'the_content', [ $this, 'maybe_disable_wptexturize_for_divi5' ], 8 ); $this->_dependency_tree->load_dependencies(); /** * Fires after frontend initialization is complete. * * This action hook runs after all frontend dependencies and functionality have been initialized, * including styles, scripts, and core components. It executes both on the frontend and in the * Visual Builder context, allowing modules and extensions to perform additional setup or * registration once the frontend system is ready. * * @since ?? */ do_action( 'divi_frontend_initialize' ); } /** * Register global scripts. * * Some scripts need to be registered on the entire site. * Global scripts are used by the build and the Divi Theme. * * @since ?? * * @return void */ public function register_global_scripts() { wp_enqueue_script( 'divi-script-library-global-functions', ET_BUILDER_5_URI . '/visual-builder/build/script-library-frontend-global-functions.js', [ 'jquery', ], ET_CORE_VERSION, true ); wp_enqueue_script( 'divi-script-library-ext-waypoint', ET_BUILDER_5_URI . '/visual-builder/build/script-library-ext-waypoint.js', [], ET_CORE_VERSION, true ); } /** * Register frontend styles. * * This function is responsible for registering the styles used in the frontend of the * application. It should be called during the plugin initialization to ensure that the styles * are enqueued properly. * * @since ?? * * @return void */ public function register_fe_styles(): void { BackgroundAssets::parallax_style_register(); BackgroundAssets::video_style_register(); } /** * Get frontend scripts list. * * Retrieves an array of scripts that are used in the frontend. * * @since ?? * * @return array An array of script handles that are used in the frontend. */ public function get_fe_scripts(): array { return [ 'script-library' => [ 'handle' => 'divi-script-library', 'additional-dependencies' => [], ], BackgroundAssets::parallax_script_name() => [ 'handle' => BackgroundAssets::parallax_script_handle(), // Technically it'd be more accurate to set `divi-script-library-window-event-emitter` as dependency // because `WindowEventEmitter` is the part that is needed. However the exported function of // `divi-script-library-window-event-emitter` is `window.divi.scriptLibrary.scriptLibraryWindowEventEmitter` // instead of `window.divi.scriptLibrary.WindowEventEmitter` so right now we're still using `divi-script-library`. 'additional-dependencies' => [ 'divi-script-library' ], ], BackgroundAssets::video_script_name() => [ 'handle' => BackgroundAssets::video_script_handle(), // Technically it'd be more accurate to set `divi-script-library-window-event-emitter` as dependency // because `WindowEventEmitter` is the part that is needed. However the exported function of // `divi-script-library-window-event-emitter` is `window.divi.scriptLibrary.scriptLibraryWindowEventEmitter` // instead of `window.divi.scriptLibrary.WindowEventEmitter` so right now we're still using `divi-script-library`. 'additional-dependencies' => [ 'wp-mediaelement', 'divi-script-library' ], ], MultiViewAssets::script_name() => [ 'handle' => MultiViewAssets::script_handle(), 'additional-dependencies' => [ 'jquery' ], ], ]; } /** * Registers frontend scripts. * * This function is used to register scripts that will be loaded on the front-end of the website. * * @since ?? * * @return void */ public function register_fe_scripts(): void { $scripts = self::get_fe_scripts(); foreach ( $scripts as $script_name => $script ) { // Front-End scripts handle. $handle = $script['handle']; $register = true; /** * Filter to determine whether to register Front-End scripts or not. * * @since ?? * * @param bool $register Whether to register Front-End scripts. * @param string $handle Front-End scripts handle. */ $should_register_front_end_scripts = apply_filters( 'divi_front_end_register_scripts_enable', $register, $handle ); if ( ! $should_register_front_end_scripts ) { continue; } $asset_data = []; $version = Conditions::is_debug_mode() ? ( $asset_data['version'] ?? ET_CORE_VERSION ) : ET_CORE_VERSION; $dependencies = array_merge( $asset_data['dependencies'] ?? [], $script['additional-dependencies'] ); /** * Filters Front-End scripts dependencies. * * @since ?? * * @param array $dependencies Front-End scripts dependencies. * @param string $handle Front-End script handle. */ $script_dependencies = apply_filters( 'divi_front_end_register_scripts_dependencies', $dependencies, $handle ); wp_register_script( $script['handle'], untrailingslashit( ET_BUILDER_5_URI ) . '/visual-builder/build/' . $script_name . '.js', $script_dependencies, $version, true ); } foreach ( Script::get_all() as $handle => $script ) { $register = true; /** * Filter to determine whether to register module script. * * @since ?? * * @param bool $register Whether to register module script. * @param string $handle Module script handle. */ $register = apply_filters( 'divi_front_end_register_module_script', $register, $handle ); if ( ! $register ) { continue; } // Only register script when the module is used / saved in the frontend page if the script has 'module' property. // The complete expectation when 'module' property exist: // 1. D5 is enabled. // 2. Visual Builder is not enabled. // 3. The page content does not have any D4 shortcode. // 4. The page content has the saved block. if ( ! empty( $script['module'] ) ) { // Skip if Divi 5 is not enabled. if ( ! Conditions::is_d5_enabled() ) { continue; } // Skip if current page is visual builder. if ( Conditions::is_vb_enabled() ) { continue; } // Skip if current page content has no saved D5 format module (serialized block). // phpcs:ignore ET.Comments.Todo.TodoFound -- Legacy TODO: May not be tracked in GitHub issues yet. Preserve for future tracking/removal. // TODO feat(D5, Conditions) :: maybe create util function to check if current page has saved D5 format module. // right now it simply assume that if current page has saved D5 format, it'll wrapped inside section at least. if ( ! has_block( 'divi/section' ) ) { continue; } // The initial assumption is current page has no passed block. $has_block = false; foreach ( $script['module'] as $module_name ) { if ( $has_block ) { break; } $has_block = has_block( $module_name ); } if ( ! $has_block ) { continue; } } $dependencies = $script['deps']; /** * Filters Front-End scripts dependencies. * * @since ?? * * @param array $dependencies Front-End scripts dependencies. * @param string $handle Front-End script handle. */ $script_dependencies = apply_filters( 'divi_front_end_register_scripts_dependencies', $dependencies, $handle ); wp_register_script( $handle, $script['src'], $script_dependencies, $script['ver'], $script['in_footer'] ); $is_enqueue = $script['is_enqueue'] ?? false; if ( $is_enqueue ) { wp_enqueue_script( $handle ); } } } /** * Override the D4 FE scripts. * * This function is responsible for overriding the D4 FE (Front-end) scripts. It can be used to modify or extend * the existing functionality of the D4 FE scripts. * * @since ?? * * @return void */ public static function override_d4_fe_scripts(): void { $is_fe_or_vb_app_window = ! Conditions::is_vb_enabled() || Conditions::is_vb_app_window(); // Bail, if the current window is neither FE nor a visual builder app window. if ( ! $is_fe_or_vb_app_window ) { return; } $current_page_id = get_the_ID(); /** * Filter to determine if the current post/page is being A-B tested. * * @since 4.x * @deprecated 5.0.0 Use `divi_front_end_is_ab_testing_active_post_id` hook instead. * * @param int $current_page_id The current page ID. */ $current_page_id = apply_filters( 'et_is_ab_testing_active_post_id', $current_page_id ); /** * Filter to determine if the current post/page is being A-B tested. * * @since ?? * * @param int $current_page_id The current page ID. */ $current_page_id = apply_filters( 'divi_front_end_is_ab_testing_active_post_id', $current_page_id ); $ab_tests = function_exists( 'et_builder_ab_get_current_tests' ) ? et_builder_ab_get_current_tests() : []; $is_ab_testing = ! empty( $ab_tests ); // Enqueues et_get_combined_script_handle's deps. DynamicAssetsUtils::enqueue_combined_script(); $widget_search_selector = '.widget_search'; /** * Filter to add the CSS class selector for widget search. * * @since 4.x * @deprecated 5.0.0 Use `divi_front_end_widget_search_selector` hook instead. * * @param string $widget_search_selector The widget search selector class. */ $widget_search_selector = apply_filters( 'et_pb_widget_search_selector', $widget_search_selector ); /** * Filter to add the CSS class selector for widget search. * * @since ?? * * @param string $widget_search_selector The widget search selector class. */ $widget_search_selector = apply_filters( 'divi_front_end_widget_search_selector', $widget_search_selector ); // Type cast for filter hook. $options = []; /** * Filters Waypoints options for client side rendering. * * This is for backward compatibility with hooks written for Divi version <5.0.0. * * @since 4.15.0 * @deprecated 5.0.0 Use `divi_front_end_waypoints_options` hook instead. * * @param array $options { * Filtered Waypoints options.Only support `context` at this moment because * there is no test case for other properties. * * @type string[] $context List of container selectors for the Waypoint. The * element will iterate and looking for the closest * parent element matches the given selectors. * } */ $options = apply_filters( 'et_builder_waypoints_options', $options ); /** * Filters Waypoints options for client side rendering. * * @since ?? * * @param array $options { * Filtered Waypoints options. Only support `context` at this moment because * there is no test case for other properties. * * @type string[] $context List of container selectors for the Waypoint. The * element will iterate and looking for the closest * parent element matches the given selectors. * } */ $waypoints_options = apply_filters( 'divi_front_end_waypoints_options', $options ); $pb_custom_data = [ 'ajaxurl' => is_ssl() ? admin_url( 'admin-ajax.php' ) : admin_url( 'admin-ajax.php', 'http' ), 'images_uri' => get_template_directory_uri() . '/images', 'builder_images_uri' => ET_BUILDER_5_URI . '/images', 'et_frontend_nonce' => wp_create_nonce( 'et_frontend_nonce' ), 'subscription_failed' => esc_html__( 'Please, check the fields below to make sure you entered the correct information.', 'et_builder_5' ), 'et_ab_log_nonce' => wp_create_nonce( 'et_ab_testing_log_nonce' ), 'fill_message' => esc_html__( 'Please, fill in the following fields:', 'et_builder_5' ), 'contact_error_message' => esc_html__( 'Please, fix the following errors:', 'et_builder_5' ), 'invalid' => esc_html__( 'Invalid email', 'et_builder_5' ), 'captcha' => esc_html__( 'Captcha', 'et_builder_5' ), 'prev' => esc_html__( 'Prev', 'et_builder_5' ), 'previous' => esc_html__( 'Previous', 'et_builder_5' ), 'next' => esc_html__( 'Next', 'et_builder_5' ), 'wrong_captcha' => esc_html__( 'You entered the wrong number in captcha.', 'et_builder_5' ), 'wrong_checkbox' => esc_html__( 'Checkbox', 'et_builder_5' ), 'ignore_waypoints' => et_is_ignore_waypoints() ? 'yes' : 'no', 'is_divi_theme_used' => function_exists( 'et_divi_fonts_url' ), 'widget_search_selector' => $widget_search_selector, 'ab_tests' => $ab_tests, 'is_ab_testing_active' => $is_ab_testing, 'page_id' => $current_page_id, 'unique_test_id' => get_post_meta( $current_page_id, '_et_pb_ab_testing_id', true ), 'ab_bounce_rate' => '' !== get_post_meta( $current_page_id, '_et_pb_ab_bounce_rate_limit', true ) ? get_post_meta( $current_page_id, '_et_pb_ab_bounce_rate_limit', true ) : 5, 'is_cache_plugin_active' => false === et_pb_detect_cache_plugins() ? 'no' : 'yes', 'is_shortcode_tracking' => get_post_meta( $current_page_id, '_et_pb_enable_shortcode_tracking', true ), 'tinymce_uri' => defined( 'ET_FB_ASSETS_URI' ) ? ET_FB_ASSETS_URI . '/vendors' : '', 'accent_color' => et_builder_accent_color(), 'waypoints_options' => $waypoints_options, ]; wp_localize_script( et_get_combined_script_handle(), 'et_pb_custom', $pb_custom_data ); wp_localize_script( et_get_combined_script_handle(), 'et_frontend_scripts', [ 'builderCssContainerPrefix' => ET_BUILDER_CSS_CONTAINER_PREFIX, 'builderCssLayoutPrefix' => ET_BUILDER_CSS_LAYOUT_PREFIX, ] ); wp_localize_script( et_get_combined_script_handle(), 'et_builder_utils_params', [ 'condition' => [ 'diviTheme' => function_exists( 'et_divi_fonts_url' ), 'extraTheme' => function_exists( 'et_extra_fonts_url' ), ], 'scrollLocations' => et_builder_get_window_scroll_locations(), 'builderScrollLocations' => et_builder_get_onload_scroll_locations(), 'onloadScrollLocation' => et_builder_get_onload_scroll_location(), 'builderType' => et_builder_get_current_builder_type(), ] ); } /** * Enqueue script data at footer * * This function is used to enqueue script data in the footer of the HTML document. It is typically used to load * JavaScript files that need to be executed after the main content has been loaded. * * @since ?? * * @return void */ public function enqueue_footer_script_data(): void { // No need to enqueue Front End script data in Visual Builder's top window because no FE element is being // rendered on VB top window. It is better to keep it as light as possible. if ( Conditions::is_vb_top_window() ) { return; } // Set script data for breakpoint. Breakpoint::set_script_data(); // phpcs:ignore ET.Comments.Todo.TodoFound -- Legacy TODO: May not be tracked in GitHub issues yet. Preserve for future tracking/removal. // TODO feat(Script Data, Refactoring) - Refactor script so all of the script uses the same script data. ScriptData::enqueue_data( 'breakpoint' ); ScriptData::enqueue_data( 'background_parallax' ); ScriptData::enqueue_data( 'background_video' ); ScriptData::enqueue_data( 'multi_view' ); } /** * Enqueue fonts in footer. * * This function enqueues fonts in the footer of the webpage. It can be used to add custom fonts * or external font libraries to the webpage. The function does not return any value. * * @since ?? * * @return void */ public function enqueue_footer_fonts(): void { Fonts::enqueue(); } /** * Enqueue global data style when Dynamic Assets are disabled. * * This function is responsible for enqueuing the necessary global colors styles for the * front end. It is called during the initialization of the FrontEnd class. * * @since ?? * * @return void */ public function maybe_enqueue_global_colors_style(): void { if ( ! DynamicAssetsUtils::use_dynamic_assets() && ! Conditions::is_vb_enabled() ) { // Get all the global colors CSS variable. $global_colors_style = Style::get_global_colors_style(); if ( ! empty( $global_colors_style ) ) { echo ''; } } } /** * Preview hide admin bar. * * This function is used to hide the admin bar when previewing a layout in the Divi Builder. * * @since ?? * * @param boolean $return The current value of the admin bar. * * @return boolean The new value of the admin bar. */ public function preview_hide_admin_bar( bool $return ): bool { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.returnFound -- Parameter name matches WordPress filter convention. if ( isset( $_GET['preview_id'] ) && isset( $_GET['preview_nonce'] ) ) { $id = (int) $_GET['preview_id']; $post_type = get_post_type( $id ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- wp_verify_nonce() function does sanitation. if ( 'et_pb_layout' === $post_type && wp_verify_nonce( wp_unslash( $_GET['preview_nonce'] ), 'post_preview_' . $id ) ) { return false; } } return $return; } /** * Enqueue global numeric variables. * * This function outputs global numeric CSS variables as inline styles when the Visual Builder is not enabled. * * @since ?? */ public function enqueue_global_numeric_and_fonts_vars(): void { if ( ! Conditions::is_vb_enabled() && ! Conditions::is_admin_request() ) { // Get all the global colors CSS variable. $global_vars_style = Style::get_global_numeric_and_fonts_vars_style(); if ( ! empty( $global_vars_style ) ) { echo ''; } } } /** * Conditionally load Divi extension class. * * This function loads D4 API Class when D4-only extensions are detected, if we don't do it * this early, some extensions will fail to enqueue scripts/styles. * * @since ?? * * @return void */ public function maybe_init_divi_4_exensions(): void { // Need to manually require this because d5-readiness doesn't run include() on frontend. require_once get_template_directory() . '/d5-readiness/server/Checks/PluginHooksCheck.php'; if ( Conditions::has_divi_4_only_extension() ) { require_once get_template_directory() . '/includes/builder/api/DiviExtensions.php'; } } /** * Fix Code Module wptexturize issues. * * Fixes wptexturized Code Module content by converting & back to & within * script tags, while preserving entities inside string literals. This is the * D5 equivalent of D4's fix_wptexturized_scripts. * * @since ?? * * @param string $content The post content. * * @return string The fixed content. */ public function fix_code_module_wptexturize( string $content ): string { // Only process if contains Code Module content and & entities. if ( false === strpos( $content, 'et_pb_code_inner' ) || false === strpos( $content, '&' ) ) { return $content; } // Fix & inside script tags (but not inside strings). $content = preg_replace_callback( '/]*>(.*?)<\/script>/si', function ( $matches ) { $script_content = $matches[1]; $fixed_content = $this->_replace_entities_outside_strings( $script_content ); return str_replace( $script_content, $fixed_content, $matches[0] ); }, $content ); return $content; } /** * Replace HTML entities outside of string literals in JavaScript code. * * This preserves & inside strings (where it might be intentional, e.g., URLs) * while converting it to & in JavaScript operators (e.g., && logical operator). * * @since ?? * * @param string $script_content The JavaScript content to process. * * @return string The processed content. */ private function _replace_entities_outside_strings( string $script_content ): string { // Match either string literals OR & entities. // String literals: single quotes, double quotes, or template literals. // We use a regex that matches strings first, then entities. $pattern = '/(?:"(?:[^"\\\\]|\\\\.)*"|\'(?:[^\'\\\\]|\\\\.)*\'|`(?:[^`\\\\]|\\\\.)*`)|(&)/s'; return preg_replace_callback( $pattern, function ( $matches ) { // We matched & outside a string, replace it. if ( ! empty( $matches[1] ) ) { return '&'; } // String literal, keep as-is. return $matches[0]; }, $script_content ); } /** * Prevent wptexturize from running on block content. * * This method runs at priority 8 (before do_blocks at 9 and wptexturize at 10) on both * `the_content` and `et_builder_render_layout` filters. If the content contains * Divi 5 blocks, rendered D5 module HTML, or any Gutenberg blocks, it temporarily * removes the wptexturize filter to prevent WordPress from converting straight quotes * to curly quotes. * * After the content passes through, the wptexturize filter is restored for * any subsequent content processing. * * This is the secure approach - preventing the conversion at the source rather * than decoding entities on output (which would bypass output escaping protections). * * @since ?? * * @param string $content The content to process. * * @return string The unmodified content (wptexturize is removed as a side effect). */ public function maybe_disable_wptexturize_for_divi5( string $content ): string { // Check if content contains Divi 5 blocks, rendered D5 HTML, or any Gutenberg blocks. // We disable wptexturize to prevent WordPress from converting straight quotes to curly quotes. // Detection scenarios: // 1. Raw D5 blocks: `