Die Standard-Paginierung der EXT:solr-Suche zeigt Vor- und Zurück-Links – praktisch, aber für Ergebnis-Listen mit vielen Seiten oft nicht ausreichend. solr_numbered_pagination ersetzt diese einfache Navigation durch eine nummerierte Paginierung im Stil „1 … 3 4 5 … 12" über die bewährte Extension georgringer/numbered-pagination.
Dieser Fork des Upstream-Projekts von Studio Mitte GmbH portiert die Extension auf TYPO3 v14.3 und EXT:solr 14 Alpha. Es handelt sich um einen fokussierten, kleinen Fork – ein eigener Commit über dem Upstream.
Inhaltsverzeichnis
Überblick
Was wurde gemacht
Funktionen im Detail
Installation
Überblick
solr_numbered_pagination ist eine kleine TYPO3-Extension, die das Pagination-Verhalten der EXT:solr-Suche durch nummerierte Seiten erweitert. Statt der üblichen zwei Links zeigt die Navigation eine kompakte Seitenfolge mit Auslassungspunkten – wie man es von großen Suchanwendungen kennt.
Das Upstream-Projekt stammt von der Studio Mitte GmbH und unterstützte bisher TYPO3 v12 und v13. Mit dem Erscheinen von TYPO3 v14.3 LTS und der Alpha-Linie von EXT:solr 14 war eine Aktualisierung der Abhängigkeiten nötig.
Dieses Paket erfordert TYPO3 ^14.3, apache-solr-for-typo3/solr ^14.0@alpha und georgringer/numbered-pagination ^2.2. Für TYPO3 v12 oder v13 das Upstream-Paket von Studio Mitte GmbH verwenden.
Solr-Suchergebnisse im Frontend: Die Ergebnisliste zeigt den realen Kontext, in dem nummerierte Pagination wirkt: Suchfeld, Trefferliste, Kategorien, Tags und Blog-Metadaten.
Was wurde gemacht
Ehrlich gesagt: dieser Fork besteht aus einem eigenen Commit über dem Upstream – „Add TYPO3 14 Solr pagination support". Die composer.json wurde auf typo3/cms-core: ^14.3 und apache-solr-for-typo3/solr: ^14.0@alpha angehoben. Das Pagination-Partial wurde neu geschrieben und nutzt jetzt shadcn/ui-kompatible CSS-Klassen, die sich direkt in moderne TYPO3-Frontend-Projekte mit Tailwind/shadcn einbinden lassen.
Mehr ist es nicht – und das soll es auch sein. Ein fokussierter Port auf v14, ohne die Upstream-Logik anzutasten.
Funktionen im Detail
| Funktion | Nutzen |
|---|---|
| Nummerierte Paginierung | Zeigt „1 … 3 4 5 … 12" statt nur Vor-/Zurück-Links – über georgringer/numbered-pagination. |
| Event-Listener-Ansatz | Ersetzt das Solr-Pagination-Objekt vor der Fluid-Zuweisung – kein Eingriff in EXT:solr-Core nötig. |
| Solr-URL-ViewHelper | Behält den EXT:solr-Pagination-URL-ViewHelper für korrekte Solr-Seitenparameter. |
| Partial via Site-Settings | partialRootPath überschreibbar – kein eigenes Sitepackage zwingend erforderlich. |
| shadcn/ui-CSS-Klassen | Pagination-Partial nutzt shadcn/ui-kompatible Klassen für konsistente Optik in modernen Projekten. |
| Minimale Abhängigkeiten | Nur EXT:solr, numbered-pagination und TYPO3-Core – kein weiteres Sitepackage vorausgesetzt. |
Der Event-Listener greift in den Rendering-Prozess ein, bevor Fluid das Pagination-Objekt zugewiesen bekommt, und tauscht es gegen die NumberedPagination-Implementierung von Georg Ringer aus. Der EXT:solr-eigene Pagination-URL-ViewHelper bleibt dabei erhalten – die Solr-Seitenparameter werden korrekt generiert.
Installation
composer config repositories.solr-numbered-pagination vcs https://github.com/dirnbauer/solr_numbered_pagination.git
composer require studiomitte/solr-numbered-pagination:^14.0Nach der Installation wird das Standard-Solr-Paginierungs-Partial automatisch durch das nummerierte ersetzt. Wer das Partial anpassen möchte, überschreibt partialRootPath in den Site-Settings – ein eigenes Sitepackage ist dafür nicht zwingend erforderlich.
Häufige Fragen
Fazit
Eine kleine Extension für ein konkretes Problem: die nummerierte Paginierung fehlt in EXT:solr, und dieser fokussierte Fork schließt die Lücke für TYPO3 v14. Keine Überarchitektur, keine unnötigen Abhängigkeiten – ein fokussierter Port auf die aktuelle Plattform.
solr_numbered_pagination ist ein Fork des Upstream-Projekts von Studio Mitte GmbH. Dank an Studio Mitte für die Vorlage und an Georg Ringer für georgringer/numbered-pagination. Beide Projekte stehen unter GPL-2.0-or-later.