Diff

mod_invites_page/README.markdown @ 4402:85c11eb4331b

mod_invites_page: Allow disabling of built-in pages with invites_page_external option
author Matthew Wild <mwild1@gmail.com>
date Wed, 27 Jan 2021 08:16:26 +0000
parent 4224:816c2fa1ca84
child 5141:027fb71ad509
line wrap: on
line diff
--- a/mod_invites_page/README.markdown	Tue Jan 26 22:04:43 2021 +0100
+++ b/mod_invites_page/README.markdown	Wed Jan 27 08:16:26 2021 +0000
@@ -45,11 +45,12 @@
 Configuration
 =============
 
-| Name                      | Description                                                                    | Default                                                    |
-|---------------------------|--------------------------------------------------------------------------------|------------------------------------------------------------|
-| invites_page              | The format of an invite page URL (must begin with `https://`)                  | `"https://{host}:5281/invites_page?{invite.token}"`        |
-| invites_registration_page | The format of an invite registration page URL (may be relative to invites_page)| `"register?t={invite.token}&c={app.id}"`                   |
-| site_name                 | The friendly name of the server                                                | `"example.com"`                                            |
+| Name                      | Description                                                                    | Default                                             |
+|---------------------------|--------------------------------------------------------------------------------|-----------------------------------------------------|
+| invites_page              | The format of an invite page URL (must begin with `https://`)                  | `"https://{host}:5281/invites_page?{invite.token}"` |
+| invites_registration_page | The format of an invite registration page URL (may be relative to invites_page)| `"register?t={invite.token}&c={app.id}"`            |
+| site_name                 | The friendly name of the server                                                | `"example.com"`                                     |
+| invites_page_external     | Set this to true if your invitation pages will be rendered by something else   | `false`                                             |
 
 The `invites_page` and `invites_registration_page` options are templates
 that support a number of variables. The most useful being `{host}` and
@@ -60,3 +61,8 @@
 behind a reverse proxy such as nginx or Apache, you will probably want
 to set `http_external_url` so that Prosody knows what URLs should look
 like for users.
+
+If you want to disable this module's built-in pages and use an external
+invitation page generator (such as [ge0rg/easy-xmpp-invitation](https://github.com/ge0rg/easy-xmpp-invitation)
+then set `invites_page_external = true` and set `invites_page` to the
+appropriate URL for your installation.