Skip to main content

Django mailing through admin

Project description

django-postie

This project allows you to send emails and manage them in the admin panel. By default package uses celery to send emails.

Installation

Update INSTALLED_APPS

INSTALLED_APPS = [
    ...
    'postie',
    'parler',
    'codemirror2',
    'ckeditor',
    'des',
    ...
]

Run migrations: `python manage.py migrate`

Available settings

POSTIE_TEMPLATE_CHOICES - Tuple of tuples. Where the first value is the value to use in code and second is verbose(translated).

POSTIE_TEMPLATE_CONTEXTS - dictionary with template choices as keys and dictionaries as values

For example:

POSTIE_TEMPLATE_CONTEXTS = {
    'mail_event': {
        'context_var1': _('Context variable 1 description'),
        'context_vae2': _('Context variable 2 user description'),
        ...
    },
    ...
}

POSTIE_INSTANT_SEND - whether to send letters instantly or to use celery task. If False celery is required.

POSTIE_HTML_ADMIN_WIDGET - dictionary with default widget for HTML field in Template model in django admin interface

For example:

POSTIE_HTML_ADMIN_WIDGET = {
    'widget': 'TinyMCE',
    'widget_module': 'tinymce',
    'attrs': {'attrs': {'cols': 80, 'rows': 10}}
}

POSTIE_DEBUG_MODE - controls whether to raise exceptions on send_mail. By default equals DEBUG

Basic example to use:

# your_module.py

from postie.shortcuts import send_mail

send_mail(
    event='MAIL_EVENT',
    recipients=['email@email.com', 'email1@email1.com'],
    context={
        'var1': 'variable context',
        'var2': 'another value'
    },
    from_email='noreply@email.com',
    attachments=[{
        'file_name': open('path-to-the-file')
    }]
)

Full documentation check here - https://cyberbudy.gitlab.io/django-postie/

Integrations

Tilda

To use https://tilda.cc/ add integration to settings

INSTALLED_APPS = [
    ...
    'postie.integrations.tilda',
    'solo',
    ...
]

Run migrations Now you can edit Tilda preferences and add corresponding tilda id to your mail templates in the admin.

Signals

There are two signals available:

tilda_webhook_received - This is send on webhook call.

Argumets:

request - request instance.

credentials - Credentials used to validate request

tilda_page_fetched - This is send when tilda_html is updated in the template.

Argumets:

project_id - Tilda project id.

page_id - Tilda page id.

template - MailTemplate was updated. If None - template with such page_id was not found.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-postie-0.8.4.tar.gz (23.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page