== Configuration Guidelines ==

=== {{{favicon.ico}}} & {{{robots.txt}}} ===
These can be provided via 2 different means:
 * mod_rewrite
 * {{{web2py/routes.py}}}: copy {{{routes.example.py}}} & edit

=== Configurable Options ===
These can be set via [http://127.0.0.1:8000/sahana/appadmin/update/db/s3_setting/1 appadmin]
 * Admin Name/Email/Tel
 * Debug: improve performance by deselecting this option.
 * Self-Registration: disable Self-Registration by deselecting this option.
 * Audit Read: Enable Auditing of all Read operations (Display)
 * Audit Write: Enable Auditing of all Write operations (Create/Update/Delete)

In time these will be configured by [wiki:BluePrintWebSetup Web Setup].

Email Verification for Self-Registration can be enabled in {{{controllers/default.py}}}.[[BR]]
This requires the ability to send emails (server details currently set in {{{modules/sahana.py}}})

=== Roles ===
By default the 1st user to register will gain the Administrator role.

All other users have just the 'Reader' level of access.

To add roles to users, go to appadmin & add this Mapping:
 * http://127.0.0.1:8000/sahana/appadmin/insert/db/auth_membership
(A custom GUI should, in time, be built for this)

=== Internet Hosting ===
Can switch to having users download files from CDNs instead of your server.[[BR]]
This can improve performance in 2 ways:
 * The CDN may have faster/closer servers to the client
 * Increases the number of files being downloaded simultaneously, since pulled from different hostnames: http://www.websiteoptimization.com/speed/tweak/parallel/

jQuery from Google  by uncommenting the line in {{{views/sahana_scripts_min.html}}}

ext-all.js & ext-all.css from Cachefly by uncommenting the lines in {{{views/gis/gis_scripts_min.html}}} & {{{views/gis/ol_js_loaders.html}}}
----
InstallationGuidelines