django-zendesk-tickets 0.10

Django views and forms that submit tickets to Zendesk

Settings

ZENDESK_BASE_URL=http://zendesk.example.com
ZENDESK_API_USERNAME=...
ZENDESK_API_TOKEN=...
ZENDESK_REQUESTER_ID=...
ZENDESK_GROUP_ID=...

Usage

Add an entry to your urls.py

from zendesk_tickets import views
from zendesk_tickets import forms

url(r'^submit_ticket/$', views.ticket, {
        'template_name': 'xxx/submit_ticket_page.html',
        'success_redirect_url': '/',
        'ticket_template_name': 'zendesk_tickets/ticket.txt',
        'form_class': forms.TicketForm,
        'subject': 'Website Ticket',
        'tags': [],
        'extra_context': {},
    }, name='submit_ticket'),

If you wish to include additional fields, subclass BaseTicketForm and add them. If you wish to include them in the body of the ticket, create a new ticket template and pass it as the ticket_template_name. If you wish to include them as custom fields, define the following in your settings.py:

ZENDESK_CUSTOM_FIELDS={
    'referer': 31,  # zendesk field id
    'username': 32,
    'user_agent': 33
}

The three fields in the example above are included in TicketForm by default and can be included in your ticket by referencing them in the ticket template or specifying custom field ids in settings.

Copyright

Copyright © 2016 HM Government (Ministry of Justice Digital Services). See LICENSE for further details.