Skip to content

CoLuiza/django-admin-no-more-blue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django admin - No more blue

Django admin - no more blue is a Django app that let you choose a skin for your django admin. You can let your users set their favorite theme on the session or you can choose to statically set the theme for the entire application. With a variations of fruity themes you can now set a unique appearance for your Django.

Color your environments! It's easier not to break something into production now.

Show me how to use it

After you follow the guide bellow on getting started with django-admin-no-more-blue it should work like this:

If STATIC_THEME is False

The theme will be selected by every user and will be saved on the session

image

You can spot the CHANGE THEME button, don't be shy! Click it!

image

Let's say we change the theme to PLUM.

image

That's it, your theme is now purple and fine!

If STATIC_THEME is True

The select theme option will not be visible anymore and all the users will see the theme configured in settings.

image

As you can see, in the settings, the THEME is set to "apple".

Quick Start

  • Add "no_more_blue" to your INSTALLED_APPS settings like this:

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

! The order is important. Place the app before the default admin app.

  • In settings.py, make sure you have 'django.template.context_processors.request' added in the context_processors.
  • In settings.py, at TEMPLATES section, inside 'OPTIONS', at the same level with context_processors, add:

    'libraries': {
                'themes': 'no_more_blue.templatetags.themes',
      }

TEMPLATES should look like this:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.request',
                 ...
            ],
            'libraries': {
                'themes': 'no_more_blue.templatetags.themes',

            }
        },
    },
]
  • Include URLconf into your project urls.py like this:

    from no_more_blue.urls import themes_urlpatterns
    ...
    
    urlpatterns = [
        path('themes/', include(themes_urlpatterns)),
        ...
    ]
  • And as a final step add STATIC_THEME and THEME variables in your settings.

    STATIC_THEME - True/False depending on whether you want the theme to be static and all the users will have the same theme.

    THEME - if the theme is static (STATIC_THEME = True) you can set which theme you want to render. Here you should set the AKA for the theme. e.g. THEME = 'plum'

List of themes:
AKA TITLE COLOR
base

Base Theme

Light blue

blueberry

Blueberry Theme

Blue

apple

Green Apple Theme

Green

melon

Melon Theme

Dark Green

peach

Peach Theme

Orange

plum

Plum Theme

Light Purple

grapes

Grapes Theme

Purple

  • That's it! Do not forget to use collectstatic when you are not in DEBUG mode

About

Color your environments! It's easier not to break something into production now.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published