2011-01-26 00:10:30 +01:00
|
|
|
django-helpdesk - A Django powered ticket tracker for small enterprise.
|
2011-02-05 05:51:34 +01:00
|
|
|
=======================================================================
|
2008-02-06 05:36:07 +01:00
|
|
|
|
2011-02-05 05:59:24 +01:00
|
|
|
Copyright 2009-11 Jutda and Ross Poulton. All Rights Reserved. See LICENSE for details.
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-01-26 00:10:30 +01:00
|
|
|
django-helpdesk was formerly known as Jutda Helpdesk, named after the
|
|
|
|
|
company who originally created it. As of January 2011 the name has been
|
|
|
|
|
changed to reflect what it really is: a Django-powered ticket tracker with
|
|
|
|
|
contributors reaching far beyond Jutda.
|
|
|
|
|
|
2011-02-05 00:13:37 +01:00
|
|
|
Complete documentation is available in the docs/ directory, or online at http://django-helpdesk.readthedocs.org/.
|
|
|
|
|
|
2011-02-05 05:59:24 +01:00
|
|
|
You can see a demo installation at http://demo.jutdahelpdesk.com
|
|
|
|
|
|
|
|
|
|
Licensing
|
|
|
|
|
=========
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-01-26 00:08:41 +01:00
|
|
|
See the file 'LICENSE' for licensing terms. Note that django-helpdesk is
|
2009-01-23 11:35:53 +01:00
|
|
|
distributed with 3rd party products which have their own licenses. See
|
2009-01-20 09:13:54 +01:00
|
|
|
LICENSE.3RDPARTY for license terms for included packages.
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-02-05 05:59:24 +01:00
|
|
|
Dependencies (pre-flight checklist)
|
|
|
|
|
===================================
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-02-05 05:51:34 +01:00
|
|
|
1. Python 2.4+
|
2011-01-26 00:08:41 +01:00
|
|
|
2. Django (1.2 or newer)
|
2008-01-16 04:23:43 +01:00
|
|
|
3. An existing WORKING Django project with database etc. If you
|
2008-01-15 00:12:27 +01:00
|
|
|
cannot log into the Admin, you won't get this product working.
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-02-05 05:51:34 +01:00
|
|
|
**NOTE REGARDING SQLITE AND SEARCHING:**
|
2009-01-22 08:33:30 +01:00
|
|
|
If you use sqlite as your database, the search function will not work as
|
|
|
|
|
effectively as it will with other databases due to its inability to do
|
|
|
|
|
case-insensitive searches. It's recommended that you use PostgreSQL or MySQL
|
|
|
|
|
if possible. For more information, see this note in the Django documentation:
|
|
|
|
|
http://docs.djangoproject.com/en/dev/ref/databases/#sqlite-string-matching
|
|
|
|
|
|
2009-03-08 06:49:08 +01:00
|
|
|
When you try to do a keyword search using sqlite, a message will be displayed
|
|
|
|
|
to alert you to this shortcoming. There is no way around it, sorry.
|
|
|
|
|
|
2011-02-05 05:59:24 +01:00
|
|
|
Upgrading from previous versions
|
|
|
|
|
================================
|
2009-01-23 11:35:53 +01:00
|
|
|
|
2011-01-26 00:08:41 +01:00
|
|
|
If you are upgrading from a previous version of django-helpdesk, you should
|
2009-01-23 11:35:53 +01:00
|
|
|
read the UPGRADING file to learn what changes you will need to make to get
|
2011-01-26 00:08:41 +01:00
|
|
|
the current version of django-helpdesk working.
|
2009-01-23 11:35:53 +01:00
|
|
|
|
2011-01-26 00:08:41 +01:00
|
|
|
1. Find out your current version of django-helpdesk. In the 'helpdesk' folder,
|
2011-02-05 05:51:34 +01:00
|
|
|
use the 'svn' command to find the current revision::
|
2009-01-23 11:35:53 +01:00
|
|
|
|
2011-02-05 05:51:34 +01:00
|
|
|
svn info .
|
2009-01-23 11:35:53 +01:00
|
|
|
|
2011-02-05 05:51:34 +01:00
|
|
|
Look for the 'Revision' line, eg::
|
2009-01-23 11:35:53 +01:00
|
|
|
|
2011-02-05 05:51:34 +01:00
|
|
|
Revision: 92
|
2009-01-23 11:35:53 +01:00
|
|
|
|
|
|
|
|
2. Read through the UPGRADE file, looking for any changse made _after_ that
|
|
|
|
|
revision. Apply the commands provided in order from oldest to most recent.
|
|
|
|
|
|
|
|
|
|
3. Restart your web server software (eg Apache) or FastCGI instance, to ensure
|
|
|
|
|
the latest changes are in use.
|
|
|
|
|
|
|
|
|
|
4. Continue to the 'Initial Configuration' area, if needed.
|
|
|
|
|
|
2011-02-05 05:59:24 +01:00
|
|
|
Installation
|
|
|
|
|
============
|
2008-01-07 21:22:13 +01:00
|
|
|
|
2011-02-05 00:13:37 +01:00
|
|
|
``pip install django-helpdesk``
|
2008-08-18 23:29:31 +02:00
|
|
|
|
2011-02-05 00:13:37 +01:00
|
|
|
For further installation information see docs/install.html and docs/configuration.html
|
2011-02-02 12:40:40 +01:00
|
|
|
|
2011-02-07 08:50:47 +01:00
|
|
|
Internationalisation
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
If you want to help translate django-helpdesk into languages other than English, we encourage you to make use of our Transifex project.
|
|
|
|
|
|
|
|
|
|
http://www.transifex.net/projects/p/django-helpdesk/resource/core/
|
|
|
|
|
|
|
|
|
|
Feel free to request access to contribute your translations.
|
