3 * File for the TestMailing class
9 * This file is part of CiviCRM
11 * CiviCRM is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Affero General Public License
13 * as published by the Free Software Foundation; either version 3 of
14 * the License, or (at your option) any later version.
16 * CiviCRM is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU Affero General Public License for more details.
21 * You should have received a copy of the GNU Affero General Public
22 * License along with this program. If not, see
23 * <http://www.gnu.org/licenses/>.
26 require_once 'CiviTest/CiviUnitTestCase.php';
30 * Test APIv3 civicrm_mailingab_* functions
34 class api_v3_MailingABTest
extends CiviUnitTestCase
{
35 protected $_mailingID_A;
36 protected $_mailingID_B;
37 protected $_mailingID_C;
39 protected $_apiversion = 3;
40 protected $_entity = 'MailingAB';
43 public function setUp() {
45 $this->useTransaction(TRUE);
46 $this->createLoggedInUser();
47 $this->_mailingID_A
= $this->createMailing();
48 $this->_mailingID_B
= $this->createMailing();
49 $this->_mailingID_C
= $this->createMailing();
50 $this->_groupID
= $this->groupCreate();
52 $this->_params
= array(
53 'mailing_id_a' => $this->_mailingID_A
,
54 'mailing_id_b' => $this->_mailingID_B
,
55 'mailing_id_c' => $this->_mailingID_C
,
56 'testing_criteria' => 'subject',
57 'winner_criteria' => 'open',
58 'declare_winning_time' => '+2 days',
59 'group_percentage' => 10,
64 * Test civicrm_mailing_create.
66 public function testMailingABCreateSuccess() {
67 $result = $this->callAPIAndDocument($this->_entity
, 'create', $this->_params
, __FUNCTION__
, __FILE__
);
68 $this->assertTrue(is_numeric($result['id']), "In line " . __LINE__
);
69 $this->assertEquals($this->_params
['group_percentage'], $result['values'][$result['id']]['group_percentage']);
73 * Test civicrm_mailing_delete.
75 public function testMailerDeleteSuccess() {
76 $result = $this->callAPISuccess($this->_entity
, 'create', $this->_params
);
78 $this->assertDBQuery(1, "SELECT count(*) FROM civicrm_mailing_abtest WHERE id = %1", array(
79 1 => array($result['id'], 'Integer'),
81 $this->assertDBQuery(3, "SELECT count(*) FROM civicrm_mailing WHERE id IN (%1,%2,%3)", array(
82 1 => array($this->_mailingID_A
, 'Integer'),
83 2 => array($this->_mailingID_B
, 'Integer'),
84 3 => array($this->_mailingID_C
, 'Integer'),
87 $this->callAPISuccess($this->_entity
, 'delete', array('id' => $result['id']));
89 $this->assertDBQuery(0, "SELECT count(*) FROM civicrm_mailing_abtest WHERE id = %1", array(
90 1 => array($result['id'], 'Integer'),
92 $this->assertDBQuery(0, "SELECT count(*) FROM civicrm_mailing WHERE id IN (%1,%2,%3)", array(
93 1 => array($this->_mailingID_A
, 'Integer'),
94 2 => array($this->_mailingID_B
, 'Integer'),
95 3 => array($this->_mailingID_C
, 'Integer'),
102 public function groupPctProvider() {
103 $cases = array(); // array(int $totalSize, int $groupPct, int $expectedCountA, $expectedCountB, $expectedCountC)
104 $cases[] = array(400, 7, 28, 28, 344);
105 $cases[] = array(100, 10, 10, 10, 80);
106 $cases[] = array(50, 20, 10, 10, 30);
107 $cases[] = array(50, 10, 5, 5, 40);
108 $cases[] = array(3, 10, 1, 1, 1);
109 $cases[] = array(2, 10, 1, 1, 0);
110 $cases[] = array(1, 10, 1, 0, 0);
115 * Create a test and ensure that all three mailings (A/B/C) wind up with the correct
116 * number of recipients.
118 * @param $totalGroupContacts
120 * @param $expectedCountA
121 * @param $expectedCountB
122 * @param $expectedCountC
123 * @dataProvider groupPctProvider
125 public function testDistribution($totalGroupContacts, $groupPct, $expectedCountA, $expectedCountB, $expectedCountC) {
127 $result = $this->groupContactCreate($this->_groupID
, $totalGroupContacts);
128 $this->assertEquals($totalGroupContacts, $result['added'], "in line " . __LINE__
);
130 $params = $this->_params
;
131 $params['group_percentage'] = $groupPct;
132 $result = $this->callAPISuccess($this->_entity
, 'create', $params);
134 $this->callAPISuccess('Mailing', 'create', array(
135 'id' => $this->_mailingID_A
,
136 'groups' => array('include' => array($this->_groupID
)),
138 $this->assertJobCounts(0, 0, 0);
140 $this->callAPISuccess('MailingAB', 'submit', array(
141 'id' => $result['id'],
142 'status' => 'Testing',
143 'scheduled_date' => date('YmdHis'),
144 'approval_date' => date('YmdHis'),
146 $this->assertRecipientCounts($expectedCountA, $expectedCountB, $expectedCountC);
147 $this->assertJobCounts(1, 1, 0);
149 $this->callAPISuccess('MailingAB', 'submit', array(
150 'id' => $result['id'],
152 'scheduled_date' => date('YmdHis'),
153 'approval_date' => date('YmdHis'),
155 $this->assertRecipientCounts($expectedCountA, $expectedCountB, $expectedCountC);
156 $this->assertJobCounts(1, 1, 1);
160 * @param $expectedCountA
161 * @param $expectedCountB
162 * @param $expectedCountC
164 protected function assertRecipientCounts($expectedCountA, $expectedCountB, $expectedCountC) {
165 $countA = $this->callAPISuccess('MailingRecipients', 'getcount', array('mailing_id' => $this->_mailingID_A
));
166 $countB = $this->callAPISuccess('MailingRecipients', 'getcount', array('mailing_id' => $this->_mailingID_B
));
167 $countC = $this->callAPISuccess('MailingRecipients', 'getcount', array('mailing_id' => $this->_mailingID_C
));
168 $this->assertEquals($expectedCountA, $countA, "check mailing recipients A in line " . __LINE__
);
169 $this->assertEquals($expectedCountB, $countB, "check mailing recipients B in line " . __LINE__
);
170 $this->assertEquals($expectedCountC, $countC, "check mailing recipients C in line " . __LINE__
);
178 protected function assertJobCounts($expectedA, $expectedB, $expectedC) {
179 $this->assertDBQuery($expectedA, 'SELECT count(*) FROM civicrm_mailing_job WHERE mailing_id = %1', array(
185 $this->assertDBQuery($expectedB, 'SELECT count(*) FROM civicrm_mailing_job WHERE mailing_id = %1', array(
191 $this->assertDBQuery($expectedC, 'SELECT count(*) FROM civicrm_mailing_job WHERE mailing_id = %1', array(