Weak hands cannot be planted, meager skills have no foundation. Shallow wisdom is futile, how can one hope for a good name?扰扰从役倦，屑屑身事微。少壮轻年月，迟暮惜光辉。 */ private static $_group_preset_items_cache = null; /** * Cached module preset data by module name. * * @since ?? * * @var array */ private static $_module_preset_items_cache = null; /** * Run the migration. * * @since ?? * * @return void */ public static function load(): void { add_filter( 'divi_framework_portability_import_migrated_post_content', [ __CLASS__, 'migrate_import_content' ] ); add_action( 'wp', [ __CLASS__, 'migrate_fe_content' ] ); add_filter( 'et_fb_load_raw_post_content', [ __CLASS__, 'migrate_vb_content' ], 10, 2 ); } /** * Get the migration name. * * @since ?? * * @return string */ public static function get_name() { return self::$_name; } /** * Get the release version for this migration. * * @since ?? * * @return string */ public static function get_release_version(): string { return self::$_release_version; } /** * Migrate import content. * * @since ?? * * @param string $content The content to migrate. * * @return string */ public static function migrate_import_content( $content ) { return self::_migrate_the_content( $content ); } /** * Migrate frontend content. * * @since ?? * * @return void */ public static function migrate_fe_content(): void { if ( ! Conditions::is_fe_and_should_migrate_content() ) { return; } $content = MigrationUtils::get_current_content(); if ( $content ) { add_filter( 'the_content', function ( $content ) { $new_content = self::_migrate_block_content( $content ); remove_filter( 'the_content', __FUNCTION__ ); return $new_content; }, 8 ); } $tb_template_ids = DynamicAssetsUtils::get_theme_builder_template_ids(); if ( ! empty( $tb_template_ids ) ) { add_filter( 'et_builder_render_layout', function ( $rendered_content ) { return self::_migrate_block_content( $rendered_content ); }, 8 ); } } /** * Migrate visual builder content. * * @since ?? * * @param string $content The content to migrate. * * @return string */ public static function migrate_vb_content( $content ) { return self::_migrate_the_content( $content ); } /** * Migrate content from all entry points. * * @since ?? * * @param string $content The content to migrate. * * @return string */ private static function _migrate_the_content( $content ) { if ( ! MigrationUtils::content_needs_migration( $content, self::$_release_version, [ 'divi/tabs', 'divi/blurb', 'divi/button', 'divi/comments' ] ) && ! self::_content_has_legacy_button_alignment_attr( $content ) && ! self::_content_has_button_custom_style_disabled_attr( $content ) ) { return $content; } return self::_migrate_block_content( $content ); } /** * Migrate block-based Tabs content. * * @since ?? * * @param string $content The content to migrate. * * @return string */ private static function _migrate_block_content( $content ) { if ( ! BlockParser::has_any_divi_block( $content ) || '' === $content ) { return $content; } if ( ! MigrationUtils::content_needs_migration( $content, self::$_release_version, [ 'divi/tabs', 'divi/blurb', 'divi/button', 'divi/comments' ] ) && ! self::_content_has_legacy_button_alignment_attr( $content ) && ! self::_content_has_button_custom_style_disabled_attr( $content ) ) { return $content; } $content = MigrationUtils::ensure_placeholder_wrapper( $content ); self::$_group_preset_items_cache = null; self::$_module_preset_items_cache = null; MigrationContext::start(); try { $flat_objects = MigrationUtils::parse_serialized_post_into_flat_module_object( $content, self::$_name ); $changes_made = false; foreach ( $flat_objects as $module_id => $module_data ) { $module_name = $module_data['name'] ?? ''; $current_version = $module_data['props']['attrs']['builderVersion'] ?? '0.0.0'; if ( ! StringUtility::version_compare( $current_version, self::$_release_version, '<' ) ) { continue; } $attrs = $module_data['props']['attrs'] ?? []; $module_changed = false; if ( 'divi/tabs' === $module_name ) { $module_changed = self::_migrate_tabs_module_attrs( $flat_objects, $module_id, $attrs ); } if ( 'divi/blurb' === $module_name ) { $module_changed = self::_migrate_blurb_module_attrs( $flat_objects, $module_id, $attrs ) || $module_changed; } if ( self::_has_legacy_button_alignment_attr( $attrs ) ) { $module_changed = self::_migrate_button_module_attrs( $flat_objects, $module_id, $attrs ) || $module_changed; } $updated_attrs = $flat_objects[ $module_id ]['props']['attrs'] ?? []; if ( self::_has_button_custom_style_disabled_attr( $updated_attrs ) ) { $module_changed = self::_migrate_disabled_button_custom_style_attrs( $flat_objects, $module_id ) || $module_changed; } if ( $module_changed ) { $changes_made = true; $flat_objects[ $module_id ]['props']['attrs']['builderVersion'] = self::$_release_version; } } if ( $changes_made ) { $blocks = MigrationUtils::flat_objects_to_blocks( $flat_objects ); return MigrationUtils::serialize_blocks( $blocks ); } return $content; } finally { MigrationContext::end(); } } /** * Migrate Tabs composable attributes. * * @since ?? * * @param array $flat_objects Flat parsed module object map. * @param string $module_id Current module ID. * @param array $attrs Current module attrs. * * @return bool */ private static function _migrate_tabs_module_attrs( array &$flat_objects, string $module_id, array $attrs ): bool { $has_inactive_tab_background = isset( $attrs['inactiveTab']['decoration']['background'] ); $has_new_tab_background = isset( $attrs['tab']['decoration']['background'] ); $has_deprecated_inactive_group = array_key_exists( 'inactiveTab', $attrs ); $has_tab_text_group_preset = isset( $attrs['groupPreset']['designTabText'] ); $has_active_group_preset = isset( $attrs['groupPreset']['designActiveTabText'] ); $module_changed = false; if ( $has_inactive_tab_background && ! $has_new_tab_background ) { $flat_objects[ $module_id ]['props']['attrs']['tab']['decoration']['background'] = $attrs['inactiveTab']['decoration']['background']; $module_changed = true; } if ( $has_deprecated_inactive_group ) { unset( $flat_objects[ $module_id ]['props']['attrs']['inactiveTab'] ); $module_changed = true; } // Keep preset behavior consistent after splitting Tab Text and Active Tab Text. if ( $has_tab_text_group_preset && ! $has_active_group_preset ) { $tab_text_group_preset = $attrs['groupPreset']['designTabText']; $active_group_preset = $tab_text_group_preset; $preset_ids_value = $tab_text_group_preset['presetId'] ?? []; $preset_ids = is_array( $preset_ids_value ) ? $preset_ids_value : [ $preset_ids_value ]; $active_preset_ids = []; foreach ( $preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id ) { continue; } $active_preset_ids[] = ComposibleOptionsPresetMigration::get_active_group_preset_id( $preset_id ); } if ( ! empty( $active_preset_ids ) ) { $existing_active_preset_ids = array_filter( $active_preset_ids, function ( $preset_id ) { return self::_group_preset_exists( 'divi/font', $preset_id ); } ); if ( ! empty( $existing_active_preset_ids ) ) { $active_group_preset['presetId'] = array_values( $existing_active_preset_ids ); $flat_objects[ $module_id ]['props']['attrs']['groupPreset']['designActiveTabText'] = $active_group_preset; $module_changed = true; } } } return $module_changed; } /** * Migrate Blurb legacy image/icon attrs to composable option groups. * * @since ?? * * @param array $flat_objects Flat parsed module object map. * @param string $module_id Current module ID. * @param array $attrs Current module attrs. * * @return bool */ private static function _migrate_blurb_module_attrs( array &$flat_objects, string $module_id, array $attrs ): bool { $image_icon_inner_content = $attrs['imageIcon']['innerContent'] ?? []; $breakpoints = [ 'desktop', 'tablet', 'phone' ]; $module_changed = false; $has_legacy_animation = false; $has_new_animation = false; foreach ( $breakpoints as $breakpoint ) { $new_sizing_alignment = $attrs['imageIcon']['decoration']['sizing'][ $breakpoint ]['value']['alignment'] ?? null; $legacy_alignment = $attrs['imageIcon']['advanced']['alignment'][ $breakpoint ]['value'] ?? null; if ( ! is_string( $legacy_alignment ) || '' === $legacy_alignment ) { $legacy_alignment = $attrs['imageIcon']['advanced']['alignment']['desktop']['value'] ?? null; } if ( ( ! is_string( $new_sizing_alignment ) || '' === $new_sizing_alignment ) && is_string( $legacy_alignment ) && '' !== $legacy_alignment ) { $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['sizing'][ $breakpoint ]['value']['alignment'] = $legacy_alignment; $module_changed = true; } $legacy_image_width = $attrs['imageIcon']['advanced']['width'][ $breakpoint ]['value']['image'] ?? null; $legacy_icon_width = $attrs['imageIcon']['advanced']['width'][ $breakpoint ]['value']['icon'] ?? null; $sizing_width_attr = self::_get_blurb_image_sizing_width_attr( $legacy_image_width ); $new_image_width = $attrs['imageIcon']['decoration']['sizing'][ $breakpoint ]['value'][ $sizing_width_attr ] ?? null; $new_icon_size = $attrs['imageIcon']['decoration']['sizing'][ $breakpoint ]['value']['iconFontSize'] ?? null; if ( ( ! is_string( $new_image_width ) || '' === $new_image_width ) && is_string( $legacy_image_width ) && '' !== $legacy_image_width ) { $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['sizing'][ $breakpoint ]['value'][ $sizing_width_attr ] = $legacy_image_width; $module_changed = true; } if ( ( ! is_string( $new_icon_size ) || '' === $new_icon_size ) && is_string( $legacy_icon_width ) && '' !== $legacy_icon_width ) { $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['sizing'][ $breakpoint ]['value']['iconFontSize'] = $legacy_icon_width; $module_changed = true; } $legacy_background = $attrs['imageIcon']['decoration']['background'][ $breakpoint ]['value'] ?? null; if ( is_string( $legacy_background ) ) { $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['background'][ $breakpoint ]['value'] = [ 'color' => $legacy_background, ]; $module_changed = true; } $new_animation = $attrs['imageIcon']['decoration']['animation'][ $breakpoint ]['value'] ?? null; if ( is_array( $new_animation ) && ! empty( $new_animation['style'] ) ) { $has_new_animation = true; } if ( ! is_array( $image_icon_inner_content ) || empty( $image_icon_inner_content ) ) { continue; } $legacy_animation = $image_icon_inner_content[ $breakpoint ]['value']['animation'] ?? null; if ( ! is_string( $legacy_animation ) || '' === $legacy_animation ) { continue; } $has_legacy_animation = true; $animation_style = 'off' === $legacy_animation ? 'none' : 'slide'; $animation_direction = in_array( $legacy_animation, [ 'top', 'left', 'right', 'bottom' ], true ) ? $legacy_animation : 'top'; $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['animation'][ $breakpoint ]['value'] = [ 'style' => $animation_style, 'direction' => $animation_direction, 'intensity' => [ 'slide' => '2', ], 'duration' => '600ms', ]; unset( $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['innerContent'][ $breakpoint ]['value']['animation'] ); $module_changed = true; } if ( isset( $attrs['imageIcon']['advanced']['width'] ) ) { unset( $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['advanced']['width'] ); $module_changed = true; } if ( isset( $attrs['imageIcon']['advanced']['alignment'] ) ) { unset( $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['advanced']['alignment'] ); $module_changed = true; } if ( ! $has_legacy_animation && ! $has_new_animation ) { if ( self::_has_blurb_inherited_preset_with_legacy_image_icon_animation( $attrs ) ) { return $module_changed; } $flat_objects[ $module_id ]['props']['attrs']['imageIcon']['decoration']['animation']['desktop']['value'] = [ 'style' => 'slide', 'direction' => 'top', 'intensity' => [ 'slide' => '2', ], 'duration' => '600ms', ]; $module_changed = true; } return $module_changed; } /** * Determine target sizing width attribute for legacy blurb image width migration. * * Maps pixel widths to width and all other units to maxWidth. * * @since ?? * * @param string|null $legacy_image_width Legacy image width value. * * @return string */ private static function _get_blurb_image_sizing_width_attr( ?string $legacy_image_width ): string { $legacy_image_width = is_string( $legacy_image_width ) ? strtolower( trim( $legacy_image_width ) ) : ''; return StringUtility::ends_with( $legacy_image_width, 'px' ) ? 'width' : 'maxWidth'; } /** * Migrate Button legacy alignment attrs to nested sizing alignment attrs. * * @since ?? * * @param array $flat_objects Flat parsed module object map. * @param string $module_id Current module ID. * @param array $attrs Current module attrs. * * @return bool */ private static function _migrate_button_module_attrs( array &$flat_objects, string $module_id, array $attrs ): bool { $breakpoints = [ 'desktop', 'tablet', 'phone' ]; $states = [ 'value', 'hover', 'sticky' ]; $module_changed = false; foreach ( $breakpoints as $breakpoint ) { foreach ( $states as $state ) { $legacy_alignment = $attrs['button']['decoration']['button'][ $breakpoint ][ $state ]['alignment'] ?? null; $new_alignment = $attrs['button']['decoration']['sizing'][ $breakpoint ][ $state ]['alignment'] ?? null; if ( is_string( $legacy_alignment ) && '' !== $legacy_alignment ) { if ( ! is_string( $new_alignment ) || '' === $new_alignment ) { $flat_objects[ $module_id ]['props']['attrs']['button']['decoration']['sizing'][ $breakpoint ][ $state ]['alignment'] = $legacy_alignment; $module_changed = true; } unset( $flat_objects[ $module_id ]['props']['attrs']['button']['decoration']['button'][ $breakpoint ][ $state ]['alignment'] ); if ( self::_cleanup_button_legacy_alignment_path( $flat_objects[ $module_id ]['props']['attrs'], $breakpoint, $state ) ) { $module_changed = true; } $module_changed = true; } } } return $module_changed; } /** * Determine whether serialized content may contain legacy button alignment attrs. * * @since ?? * * @param string $content Serialized block content. * * @return bool */ private static function _content_has_legacy_button_alignment_attr( string $content ): bool { return str_contains( $content, '"button":{"decoration":{"button"' ) && str_contains( $content, '"alignment"' ); } /** * Determine whether serialized content may contain disabled button custom style attrs. * * @since ?? * * @param string $content Serialized block content. * * @return bool */ private static function _content_has_button_custom_style_disabled_attr( string $content ): bool { return str_contains( $content, '"button":{"decoration":{"button"' ) && str_contains( $content, '"enable":"off"' ); } /** * Determine whether attrs contain legacy button alignment values. * * @since ?? * * @param array $attrs Module attrs. * * @return bool */ private static function _has_legacy_button_alignment_attr( array $attrs ): bool { $breakpoints = [ 'desktop', 'tablet', 'phone' ]; $states = [ 'value', 'hover', 'sticky' ]; foreach ( $breakpoints as $breakpoint ) { foreach ( $states as $state ) { $legacy_alignment = $attrs['button']['decoration']['button'][ $breakpoint ][ $state ]['alignment'] ?? null; if ( is_string( $legacy_alignment ) && '' !== $legacy_alignment ) { return true; } } } return false; } /** * Determine whether attrs contain disabled button custom style toggle. * * @since ?? * * @param array $attrs Module attrs. * * @return bool */ private static function _has_button_custom_style_disabled_attr( array $attrs ): bool { return 'off' === ( $attrs['button']['decoration']['button']['desktop']['value']['enable'] ?? null ); } /** * Migrate module attrs when button custom styles were disabled. * * Clears button decoration attrs while preserving sizing alignment values. * * @since ?? * * @param array $flat_objects Flat parsed module object map. * @param string $module_id Current module ID. * * @return bool */ private static function _migrate_disabled_button_custom_style_attrs( array &$flat_objects, string $module_id ): bool { $module_attrs = $flat_objects[ $module_id ]['props']['attrs'] ?? []; $before_attrs = $module_attrs; if ( ! isset( $module_attrs['button']['decoration'] ) || ! is_array( $module_attrs['button']['decoration'] ) ) { return false; } $alignment_sizing = self::_extract_button_alignment_sizing_attrs( $module_attrs ); unset( $module_attrs['button']['decoration'] ); if ( ! empty( $alignment_sizing ) ) { $module_attrs['button']['decoration']['sizing'] = $alignment_sizing; } $flat_objects[ $module_id ]['props']['attrs'] = $module_attrs; return $before_attrs !== $module_attrs; } /** * Extract button sizing alignment values from both new and legacy paths. * * @since ?? * * @param array $attrs Module attrs. * * @return array */ private static function _extract_button_alignment_sizing_attrs( array $attrs ): array { $breakpoints = [ 'desktop', 'tablet', 'phone' ]; $states = [ 'value', 'hover', 'sticky' ]; $alignment_sizing = []; foreach ( $breakpoints as $breakpoint ) { foreach ( $states as $state ) { $sizing_alignment = $attrs['button']['decoration']['sizing'][ $breakpoint ][ $state ]['alignment'] ?? null; $legacy_alignment = $attrs['button']['decoration']['button'][ $breakpoint ][ $state ]['alignment'] ?? null; $alignment_value = $sizing_alignment ?? $legacy_alignment; if ( is_string( $alignment_value ) && '' !== $alignment_value ) { $alignment_sizing[ $breakpoint ][ $state ]['alignment'] = $alignment_value; } } } return $alignment_sizing; } /** * Cleanup empty legacy button alignment containers after migration. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * @param string $state State key. * * @return bool */ private static function _cleanup_button_legacy_alignment_path( array &$attrs, string $breakpoint, string $state ): bool { $module_changed = false; if ( empty( $attrs['button']['decoration']['button'][ $breakpoint ][ $state ] ?? null ) ) { unset( $attrs['button']['decoration']['button'][ $breakpoint ][ $state ] ); $module_changed = true; } if ( empty( $attrs['button']['decoration']['button'][ $breakpoint ] ?? null ) ) { unset( $attrs['button']['decoration']['button'][ $breakpoint ] ); $module_changed = true; } return $module_changed; } /** * Check whether applied blurb preset inheritance contains legacy image/icon animation attrs. * * @since ?? * * @param array $attrs Module attrs. * * @return bool */ private static function _has_blurb_inherited_preset_with_legacy_image_icon_animation( array $attrs ): bool { if ( self::_has_blurb_module_preset_with_legacy_image_icon_animation( $attrs ) ) { return true; } return self::_has_blurb_group_preset_with_legacy_image_icon_animation( $attrs ); } /** * Check whether applied blurb module preset contains legacy image/icon animation attrs. * * @since ?? * * @param array $attrs Module attrs. * * @return bool */ private static function _has_blurb_module_preset_with_legacy_image_icon_animation( array $attrs ): bool { $module_preset_value = $attrs['modulePreset'] ?? []; $module_preset_ids = is_array( $module_preset_value ) ? $module_preset_value : [ $module_preset_value ]; foreach ( $module_preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || 'default' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_module_preset_item( 'divi/blurb', $preset_id ); if ( is_array( $preset_item ) && self::_preset_item_has_blurb_image_icon_animation_override( $preset_item ) ) { return true; } } return false; } /** * Check whether applied blurb group presets contain legacy image/icon animation attrs. * * @since ?? * * @param array $attrs Module attrs. * * @return bool */ private static function _has_blurb_group_preset_with_legacy_image_icon_animation( array $attrs ): bool { $group_presets = $attrs['groupPreset'] ?? []; if ( ! is_array( $group_presets ) || empty( $group_presets ) ) { return false; } foreach ( $group_presets as $group_preset ) { if ( ! is_array( $group_preset ) ) { continue; } $group_name = $group_preset['groupName'] ?? ''; if ( ! is_string( $group_name ) || '' === $group_name ) { continue; } $preset_ids_value = $group_preset['presetId'] ?? []; $preset_ids = is_array( $preset_ids_value ) ? $preset_ids_value : [ $preset_ids_value ]; foreach ( $preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || 'default' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_group_preset_item( $group_name, $preset_id ); if ( ! is_array( $preset_item ) ) { continue; } if ( self::_preset_item_has_blurb_image_icon_animation_override( $preset_item ) ) { return true; } } } return false; } /** * Determine whether blurb use icon toggle is enabled for a breakpoint. * * Falls back to desktop value when the current breakpoint value is missing. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return bool */ private static function _is_blurb_use_icon_enabled_for_breakpoint( array $attrs, string $breakpoint ): bool { $use_icon = $attrs['imageIcon']['innerContent'][ $breakpoint ]['value']['useIcon'] ?? null; if ( ! is_string( $use_icon ) || '' === $use_icon ) { $use_icon = $attrs['imageIcon']['innerContent']['desktop']['value']['useIcon'] ?? null; } if ( ! is_string( $use_icon ) || '' === $use_icon ) { $use_icon = self::_get_blurb_inherited_use_icon_value( $attrs, $breakpoint ); } return 'on' === $use_icon; } /** * Resolve inherited blurb use icon toggle value from applied presets. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_inherited_use_icon_value( array $attrs, string $breakpoint ): ?string { $module_preset_use_icon = self::_get_blurb_module_preset_use_icon_value( $attrs, $breakpoint ); if ( is_string( $module_preset_use_icon ) && '' !== $module_preset_use_icon ) { return $module_preset_use_icon; } return self::_get_blurb_group_preset_use_icon_value( $attrs, $breakpoint ); } /** * Resolve inherited blurb use icon value from applied module presets. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_module_preset_use_icon_value( array $attrs, string $breakpoint ): ?string { $module_preset_value = $attrs['modulePreset'] ?? []; $module_preset_ids = is_array( $module_preset_value ) ? $module_preset_value : [ $module_preset_value ]; foreach ( $module_preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_module_preset_item( 'divi/blurb', $preset_id ); $use_icon_value = self::_get_blurb_use_icon_value_from_preset_item( $preset_item, $breakpoint ); if ( is_string( $use_icon_value ) && '' !== $use_icon_value ) { return $use_icon_value; } } return null; } /** * Resolve inherited blurb use icon value from applied group presets. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_group_preset_use_icon_value( array $attrs, string $breakpoint ): ?string { $group_presets = $attrs['groupPreset'] ?? []; if ( ! is_array( $group_presets ) || empty( $group_presets ) ) { return null; } foreach ( $group_presets as $group_preset ) { if ( ! is_array( $group_preset ) ) { continue; } $group_name = $group_preset['groupName'] ?? ''; if ( ! is_string( $group_name ) || '' === $group_name ) { continue; } $preset_ids_value = $group_preset['presetId'] ?? []; $preset_ids = is_array( $preset_ids_value ) ? $preset_ids_value : [ $preset_ids_value ]; foreach ( $preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_group_preset_item( $group_name, $preset_id ); $use_icon_value = self::_get_blurb_use_icon_value_from_preset_item( $preset_item, $breakpoint ); if ( is_string( $use_icon_value ) && '' !== $use_icon_value ) { return $use_icon_value; } } } return null; } /** * Resolve blurb use icon value from preset item attrs/style attrs. * * @since ?? * * @param array|null $preset_item Preset item. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_use_icon_value_from_preset_item( ?array $preset_item, string $breakpoint ): ?string { if ( ! is_array( $preset_item ) ) { return null; } $attr_groups = [ 'attrs', 'renderAttrs', 'styleAttrs' ]; foreach ( $attr_groups as $attr_group ) { $attrs = $preset_item[ $attr_group ] ?? []; if ( ! is_array( $attrs ) ) { continue; } $use_icon_value = $attrs['imageIcon']['innerContent'][ $breakpoint ]['value']['useIcon'] ?? null; if ( ! is_string( $use_icon_value ) || '' === $use_icon_value ) { $use_icon_value = $attrs['imageIcon']['innerContent']['desktop']['value']['useIcon'] ?? null; } if ( is_string( $use_icon_value ) && '' !== $use_icon_value ) { return $use_icon_value; } } return null; } /** * Resolve inherited legacy blurb icon width from applied presets for a breakpoint. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_inherited_legacy_icon_width( array $attrs, string $breakpoint ): ?string { $module_preset_width = self::_get_blurb_module_preset_legacy_icon_width( $attrs, $breakpoint ); if ( is_string( $module_preset_width ) && '' !== $module_preset_width ) { return $module_preset_width; } return self::_get_blurb_group_preset_legacy_icon_width( $attrs, $breakpoint ); } /** * Resolve inherited legacy blurb icon width from applied module presets. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_module_preset_legacy_icon_width( array $attrs, string $breakpoint ): ?string { $module_preset_value = $attrs['modulePreset'] ?? []; $module_preset_ids = is_array( $module_preset_value ) ? $module_preset_value : [ $module_preset_value ]; foreach ( $module_preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_module_preset_item( 'divi/blurb', $preset_id ); $width_value = self::_get_blurb_legacy_icon_width_from_preset_item( $preset_item, $breakpoint ); if ( is_string( $width_value ) && '' !== $width_value ) { return $width_value; } } return null; } /** * Resolve inherited legacy blurb icon width from applied group presets. * * @since ?? * * @param array $attrs Module attrs. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_group_preset_legacy_icon_width( array $attrs, string $breakpoint ): ?string { $group_presets = $attrs['groupPreset'] ?? []; if ( ! is_array( $group_presets ) || empty( $group_presets ) ) { return null; } foreach ( $group_presets as $group_preset ) { if ( ! is_array( $group_preset ) ) { continue; } $group_name = $group_preset['groupName'] ?? ''; if ( ! is_string( $group_name ) || '' === $group_name ) { continue; } $preset_ids_value = $group_preset['presetId'] ?? []; $preset_ids = is_array( $preset_ids_value ) ? $preset_ids_value : [ $preset_ids_value ]; foreach ( $preset_ids as $preset_id ) { if ( ! is_string( $preset_id ) || '' === $preset_id || '_initial' === $preset_id ) { continue; } $preset_item = self::_get_group_preset_item( $group_name, $preset_id ); $width_value = self::_get_blurb_legacy_icon_width_from_preset_item( $preset_item, $breakpoint ); if ( is_string( $width_value ) && '' !== $width_value ) { return $width_value; } } } return null; } /** * Resolve legacy blurb icon width from preset item attrs/style attrs. * * @since ?? * * @param array|null $preset_item Preset item. * @param string $breakpoint Breakpoint key. * * @return string|null */ private static function _get_blurb_legacy_icon_width_from_preset_item( ?array $preset_item, string $breakpoint ): ?string { if ( ! is_array( $preset_item ) ) { return null; } $attr_groups = [ 'attrs', 'renderAttrs', 'styleAttrs' ]; foreach ( $attr_groups as $attr_group ) { $attrs = $preset_item[ $attr_group ] ?? []; if ( ! is_array( $attrs ) ) { continue; } $width_value = $attrs['imageIcon']['advanced']['width'][ $breakpoint ]['value']['icon'] ?? null; if ( ! is_string( $width_value ) || '' === $width_value ) { $width_value = $attrs['imageIcon']['advanced']['width']['desktop']['value']['icon'] ?? null; } if ( is_string( $width_value ) && '' !== $width_value ) { return $width_value; } } return null; } /** * Get module preset item by module and preset id. * * @since ?? * * @param string $module_name Module name. * @param string $preset_id Preset ID. * * @return array|null */ private static function _get_module_preset_item( string $module_name, string $preset_id ): ?array { if ( '' === $module_name || '' === $preset_id ) { return null; } if ( null === self::$_module_preset_items_cache ) { $presets_data = GlobalPreset::get_data(); self::$_module_preset_items_cache = []; foreach ( $presets_data['module'] ?? [] as $preset_module_name => $module_data ) { self::$_module_preset_items_cache[ $preset_module_name ] = $module_data['items'] ?? []; } } $preset_item = self::$_module_preset_items_cache[ $module_name ][ $preset_id ] ?? null; return is_array( $preset_item ) ? $preset_item : null; } /** * Migrate shortcode content. * * @since ?? * * @param string $content The shortcode content. * * @return string */ public static function migrate_content_shortcode( string $content ): string { return $content; } /** * Migrate block content. * * @since ?? * * @param string $content The block content. * * @return string */ public static function migrate_content_block( string $content ): string { if ( ! self::has_divi_block( $content ) ) { return $content; } return self::_migrate_block_content( $content ); } /** * Check if group preset exists in global preset data. * * @since ?? * * @param string $group_name Group preset name. * @param string $preset_id Preset ID. * * @return bool */ private static function _group_preset_exists( string $group_name, string $preset_id ): bool { return null !== self::_get_group_preset_item( $group_name, $preset_id ); } /** * Get group preset item by group and preset id. * * @since ?? * * @param string $group_name Group preset name. * @param string $preset_id Preset ID. * * @return array|null */ private static function _get_group_preset_item( string $group_name, string $preset_id ): ?array { if ( '' === $group_name || '' === $preset_id ) { return null; } if ( null === self::$_group_preset_items_cache ) { $presets_data = GlobalPreset::get_data(); self::$_group_preset_items_cache = []; foreach ( $presets_data['group'] ?? [] as $preset_group_name => $group_data ) { self::$_group_preset_items_cache[ $preset_group_name ] = $group_data['items'] ?? []; } } $preset_item = self::$_group_preset_items_cache[ $group_name ][ $preset_id ] ?? null; return is_array( $preset_item ) ? $preset_item : null; } /** * Check whether preset item contains blurb image/icon animation override attrs. * * @since ?? * * @param array $preset_item Preset item. * * @return bool */ private static function _preset_item_has_blurb_image_icon_animation_override( array $preset_item ): bool { $attr_groups = [ 'attrs', 'renderAttrs', 'styleAttrs' ]; foreach ( $attr_groups as $attr_group ) { $attrs = $preset_item[ $attr_group ] ?? []; if ( ! is_array( $attrs ) ) { continue;