AuHau / django-jet

Modern responsive template for the Django admin interface with improved functionality

2018.08 - zvolsky notes:

• I try integrate geex-arts and others (ntcong + qwIvan at this time) into branch: dev

• My (zvolsky) changes into dev are:

  • package.json and bundle.min.js are updated to latest (2018-07) versions where possible (where jet js changes weren't required)
  • jet.jQuery is always present: v1.12.4
  • $===jQuery===django.jQuery is always present: v3.3.1 where original django.jQuery; otherwise v1.12.4 - see base.html code ad comments
  • you can force v3.3.1 in particular template: <script type="text/javascript" src="{% static 'admin/js/vendor/jquery/jquery.min.js' %}"></script>
  • sourcemap bundle.min.js.map for js debugging
  • removed SelectFilter2.js (repairs broken multiselects in Dj2.0) [need watching/testing]
  • fixed for dj2.1 sortable_by
  • partialy fixed strange django-ajax-selects fallback: reload jquery-ui from CDN (v11->v10)
  • hack/fix to go well with [+] in available/chosen widgets

• branch zvolsky just adds a changed README (added this top info)
• I'm sorry, I don't run any tests
• pip install git+https://github.com/zvolsky/django-jet.git
• licence: AGPL (or commercial licence from the original author (geex-arts?))

Django JET

Modern template for Django admin interface with improved functionality

Django JET has two kinds of licenses: open-source (AGPLv3) and commercial. Please note that using AGPLv3 code in your programs make them AGPL compatible too. So if you don't want to comply with that we can provide you a commercial license (visit Home page). The commercial license is designed for using Django JET in commercial products and applications without the provisions of the AGPLv3.

• Home page: http://jet.geex-arts.com/
• Live Demo: http://demo.jet.geex-arts.com/admin/
• Documentation: http://jet.readthedocs.org/
• libi.io http://libi.io/library/1683/django-jet
• PyPI: https://pypi.python.org/pypi/django-jet
• Support: [e-mail]

Why Django JET?

• New fresh look
• Responsive mobile interface
• Useful admin home page
• Minimal template overriding
• Easy integration
• Themes support
• Autocompletion
• Handy controls

Screenshots

Installation

• Download and install latest version of Django JET:

pip install django-jet
# or
easy_install django-jet

• Add 'jet' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'django.contrib.admin'):

INSTALLED_APPS = (
    ...
    'jet',
    'django.contrib.admin',
)

• Make sure django.template.context_processors.request context processor is enabled in settings.py (Django 1.8+ way):

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                ...
                'django.template.context_processors.request',
                ...
            ],
        },
    },
]

Warning

Before Django 1.8 you should specify context processors different way. Also use django.core.context_processors.request instead of django.template.context_processors.request.

from django.conf import global_settings

TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + (
    'django.core.context_processors.request',
)

• Add URL-pattern to the urlpatterns of your Django project urls.py file (they are needed for related–lookups and autocompletes):

urlpatterns = patterns(
    '',
    url(r'^jet/', include('jet.urls', 'jet')),  # Django JET URLS
    url(r'^admin/', include(admin.site.urls)),
    ...
)

• Create database tables:

python manage.py migrate jet
# or
python manage.py syncdb

• Collect static if you are in production environment:

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'):

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):

urlpatterns = patterns(
    '',
    url(r'^jet/', include('jet.urls', 'jet')),  # Django JET URLS
    url(r'^jet/dashboard/', include('jet.dashboard.urls', 'jet-dashboard')),  # Django JET dashboard URLS
    url(r'^admin/', include(admin.site.urls)),
    ...
)

• For Google Analytics widgets only install python package:

pip install google-api-python-client==1.4.1

• Create database tables:

python manage.py migrate dashboard
# or
python manage.py syncdb

• Collect static if you are in production environment:

python manage.py collectstatic