(dev/mail#83) EntityTokens - Allow using mocked data

[totten]

Overview

This updates the wiring for certain token-providers ({contribution.*}, {contribution_recur.*}, etc) to follow a data-mocking pattern available to {contact.*} tokens.

This is a step toward more responsive previewing/experimentation when editing message-templates.

Before

Tokens are generally based on entity-id as input, eg

$proc->addRow([
  'contactId' => 123, 
  'contributionId' => 456, 
]);

The {contact.*} entity allows mocking or overriding specific data values, eg

$proc->addRow([
  'contactId' => 123, 
  'contact' => ['display_name' => 'Fake Name', ...],
  'contributionId' => 456, 
]);

However, this doesn't work with other entities.

After

Any entity based on CRM_Core_EntityTokens will support similar mocking/overriding, eg

$proc->addRow([
  'contactId' => 123, 
  'contact' => ['display_name' => 'Fake Name', ...],
  'contributionId' => 456, 
  'contribution' => ['net_amount' => 3211.23, 'invoice_id' => '888-999', ...],
]);

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[eileenmcnaughton]

Looks like this is a reviewer's commit as it was originally a change I put up - so MOP on that basis + thanks for the test!