3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.6 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2014 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2014
35 class CRM_Mailing_Event_BAO_Queue
extends CRM_Mailing_Event_DAO_Queue
{
40 function __construct() {
41 parent
::__construct();
45 * Queue a new recipient
47 * @param array $params values of the new EventQueue
49 * @return CRM_Mailing_Event_BAO_Queue The new EventQueue
53 public static function create($params) {
54 $eq = new CRM_Mailing_Event_BAO_Queue();
55 $eq->copyValues($params);
56 if (empty($params['id']) && empty($params['hash'])) {
57 $eq->hash
= self
::hash($params);
64 * Create a security hash from the job, email and contact ids
66 * @param array The ids to be hashed
68 * @return int The hash
72 public static function hash($params) {
73 $jobId = $params['job_id'];
74 $emailId = CRM_Utils_Array
::value('email_id', $params, '');
75 $contactId = $params['contact_id'];
77 return substr(sha1("{$jobId}:{$emailId}:{$contactId}:" . time()),
83 * Verify that a queue event exists with the specified id/job id/hash
85 * @param int $job_id The job ID of the event to find
86 * @param int $queue_id The Queue Event ID to find
87 * @param string $hash The hash to validate against
89 * @return object|null The queue event if verified, or null
93 public static function &verify($job_id, $queue_id, $hash) {
95 $q = new CRM_Mailing_Event_BAO_Queue();
96 if (!empty($job_id) && !empty($queue_id) && !empty($hash)) {
100 if ($q->find(TRUE)) {
108 * Given a queue event ID, find the corresponding email address.
110 * @param int $queue_id The queue event ID
112 * @return string The email address
116 public static function getEmailAddress($queue_id) {
117 $email = CRM_Core_BAO_Email
::getTableName();
118 $eq = self
::getTableName();
119 $query = " SELECT $email.email as email
122 ON $eq.email_id = $email.id
123 WHERE $eq.id = " . CRM_Utils_Type
::rule($queue_id, 'Integer');
125 $q = new CRM_Mailing_Event_BAO_Queue();
135 * Count up events given a mailing id and optional job id
137 * @param int $mailing_id ID of the mailing to count
138 * @param int $job_id Optional ID of a job to limit results
140 * @return int Number of matching events
144 public static function getTotalCount($mailing_id, $job_id = NULL) {
145 $dao = new CRM_Core_DAO();
147 $queue = self
::getTableName();
148 $mailing = CRM_Mailing_BAO_Mailing
::getTableName();
149 $job = CRM_Mailing_BAO_MailingJob
::getTableName();
152 SELECT COUNT(*) as queued
155 ON $queue.job_id = $job.id
157 ON $job.mailing_id = $mailing.id
159 WHERE $mailing.id = " . CRM_Utils_Type
::escape($mailing_id, 'Integer') . ($job_id ?
" AND $job.id = " . CRM_Utils_Type
::escape($job_id,
169 * Get rows for the event browser
171 * @param int $mailing_id ID of the mailing
172 * @param int $job_id optional ID of the job
173 * @param int $offset Offset
174 * @param int $rowCount Number of rows
175 * @param array $sort sort array
177 * @return array Result set
181 public static function &getRows($mailing_id, $job_id = NULL, $offset = NULL,
182 $rowCount = NULL, $sort = NULL
184 $dao = new CRM_Core_Dao();
186 $queue = self
::getTableName();
187 $mailing = CRM_Mailing_BAO_Mailing
::getTableName();
188 $job = CRM_Mailing_BAO_MailingJob
::getTableName();
189 $contact = CRM_Contact_BAO_Contact
::getTableName();
190 $email = CRM_Core_BAO_Email
::getTableName();
192 $orderBy = "sort_name ASC, {$job}.start_date DESC";
194 if (is_string($sort)) {
195 $sort = CRM_Utils_Type
::escape($sort, 'String');
199 $orderBy = trim($sort->orderBy());
204 SELECT $contact.display_name as display_name,
205 $contact.id as contact_id,
206 $email.email as email,
207 $job.start_date as date
210 ON $queue.contact_id = $contact.id
212 ON $queue.email_id = $email.id
214 ON $queue.job_id = $job.id
216 ON $job.mailing_id = $mailing.id
218 WHERE $mailing.id = " . CRM_Utils_Type
::escape($mailing_id, 'Integer');
220 if (!empty($job_id)) {
221 $query .= " AND $job.id = " . CRM_Utils_Type
::escape($job_id, 'Integer');
224 $query .= " ORDER BY {$orderBy} ";
226 if ($offset ||
$rowCount) {
227 //Added "||$rowCount" to avoid displaying all records on first page
228 $query .= ' LIMIT ' . CRM_Utils_Type
::escape($offset, 'Integer') . ', ' . CRM_Utils_Type
::escape($rowCount, 'Integer');
235 while ($dao->fetch()) {
236 $url = CRM_Utils_System
::url('civicrm/contact/view',
237 "reset=1&cid={$dao->contact_id}"
240 'name' => "<a href=\"$url\">{$dao->display_name}</a>",
241 'email' => $dao->email
,
242 'date' => CRM_Utils_Date
::customFormat($dao->date
),
249 * Get the mailing object for this queue event instance
253 * @return object Mailing BAO
256 public function &getMailing() {
257 $mailing = new CRM_Mailing_BAO_Mailing();
258 $jobs = CRM_Mailing_BAO_MailingJob
::getTableName();
259 $mailings = CRM_Mailing_BAO_Mailing
::getTableName();
260 $queue = self
::getTableName();
266 ON $jobs.mailing_id = $mailings.id
268 ON $queue.job_id = $jobs.id
269 WHERE $queue.id = {$this->id}");
275 * @param int $queueID
279 public static function getContactInfo($queueID) {
281 SELECT DISTINCT(civicrm_mailing_event_queue.contact_id) as contact_id,
282 civicrm_contact.display_name as display_name,
283 civicrm_email.email as email
284 FROM civicrm_mailing_event_queue,
287 WHERE civicrm_mailing_event_queue.contact_id = civicrm_contact.id
288 AND civicrm_mailing_event_queue.email_id = civicrm_email.id
289 AND civicrm_mailing_event_queue.id = " . CRM_Utils_Type
::escape($queueID, 'Integer');
291 $dao = CRM_Core_DAO
::executeQuery($query, CRM_Core_DAO
::$_nullArray);
293 $displayName = 'Unknown';
296 $displayName = $dao->display_name
;
297 $email = $dao->email
;
300 return array($displayName, $email);
304 * @param array $params
307 static function bulkCreate($params, $now = NULL) {
312 // construct a bulk insert statement
314 foreach ($params as $param) {
315 $values[] = "( {$param[0]}, {$param[1]}, {$param[2]}, {$param[3]}, '" . substr(sha1("{$param[0]}:{$param[1]}:{$param[2]}:{$param[3]}:{$now}"),
320 while (!empty($values)) {
321 $input = array_splice($values, 0, CRM_Core_DAO
::BULK_INSERT_COUNT
);
322 $str = implode(',', $input);
323 $sql = "INSERT INTO civicrm_mailing_event_queue ( job_id, email_id, contact_id, phone_id, hash ) VALUES $str;";
324 CRM_Core_DAO
::executeQuery($sql);