Merge pull request #3679 from yashodha/CRM-14951
[civicrm-core.git] / api / v3 / UFJoin.php
CommitLineData
6a488035 1<?php
6a488035
TO
2
3/*
4 +--------------------------------------------------------------------+
731a0992 5 | CiviCRM version 4.5 |
6a488035 6 +--------------------------------------------------------------------+
731a0992 7 | Copyright CiviCRM LLC (c) 2004-2014 |
6a488035
TO
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 user framework join functions
31 *
32 * @package CiviCRM_APIv3
33 * @subpackage API_UF
34 *
731a0992 35 * @copyright CiviCRM LLC (c) 2004-2014
6a488035
TO
36 * @version $Id: UFJoin.php 30171 2010-10-14 09:11:27Z mover $
37 *
38 */
39
6a488035
TO
40/**
41 * takes an associative array and creates a uf join in the database
42 *
43 * @param array $params assoc array of name/value pairs
44 *
45 * @return array CRM_Core_DAO_UFJoin Array
46 * @access public
47 * @example UFJoinCreate.php
48 * {@getfields UFJoin_create}
49 *
50 */
51function civicrm_api3_uf_join_create($params) {
52
53 $ufJoin = CRM_Core_BAO_UFJoin::create($params);
54 _civicrm_api3_object_to_array($ufJoin, $ufJoinArray[]);
55 return civicrm_api3_create_success($ufJoinArray, $params, 'uf_join', 'create');
56}
11e09c59
TO
57
58/**
6a488035 59 * Adjust Metadata for Create action
1c88e578 60 *
6a488035 61 * @param array $params array or parameters determined by getfields
1c88e578 62 * @todo - suspect module, weight don't need to be required - need to test
6a488035
TO
63 */
64function _civicrm_api3_uf_join_create_spec(&$params) {
65 $params['module']['api.required'] = 1;
66 $params['weight']['api.required'] = 1;
67 $params['uf_group_id']['api.required'] = 1;
68}
69
70/**
71 * Get CiviCRM UF_Joins (ie joins between CMS user records & CiviCRM user record
72 *
73 * @param array $params (reference) an assoc array of name/value pairs
74 *
75 * @return array $result CiviCRM Result Array or null
76 * @todo Delete function missing
77 * @access public
78 * {getfields UFJoin_get}
79 */
80function civicrm_api3_uf_join_get($params) {
81 return _civicrm_api3_basic_get(_civicrm_api3_get_BAO(__FUNCTION__), $params);
82}
83