tests/phpunit/CRM/Contribute/Form/Task/PDFLetterCommonTest.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   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  +--------------------------------------------------------------------+
  10  */
  11
  12 /**
  13  *  Test APIv3 civicrm_contribute_* functions
  14  *
  15  * @package CiviCRM_APIv3
  16  * @subpackage API_Contribution
  17  * @group headless
  18  */
  19 class CRM_Contribute_Form_Task_PDFLetterCommonTest extends CiviUnitTestCase {
  20
  21   protected $_individualId;
  22
  23   protected $_docTypes;
  24
  25   protected $_contactIds;
  26
  27   /**
  28    * Count how many times the hookTokens is called.
  29    *
  30    * This only needs to be called once, check refactoring doesn't change this.
  31    *
  32    * @var int
  33    */
  34   protected $hookTokensCalled = 0;
  35
  36   protected function setUp(): void {
  37     parent::setUp();
  38     $this->_individualId = $this->individualCreate(['first_name' => 'Anthony', 'last_name' => 'Collins']);
  39     $this->_docTypes = CRM_Core_SelectValues::documentApplicationType();
  40   }
  41
  42   /**
  43    * Clean up after each test.
  44    *
  45    * @throws \CRM_Core_Exception
  46    */
  47   public function tearDown(): void {
  48     $this->quickCleanUpFinancialEntities();
  49     $this->quickCleanup(['civicrm_uf_match']);
  50     CRM_Utils_Hook::singleton()->reset();
  51   }
  52
  53   /**
  54    * Test thank you send with grouping.
  55    *
  56    * @throws \CRM_Core_Exception
  57    * @throws \CiviCRM_API3_Exception
  58    */
  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',
  66       'currency' => 'USD',
  67       'receive_date' => '2021-01-01 13:21',
  68     ])['id'];
  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',
  74       'currency' => 'USD',
  75     ])['id'];
  76     $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter', [
  77       'campaign_id' => '',
  78       'subject' => '',
  79       'format_id' => '',
  80       'paper_size' => 'letter',
  81       'orientation' => 'portrait',
  82       'metric' => 'in',
  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}',
  89       'template' => '',
  90       'saveTemplateName' => '',
  91       'from_email_address' => '185',
  92       'thankyou_update' => '1',
  93       'group_by' => 'contact_id',
  94       'group_by_separator' => 'comma',
  95       'email_options' => '',
  96     ]);
  97     $this->setSearchSelection([$contribution1ID, $contribution2ID], $form);
  98     $form->preProcess();
  99     try {
 100       $form->postProcess();
 101     }
 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']);
 104     }
 105   }
 106
 107   /**
 108    * Test the buildContributionArray function.
 109    *
 110    * @throws \CRM_Core_Exception|\CiviCRM_API3_Exception
 111    */
 112   public function testBuildContributionArray(): void {
 113     $this->_individualId = $this->individualCreate();
 114
 115     $customGroup = $this->callAPISuccess('CustomGroup', 'create', [
 116       'title' => 'Test Custom Set for Contribution',
 117       'extends' => 'Contribution',
 118       'is_active' => TRUE,
 119     ]);
 120     $params = [
 121       'custom_group_id' => $customGroup['id'],
 122       'label' => 'Text field',
 123       'html_type' => 'Text',
 124       'data_type' => 'String',
 125       'weight' => 1,
 126       'is_active' => 1,
 127     ];
 128     $customField = $this->callAPISuccess('CustomField', 'create', $params);
 129     $customFieldKey = 'custom_' . $customField['id'];
 130     $campaignTitle = 'Test Campaign ';
 131
 132     $params = [
 133       'contact_id' => $this->_individualId,
 134       'total_amount' => 6,
 135       'campaign_id' => $this->campaignCreate(['title' => $campaignTitle], FALSE),
 136       'financial_type_id' => 'Donation',
 137       $customFieldKey => 'Text_' . substr(sha1(rand()), 0, 7),
 138     ];
 139     $contributionIDs = $returnProperties = [];
 140     $result = $this->callAPISuccess('Contribution', 'create', $params);
 141     $contributionIDs[] = $result['id'];
 142     $this->hookClass->setHook('civicrm_tokenValues', [$this, 'hookTokenValues']);
 143
 144     // assume that there are two token {contribution.financial_type} and
 145     // {contribution.custom_N} in message content
 146     $messageToken = [
 147       'contribution' => [
 148         'financial_type',
 149         'payment_instrument',
 150         'campaign',
 151         $customFieldKey,
 152       ],
 153     ];
 154
 155     $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter');
 156     [$contributions, $contacts] = $form->buildContributionArray('contact_id', $contributionIDs, $returnProperties, TRUE, TRUE, $messageToken, 'test', '**', FALSE);
 157
 158     $this->assertEquals('Anthony', $contacts[$this->_individualId]['first_name']);
 159     $this->assertEquals('emo', $contacts[$this->_individualId]['favourite_emoticon']);
 160     $this->assertEquals('Donation', $contributions[$result['id']]['financial_type']);
 161     $this->assertEquals($campaignTitle, $contributions[$result['id']]['campaign']);
 162     $this->assertEquals('Check', $contributions[$result['id']]['payment_instrument']);
 163     // CRM-20359: assert that contribution custom field token is rightfully replaced by its value
 164     $this->assertEquals($params[$customFieldKey], $contributions[$result['id']][$customFieldKey]);
 165
 166     $this->customFieldDelete($customField['id']);
 167     $this->customGroupDelete($customGroup['id']);
 168   }
 169
 170   /**
 171    * Implement token values hook.
 172    *
 173    * @param array $details
 174    * @param array $contactIDs
 175    * @param int $jobID
 176    * @param array $tokens
 177    * @param string $className
 178    */
 179   public function hookTokenValues(&$details, $contactIDs, $jobID, $tokens, $className): void {
 180     foreach ($details as $index => $detail) {
 181       $details[$index]['favourite_emoticon'] = 'emo';
 182     }
 183   }
 184
 185   /**
 186    * Test contribution token replacement in
 187    * html returned by postProcess function.
 188    *
 189    * @throws \CiviCRM_API3_Exception
 190    * @throws \CRM_Core_Exception
 191    */
 192   public function testPostProcess(): void {
 193     $this->createLoggedInUser();
 194     $this->_individualId = $this->individualCreate();
 195     foreach (['docx', 'odt'] as $docType) {
 196       $formValues = [
 197         'is_unit_test' => TRUE,
 198         'group_by' => NULL,
 199         'document_file' => [
 200           'name' => __DIR__ . "/sample_documents/Template.$docType",
 201           'type' => $this->_docTypes[$docType],
 202         ],
 203       ];
 204
 205       $contributionParams = [
 206         'contact_id' => $this->_individualId,
 207         'total_amount' => 100,
 208         'financial_type_id' => 'Donation',
 209       ];
 210       $contribution = $this->callAPISuccess('Contribution', 'create', $contributionParams);
 211       $contributionId = $contribution['id'];
 212       /* @var $form CRM_Contribute_Form_Task_PDFLetter */
 213       $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter', $formValues);
 214       $form->setContributionIds([$contributionId]);
 215       $format = Civi::settings()->get('dateformatFull');
 216       $date = CRM_Utils_Date::getToday();
 217       $displayDate = CRM_Utils_Date::customFormat($date, $format);
 218
 219       $html = $form->postProcess();
 220       $expectedValues = [
 221         'Hello Anthony',
 222         '$ 100.00',
 223         $displayDate,
 224         'Donation',
 225         'Domain Name - Default Domain Name',
 226       ];
 227
 228       foreach ($expectedValues as $val) {
 229         $this->assertTrue(strpos($html[$contributionId], $val) !== 0);
 230       }
 231     }
 232   }
 233
 234   /**
 235    * Test assignment of variables when using the group by function.
 236    *
 237    * We are looking to see that the contribution aggregate and contributions
 238    * arrays reflect the most recent contact rather than a total aggregate,
 239    * since we are using group by.
 240    *
 241    * @throws \CiviCRM_API3_Exception
 242    * @throws \CRM_Core_Exception
 243    */
 244   public function testPostProcessGroupByContact(): void {
 245     $this->createLoggedInUser();
 246     $this->hookClass->setHook('civicrm_tokenValues', [$this, 'hook_aggregateTokenValues']);
 247     $this->hookClass->setHook('civicrm_tokens', [$this, 'hook_tokens']);
 248     $this->mut = new CiviMailUtils($this, TRUE);
 249     $this->_individualId = $this->individualCreate();
 250     $this->_individualId2 = $this->individualCreate();
 251     $htmlMessage = "{aggregate.rendered_token}";
 252     $formValues = [
 253       'is_unit_test' => TRUE,
 254       'group_by' => 'contact_id',
 255       'html_message' => $htmlMessage,
 256       'email_options' => 'both',
 257       'subject' => 'Testy test test',
 258       'from' => 'info@example.com',
 259     ];
 260
 261     $contributionIDs = [];
 262     $contribution = $this->callAPISuccess('Contribution', 'create', [
 263       'contact_id' => $this->_individualId,
 264       'total_amount' => 100,
 265       'financial_type_id' => 'Donation',
 266       'receive_date' => '2016-12-25',
 267     ]);
 268     $contributionIDs[] = $contribution['id'];
 269     $contribution = $this->callAPISuccess('Contribution', 'create', [
 270       'contact_id' => $this->_individualId2,
 271       'total_amount' => 10,
 272       'financial_type_id' => 'Donation',
 273       'receive_date' => '2016-12-25',
 274     ]);
 275     $contributionIDs[] = $contribution['id'];
 276
 277     $contribution = $this->callAPISuccess('Contribution', 'create', [
 278       'contact_id' => $this->_individualId2,
 279       'total_amount' => 1,
 280       'financial_type_id' => 'Donation',
 281       'receive_date' => '2016-12-25',
 282     ]);
 283     $contributionIDs[] = $contribution['id'];
 284
 285     /* @var \CRM_Contribute_Form_Task_PDFLetter $form */
 286     $form = $this->getFormObject('CRM_Contribute_Form_Task_PDFLetter', $formValues);
 287     $form->setContributionIds($contributionIDs);
 288
 289     $html = $form->postProcess();
 290     $this->assertEquals("<table border='1' cellpadding='2' cellspacing='0' class='table'>
 291   <tbody>
 292   <tr>
 293     <th>Date</th>
 294     <th>Amount</th>
 295     <th>Financial Type</th>
 296     <th>Source</th>
 297   </tr>
 298   <!--
 299    -->
 300   <tr>
 301     <td>25 December 2016</td>
 302     <td>$ 100.00</td>
 303     <td>Donation</td>
 304     <td></td>
 305   </tr>
 306   <!--
 307     -->
 308   <tr>
 309     <td><strong>Total</strong></td>
 310     <td><strong>$ 100.00</strong></td>
 311     <td></td>
 312     <td></td>
 313   </tr>
 314   </tbody>
 315 </table>", $html[1]);
 316     $this->assertEquals("<table border='1' cellpadding='2' cellspacing='0' class='table'>
 317   <tbody>
 318   <tr>
 319     <th>Date</th>
 320     <th>Amount</th>
 321     <th>Financial Type</th>
 322     <th>Source</th>
 323   </tr>
 324   <!--
 325     -->
 326   <tr>
 327     <td>25 December 2016</td>
 328     <td>$ 10.00</td>
 329     <td>Donation</td>
 330     <td></td>
 331   </tr>
 332   <!--
 333      -->
 334   <tr>
 335     <td>25 December 2016</td>
 336     <td>$ 1.00</td>
 337     <td>Donation</td>
 338     <td></td>
 339   </tr>
 340   <!--
 341   -->
 342   <tr>
 343     <td><strong>Total</strong></td>
 344     <td><strong>$ 11.00</strong></td>
 345     <td></td>
 346     <td></td>
 347   </tr>
 348   </tbody>
 349 </table>", $html[2]);
 350
 351     $activities = $this->callAPISuccess('Activity', 'get', ['activity_type_id' => 'Print PDF Letter', 'sequential' => 1]);
 352     $this->assertEquals(2, $activities['count']);
 353     $this->assertEquals($html[1], $activities['values'][0]['details']);
 354     $this->assertEquals($html[2], $activities['values'][1]['details']);
 355     // Checking it is not called multiple times.
 356     // once for each contact create + once for the activities.
 357     $this->assertEquals(3, $this->hookTokensCalled);
 358     $this->mut->checkAllMailLog($html);
 359
 360   }
 361
 362   /**
 363    * Implements civicrm_tokens().
 364    */
 365   public function hook_tokens(&$tokens) {
 366     $this->hookTokensCalled++;
 367     $tokens['aggregate'] = ['rendered_token' => 'rendered_token'];
 368   }
 369
 370   /**
 371    * Get the html message.
 372    *
 373    * @return string
 374    */
 375   public function getHtmlMessage() {
 376     return '{assign var=\'contact_aggregate\' value=0}
 377 <table border=\'1\' cellpadding=\'2\' cellspacing=\'0\' class=\'table\'>
 378   <tbody>
 379   <tr>
 380     <th>Date</th>
 381     <th>Amount</th>
 382     <th>Financial Type</th>
 383     <th>Source</th>
 384   </tr>
 385   <!--
 386 {foreach from=$contributions item=contribution}
 387  {if $contribution.contact_id == $messageContactID}
 388  {assign var=\'date\' value=$contribution.receive_date|date_format:\'%d %B %Y\'}
 389  {assign var=contact_aggregate
 390 value=$contact_aggregate+$contribution.total_amount}
 391 -->
 392   <tr>
 393     <td>{$date}</td>
 394     <td>{$contribution.total_amount|crmMoney}</td>
 395     <td>{$contribution.financial_type}</td>
 396     <td></td>
 397   </tr>
 398   <!--
 399   {/if}
 400 {/foreach}
 401 -->
 402   <tr>
 403     <td><strong>Total</strong></td>
 404     <td><strong>{$contact_aggregate|crmMoney}</strong></td>
 405     <td></td>
 406     <td></td>
 407   </tr>
 408   </tbody>
 409 </table>';
 410   }
 411
 412   /**
 413    * Implements CiviCRM hook.
 414    *
 415    * @param array $values
 416    * @param array $contactIDs
 417    * @param null $job
 418    * @param array $tokens
 419    * @param null $context
 420    */
 421   public function hook_aggregateTokenValues(&$values, $contactIDs, $job = NULL, $tokens = [], $context = NULL) {
 422     foreach ($contactIDs as $contactID) {
 423       CRM_Core_Smarty::singleton()->assign('messageContactID', $contactID);
 424       $values[$contactID]['aggregate.rendered_token'] = CRM_Core_Smarty::singleton()
 425         ->fetch('string:' . $this->getHtmlMessage());
 426     }
 427   }
 428
 429   /**
 430    * @param string $token
 431    * @param string $entity
 432    * @param string $textToSearch
 433    * @param bool $expected
 434    *
 435    * @dataProvider isHtmlTokenInTableCellProvider
 436    */
 437   public function testIsHtmlTokenInTableCell($token, $entity, $textToSearch, $expected) {
 438     $this->assertEquals($expected,
 439       CRM_Contribute_Form_Task_PDFLetter::isHtmlTokenInTableCell($token, $entity, $textToSearch)
 440     );
 441   }
 442
 443   public function isHtmlTokenInTableCellProvider() {
 444     return [
 445
 446       'simplest TRUE' => [
 447         'token',
 448         'entity',
 449         '<td>{entity.token}</td>',
 450         TRUE,
 451       ],
 452
 453       'simplest FALSE' => [
 454         'token',
 455         'entity',
 456         '{entity.token}',
 457         FALSE,
 458       ],
 459
 460       'token between two tables' => [
 461         'token',
 462         'entity',
 463         ' <table><tr><td>Top</td></tr></table>
 464           {entity.token}
 465           <table><tr><td>Bottom</td></tr></table>',
 466         FALSE,
 467       ],
 468
 469       'token in two tables' => [
 470         'token',
 471         'entity',
 472         ' <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>
 473           <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>',
 474         TRUE,
 475       ],
 476
 477       'token outside of table and inside of table' => [
 478         'token',
 479         'entity',
 480         ' {entity.token}
 481           <table><tr><td>{entity.token}</td></tr><tr><td>foo</td></tr></table>',
 482         FALSE,
 483       ],
 484
 485       'token inside more complicated table' => [
 486         'token',
 487         'entity',
 488         ' <table><tr><td class="foo"><em>{entity.token}</em></td></tr></table>',
 489         TRUE,
 490       ],
 491
 492       'token inside something that looks like table cell' => [
 493         'token',
 494         'entity',
 495         ' <tdata>{entity.token}</tdata>
 496           <table><tr><td>Bottom</td></tr></table>',
 497         FALSE,
 498       ],
 499
 500     ];
 501   }
 502
 503   /**
 504    * @param array $entities
 505    * @param \CRM_Core_Form $form
 506    */
 507   protected function setSearchSelection(array $entities, CRM_Core_Form $form): void {
 508     $_SESSION['_' . $form->controller->_name . '_container']['values']['Search'] = [
 509       'radio_ts' => 'ts_sel',
 510     ];
 511     foreach ($entities as $entityID) {
 512       $_SESSION['_' . $form->controller->_name . '_container']['values']['Search']['mark_x_' . $entityID] = TRUE;
 513     }
 514   }
 515
 516 }