dev/core#2817 towards deprecating legacy replaceCaseTokens

[eileenmcnaughton]

Overview

dev/core#2817 towards deprecating legacy

This adds support for the syntax

{case.status_id:label} which what we agreed as a preferred syntax
to disambiguate the demands for labels vs ids vs machine names in
various implementations.

The new (preferred) label is advertised - but the old
one still works

Before

{case.status_id} renders (e.g.) 'Ongoing'
{case.case_type_id} renders (e.g 'Housing Support')

After

The unambiguous versions work & are supported. The ambiguous ones also still work - but in the token processor variant they will render the DB value

{case.status_id} renders (e.g.) 'Ongoing'
{case.status_id:label} renders (e.g.) 'Ongoing'
{case.case_type_id} renders (e.g 'Housing Support')
{case.case_type_id:label} renders (e.g 'Housing Support')

Technical Details

See https://lab.civicrm.org/dev/core/-/issues/2817 for next steps

Comments

[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]

thanks @mattwire