Diff

mod_welcome_page/README.markdown @ 4184:9127fa98ee1e

mod_welcome_page: New module to provide a friendly entrypoint to invite-based setups
author Matthew Wild <mwild1@gmail.com>
date Fri, 09 Oct 2020 12:19:46 +0100
child 4605:ffb709728210
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_welcome_page/README.markdown	Fri Oct 09 12:19:46 2020 +0100
@@ -0,0 +1,47 @@
+---
+labels:
+- 'Stage-Beta'
+summary: 'Serve a welcome page to users'
+rockspec:
+  dependencies:
+  - mod_invites
+  build:
+    copy_directories:
+    - html
+...
+
+Introduction
+============
+
+This module serves a welcome page to users, and allows them to create an
+account invite via the web on invite-only servers.
+
+The page template and policy of when to allow account creation are both
+possible to override.
+
+This module is part of the suite of modules that implement invite-based
+account registration for Prosody. The other modules are:
+
+- mod_invites
+- mod_invites_adhoc
+- mod_invites_page
+- mod_invites_register
+- mod_invites_register_web
+- mod_register_apps
+
+For details and a full overview, start with the mod_invites documentation.
+
+Configuration
+=======
+
+`welcome_page_template_path`
+:   The path to a directory containing the page templates and assets. See
+    the module source for the example template.
+
+`welcome_page_variables`
+:   Optional variables to pass to the template, available as `{var.name}`
+
+`welcome_page_open_registration`
+:   Whether to allow account creation in the absence of any other plugin
+    overriding the policy. Defaults to `false` unless `registration_invite_only`
+    is set to `false`.