Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.

betrifft
TYPOlight Version	Alle Versionen

Extensions	TYPOlight Core

catalog 2

Mit Hilfe des Catalog-Moduls kann man eigentlich alles darstellen was wie ein Katalog aufgebaut sein soll. Angefangen von einfachen Tabellen bis hin zur Darstellung von Immobilien ist eigentlich alles möglich. Man kann den Catalog im Grunde als Möglichkeit sehen um eigene Module zu entwickeln ohne zu Programmieren.

In der neuen Version wurde vieles verändert. So ist es nicht mehr nötig Catalog und Catalog_ext zu installieren, da diese zusammengelegt wurden. Daher müssen Sie bei einem Update etwas aufpassen:

Zuerst die alten Modulordner entfernen
danach die neuen Modulordner hochladen
erst zum Schluss das Datenbankupdate ausführen!

So ist es möglich ohne Datenverlust den catalog upzudaten.

Allgemeines

Beispielanwendungen

Backend

Mit dem Catalog bekommt man 2 neue Menüeinträge im Backend:

Katalog
Taxonomie

Module

Catalog List (Zur Ausgabe einer Liste von Items)
Catalog Reader (Um die Details von einem einzelnen Item anzuzeigen)
Catalog Filter (Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs Filtern und die Anzeige eingrenzen)
Catalog Navigation (Mit dieser Navigation kann man eine Navigation Erstellen. Die Navigation besteht zum Beispiel aus Kategorien)
Catalog Notify (Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird)
Catalog Featured (Hiermit kann man eine besondere Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.)
Catalog Related (Hiermit erstellt man eine Liste von ähnlichen Items - Einzusezten auf einer Seite wo auch der Catalog Reader enthalten ist. Zufallsausgabe)
Catalog Reference (Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft.)
Catalog Edit (Um ein Item im Frontend editieren zu können. Wird anstelle von Catalog Reader dieses Modul verwendet)

Für die einfachste Variante eines Cataloges braucht man nur eine Catalog List, wo dann alle Items in einer Liste/Tabelle ausgegeben werden.

Der nächste Schritt wäre eine Liste von Items mit einer Detail Ansicht. Dafür braucht man dann nur noch Catalog List und Catalog Reader. Die Liste verweist dabei auf den Reader wo dann ein einzelnes Item dargestellt wird.

Alle anderen Module sind für fortgeschrittene Bedürfnisse da und müssen an sich nicht für die Grundfunktionalität benutzt werden.

Erstellen von einem Katalog (Backend)

Auf Katalog klicken > Neuer Katalog:

Name des Katalogs angeben
Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewehrt eine Tabelle anzulegen ohne tl_ als präfix, da TYPOlight diese Tabellen sonst zum entfernen vorschlät. Ich empfehle den präfix cat_ damit man die Tabellen schnell wiederfindet.)
Alias field (kann erst später ausgefüllt werden) -> anstelle der ID wird der Alias genutzt bei den Links
Ein Bild hinzufügen -> Hier kann ein Bild für den Katalog hinzugefügt werden, um im Backend den Katalog schnell von anderen unterscheiden zu können
Zeichenkette des Titels formatieren (wird erst später gebraucht) -> Um im Backend die Übersicht von vielen Items besser gewährleisten zu können, kann man hier die Anzeigen der einzelnen Items konfigurieren
Allow comments -> Kommentare bei den einzelnen Items erlauben und konfigurieren (Funktion ist wie bei News o.ä. daher wird hier nicht genauer darauf eingegangen)
Searchable -> Wenn man die Items auch in der TYPOlight Suche Indexieren lassen möchte. Nach aktivierung ist es möglich Conditions (Ausnahmen) einzugeben und das Title Feld anzugeben von einem Item (weiteres zu Conditions und Title finden Sie weiter unten)
Enable CSV import -> Damit ist es möglich CSV-Dateien zu importieren. Natürlich sollte man das nicht einfach so machen und nur von Leuten die wissen was sie tun. Daher kann hier festgelegt werden, das nur Administratoren das machne dürften und ob Items überschrieben werden oder nicht
Generate feed -> Hier kann festgelegt werden, das ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä. daher wird hier nicht genauer darauf eingegangen)

Erstellen von Attributen/Feldern von Items in einem Katalog

Nun ist die Grundkonfiguration von einem Katalog erst einmal abgeschlossen. Aber es ist noch nicht festgelegt aus welchen Feldern ein Item denn nun Besteht, also welche Attribute ein Item besitzen kann. Dazu kommen wir jetzt:

Katalog > Felder für Katalog erstellen > Neues Feld:

Die Standardwerte von Feldern

Die Speziellen Felder werden erst sichtbar, wenn man einen Feldtyp ausgewählt hat. Diese Werte werden weiter unten erläutert.

Field configuration
- Bezeichnung (Eine Eindeutige Bezeichnung für das Feld. Diese sollte möglichst selbsterklährend sein.)
- Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
- Spaltenname (der Spaltenname in der Tabelle, muss eindeutig sein und diesen sollte man auch so vergeben, das er Logisch ist, da man beim Template erstellen diese Namen benutzt um an die Inhalte zu kommen)
- Typ (weiter unten)
Display Settings (Diese Einstellungen sind für die Ansicht im Backend zuständig)
- Kontroll-Checkbox (Wenn eine Kontroll-Checkbox angegeben wird, wird dieses Feld erst angezeigt, wenn das Kontroll-Checkbox Feld angekreuzt ist)
- Vorher Umbruch einfügen (Um dieses Eingabefeld in einer neuen Zeile zu beginnen)
  - Legend Titel (hier kann dann ein Name für den Legend Titel angegeben werden -> die Grün geschriebenen Titel im Backend)
- Enable half width (um 2 Felder nebeneinander anzuzeigen - durch TYPOlight 2.7 möglich)
Backend filter settings (hier kann festgelegt werden ob das Feld im Backend zur Filterung angezeigt wird)
- Sortieren
- Filter
- Suche
Advanced settings
- Pflichtfeld -> Dieses Feld muss ausgefüllt werden
Frontend editing
- Frontend editing groups -> Welche Gruppen dürfen dieses Feld im Frontend bearbeiten (Mehrfach Angabe ist Möglich). Wenn hier nichts angegeben wird, dürfen alle Gruppen dieses Feld im Frontend editieren

Typ - Feldtypen von Feldern

Hier werden die Angaben für die jeweiligen Typen aufgelistet und erläutert.

Text

Format settings
- Prefix und Suffix Strings
- Format
  - Formattyp
    - Zeichenkette
    - Nummer
    - Datum
  - Zeichenfolge für Formatierung

Alias

Es ist immer nur ein Alias Feld erlaubt in einem Katalog. Die Funktion ist die selbe wie bei einem Alias für eine Seite.

Alias-Titel-Feld (Aus diesem Feld wird automatisch ein Alias generiert, wenn keine Angabe beim Alias gemacht wurde. Dieses Feld muss nicht Eindeutig sein. Der Alias wird aber eindeutig generiert und ist damit genau so benutzbar wie eine eindeutige ID)

Langtext

Advanced settings
- Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von TYPOlight editierbar)
- Rich Text (wenn angekreuzt wird der TinyMCE angezeigt)

Nummer

Advanced settings
- Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
- Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
Format settings
- Prefix und Suffix Strings
- Format
  - Formattyp
    - Zeichenkette
    - Nummer
    - Datum
  - Zeichenfolge für Formatierung

Dezimal

Advanced settings
- Minimum (legt den Minimalwert fest, den ein Benutzer eingeben kann)
- Maximum (legt den Maximalwert fest, den ein Benutzer eingeben kann)
Format settings
- Prefix und Suffix Strings
- Format
  - Formattyp
    - Zeichenkette
    - Nummer
    - Datum
  - Zeichenfolge für Formatierung

Datum

Advanced settings
- Zeiteingabe (Falls ausgewählt, darf der Benutzer Datum und Zeit eingeben
- Format
  - Formattyp
    - Zeichenkette
    - Nummer
    - Datum
  - Zeichenfolge für Formatierung

Checkbox

Zum erstellen einer einfachen Checkbox. Hier kann nicht viel eingestellt werden, da ja nur 1 oder 0 als Zustand gillt.

Auswahl

Hiermit kann man eine Auswahl (Select Feld) erstellen, die als Grundlage eine andere Tabelle nutzt. Das kann Taxonomie sein oder auch ein anderer Katalog.

Advanced settings
- Include blank option (Um bei der drop-down Liste auch die Möglichkeit zu haben eine leere Auswahl anzubieten)
Options settings
- Tabelle für Optionen (Hier muss die Tabelle ausgewählt werden wo die Optionen drinn stehen - Taxonomie wäre -> tl_taxonomie)
- Spalte für Tabellenwerte (Eine Spalte für die Speicherung einer Option auswählen. Hier sind nur die Spalten vorgegeben, die sich auch in der Tabelle befinden)
- Anzeige der Sortierspalte (Um die Sortierung der Optionen vorzunehmen kann hier eine andere Spalte ausgewählt werden.)
- Filter items (Hier kann man wieder eigene Filter definieren um die Auswahl einzugrenzen)
- Auswahl der Einträge
  - Optionen (Hier kann man noch mal genau Auswählen welche Optionen man anbieten möchte)
  - Modus für Unterauswahl
    - Show selected items collapsed (Nur die ausgewählten Items anzeigen)
    - Show children of selected items collapsed (Nur die Kinder der selectierten Items anzeigen)
    - Tree with all items selectable (Baumansicht mit allen Items als Option auswählbar)
    - Tree with only children selectable (Baumansicht nur mit den Kind-Items auswählbar)
  - Parent Filter (Hier kann man das Eltern Element angeben, welches die Optionen enthält. Praktisch wenn man 2 Bäume bei der Taxonomie hat und nur einen zur Auswahl geben will)

URL

Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der ein und ausgabe einer URL.

Datei

Dieser Feldtyp ist für die Ein- und Ausgabe von Dateien vorhanden. Man kann damit Downloads oder Galerien erstellen.

Advanced Settings
- Mehrere Dateien (Wenn Ausgewählt können mehrere Dateien ausgewählt werden)
- Ändern des Dateibaumes
  - Setzen des Ordners für das Wurzelverzeichnis (Hier kann ein spezieller Dateibaum gewählt werden, um unnötige Wege zu verkürzen)
  - Gültige Dateitypen (In einer Komma-separierten Liste kann man hier die Dateitypen auf eine Gültige Liste einschränken)
  - Nur Dateien erlauben (Ordner sind dann nicht anwählbar)
Format settings
- Bild anzeigen (Um ein Bild / eine Bildergalerie anzeigen zu lassen)
  - Bildbreite und höhe sind auswählbar
- Link erzeugen
  - Um einen Link zum herunterladen der Datei zu erzeugen oder bei einem Bild eine Vollansicht (Lightbox) anzubieten

Calculate

Um Berechnungen auf SQL Ebene vorzunehmen

Calculation formula (Eingabe von einer SQL calculation für das Feld, wie '(price*1.15)*qty'
Format settings
- Prefix und Suffix Strings
- Format
  - Formattyp
    - Zeichenkette
    - Nummer
    - Datum
  - Zeichenfolge für Formatierung

Bewertungen

Die Besucher der Internetseite können bei angabe eines solchen Feldtypes eine Bewertung vornehmen

ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

Zugriffszähler

Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde.

Frontend Benutzer

Ohne Optionen. Um die Items nur dem jeweiligen Frontendbenutzer der sie angelegt hat zuzuweisen muss ein Feldtyp dieser Art angelegt sein.

Meta Keywords

Ohne Optionen. Um eine Liste von Keywords für diese Item eingeben zu können.

Mehrspaltiger Text

Hiermit kann ein Feld ähnlich des Tabellenelements in TYPOlight angelegt werden. Man definiert einmal die Spaltenanzahl und Überschriften. Beim Anlegen des Items hat man dann die Möglichkeit beliebig viele Zeilen anzugeben.

Spaltenüberschriften (Angabe der Anzahl, der Reihenfolge und der Titel der Spaltenüberschriften)

Produktvariante (Besonderheit vom chshop -> wird dort erläutert)

Sobald man Felder definiert hat

ist in der Übersicht bei den Feldern zu sehen ob ein Feld:

zur Suche markiert ist
Sortierbar ist
Gruppiert wurde (um die Reihenfolge festzulegen)
ein Pflichtfeld ist
ob es eine Kontrol Checkbox ist (nur wenn angewählt wird es sichtbar)
Ob es ein Dateityp ist
Ob es sich um ein Bild handelt
in der halben Breite im Backend angezeigt wird
Ob darüber ein Filter angewendet wird

--MacKP 13:02, 5. Apr. 2010 (UTC)

Catalog

Aus Contao Community Documentation

Inhaltsverzeichnis