From: Tim Otten <totten@civicrm.org>
Date: Fri, 24 Feb 2017 06:13:06 +0000 (-0700)
Subject: MailingGroup API - Tighten up deprecations
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=a8b7230d642059581b88083bda8be94715402baa;p=civicrm-core.git

MailingGroup API - Tighten up deprecations

The `MailingGroup.php` includes some very different APIs, e.g.
 * Several 'event'(subscribue/resubscribe) APIs
 * Some CRUD APIs for mailing data

The deprecation applies to the 'event' (subscribe/resubscribe) APIs --
because those can be done another way.  However, the CRUD for `MailingGroup`
records is the only way to do access that data.
---

diff --git a/api/v3/MailingGroup.php b/api/v3/MailingGroup.php
index 0dbac4513f..9a7a6ef67a 100644
--- a/api/v3/MailingGroup.php
+++ b/api/v3/MailingGroup.php
@@ -40,7 +40,13 @@
  *   to indicate this entire api entity is deprecated
  */
 function _civicrm_api3_mailing_group_deprecation() {
-  return 'The MailingGroup api is deprecated. Use the mailing_event apis instead.';
+  $message = 'This action is deprecated. Use the mailing_event API instead.';
+  return array(
+    'event_unsubscribe' => $message,
+    'event_domain_unsubscribe' => $message,
+    'event_resubscribe' => $message,
+    'event_subscribe' => $message,
+  );
 }
 
 /**