cmsplugin-contact 1.1.3

Download

Setup

Put 'cmsplugin_contact' in your INSTALLED_APPS section in settings.py. Don’t forget to syncdb your database or migrate if you’re using South.

Put 'cmsplugin_contact.middleware.ForceResponseMiddleware' in your MIDDLEWARE_CLASSES section in settings.py.

DEFAULT_FROM_EMAIL

The email address that is used to send the message is picked up from DEFAULT_FROM_EMAIL Django setting. Additionally, the Reply-To: header is set to the user-supplied email address.

Sending the message using the user-supplied address to set From: header of the email is currently not supported. This is because many servers will reject emails that use From: addresses not registered with that server. Some servers may also strip the Reply-To: header. For this, the user-supplied email address is also added to the body of the message.

RECAPTCHA_PUBLIC_KEY and RECAPTCHA_PRIVATE_KEY

If you don’t want to enter the ReCATPCHA keys in the admin interface you can provide them through these settings.

AKISMET_API_KEY

The same as for ReCAPTCHA goes fo Akismet.

CMSPLUGIN_CONTACT_FORMS

Default:

(
    ('cmsplugin_contact.forms.ContactForm', _('default')),
)

You can use your custom ContactForm, just add a new tuple with the class path and name pretty name to show for your user.

If you want to steal using the default ContactForm, do like this in your settings:

(
    ('cmsplugin_contact.forms.ContactForm', _('default')),
    ('my_app.forms.MyContactForm', _('My form')),
)

In your custom form, you can set what template you want to use, like this:

class MyContactForm(Form):
    ...
    template = 'path/to/my_contact_template.html'

Signals

Email sent

After the contact email has been sent a signal is fired. You can use it like this:

from django.dispatch import receiver
from cmsplugin_contact.cms_plugins import email_sent


@receiver(email_sent)
def handle_signal(sender, **kwargs):
    print kwargs['data']