django-email-confirm-la
Django email confirmation for any Model and any Field.
Requirements
- Python (3.5, 3.6, 3.7, 3.8)
- Django (2.0, 2.1, 2.2, 3.0, 3.1)
Installation
$ pip install django-email-confirm-laIn your settings.py:
Add the email_confirm_la app (put it after your apps) and set the required settings:
INSTALLED_APPS = ( ... 'your_app', 'email_confirm_la', ...)EMAIL_CONFIRM_LA_HTTP_PROTOCOL = 'https'EMAIL_CONFIRM_LA_DOMAIN = 'vinta.ws'EMAIL_CONFIRM_LA_AUTOLOGIN = TrueEMAIL_CONFIRM_LA_TEMPLATE_CONTEXT = { 'THE_ANSWER': 42,}If you are using the sites framework, then EMAIL_CONFIRM_LA_DOMAIN can be omitted and Site.objects.get_current().domain will be used.
In your urls.py:
urlpatterns = [ ... url(r'^email_confirmation/', include('email_confirm_la.urls', namespace='email_confirm_la')), ...]then run
$ python manage.py migrateModels
For User Model
from django.contrib.auth.models import Userfrom email_confirm_la.models import EmailConfirmationuser = User.objects.get(username='vinta')email = '[email protected]'EmailConfirmation.objects.verify_email_for_object(email, user)For Any Model And Any Field
Assumed you have a model:
from django.db import modelsfrom django.contrib.contenttypes.fields import GenericRelation # Django 1.7+from django.contrib.contenttypes.generic import GenericRelationclass YourModel(models.Model): ... customer_support_email = models.EmailField(max_length=255, null=True, blank=True) marketing_email = models.EmailField(max_length=255, null=True, blank=True) ... # optional, but recommended when you want to perform cascade-deletions email_confirmations = GenericRelation('email_confirm_la.EmailConfirmation', content_type_field='content_type', object_id_field='object_id')And you want to verify some emails:
from your_app.models import YourModelfrom email_confirm_la.models import EmailConfirmationsome_model_instance = YourModel.objects.get(id=42)EmailConfirmation.objects.verify_email_for_object( email='[email protected]', content_object=some_model_instance, email_field_name='customer_support_email')EmailConfirmation.objects.verify_email_for_object( email='[email protected]', content_object=some_model_instance, email_field_name='marketing_email')Signals
post_email_confirmation_sendpost_email_confirmation_confirm
In your models.py:
from django.dispatch import receiverfrom email_confirm_la.signals import post_email_confirmation_confirm@receiver(post_email_confirmation_confirm)def post_email_confirmation_confirm_callback(sender, confirmation, **kwargs): model_instace = confirmation.content_object email = confirmation.email old_email = kwargs['old_email'] do_your_stuff()Commands
$ python manage.py clear_expired_email_confirmationsTemplates
You will want to override the project's email message and confirmation pages.
Ensure the email_confirm_la app in INSTALLED_APPS is after the app that you will place the customized templates in so that the django.template.loaders.app_directories.Loader finds your templates first.
There are following template that you can override:
email_confirm_la/email/email_confirmation_subject.txt: Produces the subject line of the email.email_confirm_la/email/email_confirmation_message.html: The HTML body of the email.email_confirm_la/email_confirmation_success.html: What the user sees after clicking a confirmation link (on success).email_confirm_la/email_confirmation_fail.html:What the user sees after clicking a invalid confirmation link.email_confirm_la/email_confirmation_expiration.html:What the user sees after clicking an expired confirmation link.
Settings
Default values of app settings:
EMAIL_CONFIRM_LA_HTTP_PROTOCOL = 'http'EMAIL_CONFIRM_LA_DOMAIN = 'example.com'EMAIL_CONFIRM_LA_CONFIRM_EXPIRE_SEC = 60 * 60 * 24 * 1 # 1 dayEMAIL_CONFIRM_LA_CONFIRM_URL_REVERSE_NAME = 'email_confirm_la:confirm_email'EMAIL_CONFIRM_LA_TEMPLATE_CONTEXT = {}EMAIL_CONFIRM_LA_AUTOLOGIN = FalseRun Tests
$ pip install -r requirements_test.txt$ python setup.py test# or$ docker build -t email_confirm_la .$ docker run --rm=true -v `pwd`:/app email_confirm_la
