3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
13 * Test APIv3 civicrm_contribute_* functions
15 * @package CiviCRM_APIv3
16 * @subpackage API_Contribution
19 class CRM_Contribute_Form_Task_PDFLetterCommonTest
extends CiviUnitTestCase
{
21 protected $_individualId;
25 protected $_contactIds;
28 * Count how many times the hookTokens is called.
30 * This only needs to be called once, check refactoring doesn't change this.
34 protected $hookTokensCalled = 0;
36 protected function setUp(): void
{
38 $this->_individualId
= $this->individualCreate(['first_name' => 'Anthony', 'last_name' => 'Collins']);
39 $this->_docTypes
= CRM_Core_SelectValues
::documentApplicationType();
43 * Clean up after each test.
45 * @throws \CRM_Core_Exception
47 public function tearDown(): void
{
48 $this->quickCleanUpFinancialEntities();
49 $this->quickCleanup(['civicrm_uf_match']);
50 CRM_Utils_Hook
::singleton()->reset();
54 * Test thank you send with grouping.
56 * @throws \CRM_Core_Exception
57 * @throws \CiviCRM_API3_Exception
59 public function testGroupedThankYous(): void
{
60 $this->ids
['Contact'][0] = $this->individualCreate();
61 $this->createLoggedInUser();
62 $contribution1ID = $this->callAPISuccess('Contribution', 'create', [
63 'contact_id' => $this->ids
['Contact'][0],
64 'total_amount' => '60',
65 'financial_type_id' => 'Donation',
67 'receive_date' => '2021-01-01 13:21',
69 $contribution2ID = $this->callAPISuccess('Contribution', 'create', [
70 'contact_id' => $this->ids
['Contact'][0],
71 'total_amount' => '70',
72 'financial_type_id' => 'Donation',
73 'receive_date' => '2021-02-01 2:21',
76 $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter', [
80 'paper_size' => 'letter',
81 'orientation' => 'portrait',
83 'margin_left' => '0.75',
84 'margin_right' => '0.75',
85 'margin_top' => '0.75',
86 'margin_bottom' => '0.75',
87 'document_type' => 'pdf',
88 'html_message' => '{contribution.currency} * {contribution.total_amount} * {contribution.receive_date}',
90 'saveTemplateName' => '',
91 'from_email_address' => '185',
92 'thankyou_update' => '1',
93 'group_by' => 'contact_id',
94 'group_by_separator' => 'comma',
95 'email_options' => '',
97 $this->setSearchSelection([$contribution1ID, $contribution2ID], $form);
100 $form->postProcess();
102 catch (CRM_Core_Exception_PrematureExitException
$e) {
103 $this->assertContains('USD, USD * $ 60.00, $ 70.00 * January 1st, 2021 1:21 PM, February 1st, 2021 2:21 AM', $e->errorData
['html']);
108 * Test the buildContributionArray function.
110 * @throws \CRM_Core_Exception|\CiviCRM_API3_Exception
112 public function testBuildContributionArray(): void
{
113 $this->_individualId
= $this->individualCreate();
115 $customGroup = $this->callAPISuccess('CustomGroup', 'create', [
116 'title' => 'Test Custom Set for Contribution',
117 'extends' => 'Contribution',
121 'custom_group_id' => $customGroup['id'],
122 'label' => 'Text field',
123 'html_type' => 'Text',
124 'data_type' => 'String',
128 $customField = $this->callAPISuccess('CustomField', 'create', $params);
129 $customFieldKey = 'custom_' . $customField['id'];
130 $campaignTitle = 'Test Campaign ';
133 'contact_id' => $this->_individualId
,
135 'campaign_id' => $this->campaignCreate(['title' => $campaignTitle], FALSE),
136 'financial_type_id' => 'Donation',
137 $customFieldKey => 'Text_' . substr(sha1(rand()), 0, 7),
139 $contributionIDs = $returnProperties = [];
140 $result = $this->callAPISuccess('Contribution', 'create', $params);
141 $contributionIDs[] = $result['id'];
142 $this->hookClass
->setHook('civicrm_tokenValues', [$this, 'hookTokenValues']);
144 // assume that there are two token {contribution.financial_type} and
145 // {contribution.custom_N} in message content
149 'payment_instrument',
155 [$contributions, $contacts] = CRM_Contribute_Form_Task_PDFLetterCommon
::buildContributionArray('contact_id', $contributionIDs, $returnProperties, TRUE, TRUE, $messageToken, 'test', '**', FALSE);
157 $this->assertEquals('Anthony', $contacts[$this->_individualId
]['first_name']);
158 $this->assertEquals('emo', $contacts[$this->_individualId
]['favourite_emoticon']);
159 $this->assertEquals('Donation', $contributions[$result['id']]['financial_type']);
160 $this->assertEquals($campaignTitle, $contributions[$result['id']]['campaign']);
161 $this->assertEquals('Check', $contributions[$result['id']]['payment_instrument']);
162 // CRM-20359: assert that contribution custom field token is rightfully replaced by its value
163 $this->assertEquals($params[$customFieldKey], $contributions[$result['id']][$customFieldKey]);
165 $this->customFieldDelete($customField['id']);
166 $this->customGroupDelete($customGroup['id']);
170 * Implement token values hook.
172 * @param array $details
173 * @param array $contactIDs
175 * @param array $tokens
176 * @param string $className
178 public function hookTokenValues(&$details, $contactIDs, $jobID, $tokens, $className): void
{
179 foreach ($details as $index => $detail) {
180 $details[$index]['favourite_emoticon'] = 'emo';
185 * Test contribution token replacement in
186 * html returned by postProcess function.
188 * @throws \CiviCRM_API3_Exception
189 * @throws \CRM_Core_Exception
191 public function testPostProcess(): void
{
192 $this->createLoggedInUser();
193 $this->_individualId
= $this->individualCreate();
194 foreach (['docx', 'odt'] as $docType) {
196 'is_unit_test' => TRUE,
199 'name' => __DIR__
. "/sample_documents/Template.$docType",
200 'type' => $this->_docTypes
[$docType],
204 $contributionParams = [
205 'contact_id' => $this->_individualId
,
206 'total_amount' => 100,
207 'financial_type_id' => 'Donation',
209 $contribution = $this->callAPISuccess('Contribution', 'create', $contributionParams);
210 $contributionId = $contribution['id'];
211 /* @var $form CRM_Contribute_Form_Task_PDFLetter */
212 $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter');
213 $form->setContributionIds([$contributionId]);
214 $format = Civi
::settings()->get('dateformatFull');
215 $date = CRM_Utils_Date
::getToday();
216 $displayDate = CRM_Utils_Date
::customFormat($date, $format);
218 $html = CRM_Contribute_Form_Task_PDFLetterCommon
::postProcess($form, $formValues);
224 'Domain Name - Default Domain Name',
227 foreach ($expectedValues as $val) {
228 $this->assertTrue(strpos($html[$contributionId], $val) !== 0);
234 * Test assignment of variables when using the group by function.
236 * We are looking to see that the contribution aggregate and contributions
237 * arrays reflect the most recent contact rather than a total aggregate,
238 * since we are using group by.
240 * @throws \CiviCRM_API3_Exception
241 * @throws \CRM_Core_Exception
243 public function testPostProcessGroupByContact(): void
{
244 $this->createLoggedInUser();
245 $this->hookClass
->setHook('civicrm_tokenValues', [$this, 'hook_aggregateTokenValues']);
246 $this->hookClass
->setHook('civicrm_tokens', [$this, 'hook_tokens']);
247 $this->mut
= new CiviMailUtils($this, TRUE);
248 $this->_individualId
= $this->individualCreate();
249 $this->_individualId2
= $this->individualCreate();
250 $htmlMessage = "{aggregate.rendered_token}";
252 'is_unit_test' => TRUE,
253 'group_by' => 'contact_id',
254 'html_message' => $htmlMessage,
255 'email_options' => 'both',
256 'subject' => 'Testy test test',
257 'from' => 'info@example.com',
260 $contributionIDs = [];
261 $contribution = $this->callAPISuccess('Contribution', 'create', [
262 'contact_id' => $this->_individualId
,
263 'total_amount' => 100,
264 'financial_type_id' => 'Donation',
265 'receive_date' => '2016-12-25',
267 $contributionIDs[] = $contribution['id'];
268 $contribution = $this->callAPISuccess('Contribution', 'create', [
269 'contact_id' => $this->_individualId2
,
270 'total_amount' => 10,
271 'financial_type_id' => 'Donation',
272 'receive_date' => '2016-12-25',
274 $contributionIDs[] = $contribution['id'];
276 $contribution = $this->callAPISuccess('Contribution', 'create', [
277 'contact_id' => $this->_individualId2
,
279 'financial_type_id' => 'Donation',
280 'receive_date' => '2016-12-25',
282 $contributionIDs[] = $contribution['id'];
284 /* @var \CRM_Contribute_Form_Task_PDFLetter $form */
285 $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter');
286 $form->setContributionIds($contributionIDs);
288 $html = CRM_Contribute_Form_Task_PDFLetterCommon
::postProcess($form, $formValues);
289 $this->assertEquals("<table border='1' cellpadding='2' cellspacing='0' class='table'>
294 <th>Financial Type</th>
300 <td>25 December 2016</td>
308 <td><strong>Total</strong></td>
309 <td><strong>$ 100.00</strong></td>
314 </table>", $html[1]);
315 $this->assertEquals("<table border='1' cellpadding='2' cellspacing='0' class='table'>
320 <th>Financial Type</th>
326 <td>25 December 2016</td>
334 <td>25 December 2016</td>
342 <td><strong>Total</strong></td>
343 <td><strong>$ 11.00</strong></td>
348 </table>", $html[2]);
350 $activities = $this->callAPISuccess('Activity', 'get', ['activity_type_id' => 'Print PDF Letter', 'sequential' => 1]);
351 $this->assertEquals(2, $activities['count']);
352 $this->assertEquals($html[1], $activities['values'][0]['details']);
353 $this->assertEquals($html[2], $activities['values'][1]['details']);
354 // Checking it is not called multiple times.
355 // once for each contact create + once for the activities.
356 $this->assertEquals(3, $this->hookTokensCalled
);
357 $this->mut
->checkAllMailLog($html);
362 * Implements civicrm_tokens().
364 public function hook_tokens(&$tokens) {
365 $this->hookTokensCalled++
;
366 $tokens['aggregate'] = ['rendered_token' => 'rendered_token'];
370 * Get the html message.
374 public function getHtmlMessage() {
375 return '{assign var=\'contact_aggregate\' value=0}
376 <table border=\'1\' cellpadding=\'2\' cellspacing=\'0\' class=\'table\'>
381 <th>Financial Type</th>
385 {foreach from=$contributions item=contribution}
386 {if $contribution.contact_id == $messageContactID}
387 {assign var=\'date\' value=$contribution.receive_date|date_format:\'%d %B %Y\'}
388 {assign var=contact_aggregate
389 value=$contact_aggregate+$contribution.total_amount}
393 <td>{$contribution.total_amount|crmMoney}</td>
394 <td>{$contribution.financial_type}</td>
402 <td><strong>Total</strong></td>
403 <td><strong>{$contact_aggregate|crmMoney}</strong></td>
412 * Implements CiviCRM hook.
414 * @param array $values
415 * @param array $contactIDs
417 * @param array $tokens
418 * @param null $context
420 public function hook_aggregateTokenValues(&$values, $contactIDs, $job = NULL, $tokens = [], $context = NULL) {
421 foreach ($contactIDs as $contactID) {
422 CRM_Core_Smarty
::singleton()->assign('messageContactID', $contactID);
423 $values[$contactID]['aggregate.rendered_token'] = CRM_Core_Smarty
::singleton()
424 ->fetch('string:' . $this->getHtmlMessage());
429 * @param string $token
430 * @param string $entity
431 * @param string $textToSearch
432 * @param bool $expected
434 * @dataProvider isHtmlTokenInTableCellProvider
436 public function testIsHtmlTokenInTableCell($token, $entity, $textToSearch, $expected) {
437 $this->assertEquals($expected,
438 CRM_Contribute_Form_Task_PDFLetterCommon
::isHtmlTokenInTableCell($token, $entity, $textToSearch)
442 public function isHtmlTokenInTableCellProvider() {
448 '<td>{entity.token}</td>',
452 'simplest FALSE' => [
459 'token between two tables' => [
462 ' <table><tr><td>Top</td></tr></table>
464 <table><tr><td>Bottom</td></tr></table>',
468 'token in two tables' => [
471 ' <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>
472 <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>',
476 'token outside of table and inside of table' => [
480 <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>',
484 'token inside more complicated table' => [
487 ' <table><tr><td class="foo"><em>{entity.token}</em></td></tr></table>',
491 'token inside something that looks like table cell' => [
494 ' <tdata>{entity.token}</tdata>
495 <table><tr><td>Bottom</td></tr></table>',
503 * @param array $entities
504 * @param \CRM_Core_Form $form
506 protected function setSearchSelection(array $entities, CRM_Core_Form
$form): void
{
507 $_SESSION['_' . $form->controller
->_name
. '_container']['values']['Search'] = [
508 'radio_ts' => 'ts_sel',
510 foreach ($entities as $entityID) {
511 $_SESSION['_' . $form->controller
->_name
. '_container']['values']['Search']['mark_x_' . $entityID] = TRUE;