Skip to main content

Minified JQuery & Ajax feedback form to handle fast customer requests in Django

Project description

Minified JQuery & Ajax feedback/report form to handle fast customer requests in Django. You can use it as a fast feedback tool and/or to report objects (e.g. in case of abuse).

Prerequisites

You need at least the following packages in your virtualenv:

  • Django
  • Django Mailer
  • Django Libs
  • South

Installation

To get the latest stable release from PyPi:

$ pip install django-feedback-form

To get the latest commit from GitHub:

$ pip install -e git://github.com/bitmazk/django-feedback-form.git#egg=feedback_form

Add the app to your INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    'django',
    'mailer',
    'feedback_form',
    'django_libs',
]

Run the south migrations to create the app’s database tables:

$ ./manage.py migrate feedback_form

Usage

First of all add the feedback urls to your main urls.py:

url(r'^feedback/', include('feedback_form.urls')),

You can use the “normal” feedback view via /feedback/ but in almost every case you might want to use the ajax template tag. Just add the following code to e.g. your base.html:

{% load feedback_tags %}
{% feedback_form %}

Pretty ugly, eh? Now, you need to add css and js for sure, like this:

<link href="{{ STATIC_URL }}feedback_form/css/feedback_form.css" type="text/css" media="all" rel="stylesheet" />
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
<script type="text/javascript" src="{{ STATIC_URL }}feedback_form/js/feedback_form.js"></script>

That’s it! You can also use this app as a report tool. Simply call another url:

<a href="{% url "feedback_form_content_object" c_type='user' obj_id=user.pk %}">Report this user!</a>

You can easily customize your form by changing static files or by changing the following settings:

FEEDBACK_FORM_TEXTCOLOR

By default the text color is white like '#fff'.

FEEDBACK_FORM_COLOR

By default the background color is light blue like '#6caec9'.

FEEDBACK_FORM_TEXT

By default the text in the form is invisible. Just add the html markup you want to be displayed above the input fields, like:

<h3>Hi! Do you have feedback or questions?</h3>
<p>We'll answer as fast as possible.</p>

FEEDBACK_EMAIL_CONFIRMATION

Default: False

Sends a confirmation email to the feedback poster.

Roadmap

See the issue tracker for current and upcoming features.

Project details


Release history Release notifications

History Node

1.3

History Node

1.2.2

History Node

1.2.1

History Node

1.2

This version
History Node

1.1

History Node

1.0

History Node

0.3.1

History Node

0.3

History Node

0.2

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-feedback-form-1.1.tar.gz (24.0 kB) Copy SHA256 hash SHA256 Source None Jul 14, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page