Allow everybody to unsubscribe your messages, user accounts are not required.
Project description
Allow everybody to unsubscribe your messages, user accounts are not required.
Free software: MIT license
Documentation: https://django-opt-out.readthedocs.io.
Features
A single page form for opt-out feedback submission
Feedback options text controlled from django admin
Predefined feedback defaults available from django manage command
Feedback translations done in django admin
Feedback options selection based on tags supplied to the opt-out url
Ability to preselect a feedback option
Ability to change selected feedback options after submission
Ability to set tag:value pair on opt-out url and store them on submission with user feedback
Signal to modify opt-out form before rendering
Signal on opt-out feedback submission
Easily overridable thank you / goodbye view
Opt-out form with a easily overridable base template
Demo
To run an example project for this django reusable app, click the button below and start a demo serwer on Heroku
Quickstart
Install Django Opt-out application:
pip install django-opt-out
Add it to your INSTALLED_APPS:
INSTALLED_APPS = (
...
'django_opt_out.apps.DjangoOptOutConfig',
...
)
Add Django Opt-out application’s URL patterns:
from django_opt_out import urls as django_opt_out_urls
urlpatterns = [
...
url(r'^', include(django_opt_out_urls)),
...
]
Add unsubscribe links to your emails:
from django_opt_out.utils import get_opt_out_path
email='Django Opt-out <django-opt-out@niepodam.pl>'
unsubscribe = get_opt_out_path(email, 'some', 'tags', 'controlling', 'questionnaire')
# unsubscribe link will not have a domain name and scheme
# you can build prefix from request, but I prefer to set it in settings
from django.conf import settings
unsubscribe = settings.BASE_URL + unsubscribe
body = 'Hello, Regards\n\nUnsubscribe: ' + unsubscribe
from django.core import mail
message = mail.EmailMultiAlternatives(body=body, to=[email])
message.extra_headers['List-Unsubscribe'] = "<{}>".format(unsubscribe)
message.send()
Running Tests
Does the code actually work?
source <YOURVIRTUALENV>/bin/activate (myenv) $ pip install tox (myenv) $ tox
Credits
This package was created with Cookiecutter and the wooyek/cookiecutter-django-app project template.
History
0.1.0 (2017-11-03)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_opt_out-0.9.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f58230c7c6ecc46e8137c730c92b03dd64ed7f35411e412f467e81d6f11911df |
|
MD5 | db0cd22f2fdf3f901205412c74f8f874 |
|
BLAKE2b-256 | 2b22e9fb0489a2c44ae0191a0845916eceb0de123c0dc99f7ddbeb4328849885 |