Merge pull request #8616 from totten/coldrunKacper-ignore-components-in-disabled...
[civicrm-core.git] / tests / templates / documentFunction.tpl
CommitLineData
6a488035 1{literal}<?php{/literal}
0c13f046 2/**
a828d7b8 3 * Test Generated example demonstrating the {$entity}.{$action} API.
0c13f046 4 *
a6ec24c4
CW
5{if !empty($result.deprecated) && is_string($result.deprecated)}
6 * @deprecated
7 * {$result.deprecated}
8{if !$description}
9 *
10{/if}
11{/if}
0c13f046 12{if $description}
5c49fee0
CW
13{foreach from=$description item='line'}
14 * {$line}
15{/foreach}
947a37b4 16 *
7aaa05d2 17{/if}
0c13f046
EM
18 * @return array
19 * API result array
6a488035 20 */
0c13f046
EM
21function {$function}_example() {literal}{{/literal}
22 $params = {$params|@print_array};
947a37b4 23{literal}
0c13f046 24 try{{/literal}
a828d7b8 25 $result = civicrm_api3('{$entity}', '{$action}', $params);
0c13f046
EM
26{literal} }
27 catch (CiviCRM_API3_Exception $e) {
28 // Handle error here.
29 $errorMessage = $e->getMessage();
30 $errorCode = $e->getErrorCode();
31 $errorData = $e->getExtraParams();
32 return array(
b5541920
MM
33 'is_error' => 1,
34 'error_message' => $errorMessage,
0c13f046
EM
35 'error_code' => $errorCode,
36 'error_data' => $errorData,
37 );
38 }{/literal}
947a37b4 39
0c13f046 40 return $result;
6a488035
TO
41{literal}}{/literal}
42
947a37b4 43/**
0c13f046
EM
44 * Function returns array of result expected from previous function.
45 *
46 * @return array
47 * API result array
6a488035 48 */
0c13f046 49function {$function}_expectedresult() {literal}{{/literal}
6a488035
TO
50
51 $expectedResult = {$result|@print_array};
52
947a37b4 53 return $expectedResult;
6a488035
TO
54{literal}}{/literal}
55
a828d7b8 56/*
0c13f046 57* This example has been generated from the API test suite.
a828d7b8
CW
58* The test that created it is called "{$testFunction}"
59* and can be found at:
60* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/{$testFile}
6a488035
TO
61*
62* You can see the outcome of the API tests at
3ec6e38d 63* https://test.civicrm.org/job/CiviCRM-master-git/
6a488035
TO
64*
65* To Learn about the API read
3ec6e38d 66* http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
6a488035 67*
3ec6e38d 68* Browse the api on your own site with the api explorer
41d4d31f 69* http://MYSITE.ORG/path/to/civicrm/api
6a488035
TO
70*
71* Read more about testing here
72* http://wiki.civicrm.org/confluence/display/CRM/Testing
73*
74* API Standards documentation:
75* http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
fb32de45 76*/