https://github.com/ccnmtl/django-contact-us

simple, reusable contact us form for django
https://github.com/ccnmtl/django-contact-us

Last synced: 9 months ago
JSON representation

simple, reusable contact us form for django

• Host: GitHub
• URL: https://github.com/ccnmtl/django-contact-us
• Owner: ccnmtl
• Created: 2015-06-25T15:31:20.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2025-02-26T17:49:54.000Z (over 1 year ago)
• Last Synced: 2025-09-01T14:15:34.404Z (9 months ago)
• Language: Python
• Size: 52.7 KB
• Stars: 8
• Watchers: 9
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.txt

Awesome Lists containing this project

README

          
[![Actions Status](https://github.com/ccnmtl/django-contact-us/workflows/build-and-test/badge.svg)](https://github.com/ccnmtl/django-contact-us/actions)

[![Coverage Status](https://coveralls.io/repos/github/ccnmtl/django-contact-us/badge.svg?branch=master)](https://coveralls.io/github/ccnmtl/django-contact-us?branch=master)

Simple, reusable "contact us" form implementation for Django.

### Installation

    $ pip install django-contact-us

Add `contactus` to `INSTALLED_APPS`.

Add a `CONTACT_US_EMAIL` setting to specify the email address that

submissions will be sent to. Obviously, you also need your Django app

to be configured properly to send email.

Add a pattern like the following to your `urls.py`:

    ('^contact/', include('contactus.urls')),

Then, in any templates, you can link to the contact page with

`{% url 'contactus' %}`.

Very likely, you will want to customize the contact page and/or

success page templates. The simplest approach is probably to copy

those files out of this repo (in `contactus/templates/contactus/`)

into the appropriate templates directory in your project and tweak.

For more flexibility in overriding options, you can also use the

`contactus.views.ContactUsView` directly in your `urls.py`.