{"id":13448730,"url":"https://github.com/douglasmiranda/django-admin-bootstrap","last_synced_at":"2025-12-30T06:03:41.084Z","repository":{"id":3969443,"uuid":"5063914","full_name":"douglasmiranda/django-admin-bootstrap","owner":"douglasmiranda","description":"Responsive Theme for Django Admin With Sidebar Menu","archived":true,"fork":false,"pushed_at":"2022-10-10T08:21:49.000Z","size":2422,"stargazers_count":879,"open_issues_count":14,"forks_count":234,"subscribers_count":56,"default_branch":"master","last_synced_at":"2024-08-02T10:19:39.401Z","etag":null,"topics":["admin","bootstrap","dashboard","django","django-admin","responsive"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/douglasmiranda.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-07-16T06:47:31.000Z","updated_at":"2024-07-08T22:31:37.000Z","dependencies_parsed_at":"2022-07-16T15:30:41.533Z","dependency_job_id":null,"html_url":"https://github.com/douglasmiranda/django-admin-bootstrap","commit_stats":null,"previous_names":["django-admin-bootstrap/django-admin-bootstrap"],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmiranda%2Fdjango-admin-bootstrap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmiranda%2Fdjango-admin-bootstrap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmiranda%2Fdjango-admin-bootstrap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douglasmiranda%2Fdjango-admin-bootstrap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douglasmiranda","download_url":"https://codeload.github.com/douglasmiranda/django-admin-bootstrap/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221832218,"owners_count":16888196,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","bootstrap","dashboard","django","django-admin","responsive"],"created_at":"2024-07-31T06:00:19.585Z","updated_at":"2025-12-17T16:05:43.488Z","avatar_url":"https://github.com/douglasmiranda.png","language":"HTML","readme":"Responsive Django Admin\n=======================\n\nIf you're looking for a version compatible with Django 1.8 just install **0.3.7.1**.\n\nFeatures\n--------\n\n* Responsive\n* Sidebar Menu\n* Easy install / setup\n* Support Django **1.11**, **2.1**, **2.2** and **3.0**\n* Bootstrap 3\n* Python 3\n\n\nScreenshots\n-----------\n\n.. image:: https://raw.githubusercontent.com/douglasmiranda/django-admin-bootstrap/master/screenshots/screenshot.png\n    :target: https://github.com/douglasmiranda/django-admin-bootstrap/tree/master/screenshots\n    :alt: See Screenshots\n\n`More screenshots \u003chttps://github.com/douglasmiranda/django-admin-bootstrap/tree/master/screenshots\u003e`_\n\nINSTALL\n-------\n\nfrom pypi (recommended) ::\n\n    $ pip install bootstrap-admin\n\nAnd don't forget to add **bootstrap\\_admin** in ``INSTALLED_APPS`` before\nthe ``django.contrib.admin``.\n\nExample:\n\n.. code-block:: python\n\n    INSTALLED_APPS = (\n        # ...\n        'bootstrap_admin', # always before django.contrib.admin  \n        'django.contrib.admin',\n        # ...\n    )  \n\nCUSTOMIZE\n---------\n\nSidebar Menu\n^^^^^^^^^^^^\n\nIt is enabled by default. But if you remove ``django.template.context_processors.request`` from your ``context_processors``.\n\nJust disable it:\n\n.. code-block:: python\n\n    BOOTSTRAP_ADMIN_SIDEBAR_MENU = False\n\nBranding - Overriding logo\n^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nIf 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.\n\nFirst, make sure the ``TEMPLATES`` setting in your settings.py is properly configured:\n\n.. code-block:: python\n\n    TEMPLATES = [\n        {\n            'BACKEND': 'django.template.backends.django.DjangoTemplates',\n            'DIRS': [os.path.join(BASE_DIR, 'my_django_project/templates')],\n            'APP_DIRS': True,\n            # other stuff\n        },\n    ]\n\n`DIRS`: You must set the location of your templates, an absolute path.\n\nI'm assuming ``BASE_DIR`` is:\n\n.. code-block:: python\n\n    BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))\n\nThis pattern of creating a global templates folder could be useful for you to use for your **base.html** and other global templates.\n\nMore info: https://docs.djangoproject.com/en/2.1/ref/templates/api/#configuring-an-engine\n\nLet me show you a project structure as an example:\n\n.. code-block:: \n\n    ├── my_django_project\n    │   ├── core\n    │   │   ├── admin.py\n    │   │   ├── apps.py\n    │   │   ├── models.py\n    │   │   ├── tests.py\n    │   │   └── views.py\n    │   ├── settings.py\n    │   ├── templates\n    │   │   └── admin\n    │   │       ├── base_site.html\n    │   │       └── login.html\n    │   ├── urls.py\n    │   └── wsgi.py\n    ├── manage.py\n\nYou can see I created a global **templates/** folder, \nwith another directory inside **admin/** containing **login.html** and **base_site.html**.\n\nTheir respective contents are:\n\n**base_site.html**\n\n.. code-block:: html\n\n    {% extends 'admin/base_site.html' %}\n    {% load static %}\n\n    {% block branding %}\n        \u003ca href=\"{% url 'admin:index' %}\" class=\"django-admin-logo\"\u003e\n            \u003c!-- Django Administration --\u003e\n            \u003cimg height=\"60\" src=\"{% static \"bootstrap_admin/img/logo-140x60.png\" %}\" alt=\"{{ site_header|default:_('Django administration') }}\"\u003e\n        \u003c/a\u003e\n    {% endblock branding %}\n\n\n**login.html**\n\n.. code-block:: html\n\n    {% extends 'admin/login.html' %}\n    {% load i18n static %}\n\n    {% block branding %}\n        \u003ca href=\"{% url 'admin:index' %}\" class=\"django-admin-logo\"\u003e\n            \u003c!-- Django Administration --\u003e\n            \u003cimg height=\"60\" src=\"{% static \"bootstrap_admin/img/logo-140x60.png\" %}\" alt=\"{{ site_header|default:_('Django administration') }}\"\u003e\n        \u003c/a\u003e\n    {% endblock branding %}\n\nMore info: https://docs.djangoproject.com/en/2.1/ref/contrib/admin/#admin-overriding-templates\n\nContributing\n------------\n\n1. Fork it!\n2. Create your feature branch: ``git checkout -b my-new-feature``\n3. Commit your changes: ``git commit -am 'Add some feature'``\n4. Push to the branch: ``git push origin my-new-feature``\n5. Submit a pull request =]\n\nSee the `full list \u003chttps://github.com/douglasmiranda/django-admin-bootstrap/blob/master/AUTHORS.rst\u003e`_ of contributors.\n\n`Open an issue \u003chttps://github.com/douglasmiranda/django-admin-bootstrap/issues/new\u003e`_\nif you find a bug or want something more.\n","funding_links":[],"categories":["Admin interface","HTML","Best Django Admin Interface Resources"],"sub_categories":["Django Admin Themes \u0026 UI Enhancements"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasmiranda%2Fdjango-admin-bootstrap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouglasmiranda%2Fdjango-admin-bootstrap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouglasmiranda%2Fdjango-admin-bootstrap/lists"}