| Author: | Michael JasonSmith |
|---|---|
| Contact: | Michael JasonSmith <mpj17@onlinegroups.net> |
| Date: | 2014-11-19 |
| Organization: | GroupServer.org |
| Copyright: | This document is licensed under a Creative Commons Attribution-Share Alike 3.0 New Zealand License by OnlineGroups.Net. |
This product is concerned with the issuing of invitations to
join an online group. Invitations take the form of an email
message with a link. The invitation is responded to using one of
the two pages in the gs.profile.invite module [1].
Sending invitations in bulk is handled by the
gs.group.member.invite.csv product [2], while re-sending
invitations is dealt with by the
gs.group.member.invite.resend product [3].
For new members the invitation does two things in addition to joining a person to a group. First, it verifies that the email address works. GroupServer will only be send messages to verified addresses. Second, the Respond page allows the member to set a password, so he or she is able to log in.
Even for people that already have profiles, the invitations also allow informed consent. This is not just a good idea, in many countries it is the law.
There are two pages provided by this product for issuing invitations:
The page for inviting a site member to join a group,
admin_invite_site_members.html, is the simplest. It uses the
groupserver.InviteMembersNonGroupMembers vocabulary to list
all the site members who are not members of the group. The
administrator selects the site members to be invited, and a
notification is sent to each.
The most commonly used invitation page is used to invite a single
person to join a group: admin_join.html. This page allows the
administrator to do the following.
- Create a complete profile for the new member, including an email address.
- Customises the notification that is sent in the invitation.
If the email address matches a person who already has a profile, then the person is just sent an invitation; the profile is left as it was.
The notification is split into plain text
(invitationmessage.txt) and HTML (invitationmessage.html)
components. It is complicated by the administrator being able to
write a short message using the invite new member page.
The class
gs.group.member.invite.base.notify.InvitationNotifier
constructs the email, and uses the gs.profile.notify
[4] product to send the message.
- Code repository: https://github.com/groupserver/gs.group.member.invite.base
- Questions and comments to http://groupserver.org/groups/development
- Report bugs at https://redmine.iopen.net/projects/groupserver
| [1] | See <https://github.com/groupserver/gs.profile.invite> |
| [2] | See <https://github.com/groupserver/gs.group.member.invite.csv> |
| [3] | See <https://github.com/groupserver/gs.group.member.invite.resend> |
| [4] | See <https://github.com/groupserver/gs.profile.notify> |