Changes between Initial Version and Version 1 of DeveloperGuidelines/DeploymentSettings

Timestamp:

07/24/11 19:07:13 (14 years ago)

Author:

Michael Howden

Comment:

--

DeveloperGuidelines/DeploymentSettings

@@ +1 @@
+= Deployment Settings =
+
+== Purpose ==
+Deployment Settings can be used to provide configurable settings and functionality for different deployments, such as setting the name of the system ({{{deployment_settings.base.system_name}}}) or whether the user's  mobile phone number is requested during registration ({{{deployment_settings.auth.registration_requests_mobile_phone}}}).
+
+== Using Deployment Settings ==
+ * Deployment Settings are defined in {{{models/000_config}}}.
+ * The global {{{deployment_settings}}} variable is an instance of the {{{S3Config}}} class ({{{modules/s3/s3cfg.py}}}), which is used to store the Deployment Settings and provides methods for getting the Deployment Settings. These methods also provide default values for all of the Deployment Settings.
+ * Deployment Settings can be called in code to provide values or in logic statements to enable different functionality.
+
+== Adding New Deployment Settings ==
+ 1. ''If'' you are adding a new type (auth, base, database, etc) of Deployment Settings, add a new Storage variable to the {{{S3Config}}} class {{__init__}} ({{{modules/s3/s3cfg.py}}})/
+ 1. Add a new method to get the value of the new Deployment Settings to the {{{S3Config}}} class ({{{modules/s3/s3cfg.py}}}) and provide the default value.
+  * eg. {{{def get_auth_registration_requests_mobile_phone(self):}}}
+ 1. Add the Deployment Settings to {{{models/000_config}}}.
+ 1. Because {{{models/000_config}}} is not include in the BZR Branch, you will also need to add the same Deployment Settings to {{{deployment-templates/models/000_config}}}
+ 1. Use the Deployment Settings in your code!
+
+----
+Also See:
+ * DeveloperGuidelinesDeploymentTemplates