django-contact-form-recaptcha 1.6.1

A generic contact-form application for Django

This application provides simple, extensible contact-form functionality for Django sites.

• Mail header ‘From: “Your Name” <[e-mail]>’, so it’s easy to reply to the sender.

• Subject provided by the user.

• Uses reCAPTCHA to block spam robots.

Quick start

Requirements:

• Python (2.7, 3.4, 3.5, 3.6)

• Django (1.11, 2.0)

To use the contact_forms.forms.ReCaptchaContactForm form:

1. Install django-contact-form-recaptcha:

   pip install django-contact-form-recaptcha

2. Obtain the reCAPTCHA API keys from https://www.google.com/recaptcha.

3. Supply the API keys for django-contact-form-recaptcha to use. You can either place them in the Django settings RECAPTCHA_PUBLIC_KEY and RECAPTCHA_PRIVATE_KEY, or in the environment variables PYTHON_RECAPTCHA_PUBLIC_KEY and PYTHON_RECAPTCHA_PRIVATE_KEY.

4. Add the application captcha in the Django settings:

   INSTALLED_APPS = [
       ...
       'captcha',
   ]

5. Then use the following URLconf:

   from django.conf.urls import include, url
   
   
   urlpatterns = [
       # ... other URL patterns for your site ...
       url(r'^contact/', include('contact_form.recaptcha_urls')),
   ]

   If you’re using Django 2.0, you can do:

   from django.urls import include, path
   
   
   urlpatterns = [
       # ... other URL patterns for your site ...
       path('contact/', include('contact_form.recaptcha_urls')),
   ]

6. Create your templates in your templates directory:

   • contact_form/contact_form.html

   • contact_form/contact_form_sent.html

   • contact_form/contact_form.txt

   • contact_form/contact_form_subject.txt

   Or you can use the templates provided by this package. Remember to add the application contact_form in the Django settings.

7. Emails are sent to the MANAGERS defined in your Django settings:

   MANAGERS = [('John', '[e-mail]'),]

Full documentation for all functionality is included and is also available online.

Originally forked from django-contact-form.