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 ) ) {
return $content;
}
// Store original content before wrapping to return unchanged if no migration needed.
$original_content = $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 ) {
// Check if module needs migration based on version comparison.
if (
StringUtility::version_compare( $module_data['props']['attrs']['builderVersion'] ?? '0.0.0', self::$_release_version, '<' )
) {
// Migrate module attributes recursively.
$original_attrs = $module_data['props']['attrs'];
$migrated_attrs = self::_migrate_module_attributes( $original_attrs );
// Check if any changes were made.
if ( $original_attrs !== $migrated_attrs ) {
$flat_objects[ $module_id ]['props']['attrs'] = $migrated_attrs;
$flat_objects[ $module_id ]['props']['attrs']['builderVersion'] = self::$_release_version;
$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 {
// Return original unwrapped content if no changes were made.
$new_content = $original_content;
}
return $new_content;
} finally {
// Always end migration context, even if an exception occurs.
MigrationContext::end();
}
}
/**
* Migrate module attributes by converting slug-based post_id to numeric ID in dynamic content.
*
* @since ??
*
* @param array $attrs Module attributes.
*
* @return array Migrated attributes.
*/
private static function _migrate_module_attributes( array $attrs ): array {
return self::_migrate_attributes_recursive( $attrs );
}
/**
* Recursively migrate attributes to convert slug-based post_id to numeric ID in dynamic content.
*
* @since ??
*
* @param mixed $value The value to check and migrate.
*
* @return mixed The migrated value.
*/
private static function _migrate_attributes_recursive( $value ) {
if ( is_string( $value ) ) {
return self::_convert_slug_to_id_in_dynamic_content( $value );
}
if ( is_array( $value ) ) {
$migrated = [];
foreach ( $value as $key => $item ) {
$migrated[ $key ] = self::_migrate_attributes_recursive( $item );
}
return $migrated;
}
return $value;
}
/**
* Convert slug-based post_id to numeric ID in dynamic content string.
*
* @since ??
*
* @param string $value The dynamic content string value to convert.
*
* @return string The converted value.
*/
private static function _convert_slug_to_id_in_dynamic_content( string $value ): string {
// Check if value is a dynamic content string.
if ( false === strpos( $value, '$variable(' ) || '$' !== substr( $value, -1 ) ) {
return $value;
}
// Extract the JSON content from $variable() wrapper.
if ( ! preg_match( '/\$variable\((.+?)\)\$/', $value, $matches ) ) {
return $value;
}
$json_content = $matches[1];
// Parse the JSON content.
$data_value = DynamicData::get_data_value( $json_content );
if ( empty( $data_value ) || ! isset( $data_value['type'], $data_value['value'] ) ) {
return $value;
}
// Only process 'content' type dynamic content.
if ( 'content' !== $data_value['type'] ) {
return $value;
}
$dynamic_value = $data_value['value'];
$name = $dynamic_value['name'] ?? '';
// Only process post_link_url_* options.
if ( empty( $name ) || 0 !== strpos( $name, 'post_link_url_' ) ) {
return $value;
}
$settings = $dynamic_value['settings'] ?? [];
$post_id = $settings['post_id'] ?? '';
// Skip if post_id is not set or is already numeric.
if ( empty( $post_id ) || is_numeric( $post_id ) ) {
return $value;
}
// Extract post type from name (e.g., "post_link_url_page" -> "page").
$post_type = str_replace( 'post_link_url_', '', $name );
// Get post ID by slug.
$resolved_post_id = DynamicContentOptionCustomPostLinkUrl::get_post_id_by_slug( $post_id, $post_type );
// If post ID was found, update the dynamic content string.
if ( null !== $resolved_post_id ) {
// Update settings with numeric ID.
$settings['post_id'] = (string) $resolved_post_id;
// Reconstruct the dynamic content string.
$new_data_value = [
'type' => 'content',
'value' => [
'name' => $name,
'settings' => $settings,
],
];
$new_json_content = wp_json_encode( $new_data_value, JSON_UNESCAPED_UNICODE );
return '$variable(' . $new_json_content . ')$';
}
// If post ID was not found, return original value (preserve slug for backward compatibility).
return $value;
}
/**
* Migrate content from shortcode format.
*
* This method handles the migration of slug-based post_id values in shortcode-based content.
* Currently returns the content unchanged as shortcode modules do not support
* Divi 5 dynamic content format.
*
* @since ??
*
* @param string $content The shortcode content to migrate.
*
* @return string The migrated content (current