A reusable Django app, that handles newsletter subscriptions
A reusable Django app, that handles newsletter subscriptions.
If you upgrade from 0.2 upwards, you need to be aware, that the migrations were reset. They used to be south, but they have been re-created to new Django migrations in 0.3.
If you’re first install is on 0.3 or beyond, you don’t have to do anything.
To get the latest stable release from PyPi
pip install django-newsletter-signup
To get the latest commit from GitHub
pip install -e git+git://github.com/bitmazk/django-newsletter-signup.git#egg=newsletter_signup
Add newsletter_signup to your INSTALLED_APPS
INSTALLED_APPS = ( ..., 'newsletter_signup', )
Add the newsletter_signup URLs to your urls.py
urlpatterns = patterns('', ... url(r'^newsletter/', include('newsletter_signup.urls')), )
Add the provided middleware to catch all referrers
MIDDLEWARE_CLASSES = ( '...', # your other middlewares 'newsletter.middleware.GetRefererMiddleware', )
Don’t forget to migrate your database
./manage.py migrate newsletter_signup
Just link to the signup page or fetch it’s contents via AJAX into e.g. a bootstrap modal. Once a user fills out the subscription form she gets a verification email, that on click makes the Subscription verified.
Future updates might include mailchimp integration to have everything setup right away. For now you then need to gather the emails from the admin or your own custom management views that you want to send mails to, or alternatively create a custom management command.
Default = 'locahost:8000'
DOMAIN is the hostname of your site.
DOMAIN = 'example.com'