Beitragsnavigation als Baustein (Dokumentschema v18)

Umut: "Beitragsseite gefaellt mir nicht, sollte wie bei kant-it.de sein
oder besser. Falls noetig Plugin bauen."

Die Originalseite hat Galerie, Vor/Zurueck zwischen Projekten und einen
Abschlussaufruf. Galerie und Aufruf gab es laengst - sie waren nur nicht
benutzt. Die Navigation gab es nicht.

Kein Plugin: ein Plugin ist hier ein Bausteintyp, dessen Eigenschaften der
Kern aufbewahrt, aber nicht rendert - es koennte also nichts ausgeben,
solange es keine Laufzeit dafuer gibt. Und die Nachbarn eines Beitrags
stehen in derselben Tabelle wie die Beitragsliste, die der Kern schon
fuellt. Also ein Baustein: postnav.

Gespeichert sind zwei Beschriftungen, mehr nicht - welcher Beitrag vorher
und nachher kommt, entscheidet der Renderer. Gesucht wird innerhalb
derselben Kategorie, und am Rand wird nicht umgebrochen.

Ausserdem: die uebernommenen Projekttexte begannen mit dem wiederholten
Titel (20 Beitraege), und schmale Abschnitte standen links statt mittig -
max-width ohne margin:auto ist eine halbe Einstellung.

Geprueft: 396 Tests unter PHP 8.2 und 8.4, 18 JS-Tests, Editortest,
Browserpruefung, axe ohne Verstoss auf der Beitragsseite.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/Content/PostRepository.php

@@ -153,6 +153,45 @@ final class PostRepository
     /**
      * @return array<string, list<array{slug: string, name: string, href: string}>>
      */
+    /**
+     * Der vorherige und der nächste Beitrag, in der Reihenfolge des Archivs.
+     *
+     * Gesucht wird innerhalb derselben Kategorie, wenn der Beitrag eine hat: von einem Projekt
+     * führt man zum nächsten Projekt und nicht zur nächsten Pressemitteilung. Hat er keine, gilt
+     * die ganze Liste. Am Rand wird nicht umgebrochen - der erste Beitrag hat keinen Vorgänger,
+     * und ein Ring aus zwei Beiträgen wäre eine Schleife, keine Navigation.
+     *
+     * @return array{previous: ?array, next: ?array}
+     */
+    public function neighbours(string $pageId, string $locale = 'de'): array
+    {
+        $termId = (string) $this->db->fetchOne(
+            'SELECT t.id FROM term t JOIN page_term pt ON pt.term_id = t.id WHERE pt.page_id = ? AND t.kind = ? ORDER BY t.name LIMIT 1',
+            [$pageId, 'category'],
+        );
+        // Dieselbe Sortierung wie im Archiv, damit „vorheriges" dort dasselbe heißt wie hier.
+        $all = $this->published(1, '' === $termId ? null : $termId, 500, $locale)['posts'];
+        // present() gibt bewusst keine Kennung heraus - in eine Liste gehören Titel und Adresse.
+        // Verglichen wird deshalb über die Adresse, die innerhalb einer Website eindeutig ist.
+        $own = $this->settings->publicPath((string) $this->db->fetchOne('SELECT path FROM page WHERE id = ?', [$pageId]));
+        $index = null;
+        foreach ($all as $position => $post) {
+            if ($post['href'] === $own) {
+                $index = $position;
+                break;
+            }
+        }
+        if (null === $index) {
+            return ['previous' => null, 'next' => null];
+        }
+
+        return [
+            // „Vorheriges" ist im Archiv der neuere Beitrag, weil dort das Neueste oben steht.
+            'previous' => $all[$index - 1] ?? null,
+            'next' => $all[$index + 1] ?? null,
+        ];
+    }
+
     public function termsFor(string $pageId): array
     {
         $terms = ['category' => [], 'tag' => []];