Django application that allows you to easily get user feedbacks. Users need to be registrated via django.contrib.auth.
Project description
=====================================
django-simple-feedback (django-simple-feedback)
=====================================
.. image:: https://secure.travis-ci.org/Narsil/django-simple-feedback.png
This `Django <http://djangoproject.com>`_ app has for purpose to integrate easily user based feedback.
It aims to be easily added into existing projects and pretty on any website.
NEW in master
~~~~~~~~~~~~~
master version is now operational for Django-1.3 with `collectstatic <https://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#collectstatic>`_
This will break backward compatibility, branch django-1.2.5 is the last working
state for Django-1.2.5
Installation
============
Depedencies
~~~~~~~~~~~
django-simple-feedback requires jQuery, and it includes it in its static files.
Installing django-simple-feedback
~~~~~~~~~~~~~~~~~~~~~~~~~~
Install into your python path using pip or github version::
pip install django-simple-feedback
pip install -e git://github.com/Narsil/django-simple-feedback
Add *'feedback'* to your INSTALLED_APPS in settings.py, also make sure *'django.core.context_processors.request'* is in your TEMPLATE_CONTEXT_PROCESSORS::
INSTALLED_APPS = (
...
'feedback',
)
....
TEMPLATE_CONTEXT_PROCESSORS = (
'django.core.context_processors.request'
)
Add css and javascript in your *'base.html'* template (jQuery is optional if you already include it in your project)::
<link rel="stylesheet" type="text/css" href="{{ STATIC_URL }}feedback/css/feedback.css" />
<script type="text/javascript" src="{{ STATIC_URL }}feedback/js/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="{{ STATIC_URL }}feedback/js/feedback.js"></script>
And then in templates where you want feedback to appear::
{% load feedback_tags %}
....
{% feedback %}
Add *'(r'^feedback', include('feedback.urls')'* to your urls::
urlpatterns = patterns( '',
....
(r'^feedback', include('feedback.urls'),
)
Don't forget to run ::
./manage.py syncdb
to create the table that is going to receive the feedbacks.
Receiving mail of feedbacks
~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you wish to receive mail when someone posts some feedback then you need to
configure these which are the defaults::
FEEDBACK_SEND_MAIL = True
FEEDBACK_FROM = 'feedback@example.com'
FEEDBACK_REPLY_TO_USER = True
FEEDBACK_TO = map(lambda x:x[1], settings.MANAGERS) (should be managers emails)
FEEDBACK_SUBJECT = '[feedback] %(path)s'
FEEDBACK_BODY = '%(feedback)s'
In `FEEDBACK_SUBJECT` and `FEEDBACK_BODY` you are able to customize the text.
each string is formatted with a dict containing information on the feedback.
Dict is::
{'id': 42,
'feedback': 'This is a random comment made by random person',
'path': 'url the feedback was made on',
'user': User object,
'request': request object} # You can access IP and USER_AGENT via request.
Other settings are::
FEEDBACK_ASK_EMAIL = False
Asks user to write his email when it is missing from his account.
django-simple-feedback (django-simple-feedback)
=====================================
.. image:: https://secure.travis-ci.org/Narsil/django-simple-feedback.png
This `Django <http://djangoproject.com>`_ app has for purpose to integrate easily user based feedback.
It aims to be easily added into existing projects and pretty on any website.
NEW in master
~~~~~~~~~~~~~
master version is now operational for Django-1.3 with `collectstatic <https://docs.djangoproject.com/en/dev/ref/contrib/staticfiles/#collectstatic>`_
This will break backward compatibility, branch django-1.2.5 is the last working
state for Django-1.2.5
Installation
============
Depedencies
~~~~~~~~~~~
django-simple-feedback requires jQuery, and it includes it in its static files.
Installing django-simple-feedback
~~~~~~~~~~~~~~~~~~~~~~~~~~
Install into your python path using pip or github version::
pip install django-simple-feedback
pip install -e git://github.com/Narsil/django-simple-feedback
Add *'feedback'* to your INSTALLED_APPS in settings.py, also make sure *'django.core.context_processors.request'* is in your TEMPLATE_CONTEXT_PROCESSORS::
INSTALLED_APPS = (
...
'feedback',
)
....
TEMPLATE_CONTEXT_PROCESSORS = (
'django.core.context_processors.request'
)
Add css and javascript in your *'base.html'* template (jQuery is optional if you already include it in your project)::
<link rel="stylesheet" type="text/css" href="{{ STATIC_URL }}feedback/css/feedback.css" />
<script type="text/javascript" src="{{ STATIC_URL }}feedback/js/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="{{ STATIC_URL }}feedback/js/feedback.js"></script>
And then in templates where you want feedback to appear::
{% load feedback_tags %}
....
{% feedback %}
Add *'(r'^feedback', include('feedback.urls')'* to your urls::
urlpatterns = patterns( '',
....
(r'^feedback', include('feedback.urls'),
)
Don't forget to run ::
./manage.py syncdb
to create the table that is going to receive the feedbacks.
Receiving mail of feedbacks
~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you wish to receive mail when someone posts some feedback then you need to
configure these which are the defaults::
FEEDBACK_SEND_MAIL = True
FEEDBACK_FROM = 'feedback@example.com'
FEEDBACK_REPLY_TO_USER = True
FEEDBACK_TO = map(lambda x:x[1], settings.MANAGERS) (should be managers emails)
FEEDBACK_SUBJECT = '[feedback] %(path)s'
FEEDBACK_BODY = '%(feedback)s'
In `FEEDBACK_SUBJECT` and `FEEDBACK_BODY` you are able to customize the text.
each string is formatted with a dict containing information on the feedback.
Dict is::
{'id': 42,
'feedback': 'This is a random comment made by random person',
'path': 'url the feedback was made on',
'user': User object,
'request': request object} # You can access IP and USER_AGENT via request.
Other settings are::
FEEDBACK_ASK_EMAIL = False
Asks user to write his email when it is missing from his account.
Project details
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
Built Distribution
Close
Hashes for django-simple-feedback-0.2.9.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6913fdc78b5833c6ce2f962b9009fc5a643eab38fca3420e0ac6c17dedd24056 |
|
MD5 | b2d696b24e08e7129bb851b5249d300b |
|
BLAKE2b-256 | a12aa34cef5c37ae942ebc1625eb92f15c065e7cbbaa2fcd9ae0e1d56caa718b |
Close
Hashes for django-simple-feedback-0.2.9.linux-i686.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4da420fbab54695e54178dfe69592e16106ea00d187a48b054327d57b3abd3d7 |
|
MD5 | 009157fde09ca698f9cc97d6512f2096 |
|
BLAKE2b-256 | a143c2e77349a3646e59b71d0d7f48b026bc9ebb7bc1d74f69b2b9622a6f8ca0 |