README.rst

Django Talkback

Django-Talkback is a pluggable Django app which adds a feedback form to every page on your site.

Installation

You can install the latest release of Django Talkback using pip:

$ pip install django-talkback

You can clone the repository yourself at https://github.com/littleweaver/django-talkback.

Setup

Ensure that 'talkback' is in your project's INSTALLED_APPS:

INSTALLED_APPS = (
    'talkback',
    ...
)

Add the following or similar anywhere in your URLconf:

urlpatterns = patterns('',
    url(r'^talkback/', include('talkback.urls')),
    ...
)

Add the following to your settings.py file:

MIDDLEWARE_CLASSES += (
   'talkback.middleware.TalkbackMiddleware',
   ...
)

Django Talkback relies on jQuery. If you do not already have jQuery in your templates, add this to you settings.py file:

TALKBACK_CONFIG = {
   'JQUERY_URL': '//ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js',
}

Customization

By default Talkback will send notification emails to all admins listed in settings.ADMINS. To change that, adjust this setting in settings.py:

TALKBACK_CONFIG = {
   'FEEDBACK_RECIPIENTS': (("Customer Support", "[email protected]"), ("Support 2", "[email protected]"),),
}

To disable notification emails, set FEEDBACK_RECIPIENTS to None.