django-exchange-themes
django-exchange-themes is an appearance application that allows administrators the ability to select a predefined theme or customize their own theme.
The license for this matches the license found for colorfield, which is BSD License and listed in the classifiers section of setup.py. The author has also been added to the setup.py of django-exchange-themes.
Installation
-
pip install
pip install git+git://github.com/boundlessgeo/django-exchange-themes@master#egg=appearance
-
Add the following to your Django configuration (settings) file
INSTALLED_APPS = ( 'appearance', ) + INSTALLED_APPS
-
Run migrations
python manage.py migrate
-
Collect static
python manage.py collectstatic --noinput
Coverage
coverage within the app
virtualenv venv source venv/bin/activate pip install . pip install coverage cd appearance/tests python manage.py migrate python manage.py collectstatic --noinput coverage run manage.py test appearance
The Theme model
has the following fields:
name (Theme name)
- CharField
- Max length is 28
description (Theme description)
- CharField
- Max length is 64
default_theme (Default application included Theme)
- BooleanField
- Not editable in Admin console
active_theme (Enables Theme to be active)
- BooleanField
title (Theme landing page title)
- CharField
- Max length is 32
- Can be blank
tagline (Theme landing page tagline)
- CharField
- Max length is 64
- Can be blank
running_hex (Header/Footer color)
- ColorField (GUI to select the color)
- Default is 0F1A2C
running_text_hex (Header/Footer text color)
- ColorField (GUI to select the color)
- Default is FFFFFF
running_link_hex (Header/Footer link color)
- ColorField (GUI to select the color)
- Default is 0F1A2C
pb_text (Powered by text)
- CharField
- Max length is 64
- Default is 'Boundless Spatial'
pb_link (Powered by link)
- URLField
- Default is 'http://boundlessgeo.com/'
docs_link (Documentation links)
- URLField
- Can be blank
background_logo (Landing page background image)
- ImageField
- Can be blank
primary_logo (Landing page primary logo)
- ImageField
- Can be blank
banner_logo (Header logo)
- ImageField
- Can be blank
Note: The templates in appearance/templates will override existing templates in exchange. Blank fields will be accounted for and use the default settings in the template, which are Boundless Exchange defaults.