Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
91 lines (58 sloc) 2.22 KB

Settings

Your settings can be found in settings.py. Here are explanations of a few oTree-specific settings. Full info on all Django's settings can be found here.

SESSION_CONFIGS

To create a session, you first need to define a "session config".

In settings.py, add an entry to SESSION_CONFIGS like this (assuming you have created apps named my_app_1 and my_app_2):

{
    'name': 'my_session_config',
    'display_name': 'My Session Config',
    'num_demo_participants': 2,
    'app_sequence': ['my_app_1', 'my_app_2'],
},

Once you have defined a session config, you can run otree devserver, open your browser to the admin interface, and create a new session. You would select "My Session Config" as the configuration to use.

For more info on how to use SESSION_CONFIGS, see :ref:`edit_config` and :ref:`session_config_treatments`.

SESSION_CONFIG_DEFAULTS

If you set a property in SESSION_CONFIG_DEFAULTS, it will be inherited by all configs in SESSION_CONFIGS, except those that explicitly override it. the session config can be accessed from methods in your apps as self.session.config, e.g. self.session.config['participation_fee']

REAL_WORLD_CURRENCY_CODE

See :ref:`currency`.

USE_POINTS

See :ref:`points`.

ROOMS

See :ref:`rooms`.

ROOM_DEFAULTS

See :ref:`rooms`.

ADMIN_USERNAME, ADMIN_PASSWORD

For security reasons, it's recommended to put your admin password in an environment variable, then read it in settings.py like this:

ADMIN_PASSWORD = environ.get('OTREE_ADMIN_PASSWORD')

To set OTREE_ADMIN_PASSWORD on Heroku, log into your Heroku dashboard's settings, and set the config var OTREE_ADMIN_PASSWORD to your password.

If you change ADMIN_USERNAME or ADMIN_PASSWORD, you need to reset the database.

DEMO_PAGE_TITLE

The title of the demo page

DEMO_PAGE_INTRO_HTML

The HTML in the sidebar of the demo page (previously called DEMO_PAGE_INTRO_TEXT)