Project description

django-theme

Allow a Django user to set a theme preference.

Quickstart

Install django-theme via pip:
```
pip install django-theme
```
Add theme to your INSTALLED_APPS in your project settings.py file:
```
INSTALLED_APPS = [
    '...',
    'theme',
]
```
Run migrate:
```
python manage.py migrate
```

Add the following to your context_processors setting:

TEMPLATES = [
    {
        'BACKEND': '...',
        'OPTIONS': {
            'context_processors': [
                '...',
                '...',
                'theme.context_processors.theme',
            ],
        },
    },
]

In your template, you can then use the following snippet (theme options are 'system', 'dark' and 'light'):

<body class="{% spaceless %}
        {% if theme == 'dark' %}
                dark-theme
        {% endif %}
{% endspaceless %}">

The Theme model defines a one-to-one relationship with the User model. Therefore, the theme object for a user can be retrieved by using:
```
theme = user.theme
```

Compatibility

Compatible with Python 3.8 and above.
Compatible with Django 3.2 and above.

Versioning

This project follows semantic versioning (SemVer).

License and code of conduct

Check the root of the repo for these files.

Project details

These details have not been verified by PyPI

Project links

Homepage

GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Release history Release notifications | RSS feed

This version

0.3

Aug 23, 2021

Download files

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

Source Distribution

django-theme-0.3.tar.gz (15.9 kB view hashes)

Uploaded Aug 23, 2021 Source

Built Distribution

django_theme-0.3-py3-none-any.whl (17.3 kB view hashes)

Uploaded Aug 23, 2021 Python 3

Hashes for django-theme-0.3.tar.gz

Hashes for django-theme-0.3.tar.gz
Algorithm	Hash digest
SHA256	`1bc380062f4b876c26e71c4433797877de36814473f896991a01fa3d22095c92`
MD5	`3109c6dfa6ef2627d9dab29bc18b001e`
BLAKE2b-256	`aa9e64def074dedf7a9012b9ecba5a6f253d61d605e3cb5f439f136a342527c6`

Hashes for django_theme-0.3-py3-none-any.whl

Hashes for django_theme-0.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`bf7856327c9585f2b71c48087194371294806f150c9fce8c2736934c819bae8b`
MD5	`1ab205f449bb23ee34cfe9edfa1a5e32`
BLAKE2b-256	`3a9734fbe23e13830b33fe06431d702dc50940c6e103b61c6c5dde9be2225544`