Überholt
Inzwischen wurde bereits eine neuere Version von Steffen Kamper eingereicht (erhältlich im Online Repository), welche auch eine Seitennavigation enthält. Weil dies auch als Beispiel für eine Anpassung dienen kann, bleibt es erhalten.
Seitennavigation für sk-simplegallery
Die TYPO3 Extension 
sk-simplegallery von 
Steffen Kamper ist eine für Autoren angenehm zu handhabende Bildergallerie. Das einzige Defizit: es fehlt eine Seitennavigation. Sollte eine Bildergallerie also aus vielen Bildern bestehen, so muss ein Besucher alle Bilder (zumindest die Voransichten) laden, was einiges an Zeit beansprucht. Aufgrund einer Kundenanfrage habe ich eine simple Seitennavigation für diese Extension geschrieben. Die veränderte Version von ski-simplegallery steht hier zum Download bereit.
- Einstellungsmöglichkeiten
Konfiguration der Extension
Die Seitennavigation wird vorwiegend durch TypoScript verändert. Nur die Einstellung Einträge pro Seite kann im Formular des Backend eingestellt werden. Die Konfiguration des TypoScript erfolgt durch die Elemente pagebrowser und singleView, wobei singleView schon vorher Teil der Extension war. Hier ein kleines Beispiel - TS:
plugin.tx_sksimplegallery_pi1 { templateFile = path-to-your-template popupBodyTag = <body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0"> captionWrap = <p style="font: 0.9em 'palatino', arial, helvetica, sans-serif;padding:10px;">|</p> singleView { entriesPP = 9 entriesPerLine = 3 line_start = <tr> line_end = </tr> } pageBrowser { activePageWrap = <span class="activePage">|</span> pageWrap = <span class="page">|</span> nextLinkWrap = <span class="nextLink">|</span> previousLinkWrap = <span class="previousLink">|</span> inactiveNextLinkWrap = <span class="inactiveNextLink">|</span> inactivePreviousLinkWrap = <span class="inactivePreviousLink">|</span> jumpFirstPageWrap = <span class="jumpToFirst">|</span> jumpLastPageWrap = <span class="jumpToLast">|</span> inactiveJumpFirstPageWrap = <span class="inactiveJumpToFirst">|</span> inactiveJumpLastPageWrap = <span class="inactiveJumpToLast">|</span> showInactiveLinks = 1 } captionHeight = 100 general_stdWrap > }
(copy 1)
plugin.tx_sksimplegallery_pi1 { templateFile = path-to-your-template popupBodyTag = <body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0"> captionWrap = <p style="font: 0.9em 'palatino', arial, helvetica, sans-serif;padding:10px;">|</p> singleView { entriesPP = 9 entriesPerLine = 3 line_start = <tr> line_end = </tr> } pageBrowser { activePageWrap = <span class="activePage">|</span> pageWrap = <span class="page">|</span> nextLinkWrap = <span class="nextLink">|</span> previousLinkWrap = <span class="previousLink">|</span> inactiveNextLinkWrap = <span class="inactiveNextLink">|</span> inactivePreviousLinkWrap = <span class="inactivePreviousLink">|</span> jumpFirstPageWrap = <span class="jumpToFirst">|</span> jumpLastPageWrap = <span class="jumpToLast">|</span> inactiveJumpFirstPageWrap = <span class="inactiveJumpToFirst">|</span> inactiveJumpLastPageWrap = <span class="inactiveJumpToLast">|</span> showInactiveLinks = 1 } captionHeight = 100 general_stdWrap > }
Eine vollständige Liste des TS-Setup kann auf der offiziellen TYPO3 Seite für Entwickler gefunden werden. Die folgenden Zeilen sind die Einstellungsmöglichkeiten der Seitennavigation:
plugin.tx_sksimplegallery_pi1 { singleView { entriesPP = 9 entriesPerLine = 3 line_start = <tr> line_end = </tr> } pageBrowser { activePageWrap = <span class="activePage">|</span> pageWrap = <span class="page">|</span> nextLinkWrap = <span class="nextLink">|</span> previousLinkWrap = <span class="previousLink">|</span> inactiveNextLinkWrap = <span class="inactiveNextLink">|</span> inactivePreviousLinkWrap = <span class="inactivePreviousLink">|</span> jumpFirstPageWrap = <span class="jumpToFirst">|</span> jumpLastPageWrap = <span class="jumpToLast">|</span> inactiveJumpFirstPageWrap = <span class="inactiveJumpToFirst">|</span> inactiveJumpLastPageWrap = <span class="inactiveJumpToLast">|</span> showInactiveLinks = 1 } }
Was zum ...?!
Im Bereich singleView kann man die Einträge entriesPP, entriesPerLine, line_start und line_end finden. Aber wofür sind die da?
- entriesPP: Einträge pro Seite. Ermöglicht das Einstellen der Seitennavigation durch die Angabe, wie viele Einträge pro Seite angezeigt werden sollen. Ist die Anzahl der in einer Gallerie enthaltenen Bilder kleiner als die erlaubten Einträge pro Seite, so wird die Seitennavigation nicht angezeigt.
- entriesPerLine: Wie viele Bilder pro Zeile angezeigt werden sollen. In Kombination mit line_start und line_end ermöglicht dieser Wert die Darstellung der Gallerie als Tabelle.
- line_start: der Text, welcher am Zeilenanfang angezeigt werden soll (z.B.: für ein Tabellenlayout <tr>).
- line_end: der Text, welcher am Zeilenende angezeigt werden soll (z.B.: für ein Tabellenlayout </tr>).
Der Bereich pagebrowser besteht mehr oder weniger nur aus Wraps. Der Syntax für diese Wraps ist der selbe wie in allen anderen TypoScripts:
- Text vor dem Wrap | Text nach dem Wrap : Das "|" wird mit dem zu wrappenden Inhalt ersetzt
Nun zu den Elementen in pagebrowser:
- activePageWrap: der Wrap für die aktuelle Seite
- pageWrap: standard Wrap für Seitenlinks (nichtig für die aktuelle Seite)
- nextLinkWrap: Wrap für den Link zur nächsten Seite (>)
- previousLinkWrap: Wrap für den Link zur vorherigen Seite (<)
- jumpFirstPageWrap: Wrap für den Link zur ersten Seite (<<)
- jumpLastPageWrap: Wrap für den Link zur letzten Seite (>>)
- showInactiveLinks (Wahrheitswert): Falls wahr, sind die Links zur nächsten Seite, vorherigen Seite, zur ersten Seite und zur letzten Seite immer sichtbar (als Text: <<, <, >, >>). Falls der Wert von showInactiveLinks nicht wahr ist, werden die Links nicht angezeigt, falls sie nicht verwendbar sind (z.B.: der Link zur ersten Seite ist nicht sichtbar, falls man sich auf der ersten Seite befindet).
- inactiveNextLinkWrap, inactivePreviousLinkWrap, inactiveJumpFirstPageWrap, inactiveJumpLastPageWrap: Ist showInactiveLinks war, sind dies die Wraps für die inaktiven Links, welche vorher als aktive Links besprochen wurden (also jumpFirstPage usw...).
Beispiel
Im Einsatz ist diese Extension zur Zeit auf Panorama Schenna und unter der 
Sektion Photos dieser Seite zu sehen.