antipode.info/mailgunny
3
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
1 Commit 1 Branch 0 Tags 60 KiB
PHP 96.2%
Smarty 3.8%
7d66a7e439
Go to file
Rich Lott 7d66a7e439 initial commit
2018-12-13 15:40:26 +00:00
CRM/Mailgunny initial commit 2018-12-13 15:40:26 +00:00
images initial commit 2018-12-13 15:40:26 +00:00
settings initial commit 2018-12-13 15:40:26 +00:00
templates/CRM/Mailgunny initial commit 2018-12-13 15:40:26 +00:00
xml/Menu initial commit 2018-12-13 15:40:26 +00:00
info.xml initial commit 2018-12-13 15:40:26 +00:00
LICENSE.txt initial commit 2018-12-13 15:40:26 +00:00
mailgunny.civix.php initial commit 2018-12-13 15:40:26 +00:00
mailgunny.php initial commit 2018-12-13 15:40:26 +00:00
README.md initial commit 2018-12-13 15:40:26 +00:00

README.md

Mailgunny - Mailgun bounce processing.

Mailgun is one of many emailing services (e.g. SMTP relays). While many services offer to send all your bounced email to a particular email address (e.g. so CiviCRM can process bounces), Mailgun does not.

However, Mailgun can be configured to send bounce information directly to CiviCRM using webhooks, enabling the normal CiviMail mailing reports.

This extension provides this functionality.

The extension is licensed under AGPL-3.0.

Requirements

  • PHP v7.0+
  • CiviCRM 5.x (tested with 5.8.1)

Installation (Web UI)

This extension has not yet been published for installation via the web UI.

Installation (CLI, Zip)

Sysadmins and developers may download the .zip file for this extension and install it with the command-line tool cv.

cd <extension-dir>
cv dl mailgunny@https://github.com/artfulrobot/mailgunny/archive/master.zip

Installation (CLI, Git)

Sysadmins and developers may clone the Git repo for this extension and install it with the command-line tool cv.

git clone https://github.com/artfulrobot/mailgunny.git
cv en mailgunny

Usage

Step 1: configure your webhooks at Mailgun

Log in to mailgun's website and find the Webhooks page.

For Permanent Failure and Temporary Failure events, enter the webhook URL for your site, which will look like:

  • Drupal 7: https://example.com/civicrm/mailgunny/webhook
  • Wordpress: https://example.com/?page=CiviCRM&q=civicrm/mailgunny/webhook
  • Joomla: https://example.com/index.php?option=com_civicrm&task=civicrm/mailgunny/webhook

Step 2: enter your Mailgun API key

Nb. the API key is not your Mailgun password (nor your domain's SMTP password). You can find it on the page for your domain on the Mailgun admin interface.

Once you've got it, visit the settings page at:

  • Drupal 7: https://example.com/civicrm/mailgunny/settings
  • Wordpress: https://example.com/?page=CiviCRM&q=civicrm/mailgunny/settings
  • Joomla: https://example.com/index.php?option=com_civicrm&task=civicrm/mailgunny/settings

Put it in the box and press Save.

Right, you're all set.

Hey what's with the name?

Gunny is a strong coarse material. Such that you might make sacks out of. Like post/mail sacks. And this is about mailings. So Mailgunny. And, what we're not interested in at all is guns, so it's a deliberate subversion of Mailgun's name. After all, who wants to be shot by email?