Updates Migrations: Rename Theme Option Fields

Migrates legacy ACF theme-option keys while retaining configured values.

Capabilities and extension points

Copies legacy ACF option rows to their descriptive field names.

Immutable migration identifier.

• var string

Parent version that introduced the field names.

• var string

Gets legacy prefixes keyed to their current equivalents.

• return array Legacy-to-current prefix map.

Determines whether an existing site contains legacy option references.

• param \Cherry\Blossom\Updates\Context $context Migration context.
• return bool Whether legacy rows should be copied.

Copies legacy option prefixes without replacing current values.

• param \Cherry\Blossom\Updates\Context $context Migration context.
• return true|\WP_Error True on success, or the failed prefix details.

Copies one complete ACF option prefix when destination rows are absent.

• param string $legacy_name Legacy ACF field name.
• param string $current_name Current ACF field name.
• return bool Whether every row is present at the destination.

Source reference

This editable reference page is based on the PHP documentation in updates/migrations/class-rename-theme-option-fields.php.