Add noisy deprecation warning to Contribution.transact

[eileenmcnaughton]

Overview

Add a deprecation notice when people use the broken Contribution.transact api.

The Order api has been the recommended api for several years & was adopted over a year ago by by the wordpress integration - the bottom of this page contains instructions for getting off it https://docs.civicrm.org/dev/en/latest/financial/OrderAPI/

Currently it IS broken and while it's possible to install an extension to fix it we should strongly discourage people from using it.

Before

No warning that it is unsupported & broken

After

Warning

Technical Details

Comments

@colemanw since you merged the PR allowing people to override it please merge this

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

See #15504

[KarinG]

Getting a 404 on https://docs.civicrm.org/dev/en/latest/financial/OrderAPI/

[mattwire]

@KarinG It should be https://docs.civicrm.org/dev/en/latest/financial/orderAPI/

[KarinG]

So you'll be updating the deprecation notice then to the correct URL?