2 files changed, 153 insertions, 0 deletions
diff --git a/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/Get.php b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/Get.php
new file mode 100644
index 00000000..020c6398
--- /dev/null
+++ b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/Get.php
@@ -0,0 +1,102 @@
+<?php
+
+namespace Civi\Api4\Action\Entity;
+
+use Civi\Api4\CustomGroup;
+use Civi\Api4\Utils\ReflectionUtils;
+
+/**
+ * Get entities
+ *
+ * @method $this setIncludeCustom(bool $value)
+ * @method bool getIncludeCustom()
+ */
+class Get extends \Civi\Api4\Generic\BasicGetAction {
+
+  /**
+   * Include custom-field-based pseudo-entities?
+   *
+   * @var bool
+   */
+  protected $includeCustom = TRUE;
+
+  /**
+   * Scan all api directories to discover entities
+   */
+  protected function getRecords() {
+    $entities = [];
+    foreach (explode(PATH_SEPARATOR, get_include_path()) as $path) {
+      $dir = \CRM_Utils_File::addTrailingSlash($path) . 'Civi/Api4';
+      if (is_dir($dir)) {
+        foreach (glob("$dir/*.php") as $file) {
+          $matches = [];
+          preg_match('/(\w*).php/', $file, $matches);
+          $entity = ['name' => $matches[1]];
+          if ($this->_isFieldSelected('description') || $this->_isFieldSelected('comment')) {
+            $this->addDocs($entity);
+          }
+          $entities[$matches[1]] = $entity;
+        }
+      }
+    }
+    unset($entities['CustomValue']);
+
+    if ($this->includeCustom) {
+      $this->addCustomEntities($entities);
+    }
+
+    ksort($entities);
+    return $entities;
+  }
+
+  /**
+   * Add custom-field pseudo-entities
+   *
+   * @param $entities
+   * @throws \API_Exception
+   */
+  private function addCustomEntities(&$entities) {
+    $customEntities = CustomGroup::get()
+      ->addWhere('is_multiple', '=', 1)
+      ->addWhere('is_active', '=', 1)
+      ->setSelect(['name', 'title', 'help_pre', 'help_post', 'extends'])
+      ->setCheckPermissions(FALSE)
+      ->execute();
+    foreach ($customEntities as $customEntity) {
+      $fieldName = 'Custom_' . $customEntity['name'];
+      $entities[$fieldName] = [
+        'name' => $fieldName,
+        'description' => $customEntity['title'] . ' custom group - extends ' . $customEntity['extends'],
+      ];
+      if (!empty($customEntity['help_pre'])) {
+        $entities[$fieldName]['comment'] = $this->plainTextify($customEntity['help_pre']);
+      }
+      if (!empty($customEntity['help_post'])) {
+        $pre = empty($entities[$fieldName]['comment']) ? '' : $entities[$fieldName]['comment'] . "\n\n";
+        $entities[$fieldName]['comment'] = $pre . $this->plainTextify($customEntity['help_post']);
+      }
+    }
+  }
+
+  /**
+   * Convert html to plain text.
+   *
+   * @param $input
+   * @return mixed
+   */
+  private function plainTextify($input) {
+    return html_entity_decode(strip_tags($input), ENT_QUOTES | ENT_HTML5, 'UTF-8');
+  }
+
+  /**
+   * Add info from code docblock.
+   *
+   * @param $entity
+   */
+  private function addDocs(&$entity) {
+    $reflection = new \ReflectionClass("\\Civi\\Api4\\" . $entity['name']);
+    $entity += ReflectionUtils::getCodeDocs($reflection);
+    unset($entity['package'], $entity['method']);
+  }
+
+}
diff --git a/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/GetLinks.php b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/GetLinks.php
new file mode 100644
index 00000000..ee274bf9
--- /dev/null
+++ b/www/crm/wp-content/plugins/civicrm/civicrm/ext/api4/Civi/Api4/Action/Entity/GetLinks.php
@@ -0,0 +1,51 @@
+<?php
+
+namespace Civi\Api4\Action\Entity;
+
+use \CRM_Core_DAO_AllCoreTables as AllCoreTables;
+
+/**
+ * Get a list of FK links between entities
+ */
+class GetLinks extends \Civi\Api4\Generic\BasicGetAction {
+
+  public function getRecords() {
+    $result = [];
+    /** @var \Civi\Api4\Service\Schema\SchemaMap $schema */
+    $schema = \Civi::container()->get('schema_map');
+    foreach ($schema->getTables() as $table) {
+      $entity = AllCoreTables::getBriefName(AllCoreTables::getClassForTable($table->getName()));
+      // Since this is an api function, exclude tables that don't have an api
+      if (class_exists('\Civi\Api4\\' . $entity)) {
+        $item = [
+          'entity' => $entity,
+          'table' => $table->getName(),
+          'links' => [],
+        ];
+        foreach ($table->getTableLinks() as $link) {
+          $link = $link->toArray();
+          $link['entity'] = AllCoreTables::getBriefName(AllCoreTables::getClassForTable($link['targetTable']));
+          $item['links'][] = $link;
+        }
+        $result[] = $item;
+      }
+    }
+    return $result;
+  }
+
+  public function fields() {
+    return [
+      [
+        'name' => 'entity',
+      ],
+      [
+        'name' => 'table',
+      ],
+      [
+        'name' => 'links',
+        'data_type' => 'Array',
+      ],
+    ];
+  }
+
+}