Merge pull request #13345 from GinkgoFJG/generic-settings-form
[civicrm-core.git] / api / v3 / examples / Setting / GetDefaults.php
CommitLineData
6a488035 1<?php
50fb255d 2/**
a828d7b8 3 * Test Generated example demonstrating the Setting.getdefaults API.
50fb255d 4 *
5c49fee0 5 * Gets defaults setting a variable for a given domain - if no domain is set current is assumed.
50fb255d 6 *
7 * @return array
8 * API result array
9 */
10function setting_getdefaults_example() {
11 $params = array(
12 'name' => 'address_format',
13 );
6a488035 14
50fb255d 15 try{
a828d7b8 16 $result = civicrm_api3('Setting', 'getdefaults', $params);
50fb255d 17 }
18 catch (CiviCRM_API3_Exception $e) {
19 // Handle error here.
20 $errorMessage = $e->getMessage();
21 $errorCode = $e->getErrorCode();
22 $errorData = $e->getExtraParams();
23 return array(
1d8ee3d6 24 'is_error' => 1,
25 'error_message' => $errorMessage,
50fb255d 26 'error_code' => $errorCode,
27 'error_data' => $errorData,
28 );
29 }
30
31 return $result;
6a488035
TO
32}
33
fb32de45 34/**
50fb255d 35 * Function returns array of result expected from previous function.
36 *
37 * @return array
38 * API result array
6a488035 39 */
50fb255d 40function setting_getdefaults_expectedresult() {
6a488035 41
53ca8fd7 42 $expectedResult = array(
50fb255d 43 'is_error' => 0,
44 'version' => 3,
45 'count' => 1,
46 'id' => 1,
47 'values' => array(
53ca8fd7 48 '1' => array(
50fb255d 49 'address_format' => '{contact.address_name}
6a488035
TO
50{contact.street_address}
51{contact.supplemental_address_1}
52{contact.supplemental_address_2}
207f62c6 53{contact.supplemental_address_3}
6a488035
TO
54{contact.city}{, }{contact.state_province}{ }{contact.postal_code}
55{contact.country}',
50fb255d 56 ),
6a488035 57 ),
50fb255d 58 );
6a488035 59
fb32de45 60 return $expectedResult;
6a488035
TO
61}
62
a828d7b8 63/*
50fb255d 64* This example has been generated from the API test suite.
a828d7b8
CW
65* The test that created it is called "testGetDefaults"
66* and can be found at:
69d79249 67* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/SettingTest.php
6a488035
TO
68*
69* You can see the outcome of the API tests at
69d79249 70* https://test.civicrm.org/job/CiviCRM-master-git/
6a488035
TO
71*
72* To Learn about the API read
69d79249 73* http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
6a488035 74*
69d79249 75* Browse the api on your own site with the api explorer
41d4d31f 76* http://MYSITE.ORG/path/to/civicrm/api
6a488035
TO
77*
78* Read more about testing here
79* http://wiki.civicrm.org/confluence/display/CRM/Testing
80*
81* API Standards documentation:
82* http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
4ed37178 83*/