<?php
/*
+--------------------------------------------------------------------+
- | CiviCRM version 4.5 |
+ | CiviCRM version 4.6 |
+--------------------------------------------------------------------+
| Copyright CiviCRM LLC (c) 2004-2014 |
+--------------------------------------------------------------------+
/**
* Get all the mailings and details that a contact was involved with
*
- * @param array $params input parameters
- * - key: contact_id, value: int - required
- * - key: type, value: Delivered | Bounced - optional, defaults to Delivered
- * - Future extensions will include: Opened, Clicked, Forwarded
- *
- * @return array API result
- * @static void
- * @access public
- * @example CRM/Mailing/BAO/Mailing.php
+ * @param array $params
+ * Input parameters - see _spec for details (returned by getfields)
*
+ * @return array
+ * API result
*/
function civicrm_api3_mailing_contact_get($params) {
return civicrm_api3_create_success(_civicrm_api3_mailing_contact_getresults($params, FALSE));
* This is a wrapper for the functions that return the results from the 'quasi-entity'
* mailing contact
* @param array $params
- * @param Boolean $count
+ * @param bool $count
* @throws Exception
*/
-function _civicrm_api3_mailing_contact_getresults($params, $count){
- if(empty($params['type'])){
- //ie. because the api is an anomoly & passing in id is not valid
+function _civicrm_api3_mailing_contact_getresults($params, $count) {
+ if (empty($params['type'])) {
+ //ie. because the api is an anomaly & passing in id is not valid
throw new Exception('This api call does not accept api as a parameter');
}
$options = _civicrm_api3_get_options_from_params($params, TRUE,'contribution','get');
/**
* Adjust Metadata for Get action
*
- * @param array $params array or parameters determined by getfields
+ * @param array $params
+ * Array or parameters determined by getfields.
*/
function _civicrm_api3_mailing_contact_get_spec(&$params) {
$params['contact_id']['api.required'] = 1;
+ $params['contact_id']['title'] = 'Contact ID';
$params['type'] = array(
'api.default' => 'Delivered',
+ 'title' => 'Type',// doesn't really explain the field - but not sure I understand it to explain it better
'type' => CRM_Utils_Type::T_STRING,
'options' => array(
'Delivered' => 'Delivered',
'Bounced' => 'Bounced',
- )
+ ),
);
}
/**
- * @param $type
- * @param $contactID
+ * @param int $contactID
* @param $offset
* @param $limit
* @param $selectFields
* @return array
*/
function _civicrm_api3_mailing_contact_query(
- $type,
$contactID,
$offset,
$limit,
";
$qParams = array(
- 1 => array($contactID, 'Integer')
+ 1 => array($contactID, 'Integer'),
);
$dao = CRM_Core_DAO::executeQuery($sql, $qParams);
- $params = array(
- 'type' => $type,
- 'contact_id' => $contactID
- );
-
$results = $dao->N;
}
else {
$qParams = array(
1 => array($contactID, 'Integer'),
2 => array($offset, 'Integer'),
- 3 => array($limit, 'Integer')
+ 3 => array($limit, 'Integer'),
);
$dao = CRM_Core_DAO::executeQuery($sql, $qParams);
}
/**
- * @param $contactID
+ * @param int $contactID
* @param $offset
* @param $limit
* @param $sort
";
return _civicrm_api3_mailing_contact_query(
- 'Delivered',
$contactID,
$offset,
$limit,
}
/**
- * @param $contactID
+ * @param int $contactID
* @param $offset
* @param $limit
* @param $sort
";
return _civicrm_api3_mailing_contact_query(
- 'Bounced',
$contactID,
$offset,
$limit,
/**
* Get count of all the mailings that a contact was involved with
*
- * @param array $params input parameters
- * - key: contact_id, value: int - required
- * - key: type, value: Delivered | Bounced - optional, defaults to Delivered
- * - Future extensions will include: Opened, Clicked, Forwarded
- *
- * @return array API result
- * @static void
- * @access public
- * @example CRM/Mailing/BAO/Mailing.php
+ * @param array $params
+ * Input parameters per getfields
*
+ * @return array
+ * API result
*/
function civicrm_api3_mailing_contact_getcount($params) {
return _civicrm_api3_mailing_contact_getresults($params, TRUE);