feat(demo): add story 1 — Sorano: Rock and Time

2026-06-20 21:19:57 +02:00
parent 42ed59a6b3
commit 8f87155c1d
5508 changed files with 1595740 additions and 124 deletions
@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Grav\Plugin\Api;
+
+use Grav\Framework\Flex\FlexDirectory;
+
+/**
+ * Trait for controllers that optionally use Flex-Objects backend
+ * for listing/search operations.
+ *
+ * When enabled (default), listing endpoints use flex directories for
+ * indexed search, filtering, sorting, and pagination. When disabled
+ * or unavailable, controllers fall back to regular Grav services.
+ *
+ * Config keys: plugins.api.flex_backend.pages, plugins.api.flex_backend.accounts
+ */
+trait FlexBackend
+{
+    /**
+     * Map flex directory types to their config keys.
+     */
+    private const FLEX_CONFIG_MAP = [
+        'pages' => 'pages',
+        'user-accounts' => 'accounts',
+    ];
+
+    protected function getFlexDirectory(string $type): ?FlexDirectory
+    {
+        $configKey = self::FLEX_CONFIG_MAP[$type] ?? $type;
+        if (!$this->config->get('plugins.api.flex_backend.' . $configKey, true)) {
+            return null;
+        }
+
+        if (!isset($this->grav['flex_objects'])) {
+            return null;
+        }
+
+        $flex = $this->grav['flex_objects'];
+        $directory = $flex->getDirectory($type);
+
+        return ($directory && $directory->isEnabled()) ? $directory : null;
+    }
+}