== Configuration Guidelines ==

=== Configurable Options ===
These can be set via [http://127.0.0.1:8000/sahana/admin/setting/update/1]
 * 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].

Some Auth options are currently only configurable via editing {{models/00_db.py}}:
{{{
mail.settings.server
mail.sender
auth.settings.login_methods.append(ldap_auth())
auth.settings.registration_requires_verification
auth.settings.captcha
auth.messages.verify_email
auth.settings.registration_requires_approval
auth.settings.gmail_login
}}}
In time we could expose to a Web-based admin page, although it's low priority as these are mostly installation-time decisions.

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

All other users have just the 'Authenticated' level of access, which by default allows 'Read' access to all records.

To Edit records, users need to be added to the 'Editors' role.

To add roles to users, go to the Administration menu & within User Management choose 'Membership'.

Security policy is configured in {{{models/zzz.py}}}

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

=== 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}}}

=== Performance Optimisation ===
 * http://groups.google.co.uk/group/web2py/browse_thread/thread/218bb58c96883578

=== Themes ===
Modify {{{views/layout.html}}}.

Can import Drupal themes: http://groups.google.com/group/web2py/browse_thread/thread/1ae6dba19ef40a53
----
InstallationGuidelines