Installation guide

The 1.6.0 release of django-contact-form-recaptcha supports Django 1.11 and 2.0 on the following Python versions (matching the versions supported by Django itself):

• Django 1.11 supports Python 2.7, 3.4, 3.5, and 3.6.
• Django 2.0 supports Python 3.4, 3.5, and 3.6.

Normal installation

The preferred method of installing django-contact-form-recaptcha is via pip, the standard Python package-installation tool. If you don’t have pip, instructions are available for how to obtain and install it. If you’re using Python 2.7.9 or later (for Python 2) or Python 3.4 or later (for Python 3), pip came bundled with your installation of Python.

Once you have pip, type:

pip install django-contact-form-recaptcha

If you plan to use the included spam-filtering contact form class AkismetContactForm, you will also need the Python akismet module. You can manually install it via pip install akismet, or tell django-contact-form-recaptcha to install it for you, by running:

pip install django-contact-form-recaptcha[akismet]

If you plan to use the included spam-filtering contact form class ReCaptchaContactForm, you will also need the Python django-recaptcha module. You can manually install it via pip install django-recaptcha, or it is installed by default with django-contact-form-recaptcha, by running:

pip install django-contact-form-recaptcha

If you do not already have a supported version of Django installed, installing django-contact-form-recaptcha will automatically install the most recent supported version of Django.

Installing from a source checkout

If you want to work on django-contact-form-recaptcha, you can obtain a source checkout.

The development repository for django-contact-form-recaptcha is at <https://github.com/maru/django-contact-form-recaptcha>. If you have git installed, you can obtain a copy of the repository by typing:

git clone https://github.com/maru/django-contact-form-recaptcha.git

From there, you can use normal git commands to check out the specific revision you want, and install it using pip install -e . (the -e flag specifies an “editable” install, allowing you to change code as you work on django-contact-form-recaptcha, and have your changes picked up automatically).

Configuration and use

Once you have Django and django-contact-form-recaptcha installed, check out the quick start guide to see how to get your contact form up and running.