APIv4 - Add `@since` annotation to each entity
[civicrm-core.git] / Civi / Api4 / Contact.php
1 <?php
2
3 /*
4 +--------------------------------------------------------------------+
5 | Copyright CiviCRM LLC. All rights reserved. |
6 | |
7 | This work is published under the GNU AGPLv3 license with some |
8 | permitted exceptions and without any warranty. For full license |
9 | and copyright information, see https://civicrm.org/licensing |
10 +--------------------------------------------------------------------+
11 */
12
13 /**
14 *
15 * @package CRM
16 * @copyright CiviCRM LLC https://civicrm.org/licensing
17 */
18
19
20 namespace Civi\Api4;
21
22 /**
23 * Contacts - Individuals, Organizations, Households.
24 *
25 * This is the central entity in the CiviCRM database, and links to
26 * many other entities (Email, Phone, Participant, etc.).
27 *
28 * Creating a new contact requires at minimum a name or email address.
29 *
30 * @see https://docs.civicrm.org/user/en/latest/organising-your-data/contacts/
31 * @searchable primary
32 * @since 5.19
33 * @package Civi\Api4
34 */
35 class Contact extends Generic\DAOEntity {
36
37 /**
38 * @param bool $checkPermissions
39 * @return Action\Contact\GetChecksum
40 */
41 public static function getChecksum($checkPermissions = TRUE) {
42 return (new Action\Contact\GetChecksum(__CLASS__, __FUNCTION__))
43 ->setCheckPermissions($checkPermissions);
44 }
45
46 /**
47 * @param bool $checkPermissions
48 * @return Action\Contact\ValidateChecksum
49 */
50 public static function validateChecksum($checkPermissions = TRUE) {
51 return (new Action\Contact\ValidateChecksum(__CLASS__, __FUNCTION__))
52 ->setCheckPermissions($checkPermissions);
53 }
54
55 }