| 1 |
$Id: README.txt,v 1.5.4.1 2006/08/31 13:42:21 kbahey Exp $
|
| 2 |
|
| 3 |
Copyright 2005 http://2bits.com
|
| 4 |
|
| 5 |
Description
|
| 6 |
-----------
|
| 7 |
This module provides the ability for users to vote on various node,
|
| 8 |
assigning a score to each one. The average overall score and number
|
| 9 |
of votes are displayed below each node.
|
| 10 |
|
| 11 |
The module is useful in many situations, for example, to rate articles,
|
| 12 |
forum posts, stories.
|
| 13 |
|
| 14 |
Several blocks are provided to display top voted for nodes, top scored
|
| 15 |
nodes, and top voting users.
|
| 16 |
|
| 17 |
Permissions are used to determine which roles can vote, as well as which
|
| 18 |
roles can see the results.
|
| 19 |
|
| 20 |
Voting can be limited to one or more node type (e.g. image, page, ...etc).
|
| 21 |
|
| 22 |
Users can earn points when they vote, if the user points module is installed.
|
| 23 |
|
| 24 |
The site admin can choose whether everyone can see vote results, or whether
|
| 25 |
votes are only visible to the node owner and those who voted on that node.
|
| 26 |
|
| 27 |
Notes:
|
| 28 |
|
| 29 |
1. In order to maintain voting integrity, the author of the node is not
|
| 30 |
allowed to vote on nodes they created.
|
| 31 |
|
| 32 |
2. By default, anonymous users cannot vote. This will prevent vote rigging
|
| 33 |
by logging off, and voting multiple times.
|
| 34 |
However, it seems that some would still want that functionlity. To enable
|
| 35 |
it, some code editing is required. Please check the workaround here
|
| 36 |
http://drupal.org/node/32519 for detail.
|
| 37 |
|
| 38 |
Sponsored by: http://artalyst.com
|
| 39 |
|
| 40 |
You may want to use the xtracker module in conjunction with nodevote, replacing
|
| 41 |
Drupal's tracker. It allows you to display nodes sorted by score.
|
| 42 |
http://drupal.org/node/36756
|
| 43 |
|
| 44 |
Extended Version
|
| 45 |
----------------
|
| 46 |
A commercial extended version of this module allows multiple vote critera
|
| 47 |
to be used, not just one. An overall average for all criteria is calculated,
|
| 48 |
as well as for each criterion.
|
| 49 |
|
| 50 |
|
| 51 |
For example, a literature web site can rate articles on style, subject,
|
| 52 |
grammar, ...etc. A photo/art web site can rate images on composition,
|
| 53 |
exposure, topic, colors, contrast, ...etc.
|
| 54 |
|
| 55 |
Contact the author for more details.
|
| 56 |
|
| 57 |
Installation
|
| 58 |
------------
|
| 59 |
To install this module, extract the nodevote tarball that you downloaded
|
| 60 |
and copy the nodevote folder and all its contents to your modules directory.
|
| 61 |
|
| 62 |
Configuration
|
| 63 |
-------------
|
| 64 |
To enable this module do the following:
|
| 65 |
|
| 66 |
1. Go to Admin -> Modules, and enable nodevote. Make sure you get no errors.
|
| 67 |
|
| 68 |
2. Go to Admin -> Settings -> nodevote.
|
| 69 |
|
| 70 |
Enable the node types that you want users to vote on, and enter a
|
| 71 |
desciption for the vote (optional).
|
| 72 |
|
| 73 |
3. Go to Admin -> Access Control and enable voting/viewing for the
|
| 74 |
roles you want. For example, you may want Authenticated users to
|
| 75 |
view the votes, but paying customers to do the voting.
|
| 76 |
|
| 77 |
Bugs/Features/Patches:
|
| 78 |
----------------------
|
| 79 |
If you want to report bugs, feature requests, or submit a patch, please do so
|
| 80 |
at the project page on the Drupal web site.
|
| 81 |
http://drupal.org/project/nodevote
|
| 82 |
|
| 83 |
Author
|
| 84 |
------
|
| 85 |
Khalid Baheyeldin (http://baheyeldin.com/khalid and http://2bits.com)
|
| 86 |
|
| 87 |
If you use this module, find it useful, and want to send the author
|
| 88 |
a thank you note, then use the Feedback/Contact page at the URL above.
|
| 89 |
|
| 90 |
The author can also be contacted for paid customizations of this
|
| 91 |
and other modules.
|