Invitation Feature

The invitation feature allows authorized users to send emails, either in bulk or individually, to invite people to register on the Tiki site or to join specific groups.

It handles email delivery, invitation tracking, and automatic group assignment upon acceptance.

Requirements

To use this feature:

• Email notifications must be enabled.
• The administrator must enable the feature_invite.
• The user must have the tiki_p_invite permission.
• To view all invitations (not only their own), the user must be an administrator (tiki_p_admin).

1. Sending an Invitation

Access path: Settings → Users → Invitation list → Invite or directly via tiki-invite.php

A. Loading Previous Settings

If you have already sent invitations, you can select a previous invitation from the “Load a previous…” dropdown list.

This will pre-fill:

• The email subject and content.
• The home page content (Wiki content).
• The list of recipients from the previous send (useful for reminders).
• The associated groups.
• etc.

Click to expand

B. Recipient List

Two formats are supported:

CSV Style (recommended)

Select the “CSV style…” radio button.
Line format: LastName,FirstName,Email
Example: Landry,Bitege,landrybit29@example.com

Automatic Extraction (All)

Select the “Everything that appear as an email…” radio button.
The system will analyze the content and extract anything that looks like a valid email address.

⚠️ Note: in this mode, the {firstname} and {lastname} variables are not available for message personalization.

Click to expand

C. Message Composition

Email subject: title of the message received by the invitee.
Email content: body of the message. The following variables can be used and will be automatically replaced:
{firstname}: recipient’s first name
{lastname}: recipient’s last name
{email}: email address
{link}: unique link the user must click

⚠️ The {link} variable is mandatory and must be included in the content.

D. Wiki Content

This is the text displayed on the Tiki site after the user clicks the link in the email, even before logging in or registering.

Standard Wiki syntax can be used.
Available variables: {firstname}, {lastname}, {email}.

Click to expand

E. Group Assignment

Select one or more groups from the list.

When the invitee accepts the invitation (by logging in or creating an account), they are automatically added to the selected groups.

F. Redirection After Acceptance (Optional)

You may specify the name of a Wiki page (e.g. HomePage) to which the user will be redirected after the invitation is validated (login or account creation).

Click to expand

2. Confirmation and Sending

After clicking Send, a confirmation page displays the list of extracted and valid email addresses.

If the list is correct, click OK to send.
Otherwise, click Go Back to make changes.

Click to expand

Once confirmed, the system sends the emails and stores the invitations in the database.

Click to expand

3. Accepting an Invitation (Invitee Side)

The user receives the email and clicks the link.

Click to expand

They are redirected to a page (tiki-invited.php) displaying the Wiki content defined by the inviter.

Link Verification

The system checks:

• The existence of the invitation
• The email address
• The status used = no

The invitee already has an account and is logged in

• A “Validate” button is displayed to link the invitation to the current account.
• The user is immediately added to the assigned groups.
• The status changes to logged.
• Optional redirection.

Click to expand

The invitee already has an account but is not logged in

• A link to the login page is provided.
• After logging in, a “Validate” button is displayed.
• The user is added to the assigned groups.
• The status changes to logged.
• Optional redirection.

The invitee does not have an account

• A link to the registration page (tiki-register.php) is provided.
• The email address and invitation key are pre-filled.
• After the account is created, the groups are automatically assigned.

Click to expand

4. Invitation Management and Tracking

Access path: Settings → Users → List invite or tiki-list_invite.php
This page allows tracking the status of sent invitations.

Columns

• Inviter (visible to administrators only)
• Invitation date
• Recipient email
• Status: logged: invitation used no: invitation pending

Available Filters

• Only successful invitations
• Only pending invitations
• Filter by inviter name (administrators only)

Click to expand