Sem descrição

Denis K 0d089a7ac9 Update instructions for Django 1.8+ há 9 anos atrás
docs 0d089a7ac9 Update instructions for Django 1.8+ há 9 anos atrás
jet 2049725cae Compile css, js há 9 anos atrás
.gitignore e36ade21b7 Update .gitignore há 10 anos atrás
.travis.yml c5e2944500 Update versions to previously used há 10 anos atrás
CHANGELOG.rst 42c3c8e5da Update changelog há 9 anos atrás
LICENSE 8e02297399 Change license to GPLv2 há 10 anos atrás
MANIFEST.in 781ce85f98 Fix dashboard application templates not being loaded há 10 anos atrás
README.rst 0d089a7ac9 Update instructions for Django 1.8+ há 9 anos atrás
manage.py d75a732e5f Add initial tests há 10 anos atrás
setup.py d3dd5e24c1 Fix setup.py open file in case utf-8 path (thanks to edvm for the report) há 9 anos atrás

README.rst

==========
Django JET
==========

.. image:: https://travis-ci.org/geex-arts/django-jet.svg?branch=master
:target: https://travis-ci.org/geex-arts/django-jet

**Modern template for Django admin interface with improved functionality**

Django JET has two kinds of licenses: open-source (GPLv2) and commercial. Please note that using GPLv2
code in your programs make them GPL too. So if you don't want to comply with that we can provide you a commercial
license (in this case please email at support@jet.geex-arts.com). The commercial license
is designed for using Django JET in commercial products and applications without the provisions of the GPLv2.

.. image:: https://raw.githubusercontent.com/geex-arts/jet/static/logo.png
:width: 500px
:height: 500px
:scale: 50%
:alt: Screenshot #1
:align: center

* Home page: http://jet.geex-arts.com/
* **Live Demo**: http://demo.jet.geex-arts.com/admin/
* Documentation: http://jet.readthedocs.org/
* PyPI: https://pypi.python.org/pypi/django-jet
* Support: support@jet.geex-arts.com

Screenshots
===========

.. image:: https://raw.githubusercontent.com/geex-arts/jet/static/screen1_720.png
:alt: Screenshot #1
:align: center
:target: https://raw.githubusercontent.com/geex-arts/jet/static/screen1.png

.. image:: https://raw.githubusercontent.com/geex-arts/jet/static/screen2_720.png
:alt: Screenshot #1
:align: center
:target: https://raw.githubusercontent.com/geex-arts/jet/static/screen2.png

.. image:: https://raw.githubusercontent.com/geex-arts/jet/static/screen3_720.png
:alt: Screenshot #1
:align: center
:target: https://raw.githubusercontent.com/geex-arts/jet/static/screen3.png

Beta
====
Current version is still in beta phase. Use it at your own risk (though may be already enough workable).

License
=======
Django JET is licensed under a
The GNU General Public License, Version 2

Installation
============

* Download and install latest version of Django JET:

.. code:: python

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

.. 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',
...
],
},
},
]

.. 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``.

.. code:: python

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

.. code:: python

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

* Create database tables:

.. code:: python

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

* 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(
'',
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:

.. code::

pip install google-api-python-client

* Create database tables:

.. code:: python

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

* Collect static if you are in production environment:

.. code:: python

python manage.py collectstatic