Changes between Version 114 and Version 115 of ConfigurationGuidelines


Ignore:
Timestamp:
03/18/16 11:03:49 (6 years ago)
Author:
Pat Tressel
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ConfigurationGuidelines

    v114 v115  
    9090Security policy is initially defined in {{{models/zzz_1st_roles.py}}} but then subsequently managed via the database.
    9191== Configurable Options ==
     92
     93=== Basic Options ===
     94
    9295These can be set via [http://127.0.0.1:8000/sahana/admin/setting/1/update]
    9396 * Admin Name/Email/Tel
     
    108111We would like to expose these to a [wiki:BluePrintWebSetup Web Setup], although it's low priority as these are mostly installation-time decisions.
    109112
     113=== Modules and Menu ===
     114
    110115Disable 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.
    111116
     
    113118  * edit file {{{models/01_modules.py}}}
    114119  * section: {{{s3.menu_modules}}}
     120
     121=== Table Fields ===
    115122
    116123If 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):
     
    145152}}}
    146153
     154=== Registration Message Options ===
     155
     156The welcome message and other messages relating to registration and logging in are in {{{settings.auth.messages}}}
     157which can be set in a {{{customise_auth_user_resource()}}} function in your template's config.py file.  To see the
     158messages that can be changed, look for the {{{messages.*}}} lines in the {{{AuthS3.__init__}}} in {{{modules/s3/s3aaa.py}}}.
     159These also show examples of using format elements like {{{%(system_name)s}}} to insert the system name, url, user name,
     160and link to the user's profile.  Use the same format elements in your messages to have those inserted.
     161
     162These messages will be inserted in the translation files automatically, and do not need {{{T( )}}} around them.
     163For a site with multiple languages, it is suggested to include the original message in English to server as the
     164key in the translation files, and to include the format elements (for system name, etc.) in the message, so that
     165the translator can rearrange them as needed.
    147166== Mapping Options ==
    148167http://localhost:8000/sahana/gis/config/update/1