Skip to main content

Simple application, that provides customizable email form tempalte tag.You can specify form fields and optionally enable dedicated view to render feedback page.

Project description


Add feedback to INSTALLED_APPS


Synchronize your database models:

django syncdb

Load feedback template tags:

{% load feedback_tags %}

Insert template tag in your template

{% show_feedback [key] %},

where key is feedback form key. Default key value is default.

Include something like

(r'^feedback', include('feedback.urls'))

in urlpatterns. That’s all!


Note that feedback uses ajax form based on jQuery, so you need to include jQuery in your page. You can install it from Google hosting. Just include

<script type="text/javascript" src=""></script>

in <head> element.


DIRECT_TO_TEMPLATE - When True, application will show default feedback form with template feedback/feedback_page.html where feedback urls were included. If you set this setting to False you should display feedback form manually, by including {% show_feedback [key] %} tag into template.

FEEDBACK_FILE_SIZE - This parameter sets attachments maximum file size in megabytes. Default value is 2 MB.


If you want to customize default feedback form, or add your own, you have to create an application with your forms. All feedback forms should be subclasses of feedback.forms.BaseFeedbackForm. Here is an example of custom feedback class:

from django import forms
from feedback.forms import BaseFeedbackForm

class OrderForm(BaseFeedbackForm):
    name = forms.CharField(label=u'Your name', max_length=200)
    email = forms.EmailField(label=u'Your Email', max_length=200)
    phone = forms.CharField(label=u'Phone', max_length=200)
    address = forms.CharField(label=u'Your address', max_length=200)
    date = forms.CharField(label=u'Date and time', max_length=200)
    file = forms.FileField(label=u'Attach the file')

    response = forms.CharField(label=u'Comment', max_length=500,
        widget=forms.Textarea(attrs={'cols':'30', 'rows':'5'}))
    subject = u'Custom order form'

    serialized_fields = ('name', 'phone', 'address', 'response')

subject attribute appears in email subject.

serialized_fields attribute contains names of fields, those will be stored in DB.

Than, you need to put feedback forms in your

FEEDBACK_FORMS - dictionary object, describes feedback forms on your site. Every key-value pair stands for feedback form object. For example:

    'default': 'mysite.custom_feedback.forms.OrderForm'

We have overrided default feedback form.

Now we can include {% show_feedback default %} in template and get overriden form.

What’s new

0.3.0 - Model for storing attachments in database added. Now attachments available in admin interface.

0.3.1 - Feedback Emails are ‘marked safe’

0.3.2 - Added Reply-to header if email form has email key

0.3.3 - Fiexd javascript URL in order to work with staticfiles

Redsolution CMS classifiers:

Content plugins

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page