django-extra-settings

config and manage extra settings using just the django admin.

Installation

Run pip install django-extra-settings
Add extra_settings to settings.INSTALLED_APPS
Run python manage.py migrate
Run python manage.py collectstatic
Restart your application server

Usage

Settings

All these settings are optional, if not defined in settings.py the default values (listed below) will be used.

# if True the template tag will fallback to django.conf.settings,
# very useful to retrieve conf settings such as DEBUG.
EXTRA_SETTINGS_FALLBACK_TO_CONF_SETTINGS = True

# the upload_to path value of settings of type 'file'
EXTRA_SETTINGS_FILE_UPLOAD_TO = 'files'

# the upload_to path value of settings of type 'image'
EXTRA_SETTINGS_IMAGE_UPLOAD_TO = 'images'

Admin

Just go to the admin where you can:

Create a new setting
Update an existing setting
Delete an existing setting

Python

You can retrieve settings programmatically:

from extra_settings.models import Setting

value = Setting.get('SETTING_NAME', default='django-extra-settings')

Templates

You can retrieve settings in templates:

{% load extra_settings %}

{% get_setting 'SETTING_NAME' default='django-extra-settings' %}

Testing

# create python virtual environment
virtualenv testing_django_extra_settings

# activate virtualenv
cd testing_django_extra_settings && . bin/activate

# clone repo
git clone https://github.com/fabiocaccamo/django-extra-settings.git src && cd src

# install dependencies
pip install -r requirements.txt

# run tests
tox
# or
python setup.py test
# or
python -m django test --settings "tests.settings"

License

Released under MIT License.

Ladet02/django-extra-settings