/[drupal]/contributions/modules/taxonomy_theme/README.txt
ViewVC logotype

Diff of /contributions/modules/taxonomy_theme/README.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.9, Mon Oct 9 22:14:49 2006 UTC revision 1.10, Sun Jun 8 15:21:03 2008 UTC
# Line 3  Line 3 
3  *****************************************************************************  *****************************************************************************
4  Name: taxonomy_theme module  Name: taxonomy_theme module
5  Author: Thilo Wawrzik <drupal at profix898 dot de>  Author: Thilo Wawrzik <drupal at profix898 dot de>
6  Drupal: 5.0  Drupal: 6.x
7  *****************************************************************************  *****************************************************************************
8  DESCRIPTION:  DESCRIPTION:
9    
10  The taxonomy_theme module allows you to change the theme of a given node  The taxonomy_theme module allows you to change the theme of a given node
11  based on the taxonomy term, vocabulary or nodetype of that node. You can  based on the taxonomy term or vocabulary that node.
 also theme your forums and map themes to Drupal pathes or path aliases  
 directly.  
12    
13  *****************************************************************************  *****************************************************************************
14  INSTALLATION:  INSTALLATION:
15    
16  1. Place whole reptag folder into your Drupal modules/ directory.  Taxonomy Theme depends on the ThemeKey module. You will need to install
17    that module as well in order to use Taxonomy Theme.
18    
19    1. Place whole taxonomy_theme folder into your Drupal sites/*/modules
20         directory.
21    
22  2. Enable taxonomy_theme module by navigating to  2. Enable taxonomy_theme module by navigating to
23       Administer > Site Building > Modules (admin/build/modules)       Administer > Site Building > Modules (admin/build/modules)
24    
25  3. Bring up taxonomy_theme configuration screen by navigating to  3. Bring up taxonomy_theme configuration screen by navigating to
26       Administer > Site Configuration > Taxonomy Theme       Administer > Site Configuration > ThemeKey > Taxonomy
27      (admin/settings/taxonomy_theme)      (admin/settings/themekey/taxonomy)
28    
29  4. Configure all settings after your fancy (see below)  4. Configure all settings after your fancy (see below)
30    
# Line 33  INSTALLATION: Line 35  INSTALLATION:
35  !! they want to change the theme on (otherwise default theme is applied).  !! they want to change the theme on (otherwise default theme is applied).
36    
37  *****************************************************************************  *****************************************************************************
 UPDATE:  
   
 1. Replace all files with the latest version  
   
 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.  
   
 3. Enable all your themes once to make them available for taxonomy_theme  
    and don't forget to configure block settings per theme (core feature  
    since Drupal 4.7).  
   
 *****************************************************************************  
38  SETTINGS / OPTIONS:  SETTINGS / OPTIONS:
39    
40  Most options should be pretty much self-explanatory. But some may not!  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. You can also  
 prevent your users from selecting their personal theme by removing the  
 'select different theme' (system module) permission.  
   
 - "Enable 'Extended' (path-based) 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 (Pathes)' section (visible only with this option enabled).  
 Extended options have higher priority. Themes assigned to pathes  
 override themes from taxonomy selection methods (e.g. vocab-based).  
   
 - "Enable 'Themes for Views'"  
 This option is available 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 adds 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 adds a theme selection box to term/vocab pages in  
 'Categories' and to content-type settings page. It depends on your  
 taxonomy selection method what forms are altered, e.g. with  
 'vocab-based' method selected only 'edit vocabulary' pages  
 (admin/content/taxonomy/edit/vocabulary/x) are extended.  
   
 Selecting 'default' from the theme selection boxes, disables 'Extended'  
 assignment for this node/path/... and uses the theme selected from  
 taxonomy 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. Path-based themes override Taxonomy-based ones!  
   
 - "'Admin Area' - Theme"  
 This option is now a core feature. You can find it at  
  Administer > Site Configuration > Taxonomy Theme (admin/settings/admin)  
41    
42  - "Taxonomy: Template selection"  - "Taxonomy: Template selection"
43  You can choose one of four different methods here.  You can choose one of three different methods here.
44    
45  + Option A: Term-based  + Option A: Term-based
46  With this method you will have a 'Theme-Selector' vocabulary and you can  With this method you will have a 'Theme-Selector' vocabulary and you can
# Line 122  With the 'all taxonomy' method you can s Line 66  With the 'all taxonomy' method you can s
66  categories/vocabularies, what gives you even more control.  categories/vocabularies, what gives you even more control.
67   All Taxonomy = Term-based + Vocab-based   All Taxonomy = Term-based + Vocab-based
68    
 + 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.  
   
69  *****************************************************************************  *****************************************************************************
70  Enjoy theming your Site. Thilo.  Enjoy theming your Site. Thilo.

Legend:
Removed from v.1.9  
changed lines
  Added in v.1.10

  ViewVC Help
Powered by ViewVC 1.1.2