README.txt 1.7 KB

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