103 lines
3.3 KiB
PHP
103 lines
3.3 KiB
PHP
<?php
|
|
use CRM_TwingleCampaign_ExtensionUtil as E;
|
|
|
|
/**
|
|
* TwingleCampaign.Getsingle API specification (optional)
|
|
* This is used for documentation and validation.
|
|
*
|
|
* @param array $spec description of fields supported by this API call
|
|
*
|
|
* @see https://docs.civicrm.org/dev/en/latest/framework/api-architecture/
|
|
*/
|
|
function _civicrm_api3_twingle_campaign_Getsingle_spec(&$spec) {
|
|
$spec['id'] = [
|
|
'name' => 'id',
|
|
'title' => E::ts('Twingle Campaign ID'),
|
|
'type' => CRM_Utils_Type::T_INT,
|
|
'api.required' => 0,
|
|
'description' => E::ts('The Twingle Campaign ID'),
|
|
];
|
|
|
|
$spec['cid'] = [
|
|
'name' => 'cid',
|
|
'title' => E::ts('Twingle Campaign CID'),
|
|
'type' => CRM_Utils_Type::T_STRING,
|
|
'api.required' => 0,
|
|
'description' => E::ts('A unique identifier for a TwingleCampaign generated by a hashing its id + name'),
|
|
];
|
|
$spec['name'] = [
|
|
'name' => 'name',
|
|
'title' => E::ts('Campaign Name'),
|
|
'type' => CRM_Utils_Type::T_STRING,
|
|
'api.required' => 0,
|
|
'description' => E::ts('Name of the Campaign'),
|
|
];
|
|
$spec['title'] = [
|
|
'name' => 'title',
|
|
'title' => E::ts('Campaign Title'),
|
|
'type' => CRM_Utils_Type::T_STRING,
|
|
'api.required' => 0,
|
|
'description' => E::ts('Title of the Campaign'),
|
|
];
|
|
$spec['start_date'] = [
|
|
'name' => 'start_date',
|
|
'title' => E::ts('Campaign Start Date'),
|
|
'type' => CRM_Utils_Type::T_STRING,
|
|
'api.required' => 0,
|
|
'description' => E::ts('Date and Time that Campaign starts.'),
|
|
];
|
|
$spec['last_modified_id'] = [
|
|
'name' => 'last_modified_id',
|
|
'title' => E::ts('Campaign Modified By'),
|
|
'type' => CRM_Utils_Type::T_INT,
|
|
'api.required' => 0,
|
|
'description' => E::ts('FK ti civicrm_contact, who recently edited this campaign'),
|
|
'FKClassName' => 'CRM_Contact_DAO_Contact',
|
|
];
|
|
$spec['last_modified_date'] = [
|
|
'name' => 'last_modified_date',
|
|
'title' => E::ts('Campaign Modified Date'),
|
|
'type' => CRM_Utils_Type::T_STRING,
|
|
'api.required' => 0,
|
|
'description' => E::ts('FK ti civicrm_contact, who recently edited this campaign'),
|
|
];
|
|
$spec['is_active'] = [
|
|
'name' => 'is_active',
|
|
'title' => E::ts('Campaign is active'),
|
|
'type' => CRM_Utils_Type::T_BOOLEAN,
|
|
'api.required' => 0,
|
|
'description' => E::ts('Is this Campaign enabled or disabled/cancelled?'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* # TwingleCampaign.Getsingle API
|
|
*
|
|
* @param array $params
|
|
*
|
|
* @return array
|
|
* API result descriptor
|
|
*
|
|
* @throws \CiviCRM_API3_Exception
|
|
* @see civicrm_api3_create_success
|
|
*
|
|
*/
|
|
function civicrm_api3_twingle_campaign_Getsingle(array $params): array {
|
|
|
|
// filter parameters
|
|
$allowed_params = [];
|
|
_civicrm_api3_twingle_campaign_Getsingle_spec($allowed_params);
|
|
$params = array_intersect_key($params, $allowed_params);
|
|
|
|
// Get TwingleCampaign by provided parameters
|
|
$returnValues = civicrm_api3('TwingleCampaign', 'get', $params);
|
|
$count = $returnValues['count'];
|
|
|
|
// Check whether only a single TwingleCampaign is found
|
|
if ($count != 1) {
|
|
return civicrm_api3_create_error(
|
|
"Expected one TwingleCampaign but found $count"
|
|
);
|
|
}
|
|
return $returnValues['values'][$returnValues['id']];
|
|
}
|