You are here

README.txt in User Referral 6

Same filename in this branch
  1. 6 README.txt
  2. 6 referral_trigger/README.txt
Same filename and directory in other branches
  1. 5 README.txt
  2. 7 README.txt
Copyright 2006 http://2bits.com

This module provides users with the ability to refer other users
to a site they are registered at. When the new users registers,
the referral is recorded.

Users can see a list of users they referred, and the site admin
can view more detailed reports.

Basic Functionality
-------------------
The module works by generating a referral link as a hex code (such as referral/123)
in the user's profile page.

Referral information is recorded for a visitor in a cookie, when either of the following
happens:

- A non-registered visitor clicks on the referral link, or
- A non-registered visitor visits the profile page of the referring user. This 
  requires the profile page to be visible for anonymous users.
  
When the visitor registers on the site, the referral information is used to record 
the referring user's User ID in the database.

The link for referral for each user is displayed in "my account" menu.

If the Adsense module is installed and Revenue sharing is enabled, then
the referral is used to share the revenue between the referring user and
the referred user.

Optionally, points are awarded for the referring user (requires userpoints module).

Only active users are counted in referrals. Blocked users, or users
not yet approved by the administrator are not counted in referrals.

Developer API
-------------
Any module can implement a hook_referral() to act on the event of a new user
registering via a referral. This is useful in many cases. For an example on
how to use this, see the included referral_userpoints module.

Reports
-------
On the "my account" page, there is a link to a report on users you have
referred.

There are also admin reports under Administer -> Logs.

Two reports are provided:
- Summary: Lists each user and how many users they referred, and the date
  of the last referral.
- Details: Lists each users, and each user they have referred, the date/time
  of referral, the IP address, and Referral link.

Flag/Unflagged
--------------
Flagging of referrals can be used as a means of tracking with any special
meaning attached to it. For example, if your site needs to pay the referring
user for the number of referrals they make, then there is an "unflagged"
report. You can see the outstanding number of referrals, pay the referring
user, and unflag the current referrals to make way for the next billing
cycle. Or you can simply use this as a way to see referrals since you
last checked, and flag them.

Referral Goto Path
------------------
By default, when someone visits a referral link, they will be redirected to 
the path 'user/register'.  This path can be changed in the admin to anything
you want. 

Additionally, if you change the "Referral goto path" field in the 
admin to be blank, then you can dynamically set the goto path by adding a 
"?destination=<mypath>" querystring to a referral link.

For example, someone visiting "referral/abc123?destination=landingpage/123" 
would be redirected to "landingpage/123" after the referral module installs 
it's referral tracking cookie.

Installation
------------
To install this module, upload or copy the directory called "referral" to
your modules directory.

Configuration
-------------
To enable this module do the following:

1. Go to Administer -> Modules, and click enable. Make sure there are no error
   messages.

2. Go to Administer -> Access Control and enable for the roles you want.
   Users with 'admin referral' permission can view the detailed

Bugs/Features/Patches:
----------------------
If you want to report bugs, feature requests, or submit a patch, please do so
at the project page on the Drupal web site.

Author
------
<a href="http://baheyeldin.com">Khalid Baheyeldin</a> of <a href="http://2bits.com">2bits.com</a>.

The author can also be contacted for paid customizations of this module as well as Drupal consulting,
installation, development, and customizations.

File

README.txt
View source
  1. Copyright 2006 http://2bits.com
  2. This module provides users with the ability to refer other users
  3. to a site they are registered at. When the new users registers,
  4. the referral is recorded.
  5. Users can see a list of users they referred, and the site admin
  6. can view more detailed reports.
  7. Basic Functionality
  8. -------------------
  9. The module works by generating a referral link as a hex code (such as referral/123)
  10. in the user's profile page.
  11. Referral information is recorded for a visitor in a cookie, when either of the following
  12. happens:
  13. - A non-registered visitor clicks on the referral link, or
  14. - A non-registered visitor visits the profile page of the referring user. This
  15. requires the profile page to be visible for anonymous users.
  16. When the visitor registers on the site, the referral information is used to record
  17. the referring user's User ID in the database.
  18. The link for referral for each user is displayed in "my account" menu.
  19. If the Adsense module is installed and Revenue sharing is enabled, then
  20. the referral is used to share the revenue between the referring user and
  21. the referred user.
  22. Optionally, points are awarded for the referring user (requires userpoints module).
  23. Only active users are counted in referrals. Blocked users, or users
  24. not yet approved by the administrator are not counted in referrals.
  25. Developer API
  26. -------------
  27. Any module can implement a hook_referral() to act on the event of a new user
  28. registering via a referral. This is useful in many cases. For an example on
  29. how to use this, see the included referral_userpoints module.
  30. Reports
  31. -------
  32. On the "my account" page, there is a link to a report on users you have
  33. referred.
  34. There are also admin reports under Administer -> Logs.
  35. Two reports are provided:
  36. - Summary: Lists each user and how many users they referred, and the date
  37. of the last referral.
  38. - Details: Lists each users, and each user they have referred, the date/time
  39. of referral, the IP address, and Referral link.
  40. Flag/Unflagged
  41. --------------
  42. Flagging of referrals can be used as a means of tracking with any special
  43. meaning attached to it. For example, if your site needs to pay the referring
  44. user for the number of referrals they make, then there is an "unflagged"
  45. report. You can see the outstanding number of referrals, pay the referring
  46. user, and unflag the current referrals to make way for the next billing
  47. cycle. Or you can simply use this as a way to see referrals since you
  48. last checked, and flag them.
  49. Referral Goto Path
  50. ------------------
  51. By default, when someone visits a referral link, they will be redirected to
  52. the path 'user/register'. This path can be changed in the admin to anything
  53. you want.
  54. Additionally, if you change the "Referral goto path" field in the
  55. admin to be blank, then you can dynamically set the goto path by adding a
  56. "?destination=" querystring to a referral link.
  57. For example, someone visiting "referral/abc123?destination=landingpage/123"
  58. would be redirected to "landingpage/123" after the referral module installs
  59. it's referral tracking cookie.
  60. Installation
  61. ------------
  62. To install this module, upload or copy the directory called "referral" to
  63. your modules directory.
  64. Configuration
  65. -------------
  66. To enable this module do the following:
  67. 1. Go to Administer -> Modules, and click enable. Make sure there are no error
  68. messages.
  69. 2. Go to Administer -> Access Control and enable for the roles you want.
  70. Users with 'admin referral' permission can view the detailed
  71. Bugs/Features/Patches:
  72. ----------------------
  73. If you want to report bugs, feature requests, or submit a patch, please do so
  74. at the project page on the Drupal web site.
  75. Author
  76. ------
  77. Khalid Baheyeldin of 2bits.com.
  78. The author can also be contacted for paid customizations of this module as well as Drupal consulting,
  79. installation, development, and customizations.