Taxonomy -> Category

This describes how to migrate a site that uses books and taxonomy to use the prefered category module.

Multi-site Issue

On a multi-site, the book and taxonomy modules live in /modules/taxonomy and /modules/books and are used by all sites in the installation.

When the Category module installs the wrappers for these two modules, it copies the module code to a '.old' file, and substitutes the wrapper code. The problem is that this breaks all the other sites on the installation that were using the legacy taxonomy code.

The solution is:

1. uninstall the taxonomy and book modules on mysite.com
2. copy the legacy modules to the /sites/mysite.com/modules/ directory
3. install the modules again

Now, mysite.com is running off its own copy of the modules, and is independent of other sites use or not of the wrappers. When you now install the wrappers (in /admin/content/category/settings) you will see that the changes are applied to the /sites/mysite.com/modules/ version of those modules.

Migration

To migrate, follow these steps:

1. Copy and apply local versions of taxonomy and book modules
2. Install all the Category modules, and the wrappers
3. Go to /admin/content/category/legacy
4. Import the taxonomies and books
5. Voila, you are done.