Contao Community Documentation - Benutzerbeiträge [de]

Catalog

2013-03-06T07:00:36Z

Carino: /* Sortierung des Datums per Endzeit bzw. Anfangszeit (für Veranstaltungskalender o.ä.) */

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder eine Immobilienverwaltung (mit Frontendeingabe und Workflow) oder einer Rezeptdatenbank (zu sehen auf [http://catalogdemo.dasprojekt.org http://catalogdemo.dasprojekt.org] ).

Da dieses Modul sehr komplex ist, findet man einzelne Dokumentationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Beschreibung=
Definieren von mehrfachen individuellen Katalogen, individuellen Feldtypen und zahlreichen Frontend-Anzeige-Formatierungs-Möglichkeiten.
Dieses Modul erlaubt es Benutzern, Kataloge mit Einträgen zu definieren und zu verwalten. Stellen Sie sich vor, Sie möchten einem Besucher Ihrer Seite eine Liste mit Ihren Spielen zeigen. Sie haben viele Spiele, aber alle haben gleiche bestimmte Eigenschaften, wie z.B. Titel, Autor, Genre, Konsolenformat, Veröffentlichungsdatum usw. Sie möchten nun alle diese Informationen speichern und später dann Besuchern zeigen, ihnen dabei nur Spiele zeigen aus dem Motorsport-Bereich oder Spiele mit einem Preis über einer bestimmten Höhe, nur Spiele, die verfügbar sind usw. Dieses Modul erlaubt Ihnen, solche Dinge zu tun.

Quelle: [http://www.contao.org/erweiterungsliste/view/catalog.html Beschreibungstext des Catalog-Moduls in der Extension-Repository]

=Contao2go Catalog Version=

Da die größte Schwierigkeit darin besteht, zu sehen was man einstellen muss um gewisse Ergebnisse zu bekommen wurde ein Catalog erstellt, mit dem man ein wenig rumspielen kann. Die aktuelle Version kann immer über diesen Link bezogen werden: [http://catalog.mediendepot-ruhr.de http://catalog.mediendepot-ruhr.de]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
==Catalog aus dem Contao-Repository==
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

==Catalog aus dem Entwicklungs-Repository==
Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden.

Man sollte darauf achten, welche Ordner wohin in der Installation kommen:
* der Inhalt von /drivers nach /system/drivers/
* alle anderen Ordner (bis auf /custumnav) nach /system/modules/
* /customnav wird nicht benötigt

Danach muss ein Update der Datenbank gemacht werden.

Eventuell fehlende Sprachdateien können aus den Übersetzungen der Version im Contao-Extension-Repository manuell hinzugefügt werden. So kann dafür gesorgt werden, dass der Catalog dann (weitgehend) in einer Übersetzung benutzt werden kann.

{{Hinweis|Bei einem Update muss seit Version r239 einmal unter Katalog (Menü von Contao) ganz oben rechts auf 'Maintenance' geklickt werden um die Tags Felder neu aufbauen lassen.}}

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

Katalogfelder vom Typ "Taxonomie" müssen umgestellt werden auf "Auswahl" mit der Datentabelle "tl_taxonomy", Option Spaltenwert = name. Für eine schönere Darstellung aktiviert man "Die Optionsauswahl individualisieren", dann kann man auch Teilbereiche aus der Taxonomie vorgeben und die Anzeige auf "Baum nur mit auswählbaren Kindeinträgen" stellen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* 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)

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. 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 für die URLs der Alias genutzt. Es muss kein Alias-Feld erstellt werden, es werden dann Text-Felder mit der Eigenschaft 'Eindeutig' zur Auswahl angeboten. Bei dieser Methode (ohne Alias-Feld) wird der Alias allerdings nicht in eine sichere Form konvertiert. 'Föö Bar' !-> 'foefoe-bar'.
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* 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 Contao 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) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* 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 machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=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. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==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ärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, 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 - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** 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 (Mehrfachangabe 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.)
{{Hinweis|Es ist darauf zu achten, dass beim Anlegen der Felder das Feld ''Alias'' '''nach''' dem Feld ''Titel'' plaziert wird, da sonst der Alias nicht korrekt generiert bzw. nur die ID gesetzt wird.}}

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao 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

Möchte man im Feld ''Date'' immer das aktuelle Datum beim Anlegen eines Items verwenden, kann man in den erweiterten Einstellungen des Date-Feldes beim Standartwert den Wert '''date()''' eintragen.

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

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das 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, in der die Optionen 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 selektierten 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)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* 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, in der die Optionen 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)

Bis catalog Version 2.0.0 beta2 Build 59 kann man nicht [https://www.contao-community.de/showthread.php?27484-Wieso-kein-BE-Filter-f%FCr-Feld-vom-Typ-quot-Tags-quot&p=183047&viewfull=1#post183047 Tags Felder als Filter in Backend-Listenansichten verwenden]. Ein par Zeilen Code helfen dem aber nach. Wie das geht steht im verlinkten Forumbeitrag.

===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. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* 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

===Berechnen===
Um Berechnungen auf SQL Ebene vorzunehmen
* Berechnungsformel
** Beispiel einer SQL-Berechnung, wenn man einen numerischen Wert erhalten will -> (price*1.15)*qty
** Beispiel einer SQL-Berechnung, wenn man mehrere Texte zu einer Textzeichenfolge verknüpfen will -> CONCAT('Adresse: ', col_adresse , ', ' , col_plz , ' ' , col_ort)
* Format-Einstellungen
** Vor- und Nachsilben
** Format
*** Format-Funktion
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung oder Parameter

===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. Hiermit wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick pro IP und Tag festgelegt.

===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.
{{Anmerkung|der Feldtyp "Meta Keywords" ist veraltet, da in der Katalog Konfiguration direkt nun ein Textfeld als Quelle der META Keywords gewählt werden kann.}}

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao 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)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

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

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==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

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Fields (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Selectfield aus dem gewählten Katalog. (Andere Felder wie Tagfield gehen nicht und stehen deswegen nicht zur Auswahl!)
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
{{Anmerkung|Der folgende Punkt ist in catalog 2.0.0 beta1 Build 51 nicht, oder nicht mehr vorhanden!}}
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

Vorgehensweise:
* Installation der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement]
* In ''Inhalte -- Katalog'' auf die Büroklammer klicken, um ein Template für das Inhaltselement anzulegen. ''Wichtig:'' Erst den Katalog auswählen, dann auf ''speichern'' klicken. Nun erscheint zwar eine Fehlermeldung, aber auch alle nötigen Informationen, um die Einstellungen vollständig vorzunehmen.
* Nun kann unter ''Inhalte -- Artikel'' das Inhaltselement auf eienr beliebigen Seite plaziert werden. Das vorher konfigurierte Template und den Katalogeintrag können in den Einstellungen ausgewählt werden.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
oder
<source lang="php">
<?php $this->showTemplateVars(); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

'''Achtung: Diese Anweisung stellt ein potenzielles Sicherheitsrisiko dar und muss vor dem Produktiveinsatz entfernt werden.'''

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu braucht man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden, sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''
Wenn das Aliasfeld nicht angelegt ist wird das Item per ID verlinkt.

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort,search" angegeben werden. Dadurch ignoriert Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht im Feld "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==

Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC). Im Backend können Einträge nur dann manuell sortiert (verschoben) werden, wenn bei keinem Feld die Einstellung 'Sortier DropDown aktivieren' aktiv ist.

{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]
[[http://code.google.com/p/typolight-catalog/issues/detail?id=199 Bug-Report]] [[http://code.google.com/p/typolight-catalog/source/detail?r=198 fixed in r198]]}}

{{Hinweis|Mit der Erweiterung [[catalog_manualsort]] ist es möglich die Reihenfolge der Einträge im Backend trotzdem zu ändern, auch wenn die Sortieroption für bestimmte Felder aktiv ist.}}

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf die '''Sortierungs Option''' (Feld-Eigenschaften->Backend Filter Einstellungen->'Sortierungs Dropdown aktivieren') '''bei keinem Feld aktiviert''' sein.
{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]}}

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatieren der Felder vom Typ Text, Nummer und Dezimal==
Options-Checkbox: '''Zusätzliche Format-Funktionen aktivieren.'''

Das Auswahlmenü '''Format-Funktion''' erlaubt es, die Feldtypen '''Text''', '''Nummer''' und '''Dezimal''' zu formatieren. So gehts:

=== Zeichenkette ===
Hier gibt man einen sprintf Formatierungs-String ein (siehe [http://de3.php.net/sprintf PHP: sprintf - Manual])

''Beispiel Zeichenkette:''
* '''Feldinhalt:''' Broccoli
* '''Formatierungs-String:''' Auf zum %s!
* '''Ausgabe:''' Auf zum Broccoli!

=== Nummer ===
Hier gibt man nur die Anzahl der gewünschten Nachkommastellen an. In der Ausgabe erscheinen nun die in Contao festgelegten Tausender- und Dezimal-Trennzeichen.

''Beispiel Nummer:''
* '''Feldinhalt:''' 1000
* '''Nachkommastellen:''' 2
* '''Ausgabe:''' 1.000,00

=== Datum ===
Hier gibt man ein Formatierungsmuster ein (siehe [http://de.php.net/manual/de/function.date.php PHP: date - Manual])

''Beispiel Datum:''
* '''Feldinhalt (Unix Timestamp):''' 1293217200
* '''Formatierungsmuster:''' Y-m-d H:i
* '''Ausgabe:''' 2010-12-24 18:00

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

Ausgabe für das aktuelle Jahr + 1 weiteres Jahr:
<source>
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP(DATE_ADD('{{date::Y}}-12-31',INTERVAL 1 YEAR))
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesentlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann man die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können, muss darauf geachtet werden, dass diese UTF-8 kodiert sind. Das wird von Excel nicht direkt so gemacht.
Hier ist OpenOffice eine valable Alternative. Hier bieten sich sowohl beim Import (wie auch beim Export) von .csv Dateien diverse Einstellungsmöglichkeiten an.

Der Import von Daten kann in zwei Varianten erfolgen:
# Variante: Die Daten werden nach dem letzten Eintrag in der Datenbank eingetragen.
# Variante: Die bestehehenden werden gelöscht und dann neu eingetragen. Hierbei zählt aber die ID weiter!

[[Datei:Cat-openoffice-import.png|Screen Textimport]]

Standardmässig ist die Möglichkeit .csv Dateien zu importieren nicht aktiviert. Klick hierzu zuerst im Übersichtsfeld des Katalogs auf 'Bearbeiten'.
Dann unter 'Import' die jeweilige Option anklicken.

[[Datei:Cat-csv-import.png|Option CSV-Import aktivieren]]

==Mehrsprachige Filter mit dem Taxonomie Modul==
Möchte man einen Mehrsprachigen Katalog erstellen und diesen nach Taxonomien Filtern, so gibt es u.a. zwei Möglichkeiten dies zu tun:
* Für jede Sprache einen Taxonomiebaum erstellen. Problem: Doppelte Zuweisung im Katalog-Item + mehrere Taxonomiebäume
* Bessere Lösung: Man arbeitet mit den sprachabhängigen Inserttags. So kann man je nach Spracheinstellungen der Seite eine passende Frontend-Ausgabe erreichen.

Beispiel:
Möchte man jedem Item ein Land zuordnen, so erstellt man einen Taxonomie-Eintrag "Länder" und in fügt in diesen die auswählbaren Länder ein. Für "Deutschland" könnte das dann z.B. so aussehen:
<nowiki>{{iflng::de}}</nowiki>Deutschland<nowiki>{{iflng}}{{iflng::en}}</nowiki>Germany<nowiki>{{iflng}}</nowiki>
Nun sollte der Filter auf der deutschen Seite "Deutschland", und auf der englischen "Germany" ausgeben.
Dabei gibt es allerdings ein Problem mit dem Feldtyp in der Datenbank. Dieser ist auf wenige Zeichen beschränkt, wird somit bei entsprechender Länge gekürzt. Um dies '''nicht updatesicher''' zu korrigieren, muss man ins phpMyAdmin gehen und unter tl_taxonomy die Länge des entsprechenden Feldes (ich glaube es ist: "name") ändern. (wird später genauer beschrieben)

==Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt==
Beispiel:
Katalog A hat ein Select wo man Items aus Katalog B auswählen kann.

<source lang="sql">(SELECT sorting FROM catalog_tabellenname AS cs WHERE cs.id=catalog_feld) ASC</source>

catalog_tabellenname = Tabelle die das Feld beinhaltet (Katalog B)
catalog_feld = Name von dem Feld welches im Select genutz wird. (Feld in Katalog B)

==Sortierung des Datums per Endzeit bzw. Anfangszeit (für Veranstaltungskalender o.ä.) ==
Beispiel:
Damit werden vom Enddatum abhängig sämtliche Datensätze (Events) angezeigt, die jetzt oder später stattfinden, unabhängig davon ob ein Enddatum gewählt wurde oder nicht.
Wenn nicht, wird stattdessen das Beginndatum als Grundlage genommen. Die Anweisung gehört in das Bedingungsfeld (Conditions) innerhalb des Cataloglistenmoduls.

<source lang="sql">
publish = 1 AND kategorie IN (82, 77, 80, 81) AND
(
(ende != '' AND ende >= UNIX_TIMESTAMP())
OR beginn >= UNIX_TIMESTAMP()
)
</source>

'''Felder:'''
beginn = Startdatum
ende = Enddatum
kategorie = Taxonomie

==Frontendausgabe über Taxonomie sortieren==
Problemstellung: Wenn man bei einem Katalog ein Selectfeld einsetzt, welches man auf eine Taxonomie referenziert, kommt es zu Problemen in der Sortierung.

Beispielausgabe im FE:

[[Taxonomie 1]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 2]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 3]]
- Item 1
...

<source lang="sql">FIND_IN_SET(servicesolutions, (

SELECT GROUP_CONCAT(CAST(id AS CHAR) ORDER BY cs.sorting) FROM tl_taxonomy AS cs WHERE cs.pid=34 group by cs.pid

)) ,name</source>

servicesolutions (Feldname des genutzten Kataloges, welches auf die Taxonomie referenziert wird)
pid=34 (Das Elternelement in der Taxonomie, nach denen die Kindelemente sortiert werden soll.

----

==Katalogeinträge an den Frontend-Benutzer binden==

Um Katalogeinträge an den Frontend-Benutzer zu binden, kann die Erweiterung [http://www.contao.org/erweiterungsliste/view/catalogitemuseridfield.de.html catalogitemuseridfield] installiert werden.

Nach der Installation besteht die Möglichkeit ein Feld mit dem Feldtyp Frontend-Benutzer im Catalog zu definieren.
In diesem Feld wird die User ID des Frontend-Benutzers gespeichert und kann so z.B. in den Bedingungen verknüpft werden.

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

--[[Benutzer:Nils.riel|Nils.riel]] 12:04, 24. Nov. 2010 (CET)

--[[Benutzer:Carino|Carino]] 19:00, 24. Nov. 2012 (UTC+1)

Catalog

2013-03-06T06:59:24Z

Carino: /* Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt */

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder eine Immobilienverwaltung (mit Frontendeingabe und Workflow) oder einer Rezeptdatenbank (zu sehen auf [http://catalogdemo.dasprojekt.org http://catalogdemo.dasprojekt.org] ).

Da dieses Modul sehr komplex ist, findet man einzelne Dokumentationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Beschreibung=
Definieren von mehrfachen individuellen Katalogen, individuellen Feldtypen und zahlreichen Frontend-Anzeige-Formatierungs-Möglichkeiten.
Dieses Modul erlaubt es Benutzern, Kataloge mit Einträgen zu definieren und zu verwalten. Stellen Sie sich vor, Sie möchten einem Besucher Ihrer Seite eine Liste mit Ihren Spielen zeigen. Sie haben viele Spiele, aber alle haben gleiche bestimmte Eigenschaften, wie z.B. Titel, Autor, Genre, Konsolenformat, Veröffentlichungsdatum usw. Sie möchten nun alle diese Informationen speichern und später dann Besuchern zeigen, ihnen dabei nur Spiele zeigen aus dem Motorsport-Bereich oder Spiele mit einem Preis über einer bestimmten Höhe, nur Spiele, die verfügbar sind usw. Dieses Modul erlaubt Ihnen, solche Dinge zu tun.

Quelle: [http://www.contao.org/erweiterungsliste/view/catalog.html Beschreibungstext des Catalog-Moduls in der Extension-Repository]

=Contao2go Catalog Version=

Da die größte Schwierigkeit darin besteht, zu sehen was man einstellen muss um gewisse Ergebnisse zu bekommen wurde ein Catalog erstellt, mit dem man ein wenig rumspielen kann. Die aktuelle Version kann immer über diesen Link bezogen werden: [http://catalog.mediendepot-ruhr.de http://catalog.mediendepot-ruhr.de]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
==Catalog aus dem Contao-Repository==
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

==Catalog aus dem Entwicklungs-Repository==
Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden.

Man sollte darauf achten, welche Ordner wohin in der Installation kommen:
* der Inhalt von /drivers nach /system/drivers/
* alle anderen Ordner (bis auf /custumnav) nach /system/modules/
* /customnav wird nicht benötigt

Danach muss ein Update der Datenbank gemacht werden.

Eventuell fehlende Sprachdateien können aus den Übersetzungen der Version im Contao-Extension-Repository manuell hinzugefügt werden. So kann dafür gesorgt werden, dass der Catalog dann (weitgehend) in einer Übersetzung benutzt werden kann.

{{Hinweis|Bei einem Update muss seit Version r239 einmal unter Katalog (Menü von Contao) ganz oben rechts auf 'Maintenance' geklickt werden um die Tags Felder neu aufbauen lassen.}}

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

Katalogfelder vom Typ "Taxonomie" müssen umgestellt werden auf "Auswahl" mit der Datentabelle "tl_taxonomy", Option Spaltenwert = name. Für eine schönere Darstellung aktiviert man "Die Optionsauswahl individualisieren", dann kann man auch Teilbereiche aus der Taxonomie vorgeben und die Anzeige auf "Baum nur mit auswählbaren Kindeinträgen" stellen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* 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)

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. 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 für die URLs der Alias genutzt. Es muss kein Alias-Feld erstellt werden, es werden dann Text-Felder mit der Eigenschaft 'Eindeutig' zur Auswahl angeboten. Bei dieser Methode (ohne Alias-Feld) wird der Alias allerdings nicht in eine sichere Form konvertiert. 'Föö Bar' !-> 'foefoe-bar'.
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* 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 Contao 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) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* 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 machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=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. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==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ärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, 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 - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** 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 (Mehrfachangabe 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.)
{{Hinweis|Es ist darauf zu achten, dass beim Anlegen der Felder das Feld ''Alias'' '''nach''' dem Feld ''Titel'' plaziert wird, da sonst der Alias nicht korrekt generiert bzw. nur die ID gesetzt wird.}}

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao 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

Möchte man im Feld ''Date'' immer das aktuelle Datum beim Anlegen eines Items verwenden, kann man in den erweiterten Einstellungen des Date-Feldes beim Standartwert den Wert '''date()''' eintragen.

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

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das 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, in der die Optionen 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 selektierten 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)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* 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, in der die Optionen 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)

Bis catalog Version 2.0.0 beta2 Build 59 kann man nicht [https://www.contao-community.de/showthread.php?27484-Wieso-kein-BE-Filter-f%FCr-Feld-vom-Typ-quot-Tags-quot&p=183047&viewfull=1#post183047 Tags Felder als Filter in Backend-Listenansichten verwenden]. Ein par Zeilen Code helfen dem aber nach. Wie das geht steht im verlinkten Forumbeitrag.

===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. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* 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

===Berechnen===
Um Berechnungen auf SQL Ebene vorzunehmen
* Berechnungsformel
** Beispiel einer SQL-Berechnung, wenn man einen numerischen Wert erhalten will -> (price*1.15)*qty
** Beispiel einer SQL-Berechnung, wenn man mehrere Texte zu einer Textzeichenfolge verknüpfen will -> CONCAT('Adresse: ', col_adresse , ', ' , col_plz , ' ' , col_ort)
* Format-Einstellungen
** Vor- und Nachsilben
** Format
*** Format-Funktion
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung oder Parameter

===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. Hiermit wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick pro IP und Tag festgelegt.

===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.
{{Anmerkung|der Feldtyp "Meta Keywords" ist veraltet, da in der Katalog Konfiguration direkt nun ein Textfeld als Quelle der META Keywords gewählt werden kann.}}

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao 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)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

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

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==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

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Fields (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Selectfield aus dem gewählten Katalog. (Andere Felder wie Tagfield gehen nicht und stehen deswegen nicht zur Auswahl!)
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
{{Anmerkung|Der folgende Punkt ist in catalog 2.0.0 beta1 Build 51 nicht, oder nicht mehr vorhanden!}}
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

Vorgehensweise:
* Installation der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement]
* In ''Inhalte -- Katalog'' auf die Büroklammer klicken, um ein Template für das Inhaltselement anzulegen. ''Wichtig:'' Erst den Katalog auswählen, dann auf ''speichern'' klicken. Nun erscheint zwar eine Fehlermeldung, aber auch alle nötigen Informationen, um die Einstellungen vollständig vorzunehmen.
* Nun kann unter ''Inhalte -- Artikel'' das Inhaltselement auf eienr beliebigen Seite plaziert werden. Das vorher konfigurierte Template und den Katalogeintrag können in den Einstellungen ausgewählt werden.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
oder
<source lang="php">
<?php $this->showTemplateVars(); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

'''Achtung: Diese Anweisung stellt ein potenzielles Sicherheitsrisiko dar und muss vor dem Produktiveinsatz entfernt werden.'''

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu braucht man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden, sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''
Wenn das Aliasfeld nicht angelegt ist wird das Item per ID verlinkt.

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort,search" angegeben werden. Dadurch ignoriert Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht im Feld "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==

Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC). Im Backend können Einträge nur dann manuell sortiert (verschoben) werden, wenn bei keinem Feld die Einstellung 'Sortier DropDown aktivieren' aktiv ist.

{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]
[[http://code.google.com/p/typolight-catalog/issues/detail?id=199 Bug-Report]] [[http://code.google.com/p/typolight-catalog/source/detail?r=198 fixed in r198]]}}

{{Hinweis|Mit der Erweiterung [[catalog_manualsort]] ist es möglich die Reihenfolge der Einträge im Backend trotzdem zu ändern, auch wenn die Sortieroption für bestimmte Felder aktiv ist.}}

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf die '''Sortierungs Option''' (Feld-Eigenschaften->Backend Filter Einstellungen->'Sortierungs Dropdown aktivieren') '''bei keinem Feld aktiviert''' sein.
{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]}}

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatieren der Felder vom Typ Text, Nummer und Dezimal==
Options-Checkbox: '''Zusätzliche Format-Funktionen aktivieren.'''

Das Auswahlmenü '''Format-Funktion''' erlaubt es, die Feldtypen '''Text''', '''Nummer''' und '''Dezimal''' zu formatieren. So gehts:

=== Zeichenkette ===
Hier gibt man einen sprintf Formatierungs-String ein (siehe [http://de3.php.net/sprintf PHP: sprintf - Manual])

''Beispiel Zeichenkette:''
* '''Feldinhalt:''' Broccoli
* '''Formatierungs-String:''' Auf zum %s!
* '''Ausgabe:''' Auf zum Broccoli!

=== Nummer ===
Hier gibt man nur die Anzahl der gewünschten Nachkommastellen an. In der Ausgabe erscheinen nun die in Contao festgelegten Tausender- und Dezimal-Trennzeichen.

''Beispiel Nummer:''
* '''Feldinhalt:''' 1000
* '''Nachkommastellen:''' 2
* '''Ausgabe:''' 1.000,00

=== Datum ===
Hier gibt man ein Formatierungsmuster ein (siehe [http://de.php.net/manual/de/function.date.php PHP: date - Manual])

''Beispiel Datum:''
* '''Feldinhalt (Unix Timestamp):''' 1293217200
* '''Formatierungsmuster:''' Y-m-d H:i
* '''Ausgabe:''' 2010-12-24 18:00

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

Ausgabe für das aktuelle Jahr + 1 weiteres Jahr:
<source>
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP(DATE_ADD('{{date::Y}}-12-31',INTERVAL 1 YEAR))
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesentlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann man die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können, muss darauf geachtet werden, dass diese UTF-8 kodiert sind. Das wird von Excel nicht direkt so gemacht.
Hier ist OpenOffice eine valable Alternative. Hier bieten sich sowohl beim Import (wie auch beim Export) von .csv Dateien diverse Einstellungsmöglichkeiten an.

Der Import von Daten kann in zwei Varianten erfolgen:
# Variante: Die Daten werden nach dem letzten Eintrag in der Datenbank eingetragen.
# Variante: Die bestehehenden werden gelöscht und dann neu eingetragen. Hierbei zählt aber die ID weiter!

[[Datei:Cat-openoffice-import.png|Screen Textimport]]

Standardmässig ist die Möglichkeit .csv Dateien zu importieren nicht aktiviert. Klick hierzu zuerst im Übersichtsfeld des Katalogs auf 'Bearbeiten'.
Dann unter 'Import' die jeweilige Option anklicken.

[[Datei:Cat-csv-import.png|Option CSV-Import aktivieren]]

==Mehrsprachige Filter mit dem Taxonomie Modul==
Möchte man einen Mehrsprachigen Katalog erstellen und diesen nach Taxonomien Filtern, so gibt es u.a. zwei Möglichkeiten dies zu tun:
* Für jede Sprache einen Taxonomiebaum erstellen. Problem: Doppelte Zuweisung im Katalog-Item + mehrere Taxonomiebäume
* Bessere Lösung: Man arbeitet mit den sprachabhängigen Inserttags. So kann man je nach Spracheinstellungen der Seite eine passende Frontend-Ausgabe erreichen.

Beispiel:
Möchte man jedem Item ein Land zuordnen, so erstellt man einen Taxonomie-Eintrag "Länder" und in fügt in diesen die auswählbaren Länder ein. Für "Deutschland" könnte das dann z.B. so aussehen:
<nowiki>{{iflng::de}}</nowiki>Deutschland<nowiki>{{iflng}}{{iflng::en}}</nowiki>Germany<nowiki>{{iflng}}</nowiki>
Nun sollte der Filter auf der deutschen Seite "Deutschland", und auf der englischen "Germany" ausgeben.
Dabei gibt es allerdings ein Problem mit dem Feldtyp in der Datenbank. Dieser ist auf wenige Zeichen beschränkt, wird somit bei entsprechender Länge gekürzt. Um dies '''nicht updatesicher''' zu korrigieren, muss man ins phpMyAdmin gehen und unter tl_taxonomy die Länge des entsprechenden Feldes (ich glaube es ist: "name") ändern. (wird später genauer beschrieben)

==Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt==
Beispiel:
Katalog A hat ein Select wo man Items aus Katalog B auswählen kann.

<source lang="sql">(SELECT sorting FROM catalog_tabellenname AS cs WHERE cs.id=catalog_feld) ASC</source>

catalog_tabellenname = Tabelle die das Feld beinhaltet (Katalog B)
catalog_feld = Name von dem Feld welches im Select genutz wird. (Feld in Katalog B)

==Sortierung des Datums per Endzeit bzw. Anfangszeit (für Veranstaltungskalender o.ä.) ==
Beispiel:
Damit werden vom Enddatum abhängig sämtliche Datensätze (Events) angezeigt, die jetzt oder später stattfinden, unabhängig davon ob ein Enddatum gewählt wurde oder nicht.
Wenn nicht, wird stattdessen das Beginndatum als Grundlage genommen.

<source lang="sql">
publish = 1 AND kategorie IN (82, 77, 80, 81) AND
(
(ende != '' AND ende >= UNIX_TIMESTAMP())
OR beginn >= UNIX_TIMESTAMP()
)
</source>

'''Felder:'''
beginn = Startdatum
ende = Enddatum
kategorie = Taxonomie

==Frontendausgabe über Taxonomie sortieren==
Problemstellung: Wenn man bei einem Katalog ein Selectfeld einsetzt, welches man auf eine Taxonomie referenziert, kommt es zu Problemen in der Sortierung.

Beispielausgabe im FE:

[[Taxonomie 1]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 2]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 3]]
- Item 1
...

<source lang="sql">FIND_IN_SET(servicesolutions, (

SELECT GROUP_CONCAT(CAST(id AS CHAR) ORDER BY cs.sorting) FROM tl_taxonomy AS cs WHERE cs.pid=34 group by cs.pid

)) ,name</source>

servicesolutions (Feldname des genutzten Kataloges, welches auf die Taxonomie referenziert wird)
pid=34 (Das Elternelement in der Taxonomie, nach denen die Kindelemente sortiert werden soll.

----

==Katalogeinträge an den Frontend-Benutzer binden==

Um Katalogeinträge an den Frontend-Benutzer zu binden, kann die Erweiterung [http://www.contao.org/erweiterungsliste/view/catalogitemuseridfield.de.html catalogitemuseridfield] installiert werden.

Nach der Installation besteht die Möglichkeit ein Feld mit dem Feldtyp Frontend-Benutzer im Catalog zu definieren.
In diesem Feld wird die User ID des Frontend-Benutzers gespeichert und kann so z.B. in den Bedingungen verknüpft werden.

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

--[[Benutzer:Nils.riel|Nils.riel]] 12:04, 24. Nov. 2010 (CET)

--[[Benutzer:Carino|Carino]] 19:00, 24. Nov. 2012 (UTC+1)

Catalog

2012-11-24T18:00:42Z

Carino: /* Frontendausgabe über Taxonomie sortieren */

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder eine Immobilienverwaltung (mit Frontendeingabe und Workflow) oder einer Rezeptdatenbank (zu sehen auf [http://catalogdemo.dasprojekt.org http://catalogdemo.dasprojekt.org] ).

Da dieses Modul sehr komplex ist, findet man einzelne Dokumentationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Beschreibung=
Definieren von mehrfachen individuellen Katalogen, individuellen Feldtypen und zahlreichen Frontend-Anzeige-Formatierungs-Möglichkeiten.
Dieses Modul erlaubt es Benutzern, Kataloge mit Einträgen zu definieren und zu verwalten. Stellen Sie sich vor, Sie möchten einem Besucher Ihrer Seite eine Liste mit Ihren Spielen zeigen. Sie haben viele Spiele, aber alle haben gleiche bestimmte Eigenschaften, wie z.B. Titel, Autor, Genre, Konsolenformat, Veröffentlichungsdatum usw. Sie möchten nun alle diese Informationen speichern und später dann Besuchern zeigen, ihnen dabei nur Spiele zeigen aus dem Motorsport-Bereich oder Spiele mit einem Preis über einer bestimmten Höhe, nur Spiele, die verfügbar sind usw. Dieses Modul erlaubt Ihnen, solche Dinge zu tun.

Quelle: [http://www.contao.org/erweiterungsliste/view/catalog.html Beschreibungstext des Catalog-Moduls in der Extension-Repository]

=Contao2go Catalog Version=

Da die größte Schwierigkeit darin besteht, zu sehen was man einstellen muss um gewisse Ergebnisse zu bekommen wurde ein Catalog erstellt, mit dem man ein wenig rumspielen kann. Die aktuelle Version kann immer über diesen Link bezogen werden: [http://catalog.mediendepot-ruhr.de http://catalog.mediendepot-ruhr.de]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
==Catalog aus dem Contao-Repository==
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

==Catalog aus dem Entwicklungs-Repository==
Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden.

Man sollte darauf achten, welche Ordner wohin in der Installation kommen:
* der Inhalt von /drivers nach /system/drivers/
* alle anderen Ordner (bis auf /custumnav) nach /system/modules/
* /customnav wird nicht benötigt

Danach muss ein Update der Datenbank gemacht werden.

Eventuell fehlende Sprachdateien können aus den Übersetzungen der Version im Contao-Extension-Repository manuell hinzugefügt werden. So kann dafür gesorgt werden, dass der Catalog dann (weitgehend) in einer Übersetzung benutzt werden kann.

{{Hinweis|Bei einem Update muss seit Version r239 einmal unter Katalog (Menü von Contao) ganz oben rechts auf 'Maintenance' geklickt werden um die Tags Felder neu aufbauen lassen.}}

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

Katalogfelder vom Typ "Taxonomie" müssen umgestellt werden auf "Auswahl" mit der Datentabelle "tl_taxonomy", Option Spaltenwert = name. Für eine schönere Darstellung aktiviert man "Die Optionsauswahl individualisieren", dann kann man auch Teilbereiche aus der Taxonomie vorgeben und die Anzeige auf "Baum nur mit auswählbaren Kindeinträgen" stellen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* 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)

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. 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 für die URLs der Alias genutzt. Es muss kein Alias-Feld erstellt werden, es werden dann Text-Felder mit der Eigenschaft 'Eindeutig' zur Auswahl angeboten. Bei dieser Methode (ohne Alias-Feld) wird der Alias allerdings nicht in eine sichere Form konvertiert. 'Föö Bar' !-> 'foefoe-bar'.
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* 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 Contao 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) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* 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 machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=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. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==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ärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, 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 - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** 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 (Mehrfachangabe 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.)
{{Hinweis|Es ist darauf zu achten, dass beim Anlegen der Felder das Feld ''Alias'' '''nach''' dem Feld ''Titel'' plaziert wird, da sonst der Alias nicht korrekt generiert bzw. nur die ID gesetzt wird.}}

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao 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

Möchte man im Feld ''Date'' immer das aktuelle Datum beim Anlegen eines Items verwenden, kann man in den erweiterten Einstellungen des Date-Feldes beim Standartwert den Wert '''date()''' eintragen.

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

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das 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, in der die Optionen 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 selektierten 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)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* 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, in der die Optionen 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)

Bis catalog Version 2.0.0 beta2 Build 59 kann man nicht [https://www.contao-community.de/showthread.php?27484-Wieso-kein-BE-Filter-f%FCr-Feld-vom-Typ-quot-Tags-quot&p=183047&viewfull=1#post183047 Tags Felder als Filter in Backend-Listenansichten verwenden]. Ein par Zeilen Code helfen dem aber nach. Wie das geht steht im verlinkten Forumbeitrag.

===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. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* 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

===Berechnen===
Um Berechnungen auf SQL Ebene vorzunehmen
* Berechnungsformel
** Beispiel einer SQL-Berechnung, wenn man einen numerischen Wert erhalten will -> (price*1.15)*qty
** Beispiel einer SQL-Berechnung, wenn man mehrere Texte zu einer Textzeichenfolge verknüpfen will -> CONCAT('Adresse: ', col_adresse , ', ' , col_plz , ' ' , col_ort)
* Format-Einstellungen
** Vor- und Nachsilben
** Format
*** Format-Funktion
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung oder Parameter

===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. Hiermit wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick pro IP und Tag festgelegt.

===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.
{{Anmerkung|der Feldtyp "Meta Keywords" ist veraltet, da in der Katalog Konfiguration direkt nun ein Textfeld als Quelle der META Keywords gewählt werden kann.}}

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao 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)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

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

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==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

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Fields (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Selectfield aus dem gewählten Katalog. (Andere Felder wie Tagfield gehen nicht und stehen deswegen nicht zur Auswahl!)
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
{{Anmerkung|Der folgende Punkt ist in catalog 2.0.0 beta1 Build 51 nicht, oder nicht mehr vorhanden!}}
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

Vorgehensweise:
* Installation der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement]
* In ''Inhalte -- Katalog'' auf die Büroklammer klicken, um ein Template für das Inhaltselement anzulegen. ''Wichtig:'' Erst den Katalog auswählen, dann auf ''speichern'' klicken. Nun erscheint zwar eine Fehlermeldung, aber auch alle nötigen Informationen, um die Einstellungen vollständig vorzunehmen.
* Nun kann unter ''Inhalte -- Artikel'' das Inhaltselement auf eienr beliebigen Seite plaziert werden. Das vorher konfigurierte Template und den Katalogeintrag können in den Einstellungen ausgewählt werden.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
oder
<source lang="php">
<?php $this->showTemplateVars(); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

'''Achtung: Diese Anweisung stellt ein potenzielles Sicherheitsrisiko dar und muss vor dem Produktiveinsatz entfernt werden.'''

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu braucht man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden, sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''
Wenn das Aliasfeld nicht angelegt ist wird das Item per ID verlinkt.

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort,search" angegeben werden. Dadurch ignoriert Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht im Feld "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==

Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC). Im Backend können Einträge nur dann manuell sortiert (verschoben) werden, wenn bei keinem Feld die Einstellung 'Sortier DropDown aktivieren' aktiv ist.

{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]
[[http://code.google.com/p/typolight-catalog/issues/detail?id=199 Bug-Report]] [[http://code.google.com/p/typolight-catalog/source/detail?r=198 fixed in r198]]}}

{{Hinweis|Mit der Erweiterung [[catalog_manualsort]] ist es möglich die Reihenfolge der Einträge im Backend trotzdem zu ändern, auch wenn die Sortieroption für bestimmte Felder aktiv ist.}}

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf die '''Sortierungs Option''' (Feld-Eigenschaften->Backend Filter Einstellungen->'Sortierungs Dropdown aktivieren') '''bei keinem Feld aktiviert''' sein.
{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]}}

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatieren der Felder vom Typ Text, Nummer und Dezimal==
Options-Checkbox: '''Zusätzliche Format-Funktionen aktivieren.'''

Das Auswahlmenü '''Format-Funktion''' erlaubt es, die Feldtypen '''Text''', '''Nummer''' und '''Dezimal''' zu formatieren. So gehts:

=== Zeichenkette ===
Hier gibt man einen sprintf Formatierungs-String ein (siehe [http://de3.php.net/sprintf PHP: sprintf - Manual])

''Beispiel Zeichenkette:''
* '''Feldinhalt:''' Broccoli
* '''Formatierungs-String:''' Auf zum %s!
* '''Ausgabe:''' Auf zum Broccoli!

=== Nummer ===
Hier gibt man nur die Anzahl der gewünschten Nachkommastellen an. In der Ausgabe erscheinen nun die in Contao festgelegten Tausender- und Dezimal-Trennzeichen.

''Beispiel Nummer:''
* '''Feldinhalt:''' 1000
* '''Nachkommastellen:''' 2
* '''Ausgabe:''' 1.000,00

=== Datum ===
Hier gibt man ein Formatierungsmuster ein (siehe [http://de.php.net/manual/de/function.date.php PHP: date - Manual])

''Beispiel Datum:''
* '''Feldinhalt (Unix Timestamp):''' 1293217200
* '''Formatierungsmuster:''' Y-m-d H:i
* '''Ausgabe:''' 2010-12-24 18:00

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesentlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann man die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können muss darauf geachtet werden, das diese UTF-8 kodiert sein müssen. Das wird von Excel nicht direkt so gemacht.
Hier ist OpenOffice eine valable Alternative. Hier bieten sich sowohl beim Import (wie auch beim Export) von .csv Dateien diverse Einstellungsmöglichkeiten an.

Der Import von Daten kann in zwei Varianten erfolgen:
# Variante: Die Daten werden nach dem letzten Eintrag in der Datenbank eingetragen.
# Variante: Die bestehehenden werden gelöscht und dann neu eingetragen. Hierbei zählt aber die ID weiter!

[[Datei:Cat-openoffice-import.png|Screen Textimport]]

Standardmässig ist die Möglichkeit .csv Dateien zu importieren nicht aktiviert. Klick hierzu zuerst im Übersichtsfeld des Katalogs auf 'Bearbeiten'.
Dann unter 'Import' die jeweilige Option anklicken.

[[Datei:Cat-csv-import.png|Option CSV-Import aktivieren]]

==Mehrsprachige Filter mit dem Taxonomie Modul==
Möchte man einen Mehrsprachigen Katalog erstellen und diesen nach Taxonomien Filtern, so gibt es u.a. zwei Möglichkeiten dies zu tun:
* Für jede Sprache einen Taxonomiebaum erstellen. Problem: Doppelte Zuweisung im Katalog-Item + mehrere Taxonomiebäume
* Bessere Lösung: Man arbeitet mit den sprachabhängigen Inserttags. So kann man je nach Spracheinstellungen der Seite eine passende Frontend-Ausgabe erreichen.

Beispiel:
Möchte man jedem Item ein Land zuordnen, so erstellt man einen Taxonomie-Eintrag "Länder" und in fügt in diesen die auswählbaren Länder ein. Für "Deutschland" könnte das dann z.B. so aussehen:
<nowiki>{{iflng::de}}</nowiki>Deutschland<nowiki>{{iflng}}{{iflng::en}}</nowiki>Germany<nowiki>{{iflng}}</nowiki>
Nun sollte der Filter auf der deutschen Seite "Deutschland", und auf der englischen "Germany" ausgeben.
Dabei gibt es allerdings ein Problem mit dem Feldtyp in der Datenbank. Dieser ist auf wenige Zeichen beschränkt, wird somit bei entsprechender Länge gekürzt. Um dies '''nicht updatesicher''' zu korrigieren, muss man ins phpMyAdmin gehen und unter tl_taxonomy die Länge des entsprechenden Feldes (ich glaube es ist: "name") ändern. (wird später genauer beschrieben)

==Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt==
Beispiel:
Katalog A hat ein Select wo man Items aus Katalog B auswählen kann.

<source lang="sql">(SELECT sorting FROM catalog_tabellenname AS cs WHERE cs.id=catalog_feld) ASC</source>

catalog_tabellenname = Tabelle die das Feld beinhaltet (Katalog B)
catalog_feld = Name von dem Feld welches im Select genutz wird. (Feld in Katalog B)

==Frontendausgabe über Taxonomie sortieren==
Problemstellung: Wenn man bei einem Katalog ein Selectfeld einsetzt, welches man auf eine Taxonomie referenziert, kommt es zu Problemen in der Sortierung.

Beispielausgabe im FE:

[[Taxonomie 1]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 2]]
- Item 1
- Item 2
- Item 3

[[Taxonomie 3]]
- Item 1
...

<source lang="sql">FIND_IN_SET(servicesolutions, (

SELECT GROUP_CONCAT(CAST(id AS CHAR) ORDER BY cs.sorting) FROM tl_taxonomy AS cs WHERE cs.pid=34 group by cs.pid

)) ,name</source>

servicesolutions (Feldname des genutzten Kataloges, welches auf die Taxonomie referenziert wird)
pid=34 (Das Elternelement in der Taxonomie, nach denen die Kindelemente sortiert werden soll.

----

==Katalogeinträge an den Frontend-Benutzer binden==

Um Katalogeinträge an den Frontend-Benutzer zu binden, kann die Erweiterung [http://www.contao.org/erweiterungsliste/view/catalogitemuseridfield.de.html catalogitemuseridfield] installiert werden.

Nach der Installation besteht die Möglichkeit ein Feld mit dem Feldtyp Frontend-Benutzer im Catalog zu definieren.
In diesem Feld wird die User ID des Frontend-Benutzers gespeichert und kann so z.B. in den Bedingungen verknüpft werden.

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

--[[Benutzer:Nils.riel|Nils.riel]] 12:04, 24. Nov. 2010 (CET)

--[[Benutzer:Carino|Carino]] 19:00, 24. Nov. 2012 (UTC+1)

Catalog

2012-11-24T17:58:39Z

Carino: Ergänzung: Frontendausgabe über Taxonomie sortieren

Das Catalog-Modul ermöglicht eine vielfältige Kategorisierung beliebiger Daten in hierarchischen und flachen Strukturen. Beispiele umfassen [http://www.tuerkischdeutsche-literatur.de Literaturverzeichnisse] oder eine Immobilienverwaltung (mit Frontendeingabe und Workflow) oder einer Rezeptdatenbank (zu sehen auf [http://catalogdemo.dasprojekt.org http://catalogdemo.dasprojekt.org] ).

Da dieses Modul sehr komplex ist, findet man einzelne Dokumentationen in der Kategorie [[:Category:Catalog|Catalog]].

{{AppliesTo
|TLVersion=ab 2.8
|Version=ab 2.9
|Ext1=Catalog ab 2.0beta1
}}
[[Category:Extensions]]
[[Category:Catalog]]

=Beschreibung=
Definieren von mehrfachen individuellen Katalogen, individuellen Feldtypen und zahlreichen Frontend-Anzeige-Formatierungs-Möglichkeiten.
Dieses Modul erlaubt es Benutzern, Kataloge mit Einträgen zu definieren und zu verwalten. Stellen Sie sich vor, Sie möchten einem Besucher Ihrer Seite eine Liste mit Ihren Spielen zeigen. Sie haben viele Spiele, aber alle haben gleiche bestimmte Eigenschaften, wie z.B. Titel, Autor, Genre, Konsolenformat, Veröffentlichungsdatum usw. Sie möchten nun alle diese Informationen speichern und später dann Besuchern zeigen, ihnen dabei nur Spiele zeigen aus dem Motorsport-Bereich oder Spiele mit einem Preis über einer bestimmten Höhe, nur Spiele, die verfügbar sind usw. Dieses Modul erlaubt Ihnen, solche Dinge zu tun.

Quelle: [http://www.contao.org/erweiterungsliste/view/catalog.html Beschreibungstext des Catalog-Moduls in der Extension-Repository]

=Contao2go Catalog Version=

Da die größte Schwierigkeit darin besteht, zu sehen was man einstellen muss um gewisse Ergebnisse zu bekommen wurde ein Catalog erstellt, mit dem man ein wenig rumspielen kann. Die aktuelle Version kann immer über diesen Link bezogen werden: [http://catalog.mediendepot-ruhr.de http://catalog.mediendepot-ruhr.de]

=Forum=
Fragen rund um den Catalog werden im Forum hier behandelt: [http://www.contao-community.de/forumdisplay.php?18-catalog Forum - Catalog Bereich]

=Installation=
==Catalog aus dem Contao-Repository==
Catalog kann ganz normal über die Erweiterungsverwaltung des Contao-Backend installiert werden. Eine manuelle Installation ist auch möglich, dazu muss man sich die benötigen Dateien des [http://www.contao.org/erweiterungsliste/view/catalog.html catalog aus dem Extension Repository herunterladen] (abhängige Erweiterungen nicht vergessen!).

==Catalog aus dem Entwicklungs-Repository==
Den jeweils neusten Build kann man sich aus dem [http://code.google.com/p/typolight-catalog/source/checkout SVN-Repository] herunterladen. Einzig das Modul backend_filterwiz muss dabei separat installiert werden, alle weiteren Module sind im Repository vorhanden.

Man sollte darauf achten, welche Ordner wohin in der Installation kommen:
* der Inhalt von /drivers nach /system/drivers/
* alle anderen Ordner (bis auf /custumnav) nach /system/modules/
* /customnav wird nicht benötigt

Danach muss ein Update der Datenbank gemacht werden.

Eventuell fehlende Sprachdateien können aus den Übersetzungen der Version im Contao-Extension-Repository manuell hinzugefügt werden. So kann dafür gesorgt werden, dass der Catalog dann (weitgehend) in einer Übersetzung benutzt werden kann.

{{Hinweis|Bei einem Update muss seit Version r239 einmal unter Katalog (Menü von Contao) ganz oben rechts auf 'Maintenance' geklickt werden um die Tags Felder neu aufbauen lassen.}}

==Migration von Version 1 auf Version 2==
In Version 2 wurde Einiges geändert. So ist es u. a. nicht mehr nötig catalog und catalog_ext zu installieren, da diese Erweiterungen zusammengelegt wurden. Damit es zu keinem Datenverlust kommt, muss bei einem manuellen Update wie folgt vorgegangen werden:
* Zuerst die alten Modulordner entfernen,
* danach die neuen Modulordner hochladen.
* Erst zum Schluss das Datenbankupdate ausführen!

Beim Update über das Contao-ExtensionRepository sollte man die Reihenfolge beachten:
* Catalog 2 installieren und Datenbank-Update ausführen.
* Catalog_ext deinstallieren und erneut Datenbank-Update ausführen.
* Zur Sicherheit alle catalog-Module etc. noch mal öffnen und speichern, damit auch alles glatt läuft.
* Neue Einstellungen vornehmen.

Katalogfelder vom Typ "Taxonomie" müssen umgestellt werden auf "Auswahl" mit der Datentabelle "tl_taxonomy", Option Spaltenwert = name. Für eine schönere Darstellung aktiviert man "Die Optionsauswahl individualisieren", dann kann man auch Teilbereiche aus der Taxonomie vorgeben und die Anzeige auf "Baum nur mit auswählbaren Kindeinträgen" stellen.

=Allgemeines=
Testumgebung und Vortrag vom Usertreffen 2010:
* Vortrag / Testumgebung -> http://catalogdemo.dasprojekt.org/
* Benutzer: tlut2010
* Passwort: catalogisttoll

==Backend==
Mit dem Catalog bekommt man im Backend unter dem Menüpunkt 'Inhalte' 2 neue Menüeinträge:
* Katalog
* Mit '''Taxonomie''' können Stichworte hierarchisch angelegt und verwaltet werden. Diese sind Grundlage für Filter, Navigation und Verschlagwortung (sog. ''Tagging'') in den Katalogen.

[[Datei:cat-cat2-be.png|Cat Backend]]

==Frontend-Module==
Für eine Basisanwendung der Katalog-Erweiterung können folgende Module eingesetzt werden:
* Mit '''Catalog List''' kann eine Liste von Einträgen angezeigt werden.
* Eine Detailansicht eines Eintrags kann mit Hilfe des '''Catalog Reader''' angezeigt werden. Eine ''Catalog List'' verweist dabei auf den ''Catalog Reader''. Der ''Catalog Reader'' muss natürlich nur dann verwendet werden, wenn von einer Auflistung aus eine Detailseite eines Eintrags angezeigt werden soll.

Für eine weiterführende Benutzung der Katalog-Erweiterung stehen optional diese Module zur Verfügung:
* 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)

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

=Erstellen eines Katalogs (Backend)=
Um einen neuen catalog zu erstellen, klickt man links im Backend unter 'Inhalte' auf 'Katalog'. Anschliessend im Hauptbereich auf den Button 'Neuer Katalog'.

[[Datei:cat-cat2-newcat.png|Neuen Cat erstellen]]

* Name des Katalogs angeben
* Einen Tabellennamen angeben (Der catalog legt diese Tabelle selbstständig an. Es hat sich bewährt eine Tabelle anzulegen ohne tl_ als präfix, da Contao diese Tabellen sonst zum Entfernen vorschlägt. 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 für die URLs der Alias genutzt. Es muss kein Alias-Feld erstellt werden, es werden dann Text-Felder mit der Eigenschaft 'Eindeutig' zur Auswahl angeboten. Bei dieser Methode (ohne Alias-Feld) wird der Alias allerdings nicht in eine sichere Form konvertiert. 'Föö Bar' !-> 'foefoe-bar'.
* publishField (kann erst später ausgefüllt werden) -> Hier kann ein Checkboxfeld ausgewählt werden, was die Funktion eines 'Auges' = on-/offline hat (z.B. Ein Feld mit dem Namen online)
* Jump to page -> Hier muss die Detail Seite mit dem Modul Catalog Reader angegeben werden. {{Achtung|Die richtige Zuweisung der Readerseite erfolgt in den Kataloglisten Modulen, diese Zuweisung hier ist jedoch nötig damit der Katalog die Items in die xml-Sitemap eintragen kann. Wird diese Zuweisung hier nicht vorgenommen, so "weiss" der Katalog nicht, auf welchem Reader die Items dargestellt werden sollen und trägt sie daher nicht in der sitemap.xml ein. Auch für die Contao Suche muss diese Angabe gemacht werden.}}
* 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 Contao 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) Wichtig: Weiterleitungsseite muss angegeben werden!
** Condition -> Um Felder direkt aus der Suche herauszunehmen (damit unveröffentlichte Items nicht in die Suche aufgenommen werden o.ä.)
** Page title field -> Den Namen des Items auswählen, damit dieser für die Ergebnisanzeige der Suche genutzt wird ('''und auch für den Title''')
* 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 machen dürften und ob Items überschrieben werden oder nicht
* Generate feed -> Hier kann festgelegt werden, dass ein RSS-Feed generiert wird aus den Items (Funktion ist wie bei News o.ä., daher wird hier nicht genauer darauf eingegangen)

==Nachträgliches Bearbeiten eines Katalogs==
Um die Grundeinstellungen eines Katalogs nachträglich noch einmal bearbeiten zu können, klickt man in der Katalogübersicht auf den Felder-Button...

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und anschließend im Übersichtsfeld des Katalogs auf 'Bearbeiten'.

[[Datei:cat-cat2-editcat.png|Cat Catalog editieren]]

=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. Um neue Felder für den Katalog zu erstellen, klickt man in der Katalogübersicht auf 'Felder für Katalog erstellen'....

[[Datei:cat-cat2-editfields.png|Cat Felder editieren]]

...und danach auf 'Neues Feld'.

[[Datei:cat-cat2-newfield.png|Cat Neues Feld anlegen]]

==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ärend sein.)
** Beschreibung (Um im Backend und beim Frontend-Editing eine Beschreibung anzuzeigen für die Ersteller eines Items)
** Spaltenname (der Spaltenname in der Tabelle. Dieser muss eindeutig sein und so vergeben werden, 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 - seit TYPOlight 2.7 möglich)
* Backend filter settings (hier kann festgelegt werden, ob das Feld im Backend zur Filterung angezeigt wird)
** Sortieren ('''Muss zum Filtern etc. angegeben werden.''' Sonst weiß Contao nicht wie der Filter erstellt werden soll. Für '''Datum''' ist zwangsweise die Angabe nötig ob nach Jahr, Monat oder Tag sortiert werden soll!)
** 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 (Mehrfachangabe 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.)
{{Hinweis|Es ist darauf zu achten, dass beim Anlegen der Felder das Feld ''Alias'' '''nach''' dem Feld ''Titel'' plaziert wird, da sonst der Alias nicht korrekt generiert bzw. nur die ID gesetzt wird.}}

===Langtext===
* Advanced settings
** Allow html (wenn erlaubt werden in dem Feld HTML-Tags erlaubt - Liste der erlaubten HTML-Tags ist in den Eigenschaften von Contao 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

Möchte man im Feld ''Date'' immer das aktuelle Datum beim Anlegen eines Items verwenden, kann man in den erweiterten Einstellungen des Date-Feldes beim Standartwert den Wert '''date()''' eintragen.

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

===Auswahl===
Hiermit kann man ein Auswahl-Feld (Select) erstellen, das 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, in der die Optionen 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 selektierten 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)

===Tags===
Auch Tags sind ähnlich der Auswahl dazu da, eine andere Tabelle als Wert anzugeben.

Der Unterschied besteht darin, das Tags eine Checkboxliste ergeben, mit der auch eine Mehrfachauswahl möglich ist.

* 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, in der die Optionen 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)

Bis catalog Version 2.0.0 beta2 Build 59 kann man nicht [https://www.contao-community.de/showthread.php?27484-Wieso-kein-BE-Filter-f%FCr-Feld-vom-Typ-quot-Tags-quot&p=183047&viewfull=1#post183047 Tags Felder als Filter in Backend-Listenansichten verwenden]. Ein par Zeilen Code helfen dem aber nach. Wie das geht steht im verlinkten Forumbeitrag.

===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. Falls die ausgewählte Datei nicht unter den Contao-Einstellungen eingetragen ist, so bleibt das Feld "value" (mehr dazu siehe "Welche Variablen hat man in einem Template zur Verfügung?") leer. Aus diesem Grund sollte man im Vorhinein die entsprechenden Dateitypen freischalten.
* 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

===Berechnen===
Um Berechnungen auf SQL Ebene vorzunehmen
* Berechnungsformel
** Beispiel einer SQL-Berechnung, wenn man einen numerischen Wert erhalten will -> (price*1.15)*qty
** Beispiel einer SQL-Berechnung, wenn man mehrere Texte zu einer Textzeichenfolge verknüpfen will -> CONCAT('Adresse: ', col_adresse , ', ' , col_plz , ' ' , col_ort)
* Format-Einstellungen
** Vor- und Nachsilben
** Format
*** Format-Funktion
**** Zeichenkette
**** Nummer
**** Datum
*** Zeichenfolge für Formatierung oder Parameter

===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. Hiermit wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick pro IP und Tag festgelegt.

===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.
{{Anmerkung|der Feldtyp "Meta Keywords" ist veraltet, da in der Katalog Konfiguration direkt nun ein Textfeld als Quelle der META Keywords gewählt werden kann.}}

===Mehrspaltiger Text===

Nur verfügbar wenn zusätzlich installiert: [http://www.contao.org/erweiterungsliste/view/catalogmultitextwizardfield.html direkt zum ER]

Hiermit kann ein Feld ähnlich des Tabellenelements in Contao 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)

Für das Frontend Editing (wenn man dieses Feld dort editieren möchte) braucht man die Erweiterung [http://www.contao.org/erweiterungsliste/view/x_FrontendMultiTextWizard.de.html xFrontend MultiTextWizard]. Ansonsten ist dieses Feld nicht editierbar.

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

=== Merkliste und Varianten ===
Mit diesem Feldtyp ist es möglich Items für eine Merkliste vorzubereiten.
* Notelistvariants sind die Varianten, die ein Item besitzen können. Die Liste der Varianten besteht aus Select- und Tagfields des Katalogs. Dadurch ist es möglich Varianten von der Taxonomie oder von anderen Katalogen zu erstellen, indem man in diesem Katalog Auswahlen dafür anlegt.

==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

[[Datei:cat-cat2-fieldpreview.png|Felderübersicht]]

=Frontend Module und ihre Attribute=

Bei den verschiedenen Modulen muss zunächst eine Auswahl getroffen werden, für welchen Katalog das Modul gemacht wird. Dabei kann immer nur ein Katalog gewählt werden.

'''Allgemeine Einstellungen (die alle Module haben):'''
* Titel
* Überschrift
* Modultyp (mit den unten stehenden Modultypen)
* Zugriffsschutz (Nur bestimmten Gruppen das Modul anzeigen)
* Experten Einstellungen
** Nur Gästen anzeigen
** CSS-ID/Klasse
** Abstand davor und dahinter

[[Datei:cat-cat2-view-list.jpg|Cat Modul Liste]]

[[Datei:cat-cat2-view-reader.jpg|Cat Modul Reader]]

==Catalog List==
Zur Ausgabe einer Liste von Items wird das Modul [[ModuleCatalogList]] verwendet.

==Catalog Reader==
Um die Details von einem einzelnen Item anzuzeigen
* Als Wichtigstes muss eine Weiterleitungsseite eingestellt werden. Auf dieser Seite muss der Catalog Reader vorhanden sein.
* catalog layout (Auswahl des Templates für den Reader)
** catalog_full (Standardtemplate um Alles auszugeben)
** catalog_full_rev (Template um alle Felder auszugeben - Entwickler Version)
* Visible Fields - Sichbare Felder. Diese Felder sind dann im Template verfügbar. Man kann auch die Reihenfolge der Ausgabe bestimmen.

==Catalog Filter==
Mit Hilfe von einem Filter können Besucher die Liste eines Catalogs filtern und die Anzeige eingrenzen. Die Filter können hier genau eingestellt werden. Sogar ein eigenes Suchfeld nur für den einen Katalog kann hier erstellt werden.
* Catalog -> für welchen Katalog soll dieser Filter benutzt werden (es kann nur ein Katalog angegeben werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul 'cataloglist', da hier dann nur noch die Items angezeigt werden, die zu der gefilterten Ausgabe passen)
* Filter layout (default -> filter_default | zum Entwickeln ist das filter_widget Template gedacht)
* Enables Filter By section (Einen Filter erstellen)
** Filter Headline (Überschrift für diese(n) Filter)
** Filter Fields (Hier kann man das Feld und die Art des Filters auswählen)
*** Die Reihenfolge bestimmt man mit den grünen Pfeilen neben der Feldbezeichnung
*** Tree View (Ankreuzen wenn es eine baumartige Struktur sein soll, bzw. bei diesem Feld eine baumartige Struktur eingegeben wurde. Die Kindelemente reagieren dabei auf die Auswahl der Elternelemente)
*** None (default Wert -> es wird von diesem Feld kein Filter erstellt)
*** Links List (eine einfache Link Liste wird von dem Feld erstellt)
*** Radio Button (Eine Auswahl mittels Radio Button wird erstellt, so ist die Auswahl nur von einem Wert möglich)
*** Select drop-down (Eine Auswahl mittels einer Select-Box wird erstellt. Nur ein Wert kann ausgewählt werden.)
** Reveal tree view sequentially (Die Filter werden erst nach und nach eingeblendet. Die Reihenfolge bestimmt dabei die Einblendung. So wird der 2. Filter erst eingeblendet, wenn im ersten etwas ausgewählt wurde. Eine Möglichkeit wäre hier die Auswahl von Städten, die erst erscheint, wenn ein Bundesland ausgewählt wurde)
** Tags multiple select allowed (Wenn dieses Feld ausgewählt wurde, wird aus dem Radio Button eine Checkbox und aus der Select drop-down Liste eine Liste mit der Möglichkeit meherere auszuwählen.)
* Enables Range section (Hier können Felder ausgewählt werden, wo ein Minimum und Maximum eingegeben werden kann um darüber zu Filtern)
** Range Headline (Überschrift angeben)
** Range Fields (Auswahl der Felder für die ein Bereichsauswahl erstellt werden soll. Die Liste ist auch wieder sortierbar)
* Enables Date section (Hier können Felder ausgewählt werden, welche nach Datum zusammengefasst werden können)
** Dates Headline (Überschrift angeben)
** Date Fields (Hier sind nur Datumsfelder zur Auswahl angeboten. Man kann bestimmen, welches benutzt werden soll)
** Date Ranges (Hier kann angegeben werden, welche Auswahl der Besucher hat, um die Daten zu filtern):
*** Last year
*** Last 6 months
*** Last month
*** Last week
*** Yesterday
*** Today
*** Tomorrow
*** Next week
*** Next month
*** Next 6 months
*** Next year
* Enables Sort section (Hier wird eingestellt, welche Felder vom Besucher überhaupt sortierbar sind und wie das geschehen soll)
** Sort Headline (Überschrift angeben)
** Sort Fields (Hier muss angegeben werden, welche Felder sortierbar sein sollen. Die Reihenfolge kann wieder über die grünen Pfeile bestimmt werden)
** Sort form control type Hier wird festgelegt, wie die Besucher bestimmen können wie sortiert wird:
*** select (Über eine Select Auswahl)
*** list (Mit hilfe einer Linkliste)
*** radio (Über einen Radio Button)
* Enables Search Box (Eine Suchbox einschalten. Nur Text, langtext Felder werden unterstützt)
** Search Headline (Überschrift eingeben)
** Search Fields (Hier können die Felder ausgewählt werden, in denen gesucht werden soll)
* Use filter condition from lister on same page (Wenn auf derselben Seite auch eine List-Modul von dem Katalog eingesetzt wird und diese Liste mit conditions eingeschränkt ist, werden bei Auswahl dieses Feldes die Filter mit Berücksichtigung der conditions erstellt.)

==Catalog Navigation==
Mit diesem Modul kann man eine Navigation durch einen Katalogs erstellen. Die Navigation besteht zum Beispiel aus Kategorien.
* Catalog -> für welchen Katalog soll diese Navigation genommen werden (es kann nur ein Katalog ausgewählt werden)
* Weiterleitungsseite (auf welche Seite soll bei Klick weitergeleitet werden. Üblicherweise ist das eine Seite mit dem Modul [[ModuleCatalogList|Katalog liste]], da hier dann nur noch die Items angezeigt werden, die zu der Kategorie passen)
* Navigations field -> Hier muss das Feld angegeben werden, aus dem die Navigation zusammengesetzt wird. Also ein Selectfield aus dem gewählten Katalog. (Andere Felder wie Tagfield gehen nicht und stehen deswegen nicht zur Auswahl!)
* Alle anderen Einstellungen der Navigation funktionieren genau so wie beim normalen [[ModulNavigation|Navigationsmodul]]

==Catalog Notify==
Hiermit wird ein Formular erstellt, welches zur schnellen Kontaktaufnahme bei einem einzelnen Item dargestellt wird. Z.B.: Möchten Sie nähere Informationen zu diesem Produkt? Dann schicken Sie uns bitte Ihre Kontaktdaten, damit wir uns bei Ihnen melden können.
* Catalog (Hier muss wieder der Katalog angegeben werden, in dem das Item dargestellt werden soll)
* Form Fields (Hier können Sie Felder angeben, die der Benutzer ausfüllen soll, damit Sie Kontakt zu ihm aufnehmen können)
{{Anmerkung|Der folgende Punkt ist in catalog 2.0.0 beta1 Build 51 nicht, oder nicht mehr vorhanden!}}
* Sicherheitsfrage deaktivieren (nicht empfohlen! Nur sinnvoll, wenn die Benutzer schon in einem Bereich sind, in dem man sich anmelden muss)
* Subject (Betreff der Email, hier können spezielle Inserttags benutzt werden in der Art -> <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki>. Z.B. <nowiki>{{catalog::title}}</nowiki>
* Recipients List (Liste von Emailadressen, die eine Email mit dem Inhalt erhalten sollen)
* Body text (Text der Email. Auch hier sind die speziellen Inserttags <nowiki>{{catalog::Spaltenbezeichnung}}</nowiki> möglich. Zusätzlich sind noch die Variablen ##catalog## und ##link## verfügbar. Wobei catalog durch den Katalog und link durch den direkten Link zu dem Item ersetzt werden.
* Catalog Template (Hier kann das passende Template angegeben werden um das Formular darzustellen. Default ist mod_catalognotify)

==Catalog Featured==
Hiermit kann man eine Liste erstellen, die besondere Items darstellt. Die Liste wird per Zufall zusammengestellt.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)
* Um spezielle Einträge anzulegen braucht nur ein extra Feld (checkbox) erstellt werden (z.B. hervorgehoben) und in der Condition können dann Items festgelegt werden, deren Wert 1 ist -> spalte_hervorgehoben=1

==Catalog Related==
Hiermit erstellt man eine Liste von ähnlichen Items - einzusetzen auf einer Seite, auf der auch der Catalog Reader enthalten ist. Zufallsausgabe.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Related fields to match (Angabe der Felder, die bei den darzustellenden Items gleich sein sollen)
** Amount of tags that must be in common (Einstellen der Anzahl der Übereinstimmungen -> Minimumangabe. d.h. wenn 3 Felder angegeben wurden, die übereinstimmen sollen, kann bei einer Angabe von 1 auch ein Item angezeigt werden, welches nur eine Übereinstimmung hat und nicht alle 3)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Reference==
Hiermit erstellt man eine Liste von Items mit einer gleichen Eigenschaft. Diese muss zusammen mit dem Catalog Reader eingesetzt werden und ist für die Anzeige von Items aus einem '''anderen''' Katalog.
* Grundeinstellungen sind wie bei der Catalog-List
* Besonderheiten:
** Select the match field (Das Feld auswählen, welches die Verbindung zum anderen Katalog herstellt)
** Select reference catalog (Den zweiten Katalog auswählen, wo die anzuzeigenden Items enthalten sind)
** Select the reference field (Das Feld angeben, welches im 2. Katalog für die Identifizierung genutzt wird. Es soll dasselbe Feld angegeben werden, welchen auch schon für die Verknüpfung genommen wurde)
** Number of items (Hier kann die Anzahl der Items dargestellt werden. 0 zeigt alle)
** Custom ordering (Die Reihenfolge kann hier festgelegt werden)

==Catalog Edit==
Um ein Item im Frontend editieren und erstellen zu können. Dieses Modul wird anstelle von Catalog Reader verwendet.
*Catalog (den Katalog auswählen, dessen Items im Frontend editierbar sein soll)
* Editable Fields (Angabe der Felder, die editierbar sein sollen. Mit den Pfeilen kann man diese in der Reihenfolge anordnen)
* Weiterleitungsseite (Seite die angezeigt werden soll, wenn das Formular abgesendet wurde. Meistens wird wieder zurück zu der Liste weitergeleitet)
* Sicherheitsabfrage deaktivieren (Nicht empfohlen! Es sei denn, nur angemeldete Benutzer haben Zugriff auf diese Seite)
* Restricted fields (Mit dieser Einstellung können Vorbelegungen, die _nicht_ geändert werden können, vorgenommen werden. Diese Felder sollten nicht als Editable Fields konfiguriert sein)
** Wählen Sie hier die Felder aus, welche vorbelegt sein sollen
** Restricted fields default values (Sind erst '''nach dem Speichern einstellbare Vorgaben''' für die Felder, die vorher ausgewählt wurden -> Jeder Feldtyp ist individuell einstellbar.)
** Beispiel für ein Restricted field: Ein Feld mit einer Checkbox, ob das Item online sein soll. 'online' bekommt als default Wert 'Nein'. Nun ist jedes Item, was über diesen Catalog Editor erstellt oder bearbeitet wird offline! So kann man im Frontend mit einer extra Gruppe, die dieses Feld bearbeiten kann und eben keine default Vorgabe hat die Items freischalten. Die 'normalen' Benutzer haben dieses Recht dann nicht.

==Inhaltselemente==
Mit der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement] kann über ein Inhaltselement einzelne Katalogeinträge auf Seiten dargestellt werden.

Vorgehensweise:
* Installation der Erweiterung [http://www.contao.org/de/extension-list/view/catalogcontentelement.de.html Catalogcontentelement]
* In ''Inhalte -- Katalog'' auf die Büroklammer klicken, um ein Template für das Inhaltselement anzulegen. ''Wichtig:'' Erst den Katalog auswählen, dann auf ''speichern'' klicken. Nun erscheint zwar eine Fehlermeldung, aber auch alle nötigen Informationen, um die Einstellungen vollständig vorzunehmen.
* Nun kann unter ''Inhalte -- Artikel'' das Inhaltselement auf eienr beliebigen Seite plaziert werden. Das vorher konfigurierte Template und den Katalogeintrag können in den Einstellungen ausgewählt werden.

=Weitere Einstellungsmöglichkeiten=

== Merkliste - Formulargenerator ==
Die Merkliste wird nicht als extra Modul erstellt, sondern in einem Formular mit dem Formulargenerator von Contao.

Dazu gibt es ein neuen Feldtyp 'Merkliste' der zum Beispiel am Anfang positioniert werden kann.
Der Besucher kann später das Formular ausfüllen und so die Liste an den Emailempfänger versenden, um sich so zum Beispiel ein Angebot für die Items einzuholen.

Einstellungen:
* Feldname (der Feldname für diesen Feldtyp)
* Feldbezeichnung (diese wird normalerweise für Felder als Label angezeigt und sollte daher hier '''leer''' gelassen werden)
* Text (Hier kann ein Text angegeben werden, der über der Liste der Items angezeigt wird)
* Katalog (Den Katalog angeben, der die Items enthält)
* Sichtbare Felder (Die anzuzeigenden Felder von den Items, die Liste ist auch hier wieder über die Pfeile sortierbar)

=== Templates für die Merkliste ===
* form_catalognotelist.tpl (Template für die Liste im Formular)
* form_catalognotelist_mail.tpl (Template für die Email, welche die Items vom Merkzettel enthält. Hier kann genau festgelegt werden, welche Felder in der Email von einem Item angezeigt werden.)

=Tipps und Tricks zur Umsetzung=

==Welche Variablen hat man in einem Template zur Verfügung?==
<source lang="php">
<?php print_r($this->entries); ?>
</source>
oder
<source lang="php">
<?php $this->showTemplateVars(); ?>
</source>
Damit bekommt man das komplette Array ausgegeben.

'''Achtung: Diese Anweisung stellt ein potenzielles Sicherheitsrisiko dar und muss vor dem Produktiveinsatz entfernt werden.'''

==Zeichenkette des Titels formatieren==
Warum wird bei mir nichts angezeigt, obwohl ich da etwas angegeben habe?
* Wichtig: man muss bei den Feldern die man später hier benutzen möchte folgendes Ankreuzen -> Anzeige-Einstellungen > Sichtbar in der Backend-Listen-Ansicht

==Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt?==
* Einfach das Feld für den Namen mit title benennen (das ist die Fallback Methode, wenn die andere -> Page title field nicht benutzt wird). Der catalog wird dann automatisch dieses Feld benutzen um den meta-title zu generieren.
* Page title field beim Katalog sezten. Zu finden unter 'Search' in den Einstellungen vom Katalog.

==Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht==
Im Catalog Template folgendes nutzen:
<source lang="php">
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
}
?>
</source>
In dem Beispiel wird jetzt (nur wenn eine Kategorie gewählt ist) der Wert von '''$entry['data']['kategorie']['value']''' eingesetzt.

==Wie bekommt man ein Auge bei den Items? / on- offline Schalten von Items==
Zuerst muss man sich in Feld vom Typ 'Checkbox' anlegen. Zum Beispiel mit dem Namen 'online'.
Jetzt kann man den Katalog konfigurieren und bei '''Feld veröffentlichen''' (publish Field) das Checkbox-Feld auswählen.
Ab jetzt ist im Backend bei den Items eines Katalogs ein graues oder grünes Auge (je nach Zustand) sichtbar.

==Detail Seiten in die sitemap.xml und ins Modul Sitemap bringen==
* sitemap.xml -> Den Katalog einfach für die Indexierung der Suche freigeben -> [http://tip.dasprojekt.org/Catalog_2#Erstellen_von_einem_Katalog_.28Backend.29 Searchable] (Achtung: eine Weiterleitungsseite muss auf jeden Fall angegeben sein beim Katalog selber. Diese Seite wird dann in der Sitemap benutzt um die Items darzustellen.)
* Modul Sitemap -> Hier werden die Detailseiten nicht integriert, da es bei einem normalen Katalog schon zu viele Einträge wären, um diese dort sinnvoll darzustellen.

==Alias bei Links benutzen (anstelle der ID)==
Dazu braucht man nur ein Pflichtfeld (Namen von dem Item) und erstellt dann noch ein Feld vom Typ Alias. Das Alias-Titel-Feld ist dann der Name des Items.
Bei dem Katalog selber muss noch ausgewählt werden, welches das Alias Feld ist.
Das Alias Feld ist genau so wie das Alias Feld von Seiten etc., man kann selbst etwas eintragen oder den Inhalt automatisch generieren lassen, wenn man das leer lässt.
Nachdem die Suche und die Seiten neu generiert wurden (Systemwartung) sollte der Alias bei der Suche und auch bei der Detailansicht (URL) genutzt werden.
'''Im Moment muss in der Liste das Alias Feld als 'Sichtbar' ausgewählt werden, sonst funktioniert die Verlinkung nicht! (Sollte in der Endversion behoben sein)'''
Wenn das Aliasfeld nicht angelegt ist wird das Item per ID verlinkt.

==Folder-URL und der catalog wollen nicht so recht==

Unter Einstellungen kann unter Sicherheitseinstellungen eine Liste von Variablennamen angeben werden, welche von der Erweiterung Folder-URL als Parameter erkannt werden sollen. Hier muss "orderby,sort,search" angegeben werden. Dadurch ignoriert Folderurl diese Parameter und der catalog ist wie immer nutzbar.

Es sollten alle Schlüsselwörter der Filtermöglichkeiten hinzugefügt werden. Wenn man die Einträge des Kataloges nach z.B. "Ort" sortieren will, gibt es einen Fehler, wenn das Feld der Datenbanktabelle nicht im Feld "URL Schlüsselworte" in den Einstellungen auftaucht.

==Eine Liste im Frontend so sortieren wie im Backend==

Um eine Liste genau so zu sortieren wie im Backend braucht man einfach nur bei der Sortierung nach dem Feld 'sorting' zu sortieren (z.B. sorting ASC). Im Backend können Einträge nur dann manuell sortiert (verschoben) werden, wenn bei keinem Feld die Einstellung 'Sortier DropDown aktivieren' aktiv ist.

{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]
[[http://code.google.com/p/typolight-catalog/issues/detail?id=199 Bug-Report]] [[http://code.google.com/p/typolight-catalog/source/detail?r=198 fixed in r198]]}}

{{Hinweis|Mit der Erweiterung [[catalog_manualsort]] ist es möglich die Reihenfolge der Einträge im Backend trotzdem zu ändern, auch wenn die Sortieroption für bestimmte Felder aktiv ist.}}

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf die '''Sortierungs Option''' (Feld-Eigenschaften->Backend Filter Einstellungen->'Sortierungs Dropdown aktivieren') '''bei keinem Feld aktiviert''' sein.
{{Achtung|Bitte klären, da die Filterung dann nicht mehr funktioniert. Siehe Thread im Forum: [http://www.contao-community.de/showthread.php?13299-BE-Eintr%E4ge-verwalten-kein-Button-Anwenden-f%FCr-Filterung-vorhanden BE, Einträge verwalten, kein Button 'Anwenden' für Filterung vorhanden ]}}

==Bedingung bei Strings==

Um eine Bedingung anzugeben, die innerhalb eines Strings vorhanden ist, reicht es ja nicht einfach nur einen Vergleich per SQL vorzunehmen.
Beispiel: Über den Feldtyp Tag sind Taxonomieen einem Produkt zugeordnet. Da das mehrere sein können muss man die Bedingung in der Liste wie folgt abfragen ->
<source lang="php">
FIND_IN_SET(7, kategorie)
</source>
D.h.: es soll innerhalb von kategorie nach der ID 7 gesucht werden.

==Formatieren der Felder vom Typ Text, Nummer und Dezimal==
Options-Checkbox: '''Zusätzliche Format-Funktionen aktivieren.'''

Das Auswahlmenü '''Format-Funktion''' erlaubt es, die Feldtypen '''Text''', '''Nummer''' und '''Dezimal''' zu formatieren. So gehts:

=== Zeichenkette ===
Hier gibt man einen sprintf Formatierungs-String ein (siehe [http://de3.php.net/sprintf PHP: sprintf - Manual])

''Beispiel Zeichenkette:''
* '''Feldinhalt:''' Broccoli
* '''Formatierungs-String:''' Auf zum %s!
* '''Ausgabe:''' Auf zum Broccoli!

=== Nummer ===
Hier gibt man nur die Anzahl der gewünschten Nachkommastellen an. In der Ausgabe erscheinen nun die in Contao festgelegten Tausender- und Dezimal-Trennzeichen.

''Beispiel Nummer:''
* '''Feldinhalt:''' 1000
* '''Nachkommastellen:''' 2
* '''Ausgabe:''' 1.000,00

=== Datum ===
Hier gibt man ein Formatierungsmuster ein (siehe [http://de.php.net/manual/de/function.date.php PHP: date - Manual])

''Beispiel Datum:''
* '''Feldinhalt (Unix Timestamp):''' 1293217200
* '''Formatierungsmuster:''' Y-m-d H:i
* '''Ausgabe:''' 2010-12-24 18:00

==Filtern nach Datum==

Aufgabenstellung:
Das Datumsfeld ist in dem Format 'dd.mm.yyyy' vorhanden.
Es soll nun für das aktuelle Jahr eine Ausgabe erfolgen und für die vergangenen Jahre ein Archiv erstellt werden.

Das Problem:
Die Datum Angaben werden als timestamp gespeichert und sind in einem char Feld.

Lösungsansatz:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<source lang="php">
meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')
</source>

===Probleme die bei Unix Timestamp auftreten können===
Es kann passieren, das der Unix Timestamp beim Verarbeiten von PHP falsch interpretiert wird (nicht als Zahl).
Daher kann es nötig sein, diesen erst durch einen kleinen Trick auf jeden Fall in einen Zahlenwert umzuwandeln:
<source lang="php">
ROUND(datum)
</source>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verloren).

Beispiel (von do_while) aus dem Forum:
<source lang="php">
ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')
</source>
Hier wird nach dem Datum sortiert.

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesentlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann man die Möglichkeiten der Konfiguration sehen -> [http://www.contao.org/referenz.html http://www.contao.org/referenz.html]

Um ein Feld zum Beispiel nur für den Lesenden Zugriff freizugeben kann man diese Syntax nutzen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;
</source>

Oder die Eingabe von einer E-Mail überprüfen:
<source lang="php">
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';
</source>

==CSV import==
Um die Daten richtig importieren zu können muss darauf geachtet werden, das diese UTF-8 kodiert sein müssen. Das wird von Excel nicht direkt so gemacht.
Hier ist OpenOffice eine valable Alternative. Hier bieten sich sowohl beim Import (wie auch beim Export) von .csv Dateien diverse Einstellungsmöglichkeiten an.

Der Import von Daten kann in zwei Varianten erfolgen:
# Variante: Die Daten werden nach dem letzten Eintrag in der Datenbank eingetragen.
# Variante: Die bestehehenden werden gelöscht und dann neu eingetragen. Hierbei zählt aber die ID weiter!

[[Datei:Cat-openoffice-import.png|Screen Textimport]]

Standardmässig ist die Möglichkeit .csv Dateien zu importieren nicht aktiviert. Klick hierzu zuerst im Übersichtsfeld des Katalogs auf 'Bearbeiten'.
Dann unter 'Import' die jeweilige Option anklicken.

[[Datei:Cat-csv-import.png|Option CSV-Import aktivieren]]

==Mehrsprachige Filter mit dem Taxonomie Modul==
Möchte man einen Mehrsprachigen Katalog erstellen und diesen nach Taxonomien Filtern, so gibt es u.a. zwei Möglichkeiten dies zu tun:
* Für jede Sprache einen Taxonomiebaum erstellen. Problem: Doppelte Zuweisung im Katalog-Item + mehrere Taxonomiebäume
* Bessere Lösung: Man arbeitet mit den sprachabhängigen Inserttags. So kann man je nach Spracheinstellungen der Seite eine passende Frontend-Ausgabe erreichen.

Beispiel:
Möchte man jedem Item ein Land zuordnen, so erstellt man einen Taxonomie-Eintrag "Länder" und in fügt in diesen die auswählbaren Länder ein. Für "Deutschland" könnte das dann z.B. so aussehen:
<nowiki>{{iflng::de}}</nowiki>Deutschland<nowiki>{{iflng}}{{iflng::en}}</nowiki>Germany<nowiki>{{iflng}}</nowiki>
Nun sollte der Filter auf der deutschen Seite "Deutschland", und auf der englischen "Germany" ausgeben.
Dabei gibt es allerdings ein Problem mit dem Feldtyp in der Datenbank. Dieser ist auf wenige Zeichen beschränkt, wird somit bei entsprechender Länge gekürzt. Um dies '''nicht updatesicher''' zu korrigieren, muss man ins phpMyAdmin gehen und unter tl_taxonomy die Länge des entsprechenden Feldes (ich glaube es ist: "name") ändern. (wird später genauer beschrieben)

==Frontendausgabe Sortieren bei einem Feld was von einem anderen Catalog oder der Taxonomie kommt==
Beispiel:
Katalog A hat ein Select wo man Items aus Katalog B auswählen kann.

<source lang="sql">(SELECT sorting FROM catalog_tabellenname AS cs WHERE cs.id=catalog_feld) ASC</source>

catalog_tabellenname = Tabelle die das Feld beinhaltet (Katalog B)
catalog_feld = Name von dem Feld welches im Select genutz wird. (Feld in Katalog B)

==Frontendausgabe über Taxonomie sortieren==
Problemstellung: Wenn man bei einem Katalog ein Selectfeld einsetzt, welches man auf eine Taxonomie referenziert, kommt es zu Problemen in der Sortierung.

Beispielausgabe im FE:

Taxonomie 1
========
- Item 1
- Item 2
- Item 3

Taxonomie 2
========
- Item 1
- Item 2
- Item 3

Taxonomie 3
========
- Item 1
...

<source lang="sql">FIND_IN_SET(servicesolutions, (

SELECT GROUP_CONCAT(CAST(id AS CHAR) ORDER BY cs.sorting) FROM tl_taxonomy AS cs WHERE cs.pid=34 group by cs.pid

)) ,name</source>

servicesolutions (Feldname des genutzten Kataloges, welches auf die Taxonomie referenziert wird)
pid=34 (Das Elternelement in der Taxonomie, nach denen die Kindelemente sortiert werden soll.

==Katalogeinträge an den Frontend-Benutzer binden==

Um Katalogeinträge an den Frontend-Benutzer zu binden, kann die Erweiterung [http://www.contao.org/erweiterungsliste/view/catalogitemuseridfield.de.html catalogitemuseridfield] installiert werden.

Nach der Installation besteht die Möglichkeit ein Feld mit dem Feldtyp Frontend-Benutzer im Catalog zu definieren.
In diesem Feld wird die User ID des Frontend-Benutzers gespeichert und kann so z.B. in den Bedingungen verknüpft werden.

=Video Tutorials aus dem Internet=
Ein paar Videos zu dem Catalog:

{{#widget:YouTube|id=Dg55QT7uGEI}} {{#widget:YouTube|id=wwhuSCQ4Jb4}}

=Tutorials=
* [[Catalog Merkzettel erstellen]]
* [[Catalog mit Frontend-Editing und Workflow erstellen]]
* [[Catalog Templates anpassen]]
----

--[[Benutzer:Toflar|Toflar]] 15:12, 15. Mai 2010 (UTC+1)

--[[Benutzer:MacKP|MacKP]] 13:02, 5. Apr. 2010 (UTC)

--[[Benutzer:Nils.riel|Nils.riel]] 12:04, 24. Nov. 2010 (CET)

--[[Benutzer:Carino|Carino]] 19:00, 24. Nov. 2012 (UTC+1)

Mootools Aufklappmenü MenuMatic

2012-07-10T19:27:56Z

Carino: /* DEPRECEATED ? */

{{AppliesTo|TLVersion=2.8.x|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]

=Mootools Aufklappmenü MenuMatic in Contao benutzen=

Da es immer viele Probleme mit Menüs gibt und sich viele Bewegende Menüs wünschen habe ich mal MenuMatic ( [http://greengeckodesign.com/menumatic http://greengeckodesign.com/menumatic] ) in Typolight eingebaut. Auf der Seite sind auch 2 Beispiele.
== DEPRECEATED ? ==
Der Entwickler hat sich vom Script verabschiedet,
http://greengeckodesign.com/future-menumatic
Dieses Mootools-Script ist also nur noch mit Vorsicht zu geniesen ( Siehe auch
https://www.contao-community.de/showthread.php?27830-Contao-2-11-und-Menumatic-vorr%FCbergehende-L%F6sung )
18.4.2012 Geraldo

Der jüngste Beitrag des Themas bietet, Dank Jan Theofel und Andreas Schempp, eine Lösung für Contao 2.11.4:
https://www.contao-community.de/showthread.php?27830-Contao-2-11-und-Menumatic-vorr%FCbergehende-L%F6sung&p=210212&viewfull=1#post210212

==Voraussetzung:==
Mootools 1.2 (also TL ab 2.8)
Grundlegende Erfahrung mit TYPOlight und Seitenstruktur
gute CSS-Kentnisse um es genau anpassen zu können
für die Grundfunktion so wie es ist keine JavaScript-Kentnisse

==Dazu ist eigenltich nicht viel nötig.==
Von der Seite ( [http://greengeckodesign.com/menumatic http://greengeckodesign.com/menumatic] ) ganz unten die Dateien herunterladen.
Da sind 2 Beispiele drinn:
* horizontal
* vertical

==Vorgehen:==
'''1.''' Die benötigten CSS-Dateien importieren (entweder aus dem Ordner horizontal ode vertical, je nach Bedarf). Das CSS für den IE6 dann auch passend mit conditional Comment versehen.
Die JS-Datei hochladen (z.B. in den Ordner js). Diese Datei muss lesbar für alle sein.

'''2.''' Ein neues Navigation Template erstellen mit diesem Inhalt (nav_MenuMatic.tpl):
<source lang="php">
<ul <?php if ($this->level == 'level_1'): ?>id="nav"<?php endif; ?> class="vlist <?php echo $this->level; ?>">
<?php foreach ($this->items as $item): ?>
<?php if ($item['isActive']): ?>
<li class="active<?php if ($item['class']): ?> <?php echo $item['class']; ?><?php endif; ?>"><a href="<?php echo $item['href']; ?>" title="<?php echo $item['pageTitle'] ? $item['pageTitle'] : $item['title']; ?>"<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?><?php if ($item['accesskey'] != ''): ?> accesskey="<?php echo $item['accesskey']; ?>"<?php endif; ?><?php if ($item['tabindex']): ?> tabindex="<?php echo $item['tabindex']; ?>"<?php endif; ?><?php if ($item['nofollow']): ?> rel="nofollow"<?php endif; ?><?php echo $item['target']; ?>><em><?php echo $item['link']; ?></em></a><?php echo $item['subitems']; ?></li>
<?php else: ?>
<li<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?>><a href="<?php echo $item['href']; ?>" title="<?php echo $item['pageTitle'] ? $item['pageTitle'] : $item['title']; ?>"<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?><?php if ($item['accesskey'] != ''): ?> accesskey="<?php echo $item['accesskey']; ?>"<?php endif; ?><?php if ($item['tabindex']): ?> tabindex="<?php echo $item['tabindex']; ?>"<?php endif; ?><?php if ($item['nofollow']): ?> rel="nofollow"<?php endif; ?><?php echo $item['target']; ?>><?php echo $item['link']; ?></a><?php echo $item['subitems']; ?></li>
<?php endif; ?>
<?php endforeach; ?>
</ul>
</source>
'''Anpassungen (2 Stück):'''
* Das erste <nowiki><ul></nowiki> bekommt die ID 'nav' (darüber kann dann mit JavaScript das Menü angesprochen werden)
* Hier sind auch die aktiven Navi Punkte verlinkt und nicht mit einem span sondern mit em umschlossen. So werden die Beispiele nicht mehr davon beeinflusst und man kann es trotzdem gut mit CSS ansprechen.

'''3.''' Ein neues Navigationsmodul (genaueres kann hier nachgelesen werden zu dem Modul -> [http://de.contaowiki.org/ModulNavigation http://de.contaowiki.org/ModulNavigation]) :
* Startlevel 0
* Stoplevel 0
* Referenzseite (keine bzw. Startpunkt oder was man möchte)
* Navigationstemplate: (das von uns gerade erstellte) nav_MenuMatic.tpl

'''4.''' Neues Seitenlayout:
* Navigationsmodul von gerade da hin packen wo man es haben möchte
* Eigener JavaScript-Code:

<source lang="javascript">


<script src="js/MenuMatic_0.68.3.js" type="text/javascript" charset="utf-8"></script>


<script type="text/javascript" >
window.addEvent('domready', function() {
var myMenu = new MenuMatic();
});
</script>
</source>

(Damit initialisiert man das Menü und kann noch Parameter übergeben. Genaueres ist auf der oben verlinkten Seite zu finden)

Cave: für das vertikale Menü muss dieser JS-Code ergänzt werden an dieser Stelle:

<source lang="javascript">
var myMenu = new MenuMatic({ orientation:'vertical' });
</source>

'''CSS-Dateien auswählen:'''
* style.css (nur Beispiellayout, also nicht benutzen, wenn man ein eigenes hat!)
* MenuMatic.css (hier ist alles für die Navi, mit Suckerfish als Grundlage. Hier muss man dann selber die gewünschten Anpassungen vornehemn)
* MenuMatic-ie6.css (erklährt sich glaube ich von selber *g* - muss eventuell nach eigenen Bedürfnissen angepasst werden)

Soviel zu dem kleinen Tutorial.
Natürlich muss das ganze Individuell angepasst werden. Aber das Beispiel Layout dürfte so nun jeder zum laufen bekommen ;-)

Link zum Thread im Forum: [http://www.contao-community.de/showthread.php?8719-Mootools-Aufklappmen%FC-MenuMatic-in-TYPOlight-benutzen&p=60633#post60633 Forum-Diskusionsthread]

----

--[[Benutzer:MacKP|MacKP]] 13:34, 20. Jun. 2010 (UTC)

Mootools Aufklappmenü MenuMatic

2012-07-10T19:27:19Z

Carino: /* DEPRECEATED ? */

{{AppliesTo|TLVersion=2.8.x|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]

=Mootools Aufklappmenü MenuMatic in Contao benutzen=

Da es immer viele Probleme mit Menüs gibt und sich viele Bewegende Menüs wünschen habe ich mal MenuMatic ( [http://greengeckodesign.com/menumatic http://greengeckodesign.com/menumatic] ) in Typolight eingebaut. Auf der Seite sind auch 2 Beispiele.
== DEPRECEATED ? ==
Der Entwickler hat sich vom Script verabschiedet,
http://greengeckodesign.com/future-menumatic
Dieses Mootools-Script ist also nur noch mit Vorsicht zu geniesen ( Siehe auch
https://www.contao-community.de/showthread.php?27830-Contao-2-11-und-Menumatic-vorr%FCbergehende-L%F6sung )
18.4.2012 Geraldo

Der jüngste Beitrag des Theras bietet Dank Jan Theofel und Andreas Schempp eine Lösung für Contao 2.11.4:
https://www.contao-community.de/showthread.php?27830-Contao-2-11-und-Menumatic-vorr%FCbergehende-L%F6sung&p=210212&viewfull=1#post210212

==Voraussetzung:==
Mootools 1.2 (also TL ab 2.8)
Grundlegende Erfahrung mit TYPOlight und Seitenstruktur
gute CSS-Kentnisse um es genau anpassen zu können
für die Grundfunktion so wie es ist keine JavaScript-Kentnisse

==Dazu ist eigenltich nicht viel nötig.==
Von der Seite ( [http://greengeckodesign.com/menumatic http://greengeckodesign.com/menumatic] ) ganz unten die Dateien herunterladen.
Da sind 2 Beispiele drinn:
* horizontal
* vertical

==Vorgehen:==
'''1.''' Die benötigten CSS-Dateien importieren (entweder aus dem Ordner horizontal ode vertical, je nach Bedarf). Das CSS für den IE6 dann auch passend mit conditional Comment versehen.
Die JS-Datei hochladen (z.B. in den Ordner js). Diese Datei muss lesbar für alle sein.

'''2.''' Ein neues Navigation Template erstellen mit diesem Inhalt (nav_MenuMatic.tpl):
<source lang="php">
<ul <?php if ($this->level == 'level_1'): ?>id="nav"<?php endif; ?> class="vlist <?php echo $this->level; ?>">
<?php foreach ($this->items as $item): ?>
<?php if ($item['isActive']): ?>
<li class="active<?php if ($item['class']): ?> <?php echo $item['class']; ?><?php endif; ?>"><a href="<?php echo $item['href']; ?>" title="<?php echo $item['pageTitle'] ? $item['pageTitle'] : $item['title']; ?>"<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?><?php if ($item['accesskey'] != ''): ?> accesskey="<?php echo $item['accesskey']; ?>"<?php endif; ?><?php if ($item['tabindex']): ?> tabindex="<?php echo $item['tabindex']; ?>"<?php endif; ?><?php if ($item['nofollow']): ?> rel="nofollow"<?php endif; ?><?php echo $item['target']; ?>><em><?php echo $item['link']; ?></em></a><?php echo $item['subitems']; ?></li>
<?php else: ?>
<li<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?>><a href="<?php echo $item['href']; ?>" title="<?php echo $item['pageTitle'] ? $item['pageTitle'] : $item['title']; ?>"<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?><?php if ($item['accesskey'] != ''): ?> accesskey="<?php echo $item['accesskey']; ?>"<?php endif; ?><?php if ($item['tabindex']): ?> tabindex="<?php echo $item['tabindex']; ?>"<?php endif; ?><?php if ($item['nofollow']): ?> rel="nofollow"<?php endif; ?><?php echo $item['target']; ?>><?php echo $item['link']; ?></a><?php echo $item['subitems']; ?></li>
<?php endif; ?>
<?php endforeach; ?>
</ul>
</source>
'''Anpassungen (2 Stück):'''
* Das erste <nowiki><ul></nowiki> bekommt die ID 'nav' (darüber kann dann mit JavaScript das Menü angesprochen werden)
* Hier sind auch die aktiven Navi Punkte verlinkt und nicht mit einem span sondern mit em umschlossen. So werden die Beispiele nicht mehr davon beeinflusst und man kann es trotzdem gut mit CSS ansprechen.

'''3.''' Ein neues Navigationsmodul (genaueres kann hier nachgelesen werden zu dem Modul -> [http://de.contaowiki.org/ModulNavigation http://de.contaowiki.org/ModulNavigation]) :
* Startlevel 0
* Stoplevel 0
* Referenzseite (keine bzw. Startpunkt oder was man möchte)
* Navigationstemplate: (das von uns gerade erstellte) nav_MenuMatic.tpl

'''4.''' Neues Seitenlayout:
* Navigationsmodul von gerade da hin packen wo man es haben möchte
* Eigener JavaScript-Code:

<source lang="javascript">


<script src="js/MenuMatic_0.68.3.js" type="text/javascript" charset="utf-8"></script>


<script type="text/javascript" >
window.addEvent('domready', function() {
var myMenu = new MenuMatic();
});
</script>
</source>

(Damit initialisiert man das Menü und kann noch Parameter übergeben. Genaueres ist auf der oben verlinkten Seite zu finden)

Cave: für das vertikale Menü muss dieser JS-Code ergänzt werden an dieser Stelle:

<source lang="javascript">
var myMenu = new MenuMatic({ orientation:'vertical' });
</source>

'''CSS-Dateien auswählen:'''
* style.css (nur Beispiellayout, also nicht benutzen, wenn man ein eigenes hat!)
* MenuMatic.css (hier ist alles für die Navi, mit Suckerfish als Grundlage. Hier muss man dann selber die gewünschten Anpassungen vornehemn)
* MenuMatic-ie6.css (erklährt sich glaube ich von selber *g* - muss eventuell nach eigenen Bedürfnissen angepasst werden)

Soviel zu dem kleinen Tutorial.
Natürlich muss das ganze Individuell angepasst werden. Aber das Beispiel Layout dürfte so nun jeder zum laufen bekommen ;-)

Link zum Thread im Forum: [http://www.contao-community.de/showthread.php?8719-Mootools-Aufklappmen%FC-MenuMatic-in-TYPOlight-benutzen&p=60633#post60633 Forum-Diskusionsthread]

----

--[[Benutzer:MacKP|MacKP]] 13:34, 20. Jun. 2010 (UTC)

Arbeiten mit Bildern

2012-03-13T15:22:17Z

Carino: /* Parameter */

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]{{AppliesTo
|TLVersion=ab 2.7
|Version=ab 2.9
}}
Das Contao-Framework stellt folgende Methoden für das Arbeiten mit Bildern zur Verfügung:
# generateImage()
# getImage()
Die Original-Daten, welche meistens unter dem Ordner '''tl_files''' abgelegt sind werden aufbereitet.
Hierzu wird das Bild in der entsprechenden Größe unter '''system/html''' abgelegt und auf der Webseite werden nur noch Verweise auf diese erzeugte Kopie ausgegeben.

== getImage() ==
Die Methode getImage() ist in der Datei system/libraries/Controller.php angesiedelt und stellt fünf Parameter zur Verfügung, von welchen die ersten drei verpflichtend sind.
Die Methode erstellt eine neue Version des Original-Bildes und legt dieses im Cache Verzeichnis /system/html ab, sofern der Parameter $target nicht übergeben wird.
Es wird der Pfad zum neuen Bild zurück gegeben, wenn die Verarbeitung funktioniert hat.

Aktuell verarbeitet Contao die Bildformate welche von PHP (gdlib) unterstützt werden: jpeg, jpg, png und gif (nur lesen)

=== Parameter ===
# $image: Enthällt den Pfad zu dem Bild welches bearbeitet werden soll. (BSP: tl_files/images/foobar.jpg)
# $width: enthällt die gewünschte Breite des Bildes (z.B.: 200)
# $height: enthällt die gewünschte Höhe des Bildes (z.B.: 250)
# $mode: optionale Angabe der Skallierungsmethode
## proportional
## box
## crop (absolete seit 2.11)
## left_top (seit 2.11)
## center_top (seit 2.11)
## right_top (seit 2.11)
## left_center (seit 2.11)
## center_center ( seit 2.11 - rückwärtskompatibel für crop)
## right_center (seit 2.11)
## left_bottom (seit 2.11)
## center_bottom (seit 2.11)
## right_bottom (seit 2.11)

# $target: Ort an dem das neue Bild gespeichert werden soll, relativ zu TL_ROOT.

== generateImage() ==
Die Methode generateImage() ist ebenfalls in der Controller.php angesiedelt und erzeugt einen HTML <img> Tag welcher in einem Template ausgegeben werden kann. Diese Methode besitzt 3 Parameter wovon nur der Erste verpflichtend angegeben werden muss. Wird beim Parameter $src kein Pfad angegeben, sondern nur ein Bildname (Pfade beginnen immer mit / und sind relativ zum TL_ROOT zu verstehen, Bildnamen nicht) so sucht Contao das Bild im aktuellen Themes Verzeichnis. (i.d.R.: /system/themes/default/images/ sofern kein anderes Backend-Theme gewählt wurde).

=== Parameter ===
# $src: Der Pfad zum Bild welches eingebunden werden soll. (hier kann z.B. der Rückgabewert der Methode getImage() verwendet werden)
# $alt: Angabe eines Wertes für das alt-Attribut. Dieser ist laut [[w:de:W3C|W3C]] Pflicht und sollte immer angegeben werden.
# $attributes: Angabe weiterer Attribute für das zu erzeugende <img> Tag. (z.B.: inline [[w:de:CSS|CSS]] via style Attribut, etc.)

== Codebeispiele ==
Mit folgendem Code kann eine neue verkleinerte Version eines Bildes im Cache abgelegt und auf der Seite ausgegeben werden:
<source lang="php">
$strReturn = $this->generateImage($this->getImage('tl_files/images/foobar.jpg', 300, 250, 'proportional'), 'my first image');
// nun den Wert an ein Template übergeben.
$this->Template->myFirstImage = $strReturn;
</source>

Arbeiten mit Bildern

2012-03-13T15:20:53Z

Carino: Ergänzungen

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]{{AppliesTo
|TLVersion=ab 2.7
|Version=ab 2.9
}}
Das Contao-Framework stellt folgende Methoden für das Arbeiten mit Bildern zur Verfügung:
# generateImage()
# getImage()
Die Original-Daten, welche meistens unter dem Ordner '''tl_files''' abgelegt sind werden aufbereitet.
Hierzu wird das Bild in der entsprechenden Größe unter '''system/html''' abgelegt und auf der Webseite werden nur noch Verweise auf diese erzeugte Kopie ausgegeben.

== getImage() ==
Die Methode getImage() ist in der Datei system/libraries/Controller.php angesiedelt und stellt fünf Parameter zur Verfügung, von welchen die ersten drei verpflichtend sind.
Die Methode erstellt eine neue Version des Original-Bildes und legt dieses im Cache Verzeichnis /system/html ab, sofern der Parameter $target nicht übergeben wird.
Es wird der Pfad zum neuen Bild zurück gegeben, wenn die Verarbeitung funktioniert hat.

Aktuell verarbeitet Contao die Bildformate welche von PHP (gdlib) unterstützt werden: jpeg, jpg, png und gif (nur lesen)

=== Parameter ===
# $image: Enthällt den Pfad zu dem Bild welches bearbeitet werden soll. (BSP: tl_files/images/foobar.jpg)
# $width: enthällt die gewünschte Breite des Bildes (z.B.: 200)
# $height: enthällt die gewünschte Höhe des Bildes (z.B.: 250)
# $mode: optionale Angabe der Skallierungsmethode

## proportional
## box
## crop (absolete seit 2.11)

Hinzugekommen seit 2.11:
## left_top
## center_top
## right_top
## left_center
## center_center (rückwärtskompatibel für crop)
## right_center
## left_bottom
## center_bottom
## right_bottom

# $target: Ort an dem das neue Bild gespeichert werden soll, relativ zu TL_ROOT.

== generateImage() ==
Die Methode generateImage() ist ebenfalls in der Controller.php angesiedelt und erzeugt einen HTML <img> Tag welcher in einem Template ausgegeben werden kann. Diese Methode besitzt 3 Parameter wovon nur der Erste verpflichtend angegeben werden muss. Wird beim Parameter $src kein Pfad angegeben, sondern nur ein Bildname (Pfade beginnen immer mit / und sind relativ zum TL_ROOT zu verstehen, Bildnamen nicht) so sucht Contao das Bild im aktuellen Themes Verzeichnis. (i.d.R.: /system/themes/default/images/ sofern kein anderes Backend-Theme gewählt wurde).

=== Parameter ===
# $src: Der Pfad zum Bild welches eingebunden werden soll. (hier kann z.B. der Rückgabewert der Methode getImage() verwendet werden)
# $alt: Angabe eines Wertes für das alt-Attribut. Dieser ist laut [[w:de:W3C|W3C]] Pflicht und sollte immer angegeben werden.
# $attributes: Angabe weiterer Attribute für das zu erzeugende <img> Tag. (z.B.: inline [[w:de:CSS|CSS]] via style Attribut, etc.)

== Codebeispiele ==
Mit folgendem Code kann eine neue verkleinerte Version eines Bildes im Cache abgelegt und auf der Seite ausgegeben werden:
<source lang="php">
$strReturn = $this->generateImage($this->getImage('tl_files/images/foobar.jpg', 300, 250, 'proportional'), 'my first image');
// nun den Wert an ein Template übergeben.
$this->Template->myFirstImage = $strReturn;
</source>

Dma elementgenerator

2011-07-08T15:02:10Z

Carino: Ergänzung Galerie

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=Carsten Kollmeier
| DevSite=http://www.ckollmeier.de/
| ExtVersion=0.0.1 beta2
| Version=ab 2.9
| TLVersion=2.7.6 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.14.de.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Textfeld:<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel<br />

Textfeld:<br />
Beschriftung = Autor<br />
Feldname = autor<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Autor<br />

Textfeld:<br />
Beschriftung = Verlag<br />
Feldname = verlag<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Verlag<br />

Textfeld:<br />
Beschriftung = Alter<br />
Feldname = alter<br />
Beschreibung = Bitte nennen Sie, für welches Alter das Buch geeignet ist<br />

Textfeld:<br />
Beschriftung = Form<br />
Feldname = form<br />
Beschreibung = Bitte nennen Sie, welche Form das Buch aufweist<br />

Textarea:<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Dateiauswahl:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>

</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />

== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

== Bildergalerie darstellen ==

Hier ein Codeschnipsel, wie man im Template auf die Bilddaten im Falle einer Galerie zugreift:

<source lang="php">
<?php foreach(deserialize($this->elements['gallery'], true) as $bild): ?>
<img src="<?php echo $bild; ?>" />
<?php endforeach; ?>
</source>

Hierzu muss das serilisierte Array zunächst deserialisiert werden und kann dann über eine foreach Schleife schließlich ausgegeben werden. Das Beispiel ist absichtlich sehr einfach gehalten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Isotope-Attribute

2010-12-13T21:39:25Z

Carino:

[[Kategorie:Isotope eCommerce]]
=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

===Alle Bilder ausgeben:===
<?php echo $this->icons->generateGallery('icons', 0); ?>

===Alle außer das erste Bild ausgeben:===
<?php echo $this->icons->generateGallery('icons'); ?>

===Nur das erste Bild ausgeben:===
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="php">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Isotope-Attribute

2010-12-07T14:40:06Z

Carino: /* Nur das erste Bild ausgeben: */

=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

===Alle Bilder ausgeben:===
<?php echo $this->icons->generateGallery('icons', 0); ?>

===Alle außer das erste Bild ausgeben:===
<?php echo $this->icons->generateGallery('icons'); ?>

===Nur das erste Bild ausgeben:===
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="php">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Isotope-Attribute

2010-12-07T14:39:55Z

Carino: /* Alle außer das erste Bild ausgeben: */

=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

===Alle Bilder ausgeben:===
<?php echo $this->icons->generateGallery('icons', 0); ?>

===Alle außer das erste Bild ausgeben:===
<?php echo $this->icons->generateGallery('icons'); ?>

==Nur das erste Bild ausgeben:==
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="php">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Isotope-Attribute

2010-12-07T14:39:43Z

Carino: /* Alle Bilder ausgeben: */

=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

===Alle Bilder ausgeben:===
<?php echo $this->icons->generateGallery('icons', 0); ?>

==Alle außer das erste Bild ausgeben:==
<?php echo $this->icons->generateGallery('icons'); ?>

==Nur das erste Bild ausgeben:==
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="php">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Isotope-Attribute

2010-12-07T14:39:25Z

Carino: /* Download/PDF Link als Attribut */

=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

==Alle Bilder ausgeben:==
<?php echo $this->icons->generateGallery('icons', 0); ?>

==Alle außer das erste Bild ausgeben:==
<?php echo $this->icons->generateGallery('icons'); ?>

==Nur das erste Bild ausgeben:==
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="php">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Isotope-Attribute

2010-12-07T14:39:04Z

Carino: Die Seite wurde neu angelegt: „=Bildergalerien mit Attributen = Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute …“

=Bildergalerien mit Attributen =
Wenn man bei Isotope eine zusätzliche Bildergalerie anlegen möchte, geht das ganz einfach über Shop-Konfiguration > Attribute > New Attribute. Dort das Formular beispielsweise folgendermaßen ausfüllen:

Name: Produkt Icons
Interner Name: icons
Typ: Media Manager
Field Group: Media Management
Description: Bitte laden Sie hier die jeweiligen Produkt-Icons hoch
Image gallery: Default gallery (Lightbox/Mediabox)
Allowed file types: jpg, jpeg, gif, png

Ist dieses gespeichert, wechselt man nach Shop-Konfiguration > Produkttypen, wählt einen Produkttypen und aktiviert das neue Attribut "Produkt Icons".

Als Nächstes muss unter Shop-Konfiguration > Konfiguration die Bildgröße eingestellt werden. Hierzu fügt man ganz unten bei "Image sizes" einen neuen Datensatz hinzu. Diesen benennt man "icons" und vergibt die gewünschte Bildgröße.

Nun kann z.B. das Linkverhalten im Template iso_gallery_default.tpl angepasst und in die Abfragen mit einbezogen werden.

Zuletzt muss das Template (beispielsweise iso_reader_default) angepasst werden:

==Alle Bilder ausgeben:==
<?php echo $this->icons->generateGallery('icons', 0); ?>

==Alle außer das erste Bild ausgeben:==
<?php echo $this->icons->generateGallery('icons'); ?>

==Nur das erste Bild ausgeben:==
<?php echo $this->icons->generateMainImage('icons'); ?>

= Download/PDF Link als Attribut =

{{Hinweis|PDF Dateien lassen sich zwar als Attribut anlegen, doch sie werden so wie eine Bildergalerie behandelt und werden dadurch gar nicht angezeigt.}}

Somit zeige ich euch einen Workaround, wie man doch PDF Dateien integrieren kann:

Wie man ein Attribut anlegt, habe ich weiter oben erklärt. Bei allowed file types sollten nur Dateiendungen zugelassen werden, die tatsächlich auch hochgeladen werden sollen. Beispielsweise: pdf,doc,xls

Im Template kommt nun folgender Codeabschnitt zum Tragen:

<source lang="html">
<?php
$pdf = deserialize($this->raw['download_pdf']);
$letter = substr($pdf[0]['src'], 0, 1); ?>
<a href="/isotope/<?php echo $letter."/".$pdf[0]['src']; ?>"><?php echo $this->name; ?></a>
</source>

Hierbei wird zunächst das Array deserialisiert, wegen der Ordnerstruktur mit substr der erste Buchstabe extrahiert und das ganze in einen Link verpackt.

{{Hinweis|Eine Linkbeschreibung ist noch nicht integriert.}}

Wartungsmodus mit exclusiven Zugriff

2010-11-04T09:35:02Z

Carino:

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]{{AppliesTo
|TLVersion=ab 2.7
|Version=ab 2.9
}}
Einen Wartungsmodus erstellen, und trotzdem Kunden und sich selbst Zugang zur Seite bieten.

Befindet sich eine Seite online im Aufbau und ein Kunde soll sich Anpassungen anschauen koennen, jedoch normale Besucher und Suchmaschine nicht, ist durch diese kleinen Anpassungen moeglich dies zu verwirklichen.

Aufbau eine geheimen Landingpage, die ein Cookie im Browser setzt. Diese kann zusaetlich noch via htaccess passwort geschuetzt werden.

<source>
<html>
<?php echo setcookie("gesicherteSeite","halloWelt"); ?>

Ihr Zugang wurde gewaehrt!
</html>
</source>

Ein Link auf diese Webseite kann dem Kunden zugeschickt werden. Wird diese Seite nun aufgerufen, wird ein Cookie im Browser installiert.

Nun nur noch in der fe_page.tpl eine kleine Anpassung in der ersten Zeile

<source>
<?php if ($_COOKIE["gesicherteSeite"]!="halloWelt") $this->redirect("http://www.contao.org"); ?>
</source>

Somit wird bei der Ausgabe der eigentlichen Webseite kontrolliert, ob das Cookie gesetzt ist. Wenn ja, geht alles normal weiter, und der Kunde kann die normale Webseite sehen. Ist das Cookie nicht vorhanden, wird direkt auf eine andere Seite umgeleitet, in diesem Falle auf contao.org

{{msgInfo|Das Cookie kann auch noch eine Verfallszeit und die Domain enthalten. Dies ist hier nicht aufgefuehrt. Nachzulesen hier : http://php.net/manual/de/function.setcookie.php}}

Online-Shops

2010-10-17T10:29:42Z

Carino: /* Vergleichstabelle */

{{stub}}
[[Category:Extensions]]
Auf dieser Seite soll ein Überblick über die bestehenden Shop-Lösungen für Contao entstehen.

== Vergleichstabelle ==

{| border="1" cellspacing="0" cellpadding="5"
! Kategorien !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| beliebige Haupt- und Unterkategorien || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| colspan="5" |

|-
! Artikelverwaltung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| Artikel || Ja || Ja || Ja || Ja
|-
| Produktgruppen || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| Artikel mit Varianten || Nein || Ja || Ja || Ja
|-
| Artikel in mehreren Kategorien || Nein || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| Downloadartikel || Nein || Ja || Ja || Bezahlte Inhalte
|-
| Artikelempfehlungen (zu Artikel x paßt Artikel y) || Ja || Ja || Ja || via [[Catalog|Katalog-Extension]]
|-
| Artikel als NEU markieren || Ja || Ja || ? || via [[Catalog|Katalog-Extension]]
|-
| Artikel als ANGEBOT markieren || Ja || Ja || ? || via [[Catalog|Katalog-Extension]]
|-
| Artikelnummern || Ja || Ja || Ja || Ja
|-
| Artikelnummern je Variante || Nein || Ja || Ja || automatisch generiert
|-
| colspan="5" |

|-
! Lizenzierung !! Contao webShop<br />Community Edition !! Contao webShop<br />Business Edition !! Isotope<br />eCommerce !! chShop
|-
| Demo-Shop Template & Layout inkl. || Nein || Ja || Ja || ohne Layout
|-
| Support per E-Mail || Nein || Ja || Nein || Nein
|-
| Support per Forum || Ja || Ja || Ja || Ja
|-
| Support per Ticketsystem || Ja || Ja || Ja || Nein
|-
| Lizenz || EULA || EULA || LGPL || LGPL
|-
| '''Preis netto''' || '''0,00 €''' || '''499,00 €''' || '''0,00€''' || '''0,00 €'''
|}

Dma elementgenerator

2010-09-07T21:38:58Z

Carino: /* Felder hinzufügen */

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=Carsten Kollmeier
| DevSite=http://www.ckollmeier.de/
| ExtVersion=0.0.1 beta2
| Version=ab 2.9
| TLVersion=2.7.6 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.14.de.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Textfeld:<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel<br />

Textfeld:<br />
Beschriftung = Autor<br />
Feldname = autor<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Autor<br />

Textfeld:<br />
Beschriftung = Verlag<br />
Feldname = verlag<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Verlag<br />

Textfeld:<br />
Beschriftung = Alter<br />
Feldname = alter<br />
Beschreibung = Bitte nennen Sie, für welches Alter das Buch geeignet ist<br />

Textfeld:<br />
Beschriftung = Form<br />
Feldname = form<br />
Beschreibung = Bitte nennen Sie, welche Form das Buch aufweist<br />

Textarea:<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Dateiauswahl:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>

</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />

== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T21:35:10Z

Carino: /* Template anlegen */

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=Carsten Kollmeier
| DevSite=http://www.ckollmeier.de/
| ExtVersion=0.0.1 beta2
| Version=ab 2.9
| TLVersion=2.7.6 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.14.de.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel

Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>

</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />

== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T20:40:40Z

Carino: /* Buch als Inhaltselement integrieren */

Dma elementgenerator

2010-09-07T20:39:55Z

Carino: /* Buch als Inhaltselement integrieren */

Dma elementgenerator

2010-09-07T20:39:05Z

Carino:

Dma elementgenerator

2010-09-07T20:38:36Z

Carino: ExtInfo

[[Kategorie:Extensions]]

{{ExtInfo
| Dev=Carsten Kollmeier
| DevSite=http://www.ckollmeier.de/
| ExtVersion=0.0.1 beta2
| Version=ab 2.7
| TLVersion=2.7.6 - 2.8.3
| ERLink=http://www.contao.org/erweiterungsliste/view/dma_elementgenerator.14.de.html
| Forum=http://www.contao-community.de/showthread.php?6119-dma_elementgenerator-Contentelemente-und-Frontendmodule-generieren
}}

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Man klickt also auf die Schaltfläche "Neues Element" und füllt die Maske wie folgt aus:
<br />
Bezeichnung = Buch<br />
Kategorie = Layouts<br />
Template = dma_eg_default (temporär)<br />
''Als Inhaltselement bereitstellen'' auswählen<br />
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lässt man vorübergehend so, bis man später ein eigenes Template für den Datensatz erstellt.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legt man die Felder an, die man ausgeben möchte. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legt man ein Textfeld an und füllt es folgendermaßen aus:
<br />
Beschriftung = Titel<br />
Feldname = titel<br />
Beschreibung = Bitte vergeben Sie für das Buch einen Titel

Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung<br />
Feldname = beschreibung<br />
Beschreibung = Bitte beschreiben Sie das Buch<br />
Zeilen = 5<br />
Spalten = 100<br />

Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:<br />
Beschriftung = Bild<br />
Feldname = bild<br />
Beschreibung = Wählen Sie ein Bild aus<br />
Vorgabe = (hier könnte man ein Default-Bild angeben)<br />
Art der Auswahl = ft_radio<br />
Pfad = Pfad/zum/Bild.jpg<br />

== Template anlegen ==
Nun liegt ein Datensatz vor mit drei Feldern, die man in einem Template abfragen möchte. Unter Layout/Templates leget man ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weist diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der Name geändert werden (z.B. in dma_eg_buchvorstellung.tpl) und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeder andere Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:26:48Z

Carino: /* DMA Elementgenerator */

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeden anderen Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:26:31Z

Carino: /* Beispiel */

= DMA Elementgenerator =

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel / Tutorial =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeden anderen Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:26:14Z

Carino: /* Buch als Inhaltselement */

= DMA Elementgenerator =

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement integrieren ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeden anderen Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:25:59Z

Carino: /* Element erstellen */

= DMA Elementgenerator =

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel =
== Element erstellen ==
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeden anderen Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:25:45Z

Carino:

= DMA Elementgenerator =

Der Elementgenerator bietet eine Möglichkeit, Daten in einem vorgegebenem Layout auszugeben.

= Beispiel =
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
<br />
In dem Template wird das Bild in einer Breite von 150 Pixel ausgegeben, die Bildunterschrift gibt den Titel wieder.
<br />
== Buch als Inhaltselement ==

In der Artikelstruktur lässt sich nun dieses Inhaltelement "Buch" wie jeden anderen Elementtyp dem Artikel hinzufügen. Wählt man diese nun aus, findet man die drei Felder vor, die nun auszufüllen sind und kann den Datensatz nun Speichern und betrachten.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:19:40Z

Carino:

=Beispiel=
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten. Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu. Nach dem Speichern kann über "bearbeiten" der name geändert werden. z.B. in dma_eg_buchvorstellung.tpl und natürlich muss man dieses neue Template unter "Elementgenerator/Buch" gegen das Standardtemplate ersetzen.
<br />
<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>
== Template ==

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:09:46Z

Carino: /* Template anlegen */

=Beispiel=
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten.
Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu.

<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>

<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>
</source>

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T19:02:05Z

Carino: /* Template anlegen */

=Beispiel=
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten.
Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu.

<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<?php if ($this->elements['bild']): ?>


<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['titel']; ?>" width="150" />
<div class="caption"><?php if ($this->elements['titel']): ?>
<?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div>

</div>

<?php endif; ?>

<div>

<?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?>

</div>
</div>

</source>

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T18:55:43Z

Carino: /* Template anlegen */

=Beispiel=
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten.
Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu.

<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?>
<?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?>
<?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?>
<?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?>
<?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?
><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>



</source>

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T18:55:12Z

Carino: /* = Element erstellen */

=Beispiel=
= Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten.
Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu.

<source lang="php">
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?>
<?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>

<h1><?php echo $this->elements['titel']; ?></h1>

<div class="left">
<table>
<tbody>
<tr><td class="first"><?php if ($this->elements['titel']): ?><?php echo $this->labels['titel']; ?>:</td><td class="last"><?php echo $this->elements['titel']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['autor']): ?><?php echo $this->labels['autor']; ?>:</td><td class="last"><?php echo $this->elements['autor']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['verlag']): ?><?php echo $this->labels['verlag']; ?>:</td><td class="last"><?php echo $this->elements['verlag']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['alter']): ?><?php echo $this->labels['alter']; ?>:</td><td class="last"><?php echo $this->elements['alter']; ?><?php endif; ?></td></tr>
<tr><td class="first"><?php if ($this->elements['form']): ?><?php echo $this->labels['form']; ?>:</td><td class="last"><?php echo $this->elements['form']; ?><?php endif; ?></td></tr>
</tbody>
</table>
</div>

<?php if ($this->elements['bild']): ?>
<div class="right">
<div class="image_container">
<img src="<?php echo $this->elements['bild']; ?>" alt="<?php echo $this->elements['name']; ?>" width="150" />

<div class="caption"><?php if ($this->elements['titel']): ?><?php echo $this->elements['titel']; ?><?php endif; ?></div>
</div></div></div>
<?php endif; ?>

<div class="twocol"> <?php if ($this->elements['beschreibung']): ?><?php echo nl2br($this->elements['beschreibung']); ?><?php endif; ?></div>
</div>



</source>

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Dma elementgenerator

2010-09-07T18:53:31Z

Carino: Die Seite wurde neu angelegt: „=Beispiel= == Element erstellen = Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout. <br /> An…“

=Beispiel=
== Element erstellen =
Nach der erfolgreichen Installation wählt man zunächst den neuen Menüpunkt "Elementgenerator" unterhalb von Layout.
<br />
An dieser Stelle lassen sich Elemente erstellen, die völlig unabhängig voneinander strukturierte Inhalte ausgeben. Wir klicken also auf die Schaltfläche "Neues Element" und füllen die Maske wie folgt aus:
<br />
Bezeichnung = Buch
Kategorie = Layouts
Template = dma_eg_default (temporär)
Als Inhaltselement bereitstellen auswählen
<br />
Die Bezeichnung dient nur der internen Verwaltung im Backend. Auch der Name der Kategorie ist frei wählbar und ordnet die Datensätze mit gleicher Bezeichnung innerhalb der Auswahl des Elementtyps im Bereich der Inhaltselemente. Das Template lassen wir vorübergehend so, bis wir später ein eigenes Template für den Datensatz erstellen.
<br />
Der Datensatz lässt sich selbstverständlich auch als Modul bereitstellen. Somit kann man diesen beispielsweise auch direkt im Seitenlayout verlinken.<br />

== Felder hinzufügen ==
Nun legen Sie Felder an, die Sie ausgeben möchten. Die Auswahl ähnelt der von Formularen: Legende, Textfeld, Textarea, Auswahlliste, Checkboxen, Radiobuttons, Seitenauswahl, Dateiauswahl<br />
Als nächstes legen wir ein Textfeld und füllen es folgendermaßen aus:
<br />
Beschriftung = Titel
Feldname = titel
Beschreibung = Bitte vergeben Sie für das Buch einen Titel
<br />
Danach ein Textarea mit diesen Daten:
<br />
Beschriftung = Beschreibung
Feldname = beschreibung
Beschreibung = Bitte beschreiben Sie das Buch
Zeilen = 5
Spalten = 100
<br />
Letzlich noch ein Feld "Dateiauswahl" zur Generierung eines Bildes:
<br />
Beschriftung = Bild
Feldname = bild
Beschreibung = Wählen Sie ein Bild aus
Vorgabe = (hier könnte man ein Default-Bild angeben)
Art der Auswahl = ft_radio
Pfad = Pfad/zum/Bild.jpg
<br />
== Template anlegen ==
Nun liegt uns ein Datensatz vor mit drei Feldern, die wir in einem Template abfragen möchten.
Unter Layout/Templates legen wir ein neues Template auf Basis des Originaltemplates "dma_eg_default.tpl" und weisen diesem das jeweilige Zielverzeichnis zu.

----
--[[Benutzer:Carino|Carino]] 21:00, 07. Sept. 2010 (UTC)

Eigene insert tags erstellen

2010-07-31T23:02:48Z

Carino: Es fehlte ein Hochkomma.

{{stub}}
[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]
{{AppliesTo
|TLVersion=ab 2.6
|Version=ab 2.9
}}
Unter Insert-Tags versteht man in Contao spezielle Platzhalter, die beim Laden der Webseite durch bestimmte Inhalte ersetzt werden. Dies können zum Beispiel der aktuelle Benutzername, ein Datum oder ein Link sein. Der Contao-Core bietet eine ganze Reihe verschiedener Insert-Tags, welche auf der Projekthomepage dokumentiert sind (siehe [http://www.contao.org/inserttags.html Contao Insert-Tags]).

== Aufbau eines Insert-Tags ==
Insert-Tags werden generell in zwei geschwungenen Klammern verpackt. <nowiki>{{var::value}}</nowiki> Des weiteren sind Insert-Tags meistens zweigeteilt. Die Wertepaare sind durch zwei Doppelpunkte getrennt. Der erste Teil ist entweder die Kategoriezugehörigkeit des Insert-Tags oder der Name des Tags. Der zweite Teil ist meistens ein Parameter, um die gewünschte Rückgabe noch zu verfeinern. Ein Beispiel verdeutlicht dies: <nowiki>{{link::*}}</nowiki> Dieser Insert Tag würde einen Link zur Seite * (muss durch die ID der Seite ersetzt werden) im richtigen URL Format generieren.

== Eigene Insert-Tags erstellen ==
Seit TYPOlight Version 2.6 kann man Contao durch eigene Insert-Tags erweitern. Dazu wurde der Hook replaceInsertTags zur Verfügung gestellt. Der Ablauf ist nun folgender.
# Contao parsed einen Seitenaufruf und stößt dabei auf ein Insert-Tag
# Contao probiert dieses Insert-Tag mit den Core-Möglichkeiten zu ersetzen
# Wenn Contao das Insert-Tag nicht kennt, wird es an den Hook replaceInsertTags weitergereicht. Dieser Hook erhält das unbekannte Insert-Tag als Parameter. Nun kann der Entwickler prüfen ob er das unbekannte Insert-Tag ersetzen möchte und wenn ja, gibt er einen beliebigen Content zurück.
# Wenn der Entwickler nichts mit dem unbekannten Insert-Tag anfangen kann, so muss false zurück gegeben werden.

== Codebeispiel ==
In diesem Code-Beispiel soll der Insert-Tag <nowiki>{{foo::bar}}</nowiki> ersetzt werden.
Als erstes muss der Hook registriert werden.
// config.php
// Registrieren des Hooks replaceInsertTags
$GLOBALS['TL_HOOKS']['replaceInsertTags'][] = array('MyClass', 'myReplaceInsertTags');

Nach der Registrierung des Hooks muss eine Klasse erstellt werden, welche eine Methode zur Ersetzung beinhaltet.
//MyClass.php
class MyClass extends Frontend
{
public function myReplaceInsertTags($strTag)
{
$arrSplit = explode('::', $strTag);

if ($arrSplit[0] == 'foo')
{
// replace your Insert Tag
return 'mein content';
}

return false;
}
}
In der Methode myReplaceInsertTags muss man zuerst prüfen, ob man für den unbekannten Insert-Tag zuständig ist. Wenn man einen zweigeteilten Insert-Tag verwendet, splittet man den Tag anhand des :: (explode). Die geschweiften Klammern werden bereits von Contao entfernt und müssen daher nicht mehr entfernt werden.

// der Schluss ist irgend wie noch nicht richtig Formuliert, ich kann leider nicht mehr, bin total übermüdet....

Catalog Templates anpassen

2010-07-24T08:27:54Z

Carino: /* Alle Werte ausgeben und nur einen anpassen und als Bild ausgeben (Taxonomie mit Icons) */

Catalog Templates anpassen

2010-07-24T08:27:40Z

Carino: /* Alle Werte ausgeben und nur einen anpassen und als Bild ausgeben (Taxonomie mit Icons) */

Catalog Templates anpassen

2010-07-23T09:40:01Z

Carino: /* Alle Werte ausgeben und nur einen Anpassen (als Beispiel Taxonomie mit Icons) */

Catalog Templates anpassen

2010-07-23T09:38:11Z

Carino: Ergänzung

Suchfunktion integrieren

2010-07-14T13:11:35Z

Carino: /* SEO Maßnahme: Suchergebnisse in Datenbank speichern */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
--[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert { {date::Y-m-d} } (Leerzeichen bitte entfernen).

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----

[[Benutzer:carino|carino]] 15:08, 14. Jul. 2010 (CEST)

Suchfunktion integrieren

2010-07-14T13:11:11Z

Carino: /* SEO Maßnahme: Suchergebnisse in Datenbank speichern */

Suchfunktion integrieren

2010-07-14T13:10:45Z

Carino: /* SEO Maßnahme: Suchergebnisse in Datenbank speichern */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
--[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert "{{ date::Y-m-d }}" (Leerzeichen bitte entfernen).

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----

[[Benutzer:Carino|carino]] 15:08, 14. Jul. 2010 (CEST)

Suchfunktion integrieren

2010-07-14T13:09:40Z

Carino: /* SEO Maßnahme: Suchergebnisse in Datenbank speichern */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
--[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert "{{date::Y-m-d}}".

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----

[[Benutzer:Carino|carino]] 15:08, 14. Jul. 2010 (CEST)

Suchfunktion integrieren

2010-07-14T13:09:30Z

Carino: /* Suchfunktion in eine Website integrieren */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
--[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert "{{date::Y-m-d}}".

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----
--[[Benutzer:Carino|carino]] 15:08, 14. Jul. 2010 (CEST)

Suchfunktion integrieren

2010-07-14T13:09:13Z

Carino: /* Suchfunktion in eine Website integrieren */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert "{{date::Y-m-d}}".

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----
--[[Benutzer:Carino|carino]] 15:08, 14. Jul. 2010 (CEST)

Suchfunktion integrieren

2010-07-14T13:08:55Z

Carino: /* Suchfunktion in eine Website integrieren */

[[Category:Admin HOWTOS]]
{{AppliesTo|TLVersion=ab 2.6|Version=ab 2.9}}
== Suchfunktion in eine Website integrieren ==

Die Suchfunktion soll im Kopfbereich platziert und die Ausgabe der Suchergebnisse in der Hauptspalte ausgeben werden?

1. Zunächst wird ein Modul vom Typ '''Suchmaschine''' erstellt.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Suchmaschine)''

2. Das Modul '''Suchmaschine''' wird in einen Artikel eingefügt. Dazu wird zuerst eine neue Seite in der Seitenstruktur angelegt, z.B. ''Suche'' und unter den Experteneinstellungen die Option '''Im Menü verstecken''' angeklickt sowie die Option ''Veröffentlichung der Seite'' ausgewählt.
''(Inhalt > Artikel > Artikel bearbeiten > Neues Inhaltselement > Elementtyp = Modul > Suchmaschine)''

3. Mit dem Formulargenerator wird ein einfaches Formular, z.B. Sucheingabe benannt, mit einem Textfeld und einem Absendebutton erstellt.
''(Inhalt > Formulargenerator > Neues Formular)''

* Im Formularkopf wird unter der Rubrik '''Experten-Einstellungen''' im Feld '''Formular-ID''' der Wert ''tl_search'' eingegeben.
* Als Weiterleitungsseite wird die Seite (z.B. Suche) ausgewählt, die das Modul Suchmaschine beinhaltet und die Suchergebnisse anzeigt.
* Der Feldnamen für das Textfeld wird ''keywords'' benannt.

4. Für das Formular wird ein Modul (z.B. Sucheingabe benannt) erstellt, um es z.B. im Kopfbereich (#header) ausgeben zu können.
''(Layout > Themes > Module > Neues Modul erstellen > Modultyp = Form > das Formular auswählen.)''

5. Das Modul Sucheingabe wird nun im Seitenlayout eingefügt und diesem Modul der Ausgabebereich zugewiesen; z.B. Kopfzeile (#header).
''(Layout > Themes > Seitenlayout > Seitenlayout bearbeiten)''

Somit kann die Sucheingabe in der Kopfzeile platziert und die Suchergebnisse in der Hauptspalte ausgeben werden.

----
--[[Benutzer:Planepix|Planepix]] 23:01, 4. Jul. 2010 (CEST) – Übersetzt und angepasst nach einem Tutorial von Ben Robinson.

== SEO Maßnahme: Suchergebnisse in Datenbank speichern ==

Oft ist es für Onpage Optimierungen sinnvoll, wenn man weiß was/wann die Besucher (et)was in den Suchschlitz schreiben. Hierzu habe ich mir folgendermaßen beholfen:

1. Neue Tabelle mit Zwei Spalten in Datenbank hinzugefügt (ohne tl_ Präfix).
2. Spalte 1 mit dem Namen "date" und dem Typ "date", Spalte 2 mit dem Namen "keywords"und dem Typ "tinytext".
3. Das Formular mit dem Suchfeld bearbeiten.
4. Den Formularheader bearbeiten und unter: "Formulardaten speichern", "Eingaben speichern" wählen und die neue Zieltabelle wählen.
5. Verstecktes Feld vor dem Suchfeld einfügen mit dem Feldnamen "date" und dem Standardwert "{{date::Y-m-d}}".

Nach dem Speichern werden sämtliche Suchanfragen des Suchfeldes im Header in die Datenbanktabelle geschrieben. Diese ließen sich z.B. auch in einem geschützten Bereich wieder ausgeben.

----
--[[Benutzer:Carino|carino]] 15:08, 14. Jul. 2010 (CEST)