django-prismriver

A light but cool Django admin theme


Keywords
django, admin
License
MirOS
Install
pip install django-prismriver==0.12

Documentation

Django Prismriver: A light but cool Django admin Theme

Prismriver is another django-admin theme aiming to be good looking while maintaining maximum compatibility with as many django packages as possible, with zero/minimal dependencies.

Aside from that it/will try to be modular with dashboard plugins (not yet implemented) so you can configure it easily the way you prefer.

How it looks

DjangoCms on Prismriver

Requirements

  • Django 1.4
  • 5 mins to configure it.

Installation

  • Put the prismriver directory into your Pythonpath/project folder or install it using pip using:
    • pip install django-prismriver
  • In settings.py make sure that:

    • You have staticfiles configured correctly.
    • You look for templates on a '/templates/' directory.
    • You have the following template context processors.

      TEMPLATECONTEXTPROCESSORS = ( 'django.core.contextprocessors.request', 'django.contrib.auth.contextprocessors.auth', )

    • On INSTALLED_APPS make sure you add the 'prismriver' app before django.contrib.admin. For example like this:

      INSTALLED_APPS = ( 'prismriver', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'django.contrib.messages', 'django.contrib.staticfiles', 'django.contrib.admin', )

    • Run your server and it works!

    • Now there are some extended settings if you want to customize the sidebar.

      • CUSTOM_MENU: Allows you to enable the custom menu. By default this is false.
      • SIDEBARAPPMENU: When the previous option is true, it allows you to create "Folders/Menus" contontaining various models. For example imagine you want to unify the auth and sites apps in one menu with all it's options inside. Well, we do the following:

        SIDEBARAPPMENU = [ {"name": "Users and Settings", "items": ["auth", "prismriver", "sites"], "icon": "users.png", "bigicon": "usersbig.png", "description": "Manage everything about the users here", }, ]

      • SIDEBARLASTACTIONS: Shows the last actions widget thing. By default this is true

      • DEFAULT_LABELS If don't want custom menu but you want to use different labels/icons for your applications you can configure them as following:

        DEFAULT_LABELS = {

        "auth/": ["Users and Groups", "users.png", "users_big.png","Manage the application users or groups permissions"],

        "sites/": ["Site management", "web.png", "web_big.png", "Manages the sites application"]}

      The "web_big.png" field is not used, it will be removed on the next updates (old version stuff) - For more details you can see prismriver/settings.py