Releases for Migrate

Issue #2909252: 'clone' is a reserved keyword introduced in PHP version 5.0.
Issue #2946164: Remove usage of deprecrated each() function for PHP 7.2+ future proofing.
Issue #2796169: Using a better supported encryption library than mcrypt (Required for PHP 7.2 support).
Issue #2907166: Warning: sourceDataForm() expected to be a reference
Issue #2850753: d7 mysql 5.7 compatibility null handling in sqlmap.inc.
Issue #2644762: Invalid argument for foreach on entity.inc, line 199.

Migrate 2.8

See SA-CONTRIB-2015-130

Migrate 2.7

Bug fixes

- #2415597 - Make batching of SQL sources optional, and force map_joinable FALSE.

Migrate 2.7 Release Candidate 1

Features and enhancements

- #2296911 - Add a source handler for IBM DB2.
- #2256761 - Add a destination handler for variables.
- #2047815 - Support multi-column source keys in idlist.
- #1751438 - Add spreadsheet source plugin.

Migrate 2.6

IMPORTANT CHANGES SINCE MIGRATE 2.5

Migration developers will need to add the "advanced migration information"
permission to their roles to continue seeing all the info in the UI they're
used to.

Migrate 2.6 Release Candidate 1

Migration developers will need to add the "advanced migration information" permission to their roles to continue seeing all the info in the UI they're used to.

Auto-registration (having classes be registered just based on their class name, with no call to registerMigration or definition in hook_migrate_api()) is no longer supported. Registration of classes defined in hook_migrate_api() is no
longer automatic - do a drush migrate-register or use the Register button in the UI to register them.

Migration class constructors should now always accept a $arguments array as the first parameter and pass it to its parent. This version does support legacy migrations which pass a group object, or nothing, but that support will be
removed in a future version.

Features and enhancements

- #1998632 - Extend MigrateItemsXML to handle an array of XML files.
- #1990612 - Add a row status argument to MigrateException, allowing rows to be cleanly skipped by throwing exceptions.
- #2017835 - Add MigrateFileUriAsIs file class, and make file migrations more flexible.
- #2004426 - UI support for editing dependencies; enable setting dependencies through arguments.

Bug fixes

- #2025137 - Ignore --update in the presence of --idlist.
- #2023813 - Apply defaultValue() for empty XML values.

Migrate 2.5
===========

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.

Migrate 2.5 Release Candidate 2
===============================

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.

Bug fixes

Migrate 2.5 Release Candidate 2
===============================

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.

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.

Bug fixes
- #1824118 - Make --force work for rollbacks.

Migrate 2.5 Release Candidate 1
===============================

Migrate 2.5 Release Candidate 1
===============================

IMPORTANT: Automatic registration of new migration classes is no longer done on
a cache clear - you must explicitly request it with a "drush mar" (drush
migrate-auto-register) command, or by clicking the "Register migration changes"
button at admin/content/migrate/configure.

Features and enhancements
- #1778952 - Enable registration of dynamic migrations via hook_migrate_api().
Add explicit auto-registration of non-dynamic migrations, remove
performing registration on cache clear.
- #1421974 - Add queueMessage(), so messages can be generated in prepareRow().
- #1626374 - Allow creation of duplicate terms.
- #1810306 - Allow multi-value keys in MigrteItemJSON.
- #1799964 - Add reference query getter to MigrateSourceSQL.
- #1670410 - Sanity-check migration machine names.
- #1637458 - Pass field instance rather than just field name to field() methods.
- #1688312 - Allow any file field argument to have per-instance values.
- #1701764 - Add prepareKey() method to customize source keys.
- #1703050 - Add track_last_imported option for maps.
- #1690092 - Protect migrations, or specific rows, from rollback.
- #1672572 - Stifle mapping override messages.
- #1621608 - Support for splitting files on import.

Migrate 2.4
===========

IMPORTANT: The file migration support (both MigrateDestinationFile and
the file field handler) has been completely refactored since Migrate 2.3 - if you
are importing files as part of your migration, you MUST change your migrations
to properly use the new implementation. See http://drupal.org/node/1540106 for
details on how to use the new handlers and destination.

Features and enhancements
- #1606586 - Add activeUrl public method to MigrateSourceXML.

Bug fixes
- #1614318 - MigrateFileUri failed to pass file object through.
- #1601974 - Remove percent sign fix-up, leave to particular application.
- #1600912 - Base constructor was undermining UI override of displayFunction.
- #1595056 - Handle empty arguments from migrate_status table.
- #1595166 - Support multiple source keys in MigrateList.

Migrate 2.4 Release Candidate 1
===============================

Features and enhancements
- #1587842 - Remove sample CSV files from migrate project.
- #1152878 - drush migrate-analyze command, for source data analysis.
- #1587566 - Support escape option for CSV sources on PHP 5.3.
- #1189328 - UI option to ignore dependencies.
- #1016452 - Support migrating user role assignments by name.
- #653636 - Add migrate-messages command to dump message table.

Bug fixes

Migrate 2.4 Release Candidate 1
===============================

IMPORTANT: The file migration support (both MigrateDestinationFile and
the file field handler) has been completely refactored since Migrate 2.3 - if you
are importing files as part of your migration, you MUST change your migrations
to properly use the new implementation. See http://drupal.org/node/1540106 for
details on how to use the new handlers and destination.

Features and enhancements
- #1587842 - Remove sample CSV files from migrate project.
- #1152878 - drush migrate-analyze command, for source data analysis.
- #1587566 - Support escape option for CSV sources on PHP 5.3.
- #1189328 - UI option to ignore dependencies.
- #1016452 - Support migrating user role assignments by name.
- #653636 - Add migrate-messages command to dump message table.

Bug fixes
- #919108 - Cleaner error-handling when updating destinations that don't exist.
- #1574502 - Coder review, remove dead code.
- #1570536 - Undefined property in term.inc.

Migrate 2.4 Beta 1
==================

Features and enhancements
- #1428166 - Make message columns sortable.
- #1459888 - Removed deprecated source count(), showMessage(), setOutputFunction().
- #1528916 - Link field descriptions to drupal.org documentation.
- #722686 - Support for node statistics.
- #1299646 - Enforce dependencies on rollback.

Migrate 2.4 Beta 1
==================

Features and enhancements
- #1428166 - Make message columns sortable.
- #1459888 - Removed deprecated source count(), showMessage(), setOutputFunction().
- #1528916 - Link field descriptions to drupal.org documentation.
- #722686 - Support for node statistics.
- #1299646 - Enforce dependencies on rollback.
- #1328408 - Support --group on drush migrate-status.
- #1402822 - Cleaner handling of exceptions from source plugins.
- #1350284 - Visually group migrations by group in drush.

Bug fixes
- #1569612 - skip_empty should only skip NULL values.
- #1438282 - Handle errors thrown when getting counts.
- #1358318 - Fix dedupe() overdeduping on --update.
- #1538046 - Give highwater marks a chance at preparation before using them.
- #1408248 - Handle errors in complete() cleanly.
- #1529362 - Make proper check if previously imported.
- #1542922 - Fix XML parsing bug.
- #1538508 - Fix notice when mapping parent_name.
- #1537352 - Check limits and status before next().
- #1540120 - Zero not working as defaultValue.
- #1508654 - MigrateSourceQL needs to respect join aliases.
- #1518076 - UI side of subfield handling.
- #1480762 - Fix cross-database joins to map table.
- #1520688 - setDisplayFunction needs to be static.
- #1512020 - Fix CSS class on the limit field.

Migrate 2.3
===========

Features and enhancements
- #1315910 - Added migrate-deregister drush command.

Bug fixes
- #1450950 - Convert user datetimes values to timestamps.
- #1437208 - Handle malformed CSV files quietly.
- #1413350 - Support invoking subprocesses under Drush 5.
- #1404732 - Properly call taxonomy_term handler fields() method.

Migrate 2.3 RC1
===============

Features and enhancements
- #1437076 - Make Migration class field mapping methods public.
- #1430528 - Document importance of migrating term parents first.
- #1414616 - Automatically update migration arguments.
- #1401810 - Extended MigrateSourceXML to accept multiple XML files.
- #1403222 - Relaxed setting of bundle for node destinations.
- #1364326 - Default --limit option to items.
- #1337640 - Properly optimize the SQL source query for highwater marks.
- #1366588 - Source plugin support has been refactored to put more of the common
processing in the base class. When implementing a source plugin,
implement performRewind() and getNextRow().
- #1355940 - Track all source rows in the map table.
- #941440 - Autodetection of source fields when unspecified.
- #1341776 - Add option to skip source counting.
- #1342936 - Pass source key in calls to Migration::createStub().
- #1331912 - Catch exception due to skipped beginProcess().

Migrate 2.3 RC1
===============

Features and enhancements
- #1437076 - Make Migration class field mapping methods public.
- #1430528 - Document importance of migrating term parents first.
- #1414616 - Automatically update migration arguments.
- #1401810 - Extended MigrateSourceXML to accept multiple XML files.
- #1403222 - Relaxed setting of bundle for node destinations.
- #1364326 - Default --limit option to items.
- #1337640 - Properly optimize the SQL source query for highwater marks.
- #1366588 - Source plugin support has been refactored to put more of the common
processing in the base class. When implementing a source plugin,
implement performRewind() and getNextRow().
- #1355940 - Track all source rows in the map table.
- #941440 - Autodetection of source fields when unspecified.
- #1341776 - Add option to skip source counting.
- #1342936 - Pass source key in calls to Migration::createStub().
- #1331912 - Catch exception due to skipped beginProcess().
- #1337810 - Documented hooks in migrate.api.php.
- #1342322 - Added default implementation of prepareRow(), simplifying source plugins.
- #1336534 - Added MigrateSourceXML for efficient handling of large XML files.
- #1330552 - Provide more detail on bad field mappings.
- #1321078 - Display incomplete dependencies in the error message.

Migrate 2.2
===============

Bug fixes
- #1265514 - Fixed error message for failed XML load in MigrateItemsXML.

Migrate 2.2 RC2
===============

Features and enhancements
- #1226768 - Improved exception handling.
- #1230294 - Get correct count of CSV with embedded newlines.
- #1185632 - Handle (potentially multiple) headers in CSV source plugin.

Bug fixes
- #1231398 - Add map data to row in Oracle source plugin.
- #1227130 - On import, clear messages before applyMappings().
- #1195802 - Fixed SQL Server problem handling end of batch; brought Oracle/SQL
Server implementations in line with each other.
- #1223468 - Make sure getIDsFromXML always returns an array.
- #1195802 - Fixed prepareRow() support for MSSQL plugin.

Migrate 2.2 RC1
===============

Features and enhancements
- #1212818 - migrate_ui support for one-step rollback-and-import.
- #719650 - Implemented ability to assign migrations to groups, and run by group.
- #1201762 - Implemented built-in caching for source counts, and flag to enable it.
- #1195802 - Added prepareRow() support for MSSQL plugin.
- #1195784 - Added verification of required extension to MSSQL plugin.
- #1181720 - Add item/second limiting to UI.
- #1179464 - Added capability of disabling handlers.
- #1175094 - Added support for field handler complete() methods.

Migrate 2.2 RC2
===============

Features and enhancements
- #1240928 - Generalize file handlers, to ease media module support.
- #1226768 - Improved exception handling.
- #1230294 - Get correct count of CSV with embedded newlines.
- #1185632 - Handle (potentially multiple) headers in CSV source plugin.

Bug fixes
- #1231398 - Add map data to row in Oracle source plugin.
- #1225636 - File field: fixed warnings, added docs.
- #1227130 - On import, clear messages before applyMappings().
- #1195802 - Fixed SQL Server problem handling end of batch; brought Oracle/SQL
Server implementations in line with each other.
- #1205278 - Fixed file entity rollback to preserve files when requested.
- #1223468 - Make sure getIDsFromXML always returns an array.
- #1223734 - Fixed bogus assignment of uid to file fields.
- #1223756 - Fix warnings with file_blob when file exists in file_managed.
- #1216796 - Make sure file_replace argument exists.
- #1195802 - Fixed prepareRow() support for MSSQL plugin.

Migrate 2.2 RC1
===============

Features and enhancements
- #1210152 - Improved error messages on file field migration.
- #1212818 - migrate_ui support for one-step rollback-and-import.
- #1218244 - Support for is_new for users.
- #1216796 - Use file_destination() to generate destination filespec.

Migrate 2.2 RC1
===============

Features and enhancements
- #1212818 - migrate_ui support for one-step rollback-and-import.
- #719650 - Implemented ability to assign migrations to groups, and run by group.
- #1201762 - Implemented built-in caching for source counts, and flag to enable it.
- #1195802 - Added prepareRow() support for MSSQL plugin.
- #1195784 - Added verification of required extension to MSSQL plugin.
- #1181720 - Add item/second limiting to UI.
- #1179464 - Added capability of disabling handlers.
- #1175094 - Added support for field handler complete() methods.
- #1176930 - Renamed migrate-descriptions to migrate-mappings, enhanced to export to CSV.
- #1169724 - Implemented source plugin for Oracle.

Bug fixes
- #1185046 - Wine example mistakenly said GROUP_CONCAT could only be used once.
- #1181652 - Fixed MigrateDestinationTable to work on update.
- #1174934 - Support multi-column keys for table_copy destination.
- #1171840 - Delete temporary files when importing URLs to filefields.
- #1176790 - Prevent multiple handlers from messing up fields info.

Migrate 2.1
===========

Features and enhancements:
- #1025754 - Added support for multi-value source keys to handleSourceMigration().
- #1161584 - Added lookupSourceID() and lookupDestinationID() to MigrateMap.

Bug fixes
- #1161612 - Handle integer highwater marks properly.

Migrate 2.1
===========

Features and enhancements:
- #1025754 - Added support for multi-value source keys to handleSourceMigration().
- #1161584 - Added lookupSourceID() and lookupDestinationID() to MigrateMap.

Bug fixes
- #1161612 - Handle integer highwater marks properly.
- #1161812 - Added handling for NULL watchdog variables.
- #1009708 - Fixed E_STRICT notice on MigrateDestinationRole::getKeySchema().
- #1161590 - Made $migration optional for handleSourceMigration(), createStubWrapper(),
lookupDestinationID().
- #1161482 - Handle NULL source_field mappings.
- #1156972 - Do not include message table in source queries.
- #1156928 - Always load account for filefields.
- #1157250 - Fixed migrate_ui menu entry to show under admin/content.
- #1157078 - Drupal 6 filefields have list property, not display.

Migrate 2.1 Beta 1
==================

API change:

Any field handler prepare() or complete() methods you have defined must be changed
to remove stdClass for the $entity argument. I.e., prepare(stdClass $entity, stdClass $row)
should now be prepare($entity, stdClass $row).

Requirements change:

The migrate_ui submodule now requires the Elements module (http://drupal.org/project/elements)
to support performing operations from the dashboard. Install and enable Elements

Migrate 2.1 Beta 1
==================

API change:

Any field handler prepare() or complete() methods you have defined must be changed
to remove stdClass for the $entity argument. I.e., prepare(stdClass $entity, stdClass $row)
should now be prepare($entity, stdClass $row).

Features and enhancements
- #1017246 - Added support for running migrations from the dashboard.
- #1004812 - Added schema-driven table destination plugin.
- #1009708 - Added role destination plugin.
- #737170 - Added support for field level callbacks.
- #1005090 - Modified filefield property import to use JSON input.
- #730980 - Added more detailed reporting on import.
- #1142384 - Extended file field support to copy from remote URLs.
- #1138096 - Added MigrateSourceMultiItems class for self-contained XML sources.
- #1101586 - Add shortcut methods for adding several field mappings at once.
- #1101592 - Replace --itemlimit with --limit, supporting time limits as well.
- #1139080 - Added example and test for importing profile pictures over http.

Bug fixes
- #1155740 - Make remote file fetch HTTP version independent
- #1037872 - Deal with updates with idlists when mapping nids directly.
- #943546 - Make sure both slashes and backslashes are trimmed where necessary.
- #1146366 - Fixed rollback of table destinations.
- #1148474 - Enforce unique IDs in MigrateItemsXML.

IMPORTANT: This is the final release of Migrate V1 - there will be no more support for
this version of Migrate going forward.

Migrate 1.2
===========
Bug fixes
- #1010308 - Support Views 3.0.
- #736998 - Reset update flag so it isn't continously applied.
- #1008066 - Clean up drush warnings on --all.
- #891356 - Export comment noting install-time restriction.

Migrate 2.0
===========
No changes since RC3.

Migrate 2.0 Release Candidate 3
===============================

Features and enhancements
Added JSON source plugin.
CSV source backported from D7.

Bug fixes
- #940984 - Avoid user insert errors on some MySQL versions.
- #1079416 - postRollback called outside of rollback operation.
- #1079438 - Simpletest notices on D6.
- #1063926 - prepareRow() call missing from MigrateSourceList.
- #1061284 - Appropriately translate watchdog severities to migrate severities.

Migrate 2.0 Release Candidate 2
===============================

Bug fixes
- #1058942 - Flush cache on enable to make sure classes get registered.
- migrate_example error when auto_nodetitle module not present.
- #1053798 - Missing 'debug' on showMessage.

Migrate 2.0 Release Candidate 1
===============================

Features and enhancements
- #919108 - Add deleteDestination() for maps; cache migration list.
- #996086 - Add prepareRollback and completeRollback methods for entities.
- #1039882 - Pass client migration to stub creation. Note that $migration->values
(the destination object being built) is now $migration->destinationValues - any
migrations referencing this member will need to change.
- #946350 - Accept arrays in sourceMigration();
Moved filefield support from migrate_extras to migrate, for consistency with D7.

Migrate 2.0 Release Candidate 3
===============================

Features and enhancements
Added JSON source plugin.
CSV source backported from D7.

Bug fixes
- #940984 - Avoid user insert errors on some MySQL versions.
- #1079416 - postRollback called outside of rollback operation.
- #1079438 - Simpletest notices on D6.
- #1063926 - prepareRow() call missing from MigrateSourceList.
- #1061284 - Appropriately translate watchdog severities to migrate severities.

Migrate 2.0 Release Candidate 2
===============================

Bug fixes
- #1058942 - Flush cache on enable to make sure classes get registered.
- migrate_example error when auto_nodetitle module not present.
- #1053798 - Missing 'debug' on showMessage.

Migrate 2.0 Release Candidate 1
===============================

Features and enhancements
- #919108 - Add deleteDestination() for maps; cache migration list.
- #996086 - Add prepareRollback and completeRollback methods for entities.
- #1039882 - Pass client migration to stub creation. Note that $migration->values
(the destination object being built) is now $migration->destinationValues - any
migrations referencing this member will need to change.
- #946350 - Accept arrays in sourceMigration();
Moved filefield support from migrate_extras to migrate, for consistency with D7.

Migrate 2.0 Release Candidate 2
===============================

Bug fixes
- #1058942 - Flush cache on enable to make sure classes get registered.
- migrate_example error when auto_nodetitle module not present.
- #1053798 - Missing 'debug' on showMessage.

Migrate 2.0 Release Candidate 1
===============================

Features and enhancements
- #919108 - Add deleteDestination() for maps; cache migration list.
- #996086 - Add prepareRollback and completeRollback methods for entities.
- #1039882 - Pass client migration to stub creation. Note that $migration->values
(the destination object being built) is now $migration->destinationValues - any
migrations referencing this member will need to change.
- #946350 - Accept arrays in sourceMigration();
Moved filefield support from migrate_extras to migrate, for consistency with D7.
Let a node migration set node_revisions.uid. Thats the 'last edited by' user

Bug fixes
- #1053798 - Consistent use of error codes.
- #1053526 - Machine names in drush commands now case-insensitive.
- #919706 - Fix drush migrate-descriptions command.
- #1027468 - Limit map/message table name lengths.
- #1045646 - Handle PHP memory_limit of -1.
- #1050348 - Check map table existence in correct DB.
- #1028824 - Errors during registry rebuild trigger fatal error.
Fix highwater handling to deal with duplicate values.

Migrate 2.0 Release Candidate 1
===============================

Features and enhancements
- #919108 - Add deleteDestination() for maps; cache migration list.
- #1005090 - Support multiple values for file fields.
- #996086 - Add prepareRollback and completeRollback methods for entities.
- #1039882 - Pass client migration to stub creation. Note that $migration->values
(the destination object being built) is now $migration->destinationValues - any
migrations referencing this member will need to change.
- #946350 - Accept arrays in sourceMigration();
Let a node migration set node_revisions.uid. That's the 'last edited by' user

Bug fixes
- #1053798 - Consistent use of error codes.
- #1053526 - Machine names in drush commands now case-insensitive.
- #914440 - Enhance multilingual support.
- #1014648 - Defaulting of file field subfields.
- #1037872 - Make sure is_new is off for previously migrated content.
- #919706 - Fix drush migrate-descriptions command.
- #1027468 - Limit map/message table name lengths.
- #1045646 - Handle PHP memory_limit of -1.
- #1050348 - Check map table existence in correct DB.
- #1028824 - Errors during registry rebuild trigger fatal error.
Fix highwater handling to deal with duplicate values.
- #998604 - Fixed dedupe.
- #998586 - Improved feedback for disabled migrations.
- #972382 - Fix MigrateDestinationTableCopy.

Migrate 2.0 Beta 3
==================

Features and enhancements

- #989200 - Support "dynamic" migrations. Changes to be aware of:
All modules implementing migration classes must now implement hook_migrate_api()
(see migrate_migrate_api() for an example).
Dependencies and sourceMigrations must now be expressed in terms of
machine name rather than class name.
MigrationBase::getInstance now takes a machine name rather than a class name.
Migration class names are no longer required to end in 'Migration'.
- #992898 - Pass options to source and destination constructors as arrays.
File destinations (i.e., migrating directly to the file_managed table, with
option copying of the files themselves) are now supported.
Allow migration of comment enable/disable.
Check max_execution_time as well as memory_limit, for graceful exit when
max_execution_time is in play.
Add dedupe() method for a field mapping.
Apply MigrateBase::timestamp() to comment created/changed

Bug fixes

- #1006272 - Remove lengths on int fields in schema (breaks Postgres)
- #1005030 - Replace eval() with proper call_user_func().
- #1005360 - Skip .test files in registry scan
- #1004268 - Don't munge date separators
- prepareRow() hook skips current row only if boolean FALSE is returned.
- #989622 - Fix undefined variable in MigrateDestinationNode::import().