TYPO3 Extension Tutorials Dokumentation von T3NET

Ziel dieser Kurzbeschreibung soll es sein, einen Einblick in die Installation und Konfiguration sowie in die Möglichkeiten zur Anpassung der Erweiterung zu zeigen. Wird darüber hinaus noch Detailwissen benötigt, sollte die Originaldokumentation der Extension ab_linklist zu Rate gezogen werden.

Nebenstehende Darstellung zeigt die Seite Linksammlung und deren Unterseiten TOP 5 bis Suchen sowie im rechten Teil einen Auszug aus der Linksammlung in der Baum-Ansicht.

Abbildung 1 zeigt das Ergebnis dieses Tutorials. TOP 5 stellt dabei die TOP-Ansicht, Kategorien die List-Ansicht und Alle Links die Tree-Ansichthttp://t3net.de/?id=179#788 dar. Über die Seite Erweitern kann der Benutzer neue Links vorschlagen. Über die Seite Suchen können Links durch Suchbegriffe in der Sammlung gefunden werden.

Abbildung 2 zeigt einen Ausschnitt der Bildschirmausgabe von Loaded extensions des Extension Manager nach der Installation.

Um eine Extension zu installieren, klicken Sie im Modul Tools auf Ext Manager und wählen die Funktion Import Extensions. Geben Sie den Suchbegriff ab_linklist in das dafür vorgesehene Feld ein und klicken auf Look up. Danach können Sie die Extension importieren und anschließend installieren.

Sollte nichts gefunden werden, müssen Sie die Liste der auf Ihrem Server vorhandenen Extensions zunächst mit der Schaltfläche Retrieve/Update aktualisieren. Dieser Vorgang kann bis zu einer Minute dauern. Anschließend werden alle derzeit verfügbaren Extensions angezeigt.

Alle Eigenschaften der Erweiterung können bequem mit dem Constant Editor angepasst werden. Abbildung 3 zeigt die vorgeschlagenen Änderungen.

Wichtig: Unter E-Mail address die eigene Mail-Adresse eintragen, damit Sie benachrichtigt werden, wenn ein Website-Benutzer einen neuen Link vorgeschlagen hat.

Um mit der Extension arbeiten zu können, müssen die von ab_linklist zur Verfügung gestellten TypoScript-Templates zum Haupt-Template der Website hinzugefügt werden. Dazu bitte wie in Abbildung 4 gezeigt vorgehen.

Von der sich daraufhin zeigenden Seite ist nur der nebenstehende Ausschnitt relevant, deshalb ist Abbildung 5 gekürzt.

Wichtig: Am Schluß der Änderung, das Speichern der Seite nicht vergessen.

Wie viele andere Erweiterungen, die ausschließlich eigene Datensätze aber keine Inhaltselemente speichern, benötigt auch diese Extension einen System-Ordner (SysFolder). In diesem Ordner werden alle Kategorien und Links der durch ab_linklist verwalteten Linksammlung abgelegt.

Der System-Ordner wird wie in Abbildung 6 gezeigt erstellt.

Wichtig: Wenn Sie eine neue Seite anlegen, hat diese zunächst den Typ Standard. Sie müssen also unbedingt den Typ ändern und SysFolder zuweisen, wie in Abbildung 7 zu sehen ist.

Die Darstellung der Links erfolgt wegen der besseren Übersicht am Besten mittels selbst definierter Kategorien. Dabei kann zwischen Haupt- und Unterkategorien unterschieden werden. Abbildung 8 zeigt zwei Haupt- und drei Unterkategorien der Hauptkategorie Web-Entwicklung, die zum Zwecke der Demonstration im folgenden angelegt werden sollen.

Die in Abbildung 9 gezeigten Vorgehensweise zum Anlegen der Kategorien werden in den folgenden zwei Schritten näher erklärt. Legen Sie soviele Haupt- und Unterkategorien an, wie sie benötigen.

Bei der Definition der Kategorien ist vor allem wichtig, dass die Bezeichnung und die Erklärung der Kategorien möglichst sprechend ist. Dem Besucher sollte sich sofort über den Inhalt im Klaren sein. Bei der Beschreibung der Kategorien haben Sie alle Möglichkeiten, die der RTE zur Formatierung bietet. Geben Sie also möglichst mehr als nur eine einzeilige Beschreibung ein.

Abbildung 10 zeigt das Anlegen der Hauptkategorie Allgemeines.

Abbildung 11 zeigt das Anlegen der Hauptkategorie Web-Entwicklung.

Unterkategorien werden auf die selbe Weise wie Hauptkategorien angelegt. Der einzige Unterschied besteht darin, dass bei Unterkategorien die übergeordnete Hauptkategorie (Parent Category) ausgewählt werden muss.

Abbildung 12 zeigt dies am Beispiel der neu anzulegenden Unterkategorie TYPO3 und YAML.

Unterkategorien sind optional. Sie müssen sie nur anlegen, wenn es wegen der Vielzahl von Links die Übersichtlichkeit erhöht. Enthält aber jede Unterkategorie nur einen oder zwei Links, verwirrt das den Besucher mehr als es nützt.

Abbildung 13 zeigt alle Links der Linksammlung, die zu Demonstrationszwecken im Folgenden angelegt werden sollen.

Sie müssen natürlich nicht genau diese Links verwenden, sondern können gleich die von Ihnen gewünschten verwenden.

Das Anlegen der Links erfolgt in ähnlicher Weise wie bei den Kategorien. Die Abbildungen 14 bis 16 zeigen, wie ein Link angelegt wird:

Um einen neuen Link anzulegen, können Sie im Modul Web entweder Page oder List verwenden. Danach klicken Sie auf den SysFolder Link Storage, starten mit Neu den Wizard und wählen dort Modern Linklist Link (Abbildung 14).

Im Reiter General werden die Überschrift (Label) und die Beschreibung (Description) des Links erfasst. Auch hier gilt: Beschreiben Sie den Link nicht nur mit einer Zeile, sondern ausführlich. Bedenken Sie dass auch Suchmaschinen diesen Content sehen.

Der Status des Links ist sehr wichtig. Ist er nicht auf Approved gesetzt, wird er im Frontend nicht angezeigt. Deshalb dürfen Sie auf keinen Fall den Schritt 4 in Abbildung 15 vergessen. Von Besuchern vorgeschlagene Links haben zunächst den Status Open und erscheinen nicht sofort sondern erst, wenn Sie als Administrator den Link genehmigen und auf Approved setzen.

Im Reiter Relations wird das Linkziel (URI) sowie die Kategorie zu der der Link gehört, festgelegt (Abbildung 16). Ein Link kann auch zu mehreren Kategorien gehören. Sollte dies gewünscht sein, klicken Sie auf die erforderlichen Kategorien, damit sie im Feld Selected erscheinen.