This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Help Scout integration for Django.

Introduction

If you are using Help Scout to handle support tickets for your Django web application, you can use Help Scout’s custom app feature to provide additional information on the user, such as the following:

This project provides a Django app which allows you to integrate Help Scout Custom App into your Django web application and easily customize the output.

Installation

You can install this library via pip:

pip install django-helpscout

Once installed, add django_helpscout to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...,
    'django_helpscout'
    ...,
)

Add Help Scout’s secret key to your settings file:

HELPSCOUT_SECRET = '<helpscout custom app secret key>'

Getting Started

A Django view is provided to make it easy for you to get started. First, add the view to your urls.py:

from django_helpscout.views import helpscout_user

urlpatterns = patterns('',
    # Your URL definitions
    url(r'^helpscout-user/$', helpscout_user),
)

Once done, deploy your web application to production and point your Help Scout Custom App URL to the url you have configured above and you should see a simple HTML output on the side bar of a support ticket with the user’s username and join date.

Customizing the HTML Output

You will want to customize the HTML output to add in additional information related to the user. You can do so by overriding the templates that are included.

In your templates folder, create the following structure:

templates/
    |- django_helpscout
             |- 404.html
             |- helpscout.html

Details on the two templates:

404.html
Used when a user with the given email address is not found
helpscout.html
Used when a user is found

By overriding the library’s built-in templates, you can customize the output to suit your needs.

Further Customizations

You might want to use select_related to prefetch related models for a particular user, or you have additional data sources to query when loading a user. A helper decorator is available if you wish to use your own view.

The decorator helps you deal with verifying Help Scout’s signature when a request is made from their side. You can use the decorator in the following manner:

from django_helpscout.helpers import helpscout_request

# your view
@helpscout_request
def load_user_for_helpscout(request):
    ... code here ...

License

Copyright 2014 Victor Neo

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

History

0.6.3 (2015-05-21)

  • Added csrf_exempt decorator to helpscout_user view.
  • Fixed failing bytes conversion on Python < 3 in helpscout_request decorator.

0.6.2 (2014-12-04)

  • Updated documentation with previously missing configuration option.

0.6.1 (2014-11-20)

  • Fixed bug with Django’s HTTP header names (Thanks @Fizzadar!)

0.6.0 (2014-09-29)

  • Preliminary Python 3.4 support.

0.5.0 (2014-08-06)

  • PyPI release.

0.0.1 (2014-08-01)

  • Initial release on GitHub.
Release History

Release History

0.6.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.6.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.6.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.5.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-helpscout-0.6.3.tar.gz (6.6 kB) Copy SHA256 Checksum SHA256 Source May 30, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting