*****************************************************************************
                      T A X O N O M Y    T H E M E
*****************************************************************************
Name: taxonomy_theme module
Author: Thilo Wawrzik <drupal at profix898 dot de>
Drupal: 4.6 & 4.7
*****************************************************************************
DESCRIPTION:

The taxonomy_theme module allows you to change the theme of a given node
based on the taxonomy term or vocabulary of that node. You can theme your
forums and the admin section of your site. With the latest version it is
also possible to map themes to Drupal pathes or path aliases directly.

*****************************************************************************
INSTALLATION:

1. Extract the archive to your Drupal modules/ directory.

2. Enable taxonomy_theme module by navigating to
     administer > modules
     
3. Bring up taxonomy_theme configuration screen by navigating to
     administer > themes > taxonomy_theme (Drupal 4.7) or
     administer > settings > taxonomy_theme (Drupal 4.6)
   !!! In 4.7 path to options changed with latest version !!!
     
4. Configure all settings after your fancy (see below)

*****************************************************************************
UPDATE (for 4.7 version):

1. Replace all files with the latest version
   (If you update from a tableless version and/or from taxonomy_theme 4.6
   it is not sufficient to replace taxonomy_theme.module. You also need
   taxonomy_theme.install to complete the update process.) 
     
2. Run update.php to migrate your settings (in this case only data from
   'extended' assignment). It ensures that all tables are created and all
   update operations are completed properly.

*****************************************************************************
SETTINGS / OPTIONS:

Most options should be pretty much self-explanatory. But some may not! 

- "Allow all themes"
Offers all installed themes for selection, not enabled ones only.
By default you can only assign active themes to pages (themes can be
activated at administer > themes). But active themes are also presented to
your users, so they can select their favorite theme. You may want to have
different themes applied to your site without giving your users the
choice. This is what 'Allow all themes' option is for. In 4.7 you can
also prevent your users from selecting their personal theme with the new
permission 'select different theme' (system module).

- "Enable 'Extended' assignment of themes"
You can assign themes to every Drupal path and path alias. To assign a
theme for a particular path enter the path into according textarea in
'Extended' section (visible only with this option enabled). Extended
options have higher priority. Themes assigned to pathes override themes
from template selection methods (e.g. Vocab-based).

- "Enable 'Themes for Views'"
This option is available only for 4.7 and only with views.module
installed. You also need to have 'Extended' option enabled. It uses
hook_form_alter to add a theme selection box to edit view pages.

- "Show theme option in create/edit node forms"
This option is available only for 4.7. It uses hook_form_alter to add a
'Theme' section on create/edit node pages (i.e. create/edit content). 
You need to have 'Extended' option enabled to use this option. It enables
you to assign themes directly from create/edit node forms. 

- "Show theme option on term/vocab/content-types pages"
This option is available only for 4.7. It uses hook_form_alter to add a
theme selection box to term/vocab pages in 'categories' and to content-
type settings pages. It depends on your template selection method what
forms are altered, e.g. with 'Vocab-based' method selected only 'edit
vocabulary' pages (admin/taxonomy/edit/vocabulary/x) are extended.

Selecting 'default' from the theme selection box, disables 'Extended'
assignment for this node/path and uses the theme selected from standard
template selection method (e.g. Vocab-based) instead. What means you dont
need to select a theme for each node, but you can optionally do for more
precise adjustment.

- "'Admin Area' - Theme"
Allows you to map a different theme to your Admin Area than to the rest
of your site. This can be useful for a default theme without left/right
sidebars or with a very uncommon design.

- "Template selection method"
You can choose one of four different methods here.

+ Option A: Term-based
With this method you will have a 'Theme-Selector' vocabulary and you can
assign one theme to each of its terms. When you create/edit a node you map
a term to it and therefore map a theme to it also.

 Decide which vocabulary you will use to control the selection of
  templates, and make sure that vocabulary exists, e.g. create a
  'Sections' vocabulary.
 Create terms that will select templates, e.g. if 'Section A' of your
  site will have one template and 'Section B' will have another template,
  create the terms 'Section A' and 'Section B' in 'Sections' vocabulary.
 Choose the vocabulary you will use to control the selection of templates
  and map the terms to templates.

+ Option B: Vocab[ulary]-based
If you have 'Section A' and 'Section B' as two different vocabularies and
want to assign 'Theme A' and 'Theme B' to a whole Section including all
its (sub)terms, use this 'Vocab-based' method. 

+ Option C: All Taxonomy
With the 'all taxonomy' method you can select themes for all terms in all
categories/vocabularies, what gives you even more control.

+ Option D: NodeType-based
If you need to apply different themes for certain node types, you can use
NodeType-based selection method.

!!!
You can set themes globally with Option B,C and D, so that your users dont
need to select a term on each page for theme selection. In case your users
are allowed to create content (pages, stories, ...) it might be more safe
to use than Option A.
!!!

- "Apply themes to forums"
With this option enabled you can theme your forums different from the rest
of your site and/or theme each subforum independently. Since you can only
have one forum vocabulary this is necessary to use forums in different
themed context on your site.

- "Theme forum-dependent nodes/pages"
Generally only the forums (list of topics or comments) are themed, but
add/edit comment forms remain in default site/section layout. Enable this
option (very recommended) to apply forum themes to all forum-related
pages/nodes also.

*****************************************************************************
Enjoy theming your Site. Thilo.
