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.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:
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
File details
Details for the file redsolutioncms.django-simple-feedback-0.3.3.tar.gz.
File metadata
- Download URL: redsolutioncms.django-simple-feedback-0.3.3.tar.gz
- Upload date:
- Size: 12.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db5fdf4cf92c37ced27d6d5cbd9ad3c8f41406241cc4aad3114d357b1d8aa147
|
|
| MD5 |
03d3b484a60f866ec55858b679716c37
|
|
| BLAKE2b-256 |
c33f7b05a5558f6d649ac38693056c574183a7da8a4dd0b4ad7b22c1775b67fa
|
