home-information/docs/dev/Settings.md

Settings

App Settings

Each internal Django app module can provide user-controllable settings that appear on the main config page. These settings are auto-discovered by the config app module. The presence of a file named settings.py in an app module will automatically get picked up an create a new config area on the user-facing config page.

In this settings.py file, defined a subclass of the enum SettingEnum to define the label and data types. See existing examples for details.

Internal Settings

For help in debugging, there is a URL to inspect the Django internal settings.py content.

http://localhost/config/internal

Adding a New Tab Section to the Config UI

• Add entry to ConfigPageType
• Add a View - view class should extend ConfigPageView
• Override:
  • config_page_type()
  • get_main_template_name()
  • get_template_context()
• Create template (matching name)
• Should extend config/pages/config_base.html
• Add to urls.py (ensure this is included in top-level urls.py)