18. Dezember 2010

TYPO3 4-5: Paginator – Türchen 18

in ExtBase/Fluid, Programming, Tutorial, TYPO3

Seit der Beta1 von TYPO3 4-5 gibt es mit dem Paginator ein tolles Fluid-Widget, mit dem ein Pagebrowser bei Extbase-Extensions möglich ist. Das Snippet ist einfach zu konfigurieren und funktioniert tadellos.

Ein einfaches Beispiel schaut folgendermaßen aus:

<f:widget.paginate objects="{news}" as="paginatedNews">
  <f:for each="{paginatedNews}" as="newsItem">
    <f:render partial="List/Item" arguments="{newsItem: newsItem}"/>
 </f:for>
</f:widget.paginate>

Zur Erklärung: Über die news-Objekte wird ein Pagebrowser gelegt indem dem Paginate-Viewhelper die Objekte übergeben werden. Wie bei einem for-each Viewhelper wird ein Name angegeben über den die Objekte anschließend angesprochen werden – in dem Fall „paginatedNews“. Diese können dann wie bereits bekannt gerendered werden, zB über ein Partial.

Konfiguration

Die Konfiguration ist noch sehr simpel, aber für die meisten Fälle ausreichend.

<f:widget.paginate objects="{news}" as="paginatedNews" configuration="{itemsPerPage: 5, insertAbove: 1, insertBelow: 1}">
  • itemsPerPage legt die maximale Anzahl der Objekte fest
  • insertAbove: Ob der Pagebrowser über den Objekten ausgegeben werden soll
  • insertBelow: Ob der Pagebrowser unter den Objekten ausgegeben werden soll

Technischer Hintergrund

Auf dem ersten Blick mag der Code performanceintensiv ausschauen, aber das ist nicht der Fall, denn es finden nur die allernotwendigsten Datenbankabfragen statt. Mehr dazu steht u.a. in den Changelogs von fluid, siehe https://svn.typo3.org/TYPO3v4/CoreProjects/MVC/fluid/trunk/ChangeLog.txt.

Ausblick

Aktuell ist es noch nicht möglich, das dahinterstehende Template (fluid\Resources\Private\Templates\ViewHelpers\Widget\Paginate\Index.html) zu überschreiben, das wird sich aber noch bis zur finalen Version von TYPO3 4-5 ändern, siehe http://forge.typo3.org/issues/10823.

13 Reaktionen zu “TYPO3 4-5: Paginator – Türchen 18”

Kommentare abonnieren (RSS) oder TrackBack URL

Super Artikel und perfekt erklärt.
Bekomme bei mir auch die Pagebrowserlinks richtig angezeigt, jedoch bei Klick auf Seite 2 oder Weiter bekomme ich folgenden Fehler:
Fatal error: Encoding declaration pragma must be the very first statement in the script in /home/xxx/data/xxx/xxx/site/online/typo3/sysext/fluid/Classes/Core/Widget/AbstractWidgetViewHelper.php on line 2

Manchmal funktioniert es aber. Der Fehler kommt der nur sporadisch.
Woran kann das liegen?

Alex am 11. Februar 2011 um 14:19

Wirklich sehr lehrreich der Artikel. Vielen Dank dafür.

Waldemar am 19. April 2011 um 09:24

habe das Widget schon mehrfach eingesetzt.
Mich würde interessieren, ob es mitlerweile eine saubere Möglichkeit gibt den Pager anzupassen.
Besonders für mehrsprachige Webseiten würde etwa das Übersetzen der „previous“ und „next“ Links hilfreich sein.

ToBe am 15. Dezember 2011 um 15:04

mittlerweile kann man die templates per TS setzen, dir steht also alles frei

Georg Ringer am 15. Dezember 2011 um 15:34

Passende Konfiguration:
plugin.tx_myext.view.widget.Tx_Fluid_ViewHelpers_Widget_PaginateViewHelper.templateRootPath = {$plugin.tx_myext.view.templateRootPath}

siehe http://forge.typo3.org/issues/32155

Jonas am 06. Januar 2012 um 19:35

oder besser hier http://forge.typo3.org/issues/10823

Jonas am 06. Januar 2012 um 19:36

Gibt es eigentlich eine Möglichkeit, weitere Parameter zu übergeben?

Ich würde nämlich gerne auch Suchergebnisse paginieren, was aber nicht funktioniert, da der Suchstring natürlich keine Eigenschaft der Objekte ist sondern über einen Parameter der Controller-Action verarbeitet wird.

Hat dazu jemand eine Idee?

Lars am 26. Januar 2012 um 11:29

ja es gibt noch mehr Parameter zB. habe ich „maximumNumberOfLinks“ gefunden.
Weis aber grad nicht in welcher Version das eingefürt wurde. Kennt jemand ne Doku dazu?

ToBe am 09. Februar 2012 um 18:09

@Lars
den Paginater kannst du auf jede Liste anwenden.
Ich habe dazu ein extra Filter-Formualar gebaut und eine Methode „findByFilter(…)“
Der paginator „paged“ mir dann die Ergebnisliste.

Oder hab ich falsch verstanden was du willst?

ToBe am 10. Februar 2012 um 10:33

Hey,
vielen Dank für den Artikel 🙂
Das geht echt fix damit, und man muss ja nicht immer das Rad neu erfinden 😉
LG,
Thomas

Thomas am 08. Mai 2012 um 11:05

@ToBe:
Habe ich auch. Leider vergisst der Paginator beim Klick auf einen Seitenlink den Forumlar-Inhalt. Oder wie hast du den Inhalt übergeben?

Ronald am 08. November 2012 um 17:26

@ToBe @Roland hatte das selbe Problem, bei mir hat es mit der Umstellung von POST und GET dann funktioniert, der Paginator übernimmt dann die Parameter der Url

Markus am 06. Januar 2013 um 14:15

4 Jahre später…

…aber nur der Vollständigkeit halber: https://www.typo3.net/forum/thematik/zeige/thema/111586/seite/2/

Hier gibt es noch 2,3 weitere Ansätze gefilterte Datensätze paginiert zu bekommen.

Beste Grüße

Guido am 20. September 2017 um 18:50

Kategorien

Archiv