diff options
| author | Brendan Abolivier <contact@brendanabolivier.com> | 2019-04-17 14:57:39 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-04-17 14:57:39 +0100 |
| commit | 91934025b93bec62c8f5bf12f1975b0c6bffde93 (patch) | |
| tree | 0bd1029b31353d10868fa3cd3b3b22b70568e472 /docs | |
| parent | Merge pull request #5071 from matrix-org/babolivier/3pid-check (diff) | |
| parent | Send out emails with links to extend an account's validity period (diff) | |
| download | synapse-91934025b93bec62c8f5bf12f1975b0c6bffde93.tar.xz | |
Merge pull request #5047 from matrix-org/babolivier/account_expiration
Send out emails with links to extend an account's validity period
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/sample_config.yaml | 29 |
1 files changed, 26 insertions, 3 deletions
diff --git a/docs/sample_config.yaml b/docs/sample_config.yaml index 8888fd49c4..ab02e8f20e 100644 --- a/docs/sample_config.yaml +++ b/docs/sample_config.yaml @@ -646,11 +646,31 @@ uploads_path: "DATADIR/uploads" # #enable_registration: false -# Optional account validity parameter. This allows for, e.g., accounts to -# be denied any request after a given period. +# Optional account validity configuration. This allows for accounts to be denied +# any request after a given period. +# +# ``enabled`` defines whether the account validity feature is enabled. Defaults +# to False. +# +# ``period`` allows setting the period after which an account is valid +# after its registration. When renewing the account, its validity period +# will be extended by this amount of time. This parameter is required when using +# the account validity feature. +# +# ``renew_at`` is the amount of time before an account's expiry date at which +# Synapse will send an email to the account's email address with a renewal link. +# This needs the ``email`` and ``public_baseurl`` configuration sections to be +# filled. +# +# ``renew_email_subject`` is the subject of the email sent out with the renewal +# link. ``%(app)s`` can be used as a placeholder for the ``app_name`` parameter +# from the ``email`` section. # #account_validity: +# enabled: True # period: 6w +# renew_at: 1w +# renew_email_subject: "Renew your %(app)s account" # The user must provide all of the below types of 3PID when registering. # @@ -897,7 +917,7 @@ password_config: -# Enable sending emails for notification events +# Enable sending emails for notification events or expiry notices # Defining a custom URL for Riot is only needed if email notifications # should contain links to a self-hosted installation of Riot; when set # the "app_name" setting is ignored. @@ -919,6 +939,9 @@ password_config: # #template_dir: res/templates # notif_template_html: notif_mail.html # notif_template_text: notif_mail.txt +# # Templates for account expiry notices. +# expiry_template_html: notice_expiry.html +# expiry_template_text: notice_expiry.txt # notif_for_new_users: True # riot_base_url: "http://localhost/riot" |