Bez popisu

Denis K 98268c09de Merge branch 'dev' před 9 roky
docs bcd9ad3b77 Update license notes před 10 roky
jet b6168440d6 Update version před 9 roky
.gitignore e36ade21b7 Update .gitignore před 10 roky
.travis.yml c5e2944500 Update versions to previously used před 10 roky
CHANGELOG.rst c3fa1cbfc8 Update changelog před 9 roky
LICENSE 8e02297399 Change license to GPLv2 před 10 roky
MANIFEST.in 781ce85f98 Fix dashboard application templates not being loaded před 10 roky
README.rst bcd9ad3b77 Update license notes před 10 roky
manage.py d75a732e5f Add initial tests před 10 roky
setup.py d3dd5e24c1 Fix setup.py open file in case utf-8 path (thanks to edvm for the report) před 9 roky

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: incoming
* **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.core.context_processors.request' context processor is enabled in settings.py:

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