django-live-support

A live support chat app for django that lets you chat with visitors to your site through the Django Admin interface.

Dependancies

• django (tested with 1.3)
• simplejson (required if using python 2.5, suggested otherwise)

Getting Started

To get started simply install using pip:

pip install django-live-support

Add live_support to your installed apps and syncdb (or migrate, if you have south installed).

Your installed apps should look something like this:

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.messages',
    'django.contrib.admin',
    'live_support',
)

Add live_support.urls to your urls.py, like so:

from django.conf.urls.defaults import patterns, include, url

from django.contrib import admin
admin.autodiscover()

urlpatterns = patterns('',
    url(r'^admin/', include(admin.site.urls)),
    url(r'^support/', include('live_support.urls')),
)

If you are going to use the chat_iframe templatetag, be sure that you have 'django.core.context_processors.request' in your TEMPLATE_CONTEXT_PROCESSORS.

Usage

You can either override the template for the start_chat (live_support/start_chat.html) and client_chat (live_support/live_support.html) views and just point users to the root of the live_support app as defined in your urls.py file, or you can drop the {% chat_iframe %} templatetag into your base template, but be sure to include {% load live_support_tags %} at the top of your template, which will render the chat sidebar (which pops out into a chat window) on every page.