Merge pull request #4893 from colemanw/INFRA-132
[civicrm-core.git] / api / v3 / MailSettings.php
1 <?php
2
3 /*
4 +--------------------------------------------------------------------+
5 | CiviCRM version 4.6 |
6 +--------------------------------------------------------------------+
7 | Copyright CiviCRM LLC (c) 2004-2014 |
8 +--------------------------------------------------------------------+
9 | This file is a part of CiviCRM. |
10 | |
11 | CiviCRM is free software; you can copy, modify, and distribute it |
12 | under the terms of the GNU Affero General Public License |
13 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | |
15 | CiviCRM is distributed in the hope that it will be useful, but |
16 | WITHOUT ANY WARRANTY; without even the implied warranty of |
17 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
18 | See the GNU Affero General Public License for more details. |
19 | |
20 | You should have received a copy of the GNU Affero General Public |
21 | License and the CiviCRM Licensing Exception along |
22 | with this program; if not, contact CiviCRM LLC |
23 | at info[AT]civicrm[DOT]org. If you have questions about the |
24 | GNU Affero General Public License or the licensing of CiviCRM, |
25 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
26 +--------------------------------------------------------------------+
27 */
28
29 /**
30 * File for the CiviCRM APIv3 group functions
31 *
32 * @package CiviCRM_APIv3
33 * @subpackage API_mail_settings
34 * @copyright CiviCRM LLC (c) 2004-2014
35 */
36
37 /**
38 * Create or update a mail_settings
39 *
40 * @param array $params
41 * Associative array of property.
42 * name/value pairs to insert in new 'mail_settings'
43 * @example mail_settingsCreate.php Std Create example
44 *
45 * @return array
46 * api result array
47 * {@getfields mail_settings_create}
48 * @access public
49 */
50 function civicrm_api3_mail_settings_create($params) {
51 return _civicrm_api3_basic_create(_civicrm_api3_get_BAO(__FUNCTION__), $params);
52 }
53
54 /**
55 * Adjust Metadata for Create action
56 *
57 * The metadata is used for setting defaults, documentation & validation
58 * @param array $params
59 * Array or parameters determined by getfields.
60 */
61 function _civicrm_api3_mail_settings_create_spec(&$params) {
62
63 }
64
65 /**
66 * Returns array of mail_settings matching a set of one or more group properties
67 *
68 * @param array $params
69 * Array of one or more valid.
70 * property_name=>value pairs. If $params is set
71 * as null, all mail_settings will be returned
72 *
73 * @return array
74 * Array of matching mail_settings
75 * {@getfields mail_settings_get}
76 * @access public
77 */
78 function civicrm_api3_mail_settings_get($params) {
79 return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params);
80 }
81
82 /**
83 * delete an existing mail_settings
84 *
85 * This method is used to delete any existing mail_settings. id of the group
86 * to be deleted is required field in $params array
87 *
88 * @param array $params
89 * Array containing id of the group.
90 * to be deleted
91 *
92 * @return array
93 * api result array
94 * {@getfields mail_settings_delete}
95 * @access public
96 */
97 function civicrm_api3_mail_settings_delete($params) {
98 return _civicrm_api3_basic_delete(_civicrm_api3_get_BAO(__FUNCTION__), $params);
99 }
100