class SimplenewsRecipientHandlerBase in Simplenews 7.2

Base class for all Simplenews Recipient Handler classes.

This handler sends a newsletter issue to all subscribers of a given newsletter.

Hierarchy

• class \SimplenewsRecipientHandlerBase implements SimplenewsRecipientHandlerInterface

1 string reference to 'SimplenewsRecipientHandlerBase'

simplenews_subscription.inc in plugins/recipient_handlers/simplenews_subscription.inc

File

includes/simplenews.recipient_handlers.inc, line 34

Provide helpful functions and Interfaces for recipient handler plugins.

class SimplenewsRecipientHandlerBase implements SimplenewsRecipientHandlerInterface {

  /**
   * The newsletter entity.
   *
   * @var SimplenewsNewsletter
   */
  public $newsletter;

  /**
   * Name of the handler plugin to be used.
   *
   * @var String
   */
  public $handler = '';

  /**
   * Settings array.
   *
   * @var array
   */
  public $settings = array();

  /**
   * @param SimplenewsNewsletter $newsletter
   *   The simplenews newsletter.
   * @param String $handler
   *   The name of the handler plugin to use.
   * @param array $settings
   *   An array of settings used by the handler to build the list of recipients.
   */
  public function __construct($newsletter, $handler, $settings = array()) {
    $this->newsletter = $newsletter;
    $this->handler = $handler;
    $this->settings = $settings;
  }

  /**
   * Implements SimplenewsRecipientHandlerInterface::buildRecipientQuery()
   */
  public function buildRecipientQuery() {
    $select = db_select('simplenews_subscriber', 's');
    $select
      ->innerJoin('simplenews_subscription', 't', 's.snid = t.snid');
    $select
      ->addField('s', 'snid');
    $select
      ->addField('s', 'mail');
    $select
      ->addField('t', 'newsletter_id');
    $select
      ->condition('t.newsletter_id', $this->newsletter->newsletter_id);
    $select
      ->condition('t.status', SIMPLENEWS_SUBSCRIPTION_STATUS_SUBSCRIBED);
    $select
      ->condition('s.activated', SIMPLENEWS_SUBSCRIPTION_ACTIVE);
    return $select;
  }

  /**
   * Implements SimplenewsRecipientHandlerInterface::buildRecipientCountQuery()
   */
  public function buildRecipientCountQuery() {
    return $this
      ->buildRecipientQuery()
      ->countQuery();
  }

  /**
   * Implements Countable::count().
   */
  public function count() {
    return $this
      ->buildRecipientCountQuery()
      ->execute()
      ->fetchField();
  }

}

Members

Name	Modifiers	Type	Description	Overrides
SimplenewsRecipientHandlerBase::$handler	public	property	Name of the handler plugin to be used.
SimplenewsRecipientHandlerBase::$newsletter	public	property	The newsletter entity.
SimplenewsRecipientHandlerBase::$settings	public	property	Settings array.
SimplenewsRecipientHandlerBase::buildRecipientCountQuery	public	function	Implements SimplenewsRecipientHandlerInterface::buildRecipientCountQuery() Overrides SimplenewsRecipientHandlerInterface::buildRecipientCountQuery
SimplenewsRecipientHandlerBase::buildRecipientQuery	public	function	Implements SimplenewsRecipientHandlerInterface::buildRecipientQuery() Overrides SimplenewsRecipientHandlerInterface::buildRecipientQuery
SimplenewsRecipientHandlerBase::count	public	function	Implements Countable::count().
SimplenewsRecipientHandlerBase::__construct	public	function