Skip to main content

A generic contact-form application for Django

Project description

https://travis-ci.org/maru/django-contact-form-recaptcha.svg Documentation Status

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

https://raw.githubusercontent.com/maru/django-contact-form-recaptcha/master/docs/_static/contact_form_recaptcha.png
  • Mail header ‘From: “Your Name” <your@email.com>’, 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', 'john@example.com'),]
    

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

Originally forked from django-contact-form.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-contact-form-recaptcha, version 1.6.1
Filename, size File type Python version Upload date Hashes
Filename, size django_contact_form_recaptcha-1.6.1-py2.py3-none-any.whl (24.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size django-contact-form-recaptcha-1.6.1.tar.gz (55.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page