Changes between Version 114 and Version 115 of ConfigurationGuidelines

Timestamp:

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

Author:

Pat Tressel

Comment:

--

ConfigurationGuidelines

@@ -90 +90 @@
 Security policy is initially defined in {{{models/zzz_1st_roles.py}}} but then subsequently managed via the database.
 == Configurable Options ==
+
+=== Basic Options ===
+
 These can be set via [http://127.0.0.1:8000/sahana/admin/setting/1/update]
  * Admin Name/Email/Tel
@@ -108 +111 @@
 We would like to expose these to a [wiki:BluePrintWebSetup Web Setup], although it's low priority as these are mostly installation-time decisions.
 
+=== Modules and Menu ===
+
 Disable unnecessary modules, which is currently either done in {{{models/000_config.py}}} or in the template's {{{config.py}}} file. Active modules are stored in settings.modules, which is an instance of !OrderedDict. The key of each item in this !OrderedDict is the name of the module (a string), and each value is an instance of Storage. To disable a module, either comment out the relevant lines of {{{config.py}}} in the template, where the list is populated, or else use the pop method in {{{models/000_config.py}}} to remove the relevant item from settings.modules.
 
@@ -113 +118 @@
   * edit file {{{models/01_modules.py}}}
   * section: {{{s3.menu_modules}}}
+
+=== Table Fields ===
 
 If you wish to hide some fields which you don't want to confuse your system, then you can do something like this {{{models/zzz_local.py}}} instead of amending the main model (this means that future merges from trunk won't clobber your changes):
@@ -145 +152 @@
 }}}
 
+=== 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.
+
+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
+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.
 == Mapping Options ==
 http://localhost:8000/sahana/gis/config/update/1