https://github.com/douglasmiranda/django-admin-bootstrap

Responsive Theme for Django Admin With Sidebar Menu
https://github.com/douglasmiranda/django-admin-bootstrap

admin bootstrap dashboard django django-admin responsive

Last synced: about 2 months ago
JSON representation

Responsive Theme for Django Admin With Sidebar Menu

• Host: GitHub
• URL: https://github.com/douglasmiranda/django-admin-bootstrap
• Owner: douglasmiranda
• License: mit
• Archived: true
• Created: 2012-07-16T06:47:31.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2022-10-10T08:21:49.000Z (about 2 years ago)
• Last Synced: 2024-08-02T10:19:39.401Z (4 months ago)
• Topics: admin, bootstrap, dashboard, django, django-admin, responsive
• Language: HTML
• Homepage:
• Size: 2.31 MB
• Stars: 879
• Watchers: 56
• Forks: 234
• Open Issues: 14
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-django - django-admin-bootstrap - Responsive Skin for Django Admin. (Admin interface)

README

        
Responsive Django Admin

=======================

If you're looking for a version compatible with Django 1.8 just install **0.3.7.1**.

Features

--------

* Responsive

* Sidebar Menu

* Easy install / setup

* Support Django **1.11**, **2.1**, **2.2** and **3.0**

* Bootstrap 3

* Python 3

Screenshots

-----------

.. image:: https://raw.githubusercontent.com/douglasmiranda/django-admin-bootstrap/master/screenshots/screenshot.png

    :target: https://github.com/douglasmiranda/django-admin-bootstrap/tree/master/screenshots

    :alt: See Screenshots

`More screenshots `_

INSTALL

-------

from pypi (recommended) ::

    $ pip install bootstrap-admin

And don't forget to add **bootstrap\_admin** in ``INSTALLED_APPS`` before

the ``django.contrib.admin``.

Example:

.. code-block:: python

    INSTALLED_APPS = (

        # ...

        'bootstrap_admin', # always before django.contrib.admin  

        'django.contrib.admin',

        # ...

    )  

CUSTOMIZE

---------

Sidebar Menu

^^^^^^^^^^^^

It is enabled by default. But if you remove ``django.template.context_processors.request`` from your ``context_processors``.

Just disable it:

.. code-block:: python

    BOOTSTRAP_ADMIN_SIDEBAR_MENU = False

Branding - Overriding logo

^^^^^^^^^^^^^^^^^^^^^^^^^^

If you want to use your own logo, you can achieve this by overriding the **login.html** and **base_site.html**, just like in Django Admin.

First, make sure the ``TEMPLATES`` setting in your settings.py is properly configured:

.. code-block:: python

    TEMPLATES = [

        {

            'BACKEND': 'django.template.backends.django.DjangoTemplates',

            'DIRS': [os.path.join(BASE_DIR, 'my_django_project/templates')],

            'APP_DIRS': True,

            # other stuff

        },

    ]

`DIRS`: You must set the location of your templates, an absolute path.

I'm assuming ``BASE_DIR`` is:

.. code-block:: python

    BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

This pattern of creating a global templates folder could be useful for you to use for your **base.html** and other global templates.

More info: https://docs.djangoproject.com/en/2.1/ref/templates/api/#configuring-an-engine

Let me show you a project structure as an example:

.. code-block:: 

    ├── my_django_project

    │   ├── core

    │   │   ├── admin.py

    │   │   ├── apps.py

    │   │   ├── models.py

    │   │   ├── tests.py

    │   │   └── views.py

    │   ├── settings.py

    │   ├── templates

    │   │   └── admin

    │   │       ├── base_site.html

    │   │       └── login.html

    │   ├── urls.py

    │   └── wsgi.py

    ├── manage.py

You can see I created a global **templates/** folder, 

with another directory inside **admin/** containing **login.html** and **base_site.html**.

Their respective contents are:

**base_site.html**

.. code-block:: html

    {% extends 'admin/base_site.html' %}

    {% load static %}

    {% block branding %}

        

            

            

        

    {% endblock branding %}

**login.html**

.. code-block:: html

    {% extends 'admin/login.html' %}

    {% load i18n static %}

    {% block branding %}

        

            

            

        

    {% endblock branding %}

More info: https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#admin-overriding-templates

Contributing

------------

1. Fork it!

2. Create your feature branch: ``git checkout -b my-new-feature``

3. Commit your changes: ``git commit -am 'Add some feature'``

4. Push to the branch: ``git push origin my-new-feature``

5. Submit a pull request =]

See the `full list `_ of contributors.

`Open an issue `_

if you find a bug or want something more.