django-postmark-utils 0.1

Description:

djangopostmarkutils 0.1

# Django Postmark UtilsDjango utilities to help track emails sent using Postmark.## Features- Store emails (including failed attempts) sent from within your project- Receive and store webhook notifications, for email bounces and deliveries- Track sent emails for errors, bounces, and deliveries- Resend emails## Prerequisites- [Django](https://www.djangoproject.com/)- [Postmark](https://postmarkapp.com/) account## Installation```pipinstallgit+https://github.com/regulusweb/django−postmark−utils.git‘‘‘DjangoPostmarkUtilsmakesuseoftheDjangoemailbackendprovidedby[Postmarker](https://postmarker.readthedocs.io/en/latest/),sofirstconfigureitinyourproject′ssettings,asperthe[documentation](https://postmarker.readthedocs.io/en/latest/django.html).‘‘‘pythonEMAILBACKEND=′postmarker.django.EmailBackend′POSTMARK=′TOKEN′:′<YOURPOSTMARKSERVERTOKEN>′,′TESTMODE′:False,′VERBOSITY′:0,‘‘‘Addtheapptoyourproject′s‘INSTALLEDAPPS‘setting:‘‘‘pythonINSTALLEDAPPS=(′djangopostmarkutils′,)‘‘‘Createtherequireddatabasetables:‘‘‘ python manage.py migrate django_postmark_utils```To receive [bounce](https://postmarkapp.com/developer/webhooks/bounce-webhook) and [delivery](https://postmarkapp.com/developer/webhooks/delivery-webhook) [webhook notifications](https://postmarkapp.com/developer/webhooks/webhooks-overview) from Postmark, configure the webhook URLs in your project's URL configuration:```pythonurlpatterns = [ url(r'^postmark/', include('django_postmark_utils.urls')),]```In your project's settings, configure a secret to be added to the webhook URLs:```pythonPOSTMARK_UTILS_SECRET = '<YOUR WEBHOOK URLS SECRET>'```Add the webhook URLs to your Postmark account:`https://example.com/postmark/<YOUR WEBHOOK URLS SECRET>/bounce-receiver/``https://example.com/postmark/<YOUR WEBHOOK URLS SECRET>/delivery-receiver/`Optionally change the default email header field name (`X-DjangoPostmarkUtils-Resend-For`) used to match resent emails to the messages they are for, in your project's settings:```pythonMESSAGE_ID_HEADER_FIELD_NAME = '<YOUR CUSTOM EMAIL HEADER FIELD NAME>'```## UsageEmails (including failed attempts) sent via the Postmarker email backend will be stored in the database, and can be viewed in the admin.In the email change page, clicking on the `Go to resend list` link next to the `Resend` field will send you to a list from where you can use the `Resend emails` admin action to resend the email.