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

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.

View File

@ -47,7 +47,7 @@ If a user is a staff member, they get general helpdesk access, including:
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
------------
@ -63,6 +63,7 @@ Contents:
:maxdepth: 2
:glob:
license
install
configuration
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 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``.
@ -49,30 +49,30 @@ Adding To Your Django Project
./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::
chown www-data:www-data attachments/
chmod 700 attachments
chown www-data:www-data attachments/
chmod 700 attachments
(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.
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.

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
~~~~~~~
@ -26,6 +26,7 @@ If you have either of these settings enabled, the spam filtering will be done au
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>
<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/pygments.css" type="text/css" />
<script type="text/javascript">
@ -23,7 +23,7 @@
<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="prev" title="django-helpdesk custom fields" href="custom_fields.html" />
<link rel="prev" title="Custom Fields" href="custom_fields.html" />
</head>
<body>
<div class="related">
@ -33,7 +33,7 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<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>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -44,10 +44,10 @@
<div class="bodywrapper">
<div class="body">
<div class="section" id="django-helpdesk-ticket-api">
<h1>django-helpdesk Ticket API<a class="headerlink" href="#django-helpdesk-ticket-api" title="Permalink to this headline"></a></h1>
<div class="section" id="ticket-api">
<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>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>
@ -58,7 +58,7 @@
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<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>
<ul class="this-page-menu">
<li><a href="_sources/api.txt"
@ -88,7 +88,7 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields"
<a href="custom_fields.html" title="Custom Fields"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>

View File

@ -7,7 +7,7 @@
<head>
<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/pygments.css" type="text/css" />
<script type="text/javascript">
@ -23,7 +23,7 @@
<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="django-helpdesk settings" href="settings.html" />
<link rel="next" title="Settings" href="settings.html" />
<link rel="prev" title="Installation" href="install.html" />
</head>
<body>
@ -34,7 +34,7 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="settings.html" title="django-helpdesk settings"
<a href="settings.html" title="Settings"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="install.html" title="Installation"
@ -48,8 +48,8 @@
<div class="bodywrapper">
<div class="body">
<div class="section" id="django-helpdesk-configuration">
<h1>django-helpdesk Configuration<a class="headerlink" href="#django-helpdesk-configuration" title="Permalink to this headline"></a></h1>
<div class="section" id="configuration">
<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>
<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>
@ -98,7 +98,7 @@
title="previous chapter">Installation</a></p>
<h4>Next topic</h4>
<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>
<ul class="this-page-menu">
<li><a href="_sources/configuration.txt"
@ -128,7 +128,7 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="settings.html" title="django-helpdesk settings"
<a href="settings.html" title="Settings"
>next</a> |</li>
<li class="right" >
<a href="install.html" title="Installation"

View File

@ -7,7 +7,7 @@
<head>
<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/pygments.css" type="text/css" />
<script type="text/javascript">
@ -23,8 +23,8 @@
<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="django-helpdesk Ticket API" href="api.html" />
<link rel="prev" title="django-helpdesk spam filtering" href="spam.html" />
<link rel="next" title="Ticket API" href="api.html" />
<link rel="prev" title="Spam Filtering" href="spam.html" />
</head>
<body>
<div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="api.html" title="django-helpdesk Ticket API"
<a href="api.html" title="Ticket API"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering"
<a href="spam.html" title="Spam Filtering"
accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -48,8 +48,8 @@
<div class="bodywrapper">
<div class="body">
<div class="section" id="django-helpdesk-custom-fields">
<h1>django-helpdesk custom fields<a class="headerlink" href="#django-helpdesk-custom-fields" title="Permalink to this headline"></a></h1>
<div class="section" id="custom-fields">
<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>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>
@ -64,10 +64,10 @@
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<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>
<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>
<ul class="this-page-menu">
<li><a href="_sources/custom_fields.txt"
@ -97,10 +97,10 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="api.html" title="django-helpdesk Ticket API"
<a href="api.html" title="Ticket API"
>next</a> |</li>
<li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering"
<a href="spam.html" title="Spam Filtering"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>

View File

@ -23,7 +23,7 @@
<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="#" />
<link rel="next" title="Installation" href="install.html" />
<link rel="next" title="License" href="license.html" />
</head>
<body>
<div class="related">
@ -33,7 +33,7 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="install.html" title="Installation"
<a href="license.html" title="License"
accesskey="N">next</a> |</li>
<li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -88,7 +88,7 @@
</div>
<div class="section" id="licensing">
<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 class="section" id="dependencies">
<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>
<div class="toctree-wrapper compound">
<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-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>
</ul>
</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="settings.html">django-helpdesk settings</a><ul>
<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">Settings</a><ul>
<li class="toctree-l2"><a class="reference internal" href="settings.html#helpdesk-default-settings">HELPDESK_DEFAULT_SETTINGS</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="spam.html">django-helpdesk spam filtering</a><ul>
<li class="toctree-l2"><a class="reference internal" href="spam.html#akismet">Akismet</a></li>
<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#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#example">Example</a></li>
</ul>
</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="api.html">django-helpdesk Ticket API</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">Ticket API</a></li>
</ul>
</div>
</div>
@ -151,8 +157,8 @@
</ul>
<h4>Next topic</h4>
<p class="topless"><a href="install.html"
title="next chapter">Installation</a></p>
<p class="topless"><a href="license.html"
title="next chapter">License</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/index.txt"
@ -182,7 +188,7 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="install.html" title="Installation"
<a href="license.html" title="License"
>next</a> |</li>
<li><a href="#">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>

View File

@ -23,8 +23,8 @@
<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="django-helpdesk Configuration" href="configuration.html" />
<link rel="prev" title="Welcome to django-helpdesks documentation!" href="index.html" />
<link rel="next" title="Configuration" href="configuration.html" />
<link rel="prev" title="License" href="license.html" />
</head>
<body>
<div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration"
<a href="configuration.html" title="Configuration"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!"
<a href="license.html" title="License"
accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -59,7 +59,7 @@
</div>
<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>
<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>
</div>
<div class="section" id="i-just-want-a-tar-gz">
@ -94,28 +94,29 @@
</div>
</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>
<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><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/
chmod 700 attachments
(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 class="highlight-python"><pre>chown www-data:www-data attachments/
chmod 700 attachments</pre>
</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><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><tt class="docutils literal"><span class="pre">Options</span> <span class="pre">-Indexes</span></tt></p>
<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 class="highlight-python"><div class="highlight"><pre><span class="n">Options</span> <span class="o">-</span><span class="n">Indexes</span>
</pre></div>
</div>
</li>
</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>
@ -140,11 +141,11 @@ This is NOT recommended, especially if you're on a shared server.</pre>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="index.html"
title="previous chapter">Welcome to django-helpdesk&#8217;s documentation!</a></p>
<p class="topless"><a href="license.html"
title="previous chapter">License</a></p>
<h4>Next topic</h4>
<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>
<ul class="this-page-menu">
<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"
>index</a></li>
<li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration"
<a href="configuration.html" title="Configuration"
>next</a> |</li>
<li class="right" >
<a href="index.html" title="Welcome to django-helpdesks documentation!"
<a href="license.html" title="License"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</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>
<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/pygments.css" type="text/css" />
<script type="text/javascript">
@ -23,8 +23,8 @@
<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="django-helpdesk spam filtering" href="spam.html" />
<link rel="prev" title="django-helpdesk Configuration" href="configuration.html" />
<link rel="next" title="Spam Filtering" href="spam.html" />
<link rel="prev" title="Configuration" href="configuration.html" />
</head>
<body>
<div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering"
<a href="spam.html" title="Spam Filtering"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration"
<a href="configuration.html" title="Configuration"
accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -48,8 +48,8 @@
<div class="bodywrapper">
<div class="body">
<div class="section" id="django-helpdesk-settings">
<h1>django-helpdesk settings<a class="headerlink" href="#django-helpdesk-settings" title="Permalink to this headline"></a></h1>
<div class="section" id="settings">
<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>
<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>
@ -76,7 +76,7 @@
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<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>
</ul>
</li>
@ -84,10 +84,10 @@
<h4>Previous topic</h4>
<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>
<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>
<ul class="this-page-menu">
<li><a href="_sources/settings.txt"
@ -117,10 +117,10 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="spam.html" title="django-helpdesk spam filtering"
<a href="spam.html" title="Spam Filtering"
>next</a> |</li>
<li class="right" >
<a href="configuration.html" title="django-helpdesk Configuration"
<a href="configuration.html" title="Configuration"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>

View File

@ -7,7 +7,7 @@
<head>
<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/pygments.css" type="text/css" />
<script type="text/javascript">
@ -23,8 +23,8 @@
<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="django-helpdesk custom fields" href="custom_fields.html" />
<link rel="prev" title="django-helpdesk settings" href="settings.html" />
<link rel="next" title="Custom Fields" href="custom_fields.html" />
<link rel="prev" title="Settings" href="settings.html" />
</head>
<body>
<div class="related">
@ -34,10 +34,10 @@
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<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>
<li class="right" >
<a href="settings.html" title="django-helpdesk settings"
<a href="settings.html" title="Settings"
accesskey="P">previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>
@ -48,12 +48,12 @@
<div class="bodywrapper">
<div class="body">
<div class="section" id="django-helpdesk-spam-filtering">
<h1>django-helpdesk spam filtering<a class="headerlink" href="#django-helpdesk-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>To enable this functionality, sign up for an API key with one of the following services:</p>
<div class="section" id="akismet">
<h2>Akismet<a class="headerlink" href="#akismet" title="Permalink to this headline"></a></h2>
<div class="section" id="spam-filtering">
<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 <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 these two services.</p>
<div class="section" id="id1">
<h2>Akismet<a class="headerlink" href="#id1" title="Permalink to this headline"></a></h2>
<ul class="simple">
<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>
@ -72,7 +72,9 @@
<div class="section" id="example">
<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>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>
@ -84,8 +86,8 @@
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">django-helpdesk spam filtering</a><ul>
<li><a class="reference internal" href="#akismet">Akismet</a></li>
<li><a class="reference internal" href="#">Spam Filtering</a><ul>
<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="#example">Example</a></li>
</ul>
@ -94,10 +96,10 @@
<h4>Previous topic</h4>
<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>
<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>
<ul class="this-page-menu">
<li><a href="_sources/spam.txt"
@ -127,10 +129,10 @@
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="custom_fields.html" title="django-helpdesk custom fields"
<a href="custom_fields.html" title="Custom Fields"
>next</a> |</li>
<li class="right" >
<a href="settings.html" title="django-helpdesk settings"
<a href="settings.html" title="Settings"
>previous</a> |</li>
<li><a href="index.html">django-helpdesk v0.1 documentation</a> &raquo;</li>
</ul>