Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 11 days 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 (3 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 3Screenshots
-----------.. 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.pyYou 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.