A reusable contact form app for Django. Can be used via CAPTCHA and/or via modern user-friendly spam protection.
Project description
bitmazk-contact-form
====================
A reusable contact form app for Django. Can be used via CAPTCHA and/or via
modern user-friendly spam protection. Ready for multilingual sites.
At the moment this contact form does not redirect to a success page. Instead
it adds a variable ``success`` to the template context. The developer can then
just output some success message next to the form.
The project can be used in conjunction with `django-cms
<https://github.com/divio/django-cms>`_. Therefore the package comes with a
``cms_app.py`` file and can be integrated into your CMS pages via an AppHook.
The code is heavily influenced by the wonderful `django-contact-form
<https://github.com/jezdez/django-contact-form>`_ of `Jannis Leidel
<https://github.com/jezdez>`_. We just applied our own coding standards and
ported it to Class Based Generic Views.
Prerequisites
=============
- see requirements.txt
Installation
============
If you want to install the latest stable release from PyPi:
$ pip install bitmazk-contact-form
If you want to use captchas be sure to install::
$ pip install django-simple-captcha
If you feel adventurous and want to install the latest commit from GitHub:
$ pip install -e git://github.com/bitmazk/bitmazk-contact-form#egg=contact_form
Add ``contact_form`` to your ``INSTALLED_APPS``::
INSTALLED_APPS = (
[...]
'contact_form',
}
Add ``CONTACT_FORM_RECIPIENTS`` to your ``settings.py``::
CONTACT_FORM_RECIPIENTS = (
('Foo Bar', 'foobar@example.com'),
)
Make sure to have a block called ``contact_form`` in your template::
{% block contact_form %}
If the output does not fit your needs, just override the templates provided by
this package.
optional::
* Create a CMS page, assign it to the template that has the ``contact_form``
block and add the ``Contact Form AppHook`` to the page.
Configuration
=============
Set ``ENABLE_CAPTCHA=True`` if you want to show an image captcha.
====================
A reusable contact form app for Django. Can be used via CAPTCHA and/or via
modern user-friendly spam protection. Ready for multilingual sites.
At the moment this contact form does not redirect to a success page. Instead
it adds a variable ``success`` to the template context. The developer can then
just output some success message next to the form.
The project can be used in conjunction with `django-cms
<https://github.com/divio/django-cms>`_. Therefore the package comes with a
``cms_app.py`` file and can be integrated into your CMS pages via an AppHook.
The code is heavily influenced by the wonderful `django-contact-form
<https://github.com/jezdez/django-contact-form>`_ of `Jannis Leidel
<https://github.com/jezdez>`_. We just applied our own coding standards and
ported it to Class Based Generic Views.
Prerequisites
=============
- see requirements.txt
Installation
============
If you want to install the latest stable release from PyPi:
$ pip install bitmazk-contact-form
If you want to use captchas be sure to install::
$ pip install django-simple-captcha
If you feel adventurous and want to install the latest commit from GitHub:
$ pip install -e git://github.com/bitmazk/bitmazk-contact-form#egg=contact_form
Add ``contact_form`` to your ``INSTALLED_APPS``::
INSTALLED_APPS = (
[...]
'contact_form',
}
Add ``CONTACT_FORM_RECIPIENTS`` to your ``settings.py``::
CONTACT_FORM_RECIPIENTS = (
('Foo Bar', 'foobar@example.com'),
)
Make sure to have a block called ``contact_form`` in your template::
{% block contact_form %}
If the output does not fit your needs, just override the templates provided by
this package.
optional::
* Create a CMS page, assign it to the template that has the ``contact_form``
block and add the ``Contact Form AppHook`` to the page.
Configuration
=============
Set ``ENABLE_CAPTCHA=True`` if you want to show an image captcha.
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
bitmazk-contact-form-0.0.6.tar.gz
(15.4 kB
view hashes)
Close
Hashes for bitmazk-contact-form-0.0.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3ecb6adf3817c0dfbb4081b8379d7e5a190abe1c22f530c2b9c0ee8c73d6bcc0 |
|
MD5 | b2c301edd5ac9193abc0136d62bf30bd |
|
BLAKE2b-256 | ce78f662a7ee87249e111e75f4d8f3c57e814275c39ec095f2e57d593f8d6694 |