symfony-bundle mailgun-admin-bundle

copromatic/mailgun-admin-bundle

A bundle that offers a set of tools to monitor emails sent via Mailgun

Table of contents

Requirements

This bundle is tested with Symfony 3 and PHP 7.1 with Swiftmailer and Mailgun Transport, _(*1)

Getting started

MailgunAdminBundle simply register ids of emails sent from Mailgun in DB and offers, _(*2)

Just pull the vendor:br/ composer require copromatic/mailgun-admin-bundle, _(*3)

(Optional) Set up a connection for the bundle, will use "default" if not specified, _(*4)

orm:
    default_entity_manager: default
    entity_managers:
        default:
            connection: default
            naming_strategy: doctrine.orm.naming_strategy.underscore
            auto_mapping: true
        mailgun_admin:
            connection: default
            naming_strategy: doctrine.orm.naming_strategy.underscore
            mappings:
                MailgunAdminBundle: ~

...

mailgun_admin:
    api_key: '%mailgun_api_key%'
    entity_manager: 'mailgun_admin'

Then update your database:br/ php [bin|app]/console doctrine:schema:update --force [--em=mailgun_admin], _(*5)

Or, _(*6)

php [bin|app]/console doctrine:migration:diff and php [bin|app]/console doctrine:migration:migrate if you roll with migrations, _(*7)

A Swiftmailer listener waits for an email sent, it registers it to the DB if it bears a Message-Id (set up by Mailgun), _(*8)

What's included

8 tables:
One for messages (mailgun can set their same id to multiples emails if they are sent at the same time)
7 for trackers: bounces, clicks, deliveries, failures, opens, spam reports, _(*9)

TODO

• ! tests !
• Implement unsubscribe tracking
• Services to access content easily
• Twig extensions to display data

Creators

, _(*10)

github.com/copromatic, _(*11)

, _(*12)

Yannis Touili - github.com/touiliy, _(*13)

Copyright and license

Code and documentation copyright 2012-2017. Code released under the MIT License., _(*14)