OSInet TAXONEWS module for Drupal
=================================
$Id: INSTALL.txt,v 1.5 2006/10/02 19:21:06 fgm Exp $

Prerequisites: Drupal 4.6.x or 4.7.x. 
Both Drupal versions use the same version of the module

1. Copy this directory to
  <drupal>/modules/taxonews

2. If you want to use the french version (skip otherwise)
2.1 Make sure locale.module is loaded in admin/modules
2.2 Browse to admin/locale
2.3 Make sure french is declared as a site language
2.4 Import <drupal>/modules/taxonews/po/fr.po

3. To create a new vocabulary for taxonews use (skip otherwise)
3.1 browse to admin/taxonomy/add/vocabulary
3.2 hierearchy and multiple selection in the vocabulary should preferably be deactivated
3.3 add terms to your new vocabulary

4. To create news blocks with taxonews
4.1 browse to admin/settings/taxonews
4.2 Select the vocabulary based on which taxonews will create blocks.
    Remember, one block will be defined for each term in the vocabulary.
4.3 Define the maximum age, in days, for nodes to be considered as news
    included in taxonews blocks
4.4 browse to admin/block
4.5 You'll notice a set of blocks named:
        taxonews/<a term in the vocabulary you chose>
4.5.1 If you don't see these blocks, refresh the page in your browser
      or browse to devel/cache/clear if you hav devel.module installed.
4.6 Activate them like any other drupal block.

5. To theme blocks
5.1 For plain PHP themes, define <your_theme>_taxonews_block_view()
    and look at the code for theme_taxonews_block_view to see what
    your options are.
5.2 For PHPtemplate themes, see http://drupal.org/node/11811 and redefine
    theme_taxonews_blockv_view()
5.3 For simple CSS customizations, themeability is defined to the read-more class,
  the list styles (theme_item_list) and RSS icon styles (theme_xml_icon())

This documentation is copyright 2005-2006 Ouest Systemes Informatiques. All rights reserved.

This documentation is licensed for public use under the Creative Commons BY-NC-SA 2.0 license for France,
found at http://creativecommons.org/licenses/by-nc-sa/2.0/fr/

