'ttf',
* 'type' => 'application/octet-stream',
* );
* $file = '/path/to/file.ttf';
* $filename = 'font.ttf';
*
* FontsUtility::check_filetype_and_ext_font( $checked_filetype_and_ext, $file, $filename );
* ```
*
* @example:
* ```php
* $checked_filetype_and_ext = array(
* 'ext' => false,
* 'type' => false,
* );
* $file = '/path/to/invalid_file.ttf';
* $filename = 'invalid_font.ttf';
*
* FontsUtility::check_filetype_and_ext_font( $checked_filetype_and_ext, $file, $filename );
* ```
*/
public static function check_filetype_and_ext_font( array $checked_filetype_and_ext, string $file, string $filename ): array {
$mimes_font = FontsUtility::mime_types_font();
// Only process if the file exist and PHP extension "fileinfo" is loaded.
if ( file_exists( $file ) && extension_loaded( 'fileinfo' ) ) {
$ext = pathinfo( $filename, PATHINFO_EXTENSION );
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
if ( $ext && $ext !== $filename && isset( $mimes_font[ $ext ] ) ) {
// Get the real mime type.
$finfo = finfo_open( FILEINFO_MIME_TYPE );
$real_mime = finfo_file( $finfo, $file );
finfo_close( $finfo );
if ( $real_mime && in_array( $real_mime, $mimes_font[ $ext ], true ) ) {
return [
'ext' => $ext,
'type' => $real_mime,
'proper_filename' => sanitize_file_name( $filename ),
];
}
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
$ext = isset( $checked_filetype_and_ext['ext'] ) ? $checked_filetype_and_ext['ext'] : false;
$type = isset( $checked_filetype_and_ext['type'] ) ? $checked_filetype_and_ext['type'] : false;
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
if ( $ext && $type && isset( $mimes_font[ $ext ] ) && in_array( $type, $mimes_font[ $ext ], true ) ) {
return $checked_filetype_and_ext;
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
/**
* Filters the "real" file type of the given JSON file.
*
* @since ??
*
* @param array $checked_filetype_and_ext {
* Values for the extension, mime type, and corrected filename.
*
* @type string|false $ext File extension, or false if the file doesn't match a mime type.
* @type string|false $type File mime type, or false if the file doesn't match a mime type.
* @type string|false $proper_filename File name with its correct extension, or false if it cannot be determined.
* }
*
* @param string $file Full path to the file.
* @param string $filename The name of the file (may differ from $file due to
* $file being in a tmp directory).
*
* @return array
*/
public static function check_filetype_and_ext_json( array $checked_filetype_and_ext, string $file, string $filename ): array {
$mimes_json = PortabilityController::mime_types_json();
// Only process if the file exist and PHP extension "fileinfo" is loaded.
if ( file_exists( $file ) && extension_loaded( 'fileinfo' ) ) {
$ext = pathinfo( $filename, PATHINFO_EXTENSION );
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
if ( $ext && $ext !== $filename && isset( $mimes_json[ $ext ] ) ) {
// Get the real mime type.
$finfo = finfo_open( FILEINFO_MIME_TYPE );
$real_mime = finfo_file( $finfo, $file );
finfo_close( $finfo );
// sometimes finfo_file() returns "text/html" or similar for JSON files/JSON content.
// in this case, we need to check if the file has valid JSON content.
// if it is, we can safely assume that the file is a JSON file.
// see https://github.com/elegantthemes/Divi/issues/39203.
if ( ! in_array( $real_mime, $mimes_json[ $ext ], true ) && 'json' === $ext ) {
global $wp_filesystem;
json_decode( $wp_filesystem->get_contents( $file ) );
if ( json_last_error() === JSON_ERROR_NONE ) {
$real_mime = 'application/json';
}
}
if ( $real_mime && in_array( $real_mime, $mimes_json[ $ext ], true ) ) {
return [
'ext' => $ext,
'type' => $real_mime,
'proper_filename' => sanitize_file_name( $filename ),
];
}
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
$ext = $checked_filetype_and_ext['ext'] ?? false;
$type = $checked_filetype_and_ext['type'] ?? false;
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
if ( $ext && $type && isset( $mimes_json[ $ext ] ) && in_array( $type, $mimes_json[ $ext ], true ) ) {
return $checked_filetype_and_ext;
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
/**
* Set uploads dir for the custom font files.
*
* Adds a custom subdirectory '/et-fonts' to the upload directory paths and URLs for font file uploads.
* If the $directory argument is passed with a 'basedir' key, the function will append the '/et-fonts' subdirectory to the directory path.
* If the $directory argument is passed with a 'baseurl' key, the function will append the '/et-fonts' subdirectory to the directory URL.
* Additionally, it sets the 'subdir' key in the $directory array to '/et-fonts'.
*
* @since ??
*
* @param array $directory {
* An array of upload directory information.
*
* @type string $basedir The base directory path for the upload directory.
* @type string $path The full path to the upload directory including the subdirectory '/et-fonts'.
* @type string $url The full URL to the upload directory including the subdirectory '/et-fonts'.
* @type string $subdir The subdirectory '/et-fonts'.
* }
*
* @return array The modified $directory array with the 'path', 'url', and 'subdir' keys.
*
* @example:
* ```php
* Example 1: Adding '/et-fonts' subdirectory to the upload directory
*
* $directory = array(
* 'basedir' => '/var/www/uploads',
* 'baseurl' => 'http://example.com/uploads'
* );
*
* $modified_directory = HooksRegistration::upload_dir_font( $directory );
* ```
*
* @output:
* ```php
* // The $modified_directory array will be:
* array (
* 'basedir' => '/var/www/uploads',
* 'path' => '/var/www/uploads/et-fonts',
* 'baseurl' => 'http://example.com/uploads',
* 'url' => 'http://example.com/uploads/et-fonts',
* 'subdir' => '/et-fonts',
* )
* ```
*/
public static function upload_dir_font( array $directory ): array {
$subdir = '/et-fonts';
if ( isset( $directory['basedir'] ) ) {
$directory['path'] = $directory['basedir'] . $subdir;
}
if ( isset( $directory['baseurl'] ) ) {
$directory['url'] = $directory['baseurl'] . $subdir;
}
$directory['subdir'] = $subdir;
return $directory;
}
/**
* Load and register hook functions used in Visual Builder.
*
* Adds actions to update cached assets when custom fonts are added or removed.
*
* @since ??
*
* @return void
*/
public function load(): void {
// Add action to update cached assets because custom fonts are included in static helpers.
add_action( 'divi_visual_builder_fonts_custom_font_added', 'et_fb_delete_builder_assets' );
add_action( 'divi_visual_builder_fonts_custom_font_removed', 'et_fb_delete_builder_assets' );
// Dynamic Content Resolved Value.
add_filter( 'divi_module_dynamic_content_resolved_value', [ $this, 'divi_module_theme_builder_default_dynamic_content_resolved_value' ], 15, 2 );
// SVG Support: Enable SVG uploads when SVG plugins are detected.
add_filter( 'upload_mimes', [ $this, 'enable_svg_upload_mimes' ], 10, 1 );
// Initialize ACF taxonomy field processing hooks.
DynamicContentACFUtils::init_hooks();
// Override admin bar link logic for non-singular pages with Theme Builder templates.
add_action( 'admin_bar_menu', [ $this, 'add_edit_with_divi_button_for_theme_builder' ], 1000 );
// Handle Visual Builder boot for non-singular pages with Theme Builder templates.
// Run at priority 0 (before legacy et_fb_app_boot at priority 1).
add_filter( 'the_content', [ $this, 'boot_vb_for_non_singular_theme_builder' ], 0 );
add_filter( 'et_builder_render_layout', [ $this, 'boot_vb_for_non_singular_theme_builder' ], 0 );
// Prevent legacy code from running for non-singular pages with TB templates.
// Remove the legacy hook before content filters run.
add_action( 'template_redirect', [ $this, 'prevent_legacy_vb_boot_for_non_singular' ], 1 );
// Ensure non-singular Theme Builder VB sessions do not keep 404 response headers.
add_action( 'template_redirect', [ $this, 'force_success_status_for_non_singular_theme_builder_vb' ], 2 );
}
/**
* Resolve placeholder content for built-in dynamic content fields for Theme Builder layouts.
*
* @since ??
*
* @param mixed $content The current value of the post featured image option.
* @param array $args {
* Optional. An array of arguments for retrieving the post featured image.
* Default `[]`.
*
* @type string $name Optional. Option name. Default empty string.
* @type array $settings Optional. Option settings. Default `[]`.
* @type integer $post_id Optional. Post Id. Default `null`.
* @type string $context Optional. Context. Default `''`.
* @type array $overrides Optional. An associative array of `option_name => value` to override option value.
* Default `[]`.
* }
*
* @return string
*/
public static function divi_module_theme_builder_default_dynamic_content_resolved_value( $content, array $args = [] ) {
$name = $args['name'] ?? '';
$settings = $args['settings'] ?? [];
$post_id = $args['post_id'] ?? null;
// Get post type from post id.
$post_type = get_post_type( $post_id );
if ( ! et_theme_builder_is_layout_post_type( $post_type ) && ! is_et_theme_builder_template_preview() ) {
return $content;
}
// For search results, use real dynamic content instead of placeholders.
if ( is_search() && 'post_title' === $name ) {
return $content;
}
$placeholders = [
'post_title' => __( 'Your Dynamic Post Title Will Display Here', 'et_builder_5' ),
'post_excerpt' => __( 'Your dynamic post excerpt will display here. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus auctor urna eleifend diam eleifend sollicitudin a fringilla turpis. Curabitur lectus enim.', 'et_builder_5' ),
'post_date' => time(),
'post_comment_count' => 12,
'post_categories' => [
__( 'Category 1', 'et_builder_5' ),
__( 'Category 2', 'et_builder_5' ),
__( 'Category 3', 'et_builder_5' ),
],
'post_tags' => [
__( 'Tag 1', 'et_builder_5' ),
__( 'Tag 2', 'et_builder_5' ),
__( 'Tag 3', 'et_builder_5' ),
],
'post_author' => [
'display_name' => __( 'John Doe', 'et_builder_5' ),
'first_last_name' => __( 'John Doe', 'et_builder_5' ),
'last_first_name' => __( 'Doe, John', 'et_builder_5' ),
'first_name' => __( 'John', 'et_builder_5' ),
'last_name' => __( 'Doe', 'et_builder_5' ),
'nickname' => __( 'John', 'et_builder_5' ),
'username' => __( 'johndoe', 'et_builder_5' ),
],
'post_author_bio' => __( 'Your dynamic author bio will display here. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus auctor urna eleifend diam eleifend sollicitudin a fringilla turpis. Curabitur lectus enim.', 'et_builder_5' ),
'post_featured_image' => ET_BUILDER_PLACEHOLDER_LANDSCAPE_IMAGE_DATA,
'term_description' => __( 'Your dynamic category description will display here. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus auctor urna eleifend diam eleifend sollicitudin a fringilla turpis. Curabitur lectus enim.', 'et_builder_5' ),
'site_logo' => 'https://www.elegantthemes.com/img/divi.png',
];
$_ = et_();
$wrapped = false;
$defaults = static function ( $post_id, $option, $setting ) {
return DynamicContentUtils::get_default_setting_value(
[
'post_id' => $post_id,
'name' => $option,
'setting' => $setting,
]
);
};
switch ( $name ) {
case 'post_title':
$content = et_core_intentionally_unescaped( $placeholders[ $name ], 'cap_based_sanitized' );
break;
case 'post_excerpt':
$words = (int) ( $settings['words'] ?? $defaults( $post_id, $name, 'words' ) );
$read_more = $settings['read_more_label'] ?? $defaults( $post_id, $name, 'read_more_label' );
$content = esc_html( $placeholders[ $name ] );
if ( $words > 0 ) {
$content = wp_trim_words( $content, $words );
}
if ( ! empty( $read_more ) ) {
$content .= sprintf(
' %2$s',
'#',
esc_html( $read_more )
);
}
break;
case 'post_date':
$format = $settings['date_format'] ?? $defaults( $post_id, $name, 'date_format' );
$custom_format = $settings['custom_date_format'] ?? $defaults( $post_id, $name, 'custom_date_format' );
if ( 'default' === $format ) {
$format = strval( get_option( 'date_format' ) );
}
if ( 'custom' === $format ) {
$format = $custom_format;
}
$content = esc_html( gmdate( $format, $placeholders[ $name ] ) );
break;
case 'post_comment_count':
$link = $settings['link_to_comments_page'] ?? $defaults( $post_id, $name, 'link_to_comments_page' );
$link = 'on' === $link;
$content = esc_html( $placeholders[ $name ] );
if ( $link ) {
$wrapped_content = DynamicContentElements::get_wrapper_element(
[
'post_id' => $post_id,
'name' => $name,
'value' => $content,
'settings' => $settings,
]
);
$content = sprintf(
'%2$s',
'#',
et_core_esc_previously( $wrapped_content )
);
$wrapped = true;
}
break;
case 'post_categories': // Intentional fallthrough.
case 'post_tags':
$link = $settings['link_to_term_page'] ?? $defaults( $post_id, $name, 'link_to_term_page' );
$link = 'on' === $link;
$url = '#';
$separator = $settings['separator'] ?? $defaults( $post_id, $name, 'separator' );
$separator = ! empty( $separator ) ? $separator : $defaults( $post_id, $name, 'separator' );
$content = $placeholders[ $name ];
foreach ( $content as $index => $item ) {
$content[ $index ] = esc_html( $item );
if ( $link ) {
$content[ $index ] = sprintf(
'%3$s',
esc_url( $url ),
esc_attr( '_blank' ),
et_core_esc_previously( $content[ $index ] )
);
}
}
$content = implode( esc_html( $separator ), $content );
break;
case 'post_link':
$text = $settings['text'] ?? $defaults( $post_id, $name, 'text' );
$custom_text = $settings['custom_text'] ?? $defaults( $post_id, $name, 'custom_text' );
$label = 'custom' === $text ? $custom_text : $placeholders['post_title'];
$content = sprintf(
'%2$s',
'#',
esc_html( $label )
);
break;
case 'post_author':
$name_format = $settings['name_format'] ?? $defaults( $post_id, $name, 'name_format' );
$link = $settings['link'] ?? $defaults( $post_id, $name, 'link' );
$link = 'on' === $link;
$label = isset( $placeholders[ $name ][ $name_format ] ) ? $placeholders[ $name ][ $name_format ] : '';
$url = '#';
$content = esc_html( $label );
if ( $link && ! empty( $url ) ) {
$content = sprintf(
'%3$s',
esc_url( $url ),
esc_attr( '_blank' ),
et_core_esc_previously( $content )
);
}
break;
case 'post_author_bio':
$content = et_core_intentionally_unescaped( $placeholders[ $name ], 'cap_based_sanitized' );
break;
case 'term_description':
$content = et_core_intentionally_unescaped( $placeholders[ $name ], 'cap_based_sanitized' );
break;
case 'post_link_url':
$content = '#';
break;
case 'post_author_url':
$content = '#';
break;
case 'post_featured_image':
$content = et_core_intentionally_unescaped( $placeholders[ $name ], 'fixed_string' );
break;
case 'site_logo':
if ( empty( $content ) ) {
$content = esc_url( $placeholders[ $name ] );
} else {
$wrapped = true;
}
break;
default:
// Avoid unhandled cases being wrapped twice by the default resolve and this one.
$wrapped = true;
break;
}
if ( $_->starts_with( $name, 'custom_meta_' ) ) {
$meta_key = substr( $name, strlen( 'custom_meta_' ) );
$meta_value = get_post_meta( $post_id, $meta_key, true );
if ( empty( $meta_value ) ) {
$content = DynamicContentUtils::get_custom_meta_label( $meta_key );
} else {
$wrapped = true;
}
}
if ( ! $wrapped ) {
$content = DynamicContentElements::get_wrapper_element(
[
'post_id' => $post_id,
'name' => $name,
'value' => $content,
'settings' => $settings,
]
);
$wrapped = true;
}
return $content;
}
/**
* Filters the "real" file type of the given image file.
*
* @since ??
*
* @param array $checked_filetype_and_ext {
* Values for the extension, mime type, and corrected filename.
*
* @type string|false $ext File extension, or false if the file doesn't match a mime type.
* @type string|false $type File mime type, or false if the file doesn't match a mime type.
* @type string|false $proper_filename File name with its correct extension, or false if it cannot be determined.
* }
*
* @param string $file Full path to the file.
* @param string $filename The name of the file (may differ from $file due to
* $file being in a tmp directory).
*
* @return array
*/
public static function check_filetype_and_ext_image( array $checked_filetype_and_ext, string $file, string $filename ): array {
// Supported media mime types (images and videos) for portability import.
$mimes_media = [
// Images.
'jpg' => 'image/jpeg',
'jpeg' => 'image/jpeg',
'jpe' => 'image/jpeg',
'gif' => 'image/gif',
'png' => 'image/png',
'bmp' => 'image/bmp',
'tiff' => 'image/tiff',
'tif' => 'image/tiff',
'webp' => 'image/webp',
'avif' => 'image/avif',
'ico' => 'image/x-icon',
'heic' => 'image/heic',
// Videos.
'mp4' => 'video/mp4',
'webm' => 'video/webm',
'ogv' => 'video/ogg',
'avi' => 'video/avi',
'mov' => 'video/quicktime',
'wmv' => 'video/x-ms-wmv',
'flv' => 'video/x-flv',
];
$allowed_mimes = get_allowed_mime_types();
if ( in_array( 'image/svg+xml', $allowed_mimes, true ) ) {
$mimes_media['svg'] = 'image/svg+xml';
$mimes_media['svgz'] = 'image/svg+xml';
}
// Only process if the file exists and PHP extension "fileinfo" is loaded.
if ( file_exists( $file ) && extension_loaded( 'fileinfo' ) ) {
$ext = pathinfo( $filename, PATHINFO_EXTENSION );
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
if ( $ext && isset( $mimes_media[ $ext ] ) ) {
// Get the real mime type.
$finfo = finfo_open( FILEINFO_MIME_TYPE );
$real_mime = finfo_file( $finfo, $file );
finfo_close( $finfo );
$is_valid_mime = ( $real_mime === $mimes_media[ $ext ] );
if ( ! $is_valid_mime && in_array( $ext, [ 'svg', 'svgz' ], true ) ) {
$is_valid_mime = in_array( $real_mime, [ 'image/svg+xml', 'text/xml', 'application/xml' ], true );
}
if ( $real_mime && $is_valid_mime ) {
return [
'ext' => $ext,
'type' => $real_mime,
'proper_filename' => sanitize_file_name( $filename ),
];
}
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
$ext = $checked_filetype_and_ext['ext'] ?? false;
$type = $checked_filetype_and_ext['type'] ?? false;
// Normalize extension to lowercase to handle uppercase extensions from cameras/Windows systems.
$ext = $ext ? strtolower( $ext ) : $ext;
$is_valid_type = ( isset( $mimes_media[ $ext ] ) && $type === $mimes_media[ $ext ] );
if ( ! $is_valid_type && in_array( $ext, [ 'svg', 'svgz' ], true ) ) {
$is_valid_type = in_array( $type, [ 'image/svg+xml', 'text/xml', 'application/xml' ], true );
}
if ( $ext && $type && isset( $mimes_media[ $ext ] ) && $is_valid_type ) {
return $checked_filetype_and_ext;
}
return [
'ext' => false,
'type' => false,
'proper_filename' => false,
];
}
/**
* Enable SVG uploads when SVG plugins are detected.
*
* This method ensures SVG files are properly supported in all contexts, including Visual Builder,
* when SVG plugins are available and the user has permission to upload SVG files.
*
* @since ??
*
* @param array $mimes Allowed mime types.
*
* @return array Modified mime types array.
*/
public function enable_svg_upload_mimes( array $mimes ): array {
// Check if any SVG plugin is available.
if ( ! $this->_is_svg_plugin_available() ) {
return $mimes;
}
// Check user permission and allow site owners to override.
$can_upload = (bool) apply_filters(
'divi_current_user_can_upload_svg',
(bool) apply_filters( 'safe_svg_current_user_can_upload', current_user_can( 'upload_files' ) )
);
if ( ! $can_upload ) {
return $mimes;
}
// Add SVG mime types.
if ( ! isset( $mimes['svg'] ) ) {
$mimes['svg'] = 'image/svg+xml';
}
if ( ! isset( $mimes['svgz'] ) ) {
$mimes['svgz'] = 'image/svg+xml';
}
return $mimes;
}
/**
* Add "Edit With Divi" button for non-singular pages with Theme Builder templates.
*
* This overrides the legacy admin bar logic to allow the button on archive/non-singular
* pages when Theme Builder templates are assigned, even if the Visual Theme Builder
* preference is disabled.
*
* @since ??
*
* @return void
*/
public function add_edit_with_divi_button_for_theme_builder(): void {
// Only on frontend, not admin.
if ( is_admin() ) {
return;
}
if ( ! Conditions::is_non_singular_theme_builder_context() ) {
return;
}
// Check permissions.
if ( ! et_pb_is_allowed( 'use_visual_builder' ) || ! et_pb_is_allowed( 'theme_builder' ) || ! et_pb_is_allowed( 'divi_builder_control' ) ) {
return;
}
// Don't add if VB is already enabled (legacy code handles "Exit" button).
if ( et_fb_is_enabled() ) {
return;
}
global $wp_admin_bar;
// Get page URL.
$page_url = et_fb_get_page_url();
// Build Visual Builder URL.
$use_visual_builder_url = et_fb_get_builder_url( $page_url );
// Add our button.
$wp_admin_bar->add_menu(
[
'id' => 'et-use-visual-builder',
'title' => esc_html__( 'Edit With Divi', 'et_builder_5' ),
'href' => esc_url( $use_visual_builder_url ),
]
);
}
/**
* Boot Visual Builder for non-singular pages with Theme Builder templates.
*
* The legacy `et_fb_app_boot()` function checks `et_pb_is_pagebuilder_used( get_the_ID() )`
* which fails for non-singular pages. This hook handles non-singular pages with Theme Builder
* templates by booting the Visual Builder app wrapper.
*
* @since ??
*
* @param string $content The content being filtered.
*
* @return string The content (possibly wrapped with VB app container).
*/
public function boot_vb_for_non_singular_theme_builder( string $content ): string {
if ( ! Conditions::is_non_singular_theme_builder_vb_context() ) {
return $content;
}
// Get Theme Builder layouts to determine what to render.
$theme_builder_layouts = et_theme_builder_get_template_layouts();
$has_header_layout = ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_HEADER_LAYOUT_POST_TYPE ]['enabled'] ) && ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_HEADER_LAYOUT_POST_TYPE ]['override'] );
$has_body_layout = ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ]['enabled'] ) && ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ]['override'] );
$has_footer_layout = ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_FOOTER_LAYOUT_POST_TYPE ]['enabled'] ) && ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_FOOTER_LAYOUT_POST_TYPE ]['override'] );
// If no Theme Builder templates are assigned, don't boot VB.
if ( ! $has_header_layout && ! $has_body_layout && ! $has_footer_layout ) {
return $content;
}
$class = apply_filters( 'et_fb_app_preloader_class', 'et-fb-page-preloading' );
$class = '' !== $class ? sprintf( ' class="%1$s"', et_core_esc_previously( esc_attr( $class ) ) ) : '';
// et_builder_render_layout is called for individual Theme Builder layout rendering.
// When a body template exists on non-singular pages, bootstrap VB from the body layout render path
// to avoid duplicate non-editable frontend output.
if ( doing_filter( 'et_builder_render_layout' ) ) {
if ( ! $has_body_layout ) {
return $content;
}
$rendering_post = \ET_Post_Stack::get();
$rendering_post_type = $rendering_post instanceof \WP_Post ? $rendering_post->post_type : get_post_type();
// Only replace body layout render output. Header and footer layout output must remain intact.
if ( ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE !== $rendering_post_type ) {
return $content;
}
// Check if content is already wrapped (legacy code might have handled it).
if ( str_contains( $content, 'id="et-fb-app"' ) ) {
return $content;
}
return sprintf( '', $class );
}
// For the_content path:
// - only process main query,
// - skip when body template exists (handled above in et_builder_render_layout path),
// - keep legacy sidebar behavior unchanged.
if ( ! is_main_query() || $has_body_layout ) {
return $content;
}
// Check if content is already wrapped (legacy code might have handled it).
if ( str_contains( $content, 'id="et-fb-app"' ) ) {
return $content;
}
// Check if legacy code already handled this (it might have for WC shop, etc.).
// We'll let legacy code handle sidebar layouts.
if ( et_fb_should_render_app_wrapper_around_main_content() ) {
// Exception: For non-singular pages (archives) where we're processing individual post content
// in the loop, we should return the content as-is for excerpt rendering, not the app wrapper.
// The app wrapper should only be used when rendering the actual page structure.
if ( in_the_loop() && is_main_query() ) {
$current_post = get_post();
// For non-builder posts in the loop, return content unchanged (for excerpts).
if ( $current_post && 'on' !== get_post_meta( $current_post->ID, '_et_pb_use_builder', true ) ) {
return $content;
}
}
// Mirror legacy app boot behavior: when wrapper is rendered around #main-content
// via et_before_main_content/et_after_main_content, the_content should only output
// body root placeholder.
return '';
}
// For non-singular pages without a body template, we need to preserve the normal WordPress content.
// The header and footer templates will be rendered via portals in the React app,
// but the normal archive/content needs to stay visible in the body area.
// The React app will detect non-singular pages without body templates and preserve existing content.
// Return app wrapper with normal content preserved in body-root.
// The React component checks for non-singular pages (archive/home/404) without body templates
// and skips rendering RootModules, preserving the existing WordPress content.
return sprintf( '', $class, $content );
}
/**
* Prevent legacy VB boot hook from running for non-singular pages with Theme Builder templates.
*
* This removes the legacy `et_fb_app_boot` hook for non-singular pages with TB templates,
* preventing it from creating fallback wrappers that interfere with our D5 implementation.
*
* @since ??
*
* @return void
*/
public function prevent_legacy_vb_boot_for_non_singular(): void {
if ( ! Conditions::is_non_singular_theme_builder_vb_context() ) {
return;
}
$theme_builder_layouts = et_theme_builder_get_template_layouts();
$has_body_layout = ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ]['enabled'] ) && ! empty( $theme_builder_layouts[ ET_THEME_BUILDER_BODY_LAYOUT_POST_TYPE ]['override'] );
// Remove the legacy hook to prevent it from creating fallback wrappers.
remove_filter( 'the_content', 'et_fb_app_boot', 1 );
remove_filter( 'et_builder_render_layout', 'et_fb_app_boot', 1 );
// Legacy main-content app wrapper actions are still useful for no-body-template
// non-singular pages (archive/category loops) because they wrap at page level
// rather than inside individual loop item content. Disable them only when body
// template exists to avoid nested wrappers.
if ( $has_body_layout ) {
remove_action( 'et_before_main_content', 'et_fb_print_app_wrapper_before_main_content', 1 );
remove_action( 'et_after_main_content', 'et_fb_print_app_wrapper_after_main_content', 999 );
remove_action( 'get_footer', 'et_fb_ensure_app_wrapper_closed_before_footer', 0 );
}
}
/**
* Force HTTP 200 for non-singular Theme Builder Visual Builder sessions on 404 pages.
*
* When VB is opened from a 404 frontend page that has assigned Theme Builder templates,
* WordPress can keep the main query and response status as 404. This normalizes the
* request to 200 so editor loading and related requests do not inherit the 404 status.
*
* @since ??
*
* @return void
*/
public function force_success_status_for_non_singular_theme_builder_vb(): void {
if ( ! Conditions::is_non_singular_theme_builder_vb_context() || ! is_404() ) {
return;
}
// Keep the request context as 404 so Theme Builder can resolve 404 template assignments.
// Only normalize the actual HTTP status code for Visual Builder loading.
status_header( 200 );
}
/**
* Check if any SVG plugin is available (not necessarily active in current context).
*
* @since ??
*
* @return bool True if SVG plugin is available.
*/
private function _is_svg_plugin_available(): bool {
// Check for Safe SVG plugin.
if ( class_exists( 'SafeSvg\\safe_svg' ) ) {
return true;
}
// Check for SVG Support plugin.
if ( function_exists( 'bodhi_svgs_init' ) ) {
return true;
}
// Check for Enable SVG Upload plugin.
if ( function_exists( 'wp_svg_allowed' ) ) {
return true;
}
// Check for Easy SVG Support plugin.
if ( function_exists( 'esw_add_support' ) ) {
return true;
}
// Do not fallback to generic allowed mime detection to avoid enabling
// SVG without a known sanitizer plugin present.
return false;
}
}