django-sendgrid
django-sendgrid copied to clipboard
SendGrid for Django
=============== django-sendgrid
.. image:: https://pypip.in/d/django-sendgrid/badge.png
Master Branch Build Status:
.. image:: https://www.codeship.io/projects/64b8c9d0-8f52-0130-fe63-22000a95225b/status?branch=master
Develop Branch Build Status:
.. image:: https://www.codeship.io/projects/64b8c9d0-8f52-0130-fe63-22000a95225b/status?branch=develop
django-sendgrid is the easiest way to send e-mail with SendGrid. It uses the SendGrid SMTP API, as recommended.
Although it's rather simple to use, a example project is included to demonstrate usage.
Installation
To install with PyPi::
pip install django-sendgrid
Usage
Add sendgrid to your INSTALLED_APPS::
INSTALLED_APPS = (
# Existing apps
"sendgrid",
)
Add the following to your settings::
SENDGRID_EMAIL_HOST = "smtp.sendgrid.net"
SENDGRID_EMAIL_PORT = 587
SENDGRID_EMAIL_USERNAME = "your_sendgrid_username"
SENDGRID_EMAIL_PASSWORD = "your_sendgrid_password"
Don't forget to migrate::
python manage.py migrate sendgrid
The API is similar to that of Django's; create a SendGridEmailMessage and send it::
>>> from sendgrid.message import SendGridEmailMessage
>>> email = SendGridEmailMessage('Subject', 'Body', '[email protected]', ['[email protected]'])
>>> email.send()
Additional Information
- https://docs.djangoproject.com/en/1.3/topics/email/
- http://ryanbalfanz.github.com/django-sendgrid/
- http://pypi.python.org/pypi/django-sendgrid
- http://djangopackages.com/packages/p/django-sendgrid/
Preview
List View
.. image:: https://s3.amazonaws.com/django-sendgrid/email_message_list.png
Detail View
.. image:: https://s3.amazonaws.com/django-sendgrid/email_message_detail.png