Simple Django feedback application
Usage
Add feedback to INSTALLED_APPS
INSTALLED_APPS = [
...
'feedback',
...
]
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!
Requriments
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="http://ajax.googleapis.com/ajax/libs/jquery/1.5/jquery.min.js"></script>
in <head> element.
Settings
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.
Customize
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 settings.py:
FEEDBACK_FORMS - dictionary object, describes feedback forms on your site. Every key-value pair stands for feedback form object. For example:
FEEDBACK_FORMS = {
'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:
6 maintainers
Release files for redsolutioncms.django-simple-feedback 0.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| redsolutioncms.django-simple-feedback-0.3.3.tar.gz | 12.4 kB | Details |
Release files / redsolutioncms.django-simple-feedback-0.3.3.tar.gz
| Download URL | redsolutioncms.django-simple-feedback-0.3.3.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
db5fdf4cf92c37ced27d6d5cbd9ad3c8f41406241cc4aad3114d357b1d8aa147
|
|
BLAKE2b-256 checksum How to use checksums |
c33f7b05a5558f6d649ac38693056c574183a7da8a4dd0b4ad7b22c1775b67fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
