- /**
- * Class constructor.
- */
- public function __construct() {
- $this->entityFieldMetadata = CRM_Contribute_DAO_Contribution::fields();
- $tokens = CRM_Utils_Array::subset(
- CRM_Utils_Array::collect('title', $this->entityFieldMetadata),
- $this->getPassthruTokens()
- );
- $tokens['id'] = ts('Contribution ID');
- $tokens['payment_instrument'] = ts('Payment Instrument');
- $tokens['source'] = ts('Contribution Source');
- // Per https://lab.civicrm.org/dev/core/-/issues/2650
- // the intent is to deprecate this field in favour of
- // {contribution.contribution_status_id:label}
- $tokens['status'] = ts('Contribution Status');
- $tokens['type'] = ts('Financial Type');
- $tokens = array_merge($tokens, $this->getPseudoTokens(), CRM_Utils_Token::getCustomFieldTokens('Contribution'));
- parent::__construct('contribution', $tokens);
- }
-
- /**
- * Check if the token processor is active.
- *
- * @param \Civi\Token\TokenProcessor $processor
- *
- * @return bool
- */
- public function checkActive(TokenProcessor $processor) {
- return !empty($processor->context['actionMapping'])
- && $processor->context['actionMapping']->getEntity() === 'civicrm_contribution';
- }
-
- /**
- * Alter action schedule query.
- *
- * @param \Civi\ActionSchedule\Event\MailingQueryEvent $e
- */
- public function alterActionScheduleQuery(MailingQueryEvent $e): void {
- if ($e->mapping->getEntity() !== 'civicrm_contribution') {
- return;
- }
-
- $fields = CRM_Contribute_DAO_Contribution::fields();
- foreach ($this->getPassthruTokens() as $token) {
- $e->query->select("e." . $fields[$token]['name'] . " AS contrib_{$token}");
- }
- foreach (array_keys($this->getPseudoTokens()) as $token) {
- $split = explode(':', $token);
- $e->query->select("e." . $fields[$split[0]]['name'] . " AS contrib_{$split[0]}");
- }
- foreach ($this->getAliasTokens() as $alias => $orig) {
- $e->query->select('e.' . $fields[$orig]['name'] . " AS contrib_{$alias}");
- }
- }
-
- /**
- * @inheritDoc
- */
- public function evaluateToken(TokenRow $row, $entity, $field, $prefetch = NULL) {
- $actionSearchResult = $row->context['actionSearchResult'];
- $fieldValue = $actionSearchResult->{"contrib_$field"} ?? NULL;
-
- $aliasTokens = $this->getAliasTokens();
- if (in_array($field, ['total_amount', 'fee_amount', 'net_amount'])) {
- return $row->format('text/plain')->tokens($entity, $field,
- \CRM_Utils_Money::format($fieldValue, $actionSearchResult->contrib_currency));
- }
- if (isset($aliasTokens[$field])) {
- $row->dbToken($entity, $field, 'CRM_Contribute_BAO_Contribution', $aliasTokens[$field], $fieldValue);
- }
- elseif ($cfID = \CRM_Core_BAO_CustomField::getKeyID($field)) {
- $row->customToken($entity, $cfID, $actionSearchResult->entity_id);
- }
- elseif (array_key_exists($field, $this->getPseudoTokens())) {
- $split = explode(':', $field);
- $row->tokens($entity, $field, $this->getPseudoValue($split[0], $split[1], $actionSearchResult->{"contrib_$split[0]"} ?? NULL));
- }
- elseif (in_array($field, array_keys($this->getBasicTokens()))) {
- // For now we just ensure that the label fields do not override the
- // id field here.
- // Later we will add support for contribution_status_id:label
- $row->tokens($entity, $field, $fieldValue);
- }
- else {
- $row->dbToken($entity, $field, 'CRM_Contribute_BAO_Contribution', $field, $fieldValue);
- }
- }
-
- /**
- * Get the value for the relevant pseudo field.
- *
- * @param string $realField e.g contribution_status_id
- * @param string $pseudoKey e.g name
- * @param int|string $fieldValue e.g 1
- *
- * @return string
- * Eg. 'Completed' in the example above.
- *
- * @internal function will likely be protected soon.
- */
- public function getPseudoValue(string $realField, string $pseudoKey, $fieldValue): string {
- if ($pseudoKey === 'name') {
- $fieldValue = (string) CRM_Core_PseudoConstant::getName($this->getBAOName(), $realField, $fieldValue);
- }
- if ($pseudoKey === 'label') {
- $fieldValue = (string) CRM_Core_PseudoConstant::getLabel($this->getBAOName(), $realField, $fieldValue);
- }
- return (string) $fieldValue;
- }
-