User Points
This modules provide a method for users to accumulate points for performing certain actions on your site such as posting nodes, commenting or moderating a comment. It also provides an API that allows you to easily add other actions a user may perform to gain points. The project User Points Contributed modules provides a collection of user created modules that extends the functionality of User Points.
This module is useful in providing an incentive for users to participate in the site, and be more active.
Userpoints provides the following:
- Services integration: allowing retrieving and updating points on your site using XML-RPC.
- Workflow-ng integration
- Views integration
- Point awards for posting a node
- posting a comment
- Each node type can be given a different number of points, for example an image is of more value to photography site, while a page is more value to a literature site.
- When nodes/comments are deleted points are subtracted
- Points follow node/comment ownership on ownership changes
- Moderating a comment
- A block displaying the number of points a user has gained
- A block displays the top users who earned points
- A status message telling the user how many points were earned/lost and their total points
- A detailed point total report for each individual user
- A point total report for all users
Contributed modules
There are many contributed modules that use the User Points API. They now live in a collection of their own User Points contributed modules project. Before using a contributed module please read the version information below.
Userpoints Contributed Modules extends userpoints by providing:
- Points for voting on a node (requires the nodevote module)
- Points for using many other voting modules (Fivestars, vote up/down, ...), via the Voting API integration.
- Points for Inviting a user (requires the invite module)
- Points for Invited user registers (requires the invite module)
- Use points for purchases from a store using the ecommerce module. This can be used as a reward points system.
- Move user in/out of roles based on point level
- much, much more...
API
This modules provides a callable interface, as well as a hook system for adding or subtracting points to a user account, as well as querying a user's account for how many points they currently have. Please refer to the documentation link below and/or the README.txt file included with the module.
You can read a tutorial and some examples of how to write modules that use the 3.x API here.
Developer notice: The API from v2 to v3 has changed significantly and is not backwards compatible. In specific userpoints_userpointsapi() has changed to an array of parameters and it returns an array instead of true/false. Please refer to the documentation and/or the README.txt for more information.
Version Information
This project uses stable and dev releases correctly. Dev releases should never be considered stable and should be used on non-production sites only. Stable releases are deemed stable by the community at large after a long testing process. If you find any issues please file them in the issues queue.
Major version numbers indicate a major change. For example 2.14 and 3.1 are significantly different whereas 3.1 and 3.2 or 2.13 and 2.14 are only minor changes. Major numbers (2 or 3) must match when using contributed modules. Contributed modules with a version of 2.x are not compatible with version 3.x.
Sites
Some sites that use this module:
More info
Here is presentation on userpoints the author gave at Drupal Camp Toronto 2007.
Initially sponsored by: Artalyst.com
Author
Khalid Baheyeldin of 2bits.com.
The author can also be contacted for paid customizations of this module as well as Drupal consulting, installation, development, and customizations.
Releases
| Official releases | Date | Size | Links | Status | |
|---|---|---|---|---|---|
| 5.x-3.5 | 2008-Apr-04 | 45.93 KB | Download · Release notes | Recommended for 5.x |  |
| 4.7.x-2.3 | 2008-Jan-30 | 19.38 KB | Download · Release notes | Recommended for 4.7.x | |
| Development snapshots | Date | Size | Links | Status | |
|---|---|---|---|---|---|
| 6.x-1.x-dev | 2008-May-06 | 44.96 KB | Download · Release notes | Development snapshot |  |
| 5.x-3.x-dev | 2008-Apr-03 | 45.94 KB | Download · Release notes | Development snapshot | |