src/FlexMailerTask.php - Docblock

src/FlexMailerTask.php

@@ -43,41 +43,51 @@ class FlexMailerTask {
 
   /**
    * @var int
+   *   A persistent record for this email delivery.
+   * @see \CRM_Mailing_Event_DAO_Queue
    */
   private $eventQueueId;
 
   /**
    * @var int
+   *   The ID of the recipiient.
+   * @see \CRM_Contact_DAO_Contact
    */
   private $contactId;
 
   /**
    * @var string
+   *   An authentication code. The name is misleading - it may be hash, but
+   *   that implementation detail is outside our purview.
    */
   private $hash;
 
   /**
    * @var string
-   *
-   * WAS: email
+   *   Selected/preferred email address of the intended recipient.
    */
   private $address;
 
   /**
-   * The individual email message to send (per alterMailParams).
+   * The full email message to send to this recipient (per alterMailParams).
    *
    * @var array
    * @see MailParams
+   * @see \CRM_Utils_Hook::alterMailParams()
    */
   private $mailParams = array();
 
   /**
    * FlexMailerTask constructor.
    *
    * @param int $eventQueueId
+   *   A persistent record for this email delivery.
    * @param int $contactId
+   *   The ID of the recipiient.
    * @param string $hash
+   *   An authentication code.
    * @param string $address
+   *   Selected/preferred email address of the intended recipient.
    */
   public function __construct(
     $eventQueueId,
@@ -93,27 +103,33 @@ public function __construct(
 
   /**
    * @return int
+   * @see \CRM_Mailing_Event_DAO_Queue
    */
   public function getEventQueueId() {
     return $this->eventQueueId;
   }
 
   /**
    * @return int
+   *   The ID of the recipiient.
+   * @see \CRM_Contact_DAO_Contact
    */
   public function getContactId() {
     return $this->contactId;
   }
 
   /**
    * @return string
+   *   An authentication code. The name is misleading - it may be hash, but
+   *   that implementation detail is outside our purview.
    */
   public function getHash() {
     return $this->hash;
   }
 
   /**
    * @return string
+   *   Selected email address of the intended recipient.
    */
   public function getAddress() {
     return $this->address;