<?php
/*
+--------------------------------------------------------------------+
- | CiviCRM version 5 |
- +--------------------------------------------------------------------+
- | Copyright CiviCRM LLC (c) 2004-2019 |
- +--------------------------------------------------------------------+
- | This file is a part of CiviCRM. |
- | |
- | CiviCRM is free software; you can copy, modify, and distribute it |
- | under the terms of the GNU Affero General Public License |
- | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
- | |
- | CiviCRM is distributed in the hope that it will be useful, but |
- | WITHOUT ANY WARRANTY; without even the implied warranty of |
- | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
- | See the GNU Affero General Public License for more details. |
+ | Copyright CiviCRM LLC. All rights reserved. |
| |
- | You should have received a copy of the GNU Affero General Public |
- | License and the CiviCRM Licensing Exception along |
- | with this program; if not, contact CiviCRM LLC |
- | at info[AT]civicrm[DOT]org. If you have questions about the |
- | GNU Affero General Public License or the licensing of CiviCRM, |
- | see the CiviCRM license FAQ at http://civicrm.org/licensing |
+ | This work is published under the GNU AGPLv3 license with some |
+ | permitted exceptions and without any warranty. For full license |
+ | and copyright information, see https://civicrm.org/licensing |
+--------------------------------------------------------------------+
*/
* @return array
*/
function civicrm_api3_dashboard_contact_create($params) {
- if (empty($params['id'])) {
- civicrm_api3_verify_one_mandatory($params,
- NULL,
- [
- 'dashboard_id',
- ]
- );
- }
$errors = _civicrm_api3_dashboard_contact_check_params($params);
if ($errors !== NULL) {
return $errors;
*
* The metadata is used for setting defaults, documentation & validation.
*
- * @param array $params
- * Array of parameters determined by getfields.
+ * @param array $fields
+ * Array of fields determined by getfields.
*/
-function _civicrm_api3_dashboard_contact_create_spec(&$params) {
- unset($params['version']);
+function _civicrm_api3_dashboard_contact_create_spec(&$fields) {
+ $fields['dashboard_id']['api.required'] = TRUE;
}
/**
* @return array|null
*/
function _civicrm_api3_dashboard_contact_check_params(&$params) {
- $dashboard_id = CRM_Utils_Array::value('dashboard_id', $params);
- if ($dashboard_id) {
- $allDashlets = CRM_Core_BAO_Dashboard::getDashlets(TRUE, CRM_Utils_Array::value('check_permissions', $params, 0));
- if (!isset($allDashlets[$dashboard_id])) {
+ if (!empty($params['dashboard_id'])) {
+ $allDashlets = CRM_Core_BAO_Dashboard::getDashlets(TRUE, $params['check_permissions'] ?? FALSE);
+ if (!isset($allDashlets[$params['dashboard_id']])) {
return civicrm_api3_create_error('Invalid or inaccessible dashboard ID');
}
}
/**
* Delete an existing dashboard-contact.
*
- * This method is used to delete any existing dashboard-board. the id of the dashboard-contact
- * is required field in $params array
- *
* @param array $params
*
* @return array