django-email-gateway:

.. image:: https://readthedocs.org/projects/django-email-gateway/badge/?version=latest :target: http://django-email-gateway.readthedocs.io/en/latest/ :alt: Documentation Status

.. image:: https://travis-ci.org/MicroPyramid/django-email-gateway.svg?branch=master :target: https://travis-ci.org/MicroPyramid/django-email-gateway

.. image:: https://img.shields.io/pypi/v/django-email-gateway.svg :target: https://pypi.python.org/pypi/django-email-gateway :alt: Latest Release

.. image:: https://coveralls.io/repos/github/MicroPyramid/django-email-gateway/badge.svg?branch=master :target: https://coveralls.io/github/MicroPyramid/django-email-gateway?branch=master

.. image:: https://landscape.io/github/MicroPyramid/django-email-gateway/master/landscape.svg?style=flat :target: https://landscape.io/github/MicroPyramid/django-email-gateway/master :alt: Code Health

.. image:: https://img.shields.io/github/license/micropyramid/django-email-gateway.svg :target: https://pypi.python.org/pypi/django-email-gateway/

Introduction:

A Simple Django app to easily send emails, receive inbound emails from users with different email vendors like AWS SES, Sendgrid, Mailgun.

Django email gateway_ is used for sending mails from your verified domains. It can be used to send emails from different email vendors like (AWS SES, Sendgrid, MailGun). Using this app, we can easily use different email vendors to verified, non-verified users.

Installation Procedure

1. Use pip to install easily with one step::

   $ pip install django-email-gateway

2. Pull the code from github using the following command::

   git clone git://github.com/micropyramid/django-email-gateway.git

   cd django-email-gateway

   python setup.py install

Configuration

• After installing/cloning the django app, add the following details in settings file to setup your email vendor for verified & non-verified users:

  .. code:: shell

  MAIL_SENDER = 'AMAZON' | 'SENDGRID' | 'MAILGUN'
  INACTIVE_MAIL_SENDER = 'AMAZON' | 'SENDGRID' | 'MAILGUN'
  

• If you're using Amazon as a email vendor, add the following settings with their values:

  .. code:: shell

  AWS_ACCESS_KEY_ID = "Your AWS Access Key"

  AWS_SECRET_ACCESS_KEY = "Your AWS Secret Key"

• If you're using Sendgrid as a email vendor, add the following settings with their values:

  .. code:: shell

  SG_USER = "Your Sendgrid Username" SG_PWD = "Your Sendgrid Password"

• If you're using Mailgun as a email vendor, add the following settings with their values:

  .. code:: shell

  MGUN_API_URL = "Your MailGun Api Url" MGUN_API_KEY = "Your MailGun Api Key"

How It Works?

• Sending Emails:

  You can easily send emails to verified and non-verified users from different email vendors like AWS SES, Sendgrid, Mailgun. With sending_mail function, you can send custom emails to users. By default, it'll send emails from sendgrid. Based on user verification, it will send emails to users from the specified email vendor.

• Receiving Email:

  You can easily get the receving emails from different vendors like sendgrid, aws ses, mailgun, by configuring and veririfying your website records in the specified email vendors like SES.

  Now It supports only ses for receiving emails, we'll release a version to support sendgrid, mailgun.

How To Use:

1. Add these settings to send & receive emails from different vendors.

2. Sending email::

   sending_mail(subject, email_template_name, context, from_email, to_email, verified)

3. Receiving emails::

   from django_email_gateway.receiving_mail import sns_notification subject, from_mail, to_mail, hash_code, mail_content = sns_notification(request.body)

It will process your message content, will return the email subject, from mail, to email([email protected]), hashcode(abc), mail content.

Visit our Django web development page Here_

We welcome your feedback and support, raise github ticket_ if you want to report a bug. Need new features? Contact us here_

.. _contact us here: https://micropyramid.com/contact-us/ .. _avaliable online: http://django-email-gateway.readthedocs.io/en/latest/ .. _github ticket: https://github.com/MicroPyramid/django-email-gateway/issues .. _Django email gateway: https://micropyramid.com/oss/ .. _Here: https://micropyramid.com/django-development-services/