.. image:: https://github.com/assem-ch/django-jet-reboot/actions/workflows/tests.yml/badge.svg
**Note**: More collaborators are needed to maintain the project, feel free to contact `@assem-ch <https://github.com/assem-ch>`_.
=======================================
Django JET Reboot (Django 3.x and 4.x )
=======================================
Django Jet Reboot is modern template for Django admin interface with improved functionality. Rebooting the original project : `django-jet <https://github.com/geex-arts/django-jet>`_.
We focus only on django >= 3.0 & Python >= 3.7. We can't support old versions.
Why Django JET?
======================
* New fresh look
* Responsive mobile interface
* Useful admin home page
* Minimal template overriding
* Easy integration
* Themes support
* Autocompletion
* Handy controls
Screenshots
===========
.. image:: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen1_720.png
:alt: Screenshot #1
:align: center
:target: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen1.png
.. image:: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen2_720.png
:alt: Screenshot #2
:align: center
:target: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen2.png
.. image:: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen3_720.png
:alt: Screenshot #3
:align: center
:target: https://raw.githubusercontent.com/geex-arts/django-jet/static/screen3.png
Installation
============
* Download and install latest version of Django JET Reboot:
.. code:: python
pip install django-jet-reboot
* Add 'jet' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'django.contrib.admin'):
.. code:: python
INSTALLED_APPS = (
...
'jet',
'django.contrib.admin',
)
* Make sure ``django.template.context_processors.request`` context processor is enabled in settings.py (Django 1.8+ way):
.. code:: python
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
...
'django.template.context_processors.request',
...
],
},
},
]
* Add URL-pattern to the urlpatterns of your Django project urls.py file (they are needed for related–lookups and autocompletes):
.. code:: python
urlpatterns = patterns(
'',
path('jet/', include('jet.urls', 'jet')), # Django JET URLS
path('admin/', include(admin.site.urls)),
...
)
* Create database tables:
.. code:: python
python manage.py migrate jet
* Collect static if you are in production environment:
.. code:: python
python manage.py collectstatic
* Clear your browser cache
Dashboard installation
======================
.. note:: Dashboard is located into a separate application. So after a typical JET installation it won't be active.
To enable dashboard application follow these steps:
* Add 'jet.dashboard' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'jet'):
.. code:: python
INSTALLED_APPS = (
...
'jet.dashboard',
'jet',
'django.contrib.admin',
...
)
* Add URL-pattern to the urlpatterns of your Django project urls.py file (they are needed for related–lookups and autocompletes):
.. code:: python
urlpatterns = patterns(
'',
path('jet/', include('jet.urls', 'jet')), # Django JET URLS
path('jet/dashboard/', include('jet.dashboard.urls', 'jet-dashboard')), # Django JET dashboard URLS
path('admin/', include(admin.site.urls)),
...
)
* **For Google Analytics widgets only** install python package:
.. code::
pip install google-api-python-client==1.4.1
* Create database tables:
.. code:: python
python manage.py migrate dashboard
* Collect static if you are in production environment:
.. code:: python
python manage.py collectstatic