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

Contents of /contributions/modules/nodevote/README.txt

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


Revision 1.8 - (show annotations) (download)
Thu Aug 31 13:42:52 2006 UTC (3 years, 2 months ago) by kbahey
Branch: MAIN
CVS Tags: DRUPAL-6--1-0, DRUPAL-5--1-0, HEAD
Branch point for: DRUPAL-5, DRUPAL-6--1
Changes since 1.7: +17 -30 lines
File MIME type: text/plain
#81637 Documentation refers to nonexistent nodevote.mysql script
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.

  ViewVC Help
Powered by ViewVC 1.1.2