========
Membrete
========
**Membrete** is a Django application which provides a contact form allowing to
store contact messages in the database and management through Django's admin
app.

If you are using it and have ideas for it I'll be more than happy to hear them!

Features
========
- Messages are stored in the database
- Recipients are Users (from django.contrib.auth)
- Internationalization support
- Message templates support
- AJAX support

Alternatives
============
-   django-contact-form_ is an extensible and very flexible contact form app
    for Django (from which membrete borrows some ideas)

..  _django-contact-form: http://bitbucket.org/ubernostrum/django-contact-form

Super quick start
=================

1. Go to the ``devproject`` directory and run the following commands::

    python manage.py syncdb
    python manage.py runserver
    
2. Go to http://localhost:8000/ to see Membrete in action!

Installation
============
Simply run the setup.py script as root, like this::

    python setup.py install

Usage
=====

To use Membrete in your project, just follow this simple steps:

1.  Add ``membrete`` to ``INSTALLED_APPS`` in your ``settings.py`` file
2.  Run ``python manage.py syncdb`` under your project directory to create
    membrete tables
3.  Edit the urls.py file and add something like this to ``urlpatterns``::

    (r'^contact$', include('membrete.urls')),

4.  Done! Fire up the server and go to http://localhost:8000/contact

Source
======

Branch Membrete using Bazaar_:: 

    bzr branch http://gonzalodelgado.com.ar/bzr/membrete/main membrete

.. _Bazaar: http://bazaar-vcs.org/

More info
=========
Get more information about membrete from its website_
If you have any questions feel free to email_ me anytime.

.. _website: http://gonzalodelgado.com.ar/codigo/membrete
.. _email: mailto:gonzalodel@gmail.com
