Add IMP_Api::logRecipient.

imp/docs/CHANGES

@@ -2,6 +2,7 @@
 v6.2.0-git
 ----------
 
+[mjr] Add IMP_Api::logRecipient.
 [mms] Remove the mail_domain preference.
 [mjr] Add display of reccurence data to iTip viewer (Request #12919).
 [mms] Allow HTML data to be pasted within HTML compose editor paste dialog.

imp/lib/Api.php

@@ -302,6 +302,22 @@ public function favouriteRecipients($limit,
         return $GLOBALS['injector']->getInstance('IMP_Sentmail')->favouriteRecipients($limit, $filter);
     }
 
+    /**
+     * Log an entry to the IMP_Sentmail system.
+     *
+     * @param string $action             The performed action. One of:
+     *                                   'new', 'reply', 'forward', 'redirect',
+     *                                   or 'mdn'.
+     * @param string|array $recipients   The message recipients.
+     * @param string $message_id         The message-id.
+     * @param boolean $success           Was the message successfully sent?
+     */
+    public function logRecipient($reason, $recipients, $message_id, $success = true)
+    {
+        $GLOBALS['injector']->getInstance('IMP_Sentmail')->log(
+            $reason, $message_id, $recipients, $success);
+    }
+
     /**
      * Returns the Horde_Imap_Client object created using the IMP credentials.
      *

imp/package.xml

@@ -33,6 +33,7 @@
  </stability>
  <license uri="http://www.horde.org/licenses/gpl">GPL-2.0</license>
  <notes>
+* [mjr] Add IMP_Api::logRecipient.
 * [mms] Remove the mail_domain preference.
 * [mjr] Add display of reccurence data to iTip viewer (Request #12919).
 * [mms] Allow HTML data to be pasted within HTML compose editor paste dialog.