Still on Drupal 7? Security support for Drupal 7 ended on 5 January 2025. Please visit our Drupal 7 End of Life resources page to review all of your options.
The Migrate Extras module provides extensions to Migrate (http://drupal.org/project/migrate)
to support various contributed modules. The ideal place to implement migration support
for a contributed module is in that module. That way, the migration support is always
self-consistent with the current module implementation - it's not practical for the
migrate_extras module to keep up with changes to all other contrib modules. Support
for contributed modules may be added to migrate_extras for two reasons - if the module's
maintainer does not accept a patch providing migration support, or as an intermediate
step before submitting such a patch to the other module.
In cases where modules supported by migrate_extras end up implementing the support
themselves, you could at least temporarily end up with redundant implementations.
The extra implementation may be disabled at admin/content/migrate/configure.
The following modules are currently supported in Migrate Extras on Drupal 7 (note
that Date module support has moved into the Date module itself):
Address Field
Entity API
Flag
Geofield
Interval
Media
Name Field
Pathauto
Phone Number (cck_phone)
Private Messages
Profile2
Rules
User Relationships
Voting API
Webform
Compatibility
-------------
This release of Migrate Extras requires Migrate V2.4-beta1 or later.
IMPORTANT: Automatic registration of new migration classes is no longer done on
a cache clear. Depending on automatic registration is now deprecated, and you
are encouraged to implement your migrations as DynamicMigration and explicitly
register them via hook_migrate_api() or MigrationBase::registerMigration().
If your migrations are not explicitly registered, you must request auto-registration
with a "drush mar" (drush migrate-auto-register) command, or by clicking the
"Register" button at admin/content/migrate/registration.
Bug fixes
- #1827052 - Properly check for bad XML.
Features and enhancements
- #1824024 - Destination and field handlers may now be registered through
hook_migrate_api(). Automatic registration of all migration and
handler classes may be disabled at admin/content/migrate/registration.
The handler configuration formerly at admin/content/migrate/configure
is now at admin/content/migrate/handlers.
- #1778952 - Update examples to emphasize explicit registration via
hook_migrate_api().
- #1819730 - Make migration of files in a field context non-fatal.
- #1816652 - Provide useful warning when file subfield arrays don't line up.