README.txt 1.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. The Migrate module provides a flexible framework for migrating content into Drupal
  2. from other sources (e.g., when converting a web site from another CMS to Drupal).
  3. Out-of-the-box, support for creating Drupal nodes, taxonomy terms, comments, and
  4. users are included. Plugins permit migration of other types of content.
  5. Usage
  6. -----
  7. Documentation is at http://drupal.org/migrate. To get started, enable the
  8. migrate_example module and browse to admin/content/migrate to see its dashboard.
  9. The code for this migration is in migrate_example/beer.inc (advanced examples are
  10. in wine.inc). Mimic that file in order to specify your own migrations.
  11. The Migrate module itself has support for migration into core objects. Support
  12. for migration involving contrib modules is in the migrate_extras module.
  13. Known issues
  14. ------------
  15. A user migration with systemOfRecord == DESTINATION will drop pictures from user
  16. records due to core bug http://drupal.org/node/935592 - the simpletests report an
  17. error reflecting this. We have not developed a work-around.
  18. Upgrading
  19. ---------
  20. Do not attempt to upgrade directly from Migrate 1 to Migrate 2! There is no
  21. automated path to upgrade - your migrations (formerly known as "content sets")
  22. must be reimplemented from scratch. It is recommended that projects using
  23. Migrate 1 stay with Migrate 1, and that Migrate 2 be used for any new migration
  24. projects.
  25. Acknowledgements
  26. ----------------
  27. Much of the Migrate module functionality was sponsored by Cyrve, for its clients GenomeWeb
  28. (http://www.genomeweb.com), The Economist (http://www.economist.com), and Examiner.com
  29. (http://www.examiner.com).
  30. Authors
  31. -------
  32. Mike Ryan - http://drupal.org/user/4420
  33. Moshe Weitzman - http://drupal.org/user/23