mailgunny/mailgunny.php

<?php

require_once 'mailgunny.civix.php';
use CRM_Mailgunny_ExtensionUtil as E;

/**
 * Implements hook_civicrm_config().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_config
 */
function mailgunny_civicrm_config(&$config) {
  _mailgunny_civix_civicrm_config($config);
}

/**
 * Implements hook_civicrm_xmlMenu().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_xmlMenu
 */
function mailgunny_civicrm_xmlMenu(&$files) {
  _mailgunny_civix_civicrm_xmlMenu($files);
}

/**
 * Implements hook_civicrm_install().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_install
 */
function mailgunny_civicrm_install() {
  _mailgunny_civix_civicrm_install();
}

/**
 * Implements hook_civicrm_postInstall().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_postInstall
 */
function mailgunny_civicrm_postInstall() {
  _mailgunny_civix_civicrm_postInstall();
}

/**
 * Implements hook_civicrm_uninstall().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_uninstall
 */
function mailgunny_civicrm_uninstall() {
  _mailgunny_civix_civicrm_uninstall();
}

/**
 * Implements hook_civicrm_enable().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_enable
 */
function mailgunny_civicrm_enable() {
  _mailgunny_civix_civicrm_enable();
}

/**
 * Implements hook_civicrm_disable().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_disable
 */
function mailgunny_civicrm_disable() {
  _mailgunny_civix_civicrm_disable();
}

/**
 * Implements hook_civicrm_upgrade().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_upgrade
 */
function mailgunny_civicrm_upgrade($op, CRM_Queue_Queue $queue = NULL) {
  return _mailgunny_civix_civicrm_upgrade($op, $queue);
}

/**
 * Implements hook_civicrm_managed().
 *
 * Generate a list of entities to create/deactivate/delete when this module
 * is installed, disabled, uninstalled.
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_managed
 */
function mailgunny_civicrm_managed(&$entities) {
  _mailgunny_civix_civicrm_managed($entities);
}

/**
 * Implements hook_civicrm_caseTypes().
 *
 * Generate a list of case-types.
 *
 * Note: This hook only runs in CiviCRM 4.4+.
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_caseTypes
 */
function mailgunny_civicrm_caseTypes(&$caseTypes) {
  _mailgunny_civix_civicrm_caseTypes($caseTypes);
}

/**
 * Implements hook_civicrm_angularModules().
 *
 * Generate a list of Angular modules.
 *
 * Note: This hook only runs in CiviCRM 4.5+. It may
 * use features only available in v4.6+.
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_angularModules
 */
function mailgunny_civicrm_angularModules(&$angularModules) {
  _mailgunny_civix_civicrm_angularModules($angularModules);
}

/**
 * Implements hook_civicrm_alterSettingsFolders().
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_alterSettingsFolders
 */
function mailgunny_civicrm_alterSettingsFolders(&$metaDataFolders = NULL) {
  _mailgunny_civix_civicrm_alterSettingsFolders($metaDataFolders);
}

/**
 * Implements hook_civicrm_entityTypes().
 *
 * Declare entity types provided by this module.
 *
 * @link http://wiki.civicrm.org/confluence/display/CRMDOC/hook_civicrm_entityTypes
 */
function mailgunny_civicrm_entityTypes(&$entityTypes) {
  _mailgunny_civix_civicrm_entityTypes($entityTypes);
}

/**
 * Try to embed VERP data in a way that Mailgun will provide to webhooks.
 *
 * Implements hook_civicrm_alterMailParams(&$params, $context)
 */
function mailgunny_civicrm_alterMailParams(&$params, $context) {
  if (isset($params['X-CiviMail-Bounce'])) {
    // Copy this header to one that will be returned by Mailgun's webhook.
    $params['headers']['X-Mailgun-Variables'] = json_encode(['civimail-bounce' => $params['X-CiviMail-Bounce']]);
  }
  elseif (isset($params['Return-Path'])) {
    // Copy this header to one that will be returned by Mailgun's webhook.
    $params['headers']['X-Mailgun-Variables'] = json_encode(['civimail-bounce' => $params['Return-Path']]);
  }
  else {
    // Probably a single email, for which we don't have any useful information to add.
  }
  /*
   * $context = (string [10]) `flexmailer`
   * $params['X-CiviMail-Mosaico'] = (string [3]) `Yes`
   * $params['List-Unsubscribe'] = (string [52]) `<mailto:u.72.32.fa5f74c72c53c77f@crm.example.com>`
   * $params['Precedence'] = (string [4]) `bulk`
   * $params['job_id'] = (string [2]) `72`
   * $params['From'] = (string [37]) `"Wilma Flintstone" <wilma@example.com>`
   * $params['toEmail'] = (string [20]) `barney@example.com`
   * $params['toName'] = (string [12]) `Barney Rubble`
   * $params['Return-Path'] = (string [43]) `b.72.32.fa5f74c72c53c77f@crm.example.com`
   * $params['X-CiviMail-Bounce'] = (string [43]) `b.72.32.fa5f74c72c53c77f@crm.example.com`
   * $params['attachments'] = (array)
 */
}