Skip to content
This repository has been archived by the owner on Jul 20, 2022. It is now read-only.

Latest commit

 

History

History
68 lines (63 loc) · 4.09 KB

README.md

File metadata and controls

68 lines (63 loc) · 4.09 KB
Raw

biz.jmaconsulting.mte version 1.2 for CiviCRM 4.2, 4.3, 4.4, 4.5

Mandrill Transactional Emails

See https://github.com/JMAConsulting/biz.jmaconsulting.mte/wiki/About-mte-%28Mandrill-Transactional-Emails%29

Installation instructions for Mandrill Transactional Emails

  • Setup Mandrill
    • Register for or login to your Mandrill account at https://mandrillapp.com/login/
    • Create API key as follows:
    • Click on Settings (Gear icon top-right) >> SMTP & API Credentials.
    • Click +New API Key
    • Note SMTP Credentials, or leave window tab open for a few steps.
  • Setup Extensions Directory
    • If you have not already done so, go to Administer >> System Settings >> Directories
      • Set an appropriate value for CiviCRM Extensions Directory. For example, for Drupal, /path/to/drupalroot/sites/all/modules/Extensions/
      • In a different window, ensure the directory exists and is readable by your web server process.
    • Click Save.
  • Setup Extensions Resources URL
  • Install Mandrill Transactional Emails extension
    • Go to Administer >> Customize Data and Screens >> Manage Extensions.
    • If you do not see Mandrill Transactional Emails in the list of extensions, download it and unzip it into the extensions direction setup above, then return to this page.
    • Beside Mandrill Transactional Emails, click Install.
    • Review the information, then click Install.
  • Setup From Email address
    • If you have not already done so, go to:
    • Administer >> Communications >> From Email Addresses.
    • Enter a from address you would like to display to users for CiviCRM emails, for example, info@yourorg.org.
  • Setup Outbound Email
    • Administer >> System Settings >> Mandrill Smtp Settings.
    • Enter the following:
      • SMTP Server: smtp.mandrillapp.com
      • SMTP Port: 587
      • Authentication: Yes
      • SMTP Username: (from first step above, e.g. mail@yourorg.org)
      • SMTP Password: (copy and paste API Key from first step above, e.g. 12345678-abcd-1234-efgh-123456789012)
    • Click Save & Send Test Email
    • Note the value of the field Mandrill Post URL, for example by copying and pasting it into a file for use later in this setup.
    • Check that you received the test email.
  • Configure Webhooks for Mandrill
    • To complete this step successfully, your website must be accessible from the Internet so that Mandrill can post to it. So if you are running a test site locally on your laptop that other computers cannot access, this step will fail.
    • Login or go to your Mandrill account at https://mandrillapp.com/login/
    • Click on Settings (ie the Gear icon on the top-right) >> Webhooks
    • Click on +Add a Webhook
    • Click to enable all entries except Message Is Sent, including
      • Message Is Soft-bounced
      • Message Is Clicked
      • Message Recipient Unsubscribe
      • Message Is Bounced
      • Message Is Opened
      • Message Is Marked As Spam
      • Message Is Rejected
    • In Post to URL, enter the resource URL that you saved in the previous step above. For example: http://yourorg.org/civicrm/ajax/mte/callback?mandrillSecret=108d3af8a77fc502
  • Test by doing an action in CiviCRM that sends out a non-bulk email.
  • This should not be necessary, but if you would like to change the secret code that is used to ensure secure communication from Mandrill to your instance of CiviCRM, you can change the secret as follows:
    • Go to Administer > System Settings > Option Groups.
    • Beside Mandrill Secret, click on Options.
    • Click edit beside Secret Code.
    • Change the value, then click Save.
    • Navigate to Administer >> System Settings >> Mandrill Smtp Settings, click on SMTP, copy the value of Mandrill Post URL. Note that this step is necessary since it also activates the use of this callback URL.
    • Use that new value to configure the Post to URL value of the webhook for Mandrill.