myks-contact 0.1

Goals

myks-contact is a simple contact form. It’s adequate for a personal home page. It features a basic CAPTCHA.

Setup

myks-contact is a pluggable Django application. It works with Python >= 2.6 and Django >= 1.5.

1. Download and install the package from PyPI:

   $ pip install myks-contact

2. Add contact to INSTALLED_APPS:

   INSTALLED_APPS += 'contact',

   This allows Django to discover the built-in templates and translations.

3. Define the list of recipients in the CONTACT_EMAILS setting:

   CONTACT_EMAILS = ['you@example.com']

4. Add the application to your URLconf with the contact application namespace:

   urlpatterns += patterns('',
       url(r'^contact/', include('contact.urls', namespace='contact', app_name='contact')),
   )

To use the built-in templates, your project’s base.html template must provide two blocks: title and content, as shown in this example. You may also override the contact/form.html and contact/thanks.html templates.

Changelog

0.1

• Initial public release, extracted from my private repository.

• Switched the implementation to class-based generic views.

• Added documentation (README file).