pip install -e git://github.com/shantilabs/django-mailqueue.git#egg=mailqueue
Base settings:
INSTALLED_APPS = (
# ...
'mailqueue',
)Cases:
from datetime import timedelta
from django.utils import timezone
import mailqueue
# simple email
mailqueue.add_mail('subject', 'message', 'email@example.com')
# send now (synchronous)
mailqueue.add_mail('subject', 'message', 'email@example.com',
send_now=True)
# send after 3 days
start_datetime = timezone.now() + timedelta(days=3)
mailqueue.add_mail('subject', 'delayed message', 'email@example.com',
start_datetime=start_datetime)
# custom "From" (for easy reply)
mailqueue.add_mail('New question', question, manager.email,
from_email=customer.email)mailqueue.models.MailerMessage
=== letters/hello.txt ===
{% extends "email.txt" %}
{% block subject %}Subject{% endblock %}
{% block body %}
Hello, {{ customer.name }}!
{% endblock %}
Usage:
import mailqueue
# email from django templates
mailqueue.add_templated_mail(customer.email, 'letters/hello.txt', {
'customer': customer,
})Different settings for mailqueue's letters and for standard Django send_mail() / mail_admin() functions:
EMAIL_HOST = 'myhost'
EMAIL_HOST_USER = 'user'
EMAIL_HOST_PASSWORD = 'password'
MAILQUEUE_SERVER_SETTINGS = {
'host': 'another_host',
'username': 'another_username',
'password': 'another_password',
}Different settings for different recipients:
MAILQUEUE_SERVER_SETTINGS = [{
# from yandex to yandex
'to_regex': '^.*@yandex.ru$',
'host': 'smtp.yandex.ru',
'port': 465,
'username': 'username',
'password': '********',
'use_tls': True,
}, {
# from gmail to other services
'host': 'smtp.gmail.com',
'port': 587,
'username': 'username@gmail.com',
'password': '********',
'use_tls': True,
}]# default behavior: send email after creation like send_mail()
MAILQUEUE_SEND_METHOD = 'now'
# send email after creation with celery task
# MAILQUEUE_SEND_METHOD = 'celery'
# Manual run
# MAILQUEUE_SEND_METHOD = 'cron'Celery task: mailqueue.task.clean_mailqueue
Crontab for manual run:
*/2 * * * * www-data /path/to/my/project/manage.py process_mailqueue
Supervisord config for manual run:
[program:myproject_mailqueue]
command=/path/to/my/project/manage.py process_mailqueue --forever
process_name=myproject_mailqueue
user=www-data
autorestart=true
# 0 = save letters forever (default)
MAILQUEUE_ARCHIVE_LIFETIME_DAYS = 0
Celery task: mailqueue.tasks.clean_mailqueue
Crontab:
0 4 * * * www-data /path/to/my/project/manage.py clean_mailqueue
Default contents of "From" field if sender's email is not equals to server email:
MAILQUEUE_FROM = "{from_email}"
GMail always set server email to "From". Avoid this:
MAILQUEUE_FROM = u'{from_email} <{email_host_user}>'
MAILQUEUE_PROCESSING_PAUSE_SECONDS = 2