Merge pull request #1743 from danskernesdigitalebibliotek/DDFHER-119_…

…expand-event-api

Expand event API to include `partners` as array string. DDFHER-119

openapi.json

@@ -1002,6 +1002,14 @@
                       "description": "The name of a tag."
                     }
                   },
+                  "partners": {
+                    "type": "array",
+                    "description": "The partners associated with the event.",
+                    "items": {
+                      "type": "string",
+                      "description": "The name of a partner."
+                    }
+                  },
                   "ticket_categories": {
                     "type": "array",
                     "description": "Ticket categories used for the event. Not present for events without ticketing.",

web/modules/custom/dpl_event/src/Plugin/rest/resource/v1/EventsResource.php

@@ -167,6 +167,14 @@ public function getPluginDefinition(): array {
                       'description' => 'The name of a tag.',
                     ],
                   ],
+                  'partners' => [
+                    'type' => 'array',
+                    'description' => 'The partners associated with the event.',
+                    'items' => [
+                      'type' => 'string',
+                      'description' => 'The name of a partner.',
+                    ],
+                  ],
                   'ticket_categories' => [
                     'type' => 'array',
                     'description' => 'Ticket categories used for the event. Not present for events without ticketing.',

web/modules/custom/dpl_event/src/Services/EventRestMapper.php

@@ -63,6 +63,7 @@ public function getResponse(EventInstance $event_instance): EventsGET200Response
       'branches' => $this->getBranches(),
       'address' => $this->getAddress(),
       'tags' => $this->getTags(),
+      'partners' => $this->getMultiValue('event_partners'),
       'ticketCapacity' => $this->getValue('event_ticket_capacity'),
       'ticketCategories' => $this->getTicketCategories(),
       'createdAt' => $this->getDateField('created'),
@@ -252,6 +253,25 @@ private function getDateField(string $field_name): ?DateTime {
     return $date;
   }
 
+  /**
+   * Get multiple string values as an array output.
+   *
+   * @return string[]
+   *   An array of string values.
+   */
+  private function getMultiValue(string $field_name): array {
+    $field = $this->eventWrapper->getField($field_name);
+
+    if (!($field instanceof FieldItemListInterface)) {
+      return [];
+    }
+
+    $values = $field->getValue();
+
+    // Turning the value keys into a simple, one-level array of strings.
+    return array_column($values, 'value');
+  }
+
   /**
    * Get string value of a possible field (or fallback field).
    */