The source package of django-contactme comes with several demo projects to see the application in action:
- bare_demo is the simplest demo possible.
- bare_demo_with_ajax is the same previous example plus Ajax functionality provided by
jquery.djcontactme.js, the jquery plugin that comes with the application.
- crispy_forms_demo is an example of how to use django-contactme with django-crispy-forms.
Demo quick setup¶
Demo projects live inside the
example project in app’s root directory.
The simplest and less interfeing way to run the demo projects is by creating a virtualenv for django-contactme. Then:
cdinto the any of the demo directories.
python manage migrateto create a minimal SQLite db for the demo.
python manage runserverand browse http://localhost:8000
In addition, crispy_forms_demo requires the crispy_forms package:
$ pip install django-crispy-forms
By default the demo project send email messages to the standard output. You can customize the email settings to send actual emails.
settings.py module, go to the end of the file and customize the following entries:
EMAIL_HOST = "" # for gmail it would be: "smtp.gmail.com" EMAIL_PORT = "" # for gmail: "587" EMAIL_HOST_USER = "" # for gmail: firstname.lastname@example.org EMAIL_HOST_PASSWORD = "" EMAIL_USE_TLS = True # for gmail DEFAULT_FROM_EMAIL = "Your site name <email@example.com>" SERVER_EMAIL = DEFAULT_FROM_EMAIL # Fill in actual EMAIL settings above, and comment out the # following line to let the django demo sending actual emails # EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend' CONTACTME_NOTIFY_TO = "Your name <firstname.lastname@example.org>"
The domain used in the links sent by email refers to example.com and thus are not associated with your django development web server. Change the domain name through the admin interface, sites application, to something like localhost:8000 so that URLs in email messages match your development server.