Installation guide

Before installing django-contact-form, you’ll need to have a copy of Django already installed. For information on obtaining and installing Django, consult the Django download page, which offers convenient packaged downloads and installation instructions.

The 1.3 release of django-contact-form supports Django 1.8 and 1.9, on any Python version supported by those versions of Django:

  • Django 1.8 suports Python 2.7, 3.3, 3.4 and 3.5.
  • Django 1.9 supports Python 2.7, 3.4 and 3.5.

It is expected that django-contact-form 1.3 will also work with Django 1.10 and Python 3.6 once they are released.

Important

Python 3.2

Although Django 1.8 supported Python 3.2 at the time of its release, Python 3.2.7 (released in early 2016) marked the end of life of the Python 3.2 series, and as a result support for Python 3.2 has been dropped from django-contact-form.

Normal installation

The preferred method of installing django-contact-form 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.

Once you have pip, simply type:

pip install django-contact-form

Manual installation

It’s also possible to install django-contact-form manually. To do so, obtain the latest packaged version from the listing on the Python Package Index. Unpack the .tar.gz file, and run:

python setup.py install

Once you’ve installed django-contact-form, you can verify successful installation by opening a Python interpreter and typing import contact_form.

If the installation was successful, you’ll simply get a fresh Python prompt. If you instead see an ImportError, check the configuration of your install tools and your Python import path to ensure django-contact-form installed into a location Python can import from.

Installing from a source checkout

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

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

From there, you can use normal git commands to check out the specific revision you want, and install it using python setup.py install.

Basic configuration and use

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