Skip to main content

Customise theme (css and template) on a per user/client/whatever basis

Project description

Custom Theme

https://travis-ci.org/novapost/django-pimpmytheme.png?branch=master

Per client/user/whatever django template and statics theming

WHY

When you need to use custom template and/or styling based on a model in your app (Site, User, etc…).

pimpmytheme will create a folder per “client” (a client can be a User, a Site or everything that implement the get_current method (see below). It also can be used for multiple projects at the same time. The folders are under a project name folder located in the pimpmytheme directory. Your designer can then pull/push this repository to edit the whole look and feel of all your projects in the same repository!

How

with the help of custom template loader ans static file loader, pimpmytheme load the custom template and statics files if they exists for the current object.

INSTALLATION

>>> pip install django-pimpmytheme

CONFIGURATION

add pimpmytheme in your INSTALLED_APPS :

INSTALLED_APPS = (‘pimpmytheme’,

… )

add the pimpmytheme staticfiles_finder to your STATICFILES_FINDERS :

STATICFILES_FINDERS = (

“pimpmytheme.static_finder.CustomFinder”, “django.contrib.staticfiles.finders.AppDirectoriesFinder”, )

add the custom template loader to your TEMPLATE_LOADERS:

TEMPLATE_LOADERS = (

‘pimpmytheme.template_loader.Loader’, ‘django.template.loaders.app_directories.Loader’, )

finaly, you need a model with the “get_current” method. get_current will return the object responsible for customization. For example, you can use the django.contrib.sites.Site model to customize your project per a site basis:

CUSTOM_THEME_LOOKUP_OBJECT = “django.contrib.sites.models.Site” CUSTOM_THEME_LOOKUP_ATTR = “name”

Then select the directory path where your customizations will be stored. It must be an absolute path.

PIMPMYTHEME_FOLDER = “/home/user/myproject/custom_statics”

You can stop configuration here, it will work and your static files will be collected in STATIC_ROOT by the collectstatic command.

If you want to go further in your configuration, you can set the directory name where your assets will be copied by the by the collectstatic command. It will be a subfolder of django_settings.STATIC_ROOT:

PIMPMYTHEME_FOLDER_NAME = ‘pimp_theme’

Then tell compressor to use pimpmytheme’s filter to build link to your assets :

STATICFILES_FINDERS = (

“yourapp.your_finder.PrefixedFinder”, “django.contrib.staticfiles.finders.AppDirectoriesFinder”, )

COMPRESS_CSS_FILTERS = [‘pimpmytheme.filters.PrefixedCssAbsoluteFilter’]

COMMANDS

To create the needed folders for customization, you can run the management command provided by pimpmytheme:

$ python manage.py create_folders

inside custom_form you will get a folder named as your project name. Inside this folder you wil get as many folder as you customization model objects. If you use the Site, you will get a example.com folder.

Inside this folder you will find a static folder containing an empty custom.less file. Here for your convenience. you can start editing this file to customize your style.

You can also create a template folder next to the static one and put some custom templates in it.

the pimpmytheme template loader will first look in this directory to load templates files. If not found, it will fallback on the django template loader

If your themes are in a git repo, add settings :

PIMPMYTHEME_GIT_REPOSITORY = ‘git@github.com:foo/your_pimp_folders.git’

and run the useful command to pull them into PIMPMYTHEME_FOLDER :

$ python manage.py update_themefolder_from_git

TEMPLATETAG SYSTEM

With django-pimpmytheme you get a templatetag system to manage custom media (css, js and images).

This template system ensure the custom media exist for the current customization. You can so get a bunch of css/js/img for each of your client and django-pimpmytheme will only load the media revelant for the current customization.

You can then use an asset management, compressor and so on on those files.

To use the templatetags first load it on the template:

{% load pimptheme %}

Then use pimp_css, pimp_js or pimp_img to load your assets :

<img src=”{% pimp ‘myimage.jpg’%}” alt=”Hello” style=”opacity:0.8;”> {% pimp_css ‘custom.css’%} {% pimp_js ‘javascript.js’%} {% pimp_img ‘myimage.jpg’%}

NOTE

thanks to https://github.com/leotrouvtou for helping finding the project name

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-pimpmytheme-1.10.tar.gz (179.5 kB view details)

Uploaded Source

Built Distribution

django_pimpmytheme-1.10-py2.py3-none-any.whl (15.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-pimpmytheme-1.10.tar.gz.

File metadata

File hashes

Hashes for django-pimpmytheme-1.10.tar.gz
Algorithm Hash digest
SHA256 c1393321d7e2a888c530b32d0e935c65fcc46a2094b893322d66b34e90f6c01d
MD5 cb236eb496a1138fbe58c95063850276
BLAKE2b-256 efefdeb81b3692e176ded90230f56a23944f5f14efeeb182de2b4c917eecd50d

See more details on using hashes here.

Provenance

File details

Details for the file django_pimpmytheme-1.10-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_pimpmytheme-1.10-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5ab0cebde1a3a3d95ea7a2c84c5aabf8f4aba928adf0e90a7c20d1bba0268508
MD5 460a7a3f354d05664bfb54fbda7f3a18
BLAKE2b-256 1adf9e13e58b2ca6849a4fbb616ab4335eedac809b0f569c9c45e9cba5ff1e16

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page