You are here

README.txt in Invite 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 5.2 README.txt
  3. 5 README.txt
  4. 6.2 README.txt
  5. 7.4 README.txt
-- SUMMARY --

Invitations are important to create network effects and exponential growth of a
community of interest. This module adds an 'Invite a friend' feature that
allows your users to send and track invitations to join your site.

For a full description visit the project page:
  http://drupal.org/project/invite
Bug reports, feature suggestions and latest developments:
  http://drupal.org/project/issues/invite


-- REQUIREMENTS --

* Token module http://drupal.org/project/token


-- INSTALLATION --

1. Copy the invite module to your modules directory and enable it on the Modules
   page (admin/modules).

2. Give some roles permission to send invites on the Permissions page
   (admin/people/permissions). The following permissions can be controlled:

   administer invitations - Allows users to access the administrative overview
     and settings pages, and to see other people's invitations.

   send mass invitations - Allows users to send an invitation to multiple
     recipients (this was formerly a setting known as "limit per turn").

   track invitations - Gives users access to the user overview pages and
     associated actions (withdraw etc). Useful to hide overviews from anonymous
     users.

   withdraw own invitations - Allows users to withdraw invitations. If an
     invitation has been withdrawn, it cannot be used to join the site
     and it does not count against the sender's invitation limit.

   withdraw own accepted invitations - This will allow your users to delete
     accepted invitations. Disable it to prevent users from deleting
     their account to be re-invited. With the help of the Cancel User Accounts
     module it is possible to terminate user accounts by withdrawing an
     invitation.

   view invite statistics (invite_stats module) - Allows users to view invite
     statistics on their profile pages as well as view the Top inviters/User
     rank block.

   view own invite statistics (invite_stats module) - Same as above, but limits
     viewing statistics to the user's own profile.

3. Invite adds a new registration mode called 'New user registration by
   invitation only' to the User settings page (admin/config/people/accounts),
   which allows you to maintain a semi-private site. You can enable it if you
   need it.

4. Configure the module at Configuration > Invite
   (admin/config/people/invite). For an explanation of the configuration
   settings see below.


-- CONFIGURATION --

--- General settings ---

* Default target role
  Allows you to specify the role invited users will be added to when they
  register, regardless of who invited them.

* Invitation expiry
  Specify how long sent invitations are valid (in days). After an invitation
  expires the registration link becomes invalid.

* Path to registration page
  Specifies where the users will be redirected when they click the invitation
  link.

--- Role settings (separate sections for each role) ---

* Target role
  Allows you to specify an additional role invited users will be added to if
  their inviter has a specific role.

* Invitation limit
  Allows you to limit the total number of invitations each role can send.

--- E-mail settings ---

* Subject
  The default subject of the invitation e-mail.

* Editable subject
  Whether the user should be able to customize the subject.

* Mail template
  The e-mail body.

* From/Reply-To e-mail address
  Choose whether to send the e-mail on behalf of the user or in the name of the
  site.

* Manually override From/Reply-To e-mail address (Advanced settings)
  Allows to override the sender and reply-to addresses used in all e-mails.
  Make sure the domain matches that of your SMTP server, or your e-mails will
  likely be marked as spam.

--- Invite page customization ---

* Invite page title
  Allows you to change the title of the invite page and link.

-- USAGE --

Sent invitations show up in one of three states: accepted, pending, expired, or
deleted.

* Accepted: Shows that the person you have invited has accepted the invitation
  to join the site.
* Pending: The invitation has been sent, but the invitee has since not accepted
  the invitation.
* Expired: The invitation has not been used to register within the expiration
  period.
* Deleted: The user account has been blocked.

At any time, pending or expired invitations may be withdrawn. Accepted
invitations may only be withdrawn if the configuration allows you to.


-- INVITE API --

See invite.api.php.

-- CREDITS --

Original author:
  David Hill (tatonca)

Current maintainer:
  Stefan M. Kudwien (smk-ka) - http://drupal.org/user/48898

File

README.txt
View source
  1. -- SUMMARY --
  2. Invitations are important to create network effects and exponential growth of a
  3. community of interest. This module adds an 'Invite a friend' feature that
  4. allows your users to send and track invitations to join your site.
  5. For a full description visit the project page:
  6. http://drupal.org/project/invite
  7. Bug reports, feature suggestions and latest developments:
  8. http://drupal.org/project/issues/invite
  9. -- REQUIREMENTS --
  10. * Token module http://drupal.org/project/token
  11. -- INSTALLATION --
  12. 1. Copy the invite module to your modules directory and enable it on the Modules
  13. page (admin/modules).
  14. 2. Give some roles permission to send invites on the Permissions page
  15. (admin/people/permissions). The following permissions can be controlled:
  16. administer invitations - Allows users to access the administrative overview
  17. and settings pages, and to see other people's invitations.
  18. send mass invitations - Allows users to send an invitation to multiple
  19. recipients (this was formerly a setting known as "limit per turn").
  20. track invitations - Gives users access to the user overview pages and
  21. associated actions (withdraw etc). Useful to hide overviews from anonymous
  22. users.
  23. withdraw own invitations - Allows users to withdraw invitations. If an
  24. invitation has been withdrawn, it cannot be used to join the site
  25. and it does not count against the sender's invitation limit.
  26. withdraw own accepted invitations - This will allow your users to delete
  27. accepted invitations. Disable it to prevent users from deleting
  28. their account to be re-invited. With the help of the Cancel User Accounts
  29. module it is possible to terminate user accounts by withdrawing an
  30. invitation.
  31. view invite statistics (invite_stats module) - Allows users to view invite
  32. statistics on their profile pages as well as view the Top inviters/User
  33. rank block.
  34. view own invite statistics (invite_stats module) - Same as above, but limits
  35. viewing statistics to the user's own profile.
  36. 3. Invite adds a new registration mode called 'New user registration by
  37. invitation only' to the User settings page (admin/config/people/accounts),
  38. which allows you to maintain a semi-private site. You can enable it if you
  39. need it.
  40. 4. Configure the module at Configuration > Invite
  41. (admin/config/people/invite). For an explanation of the configuration
  42. settings see below.
  43. -- CONFIGURATION --
  44. --- General settings ---
  45. * Default target role
  46. Allows you to specify the role invited users will be added to when they
  47. register, regardless of who invited them.
  48. * Invitation expiry
  49. Specify how long sent invitations are valid (in days). After an invitation
  50. expires the registration link becomes invalid.
  51. * Path to registration page
  52. Specifies where the users will be redirected when they click the invitation
  53. link.
  54. --- Role settings (separate sections for each role) ---
  55. * Target role
  56. Allows you to specify an additional role invited users will be added to if
  57. their inviter has a specific role.
  58. * Invitation limit
  59. Allows you to limit the total number of invitations each role can send.
  60. --- E-mail settings ---
  61. * Subject
  62. The default subject of the invitation e-mail.
  63. * Editable subject
  64. Whether the user should be able to customize the subject.
  65. * Mail template
  66. The e-mail body.
  67. * From/Reply-To e-mail address
  68. Choose whether to send the e-mail on behalf of the user or in the name of the
  69. site.
  70. * Manually override From/Reply-To e-mail address (Advanced settings)
  71. Allows to override the sender and reply-to addresses used in all e-mails.
  72. Make sure the domain matches that of your SMTP server, or your e-mails will
  73. likely be marked as spam.
  74. --- Invite page customization ---
  75. * Invite page title
  76. Allows you to change the title of the invite page and link.
  77. -- USAGE --
  78. Sent invitations show up in one of three states: accepted, pending, expired, or
  79. deleted.
  80. * Accepted: Shows that the person you have invited has accepted the invitation
  81. to join the site.
  82. * Pending: The invitation has been sent, but the invitee has since not accepted
  83. the invitation.
  84. * Expired: The invitation has not been used to register within the expiration
  85. period.
  86. * Deleted: The user account has been blocked.
  87. At any time, pending or expired invitations may be withdrawn. Accepted
  88. invitations may only be withdrawn if the configuration allows you to.
  89. -- INVITE API --
  90. See invite.api.php.
  91. -- CREDITS --
  92. Original author:
  93. David Hill (tatonca)
  94. Current maintainer:
  95. Stefan M. Kudwien (smk-ka) - http://drupal.org/user/48898