diff --git a/synapse/config/emailconfig.py b/synapse/config/emailconfig.py
index 5b5c2f4fff..c82f3ee7a3 100644
--- a/synapse/config/emailconfig.py
+++ b/synapse/config/emailconfig.py
@@ -357,160 +357,6 @@ class EmailConfig(Config):
path=("email", "invite_client_location"),
)
- def generate_config_section(self, **kwargs: Any) -> str:
- return (
- """\
- # Configuration for sending emails from Synapse.
- #
- # Server admins can configure custom templates for email content. See
- # https://matrix-org.github.io/synapse/latest/templates.html for more information.
- #
- email:
- # The hostname of the outgoing SMTP server to use. Defaults to 'localhost'.
- #
- #smtp_host: mail.server
-
- # The port on the mail server for outgoing SMTP. Defaults to 25.
- #
- #smtp_port: 587
-
- # Username/password for authentication to the SMTP server. By default, no
- # authentication is attempted.
- #
- #smtp_user: "exampleusername"
- #smtp_pass: "examplepassword"
-
- # Uncomment the following to require TLS transport security for SMTP.
- # By default, Synapse will connect over plain text, and will then switch to
- # TLS via STARTTLS *if the SMTP server supports it*. If this option is set,
- # Synapse will refuse to connect unless the server supports STARTTLS.
- #
- #require_transport_security: true
-
- # Uncomment the following to disable TLS for SMTP.
- #
- # By default, if the server supports TLS, it will be used, and the server
- # must present a certificate that is valid for 'smtp_host'. If this option
- # is set to false, TLS will not be used.
- #
- #enable_tls: false
-
- # notif_from defines the "From" address to use when sending emails.
- # It must be set if email sending is enabled.
- #
- # The placeholder '%%(app)s' will be replaced by the application name,
- # which is normally 'app_name' (below), but may be overridden by the
- # Matrix client application.
- #
- # Note that the placeholder must be written '%%(app)s', including the
- # trailing 's'.
- #
- #notif_from: "Your Friendly %%(app)s homeserver <noreply@example.com>"
-
- # app_name defines the default value for '%%(app)s' in notif_from and email
- # subjects. It defaults to 'Matrix'.
- #
- #app_name: my_branded_matrix_server
-
- # Uncomment the following to enable sending emails for messages that the user
- # has missed. Disabled by default.
- #
- #enable_notifs: true
-
- # Uncomment the following to disable automatic subscription to email
- # notifications for new users. Enabled by default.
- #
- #notif_for_new_users: false
-
- # Custom URL for client links within the email notifications. By default
- # links will be based on "https://matrix.to".
- #
- # (This setting used to be called riot_base_url; the old name is still
- # supported for backwards-compatibility but is now deprecated.)
- #
- #client_base_url: "http://localhost/riot"
-
- # Configure the time that a validation email will expire after sending.
- # Defaults to 1h.
- #
- #validation_token_lifetime: 15m
-
- # The web client location to direct users to during an invite. This is passed
- # to the identity server as the org.matrix.web_client_location key. Defaults
- # to unset, giving no guidance to the identity server.
- #
- #invite_client_location: https://app.element.io
-
- # Subjects to use when sending emails from Synapse.
- #
- # The placeholder '%%(app)s' will be replaced with the value of the 'app_name'
- # setting above, or by a value dictated by the Matrix client application.
- #
- # If a subject isn't overridden in this configuration file, the value used as
- # its example will be used.
- #
- #subjects:
-
- # Subjects for notification emails.
- #
- # On top of the '%%(app)s' placeholder, these can use the following
- # placeholders:
- #
- # * '%%(person)s', which will be replaced by the display name of the user(s)
- # that sent the message(s), e.g. "Alice and Bob".
- # * '%%(room)s', which will be replaced by the name of the room the
- # message(s) have been sent to, e.g. "My super room".
- #
- # See the example provided for each setting to see which placeholder can be
- # used and how to use them.
- #
- # Subject to use to notify about one message from one or more user(s) in a
- # room which has a name.
- #message_from_person_in_room: "%(message_from_person_in_room)s"
- #
- # Subject to use to notify about one message from one or more user(s) in a
- # room which doesn't have a name.
- #message_from_person: "%(message_from_person)s"
- #
- # Subject to use to notify about multiple messages from one or more users in
- # a room which doesn't have a name.
- #messages_from_person: "%(messages_from_person)s"
- #
- # Subject to use to notify about multiple messages in a room which has a
- # name.
- #messages_in_room: "%(messages_in_room)s"
- #
- # Subject to use to notify about multiple messages in multiple rooms.
- #messages_in_room_and_others: "%(messages_in_room_and_others)s"
- #
- # Subject to use to notify about multiple messages from multiple persons in
- # multiple rooms. This is similar to the setting above except it's used when
- # the room in which the notification was triggered has no name.
- #messages_from_person_and_others: "%(messages_from_person_and_others)s"
- #
- # Subject to use to notify about an invite to a room which has a name.
- #invite_from_person_to_room: "%(invite_from_person_to_room)s"
- #
- # Subject to use to notify about an invite to a room which doesn't have a
- # name.
- #invite_from_person: "%(invite_from_person)s"
-
- # Subject for emails related to account administration.
- #
- # On top of the '%%(app)s' placeholder, these one can use the
- # '%%(server_name)s' placeholder, which will be replaced by the value of the
- # 'server_name' setting in your Synapse configuration.
- #
- # Subject to use when sending a password reset email.
- #password_reset: "%(password_reset)s"
- #
- # Subject to use when sending a verification email to assert an address's
- # ownership.
- #email_validation: "%(email_validation)s"
- """
- % DEFAULT_SUBJECTS
- )
-
class ThreepidBehaviour(Enum):
"""
|
