Rebuilt HTML documentation

This commit is contained in:
Ross Poulton 2011-02-05 05:11:34 +00:00
parent a15c8e0e23
commit 613b2fc132
26 changed files with 476 additions and 122 deletions

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

Binary file not shown.

View File

@ -1,6 +1,6 @@
django-helpdesk Ticket API Ticket API
========================== ==========
django-helpdesk includes an API accessible via HTTP POST requests, allowing you to create and alter tickets from 3rd party software and systems. django-helpdesk includes an API accessible via HTTP POST requests, allowing you to create and alter tickets from 3rd party software and systems.
For usage instructions and command syntax, see the file templates/helpdesk/api_help.html, or visit http://helpdesk/api/help/. For usage instructions and command syntax, see the file ``templates/helpdesk/api_help.html``, or visit http://helpdesk/api/help/.

View File

@ -1,5 +1,5 @@
django-helpdesk Configuration Configuration
============================= =============
Before django-helpdesk will be much use, you need to do some basic configuration. Most of this is done via the Django admin screens. Before django-helpdesk will be much use, you need to do some basic configuration. Most of this is done via the Django admin screens.

View File

@ -1,5 +1,5 @@
django-helpdesk custom fields Custom Fields
============================= =============
As of February 2011, django-helpdesk supports custom fields on the ``Ticket`` model. These fields are created by using the Django administration tool, and are shown on both the public and staff submission forms. As of February 2011, django-helpdesk supports custom fields on the ``Ticket`` model. These fields are created by using the Django administration tool, and are shown on both the public and staff submission forms.

View File

@ -47,7 +47,7 @@ If a user is a staff member, they get general helpdesk access, including:
Licensing Licensing
--------- ---------
django-helpdesk is released under the BSD license, however it packages 3rd party applications which may be using a different license. See the files LICENSE and LICENSE.3RDPARTY for more details. django-helpdesk is released under the BSD license, however it packages 3rd party applications which may be using a different license. More details can be found in the :doc:`license documentation`.
Dependencies Dependencies
------------ ------------
@ -63,6 +63,7 @@ Contents:
:maxdepth: 2 :maxdepth: 2
:glob: :glob:
license
install install
configuration configuration
settings settings

View File

@ -15,7 +15,7 @@ Try using ``pip install django-helpdesk``. Go and have a beer to celebrate Pytho
GIT Checkout (Cutting Edge) GIT Checkout (Cutting Edge)
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
``git clone git://github.com/rossp/django-helpdesk.git`` If you're planning on editing the code or just want to get whatever is the latest and greatest, you can clone the official Git repository with ``git clone git://github.com/rossp/django-helpdesk.git``
Copy the ``helpdesk`` folder into your ``PYTHONPATH``. Copy the ``helpdesk`` folder into your ``PYTHONPATH``.
@ -49,9 +49,9 @@ Adding To Your Django Project
./manage.py syncdb ./manage.py syncdb
4. Inside your ``MEDIA_ROOT`` folder, create a new folder called ``helpdesk`` and copy the contents of ``helpdesk/htdocs`` into it. Alternatively, create a symlink: 4. Inside your ``MEDIA_ROOT`` folder, create a new folder called ``helpdesk`` and copy the contents of ``helpdesk/htdocs`` into it. Alternatively, create a symlink::
``ln -s /path/to/helpdesk/htdocs /path/to/media/helpdesk`` ln -s /path/to/helpdesk/htdocs /path/to/media/helpdesk
5. Inside your ``MEDIA_ROOT`` folder, inside the ``helpdesk`` folder, is a folder called ``attachments``. Ensure your web server software can write to this folder - something like this should do the trick:: 5. Inside your ``MEDIA_ROOT`` folder, inside the ``helpdesk`` folder, is a folder called ``attachments``. Ensure your web server software can write to this folder - something like this should do the trick::
@ -60,19 +60,19 @@ Adding To Your Django Project
(substitute www-data for the user / group that your web server runs as, eg 'apache' or 'httpd') (substitute www-data for the user / group that your web server runs as, eg 'apache' or 'httpd')
If all else fails ensure all users can write to it: If all else fails ensure all users can write to it::
``chmod 777 attachments/`` chmod 777 attachments/
This is NOT recommended, especially if you're on a shared server. This is NOT recommended, especially if you're on a shared server.
6. Ensure that your ``attachments`` folder has directory listings turned off, to ensure users don't download files that they are not specifically linked to from their tickets. 6. Ensure that your ``attachments`` folder has directory listings turned off, to ensure users don't download files that they are not specifically linked to from their tickets.
If you are using Apache, put a ``.htaccess`` file in the ``attachments`` folder with the following content: If you are using Apache, put a ``.htaccess`` file in the ``attachments`` folder with the following content::
``Options -Indexes`` Options -Indexes
You will also have to make sure that ``.htaccess`` files aren't being ignored. You will also have to make sure that ``.htaccess`` files aren't being ignored.
Ideally, accessing http://MEDIA_URL/helpdesk/attachments/ will give you a 403 access denied error. Ideally, accessing http://MEDIA_URL/helpdesk/attachments/ will give you a 403 access denied error.

View File

@ -0,0 +1,110 @@
License
=======
django-helpdesk is released under the terms of the BSD license. You must agree to these terms before installing or using django-helpdesk.::
Copyright (c) 2008, Ross Poulton (Trading as Jutda)
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. Neither the name of Ross Poulton, Jutda, nor the names of any
of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
EXCEPTIONS
This software is distributed with some third-party software which is not distributed under the above license. See LICENSE.3RDPARTY for further details.
django-helpdesk includes 3rd party software. The licenses for these
applications are included below.
License for jQuery & jQuery UI
------------------------------
::
Copyright (c) 2007 John Resig, http://jquery.com/
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
License for jQuery UI 'Smoothness' theme
----------------------------------------
::
/*
* jQuery UI screen structure and presentation
* This CSS file was generated by ThemeRoller, a Filament Group Project for jQuery UI
* Author: Scott Jehl, scott@filamentgroup.com, http://www.filamentgroup.com
* Visit ThemeRoller.com
*/
License for akismet.py
----------------------
::
Copyright (c) 2003-2009, Michael Foord
All rights reserved.
E-mail : fuzzyman AT voidspace DOT org DOT uk
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
* Neither the name of Michael Foord nor the name of Voidspace
may be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

View File

@ -1,5 +1,5 @@
django-helpdesk settings Settings
======================== ========
The following settings can be changed in your ``settings.py`` file to help change the way django-helpdesk operates. The following settings can be changed in your ``settings.py`` file to help change the way django-helpdesk operates.

View File

@ -1,9 +1,9 @@
django-helpdesk spam filtering Spam Filtering
============================== ==============
django-helpdesk includes a copy of ``akismet.py`` by Michael Foord, which lets incoming ticket submissions be automatically checked against either the Akismet or TypePad Anti-Spam services. django-helpdesk includes a copy of ``akismet.py`` by `Michael Foord <http://www.voidspace.org.uk/>`_, which lets incoming ticket submissions be automatically checked against either the `Akismet <http://akismet.com/>`_ or `TypePad Anti-Spam <http://antispam.typepad.com/>`_ services.
To enable this functionality, sign up for an API key with one of the following services: To enable this functionality, sign up for an API key with one of these two services.
Akismet Akismet
~~~~~~~ ~~~~~~~
@ -26,6 +26,7 @@ If you have either of these settings enabled, the spam filtering will be done au
Example Example
~~~~~~~ ~~~~~~~
A sample configuration in ``settings.py`` may be: A sample configuration in ``settings.py`` may be::
TYPEPAD_ANTISPAM_API_KEY = 'abc123'
TYPEPAD_ANTISPAM_API_KEY = 'abc123'

View File

@ -7,7 +7,7 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>django-helpdesk Ticket API &mdash; django-helpdesk v0.1 documentation</title> <title>Ticket API &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript"> <script type="text/javascript">
@ -23,7 +23,7 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="prev" title="django-helpdesk custom fields" href="custom_fields.html" /> <link rel="prev" title="Custom Fields" href="custom_fields.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -33,7 +33,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields" <a href="custom_fields.html" title="Custom Fields"
accesskey="P">previous</a> |</li> accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -44,10 +44,10 @@
<div class="bodywrapper"> <div class="bodywrapper">
<div class="body"> <div class="body">
<div class="section" id="django-helpdesk-ticket-api"> <div class="section" id="ticket-api">
<h1>django-helpdesk Ticket API<a class="headerlink" href="#django-helpdesk-ticket-api" title="Permalink to this headline"></a></h1> <h1>Ticket API<a class="headerlink" href="#ticket-api" title="Permalink to this headline"></a></h1>
<p>django-helpdesk includes an API accessible via HTTP POST requests, allowing you to create and alter tickets from 3rd party software and systems.</p> <p>django-helpdesk includes an API accessible via HTTP POST requests, allowing you to create and alter tickets from 3rd party software and systems.</p>
<p>For usage instructions and command syntax, see the file templates/helpdesk/api_help.html, or visit <a class="reference external" href="http://helpdesk/api/help/">http://helpdesk/api/help/</a>.</p> <p>For usage instructions and command syntax, see the file <tt class="docutils literal"><span class="pre">templates/helpdesk/api_help.html</span></tt>, or visit <a class="reference external" href="http://helpdesk/api/help/">http://helpdesk/api/help/</a>.</p>
</div> </div>
@ -58,7 +58,7 @@
<div class="sphinxsidebarwrapper"> <div class="sphinxsidebarwrapper">
<h4>Previous topic</h4> <h4>Previous topic</h4>
<p class="topless"><a href="custom_fields.html" <p class="topless"><a href="custom_fields.html"
title="previous chapter">django-helpdesk custom fields</a></p> title="previous chapter">Custom Fields</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/api.txt" <li><a href="_sources/api.txt"
@ -88,7 +88,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields" <a href="custom_fields.html" title="Custom Fields"
>previous</a> |</li> >previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>

View File

@ -7,7 +7,7 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>django-helpdesk Configuration &mdash; django-helpdesk v0.1 documentation</title> <title>Configuration &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript"> <script type="text/javascript">
@ -23,7 +23,7 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="django-helpdesk settings" href="settings.html" /> <link rel="next" title="Settings" href="settings.html" />
<link rel="prev" title="Installation" href="install.html" /> <link rel="prev" title="Installation" href="install.html" />
</head> </head>
<body> <body>
@ -34,7 +34,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="settings.html" title="django-helpdesk settings" <a href="settings.html" title="Settings"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li class="right" > <li class="right" >
<a href="install.html" title="Installation" <a href="install.html" title="Installation"
@ -48,8 +48,8 @@
<div class="bodywrapper"> <div class="bodywrapper">
<div class="body"> <div class="body">
<div class="section" id="django-helpdesk-configuration"> <div class="section" id="configuration">
<h1>django-helpdesk Configuration<a class="headerlink" href="#django-helpdesk-configuration" title="Permalink to this headline"></a></h1> <h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline"></a></h1>
<p>Before django-helpdesk will be much use, you need to do some basic configuration. Most of this is done via the Django admin screens.</p> <p>Before django-helpdesk will be much use, you need to do some basic configuration. Most of this is done via the Django admin screens.</p>
<ol class="arabic"> <ol class="arabic">
<li><p class="first">Visit <tt class="docutils literal"><span class="pre">http://yoursite/admin/</span></tt> and add a Helpdesk Queue. If you wish, enter your POP3 or IMAP server details.</p> <li><p class="first">Visit <tt class="docutils literal"><span class="pre">http://yoursite/admin/</span></tt> and add a Helpdesk Queue. If you wish, enter your POP3 or IMAP server details.</p>
@ -98,7 +98,7 @@
title="previous chapter">Installation</a></p> title="previous chapter">Installation</a></p>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="settings.html" <p class="topless"><a href="settings.html"
title="next chapter">django-helpdesk settings</a></p> title="next chapter">Settings</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/configuration.txt" <li><a href="_sources/configuration.txt"
@ -128,7 +128,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="settings.html" title="django-helpdesk settings" <a href="settings.html" title="Settings"
>next</a> |</li> >next</a> |</li>
<li class="right" > <li class="right" >
<a href="install.html" title="Installation" <a href="install.html" title="Installation"

View File

@ -7,7 +7,7 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>django-helpdesk custom fields &mdash; django-helpdesk v0.1 documentation</title> <title>Custom Fields &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript"> <script type="text/javascript">
@ -23,8 +23,8 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="django-helpdesk Ticket API" href="api.html" /> <link rel="next" title="Ticket API" href="api.html" />
<link rel="prev" title="django-helpdesk spam filtering" href="spam.html" /> <link rel="prev" title="Spam Filtering" href="spam.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="api.html" title="django-helpdesk Ticket API" <a href="api.html" title="Ticket API"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li class="right" > <li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering" <a href="spam.html" title="Spam Filtering"
accesskey="P">previous</a> |</li> accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -48,8 +48,8 @@
<div class="bodywrapper"> <div class="bodywrapper">
<div class="body"> <div class="body">
<div class="section" id="django-helpdesk-custom-fields"> <div class="section" id="custom-fields">
<h1>django-helpdesk custom fields<a class="headerlink" href="#django-helpdesk-custom-fields" title="Permalink to this headline"></a></h1> <h1>Custom Fields<a class="headerlink" href="#custom-fields" title="Permalink to this headline"></a></h1>
<p>As of February 2011, django-helpdesk supports custom fields on the <tt class="docutils literal"><span class="pre">Ticket</span></tt> model. These fields are created by using the Django administration tool, and are shown on both the public and staff submission forms.</p> <p>As of February 2011, django-helpdesk supports custom fields on the <tt class="docutils literal"><span class="pre">Ticket</span></tt> model. These fields are created by using the Django administration tool, and are shown on both the public and staff submission forms.</p>
<p>You can use most Django field types including text, integer, boolean, and list.</p> <p>You can use most Django field types including text, integer, boolean, and list.</p>
<p>The demo at <a class="reference external" href="http://demo.jutdahelpdesk.com">http://demo.jutdahelpdesk.com</a> contains an example of each type of custom field, including a mix of mandatory and optional fields.</p> <p>The demo at <a class="reference external" href="http://demo.jutdahelpdesk.com">http://demo.jutdahelpdesk.com</a> contains an example of each type of custom field, including a mix of mandatory and optional fields.</p>
@ -64,10 +64,10 @@
<div class="sphinxsidebarwrapper"> <div class="sphinxsidebarwrapper">
<h4>Previous topic</h4> <h4>Previous topic</h4>
<p class="topless"><a href="spam.html" <p class="topless"><a href="spam.html"
title="previous chapter">django-helpdesk spam filtering</a></p> title="previous chapter">Spam Filtering</a></p>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="api.html" <p class="topless"><a href="api.html"
title="next chapter">django-helpdesk Ticket API</a></p> title="next chapter">Ticket API</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/custom_fields.txt" <li><a href="_sources/custom_fields.txt"
@ -97,10 +97,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="api.html" title="django-helpdesk Ticket API" <a href="api.html" title="Ticket API"
>next</a> |</li> >next</a> |</li>
<li class="right" > <li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering" <a href="spam.html" title="Spam Filtering"
>previous</a> |</li> >previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>

View File

@ -23,7 +23,7 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="#" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="#" />
<link rel="next" title="Installation" href="install.html" /> <link rel="next" title="License" href="license.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -33,7 +33,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="install.html" title="Installation" <a href="license.html" title="License"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -88,7 +88,7 @@
</div> </div>
<div class="section" id="licensing"> <div class="section" id="licensing">
<h2>Licensing<a class="headerlink" href="#licensing" title="Permalink to this headline"></a></h2> <h2>Licensing<a class="headerlink" href="#licensing" title="Permalink to this headline"></a></h2>
<p>django-helpdesk is released under the BSD license, however it packages 3rd party applications which may be using a different license. See the files LICENSE and LICENSE.3RDPARTY for more details.</p> <p>django-helpdesk is released under the BSD license, however it packages 3rd party applications which may be using a different license. More details can be found in the <tt class="xref doc docutils literal"><span class="pre">license</span> <span class="pre">documentation</span></tt>.</p>
</div> </div>
<div class="section" id="dependencies"> <div class="section" id="dependencies">
<h2>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline"></a></h2> <h2>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline"></a></h2>
@ -102,24 +102,30 @@
<h2>Contents:<a class="headerlink" href="#contents" title="Permalink to this headline"></a></h2> <h2>Contents:<a class="headerlink" href="#contents" title="Permalink to this headline"></a></h2>
<div class="toctree-wrapper compound"> <div class="toctree-wrapper compound">
<ul> <ul>
<li class="toctree-l1"><a class="reference internal" href="license.html">License</a><ul>
<li class="toctree-l2"><a class="reference internal" href="license.html#license-for-jquery-jquery-ui">License for jQuery &amp; jQuery UI</a></li>
<li class="toctree-l2"><a class="reference internal" href="license.html#license-for-jquery-ui-smoothness-theme">License for jQuery UI &#8216;Smoothness&#8217; theme</a></li>
<li class="toctree-l2"><a class="reference internal" href="license.html#license-for-akismet-py">License for akismet.py</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installation</a><ul> <li class="toctree-l1"><a class="reference internal" href="install.html">Installation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="install.html#getting-the-code">Getting The Code</a></li> <li class="toctree-l2"><a class="reference internal" href="install.html#getting-the-code">Getting The Code</a></li>
<li class="toctree-l2"><a class="reference internal" href="install.html#adding-to-your-django-project">Adding To Your Django Project</a></li> <li class="toctree-l2"><a class="reference internal" href="install.html#adding-to-your-django-project">Adding To Your Django Project</a></li>
</ul> </ul>
</li> </li>
<li class="toctree-l1"><a class="reference internal" href="configuration.html">django-helpdesk Configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="configuration.html">Configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="settings.html">django-helpdesk settings</a><ul> <li class="toctree-l1"><a class="reference internal" href="settings.html">Settings</a><ul>
<li class="toctree-l2"><a class="reference internal" href="settings.html#helpdesk-default-settings">HELPDESK_DEFAULT_SETTINGS</a></li> <li class="toctree-l2"><a class="reference internal" href="settings.html#helpdesk-default-settings">HELPDESK_DEFAULT_SETTINGS</a></li>
</ul> </ul>
</li> </li>
<li class="toctree-l1"><a class="reference internal" href="spam.html">django-helpdesk spam filtering</a><ul> <li class="toctree-l1"><a class="reference internal" href="spam.html">Spam Filtering</a><ul>
<li class="toctree-l2"><a class="reference internal" href="spam.html#akismet">Akismet</a></li> <li class="toctree-l2"><a class="reference internal" href="spam.html#id1">Akismet</a></li>
<li class="toctree-l2"><a class="reference internal" href="spam.html#typepad-antispam">TypePad AntiSpam</a></li> <li class="toctree-l2"><a class="reference internal" href="spam.html#typepad-antispam">TypePad AntiSpam</a></li>
<li class="toctree-l2"><a class="reference internal" href="spam.html#example">Example</a></li> <li class="toctree-l2"><a class="reference internal" href="spam.html#example">Example</a></li>
</ul> </ul>
</li> </li>
<li class="toctree-l1"><a class="reference internal" href="custom_fields.html">django-helpdesk custom fields</a></li> <li class="toctree-l1"><a class="reference internal" href="custom_fields.html">Custom Fields</a></li>
<li class="toctree-l1"><a class="reference internal" href="api.html">django-helpdesk Ticket API</a></li> <li class="toctree-l1"><a class="reference internal" href="api.html">Ticket API</a></li>
</ul> </ul>
</div> </div>
</div> </div>
@ -151,8 +157,8 @@
</ul> </ul>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="install.html" <p class="topless"><a href="license.html"
title="next chapter">Installation</a></p> title="next chapter">License</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/index.txt" <li><a href="_sources/index.txt"
@ -182,7 +188,7 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="install.html" title="Installation" <a href="license.html" title="License"
>next</a> |</li> >next</a> |</li>
<li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>

View File

@ -23,8 +23,8 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="django-helpdesk Configuration" href="configuration.html" /> <link rel="next" title="Configuration" href="configuration.html" />
<link rel="prev" title="Welcome to django-helpdesks documentation!" href="index.html" /> <link rel="prev" title="License" href="license.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration" <a href="configuration.html" title="Configuration"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li class="right" > <li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!" <a href="license.html" title="License"
accesskey="P">previous</a> |</li> accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -59,7 +59,7 @@
</div> </div>
<div class="section" id="git-checkout-cutting-edge"> <div class="section" id="git-checkout-cutting-edge">
<h3>GIT Checkout (Cutting Edge)<a class="headerlink" href="#git-checkout-cutting-edge" title="Permalink to this headline"></a></h3> <h3>GIT Checkout (Cutting Edge)<a class="headerlink" href="#git-checkout-cutting-edge" title="Permalink to this headline"></a></h3>
<p><tt class="docutils literal"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">git://github.com/rossp/django-helpdesk.git</span></tt></p> <p>If you&#8217;re planning on editing the code or just want to get whatever is the latest and greatest, you can clone the official Git repository with <tt class="docutils literal"><span class="pre">git</span> <span class="pre">clone</span> <span class="pre">git://github.com/rossp/django-helpdesk.git</span></tt></p>
<p>Copy the <tt class="docutils literal"><span class="pre">helpdesk</span></tt> folder into your <tt class="docutils literal"><span class="pre">PYTHONPATH</span></tt>.</p> <p>Copy the <tt class="docutils literal"><span class="pre">helpdesk</span></tt> folder into your <tt class="docutils literal"><span class="pre">PYTHONPATH</span></tt>.</p>
</div> </div>
<div class="section" id="i-just-want-a-tar-gz"> <div class="section" id="i-just-want-a-tar-gz">
@ -94,28 +94,29 @@
</div> </div>
</li> </li>
<li><p class="first">Inside your <tt class="docutils literal"><span class="pre">MEDIA_ROOT</span></tt> folder, create a new folder called <tt class="docutils literal"><span class="pre">helpdesk</span></tt> and copy the contents of <tt class="docutils literal"><span class="pre">helpdesk/htdocs</span></tt> into it. Alternatively, create a symlink:</p> <li><p class="first">Inside your <tt class="docutils literal"><span class="pre">MEDIA_ROOT</span></tt> folder, create a new folder called <tt class="docutils literal"><span class="pre">helpdesk</span></tt> and copy the contents of <tt class="docutils literal"><span class="pre">helpdesk/htdocs</span></tt> into it. Alternatively, create a symlink:</p>
<p><tt class="docutils literal"><span class="pre">ln</span> <span class="pre">-s</span> <span class="pre">/path/to/helpdesk/htdocs</span> <span class="pre">/path/to/media/helpdesk</span></tt></p> <div class="highlight-python"><div class="highlight"><pre><span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">helpdesk</span><span class="o">/</span><span class="n">htdocs</span> <span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">media</span><span class="o">/</span><span class="n">helpdesk</span>
</pre></div>
</div>
</li> </li>
<li><p class="first">Inside your <tt class="docutils literal"><span class="pre">MEDIA_ROOT</span></tt> folder, inside the <tt class="docutils literal"><span class="pre">helpdesk</span></tt> folder, is a folder called <tt class="docutils literal"><span class="pre">attachments</span></tt>. Ensure your web server software can write to this folder - something like this should do the trick:</p> <li><p class="first">Inside your <tt class="docutils literal"><span class="pre">MEDIA_ROOT</span></tt> folder, inside the <tt class="docutils literal"><span class="pre">helpdesk</span></tt> folder, is a folder called <tt class="docutils literal"><span class="pre">attachments</span></tt>. Ensure your web server software can write to this folder - something like this should do the trick:</p>
<div class="highlight-python"><pre> chown www-data:www-data attachments/ <div class="highlight-python"><pre>chown www-data:www-data attachments/
chmod 700 attachments chmod 700 attachments</pre>
(substitute www-data for the user / group that your web server runs as, eg 'apache' or 'httpd')
If all else fails ensure all users can write to it:
``chmod 777 attachments/``
This is NOT recommended, especially if you're on a shared server.</pre>
</div> </div>
<p>(substitute www-data for the user / group that your web server runs as, eg &#8216;apache&#8217; or &#8216;httpd&#8217;)</p>
<p>If all else fails ensure all users can write to it:</p>
<div class="highlight-python"><pre>chmod 777 attachments/</pre>
</div>
<p>This is NOT recommended, especially if you&#8217;re on a shared server.</p>
</li> </li>
<li><p class="first">Ensure that your <tt class="docutils literal"><span class="pre">attachments</span></tt> folder has directory listings turned off, to ensure users don&#8217;t download files that they are not specifically linked to from their tickets.</p> <li><p class="first">Ensure that your <tt class="docutils literal"><span class="pre">attachments</span></tt> folder has directory listings turned off, to ensure users don&#8217;t download files that they are not specifically linked to from their tickets.</p>
<p>If you are using Apache, put a <tt class="docutils literal"><span class="pre">.htaccess</span></tt> file in the <tt class="docutils literal"><span class="pre">attachments</span></tt> folder with the following content:</p> <p>If you are using Apache, put a <tt class="docutils literal"><span class="pre">.htaccess</span></tt> file in the <tt class="docutils literal"><span class="pre">attachments</span></tt> folder with the following content:</p>
<p><tt class="docutils literal"><span class="pre">Options</span> <span class="pre">-Indexes</span></tt></p> <div class="highlight-python"><div class="highlight"><pre><span class="n">Options</span> <span class="o">-</span><span class="n">Indexes</span>
<p>You will also have to make sure that <tt class="docutils literal"><span class="pre">.htaccess</span></tt> files aren&#8217;t being ignored.</p> </pre></div>
<p>Ideally, accessing <a class="reference external" href="http://MEDIA_URL/helpdesk/attachments/">http://MEDIA_URL/helpdesk/attachments/</a> will give you a 403 access denied error.</p> </div>
</li> </li>
</ol> </ol>
<p>You will also have to make sure that <tt class="docutils literal"><span class="pre">.htaccess</span></tt> files aren&#8217;t being ignored.</p>
<p>Ideally, accessing <a class="reference external" href="http://MEDIA_URL/helpdesk/attachments/">http://MEDIA_URL/helpdesk/attachments/</a> will give you a 403 access denied error.</p>
</div> </div>
</div> </div>
@ -140,11 +141,11 @@ This is NOT recommended, especially if you're on a shared server.</pre>
</ul> </ul>
<h4>Previous topic</h4> <h4>Previous topic</h4>
<p class="topless"><a href="index.html" <p class="topless"><a href="license.html"
title="previous chapter">Welcome to django-helpdesk&#8217;s documentation!</a></p> title="previous chapter">License</a></p>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="configuration.html" <p class="topless"><a href="configuration.html"
title="next chapter">django-helpdesk Configuration</a></p> title="next chapter">Configuration</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/install.txt" <li><a href="_sources/install.txt"
@ -174,10 +175,10 @@ This is NOT recommended, especially if you're on a shared server.</pre>
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration" <a href="configuration.html" title="Configuration"
>next</a> |</li> >next</a> |</li>
<li class="right" > <li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!" <a href="license.html" title="License"
>previous</a> |</li> >previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>

233
docs/html/license.html Normal file
View File

@ -0,0 +1,233 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>License &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '0.1',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="Installation" href="install.html" />
<link rel="prev" title="Welcome to django-helpdesks documentation!" href="index.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="install.html" title="Installation"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!"
accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="license">
<h1>License<a class="headerlink" href="#license" title="Permalink to this headline"></a></h1>
<p>django-helpdesk is released under the terms of the BSD license. You must agree to these terms before installing or using django-helpdesk.:</p>
<div class="highlight-python"><pre>Copyright (c) 2008, Ross Poulton (Trading as Jutda)
All rights reserved.
Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. Neither the name of Ross Poulton, Jutda, nor the names of any
of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
EXCEPTIONS
This software is distributed with some third-party software which is not distributed under the above license. See LICENSE.3RDPARTY for further details.</pre>
</div>
<p>django-helpdesk includes 3rd party software. The licenses for these
applications are included below.</p>
<div class="section" id="license-for-jquery-jquery-ui">
<h2>License for jQuery &amp; jQuery UI<a class="headerlink" href="#license-for-jquery-jquery-ui" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>::</dt>
<dd><p class="first">Copyright (c) 2007 John Resig, <a class="reference external" href="http://jquery.com/">http://jquery.com/</a></p>
<p>Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
&#8220;Software&#8221;), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:</p>
<p>The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.</p>
<p class="last">THE SOFTWARE IS PROVIDED &#8220;AS IS&#8221;, WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>
</dd>
</dl>
</div>
<div class="section" id="license-for-jquery-ui-smoothness-theme">
<h2>License for jQuery UI &#8216;Smoothness&#8217; theme<a class="headerlink" href="#license-for-jquery-ui-smoothness-theme" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>::</dt>
<dd><dl class="first docutils">
<dt>/*</dt>
<dd><ul class="first last simple">
<li>jQuery UI screen structure and presentation</li>
<li>This CSS file was generated by ThemeRoller, a Filament Group Project for jQuery UI</li>
<li>Author: Scott Jehl, <a class="reference external" href="mailto:scott&#37;&#52;&#48;filamentgroup&#46;com">scott<span>&#64;</span>filamentgroup<span>&#46;</span>com</a>, <a class="reference external" href="http://www.filamentgroup.com">http://www.filamentgroup.com</a></li>
<li>Visit ThemeRoller.com</li>
</ul>
</dd>
</dl>
<p class="last"><a href="#id1"><span class="problematic" id="id2">*</span></a>/</p>
</dd>
</dl>
</div>
<div class="section" id="license-for-akismet-py">
<h2>License for akismet.py<a class="headerlink" href="#license-for-akismet-py" title="Permalink to this headline"></a></h2>
<dl class="docutils">
<dt>::</dt>
<dd><p class="first">Copyright (c) 2003-2009, Michael Foord
All rights reserved.
E-mail : fuzzyman AT voidspace DOT org DOT uk</p>
<p>Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:</p>
<blockquote>
<div><ul class="simple">
<li>Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.</li>
<li>Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.</li>
<li>Neither the name of Michael Foord nor the name of Voidspace
may be used to endorse or promote products derived from this
software without specific prior written permission.</li>
</ul>
</div></blockquote>
<p class="last">THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
&#8220;AS IS&#8221; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</p>
</dd>
</dl>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">License</a><ul>
<li><a class="reference internal" href="#license-for-jquery-jquery-ui">License for jQuery &amp; jQuery UI</a></li>
<li><a class="reference internal" href="#license-for-jquery-ui-smoothness-theme">License for jQuery UI &#8216;Smoothness&#8217; theme</a></li>
<li><a class="reference internal" href="#license-for-akismet-py">License for akismet.py</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Welcome to django-helpdesk&#8217;s documentation!</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="install.html"
title="next chapter">Installation</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/license.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" size="18" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="install.html" title="Installation"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
</div>
<div class="footer">
&copy; Copyright 2011, Ross Poulton + Contributors.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
</html>

File diff suppressed because one or more lines are too long

View File

@ -7,7 +7,7 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>django-helpdesk settings &mdash; django-helpdesk v0.1 documentation</title> <title>Settings &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript"> <script type="text/javascript">
@ -23,8 +23,8 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="django-helpdesk spam filtering" href="spam.html" /> <link rel="next" title="Spam Filtering" href="spam.html" />
<link rel="prev" title="django-helpdesk Configuration" href="configuration.html" /> <link rel="prev" title="Configuration" href="configuration.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering" <a href="spam.html" title="Spam Filtering"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li class="right" > <li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration" <a href="configuration.html" title="Configuration"
accesskey="P">previous</a> |</li> accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -48,8 +48,8 @@
<div class="bodywrapper"> <div class="bodywrapper">
<div class="body"> <div class="body">
<div class="section" id="django-helpdesk-settings"> <div class="section" id="settings">
<h1>django-helpdesk settings<a class="headerlink" href="#django-helpdesk-settings" title="Permalink to this headline"></a></h1> <h1>Settings<a class="headerlink" href="#settings" title="Permalink to this headline"></a></h1>
<p>The following settings can be changed in your <tt class="docutils literal"><span class="pre">settings.py</span></tt> file to help change the way django-helpdesk operates.</p> <p>The following settings can be changed in your <tt class="docutils literal"><span class="pre">settings.py</span></tt> file to help change the way django-helpdesk operates.</p>
<div class="section" id="helpdesk-default-settings"> <div class="section" id="helpdesk-default-settings">
<h2>HELPDESK_DEFAULT_SETTINGS<a class="headerlink" href="#helpdesk-default-settings" title="Permalink to this headline"></a></h2> <h2>HELPDESK_DEFAULT_SETTINGS<a class="headerlink" href="#helpdesk-default-settings" title="Permalink to this headline"></a></h2>
@ -76,7 +76,7 @@
<div class="sphinxsidebarwrapper"> <div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3> <h3><a href="index.html">Table Of Contents</a></h3>
<ul> <ul>
<li><a class="reference internal" href="#">django-helpdesk settings</a><ul> <li><a class="reference internal" href="#">Settings</a><ul>
<li><a class="reference internal" href="#helpdesk-default-settings">HELPDESK_DEFAULT_SETTINGS</a></li> <li><a class="reference internal" href="#helpdesk-default-settings">HELPDESK_DEFAULT_SETTINGS</a></li>
</ul> </ul>
</li> </li>
@ -84,10 +84,10 @@
<h4>Previous topic</h4> <h4>Previous topic</h4>
<p class="topless"><a href="configuration.html" <p class="topless"><a href="configuration.html"
title="previous chapter">django-helpdesk Configuration</a></p> title="previous chapter">Configuration</a></p>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="spam.html" <p class="topless"><a href="spam.html"
title="next chapter">django-helpdesk spam filtering</a></p> title="next chapter">Spam Filtering</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/settings.txt" <li><a href="_sources/settings.txt"
@ -117,10 +117,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering" <a href="spam.html" title="Spam Filtering"
>next</a> |</li> >next</a> |</li>
<li class="right" > <li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration" <a href="configuration.html" title="Configuration"
>previous</a> |</li> >previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>

View File

@ -7,7 +7,7 @@
<head> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>django-helpdesk spam filtering &mdash; django-helpdesk v0.1 documentation</title> <title>Spam Filtering &mdash; django-helpdesk v0.1 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" /> <link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript"> <script type="text/javascript">
@ -23,8 +23,8 @@
<script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" /> <link rel="top" title="django-helpdesk v0.1 documentation" href="index.html" />
<link rel="next" title="django-helpdesk custom fields" href="custom_fields.html" /> <link rel="next" title="Custom Fields" href="custom_fields.html" />
<link rel="prev" title="django-helpdesk settings" href="settings.html" /> <link rel="prev" title="Settings" href="settings.html" />
</head> </head>
<body> <body>
<div class="related"> <div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
accesskey="I">index</a></li> accesskey="I">index</a></li>
<li class="right" > <li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields" <a href="custom_fields.html" title="Custom Fields"
accesskey="N">next</a> |</li> accesskey="N">next</a> |</li>
<li class="right" > <li class="right" >
<a href="settings.html" title="django-helpdesk settings" <a href="settings.html" title="Settings"
accesskey="P">previous</a> |</li> accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>
@ -48,12 +48,12 @@
<div class="bodywrapper"> <div class="bodywrapper">
<div class="body"> <div class="body">
<div class="section" id="django-helpdesk-spam-filtering"> <div class="section" id="spam-filtering">
<h1>django-helpdesk spam filtering<a class="headerlink" href="#django-helpdesk-spam-filtering" title="Permalink to this headline"></a></h1> <h1>Spam Filtering<a class="headerlink" href="#spam-filtering" title="Permalink to this headline"></a></h1>
<p>django-helpdesk includes a copy of <tt class="docutils literal"><span class="pre">akismet.py</span></tt> by Michael Foord, which lets incoming ticket submissions be automatically checked against either the Akismet or TypePad Anti-Spam services.</p> <p>django-helpdesk includes a copy of <tt class="docutils literal"><span class="pre">akismet.py</span></tt> by <a class="reference external" href="http://www.voidspace.org.uk/">Michael Foord</a>, which lets incoming ticket submissions be automatically checked against either the <a class="reference external" href="http://akismet.com/">Akismet</a> or <a class="reference external" href="http://antispam.typepad.com/">TypePad Anti-Spam</a> services.</p>
<p>To enable this functionality, sign up for an API key with one of the following services:</p> <p>To enable this functionality, sign up for an API key with one of these two services.</p>
<div class="section" id="akismet"> <div class="section" id="id1">
<h2>Akismet<a class="headerlink" href="#akismet" title="Permalink to this headline"></a></h2> <h2>Akismet<a class="headerlink" href="#id1" title="Permalink to this headline"></a></h2>
<ul class="simple"> <ul class="simple">
<li>Sign up at <a class="reference external" href="http://akismet.com/">http://akismet.com/</a></li> <li>Sign up at <a class="reference external" href="http://akismet.com/">http://akismet.com/</a></li>
<li>Save your API key in <tt class="docutils literal"><span class="pre">settings.py</span></tt> as <tt class="docutils literal"><span class="pre">AKISMET_API_KEY</span></tt></li> <li>Save your API key in <tt class="docutils literal"><span class="pre">settings.py</span></tt> as <tt class="docutils literal"><span class="pre">AKISMET_API_KEY</span></tt></li>
@ -72,7 +72,9 @@
<div class="section" id="example"> <div class="section" id="example">
<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline"></a></h2> <h2>Example<a class="headerlink" href="#example" title="Permalink to this headline"></a></h2>
<p>A sample configuration in <tt class="docutils literal"><span class="pre">settings.py</span></tt> may be:</p> <p>A sample configuration in <tt class="docutils literal"><span class="pre">settings.py</span></tt> may be:</p>
<p>TYPEPAD_ANTISPAM_API_KEY = &#8216;abc123&#8217;</p> <div class="highlight-python"><div class="highlight"><pre><span class="n">TYPEPAD_ANTISPAM_API_KEY</span> <span class="o">=</span> <span class="s">&#39;abc123&#39;</span>
</pre></div>
</div>
</div> </div>
</div> </div>
@ -84,8 +86,8 @@
<div class="sphinxsidebarwrapper"> <div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3> <h3><a href="index.html">Table Of Contents</a></h3>
<ul> <ul>
<li><a class="reference internal" href="#">django-helpdesk spam filtering</a><ul> <li><a class="reference internal" href="#">Spam Filtering</a><ul>
<li><a class="reference internal" href="#akismet">Akismet</a></li> <li><a class="reference internal" href="#id1">Akismet</a></li>
<li><a class="reference internal" href="#typepad-antispam">TypePad AntiSpam</a></li> <li><a class="reference internal" href="#typepad-antispam">TypePad AntiSpam</a></li>
<li><a class="reference internal" href="#example">Example</a></li> <li><a class="reference internal" href="#example">Example</a></li>
</ul> </ul>
@ -94,10 +96,10 @@
<h4>Previous topic</h4> <h4>Previous topic</h4>
<p class="topless"><a href="settings.html" <p class="topless"><a href="settings.html"
title="previous chapter">django-helpdesk settings</a></p> title="previous chapter">Settings</a></p>
<h4>Next topic</h4> <h4>Next topic</h4>
<p class="topless"><a href="custom_fields.html" <p class="topless"><a href="custom_fields.html"
title="next chapter">django-helpdesk custom fields</a></p> title="next chapter">Custom Fields</a></p>
<h3>This Page</h3> <h3>This Page</h3>
<ul class="this-page-menu"> <ul class="this-page-menu">
<li><a href="_sources/spam.txt" <li><a href="_sources/spam.txt"
@ -127,10 +129,10 @@
<a href="genindex.html" title="General Index" <a href="genindex.html" title="General Index"
>index</a></li> >index</a></li>
<li class="right" > <li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields" <a href="custom_fields.html" title="Custom Fields"
>next</a> |</li> >next</a> |</li>
<li class="right" > <li class="right" >
<a href="settings.html" title="django-helpdesk settings" <a href="settings.html" title="Settings"
>previous</a> |</li> >previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li> <li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul> </ul>