Civi/Api4/Entity.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | Copyright CiviCRM LLC. All rights reserved.                        |
   5  |                                                                    |
   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  +--------------------------------------------------------------------+
  10  */
  11 namespace Civi\Api4;
  12
  13 /**
  14  * Retrieves information about all Api4 entities.
  15  *
  16  * @see \Civi\Api4\Generic\AbstractEntity
  17  *
  18  * @searchable none
  19  * @since 5.19
  20  * @package Civi\Api4
  21  */
  22 class Entity extends Generic\AbstractEntity {
  23
  24   /**
  25    * @param bool $checkPermissions
  26    * @return Action\Entity\Get
  27    */
  28   public static function get($checkPermissions = TRUE) {
  29     return (new Action\Entity\Get('Entity', __FUNCTION__))
  30       ->setCheckPermissions($checkPermissions);
  31   }
  32
  33   /**
  34    * @param bool $checkPermissions
  35    * @return Generic\BasicGetFieldsAction
  36    */
  37   public static function getFields($checkPermissions = TRUE) {
  38     return (new Generic\BasicGetFieldsAction('Entity', __FUNCTION__, function(Generic\BasicGetFieldsAction $getFields) {
  39       return [
  40         [
  41           'name' => 'name',
  42           'description' => 'Entity name',
  43         ],
  44         [
  45           'name' => 'title',
  46           'description' => 'Localized title (singular)',
  47         ],
  48         [
  49           'name' => 'title_plural',
  50           'description' => 'Localized title (plural)',
  51         ],
  52         [
  53           'name' => 'type',
  54           'data_type' => 'Array',
  55           'description' => 'Base class for this entity',
  56           'options' => $getFields->getLoadOptions() ? self::getEntityTypes() : TRUE,
  57         ],
  58         [
  59           'name' => 'description',
  60           'description' => 'Description from docblock',
  61         ],
  62         [
  63           'name' => 'comment',
  64           'description' => 'Comments from docblock',
  65         ],
  66         [
  67           'name' => 'icon',
  68           'description' => 'crm-i icon class associated with this entity',
  69         ],
  70         [
  71           'name' => 'dao',
  72           'description' => 'Class name for dao-based entities',
  73         ],
  74         [
  75           'name' => 'table_name',
  76           'description' => 'Name of sql table, if applicable',
  77         ],
  78         [
  79           'name' => 'primary_key',
  80           'data_type' => 'Array',
  81           'description' => 'Name of unique identifier field(s) (e.g. [id])',
  82         ],
  83         [
  84           'name' => 'label_field',
  85           'description' => 'Field to show when displaying a record',
  86         ],
  87         [
  88           'name' => 'order_by',
  89           'description' => 'Default column to sort results',
  90         ],
  91         [
  92           'name' => 'searchable',
  93           'description' => 'How should this entity be presented in search UIs',
  94           'options' => [
  95             'primary' => ts('Primary'),
  96             'secondary' => ts('Secondary'),
  97             'bridge' => ts('Bridge'),
  98             'none' => ts('None'),
  99           ],
 100         ],
 101         [
 102           'name' => 'paths',
 103           'data_type' => 'Array',
 104           'description' => 'System paths for accessing this entity',
 105         ],
 106         [
 107           'name' => 'see',
 108           'data_type' => 'Array',
 109           'description' => 'Any @see annotations from docblock',
 110         ],
 111         [
 112           'name' => 'since',
 113           'data_type' => 'String',
 114           'description' => 'Version this API entity was added',
 115         ],
 116         [
 117           'name' => 'class',
 118           'data_type' => 'String',
 119           'description' => 'PHP class name',
 120         ],
 121         [
 122           'name' => 'class_args',
 123           'data_type' => 'Array',
 124           'description' => 'Arguments needed by php action factory functions (used when multiple entities share a class, e.g. CustomValue).',
 125         ],
 126         [
 127           'name' => 'bridge',
 128           'data_type' => 'Array',
 129           'description' => 'Connecting fields for EntityBridge types',
 130         ],
 131         [
 132           'name' => 'ui_join_filters',
 133           'data_type' => 'Array',
 134           'description' => 'When joining entities in the UI, which fields should be presented by default in the ON clause',
 135         ],
 136         [
 137           'name' => 'group_weights_by',
 138           'data_type' => 'Array',
 139           'description' => 'For sortable entities, what field groupings are used to order by weight',
 140         ],
 141       ];
 142     }))->setCheckPermissions($checkPermissions);
 143   }
 144
 145   /**
 146    * @param bool $checkPermissions
 147    * @deprecated
 148    * @return Action\Entity\GetLinks
 149    */
 150   public static function getLinks($checkPermissions = TRUE) {
 151     return (new Action\Entity\GetLinks('Entity', __FUNCTION__))
 152       ->setCheckPermissions($checkPermissions);
 153   }
 154
 155   /**
 156    * @return array
 157    */
 158   public static function permissions() {
 159     return [
 160       'default' => ['access CiviCRM'],
 161     ];
 162   }
 163
 164   /**
 165    * Collect the 'type' values from every entity.
 166    *
 167    * @return array
 168    */
 169   private static function getEntityTypes() {
 170     $provider = \Civi::service('action_object_provider');
 171     $entityTypes = [];
 172     foreach ($provider->getEntities() as $entity) {
 173       foreach ($entity['type'] ?? [] as $type) {
 174         $entityTypes[$type] = $type;
 175       }
 176     }
 177     return $entityTypes;
 178   }
 179
 180 }