| 1 |
OSInet TAXONEWS module for Drupal
|
| 2 |
=================================
|
| 3 |
$Id: INSTALL.txt,v 1.5.8.4 2008/06/07 22:55:20 fgm Exp $
|
| 4 |
|
| 5 |
UNSTABLE VERSION for pre-code-freeze Drupal 7
|
| 6 |
|
| 7 |
Caveat Emptor: everything in this branch is likely to change
|
| 8 |
before Drupal 7 is actually released. It is currently NOT
|
| 9 |
fit for any need except core 7 testing.
|
| 10 |
|
| 11 |
PREREQUISITES
|
| 12 |
=============
|
| 13 |
|
| 14 |
- Drupal 7.x dated 2008-06-11
|
| 15 |
- PHP 5.1
|
| 16 |
- MySQL 5.x
|
| 17 |
|
| 18 |
INSTALLING
|
| 19 |
==========
|
| 20 |
|
| 21 |
1. Copy this directory to
|
| 22 |
<drupal>/sites/all/modules/taxonews
|
| 23 |
|
| 24 |
2. If you want to use the french version, make sure locale.module is loaded
|
| 25 |
in admin/modules. Drupal will then auto-load the translation.
|
| 26 |
|
| 27 |
3. To create a new vocabulary for taxonews use (skip otherwise)
|
| 28 |
3.1 browse to admin/taxonomy/add/vocabulary
|
| 29 |
3.2 hierarchy and multiple selection in the vocabulary should preferably be deactivated
|
| 30 |
3.3 add terms to your new vocabulary
|
| 31 |
|
| 32 |
4. To create news blocks with taxonews
|
| 33 |
4.1 browse to admin/settings/taxonews
|
| 34 |
4.2 Select the vocabulary based on which taxonews will create blocks.
|
| 35 |
Remember, one block will be defined for each term in the vocabulary.
|
| 36 |
4.3 Define the maximum age, in days, for nodes to be considered as news
|
| 37 |
included in taxonews blocks
|
| 38 |
4.4 browse to admin/build/block
|
| 39 |
4.5 You'll notice a set of blocks named:
|
| 40 |
taxonews/<vocabulary name>/<a term in the vocabulary you chose>
|
| 41 |
4.5.1 If you don't see these blocks, browse to admin/settings/performance,
|
| 42 |
and click the "Clear Cached data" button
|
| 43 |
4.6 Activate them like any other drupal block.
|
| 44 |
|
| 45 |
5. To theme blocks
|
| 46 |
5.1 For plain PHP themes, define <your_theme>_taxonews_block_view()
|
| 47 |
and look at the code for theme_taxonews_block_view to see what
|
| 48 |
your options are.
|
| 49 |
5.2 For PHPtemplate themes, see http://drupal.org/node/11811 and redefine
|
| 50 |
theme_taxonews_blockv_view()
|
| 51 |
5.3 For simple CSS customizations, themeability is defined to the read-more class,
|
| 52 |
the list styles (theme_item_list) and RSS icon styles (theme_feed_icon())
|
| 53 |
|
| 54 |
|
| 55 |
UPGRADING FROM DRUPAL 4.6/4.7/5 BRANCHES
|
| 56 |
========================================
|
| 57 |
|
| 58 |
Since the module does not store any content except its parameters,
|
| 59 |
and did not change them from the earlier branches, you can just erase
|
| 60 |
the files from the previous version and copy the files of the new version.
|
| 61 |
No additional install or upgrade procedure is currently necessary.
|
| 62 |
|
| 63 |
|
| 64 |
UNINSTALLING
|
| 65 |
============
|
| 66 |
|
| 67 |
The module supports the uninstall functions available since Drupal 6.
|
| 68 |
|
| 69 |
1. disable the module from admin/build/modules
|
| 70 |
2. click on "uninstall" on the same page once the module has been disabled,
|
| 71 |
and confirm
|
| 72 |
|
| 73 |
If you just remove the module files without uninstalling, the configuration
|
| 74 |
variables will remain in the drupal 'variables' table, where a later install
|
| 75 |
can find them again, and possibly uninstall them cleanly if you choose to
|
| 76 |
perform an uninstall.
|
| 77 |
|
| 78 |
|
| 79 |
Legal notice
|
| 80 |
============
|
| 81 |
|
| 82 |
This documentation is copyright 2005-2008 Ouest Systemes Informatiques. All rights reserved.
|
| 83 |
|
| 84 |
This documentation is licensed under the Creative Commons BY-NC-SA 2.0 license for France,
|
| 85 |
found at http://creativecommons.org/licenses/by-nc-sa/2.0/fr/
|
Parent Directory
| 
Revision Log
| 
Revision Graph