dev/financial#79 minimal deprecation of Contribution.transact.

It seems urgent that we so some deprecation of this api - this is the absolute minimum.

More would involve creating some noise when people use it but there
is a separate issue for that. This is just to geet it out of being 'promoted'
by the api explorer

diff --git a/api/v3/Contribution.php b/api/v3/Contribution.php
index bbaf070382b6872b777c1695d6f25335a68b6959..f5b1d94643765f19679881bd72547a8604ddde2d 100644 (file)
--- a/api/v3/Contribution.php
+++ b/api/v3/Contribution.php
@@ -763,3 +763,13 @@ function _civicrm_api3_contribution_repeattransaction_spec(&$params) {
     'type' => CRM_Utils_Type::T_INT,
   ];
 }
+
+/**
+ * Declare deprecated functions.
+ *
+ * @return array
+ *   Array of deprecated actions
+ */
+function _civicrm_api3_contribution_deprecation() {
+  return ['transact' => 'Contribute.transact is ureliable & unsupported - see https://docs.civicrm.org/dev/en/latest/financial/OrderAPI/  for how to move on'];
+}