Commit | Line | Data |
---|---|---|
6a488035 | 1 | <?php |
c28e1768 CW |
2 | /* |
3 | +--------------------------------------------------------------------+ | |
81621fee | 4 | | CiviCRM version 4.7 | |
c28e1768 | 5 | +--------------------------------------------------------------------+ |
e7112fa7 | 6 | | Copyright CiviCRM LLC (c) 2004-2015 | |
c28e1768 CW |
7 | +--------------------------------------------------------------------+ |
8 | | This file is a part of CiviCRM. | | |
9 | | | | |
10 | | CiviCRM is free software; you can copy, modify, and distribute it | | |
11 | | under the terms of the GNU Affero General Public License | | |
12 | | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. | | |
13 | | | | |
14 | | CiviCRM is distributed in the hope that it will be useful, but | | |
15 | | WITHOUT ANY WARRANTY; without even the implied warranty of | | |
16 | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | | |
17 | | See the GNU Affero General Public License for more details. | | |
18 | | | | |
19 | | You should have received a copy of the GNU Affero General Public | | |
20 | | License and the CiviCRM Licensing Exception along | | |
21 | | with this program; if not, contact CiviCRM LLC | | |
22 | | at info[AT]civicrm[DOT]org. If you have questions about the | | |
23 | | GNU Affero General Public License or the licensing of CiviCRM, | | |
24 | | see the CiviCRM license FAQ at http://civicrm.org/licensing | | |
25 | +--------------------------------------------------------------------+ | |
26 | */ | |
27 | ||
28 | /** | |
29 | * This api exposes CiviCRM option values. | |
244bbdd8 | 30 | * |
c28e1768 CW |
31 | * Values are grouped by "OptionGroup" |
32 | * | |
33 | * @package CiviCRM_APIv3 | |
c28e1768 | 34 | */ |
6a488035 TO |
35 | |
36 | /** | |
9d32e6f7 | 37 | * Retrieve one or more option values. |
6a488035 | 38 | * |
c490a46a | 39 | * @param array $params |
6a488035 | 40 | * |
a6c01b45 | 41 | * @return array |
00f8641b | 42 | * API result array |
6a488035 TO |
43 | */ |
44 | function civicrm_api3_option_value_get($params) { | |
45 | ||
46 | if (empty($params['option_group_id']) && !empty($params['option_group_name'])) { | |
47 | $opt = array('version' => 3, 'name' => $params['option_group_name']); | |
48 | $optionGroup = civicrm_api('OptionGroup', 'Get', $opt); | |
49 | if (empty($optionGroup['id'])) { | |
50 | return civicrm_api3_create_error("option group name does not correlate to a single option group"); | |
51 | } | |
52 | $params['option_group_id'] = $optionGroup['id']; | |
53 | } | |
54 | ||
55 | return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params); | |
56 | } | |
57 | ||
58 | /** | |
9d32e6f7 | 59 | * Add an OptionValue. |
6a488035 | 60 | * |
c490a46a | 61 | * @param array $params |
1fd111c8 EM |
62 | * |
63 | * @throws API_Exception | |
a6c01b45 | 64 | * @return array |
00f8641b | 65 | * API result array |
6a488035 TO |
66 | */ |
67 | function civicrm_api3_option_value_create($params) { | |
c87bbced | 68 | $result = _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), $params); |
89ab5601 PJ |
69 | if (!empty($params['id']) && !array_key_exists('option_group_id', $params)) { |
70 | $groupId = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_OptionValue', | |
71 | $params['id'], 'option_group_id', 'id' | |
72 | ); | |
73 | } | |
74 | else { | |
75 | $groupId = $params['option_group_id']; | |
76 | } | |
77 | ||
78 | civicrm_api('option_value', 'getfields', array('version' => 3, 'cache_clear' => 1, 'option_group_id' => $groupId)); | |
c87bbced | 79 | return $result; |
6a488035 TO |
80 | } |
81 | ||
11e09c59 | 82 | /** |
0aa0303c EM |
83 | * Adjust Metadata for Create action. |
84 | * | |
85 | * The metadata is used for setting defaults, documentation & validation. | |
6a488035 | 86 | * |
cf470720 | 87 | * @param array $params |
b081365f | 88 | * Array of parameters determined by getfields. |
6a488035 TO |
89 | */ |
90 | function _civicrm_api3_option_value_create_spec(&$params) { | |
91 | $params['is_active']['api.default'] = 1; | |
c87bbced | 92 | //continue to support component |
93 | $params['component_id']['api.aliases'] = array('component'); | |
ad0121ed | 94 | // $params['name']['api.aliases'] = array('label'); |
c87bbced | 95 | $params['option_group_id']['api.required'] = TRUE; |
6a488035 TO |
96 | } |
97 | ||
98 | /** | |
9d32e6f7 | 99 | * Deletes an existing option value. |
6a488035 | 100 | * |
cf470720 | 101 | * @param array $params |
6a488035 | 102 | * |
a6c01b45 | 103 | * @return array |
00f8641b | 104 | * API result array |
6a488035 TO |
105 | */ |
106 | function civicrm_api3_option_value_delete($params) { | |
9d32e6f7 | 107 | // We will get the option group id before deleting so we can flush pseudoconstants. |
6a488035 | 108 | $optionGroupID = civicrm_api('option_value', 'getvalue', array('version' => 3, 'id' => $params['id'], 'return' => 'option_group_id')); |
9b873358 | 109 | if (CRM_Core_BAO_OptionValue::del((int) $params['id'])) { |
6a488035 TO |
110 | civicrm_api('option_value', 'getfields', array('version' => 3, 'cache_clear' => 1, 'option_group_id' => $optionGroupID)); |
111 | return civicrm_api3_create_success(); | |
112 | } | |
92e4c2a5 | 113 | else { |
6a488035 TO |
114 | civicrm_api3_create_error('Could not delete OptionValue ' . $params['id']); |
115 | } | |
116 | } |