First commit
This commit is contained in:
commit
c6e2478c40
13918 changed files with 2303184 additions and 0 deletions
435
sites/all/modules/civicrm/api/v3/Setting.php
Normal file
435
sites/all/modules/civicrm/api/v3/Setting.php
Normal file
|
|
@ -0,0 +1,435 @@
|
|||
<?php
|
||||
/*
|
||||
+--------------------------------------------------------------------+
|
||||
| CiviCRM version 4.7 |
|
||||
+--------------------------------------------------------------------+
|
||||
| Copyright CiviCRM LLC (c) 2004-2017 |
|
||||
+--------------------------------------------------------------------+
|
||||
| This file is a part of CiviCRM. |
|
||||
| |
|
||||
| CiviCRM is free software; you can copy, modify, and distribute it |
|
||||
| under the terms of the GNU Affero General Public License |
|
||||
| Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
|
||||
| |
|
||||
| CiviCRM is distributed in the hope that it will be useful, but |
|
||||
| WITHOUT ANY WARRANTY; without even the implied warranty of |
|
||||
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
|
||||
| See the GNU Affero General Public License for more details. |
|
||||
| |
|
||||
| You should have received a copy of the GNU Affero General Public |
|
||||
| License and the CiviCRM Licensing Exception along |
|
||||
| with this program; if not, contact CiviCRM LLC |
|
||||
| at info[AT]civicrm[DOT]org. If you have questions about the |
|
||||
| GNU Affero General Public License or the licensing of CiviCRM, |
|
||||
| see the CiviCRM license FAQ at http://civicrm.org/licensing |
|
||||
+--------------------------------------------------------------------+
|
||||
*/
|
||||
|
||||
/**
|
||||
* This api exposes CiviCRM configuration settings.
|
||||
*
|
||||
* @package CiviCRM_APIv3
|
||||
*/
|
||||
|
||||
/**
|
||||
* Get fields for setting api calls.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
function civicrm_api3_setting_getfields($params) {
|
||||
if (!empty($params['action']) && strtolower($params['action']) == 'getvalue') {
|
||||
$result = array(
|
||||
'name' => array(
|
||||
'title' => 'name of setting field',
|
||||
'api.required' => 1,
|
||||
'type' => CRM_Utils_Type::T_STRING),
|
||||
'group' => array(
|
||||
'api.required' => 0,
|
||||
'title' => 'Setting Group',
|
||||
'description' => 'Settings Group. This is required if the setting is not stored in config',
|
||||
'type' => CRM_Utils_Type::T_STRING),
|
||||
);
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'getfields');
|
||||
}
|
||||
if (!empty($params['name'])) {
|
||||
//am of two minds about special handling for 'name' as opposed to other filters - but is does make most common
|
||||
//usage really easy
|
||||
$params['filters']['name'] = $params['name'];
|
||||
}
|
||||
$result = CRM_Core_BAO_Setting::getSettingSpecification(
|
||||
CRM_Utils_Array::value('component_id', $params),
|
||||
CRM_Utils_Array::value('filters', $params, array()),
|
||||
CRM_Utils_Array::value('domain_id', $params, NULL),
|
||||
CRM_Utils_Array::value('profile', $params, NULL)
|
||||
);
|
||||
// find any supplemental information
|
||||
if (!empty($params['action'])) {
|
||||
$specFunction = '_civicrm_api3_setting_' . strtolower($params['action']) . '_spec';
|
||||
if (function_exists($specFunction)) {
|
||||
$specFunction($result);
|
||||
}
|
||||
}
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'getfields');
|
||||
}
|
||||
|
||||
/**
|
||||
* Alter metadata for getfields functions.
|
||||
*
|
||||
* @param array $params
|
||||
*/
|
||||
function _civicrm_api3_setting_getfields_spec(&$params) {
|
||||
$params['filters'] = array(
|
||||
'title' => 'Filters',
|
||||
'description' => 'Fields you wish to filter by e.g. array("group_name" => "CiviCRM Preferences")',
|
||||
);
|
||||
$params['component_id'] = array(
|
||||
'title' => 'Component ID',
|
||||
'description' => 'ID of relevant component',
|
||||
);
|
||||
$params['profile'] = array(
|
||||
'title' => 'Profile',
|
||||
'description' => 'Profile is passed through to hooks & added to cachestring',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Return default values for settings.
|
||||
*
|
||||
* We will domain key this as it could vary by domain (ie. urls)
|
||||
* as we will be creating the option for a function rather than an value to be in the defaults
|
||||
* Note that is not in place as yet.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
* @throws \CiviCRM_API3_Exception
|
||||
* @throws \Exception
|
||||
*/
|
||||
function civicrm_api3_setting_getdefaults(&$params) {
|
||||
$settings = civicrm_api3('Setting', 'getfields', $params);
|
||||
$domains = _civicrm_api3_setting_getDomainArray($params);
|
||||
$defaults = array();
|
||||
foreach ($domains as $domainID) {
|
||||
$defaults[$domainID] = array();
|
||||
foreach ($settings['values'] as $setting => $spec) {
|
||||
if (array_key_exists('default', $spec) && !is_null($spec['default'])) {
|
||||
$defaults[$domainID][$setting] = $spec['default'];
|
||||
}
|
||||
}
|
||||
}
|
||||
return civicrm_api3_create_success($defaults, $params, 'Setting', 'getfields');
|
||||
}
|
||||
/**
|
||||
* Metadata for Setting create function.
|
||||
*
|
||||
* @param array $params
|
||||
* Parameters as passed to the API.
|
||||
*/
|
||||
function _civicrm_api3_setting_getdefaults_spec(&$params) {
|
||||
$params['domain_id'] = array(
|
||||
'api.default' => 'current_domain',
|
||||
'description' => 'Defaults may differ by domain - if you do not pass in a domain id this will default to the current domain
|
||||
an array or "all" are acceptable values for multiple domains',
|
||||
'title' => 'Setting Domain',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get options for settings.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
* @throws \API_Exception
|
||||
*/
|
||||
function civicrm_api3_setting_getoptions($params) {
|
||||
$specs = CRM_Core_BAO_Setting::getSettingSpecification();
|
||||
|
||||
if (empty($specs[$params['field']]) || empty($specs[$params['field']]['pseudoconstant'])) {
|
||||
throw new API_Exception("The field '" . $params['field'] . "' has no associated option list.");
|
||||
}
|
||||
|
||||
$pseudoconstant = $specs[$params['field']]['pseudoconstant'];
|
||||
|
||||
// It would be nice if we could leverage CRM_Core_PseudoConstant::get() somehow,
|
||||
// but it's tightly coupled to DAO/field. However, if you really need to support
|
||||
// more pseudoconstant types, then probably best to refactor it. For now, KISS.
|
||||
if (!empty($pseudoconstant['callback'])) {
|
||||
$values = Civi\Core\Resolver::singleton()->call($pseudoconstant['callback'], array());
|
||||
return civicrm_api3_create_success($values, $params, 'Setting', 'getoptions');
|
||||
}
|
||||
elseif (!empty($pseudoconstant['optionGroupName'])) {
|
||||
return civicrm_api3_create_success(
|
||||
CRM_Core_OptionGroup::values($pseudoconstant['optionGroupName'], FALSE, FALSE, TRUE),
|
||||
$params, 'Setting', 'getoptions'
|
||||
);
|
||||
}
|
||||
|
||||
throw new API_Exception("The field '" . $params['field'] . "' uses an unsupported option list.");
|
||||
}
|
||||
|
||||
/**
|
||||
* Revert settings to defaults.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
* @throws \Exception
|
||||
*/
|
||||
function civicrm_api3_setting_revert(&$params) {
|
||||
$defaults = civicrm_api('Setting', 'getdefaults', $params);
|
||||
$fields = civicrm_api('Setting', 'getfields', $params);
|
||||
$fields = $fields['values'];
|
||||
$domains = _civicrm_api3_setting_getDomainArray($params);
|
||||
$result = array();
|
||||
foreach ($domains as $domainID) {
|
||||
$valuesToRevert = array_intersect_key($defaults['values'][$domainID], $fields);
|
||||
if (!empty($valuesToRevert)) {
|
||||
$valuesToRevert['version'] = $params['version'];
|
||||
$valuesToRevert['domain_id'] = $domainID;
|
||||
// note that I haven't looked at how the result would appear with multiple domains in play
|
||||
$result = array_merge($result, civicrm_api('Setting', 'create', $valuesToRevert));
|
||||
}
|
||||
}
|
||||
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'revert');
|
||||
}
|
||||
|
||||
/**
|
||||
* Alter metadata for getfields functions.
|
||||
*
|
||||
* @param array $params
|
||||
*/
|
||||
function _civicrm_api3_setting_revert_spec(&$params) {
|
||||
$params['name'] = array(
|
||||
'title' => 'Name',
|
||||
'description' => 'Setting Name belongs to',
|
||||
);
|
||||
$params['component_id'] = array(
|
||||
'title' => 'Component ID',
|
||||
'description' => 'ID of relevant component',
|
||||
);
|
||||
$params['domain_id'] = array(
|
||||
'api.default' => 'current_domain',
|
||||
'description' => 'Defaults may differ by domain - if you do not pass in a domain id this will default to the current domain'
|
||||
. ' an array or "all" are acceptable values for multiple domains',
|
||||
'title' => 'Setting Domain',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Revert settings to defaults.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
* @throws \CiviCRM_API3_Exception
|
||||
* @throws \Exception
|
||||
*/
|
||||
function civicrm_api3_setting_fill(&$params) {
|
||||
$defaults = civicrm_api3('Setting', 'getdefaults', $params);
|
||||
$domains = _civicrm_api3_setting_getDomainArray($params);
|
||||
$result = array();
|
||||
foreach ($domains as $domainID) {
|
||||
$apiArray = array(
|
||||
'version' => $params['version'],
|
||||
'domain_id' => $domainID,
|
||||
);
|
||||
$existing = civicrm_api3('Setting', 'get', $apiArray);
|
||||
$valuesToFill = array_diff_key($defaults['values'][$domainID], $existing['values'][$domainID]);
|
||||
if (!empty($valuesToFill)) {
|
||||
$result = array_merge($result, civicrm_api('Setting', 'create', $valuesToFill + $apiArray));
|
||||
}
|
||||
}
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'fill');
|
||||
}
|
||||
|
||||
/**
|
||||
* Alter metadata for getfields functions.
|
||||
*
|
||||
* @param array $params
|
||||
*/
|
||||
function _civicrm_api3_setting_fill_spec(&$params) {
|
||||
$params['name'] = array(
|
||||
'title' => 'Name',
|
||||
'description' => 'Setting Name belongs to',
|
||||
);
|
||||
$params['component_id'] = array(
|
||||
'title' => 'Component ID',
|
||||
'description' => 'ID of relevant component',
|
||||
);
|
||||
$params['domain_id'] = array(
|
||||
'api.default' => 'current_domain',
|
||||
'title' => 'Setting Domain',
|
||||
'description' => 'Defaults may differ by domain - if you do not pass in a domain id this will default to the '
|
||||
. 'current domain, an array or "all" are acceptable values for multiple domains',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Create or update a setting.
|
||||
*
|
||||
* @param array $params
|
||||
* Parameters as per getfields.
|
||||
*
|
||||
* @return array
|
||||
* api result array
|
||||
*/
|
||||
function civicrm_api3_setting_create($params) {
|
||||
$domains = _civicrm_api3_setting_getDomainArray($params);
|
||||
$result = CRM_Core_BAO_Setting::setItems($params, $domains);
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'create');
|
||||
}
|
||||
|
||||
/**
|
||||
* Metadata for setting create function.
|
||||
*
|
||||
* @param array $params
|
||||
* Parameters as passed to the API.
|
||||
*/
|
||||
function _civicrm_api3_setting_create_spec(&$params) {
|
||||
$params['domain_id'] = array(
|
||||
'api.default' => 'current_domain',
|
||||
'title' => 'Setting Domain',
|
||||
'description' => 'if you do not pass in a domain id this will default to the current domain
|
||||
an array or "all" are acceptable values for multiple domains',
|
||||
);
|
||||
$params['group'] = array(
|
||||
'title' => 'Setting Group',
|
||||
'description' => 'if you know the group defining it will make the api more efficient',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns array of settings matching input parameters.
|
||||
*
|
||||
* @param array $params
|
||||
* Array of one or more valid property_name=>value pairs.
|
||||
*
|
||||
* @return array
|
||||
* Array of matching settings
|
||||
*/
|
||||
function civicrm_api3_setting_get($params) {
|
||||
$domains = _civicrm_api3_setting_getDomainArray($params);
|
||||
$result = $result = CRM_Core_BAO_Setting::getItems($params, $domains, CRM_Utils_Array::value('return', $params, array()));
|
||||
return civicrm_api3_create_success($result, $params, 'Setting', 'get');
|
||||
}
|
||||
/**
|
||||
* Metadata for setting create function.
|
||||
*
|
||||
* @param array $params
|
||||
* Parameters as passed to the API.
|
||||
*/
|
||||
function _civicrm_api3_setting_get_spec(&$params) {
|
||||
$params['domain_id'] = array(
|
||||
'api.default' => 'current_domain',
|
||||
'title' => 'Setting Domain',
|
||||
'description' => 'if you do not pass in a domain id this will default to the current domain',
|
||||
);
|
||||
$params['group'] = array(
|
||||
'title' => 'Setting Group',
|
||||
'description' => 'if you know the group defining it will make the api more efficient',
|
||||
);
|
||||
}
|
||||
/**
|
||||
* Returns value for specific parameter.
|
||||
*
|
||||
* Function requires more fields than 'get' but is intended for
|
||||
* runtime usage & should be quicker
|
||||
*
|
||||
* @param array $params
|
||||
* Array of one or more valid.
|
||||
* property_name=>value pairs.
|
||||
*
|
||||
* @return array
|
||||
* API result array.
|
||||
*/
|
||||
function civicrm_api3_setting_getvalue($params) {
|
||||
//$config = CRM_Core_Config::singleton();
|
||||
//if (isset($config->$params['name'])) {
|
||||
// return $config->$params['name'];
|
||||
//}
|
||||
return CRM_Core_BAO_Setting::getItem(
|
||||
NULL,
|
||||
CRM_Utils_Array::value('name', $params),
|
||||
CRM_Utils_Array::value('component_id', $params),
|
||||
CRM_Utils_Array::value('default_value', $params),
|
||||
CRM_Utils_Array::value('contact_id', $params),
|
||||
CRM_Utils_Array::value('domain_id', $params)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Metadata for setting create function.
|
||||
*
|
||||
* @param array $params
|
||||
* Parameters as passed to the API.
|
||||
*/
|
||||
function _civicrm_api3_setting_getvalue_spec(&$params) {
|
||||
|
||||
$params['group'] = array(
|
||||
'title' => 'Settings Group',
|
||||
'api.required' => TRUE,
|
||||
);
|
||||
$params['name'] = array(
|
||||
'title' => 'Setting Name',
|
||||
'api.aliases' => array('return'),
|
||||
);
|
||||
$params['default_value'] = array(
|
||||
'title' => 'Default Value',
|
||||
);
|
||||
$params['component_id'] = array(
|
||||
'title' => 'Component Id',
|
||||
);
|
||||
$params['contact_id'] = array(
|
||||
'title' => 'Contact Id',
|
||||
);
|
||||
$params['domain_id'] = array(
|
||||
'title' => 'Setting Domain',
|
||||
'description' => 'if you do not pass in a domain id this will default to the current domain',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts domain input into an array.
|
||||
*
|
||||
* If an array is passed in this is used, if 'all' is passed
|
||||
* in this is converted to 'all arrays'
|
||||
*
|
||||
* Really domain_id should always be set but doing an empty check because at the moment
|
||||
* using crm-editable will pass an id & default won't be applied
|
||||
* we did talk about id being a pseudonym for domain_id in this api so applying it here.
|
||||
*
|
||||
* @param array $params
|
||||
*
|
||||
* @return array
|
||||
* @throws \Exception
|
||||
*/
|
||||
function _civicrm_api3_setting_getDomainArray(&$params) {
|
||||
if (empty($params['domain_id']) && isset($params['id'])) {
|
||||
$params['domain_id'] = $params['id'];
|
||||
}
|
||||
|
||||
if ($params['domain_id'] == 'current_domain') {
|
||||
$params['domain_id'] = CRM_Core_Config::domainID();
|
||||
}
|
||||
|
||||
if ($params['domain_id'] == 'all') {
|
||||
$domainAPIResult = civicrm_api('domain', 'get', array('version' => 3, 'return' => 'id'));
|
||||
if (isset($domainAPIResult['values'])) {
|
||||
$params['domain_id'] = array_keys($domainAPIResult['values']);
|
||||
}
|
||||
else {
|
||||
throw new Exception('All domains not retrieved - problem with Domain Get api call ' . $domainAPIResult['error_message']);
|
||||
}
|
||||
}
|
||||
if (is_array($params['domain_id'])) {
|
||||
$domains = $params['domain_id'];
|
||||
}
|
||||
else {
|
||||
$domains = array($params['domain_id']);
|
||||
}
|
||||
return $domains;
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue