🔖 Version 1.0.0-beta
This commit is contained in:
parent
c93a06972b
commit
460a811554
GPG key ID:
12406554CFB028B9
26 changed files with 2480 additions and 771 deletions
|
|
@ -2,6 +2,7 @@
|
|||
|
||||
use Civi\Mailinglistsync\ADGroupMailingList;
|
||||
use Civi\Mailinglistsync\Exceptions\MailinglistException;
|
||||
use Civi\Mailinglistsync\MailingListSettings;
|
||||
use CRM_Mailinglistsync_ExtensionUtil as E;
|
||||
|
||||
/**
|
||||
|
|
@ -14,31 +15,31 @@ use CRM_Mailinglistsync_ExtensionUtil as E;
|
|||
*/
|
||||
function _civicrm_api3_mailinglistsync_Adgroupsync_spec(&$spec) {
|
||||
$spec['sid'] = [
|
||||
'api.required' => 1,
|
||||
'api.required' => 0,
|
||||
'type' => CRM_Utils_Type::T_STRING,
|
||||
'title' => E::ts('Active Directory SID'),
|
||||
'description' => E::ts('The Active Directory SID of the group'),
|
||||
];
|
||||
$spec['email'] = [
|
||||
'api.required' => 1,
|
||||
'api.required' => 0,
|
||||
'type' => CRM_Utils_Type::T_EMAIL,
|
||||
'title' => 'Email Address',
|
||||
'description' => 'Email address of the mailing list',
|
||||
];
|
||||
$spec['recipients'] = [
|
||||
'api.required' => 1,
|
||||
'api.required' => 0,
|
||||
'type' => CRM_Utils_Type::T_STRING,
|
||||
'title' => E::ts('Recipients'),
|
||||
'description' => E::ts('Array of email addresses and SIDs'),
|
||||
];
|
||||
$spec['name'] = [
|
||||
'api.required' => 1,
|
||||
'api.required' => 0,
|
||||
'type' => CRM_Utils_Type::T_STRING,
|
||||
'title' => E::ts('Mail List Name'),
|
||||
'description' => E::ts('Name of the mailing list'),
|
||||
];
|
||||
$spec['description'] = [
|
||||
'api.required' => 1,
|
||||
'api.required' => 0,
|
||||
'type' => CRM_Utils_Type::T_LONGTEXT,
|
||||
'title' => E::ts('Mail List Description'),
|
||||
'description' => E::ts('Description of the mailing list'),
|
||||
|
|
@ -58,123 +59,180 @@ function _civicrm_api3_mailinglistsync_Adgroupsync_spec(&$spec) {
|
|||
* @see civicrm_api3_create_success
|
||||
*/
|
||||
function civicrm_api3_mailinglistsync_Adgroupsync($params) {
|
||||
|
||||
// Filter illegal params
|
||||
$allowed_params = [];
|
||||
_civicrm_api3_mailinglistsync_Adgroupsync_spec($allowed_params);
|
||||
$params = array_intersect_key($params, $allowed_params);
|
||||
|
||||
// Prepare result array
|
||||
$result = [
|
||||
'sid' => $params['sid'],
|
||||
'email' => $params['email'],
|
||||
'name' => $params['name'],
|
||||
'description' => $params['description'],
|
||||
'group_created' => FALSE,
|
||||
'group_updated' => FALSE,
|
||||
];
|
||||
// Check if the mailing list sync is enabled
|
||||
$enabled = (bool) MailingListSettings::get('enable');
|
||||
if (!$enabled) {
|
||||
return civicrm_api3_create_success(
|
||||
['message' => 'Mailing list sync is disabled'], [], 'Mailinglist', 'Adgroupsync'
|
||||
);
|
||||
}
|
||||
|
||||
try {
|
||||
// Try to get mailing list by SID
|
||||
$adGroupMailingList = ADGroupMailingList::getBySID($params['sid']);
|
||||
// Validate params
|
||||
|
||||
// If no AD group mailing list found, create new
|
||||
if (!$adGroupMailingList) {
|
||||
// Decode recipients JSON if it's a string
|
||||
if (!empty($params['recipients'])) {
|
||||
if (is_string($params['recipients'])) {
|
||||
try {
|
||||
$adGroupMailingList = ADGroupMailingList::createGroup(
|
||||
title: $params['name'],
|
||||
description: $params['description'],
|
||||
email: $params['email'],
|
||||
sid: $params['sid'],
|
||||
);
|
||||
$result['group_created']['group_id'] = $adGroupMailingList->getId();
|
||||
$result['group_created']['is_error'] = FALSE;
|
||||
$params['recipients'] = json_decode($params['recipients'], TRUE);
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group_created']['is_error'] = TRUE;
|
||||
catch (Exception $e) {
|
||||
return civicrm_api3_create_error(
|
||||
'Failed to decode recipients JSON',
|
||||
[
|
||||
'params' => $params,
|
||||
'entity' => 'Mailinglistsync',
|
||||
'action' => 'Adgroupsync',
|
||||
]);
|
||||
}
|
||||
}
|
||||
// Throw error if recipients is not an array
|
||||
if (!is_array($params['recipients'])) {
|
||||
return civicrm_api3_create_error(
|
||||
'Recipients must be an array',
|
||||
[
|
||||
'params' => $params,
|
||||
'entity' => 'Mailinglistsync',
|
||||
'action' => 'Adgroupsync',
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
// Sync AD group mailing list values
|
||||
else {
|
||||
if ($adGroupMailingList->getTitle() !== $params['name']) {
|
||||
try {
|
||||
$adGroupMailingList->updateGroupTitle($params['name']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' title from '{$adGroupMailingList->getTitle()}' to '{$params['name']}'"
|
||||
);
|
||||
$result['group_updated']['title'] = [
|
||||
'is_error' => FALSE,
|
||||
'old' => $adGroupMailingList->getTitle(),
|
||||
'new' => $params['name'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group_updated']['title'] = [
|
||||
'is_error' => TRUE,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
if ($adGroupMailingList->getGroupDescription() !== $params['description']) {
|
||||
try {
|
||||
$adGroupMailingList->updateGroupDescription($params['description']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' description.'"
|
||||
);
|
||||
$result['group_updated']['description'] = [
|
||||
'is_error' => FALSE,
|
||||
'old' => $adGroupMailingList->getGroupDescription(),
|
||||
'new' => $params['description'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group_updated']['description'] = [
|
||||
'is_error' => TRUE,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
if ($adGroupMailingList->getEmailAddress() !== $params['email']) {
|
||||
try {
|
||||
$adGroupMailingList->updateEmailAddress($params['email']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' email address from '{$adGroupMailingList->getEmailAddress()}' to '{$params['email']}'"
|
||||
);
|
||||
$result['group_updated']['email'] = [
|
||||
'is_error' => FALSE,
|
||||
'old' => $adGroupMailingList->getEmailAddress(),
|
||||
'new' => $params['email'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group_updated']['email'] = [
|
||||
'is_error' => TRUE,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
$adGroupMailingList->save();
|
||||
// If group is updated
|
||||
if (
|
||||
!empty($params['sid']) &&
|
||||
!empty($params['email']) &&
|
||||
!empty($params['name'])
|
||||
) {
|
||||
// Prepare result array
|
||||
$result = [
|
||||
'group' =>
|
||||
[
|
||||
'sid' => $params['sid'],
|
||||
'email' => $params['email'],
|
||||
'name' => $params['name'],
|
||||
'description' => $params['description'] ?? '',
|
||||
'created' => FALSE,
|
||||
'updated' => FALSE,
|
||||
],
|
||||
];
|
||||
|
||||
if ($result['group_updated'] ?? FALSE) {
|
||||
$result['group_updated']['error_count'] = count(array_filter($result['group_updated'], fn($v) => $v['is_error']));
|
||||
$result['group_updated']['is_error'] = $result['group_updated']['error_count'] > 0;
|
||||
$result['group_updated']['group_id'] = $adGroupMailingList->getId();
|
||||
try {
|
||||
// Try to get mailing list by SID
|
||||
$adGroupMailingList = ADGroupMailingList::getBySID($params['sid']);
|
||||
|
||||
// If no AD group mailing list found, create new
|
||||
if (!$adGroupMailingList) {
|
||||
try {
|
||||
$adGroupMailingList = ADGroupMailingList::createGroup(
|
||||
title: $params['name'],
|
||||
email: $params['email'],
|
||||
description: $params['description'],
|
||||
sid: $params['sid'],
|
||||
);
|
||||
$result['group']['created']['group_id'] = $adGroupMailingList->getId();
|
||||
$result['group']['created']['is_error'] = 0;
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group']['created']['is_error'] = 1;
|
||||
}
|
||||
}
|
||||
|
||||
// Sync AD group mailing list values
|
||||
else {
|
||||
if ($adGroupMailingList->getTitle() !== $params['name']) {
|
||||
try {
|
||||
$adGroupMailingList->updateGroupTitle($params['name']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' title from '{$adGroupMailingList->getTitle()}' to '{$params['name']}'"
|
||||
);
|
||||
$result['group']['updated']['title'] = [
|
||||
'is_error' => 0,
|
||||
'old' => $adGroupMailingList->getTitle(),
|
||||
'new' => $params['name'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group']['updated']['title'] = [
|
||||
'is_error' => 1,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
if ($adGroupMailingList->getGroupDescription() !== ($params['description'] ?? '')) {
|
||||
try {
|
||||
$adGroupMailingList->updateGroupDescription($params['description']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' description.'"
|
||||
);
|
||||
$result['group']['updated']['description'] = [
|
||||
'is_error' => 0,
|
||||
'old' => $adGroupMailingList->getGroupDescription(),
|
||||
'new' => $params['description'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group']['updated']['description'] = [
|
||||
'is_error' => 1,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
if ($adGroupMailingList->getEmailAddress() !== $params['email']) {
|
||||
try {
|
||||
$adGroupMailingList->updateEmailAddress($params['email']);
|
||||
\Civi::log(E::LONG_NAME)->info(
|
||||
"Updated group '{$adGroupMailingList->getId()}' email address from '{$adGroupMailingList->getEmailAddress()}' to '{$params['email']}'"
|
||||
);
|
||||
$result['group']['updated']['email'] = [
|
||||
'is_error' => 0,
|
||||
'old' => $adGroupMailingList->getEmailAddress(),
|
||||
'new' => $params['email'],
|
||||
];
|
||||
}
|
||||
catch (MailinglistException $e) {
|
||||
\Civi::log(E::LONG_NAME)->error($e->getLogMessage());
|
||||
$result['group']['updated']['email'] = [
|
||||
'is_error' => 1,
|
||||
'error' => $e->getLogMessage(),
|
||||
];
|
||||
}
|
||||
}
|
||||
$adGroupMailingList->save();
|
||||
|
||||
if ($result['group']['updated'] ?? FALSE) {
|
||||
$result['group']['updated']['error_count'] = count(array_filter($result['group']['updated'], fn($v) => $v['is_error']));
|
||||
$result['group']['updated']['is_error'] = (int) ($result['group']['updated']['error_count'] > 0);
|
||||
}
|
||||
$result['group']['group_id'] = $adGroupMailingList->getId();
|
||||
}
|
||||
}
|
||||
catch (MailinglistException $me) {
|
||||
\Civi::log(E::LONG_NAME)->error($me->getLogMessage());
|
||||
return civicrm_api3_create_error($me->getLogMessage(),
|
||||
[
|
||||
'values' => $result,
|
||||
'params' => $params,
|
||||
'entity' => 'Mailinglistsync',
|
||||
'action' => 'Adgroupsync',
|
||||
]);
|
||||
}
|
||||
|
||||
// Sync group mailing list members
|
||||
$result['recipients_updated'] = $adGroupMailingList->syncRecipients($params['recipients']);
|
||||
$result['recipients'] = $adGroupMailingList->syncRecipients($params['recipients']);
|
||||
|
||||
// Return error response if any errors occurred
|
||||
$totalErrors = (int) ($result['group_created']['is_error'] ?? 0)
|
||||
+ ($result['group_updated']['error_count'] ?? 0)
|
||||
+ ($result['recipients_updated']['error_count'] ?? 0);
|
||||
$result['is_error'] = $totalErrors > 0;
|
||||
$totalErrors = (int) ($result['group']['created']['is_error'] ?? 0)
|
||||
+ ($result['group']['updated']['error_count'] ?? 0)
|
||||
+ ($result['recipients']['error_count'] ?? 0);
|
||||
$result['is_error'] = (int) ($totalErrors > 0);
|
||||
$result['error_count'] = $totalErrors;
|
||||
if ($totalErrors > 0) {
|
||||
return civicrm_api3_create_error(
|
||||
|
|
@ -185,15 +243,45 @@ function civicrm_api3_mailinglistsync_Adgroupsync($params) {
|
|||
'entity' => 'Mailinglistsync',
|
||||
'action' => 'Adgroupsync',
|
||||
]);
|
||||
|
||||
}
|
||||
|
||||
// Else return success response
|
||||
return civicrm_api3_create_success($result, $params, 'Mailinglistsync', 'Adgroupsync');
|
||||
}
|
||||
catch (MailinglistException $me) {
|
||||
\Civi::log(E::LONG_NAME)->error($me->getLogMessage());
|
||||
return civicrm_api3_create_error($me->getLogMessage(),
|
||||
|
||||
// If only recipients are updated
|
||||
elseif (
|
||||
!empty($params['recipients']) &&
|
||||
empty($params['sid']) &&
|
||||
empty($params['email']) &&
|
||||
empty($params['name']) &&
|
||||
empty($params['description'])
|
||||
) {
|
||||
$result = [];
|
||||
|
||||
// Update recipients
|
||||
$result['recipients'] = ADGroupMailingList::syncContacts($params['recipients']);
|
||||
|
||||
// Return error response if any errors occurred
|
||||
$totalErrors = $result['recipients']['error_count'] ?? 0;
|
||||
$result['count'] = $result['recipients']['count'] ?? 0;
|
||||
$result['is_error'] = (int) ($totalErrors > 0);
|
||||
$result['error_count'] = $totalErrors;
|
||||
if ($totalErrors > 0) {
|
||||
return civicrm_api3_create_error(
|
||||
"Failed to sync recipients. $totalErrors errors occurred.",
|
||||
[
|
||||
'values' => $result,
|
||||
'params' => $params,
|
||||
'entity' => 'Mailinglistsync',
|
||||
'action' => 'Adgroupsync',
|
||||
]);
|
||||
}
|
||||
// Else return success response
|
||||
return civicrm_api3_create_success($result ? $result['count'] : [], $params, 'Mailinglistsync', 'Adgroupsync');
|
||||
}
|
||||
else {
|
||||
return civicrm_api3_create_error(
|
||||
'Missing required parameters',
|
||||
[
|
||||
'params' => $params,
|
||||
'entity' => 'Mailinglistsync',
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue