django-setmagic

Magically editable settings for winged pony lovers.

Why?

Because sometimes it's cool to set global configuration values through a nice interface on the Django admin. And that's what SetMagic make possible. Enjoy!

Install and set up

Install it into your project's virtual environment:

$ pip install django-setmagic

Make sure you already have the Django admin set up! Then append to your Django project's INSTALLED_APPS setting.

INSTALLED_APPS = [
	...
	'django.contrib.admin',
	'setmagic',
	...
]

Also enable the SetMagic template context processor, if you want to use it on your templates, by adding it to the TEMPLATE_CONTEXT_PROCESSORS list:

TEMPLATE_CONTEXT_PROCESSORS = [
	...
	'setmagic.context_processors.load_setmagic',
]

Create the necessary tables, like usual:

$ python manage.py syncdb

...and that's pretty much it. :)

Usage

SetMagic will look into your project's settings for the name SETMAGIC_SCHEMA. It should be defined as a pure Python list of groups like the example below:

SETMAGIC_SCHEMA = [
    ('Facebook App Credentials', [
        dict(
            name='FACEBOOK_APP_ID',
            label=u'Facebook app ID',
            help_text=u'Unique app identification code provided by Facebook.'),
        dict(
            name='FACEBOOK_APP_SECRET',
            label=u'Facebook API secret',
            help_text=u'Unique and secret API code provided by Facebook.'),
    ]),
    ('Tracking', [
        dict(
            name='GOOGLE_ANALYTICS_CODE',
            label=u'Google Analytics code',
            help_text=u'Domain to identify this site through the GA API.'),
    ]),
]

From now on, you should be able to set values for your configurations through the Django admin. And you will, of course, be able to set and retrieve these values on your code.

from setmagic import settings

# Instantly save onto the database!
settings.FACEBOOK_APP_ID = '000000000000000'

# Retrieve the setting value from the database
print(settings.FACEBOOK_APP_ID)

# Deletes it from the database
del settings.FACEBOOK_APP_ID

If you added the template context processor like described above, you can also use SetMagic values on your templates.

<p>My Facebook app ID is <code>{{ setmagic.FACEBOOK_APP_ID }}</code></p>

See? No mistery. :)

Platform support

* Python 2.6+
* Python 3.x
* Django 1.5+

Contribute

You can play with the code at SetMagic's reposity on GitHub or donate me a few bucks from heart so I can write open source code without worrying too much about bills.