django-jet-reboot

.. 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://x.com/assem_ch>_.

========================================== Django JET Reboot (Django 3.x, 4.x, 5.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