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
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.2.0 - Models for storing responses in DB created. Responses representation for admin interface added.
0.2.1 - Form attachments added. Attachments are sent by email.
Redsolution CMS classifiers:
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for redsolutioncms.django-simple-feedback-0.2.1.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 942a720b1511150647d1d7b728f8c827293e95354c436186e7820fc7803fc92f |
|
| MD5 | 8bc204e1538602471d8d70b57110a101 |
|
| BLAKE2b-256 | 14fcf0ce7821081744a3ec5a7cf13da330e84f57a614a06933bfd9126dd9cda7 |
