Changes between Version 115 and Version 116 of ConfigurationGuidelines

Timestamp:

03/18/16 11:15:11 (9 years ago)

Author:

Pat Tressel

Comment:

--

ConfigurationGuidelines

@@ -154 +154 @@
 === Registration Message Options ===
 
-The welcome message and other messages relating to registration and logging in are in {{{settings.auth.messages}}}
-which can be set in a {{{customise_auth_user_resource()}}} function in your template's config.py file.  To see the
-messages that can be changed, look for the {{{messages.*}}} lines in the {{{AuthS3.__init__}}} in {{{modules/s3/s3aaa.py}}}.
-These also show examples of using format elements like {{{%(system_name)s}}} to insert the system name, url, user name,
-and link to the user's profile.  Use the same format elements in your messages to have those inserted.
+The welcome message and other messages relating to registration and logging in are in {{{current.auth.messages}}}
+which can be set in a {{{customise_auth_user_resource()}}} function in your template's config.py file.
+To see the messages that can be changed, look for the {{{messages.*}}} lines in the {{{AuthS3.__init__}}}
+function in {{{modules/s3/s3aaa.py}}}.
+These also show examples of using format elements like {{{%(system_name)s}}} to insert the system name,
+url, user name, and link to the user's profile.  Use the same format elements in your messages to have
+those inserted.
+
+Example:
+
+{{{
+def customise_auth_user_resource(r, resource):
+    current.auth.messages.welcome_email_subject = "Welcome to %(system_name)s!"
+    current.auth.messages.welcome_email = \
+"""Welcome to %(system_name)s, %(first_name) %(last_name)!
+* You can start using %(system_name)s at: %(url)s
+* To edit your profile go to: %(url)s%(profile)s
+Thank you for registering!"""
+}}}
 
 These messages will be inserted in the translation files automatically, and do not need {{{T( )}}} around them.
-For a site with multiple languages, it is suggested to include the original message in English to server as the
+For a site with multiple languages, it is suggested to include the original message in English to serve as the
 key in the translation files, and to include the format elements (for system name, etc.) in the message, so that
 the translator can rearrange them as needed.