Typo3 zurechtgeschnitzt – Teil 2: Implementierung einer Extension

Im ersten Teil ging es um die Bereitstellung von Typo3-Extensions im Typo3-Backend. An dieser Stelle will ich mit der Implementierung weiter fortfahren.

Noch sind nicht alle vorhandenen Extensions mit Typo3 6.2 LTS kompatibel. Ich habe die Extension „pw_teaser“ schon einmal an die neuen Anforderungen angepasst. Im Weiteren zeige ich wie man die Extension implementiert und für die eigenen Bedürfnisse abändert. Der pw_teaser soll im weiteren Verlauf des Beitrages eine dynamische Seite von Angeboten darstellen, die wiederum auf den ganzen Artikel verweisen.

Implementierung der Extension

Zuerst muss im Root-Template das dazugehörige „Static Template“ inkludiert werden, damit die Default-Einstellungen der Extension im TypoScript geladen werden können. Am Rande erwähnt: TypoScript ist eine Konfigurationssprache, mit der sich Aussehen und Verhalten von Typo3 steuern lässt.

Nun lässt sich mit einem Content-Element vom Typ “Insert-Plugin“ einer Seite das Plugin „pw_teaser“ zuweisen. Anschließend wählt man unter „General preferences“ die „Teaser-Source: [Childpages of current page]“ aus.

Als letzter Konfigurationsschritt muss noch der Pfad des HTML-Templates angegeben werden, um im Anschluss Anpassungen des Seiten-Layouts per Fluid (Namespace) vornehmen zu können.

Gelegentlich ist auch gewünscht, die Sortierung der Teaser-Liste zu verändern, die Anzahl der Artikel zu beschränken und Seiten zu ignorieren. Diese und sonstige Einstellungsmöglichkeiten sind im Reiter „Visibility options“ zu finden.

Fluid-Template erstellen

Für die Ausgabe von Inhalten und Daten, die von einer Extension erzeugt werden, verwendet man die Template-Engine Fluid, die auf dem Framework Extbase basiert. Fluid-Templates lassen sich nicht nur mit HTML strukturieren, sondern beinhalten auch  einen eigenen Namespace zur Datenausgabe. Hierzu ein paar Tipps:

• Um sich einen Überblick aller Variablen im Fluid zu verschaffen, ist das globale Array „_all“ die einzige Möglichkeit.

<f:debug>{_all}</f:debug>

• Wie oben zu sehen, werden Variablen in geschweiften Klammern geschrieben. Soll ein nicht globales Array ausgegeben werden, ist hierzu eine for-each-Schleife nötig.

<f:for each="{categories}" as="category"> 
  <h1>{category.name}</h1> 
  <p>{category.description}</p>
</f:for>

• Sinnvoll ist es, den Angebotsposten zum Artikel zu verweisen. Dazu bietet uns Fluid den „Page-Link“ an. In das Attribut „pageUid” wird die UID der zu verlinkenden Seite eingetragen.

<f:link.page pageUid="23">Contact</f:link.page>

Wie sieht das Ganze aus? Ich zeige euch das hier mal an diesem Beispiel:

Jetzt sollte eigentlich alles klar sein, wenn ihr Fluid-Templates für den pw_teaser erstellen wollt.

Und wie sieht es bei euch aus? Schreibt mir doch eure Erfahrungen mit Fluid in die Kommentare.