Weak hands cannot be planted, meager skills have no foundation. Shallow wisdom is futile, how can one hope for a good name?扰扰从役倦，屑屑身事微。少壮轻年月，迟暮惜光辉。
' === $content ) {
return $content;
}
// Quick check: Skip if content doesn't need migration.
if ( ! MigrationUtils::content_needs_migration(
$content,
self::$_release_version,
self::$_portfolio_modules,
self::$_portfolio_shortcode_modules
) ) {
return $content;
}
// Ensure the content is wrapped by wp:divi/placeholder if not empty.
$content = MigrationUtils::ensure_placeholder_wrapper( $content );
// Start migration context to prevent global layout expansion during migration.
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 ) {
// Skip if not a fullwidth portfolio module.
if ( ! in_array( $module_data['name'], self::$_portfolio_modules, true ) ) {
continue;
}
// Get current builder version for this module.
$current_version = $module_data['props']['attrs']['builderVersion'] ?? '0.0.0';
// Only migrate if current version is less than release version.
if ( StringUtility::version_compare( $current_version, self::$_release_version, '<' ) ) {
// Check if post_type is already set (avoid overriding existing values).
$existing_post_type = $module_data['props']['attrs']['portfolio']['innerContent']['desktop']['value']['type'] ?? null;
if ( null === $existing_post_type ) {
// Add post_type with D4's default value.
$new_value = [
'props' => [
'attrs' => [
'portfolio' => [
'innerContent' => [
'desktop' => [
'value' => [
'type' => 'project',
],
],
],
],
'builderVersion' => self::$_release_version,
],
],
];
$flat_objects[ $module_id ] = array_replace_recursive( $flat_objects[ $module_id ], $new_value );
$changes_made = true;
}
}
}
if ( $changes_made ) {
// Serialize the flat objects back into the content.
$blocks = MigrationUtils::flat_objects_to_blocks( $flat_objects );
$new_content = MigrationUtils::serialize_blocks( $blocks );
} else {
$new_content = $content;
}
return $new_content;
} finally {
// Always end migration context, even if an exception occurs.
MigrationContext::end();
}
}
/**
* Migrate shortcode-based content (new migration).
*
* @since ??
*
* @param string $content The content to migrate.
*
* @return string The migrated content.
*/
private static function _migrate_shortcode_content( $content ) {
// Remove shortcode-module blocks to avoid false positives.
$clean_content = preg_replace( '//s', '', $content );
// Check if content starts with shortcodes that need migration.
if ( 0 !== strpos( $clean_content, '[et_pb_' ) ) {
return $content;
}
// Parse shortcodes from content.
$parsed_shortcodes = ShortcodeMigration::process_shortcode( $content );
// Migrate the parsed shortcodes.
$parsed_shortcodes = self::migrate_parsed_shortcodes( $parsed_shortcodes );
// Convert back to shortcode string (filter will be applied automatically).
$new_content = ShortcodeMigration::process_to_shortcode( $parsed_shortcodes );
return $new_content;
}
/**
* Migrate parsed shortcodes by adding post_type attributes.
*
* @since ??
*
* @param array $parsed_shortcodes The parsed shortcodes array.
*
* @return array The migrated shortcodes array.
*/
public static function migrate_parsed_shortcodes( array $parsed_shortcodes ): array {
return self::_process_shortcodes_recursive( $parsed_shortcodes, self::$_portfolio_shortcode_modules, self::$_release_version );
}
/**
* Recursively processes shortcodes to add post_type attributes.
*
* @since ??
*
* @param array $shortcodes The shortcodes to process.
* @param array $portfolio_modules The modules that need post_type attributes.
* @param string $release_version The release version to set.
*
* @return array The processed shortcodes.
*/
private static function _process_shortcodes_recursive( array $shortcodes, array $portfolio_modules, string $release_version ): array {
foreach ( $shortcodes as &$shortcode ) {
// Check if this is a fullwidth portfolio module.
if ( in_array( $shortcode['name'], $portfolio_modules, true ) ) {
// Get current builder version, default to '0.0.0' if not set.
$current_version = $shortcode['attributes']['_builder_version'] ?? '0.0.0';
// Only migrate if current version is less than release version.
if ( StringUtility::version_compare( $current_version, $release_version, '<' ) ) {
// Check if post_type is already set (avoid overriding existing values).
if ( ! isset( $shortcode['attributes']['post_type'] ) ) {
// Add post_type attribute with D4's default value.
$shortcode['attributes']['post_type'] = 'project';
}
// Update builder version.
$shortcode['attributes']['_builder_version'] = $release_version;
}
}
// Recursively process nested content if it's an array.
if ( isset( $shortcode['content'] ) && is_array( $shortcode['content'] ) ) {
$shortcode['content'] = self::_process_shortcodes_recursive( $shortcode['content'], $portfolio_modules, $release_version );
}
}
return $shortcodes;
}
/**
* Migrate content from shortcode format.
*
* This method handles the migration of deprecated attributes in shortcode-based content.
* Currently returns the content unchanged as shortcode modules do not support
* the new custom attributes system that this migration targets.
*
* @since ??
*
* @param string $content The shortcode content to migrate.
*
* @return string The migrated content (currently unchanged).
*/
public static function migrate_content_shortcode( string $content ): string {
if ( ! self::has_divi_shortcode( $content ) ) {
return $content;
}
return self::_migrate_shortcode_content( $content );
}
/**
* Migrate content from