Installation
Below are the instructions for installing the latest version of the categoryi module (CVS HEAD), with the latest version of Drupal (also CVS HEAD):
- Copy the category folder and its contents to the Drupal
modules/directory. Drupal should automatically detect it. - Go to 'administer -> modules' and enable category (and category_menu, category_display, category_export, and category_legacy, if applicable).
Note: for each module that you enable, all necessary database tables will be automatically created, using Drupal's new.installfile system. You no longer need to run thecategory.mysqlscript (which is why this file no longer exists). - If you wish to use taxonomy-dependent Drupal modules (e.g. forum, image, glossary) with this module, you must install the taxonomy wrapperi module. There is now a script available to perform this installation for you. To run the script, go to 'administer -> settings -> category', and in the 'wrapper install / uninstall settings' box, click the 'install now' link for the taxonomy wrapper. If you experience errors with this script (usually due to file system permissions problems), see the instructions for installing the wrapper modules manually.
- If you wish to use book-dependent Drupal modules (e.g. export_dxml) with this module, you must install the book wrapper module. The procedure for doing this is similar to that for installing the taxonomy wrapper module. To run the book wrapper installation script, go to 'administer -> settings -> category', and in the 'wrapper install / uninstall settings' box, click the 'install now' link for the book wrapper. If you experience errors with this script (usually due to file system permissions problems), see the instructions for installing the wrapper modules manually.
- If you have existing taxonomy terms and vocabularies, or if you have existing book nodes, you can import them as categories and containeris using category_legacy. To do this, go to 'administer -> category legacy', and follow the instructions on that page. It is recommended that you enable the taxonomy and book wrappers before performing an import. Additionally, using the taxonomy wrapper with existing taxonomy data is not recommended - either import your existing taxonomy data first, disable the taxonomy wrapper, or delete your site's taxonomy data. You are able to leave the book module enabled, and continue to use your book data, if you wish (but as with taxonomy, it is recommended that you disable book).
- Go to 'administer -> access control' to configure access privileges for this module.
- Go to 'administer -> settings -> category' to change the settings for all modules in the category package. You might also want to change the node type settings for the category and container node types, at 'administer -> settings -> content types'.
- Go to 'administer -> categories' to start managing your categories and containers. You can create new categories and containers from here, or you can go to 'create content -> category' or 'create content -> container'.
- You can assign content to categories by configuring your containers to be associated with various node types, and then creating or editing nodes of those types.
Note: content with assigned categories will only have its categories displayed if category_display is installed, and if your containers are configured to show categories on assigned nodeis, and if the taxonomy wrapper is installed.
No
It is recommended that you replace the core taxonomy and book modules with the wrapperi modules (the wrapper install scripts will do this for you), and that you leave the wrapper modules enabled permanently on your site. The wrapper modules allow taxonomy- and book-dependent modules to function, by mimicking the old API, and by maintaining the old database tables.
If you disable the wrapper modules after installation, then you will not be able to use a number of popular modules that depend on taxonomy (and book, to a lesser extent), such as forum, image, and glossary.
Enable
Leave them enabled.
What you need to understand is this: the wrapperi modules are replacement files for the taxonomy and book module files. When you install them, the old 'taxonomy.module' and 'book.module' files are replaced with the wrapper module files. So as far as Drupal is concerned, the wrappers are the "real" taxonomy and book modules. If you disable taxonomy and book (when you have the wrappers installed), you are disabling the wrappers.
When you have the wrappers installed, go to the 'administer -> modules' page, and look for taxonomy and book in the module list. You will see that they have a different description to the "real" taxonomy and book modules, but that they are listed on this page as the taxonomy and book modules. This is a visual re-inforcement of the whole 'wrapper' concept, which I hope you now understand better.
Fixed
Install instructions (on this page and in the categoryi package) have been updated to indicate that only the category.mysql script now needs to be run. In the future, please submit problems like this as bug reports using the drupal.org issue tracker: http://drupal.org/node/add/project_issue/category.
Jeremy Epstein - GreenAsh