3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
14 * APIv3 functions for registering/processing mailing group events.
16 * @package CiviCRM_APIv3
20 * Subscribe from mailing group.
22 * @param array $params
23 * Array per getfields metadata.
25 * @throws API_Exception
29 function civicrm_api3_mailing_event_subscribe_create($params) {
30 $email = $params['email'];
31 $group_id = $params['group_id'];
32 $contact_id = CRM_Utils_Array
::value('contact_id', $params);
34 $group = new CRM_Contact_DAO_Group();
35 $group->is_active
= 1;
36 $group->id
= (int) $group_id;
37 if (!$group->find(TRUE)) {
38 throw new API_Exception('Invalid Group id');
41 $subscribe = CRM_Mailing_Event_BAO_Subscribe
::subscribe($group_id, $email, $contact_id);
43 if ($subscribe !== NULL) {
44 /* Ask the contact for confirmation */
46 $subscribe->send_confirm_request($email);
49 $values[$subscribe->id
]['contact_id'] = $subscribe->contact_id
;
50 $values[$subscribe->id
]['subscribe_id'] = $subscribe->id
;
51 $values[$subscribe->id
]['hash'] = $subscribe->hash
;
53 return civicrm_api3_create_success($values);
55 return civicrm_api3_create_error('Subscription failed');
59 * Adjust Metadata for Create action.
61 * The metadata is used for setting defaults, documentation & validation.
63 * @param array $params
64 * Array of parameters determined by getfields.
66 function _civicrm_api3_mailing_event_subscribe_create_spec(&$params) {
69 'title' => 'Unsubscribe Email',
70 'type' => CRM_Utils_Type
::T_STRING
,
72 $params['group_id'] = [
74 'title' => 'Unsubscribe From Group',
75 'type' => CRM_Utils_Type
::T_INT
,