Metadata-Version: 1.0
Name: redsolutioncms.django-simple-feedback
Version: 0.2.1
Summary: Simple application, that provides customizable email form tempalte tag.
You can specify form fields and optionally enable dedicated view to render feedback page.
Home-page: UNKNOWN
Author: Ivan Gromov
Author-email: ivan.gromov@redsolution.ru
License: GPLv3
Description: 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.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:
        ````````````````````````````
        
        `Content plugins`_
        
        .. _`Content plugins`: http://www.redsolutioncms.org/classifiers/content
        
Keywords: django feedback form
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Natural Language :: Russian
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
