3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
14 * Retrieves information about all Api4 entities.
16 * @see \Civi\Api4\Generic\AbstractEntity
22 class Entity
extends Generic\AbstractEntity
{
25 * @param bool $checkPermissions
26 * @return Action\Entity\Get
28 public static function get($checkPermissions = TRUE) {
29 return (new Action\Entity\
Get('Entity', __FUNCTION__
))
30 ->setCheckPermissions($checkPermissions);
34 * @param bool $checkPermissions
35 * @return Generic\BasicGetFieldsAction
37 public static function getFields($checkPermissions = TRUE) {
38 return (new Generic\
BasicGetFieldsAction('Entity', __FUNCTION__
, function(Generic\BasicGetFieldsAction
$getFields) {
42 'description' => 'Entity name',
46 'description' => 'Localized title (singular)',
49 'name' => 'title_plural',
50 'description' => 'Localized title (plural)',
54 'data_type' => 'Array',
55 'description' => 'Base class for this entity',
56 'options' => $getFields->getLoadOptions() ? self
::getEntityTypes() : TRUE,
59 'name' => 'description',
60 'description' => 'Description from docblock',
64 'description' => 'Comments from docblock',
68 'description' => 'crm-i icon class associated with this entity',
72 'description' => 'Class name for dao-based entities',
75 'name' => 'primary_key',
76 'data_type' => 'Array',
77 'description' => 'Name of unique identifier field(s) (e.g. [id])',
80 'name' => 'label_field',
81 'description' => 'Field to show when displaying a record',
85 'description' => 'Default column to sort results',
88 'name' => 'searchable',
89 'description' => 'How should this entity be presented in search UIs',
91 'primary' => ts('Primary'),
92 'secondary' => ts('Secondary'),
93 'bridge' => ts('Bridge'),
99 'data_type' => 'Array',
100 'description' => 'System paths for accessing this entity',
104 'data_type' => 'Array',
105 'description' => 'Any @see annotations from docblock',
109 'data_type' => 'String',
110 'description' => 'Version this API entity was added',
114 'data_type' => 'String',
115 'description' => 'PHP class name',
119 'data_type' => 'Array',
120 'description' => 'Connecting fields for EntityBridge types',
123 'name' => 'ui_join_filters',
124 'data_type' => 'Array',
125 'description' => 'When joining entities in the UI, which fields should be presented by default in the ON clause',
128 'name' => 'group_weights_by',
129 'data_type' => 'Array',
130 'description' => 'For sortable entities, what field groupings are used to order by weight',
133 }))->setCheckPermissions($checkPermissions);
137 * @param bool $checkPermissions
139 * @return Action\Entity\GetLinks
141 public static function getLinks($checkPermissions = TRUE) {
142 return (new Action\Entity\
GetLinks('Entity', __FUNCTION__
))
143 ->setCheckPermissions($checkPermissions);
149 public static function permissions() {
151 'default' => ['access CiviCRM'],
156 * Collect the 'type' values from every entity.
160 private static function getEntityTypes() {
161 $provider = \Civi
::service('action_object_provider');
163 foreach ($provider->getEntities() as $entity) {
164 foreach ($entity['type'] ??
[] as $type) {
165 $entityTypes[$type] = $type;