Dadurch ist es möglich einen Teaserport direkt per Typoscript einzubinden und zum Beispiel einem Marker zuzuweisen. Außerdem kann man mit dieser praktischen Extension jede beliebige Tabelle auslesen!

Einbindung über Typoscript

Nach der Installation steht im Typoscript das Objekt plugin.tx_kiwiteaser_pi1 bereit. Das kann einem Marker zugewiesen werden und über die Eigenschaften content und ports mit Inhalt befüllt werden.

page.10.marks.CONTENT < plugin.tx_kiwiteaser_pi1

page.10.marks.CONTENT {

  content = pages_21, tt_content_123, pages_22, tx_kiwiteaser_content_2

  ports = 4

}

Und zack findet sich im Frontend statt ###CONTENT### ein cooler Kiwi Teaser mit vier Slots und den ausgelesenen Datensätzen, angegeben in content. Das Format ist simpel: Name der Datenbank - Unterstrich - UID des Datensatzes. Extra angelegten Teaserinhalte befinden sich in der Datenbank tx_kiwiteaser_content.

Ansprechen von beliebigen Datenbanken

Wenn man die Inhalte einfach per Typoscript beschreibt, lässt sich natürlich jede beliebige Datenbank ansprechen. Ja, das funktioniert! Damit die Extension weiß, welche Spalten sie auslesen soll, muss man diese per Typoscript bekannt geben. Zum Beispiel könnte man die besten Frontend Benutzer teasern:

plugin.tx_kiwiteaser_pi1 {

tables.fe_users {

  title = name

  content = address

  image = image

}

}

Das Format sollte eigentlich selbsterklärend werden. Der Inhalt aus der Spalte name landet im Marker ###TITLE### usw. Anschließend muss der Datensatz nur noch dem Teaser zugewiesen werden. Dem Beispiel von oben folgend so:

page.10.marks.CONTENT.content = fe_users_1, fe_users_3, pages_12, tt_content_21

Nett, oder?

Mehr Komfort für Redakteure

Um weitere Tabellen im Teaser zu erlauben, und diese vorallem im Backend auszuwählen muss man im Moment leider noch hart an den Quelltext ran. In der Datei typo3conf/ext/kiwi_teaser/ext_tables.php wird im Array $tempColumns ab Zeile 33 das Feld tx_kiwiteaser_teasers als Datenbankrelationsfeld definiert. In Zeile 41 werden unter dem Schlüssel allowed alle erlaubten Datenbanknamen aufgezählt. Um den Redakteuren die Auswahl von Benutzern zu erlauben, muss der Eintrag erweitert werden:

$tempColumns['tx_kiwiteaser_teasers']['allowed'] = 'tx_kiwiteaser_content,pages,tt_content,fe_users';

Ausblick und Weiterentwicklung

Der aufmerksame Betrachter wird die auskommentierte Zeile 40 bemerken, in der tt_news noch erlaubt war. Daran arbeiten wir im Moment. Verbessert werden muss die Verlinkung auf ausgewählte Inhalte.

Außerdem auf der Liste steht eine dynamische Darstellung von Teaserinhalten. Das bedeutet zum Beispiel das auslesen aller Seiten ab einem Einstiegspunkt, oder die Angabe von verschiedenen Bedingungen.

Wer diese Funktionen für sein Projekt gut gebrauchen kann oder mehr Ideen hat, ist natürlich herzlich eingeladen mit uns darüber zu reden.

Die Teaser sind entweder Teaserdatensätze (mit Titel, Inhalt, Bild und Link), ganze Seiten oder einzelne Inhaltselemente. Fertig! Auf der Startseite kann der Redakteur jetzt ganz genau bestimmen, auf welche Inhalte die Benutzer aufmerksam gemacht werden sollen und in welcher Reihenfolge.

Die Extension gibts im TYPO3 Repository oder auf GitHub - live im Einsatz bisher auf unserer Firmenpräsenz.

Berechtigung

Es liegt natürlich nahe tt_news einzusetzen. Aber erst sagt der Redakteur mir, ich soll das Datum ausblenden, denn regelmäßige News gibt es  gar nicht. Als nächstes will er die Reihenfolge ändern und ich sage, pass doch einfach das Datum entsprechend der Reihenfolge an. Klar, das geht aber so richtig genial ist das nicht.

Zumal die meisten Hinweise sich auf entsprechende Seiten in der Präsenz beziehen, auf externe Links oder einfach nur einen kurzen Hinweis darstellen. Das geht jetzt eleganter.

Inhalte

Es können verschiedene Inhalte vorgestellt werden. Die Extension bringt eigene Datensätze mit welche Titel, Inhalt, Bild und einen Link aufnehmen. Es können aber auch Seiten oder Seiteninhalte angeteast werden.

Installation

Entweder man holt sich die stabile Version aus dem Repository oder die aktuellste, brandheiße aus meinem ersten Projekt auf GitHub. Ein großartiges Portal!

Die restliche Installation ist alt bekannt und ganz normal. Der Kiwi Teaser bindet standardmäßig jQuery ins Projekt ein um ein paar coole Extras zu ermöglichen.

Konfiguration

Über Typoscript hat man viele Einstellungsmöglichkeiten. Alles natürlich unter plugin.tx_kiwiteaser_pi1 im Template - das schreibe ich jetzt nicht jedesmal mit auf. Die angegebenen Typoscriptschnipsel stellen jeweils die Standardeinstellung dar.

include.css.standard = 1

Mit dieser Anweisung wird ein minimales Stylesheet geladen welches dafür sorgt das die Boxen nebeneinander stehen und einen Abstand zueinander haben.

include.javascript.jquery = 1

Bindet die aktuelle jQuery Version ein. Hat man diese schon im Projekt sollte man diese Eigenschaft unbedingt mit include.javascript.jquery > löschen (auf diese Art kann man jeden include verhindern).

include.javascript.clickbox = 1

Holt mein Plugin Clickbox ins Projekt, welches die komplette Teaserbox klickbar macht und nicht nur den kleinen Link. Mehr zur Clickbox gibts hier.

include.javascript.height = 1

Bindet ein Script ein, welches dafür sorgt das alle Teaserboxen die gleiche Höhe haben. Besonders praktisch wenn man einen Rahmen oder eine Hintergrundfarbe gesetzt hat.

template.file = EXT:kiwi_teaser/res/html/template.html

Der Pfad zum HTML Template. Das Standardtemplate sollte man sich unbedingt angucken und die Klassennamen beibehalten, denn sonst kriegen die oben erwähnten Scripte Schwierigkeiten.

stdWrap

Der StandardWrap ist eine richtig schöne Sache! Damit kann man jeden Inhalt mit Typoscript bearbeiten bevor er ausgegeben wird. Dieser kann auf alle Felder angewendet werden: title, image, link und content. Zum Beispiel:

stdWrap.title.wrap = <b>|</b>

Außerdem kann man für verschiedene Quellen verschiedene Optionen angeben. Seiten kommen aus der Tabelle pages, Seiteninhalte aus tt_content und die Standardinhalte aus tx_kiwiteaser_content. Mit diesem Wissen kann man die Ausgabe je nach Datenbank bestimmen. Möchte man also die Überschriften von Seiten nicht fett sondern kursiv darstellen, reicht folgende Anweisung:

stdWrap.title.pages.wrap = <i>|</i>

Besonders wichtig ist diese Möglichkeit für den Linktext. Dieser wird über die Eigenschaft link.value gesetzt.

stdWrap.link.value = Mehr...

Die Extension setzt den generierten oder angegebenen Wert vor der Verarbeitung in das Feld stdWrap.link.typolink.parameter. Das typolink Objekt lässt sich natürlich trotzdem noch erweitern. Will man alle Teaserlinks in einem neuen Fenster öffnen geht das ganz einfach:

stdWrap.link.typolink.target = _blank

Mapping der Inhalte

Um zu entscheiden, welche Daten aus einem Datensatz den Titel und welche z.B. den Inhalt darstellen, gibt es eine Mappingtabelle im Typoscript. In der Standardkonfiguration wird der Untertitel einer Seite als Inhalt benutzt. Das passiert über folgende Angabe:

tables.pages.content = subtitle

Dabei bezeichnet der Schlüssel das Feld im Teaser und der Wert das Feld in der Zieltabelle. Das lässt sich je nach Anforderung beliebig anpassen. Wenn die Eigenschaft link leer ist, erzeugt die Extension den Link je nach Tabelle automatisch.

Template

Im Template stehen verschiedene Marker zur Verfügung:

• ###TITLE### Ein Beispieltitel
• ###IMAGE### uplodas/media/picture.jpg
• ###CONTENT### Das ist je nach eingabe verschieden.
• ###LINK### <a href="index.php?id=123">Mehr...</a>
• ###CLASS### teaser-first port1

Image beinhaltet den originalen Inhalt aus der Datenbank, also im Idealfall den Pfad zum Bild, sollte also noch mit einem <img> Tag gewrappt oder per Javascript weiter verarbeitet werden.

Link ist ein kompletter <a> Tag - generiert über Typoscript.

Class wird automatisch gesetzt, je nach Position des Teasers steht da first-teaser oder last-teaser drin. Außerdem kriegt jeder Teaser die Klasse portX wobei das X für die aktuelle Position steht. So kann man also den zweiten Teaser gezielt ansprechen:

.tx-kiwiteaser-pi1 .port2 {

  font-size:200%;

}

Alpha

Heute, am 17.12.2009 habe ich die erste Version fertig gestellt und in meinem Projekt eingesetzt. Als nächstes wird sie in Kundenprojekt eingesetzt und die Redakteure darauf losgelassen. Dabei werde ich sicher noch die eine oder andere Erweiterung entwickeln, mit mehreren Updates ist also zu rechnen. Auf dem neusten Stand ist man natürlich bei Twitter.

Ausblick

Der wichtigeste Punkt auf meiner Liste ist die Unterstützung von tt_news. Damit ist es dann auch möglich eine schön ausgearbeitete Nachricht zu teasern. Natürlich muss sich das nicht auf tt_news beschränken, sondern kann im Prinzip jeden beliebigen Datensatz beinhalten!

Darüber hinaus sind die Pläne natürlich groß und die Möglichkeiten auch. Ich denke an jQuery Effekte wie das faden von Inhalten, die Integration vom Kiwi Slider oder das dynamische Anpassen der Inhalte.

Da wird noch einiges passieren!

Fazit

Ich möchte kein zweites tt_news programmieren, hier geht es wirklich nur um das Teasern von eigenen und fremden Inhalten. So bequem und einfach für die Redakteure wie möglich.

Ich hoffe ihr könnt die Extension gut einsetzen - über Ideen, Fragen und Anregungen in den Kommentaren freue ich mich natürlich. Und wenn jemand per GitHub mitarbeiten möchte, ist er hiermit herzlich eingeladen.

Ganz unauffällig sei auch noch auf meine Firma hingewiesen - wenn du die Extension oder ähnliches für dein Projekt brauchst, aber nicht selbst programmieren möchtest oder kannst, dann ist der Kiwi Service ein verantwortungsbewusster und kompetenter Partner!

Wenn dir der Artikel gefällt und du mit uns zusammen mehr solche Lösungen entwickeln möchtest, an das Internet und OpenSource glaubst und einen Job in Berlin suchst, dann bewirb dich bei uns. Wir suchen neue Freunde!

Danke fürs lesen, und fröhliches teasen!