Contao Community Documentation - Benutzerbeiträge [de]

Composer/Hosting

2014-08-28T09:06:14Z

MacKP: /* Tipps und Tricks */

{{stub}}
[[Category:Composer]]
[[Category:Extensions]]
[[Category:Admin HOWTOS]]
[[Category:Installation und Updates]]

=Kompatibilitätsliste=

Auf dieser Seite werden Webhoster gelistet, auf denen Contao mit Composer läuft, mit Einschränkungen läuft oder nicht läuft.

==Kompatible Webhostingpakete==

* [https://www.df.eu/ domainfactory] ManagedServer L4 ([[User:Hellschu|Hellschu]])/ ab ManagedHosting Pro lauffähig ([[User:MacKP|MacKP]])
* [http://hosteurope.de/ Hosteurope] Virtual Server Managed, phar whitellisten ([[User:Lucina|Lucina]])
* [https://inetrobots.de/ Inetrobots.de] Getestet mit Webhosting "Professional" ([https://community.contao.org/de/member.php?4042-ciaobello ciaobello]).
* [https://www.fc-hosting.de/ fc-hosting.de] Paket: Expert 3.2 ohne Extras ([https://community.contao.org/de/member.php?6680-dackelchen dackelchen])
* [http://www.metanet.ch Metanet.ch] Wichtig ist zu beachten dass mindestens Plesk 11.5 installiert ist (darauf beharren). Dann kann die notwendige Funktion im Kontrollpanel pro Domain eingeschaltet werden. Getestet mit METAHost ([https://community.contao.org/de/member.php?4042-ciaobello ciaobello]).
* [http://w4w.net/ w4w.net] Standardhosting ([[User:Lucina|Lucina]])
* [https://www.webhostone.de/ WebhostOne] Webhosting MultiApp ([[User:Lucina|Lucina]])

==Inkompatible Webhostingpakete==

* [http://df.eu/ Domain Factory] MyHomePlus (zu geringe Ressourcen, u.a. nur 50 MB Ram ([[User:Lucina|Lucina]])
* [https://www.webhostone.de/ WebhostOne] Webhosting Single App (RAM nicht ausreichend) ([[User:Lucina|Lucina]])

==Tipps und Tricks ==
* Bei df.eu kann die php.ini so bearbeitet werden, das auch die Optionalen Bedingungen erfüllt werden (per php.ini Editor im Backend von df.eu)

Composer/Hosting

2014-08-28T09:04:58Z

MacKP:

MetaModels Beispiel 1

2013-06-06T09:55:46Z

MacKP: /* MM-Funktion: Zugriffsrechte definieren */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]
=Aufgabenstellung: Backend einrichten=
Als Beispielprojekt soll eine einfache "Musikbox" gebaut werden, in der Musikstücke mit gewissen Attributen ("Eigenschaften") erfasst werden. Zu diesem Zweck wird zuerst das Backend aufgebaut. Hierzu braucht man eine Übersichtsliste und ein Erfassungsformular.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten

=Eine leere Datenbank erstellen=

[[File:mm_startscreen.png|thumb|400px]]

Zuerst wird ein neues MetaModel erstellt. Technischen gesehen wird dabei in der Contao-Datenbank eine leere Tabelle angelegt.

* Klick auf '''Neues MetaModel'''
* Name: '''Musicbox'''
* TabellenName: '''mm_musicbox'''

===Anmerkungen===

* Obwohl es so aussieht, als sei '''Übersetzung''' eine frei wählbare Option, ist "diese Option" ein MUSS, denn ohne Sprachenzuweisung funktioniert das ganze MetaModel nicht!
* '''Varianten unterstützen''' wird vorläufig nicht benötigt.... und gegebenenfalls zu einem späteren Zeitpunkt erläutert.

===Auszuführen===

* '''Übersetzung''' anhaken
* mindestens eine unterstützte Sprache auswählen
* eine Sprache (z.B. '''Deutsch''') zum Fallback machen
* '''Varianten aktivieren''' vorerst nicht anhaken

Man sieht nun ein MetaModel "Musicbox" mit 0 (null) Datensätzen und einer Reihe von Icons, die nun zur Weiterbearbeitung genutzt werden.

<div style="clear: both"><br></div>

==MetaModels Backend-Funktionen==
Kurze Erklärung, was sich hinter den nun dargestellten Symbolen verbirgt (in Klammern ist angegegeben, was als Tooltip ausgegeben wird):

[[File:mm_backend_funktionen_icons.png|link=|border]]

[[File:icons_bearbeiten.png|left|32px]]

Hier gelangt man wieder zurück zum gleichen Screen, wie bie der Erstellung eines neuen MetaModels. Hier kann man jederzeit sowohl den '''Namen''' als auch den '''Tabellennamen''' des MetaModels ändern.

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Attribute für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Render-Einstellungen für MetaModel ID x definieren)
# [[MetaModels_Backend:_Eingabemaske|'''Eingabemaske''']] (Eingabemaske für das MetaModel ID x definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Filter für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''Paletten- und Ansichtseinstellungen''']] (Definieren Sie die Eingabe- / Ausgabe-Optionen für MetaModel ID x)

=Das Backend konfigurieren=

Um das Backend für die Erfassung der Daten vorzubereiten benötigt man a) eine Übersichtsliste und b) ein Erfassungsformular. Hierzu braucht man 4 der 5 Backend-Funktionen von MetaModels.

* Datenbank erstellen, benennen, Sprachvariable zuweisen
* Felder definieren, Attribute festlegen, Erfassungsformular gestalten
* Übersichtsliste definieren
* Erfassung (z.B. für Redakteure) freigeben

==MM-Funktion: Attribute==

[[File:icons_attribute.png|left|32px]]

Hier erfasst man die benötigen Felder für die Eingabe.
s. [[MetaModels_Backend:_Attribute|allgemeine Infos]] zu den Attributen

[[File:mm_attribute_erfassen.png|thumb|400px]]

Hierzu gibt man folgende Felder ein (im nebenstehenden Screen ist das beispielhaft für das Attribut "Titel" dargestellt):
{|
|-
| '''Titel'''
|
* Attribute Type= Text
* Column name= title
* Name (deutsch)= Titel
* Description (deutsch)= Name des Stücks
|-
| '''Interpret'''
|
* Attribute Type= Text
* Column name= composer
* Name (deutsch)= Interpret
* Description (deutsch)= Name der Band, SängerIn oder InterpretIn
|-
| '''Land'''
|
* Attribute Type= Text
* Column name= country
* Name (deutsch)= Land
* Description (deutsch)=
|-
| '''Jahr'''
|
* Attribute Type= Dezimal
* Column name= year
* Name (deutsch)= Jahr
* Description (deutsch)= Erscheinungsjahr
|-
| '''Beschreibung'''
|
* Attribute Type= Langtext
* Column name= description
* Name (deutsch)= Beschreibung
* Description (deutsch)= Wikipedia, Kurzbeschreibung, etc.
|-
| '''Cover'''
|
* Attribute Type= Datei
* Column name= images
* Name (deutsch)= Cover
* Description (deutsch)= Cover, Bilder
|-
|colspan="2"|Bis jetzt wurde bei keinem der Attribute die Option '''Unique values''' aktiviert.<br><br>Um die Einträge eindeutig identifizieren zu können, wird zusätzlich ein Alias-Attribut erzeugt:
|-
| '''Alias'''
|
* Attribute Type= Alias
* Column name= alias
* Name (deutsch)= Alias
* Description (deutsch)=
* Unique values= aktiviert
* Alias Neuerstellung erzwingen = aktiviert<br>(dann muss kein Alias eingegeben werden, wird neu berechnet bei Änderung des Titels)
* Aliasfelder = Titel
|}

<div>

==MM-Funktion: Ausgabevorgaben==
[[File:icons_ausgabevorgaben.png|left|32px]]
Hier wird die Ansicht erfasst: Eine Listendarstellung für das Backend.

[[File:mm_ausgabe_definieren.png|right|thumb|400px]]

* Klick auf '''neu'''
* '''BE Listenansicht''' eingeben
* Der Rest kann so stehen bleiben, denn für die BE Listenansicht braucht man weder eine '''Zielseite''' noch '''Filter settings'''.

(s. [[MetaModels_Backend:_Ausgabevorgaben|allgemeine Ausgabe-Vorgaben]])

<div style="clear: both"></div>

[[File:mm_ausgabe_attribute_definieren.png|thumb|400px]]

Um auszuwählen, welche Felder in der BE Listenansicht angezeigt werden sollen, klickt man einfach auf das entsprechende Icon rechts:

* '''Add all''' fügt alle Felder auf einen Rutsch hinzu. Man kann auch '''Neu''' wählen und die Felder einzeln hinzufügen, aber mit '''Add all''' gehts am schnellsten.
* Die Frage, ob alle Attribute hinzugefügt werden sollen("''Add all attributes to render setting''"), wird mit '''Weiter''' bestätigt.
* Nun werden alle Attribute aufgelistet, die im vorangegangenen Schritt erfasst worden sind.

Über das übliche 'Auge' werden nur die Attribute sichtbar gemacht, die in der Backend-Liste angezeigt werden sollen.
Für dieses Tutorial wählen wir : '''Titel''', '''Interpret''', '''Land''' und '''Jahr'''.

(( alter Screen, wird ersetzt ))
<div style="clear: both"></div>

</div>

==MM-Funktion: Eingabemaske (fka Paletteneinstellungen)==

[[File:icons_paletteneinstellungen.png|left|32px]]

Hier legt man fest, wo und wie im BE die Daten zur Musicbox erfasst werden sollen.

===BE-Liste===
[[File:mm_paletten_BE_liste.png|thumb|400px]]
Nach Klick auf '''Neue Eingabemaske''' öffnet sich ein [[MetaModels_Backend:_Eingabemaske|Erfassungsformular]]. Hier die Werte eingeben, wie nebenan abgebildet:
* Name: '''BE Erfassung'''
* Option '''Als Standard benutzen'''
* Panel-Layout: Es stehen 4 Werte ('''filter''', '''sort''', '''search''' und '''limit''') zur Verfügung. Diese können auch über das Icon rechts abgerufen werden.
**Werden hier mehrere Werte eingegeben, so sind diese entweder durch Komma (,) oder durch Semikolon (;) voneinander zu trennen - nur mit Leerzeichen getrennte Werte werden ignoriert.
**Komma => Ausgabe in der gleichen Zeile wie der vorhergehende Wert
**Semikolon => Ausgabe in neuer Zeile.
* Integration: '''Als Einzeltabelle'''
* Sortiermodus: '''2 Datensätze nach wählbarem Feld sortiert darstellen''' (Wichtig: Sowohl dieser Wert als auch '''sort''' im '''Panel-Layout''' müssen definiert sein, ansonsten erscheint die Sortier-Funktion nicht.
* Sortierung: Auf- oder Absteigend... wie es dir gefällt
* Backend-Bereich: '''Inhalte''' (oder wo soll es in der Backend-Navigation eingesetzt werden)
* Backend-Icon: Auf Wunsch kann hier ein eigenes Icon gesetzt werden
* Backend-Beschreibung: wie abgebildet

===Anmerkung===
Die Option '''Sortierung''' ist beim erstmaligen Bearbeiten der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s (hier: Inhalte) die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.

Nun wurde eine Palette namens '''BE Erfassung''' erstellt. Im Folgenden wird nun das Erfassungs-Formular ein wenig gestaltet.

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<div style="clear: both"></div>

===BE-Formular===
[[File:mm_paletten_BE_formular.png|thumb|400px]]

Man fügt nun alle Attribute zur Palette hinzu, indem man auf das Icon rechts (''Die Einstellungen der Palette ID xx bearbeiten'') klickt.
* '''Alle hinzufügen''' wählen und alle nun folgenden Screens bestätigen.
* Man erhält so eine Liste aller Attribute, die man einzeln bearbeiten kann.
* Auf Wunsch kan man hier auch die Reihenfolge umstellen und so bestimmen, wie die Daten erfasst werden sollen.
* Angefangen wird mit dem ersten Eintrag '''Titel [text]'''
<div style="clear: both"></div>

[[File:mm_paletten_BE_formular2.png|thumb|400px]]

Folgendes Beispiel zeigt, was man bei der Erfassung des Attributs '''Titel''' alles einstellen kann.<br>
Ein Klick auf das Editier-Icon zeigt die wichtigsten Einstellungen:
* Backend-Class: Damit kann man das Formular bzw. die Erfassungfelder etwas gestalten. 5 Werte stehen zur Verfügung: '''w50''', '''clr''', '''long''', '''wizard''' und '''m12'''
* Pflichtfeld: Durch Anklicken legt man fest, ob auf diesem Feld eine Inhaltsprüfung stattfinden soll. Die Felder werden mit einem roten Asterisk gekennzeichnet.
* Filterbar, Durchsuchbar, Sortierbar: Mit diesen Optionen kann man die BE-Liste etwas organisieren. Praktisch wenn man mehrere Dutzend/Hunderte von Datensätze erfasst hat.
<div style="clear: both"></div>

==MM-Funktion: Zugriffsrechte definieren==

[[File:icons_ansichtseinstellungen.png|left|32px]]

Hier legt man fest, wer im Backend auf die Daten von MetaModel zugreifen und diese editieren darf.

[[File:mm_neues_metamodel_ansichtseinstellungen.png|730px]]

Damit die Benutzer den MM auch sehen können, muß in den Gruppen-/Benutzerrechten auch noch dieser MM freigeschaltet werden. Den MM findet man unter 'Erlaubte Module' > 'Backend Module'. Je nachdem ob man den MM einzeln oder Untergeordnet anzeigen lässt dann an der jeweiligen Stelle.

=Die Daten erfassen=

[[File:mm_backend_erfassen.png|thumb|600px]]

Und so sieht's aus:<br>Nun wird in der linken Navigationsübersicht "Backend-Module" ein neuer Eintrag angezeigt und man kann mit der Erfassung der Musikstücke beginnen.

* Mit Klick auf '''MyMusik''' gelangt man auf die BE Listenansicht. Diese ist noch leer
* Mit Klick auf '''Neuer Datensatz'''. öffnet sich ein Formular, mit dem sich nun der erste Datensatz erfassen lässt
* Die gewünschten Werte eingeben und mit '''Speichern und Schliessen''' bestätigen
* Nun erscheint der erste Eintrag in der BE Listenansicht
* Diesen Vorgang wiederholen, bis alle Datensätze erfasst wurden
* Über der BE Listenansicht stehen nun die Panel-Layout Funktionen '''Suchen''', '''Sortieren''', '''Filtern''' und '''Anzeigen''' zur Verfügung

<div style="clear: both"></div>

[[MetaModels_Beispielprojekt|Zurück zur Beispiel-Übersicht]] | [[MetaModels_Beispiel_2|Weiter zum Beispiel 2: Erstellung der Frontend-Ansicht]]

Installation in Unterverzeichnis

2013-04-15T11:06:33Z

MacKP: /* Aufruf Backend-Seiten */

{{AppliesTo
|Version=ab Version 2.9
|Ext1=FolderURL}}

[[Category:Installation und Updates]]

=Ausgangssituation=
Contao soll auf einem Server in einem eigenen Unterverzeichnis installiert werden. Dies kann aus verschiedenen Gründen erforderlich sein, beispielsweise:
# um das Rootverzeichnis sauber und übersichtlich zu halten
# weil mehrere Sites aus einem Rootverzeichnis zu hosten sind
# weil parallel zu Contao auch andere Applikationen gespeichert werden sollen
# weil neben den dynamischen Seiten von Contao auch statische Seiten gehostet werden
# usw.

=Das Ziel=
Unter den unten beschriebenen Umgebungsbedingungen soll folgendes umgesetzt werden (alle Pfade sind nur Beispiele)
# Durch Aufruf von "http://www.meinedomain.de/" oder bei lokaler Installation "http://localhost/" soll die index.php in "www/cms/" aufgerufen werden
# Der Aufruf der Contao Seiten soll durch z.B. "http://www.meinedomain.de/index.html" oder "http://www.meinedomain.de/unterseiten/meine_unterseite.html" mit leicht lesbaren und suchmaschinenfreundlichen URLs erfolgen. Zu diesem Zweck ist auch FolderURL installiert.
# Die Navigation innerhalb der mit Contao realisierten Webiste soll ohne den Pfadteil .../cms/.. erfolgen. Also NICHT: "http://www.meinedomain.de/cms/unterseite/meine_unterseite.html"
# Wird eine statische Website im www-Rooverzeichnis z.B. "http://www.meinedomain.de/gibts_in_echt.html" aufgerufen, so soll diese auch angezeigt werden.
# Wird eine andere Seite oder Anwendung in einem außerhalb von Contao real existierenden Unterverzeichnis aufgerufen z.B. "http://www.meinedomain.de/onlinegame/" soll auf dieses geroutet werden.

=Die technischen Umgebungsbedingungen=
Diese Anleitung bezieht sich auf die folgenden beispielhaften Umgebungsbedingungen:
# Der Server (oder die lokale Installation) hat ein Wurzelverzeichnis, z.B. "www". Dieses wird nach Eingabe der domain "http://www.meinedomain.de/" oder bei lokaler Installation "http://localhost/" aufgerufen.
# Contao ist in ein Unterverzeichnis dieses "www" Wurzelverzeichnisses kopiert, z.B: "cms". Der Pfad zu Contao lautet nun www/cms/. In diesem liegen nun die Ordner contao, plugins, system, templates, tl_files, typolight sowie u.a. die Datei .htaccess.default und die index.php
# Die Erweiterung "FolderURL" ist in Contao installiert
# Im Wurzelverzeichnis "www" befinden sich weitere Unterordner und/oder html/php files, die andere Anwendungen bzw. statische Webseiten beinhalten, die bei Bedarf erreichbar sein müssen.
Die Domainnamen, Pfade und Seiten sind natürlich nur Beispiele und müssen an die jeweilige Installation angepasst werden!

=Die Umsetzung=
Grundsätzlich gibt es mehrere Lösungsvarianten. Die hier beschriebene Variante erfolgt unter Nutzung der Apache .htaccess Dateien. Diese können entweder offline mit einem beliebigen Editor erstellt/bearbeitet und dann per FTP auf den Server hochgeladen werden oder per FTP-fähigem Editor direkt online editiert werden (z.B. mit Notepad++ http://notepad-plus-plus.org/ - gibt es auch als portable Version unter http://portableapps.com/ bzw. http://portableapps.com/de )

==Schritt 1 - Installation im Unterverzeichnis==
Contao wurde in ein Unterverzeichnis des Wurzelverzeichnisses am Server kopiert.
Beispiel:
Wurzelverzeichnis Server lautet "www"
Installationsverzeichnis Contao lautet "cms". Der Pfad zu Contao lautet nun www/cms/.
(siehe Pkt 2. technische Umgebungsbedingungen)

==Schritt 2 - Anpassen der .htaccess im WURZELVERZEICHNIS==
Als erstes ist die .htaccess im Wurzelverzeichnis anzupassen:
<source lang="apache">
RewriteEngine On
RewriteBase /

# in der folgenden Zeile den Text "cms"entsprechend dem gewählten Unterverzeichnis für Contao ggf. ändern
RewriteCond %{REQUEST_URI} !^cms/.*

# alternativ zur letzten Zeile oberhalb geht auch:
# RewriteCond %{REQUEST_URI} !^(cms|verzeichnis1|verzeichnis2)/.*
# wenn einige Verzeichnisse real existieren und NICHT von contao behandelt werden sollen!
# mehrere Verzeichnisse sind einfach getrennt durch "|" nacheinander aufzulisten

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d [OR]
RewriteCond %{REQUEST_URI} ^/$

# in der folgenden Zeile ebenfalls den Text "cms" entsprechend dem gewählten Unterverzeichnis für Contao ändern
RewriteRule ^(.*) /cms/$1 [L]

# die folgende Zeile ist nur erforderlich, wenn ALLE Seitenaufrufe mit .html-Endung an Contao gehen sollen
# RewriteRule .*\.html$ index.php [L]
</source>

Erklärung:
Zuerst wird das Umschreiben von URLs aktiviert, wobei als Basis das aktuelle Verzeichnis festgesetzt wird (" RewriteEngine On "
und " RewriteBase / ").

Anschließend werden URLs die direkt auf das Unterverzeichnis "cms" verweisen vom Umschreiben ausgenommen (" RewriteCond %{REQUEST_URI} !^cms/.* "). Das ist auch für mehrere Verzeichnisse möglich, wenn man Inhalte außerhalb von Contao auf der Website hat.

Sofern die in der URL aufgerufenen Verzeichnisse oder Files tatsächlich existieren, findet ebenfalls kein Umschreiben statt (" RewriteCond %{REQUEST_FILENAME} !-f " und " RewriteCond %{REQUEST_FILENAME} !-d [OR] ").

Alle anderen Aufrufe werden um das Unterverzeichnis ergänzt (" RewriteRule ^(.*) /cms/$1 [L] ").

So wird aus http://www.meinedomain.de/index.html die URL http://www.meinedomain.de/cms/index.html - was weder Nutzer noch Suchmaschine zu sehen bekommen!

Zu beachten ist, dass sich im Wurzelverzeichnis keine index.php oder index.html Datei befinden darf. (Achtung auf Reste voheriger Installationen ;-)

==Schritt 3 - Anpassen der .htaccess im INSTALLATIONSVERZEICHNIS==
Im Installationsverzeichnis von Contao kann nun praktisch unverändert die mitgelieferte .htaccess.default verwendet werden (natürlich muss die auf .htaccess umbenannt werden. Also das ".default" raus aus dem Dateinamen!
Hier die Beispielversion:
<source lang="apache">
##
# Contao Open Source CMS
# Copyright (C) 2005-2011 Leo Feyer
#
# Formerly known as TYPOlight Open Source CMS.
#
# This program is free software: you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation, either
# version 3 of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this program. If not, please visit the Free
# Software Foundation website at <http://www.gnu.org/licenses/>.
#
# PHP version 5
# @copyright Leo Feyer 2005-2011
# @author Leo Feyer <http://www.contao.org>
# @license LGPL
##

##
# Disable ETags
# @see http://developer.yahoo.com/performance/rules.html#etags
##
FileETag None

##
# Prevent access to the Contao template files
##
<FilesMatch "\.(tpl|html5|xhtml)$">
Order allow,deny
Deny from all
</FilesMatch>

<IfModule mod_mime.c>

##
# Serve the correct content type for .htc files (CSS3 PIE)
# @see http://css3pie.com/documentation/known-issues/#content-type
##
AddType text/x-component .htc

</IfModule>

<IfModule mod_deflate.c>

##
# Use mod_deflate to compress JavaScript, CSS, XML, HTML and PHP files.
# @see http://developer.yahoo.com/performance/rules.html#gzip
##
<FilesMatch "\.(css|js|xml|html?|php)$">
SetOutputFilter DEFLATE
</FilesMatch>

</IfModule>

<IfModule mod_headers.c>

##
# Disable ETags
# @see http://developer.yahoo.com/performance/rules.html#etags
##
Header unset ETag

##
# Add a Vary Accept-Encoding header for the compressed resources. If you
# modify the file types above, make sure to change them here accordingly.
# @see http://developer.yahoo.com/performance/rules.html#gzip
##
<FilesMatch "\.(js|css|xml|gz)$">
Header append Vary Accept-Encoding
</FilesMatch>

</IfModule>

<IfModule mod_expires.c>

##
# Activate the module
##
ExpiresActive On

##
# Specify an expiration 30 days in the future for images, JavaScripts and
# CSS files. Edit or remove the lines to set up your own expiration logic.
# @see http://developer.yahoo.com/performance/rules.html#expires
##
ExpiresByType image/png A2592000
ExpiresByType image/gif A2592000
ExpiresByType image/jpg A2592000
ExpiresByType image/jpeg A2592000
ExpiresByType text/javascript A2592000
ExpiresByType application/x-javascript A2592000
ExpiresByType application/javascript A2592000
ExpiresByType text/css A2592000
ExpiresByType image/x-icon A2592000

</IfModule>

<IfModule mod_rewrite.c>

##
# Activate the module
##
RewriteEngine On

##
# Set the RewriteBase if your Contao installation is in a subdirectoy and
# the rewrite rules are not working properly. Usage examples:
#
# RewriteBase /contao-2.9.0
# RewriteBase /path/to/contao
#
# Uncomment the following line to set the RewriteBase.
##
RewriteBase /

##
# Contao usually does not pass absolute URLs via GET, therefore the
# following rules block all requests that try to pass a URL or the /etc/
# directory as parameter (malicious requests).
##
RewriteCond %{REQUEST_URI} (ftp|https?):|/etc/ [NC,OR]
RewriteCond %{QUERY_STRING} (ftp|https?):|/etc/ [NC]
RewriteRule .* - [F,L]

##
# Uncomment the following lines and replace "domain.com" with your domain
# name to redirect requests without "www" to the correct domain.
##
#RewriteCond %{HTTP_HOST} ^domain\.com [NC]
#RewriteRule (.*) http://www.domain.com/$1 [R=301,L]

##
# If you cannot use mod_deflate, uncomment the following lines to load a
# compressed .gz version of the bigger Contao JavaScript and CSS files.
##
#AddEncoding gzip .gz
#<FilesMatch "\.js\.gz$">
# AddType "text/javascript" .gz
#</FilesMatch>
#<FilesMatch "\.css\.gz$">
# AddType "text/css" .gz
#</FilesMatch>
#RewriteCond %{HTTP:Accept-encoding} gzip
#RewriteCond %{REQUEST_FILENAME} \.(js|css)$
#RewriteCond %{REQUEST_FILENAME}.gz -f
#RewriteRule ^(.*)$ $1.gz [QSA,L]

##
# Do not rewrite requests for static files or folders such as style sheets,
# images, movies or text documents.
##
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

##
# By default, Contao adds ".html" to the generated URLs to simulate static
# HTML documents. If you change the URL suffix in the back end settings, make
# sure to change it here accordingly!
#
# RewriteRule .*\.html$ index.php [L] # URL suffix .html
# RewriteRule .* index.php [L] # No URL suffix
# RewriteRule .*\.txt$ index.php [L] # URL suffix .txt
#
# If you are using mod_cache, it is recommended to use the RewriteRule below,
# which adds the query string to the internal URL:
#
# RewriteRule (.*\.html)$ index.php/$1 [L]
#
# Note that not all environments support mod_rewrite and mod_cache.
##
# RewriteRule .*\.html$ index.php [L]
# Rewrite TYPOlight URLs

# mit den folgenden zwei Zeilen sollte es immer klappen, notwendig ist im Prinzip
# nur jeweils eine davon, siehe Erklärung weiter oben
RewriteRule .*$ index.php [L]
RewriteRule (.*\.html)$ index.php/$1 [L]

</IfModule>
</source>

Zu beachten ist:
- die RewriteBase der .htaccess im Installationsverzeichnis darf KEIN Unterverzeichnis beinhalten, sondern lautet: "RewriteBase /" . Die Umleitung auf den Unterordner "cms" wurde ja schon von der .htaccess im Wurzelverzeichnis übernommen!
- die RewriteRule am Ende der .htaccess ist auf zwei Regeln gestellt
# "RewriteRule .*$ index.php [L]" - dadurch werden auch Dateinamen gültig aufgerufen, wenn der User das abschließende .html vergisst oder den Dateinamen irrtümlich als Pfad eingibt,
# " RewriteRule (.*\.html)$ index.php/$1 [L]" - falls mod_cache verwendet wird, sonst kann es zu merkwürdigem Verhalten kommen.

(Anm.: eine Umschreibung, dass bei Eingabe der Endung .htm (statt .html) auch richtig umgeschrieben wird, wird noch gesucht)

==Schritt 4 - Anpassen im Contao Backend==
Im Contao Backend ist der Installationspfad unter Einstellungen > Globale Einstellungen > Relativer Pfad zum Contao-Verzeichnis LEER zu lassen (weil diese Aufgabe von der .htaccess im Wurzelverzeichnis übernommen wird).

Alternativ kann man das auch in der localconfig.php im Unterverzeichnis system von Contao manuell einstellen.
Pfad/Datei gemäß Beispiel also: www/cms/system/localconfig.php
Wobei die Zeile zur Einstellung des Websitepfades leer sein muss

<source lang="php">$GLOBALS['TL_CONFIG']['websitePath'] = '';</source>

Eine manuelle Änderung kann nach einem Update oder dem Verschieben der Installation erforderlich sein, wenn sich das Contao-BE nicht aufrufen lässt. Zudem stellt Contao bei Neuinstallation den Pfad automatisch auf das Unterverzeichnis ein, was in diesem Fall aber nicht erforderlich ist, sondern zu einem Fehler führt.

==Schritt 5 - Anpassen von Verzeichnissen außerhalb Contao==
Sollen Dokumente in Verzeichnissen außerhalb von Contao ohne Einschränkungen aufgerufen werden können, so muss man im jeweiligen Unterverzeichnis (unterhalb des Wurzelverzeichnisses) eine eigene .htaccess Datei anlegen. Diese muss nur die Zeile
<source lang="apache">
RewriteEngine Off
</source>
beinhalten. Dadurch kann auf alle *.htm, *.html und *.php-Seiten in diesem Unterverzeichnis zugegriffen werden. Alternativ kann diese .htaccess auch eigene Regeln beinhalten.

Sofern diese Verzeichnisse aber in der .htaccess im Wurzelverzeichnis wie beschrieben angegeben worden sind, ist dies nicht zwingend erforderlich.

=Ergebnis: Aufruf der Seiten=
==Aufruf Frontend-Seiten==
Folgendes sollte nun funktionieren (an Hand der Beispielvorgaben):

Anmerkungen
Die Datei "gibt_es.html" (bzw. *.htm oder *.php) bezeichnet eine physikalisch(?) existente Datei.<br />
Der Folder "ausserhalb_von_contao" bezeichnet einen physikalisch(?) existenten Ordner, der sich NICHT im Contao Installationsverzeichnis befindet und auch nicht durch Contao bzw. FolderURL erzeugt wird.<br />
Die Datei "sonst_eine_cmsseite" bezeichnet eine Seite, die durch Contao bereitgestellt wird.<br />
Der Folder "cmsunterordner" bezeichnet einen "virtuellen" Ordner, der durch Contao bzw. FolderURL erzeugt wird.

'''Aufrufe an Contao'''
*Aufruf per "http://www.meinedomain.de/index.html" => geht ok an contao
*Aufruf per "http://www.meinedomain.de/sonst_eine_cmsseite.html" => geht ok an contao
*Aufruf per "http://www.meinedomain.de/sonst_eine_cmsseite" => geht ok an contao wie "http://meinedomain.de/sonst_eine_seite.html
*Aufruf per "http://www.meinedomain.de/sonst_eine_cmsseite/" => geht ok an contao wie "http://meinedomain.de/sonst_eine_seite.html
*Aufruf per "http://www.meinedomain.de/cmsunterordner/sonst_eine_cmsseite.html" => geht ok an contao
*Contao verlinkt die Seiten beim Rendern richtig ohne das .../cms/.. (Installationsverzeichnis) dazwischen

'''Aufrufe außerhalb von Contao'''
*Aufruf von "http://www.meinedomain.de/gibt_es.htm" funktioniert, ruft die real bestehende *.htm Seite im Wurzelverzeichnis auf
*Aufruf von "http://www.meinedomain.de/gibt_es.html" funktioniert, ruft die real bestehende *.html Seite im Wurzelverzeichnis auf
*Aufruf von "http://www.meinedomain.de/ausserhalb_von_contao/gibt_es.php" funktioniert, ruft die real bestehende *.php Seite im Wurzelverzeichnis auf
*Aufruf von "http://www.meinedomain.de/ausserhalb_von_contao/" funktioniert und öffnet die default html od. php-Seite (index.html, index.htm, index.php) in diesem Unterordner (parallel zu Contao)
*Aufruf von "http://www.meinedomain.de/ausserhalb_von_contao/gibt_es.htm" oder "http://meinedomain.de/ausserhalb_von_contao/gibt_es.html" oder "http://meinedomain.de/ausserhalb_von_contao/gibt_es.php" funktionieren und öffnen die jeweiligen Seiten
* für von anderen Applikationen bereitgestellten Seiten in eigenen Unterverzeichnissen unter dem Wurzelverzeichnis und parallell zu Contao sind im jeweiligen Verzeichnis zumeist eigene .htaccess Dateien erforderlich

Sofern die aufgerufenen Seiten ausserhalb von Contao nicht bestehen, bzw. keine eigene Applikation dahintersteht
* erscheint die in Contao für nichtexistente Seiten eingestellte Fehlermeldung/-seite (404)
* ausgenommen die .htaccess im Ordner der aufgerufenen Seite bestimmt ein anderes Verhalten (z.B. mit RewriteEngine Off)

==Aufruf Backend-Seiten==
Das Contao Backend kann nun entweder über
http://www.meinedomain.de/contao/
oder über
http://www.meinedomain.de/cms/contao
erfolgen.

Cave:
Wenn man schon mal im Backend angemeldet war, dann kann es sein, das man immer einen Umleitungsfehler bekommt. Einmal die Cookies von dieser Domain löschen und das Problem ist beseitigt.

Bearbeiten von Catalog und Formular vergibt Mitglieder-Gruppenzuweisung

2012-07-20T09:16:57Z

MacKP:

== '''Mitgliedergruppen Vergabe per Formular und Katalog''' ==

{{Anmerkung|Die Mitgliedergruppen Funktion in Contao ist wirklich ein feine Sache. Wenn man sie noch flexibler gestalten könnte,
würden man noch mehr nette Features umsetzen können.

Beispiel:
''Ein neuer User bekommt die Gruppe "Neuling" und "Mitglied" <br>
Alle Neulinge sehen speziell für sie eingerichtete Werbeinfos/Funktion/Anmelde-infos.<br>
Zudem haben Neulinge nicht gleich vollen Zugang.

Meldet er sich für einen Newsletter oder bewirbt sich über ein Formular, oder erstellen sein eigenes Karteprofil über den Katalog, so kann er die Gruppe "vip" erlangen und verliert den Status "neuling".<br>
Dadurch verändert sich für ihn die Website und die Zugangsberechtigung.<br><br>

Ein anderer User registriert sich als "Partner" und bekommt erweiterte Berechtigungen,<br>
soll aber auch seinen Account umwandeln können zu ein Normales Mitglied.<br><br>

Ein Käufer soll nach Teilnahme an einem Gewinnspiel besondere Produkte sehen können......''

<br><br>
Um diese Vielfalt nutzen zu können gibt es hier ein kleines Script das über einen Hook gestartet wird.}}

{{msgInfo|Bitte keine Experimente auf produktiven Plattformen. Immer brav im Sandkasten testen. Niemand übernimmt die Garantie für etwaige Schäden}}
{{msgInfo|Dieses Script wurde getestet mit Contao 2.11.2 ## efg 1.16.0 stable und catalog 2.0.0 beta2 61}}

== Funktion erstellen ==

'''FORMULAR(GENERATOR) GRUPPENZUWEISUNG'''

Für die Werteübermittlung wird ein verstecktes Feld angelegt mit Namen "'''dex'''" zum hinzufügen einer Gruppe<br>
und(oder) ein Feld mit namen "'''kil'''" zum entfernen einer Gruppe.<br>
Dem versteckten Feld gibt ihr einen echten Wert und einen eigenen Sicherheitscode(Kontrollwert) ein.<br>
Das Script überprüft anhand einer Formel ob der Sicherheitscode gleich dem echten Wert ist.<br>
Der Ausdruck sieht so aus "'''id*cz#####'''"<br>
In das Sternchen kommt die echte ID der Mitgliedergruppe und die Raute bekommt den Sicherheitscode.<br>
Den Code errechnet ihr euch selbst indem ihr die Formel benutzt:<br>
FORMEL zum manuellen codieren ((x * 15) + 344) * 23;<br><br>

'''Beispiel für Gruppe ID 8:''' 8*15=120 +344=464 *23=10672<br>
Unser Wert für HIDDEN Feld ist also "'''id8cz10672'''"<br>
Bei manipulationsversuche wird das Script also nicht ausgeführt.<br>
{{msgWarning|Die Formel MÜSST ihr natürlich noch ändern, sonst ist die Sicherheit für die Katz.}}<br><br>

Würde ich ein Anmeldeformular nun um das HIDDEN Feld "'''dex'''" mit Wert "id8cz10672" erweitern,<br>
so wird der User nach abschicken des Formulars die Gruppenzuweisung mit id 8 bekommen.<br>
Gebe ich dem HIDDEN Feld "'''kil'''" den Wert "id8cz10672" <br>
so wird dem User nach abschicken die Gruppenzuweisung ID 8 entzogen<br>

----

'''CATALOG GRUPPENZUWEISUNG'''

Hier ebenfalls ein HIDDEN Feld anlegen. Bis dato ist im Catalog keine vorhanden, daher folgendes:<br>

Unter '''modules/catalog/templates/'''<br>
befindet sich das catalog_edit.xyz Template das ihr modifiziert oder euch ''erstmal eine Kopie davon anlegt.''<br>
Im Template setzt ihr unter dem hidden REQUEST_TOKEN ein neues Hidden Feld<br>
'''
<input type="hidden" value="id8cz10672" name="dex"/>'''<br>

Das neue Template dann auch im CatalogEdit Modul auswählen.

----

'''Jetzt zum Eigentlichen...'''<br>
unter '''modules/''' legt ihr einen neuen Ordner an zb. "'''eigenefunktionen'''"<br>
Jetzt erstellt darin eine "'''Extrafunktionen.php'''" mit folgedem Inhalt<br>

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

/**
* TYPOlight webCMS
*
* The TYPOlight webCMS is an accessible web content management system that
* specializes in accessibility and generates W3C-compliant HTML code. It
* provides a wide range of functionality to develop professional websites
* including a built-in search engine, form generator, file and user manager,
* CSS engine, multi-language support and many more. For more information and
* additional TYPOlight applications like the TYPOlight MVC Framework please
* visit the project website http://www.typolight.org.
*
* This is not a complete extension. Its only a little Script for group assignment over form submitted and catalog edited
* Script powered by www.mediadistrict.de
* PHP version 5
* @copyright MediaDistrict e.K.
* @author Marco Groß
* @package
* @license free for all :)
* @filesource this file only
*/
class Extrafunktionen extends Frontend
{
public function gruppenzuweisung($arrPost, $arrForm, $arrFiles){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($arrPost["dex"]){// muss Hiddenfeld haben
$inhalt = $arrPost["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($arrPost["kil"]){// muss Hiddenfeld haben
$inhalt = $arrPost["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}

public function gruppenzuweisungcat(){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($_REQUEST["dex"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($_REQUEST["kil"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}
}
</source>

HINWEIS: Bei der eigenen Funktion darf es in der PHP kein Close Tag geben. Das "?>" darf hier am Ende nicht stehen.<br>

'''Kurz zur Erläuterung'''<br>
Die "gruppenzuweisung" Funktion ist für das abschicken von Formulardaten<br>
Die "gruppenzuweisungcat" Funktion ist eine seperate für das abschicken von Katalog(item)daten, da es von der <br>ContaoCore Routine nicht erfasst wird.<br><br>

== Funktion starten ==

Zum Schluß müssen wir nur noch festlegen wann und wo wir diese Funktion abfrufen möchten.<br><br>

Im Ordner '''system/config/'''<br>
die Datei '''dcaconfig.php''' bearbeiten und folgendes einsetzen:<br><br>

<source lang="php">
$GLOBALS['TL_HOOKS']['processFormData'][] = array('Extrafunktionen', 'gruppenzuweisung');
//$GLOBALS['TL_HOOKS']['catalogFrontendUpdate'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
$GLOBALS['TL_HOOKS']['catalogFrontendInsert'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
</source>

In diesem Beispiel wird unsere Funktion nach dem Abschicken eines Formulars ausgeführt und nachdem der User (im FE) <br>einen neuen KatalogItem erstellt hat. Je nach dem was man erreichen möchte setzt man es hier fest.

Catalog & Formular vergibt Mitglieder-Gruppenzuweisung

2012-07-20T09:16:21Z

MacKP:

Catalog und Formular vergibt Mitglieder-Gruppenzuweisung

2012-07-20T09:16:06Z

MacKP: Die Seite wurde neu angelegt: „{{AppliesTo |Version=ab 2.11 |Ext1=Catalog ab 2.0beta1 }} Category:Extensions Category:Catalog == '''Mitgliedergruppen Vergabe per Formular und Katalog'…“

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

== '''Mitgliedergruppen Vergabe per Formular und Katalog''' ==

{{Anmerkung|Die Mitgliedergruppen Funktion in Contao ist wirklich ein feine Sache. Wenn man sie noch flexibler gestalten könnte,
würden man noch mehr nette Features umsetzen können.

Beispiel:
''Ein neuer User bekommt die Gruppe "Neuling" und "Mitglied" <br>
Alle Neulinge sehen speziell für sie eingerichtete Werbeinfos/Funktion/Anmelde-infos.<br>
Zudem haben Neulinge nicht gleich vollen Zugang.

Meldet er sich für einen Newsletter oder bewirbt sich über ein Formular, oder erstellen sein eigenes Karteprofil über den Katalog, so kann er die Gruppe "vip" erlangen und verliert den Status "neuling".<br>
Dadurch verändert sich für ihn die Website und die Zugangsberechtigung.<br><br>

Ein anderer User registriert sich als "Partner" und bekommt erweiterte Berechtigungen,<br>
soll aber auch seinen Account umwandeln können zu ein Normales Mitglied.<br><br>

Ein Käufer soll nach Teilnahme an einem Gewinnspiel besondere Produkte sehen können......''

<br><br>
Um diese Vielfalt nutzen zu können gibt es hier ein kleines Script das über einen Hook gestartet wird.}}

{{msgInfo|Bitte keine Experimente auf produktiven Plattformen. Immer brav im Sandkasten testen. Niemand übernimmt die Garantie für etwaige Schäden}}
{{msgInfo|Dieses Script wurde getestet mit Contao 2.11.2 ## efg 1.16.0 stable und catalog 2.0.0 beta2 61}}

== Funktion erstellen ==

'''FORMULAR(GENERATOR) GRUPPENZUWEISUNG'''

Für die Werteübermittlung wird ein verstecktes Feld angelegt mit Namen "'''dex'''" zum hinzufügen einer Gruppe<br>
und(oder) ein Feld mit namen "'''kil'''" zum entfernen einer Gruppe.<br>
Dem versteckten Feld gibt ihr einen echten Wert und einen eigenen Sicherheitscode(Kontrollwert) ein.<br>
Das Script überprüft anhand einer Formel ob der Sicherheitscode gleich dem echten Wert ist.<br>
Der Ausdruck sieht so aus "'''id*cz#####'''"<br>
In das Sternchen kommt die echte ID der Mitgliedergruppe und die Raute bekommt den Sicherheitscode.<br>
Den Code errechnet ihr euch selbst indem ihr die Formel benutzt:<br>
FORMEL zum manuellen codieren ((x * 15) + 344) * 23;<br><br>

'''Beispiel für Gruppe ID 8:''' 8*15=120 +344=464 *23=10672<br>
Unser Wert für HIDDEN Feld ist also "'''id8cz10672'''"<br>
Bei manipulationsversuche wird das Script also nicht ausgeführt.<br>
{{msgWarning|Die Formel MÜSST ihr natürlich noch ändern, sonst ist die Sicherheit für die Katz.}}<br><br>

Würde ich ein Anmeldeformular nun um das HIDDEN Feld "'''dex'''" mit Wert "id8cz10672" erweitern,<br>
so wird der User nach abschicken des Formulars die Gruppenzuweisung mit id 8 bekommen.<br>
Gebe ich dem HIDDEN Feld "'''kil'''" den Wert "id8cz10672" <br>
so wird dem User nach abschicken die Gruppenzuweisung ID 8 entzogen<br>

----

'''CATALOG GRUPPENZUWEISUNG'''

Hier ebenfalls ein HIDDEN Feld anlegen. Bis dato ist im Catalog keine vorhanden, daher folgendes:<br>

Unter '''modules/catalog/templates/'''<br>
befindet sich das catalog_edit.xyz Template das ihr modifiziert oder euch ''erstmal eine Kopie davon anlegt.''<br>
Im Template setzt ihr unter dem hidden REQUEST_TOKEN ein neues Hidden Feld<br>
'''
<input type="hidden" value="id8cz10672" name="dex"/>'''<br>

Das neue Template dann auch im CatalogEdit Modul auswählen.

----

'''Jetzt zum Eigentlichen...'''<br>
unter '''modules/''' legt ihr einen neuen Ordner an zb. "'''eigenefunktionen'''"<br>
Jetzt erstellt darin eine "'''Extrafunktionen.php'''" mit folgedem Inhalt<br>

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

/**
* TYPOlight webCMS
*
* The TYPOlight webCMS is an accessible web content management system that
* specializes in accessibility and generates W3C-compliant HTML code. It
* provides a wide range of functionality to develop professional websites
* including a built-in search engine, form generator, file and user manager,
* CSS engine, multi-language support and many more. For more information and
* additional TYPOlight applications like the TYPOlight MVC Framework please
* visit the project website http://www.typolight.org.
*
* This is not a complete extension. Its only a little Script for group assignment over form submitted and catalog edited
* Script powered by www.mediadistrict.de
* PHP version 5
* @copyright MediaDistrict e.K.
* @author Marco Groß
* @package
* @license free for all :)
* @filesource this file only
*/
class Extrafunktionen extends Frontend
{
public function gruppenzuweisung($arrPost, $arrForm, $arrFiles){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($arrPost["dex"]){// muss Hiddenfeld haben
$inhalt = $arrPost["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($arrPost["kil"]){// muss Hiddenfeld haben
$inhalt = $arrPost["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}

public function gruppenzuweisungcat(){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($_REQUEST["dex"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($_REQUEST["kil"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}
}
</source>

HINWEIS: Bei der eigenen Funktion darf es in der PHP kein Close Tag geben. Das "?>" darf hier am Ende nicht stehen.<br>

'''Kurz zur Erläuterung'''<br>
Die "gruppenzuweisung" Funktion ist für das abschicken von Formulardaten<br>
Die "gruppenzuweisungcat" Funktion ist eine seperate für das abschicken von Katalog(item)daten, da es von der <br>ContaoCore Routine nicht erfasst wird.<br><br>

== Funktion starten ==

Zum Schluß müssen wir nur noch festlegen wann und wo wir diese Funktion abfrufen möchten.<br><br>

Im Ordner '''system/config/'''<br>
die Datei '''dcaconfig.php''' bearbeiten und folgendes einsetzen:<br><br>

<source lang="php">
$GLOBALS['TL_HOOKS']['processFormData'][] = array('Extrafunktionen', 'gruppenzuweisung');
//$GLOBALS['TL_HOOKS']['catalogFrontendUpdate'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
$GLOBALS['TL_HOOKS']['catalogFrontendInsert'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
</source>

In diesem Beispiel wird unsere Funktion nach dem Abschicken eines Formulars ausgeführt und nachdem der User (im FE) <br>einen neuen KatalogItem erstellt hat. Je nach dem was man erreichen möchte setzt man es hier fest.

Bearbeiten von Catalog und Formular vergibt Mitglieder-Gruppenzuweisung

2012-07-20T09:14:41Z

MacKP: Die Seite wurde neu angelegt: „{{AppliesTo |Version=ab 2.11 |Ext1=Catalog ab 2.0beta1 }} Category:Extensions Category:Catalog == '''Mitgliedergruppen Vergabe per Formular und Katalog'…“

Catalog & Formular vergibt Mitglieder-Gruppenzuweisung

2012-07-20T09:08:49Z

MacKP:

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

== '''Mitgliedergruppen Vergabe per Formular und Katalog''' ==

{{Anmerkung|Die Mitgliedergruppen Funktion in Contao ist wirklich ein feine Sache. Wenn man sie noch flexibler gestalten könnte,
würden man noch mehr nette Features umsetzen können.

Beispiel:
''Ein neuer User bekommt die Gruppe "Neuling" und "Mitglied" <br>
Alle Neulinge sehen speziell für sie eingerichtete Werbeinfos/Funktion/Anmelde-infos.<br>
Zudem haben Neulinge nicht gleich vollen Zugang.

Meldet er sich für einen Newsletter oder bewirbt sich über ein Formular, oder erstellen sein eigenes Karteprofil über den Katalog, so kann er die Gruppe "vip" erlangen und verliert den Status "neuling".<br>
Dadurch verändert sich für ihn die Website und die Zugangsberechtigung.<br><br>

Ein anderer User registriert sich als "Partner" und bekommt erweiterte Berechtigungen,<br>
soll aber auch seinen Account umwandeln können zu ein Normales Mitglied.<br><br>

Ein Käufer soll nach Teilnahme an einem Gewinnspiel besondere Produkte sehen können......''

<br><br>
Um diese Vielfalt nutzen zu können gibt es hier ein kleines Script das über einen Hook gestartet wird.}}

{{msgInfo|Bitte keine Experimente auf produktiven Plattformen. Immer brav im Sandkasten testen. Niemand übernimmt die Garantie für etwaige Schäden}}
{{msgInfo|Dieses Script wurde getestet mit Contao 2.11.2 ## efg 1.16.0 stable und catalog 2.0.0 beta2 61}}

== Funktion erstellen ==

'''FORMULAR(GENERATOR) GRUPPENZUWEISUNG'''

Für die Werteübermittlung wird ein verstecktes Feld angelegt mit Namen "'''dex'''" zum hinzufügen einer Gruppe<br>
und(oder) ein Feld mit namen "'''kil'''" zum entfernen einer Gruppe.<br>
Dem versteckten Feld gibt ihr einen echten Wert und einen eigenen Sicherheitscode(Kontrollwert) ein.<br>
Das Script überprüft anhand einer Formel ob der Sicherheitscode gleich dem echten Wert ist.<br>
Der Ausdruck sieht so aus "'''id*cz#####'''"<br>
In das Sternchen kommt die echte ID der Mitgliedergruppe und die Raute bekommt den Sicherheitscode.<br>
Den Code errechnet ihr euch selbst indem ihr die Formel benutzt:<br>
FORMEL zum manuellen codieren ((x * 15) + 344) * 23;<br><br>

'''Beispiel für Gruppe ID 8:''' 8*15=120 +344=464 *23=10672<br>
Unser Wert für HIDDEN Feld ist also "'''id8cz10672'''"<br>
Bei manipulationsversuche wird das Script also nicht ausgeführt.<br>
{{msgWarning|Die Formel MÜSST ihr natürlich noch ändern, sonst ist die Sicherheit für die Katz.}}<br><br>

Würde ich ein Anmeldeformular nun um das HIDDEN Feld "'''dex'''" mit Wert "id8cz10672" erweitern,<br>
so wird der User nach abschicken des Formulars die Gruppenzuweisung mit id 8 bekommen.<br>
Gebe ich dem HIDDEN Feld "'''kil'''" den Wert "id8cz10672" <br>
so wird dem User nach abschicken die Gruppenzuweisung ID 8 entzogen<br>

----

'''CATALOG GRUPPENZUWEISUNG'''

Hier ebenfalls ein HIDDEN Feld anlegen. Bis dato ist im Catalog keine vorhanden, daher folgendes:<br>

Unter '''modules/catalog/templates/'''<br>
befindet sich das catalog_edit.xyz Template das ihr modifiziert oder euch ''erstmal eine Kopie davon anlegt.''<br>
Im Template setzt ihr unter dem hidden REQUEST_TOKEN ein neues Hidden Feld<br>
'''
<input type="hidden" value="id8cz10672" name="dex"/>'''<br>

Das neue Template dann auch im CatalogEdit Modul auswählen.

----

'''Jetzt zum Eigentlichen...'''<br>
unter '''modules/''' legt ihr einen neuen Ordner an zb. "'''eigenefunktionen'''"<br>
Jetzt erstellt darin eine "'''Extrafunktionen.php'''" mit folgedem Inhalt<br>

<source lang="php">
<?php if (!defined('TL_ROOT')) die('You can not access this file directly!');

/**
* TYPOlight webCMS
*
* The TYPOlight webCMS is an accessible web content management system that
* specializes in accessibility and generates W3C-compliant HTML code. It
* provides a wide range of functionality to develop professional websites
* including a built-in search engine, form generator, file and user manager,
* CSS engine, multi-language support and many more. For more information and
* additional TYPOlight applications like the TYPOlight MVC Framework please
* visit the project website http://www.typolight.org.
*
* This is not a complete extension. Its only a little Script for group assignment over form submitted and catalog edited
* Script powered by www.mediadistrict.de
* PHP version 5
* @copyright MediaDistrict e.K.
* @author Marco Groß
* @package
* @license free for all :)
* @filesource this file only
*/
class Extrafunktionen extends Frontend
{
public function gruppenzuweisung($arrPost, $arrForm, $arrFiles){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($arrPost["dex"]){// muss Hiddenfeld haben
$inhalt = $arrPost["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($arrPost["kil"]){// muss Hiddenfeld haben
$inhalt = $arrPost["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}

public function gruppenzuweisungcat(){

/////////////////////////////////////////// Automatische Gruppenzuweisung BEGINN
$this->import('FrontendUser','user');
$user_id = $this->user->id;
$this->import('FrontendUser', 'Member');
$ok = 0;$okkill = 0;
$addgroup_id = array();$killgroup_id = array();
// Beispiel Code id2&cd8602 = ID 2 ok
// Beispiel Code id2&cd7489 = ID 2 fail
// FORMEL zum manuellen codieren ((x * 15) + 344) * 23;
// FORMEL zum auto decodieren ((x / 23) - 344) / 15;

if ($_REQUEST["dex"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["dex"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$ok = 1;
$addgroup_id[$next] = $idnumber[$next];
}
}
//print_r($codenumber[$next]);

}

if ($_REQUEST["kil"]){// muss Hiddenfeld haben
$inhalt = $_REQUEST["kil"];
$alle = explode("&", $inhalt);
$idnumber = array();
$codenumber = array();
for ($next = 0; $next <= count($alle)-1; $next++){
$zeichen = preg_split('/[id.cz]/', $alle[$next], -1);
$newarray = array();
for ($x = 0; $x <= count($zeichen)-1; $x++){//neuen Index
if($zeichen[$x]!=''){
array_push($newarray, $zeichen[$x]);
}
}

$idnumber[$next] = $newarray[0];
$codenumber[$next] = $newarray[1];
$codenumber[$next] = (($codenumber[$next] / 23) - 344) / 15;// Sicherheitscode dekodieren
if ($codenumber[$next] == floor($codenumber[$next]) && $codenumber[$next] == $idnumber[$next]){// muss ganze Zahl sein und mit ID übereinstimmen
$okkill = 1;
$killgroup_id[$next] = $idnumber[$next];
}
}
}

$memberGroups = $this->Member->groups;
for ($addit = 0; $addit <= count($addgroup_id)-1; $addit++){//neuen Index
// ---------------- neuer Gruppe zuweisen ---------------------------------
if ($ok == 1 && !in_array($addgroup_id[$addit], $this->Member->groups)){//wenn nicht schon vorhanden
$memberGroups[] = $addgroup_id[$addit];//array push

}
}
for ($killit = 0; $killit <= count($killgroup_id)-1; $killit++){//neuen Index
// ---------------- Gruppe entfernen ---------------------------------
$this->import('FrontendUser', 'Member');
if ($okkill == 1 && in_array($killgroup_id[$killit], $this->Member->groups)){//wenn vorhanden
$key = array_search($killgroup_id[$killit], $memberGroups);// gesuchte Element killen
unset($memberGroups[$key]);// Entfernt das gekillte Arrayelement um Index neu aufzubauen
$memberGroups = array_values($memberGroups);// Array mit fortlaufendem Index erzeugen um Lücken zu entfernen
}
}

if ($ok == 1 || $okkill == 1){// Tabelle beschreiben
$group_ids = serialize($memberGroups);
$this->Database->prepare("UPDATE tl_member SET groups = ? WHERE id = ?")->execute($group_ids, $user_id);
}
///////////////////////////////////////// Automatische Gruppenzuweisung ENDE

}
}
</source>

HINWEIS: Bei der eigenen Funktion darf es in der PHP kein Close Tag geben. Das "?>" darf hier am Ende nicht stehen.<br>

'''Kurz zur Erläuterung'''<br>
Die "gruppenzuweisung" Funktion ist für das abschicken von Formulardaten<br>
Die "gruppenzuweisungcat" Funktion ist eine seperate für das abschicken von Katalog(item)daten, da es von der <br>ContaoCore Routine nicht erfasst wird.<br><br>

== Funktion starten ==

Zum Schluß müssen wir nur noch festlegen wann und wo wir diese Funktion abfrufen möchten.<br><br>

Im Ordner '''system/config/'''<br>
die Datei '''dcaconfig.php''' bearbeiten und folgendes einsetzen:<br><br>

<source lang="php">
$GLOBALS['TL_HOOKS']['processFormData'][] = array('Extrafunktionen', 'gruppenzuweisung');
//$GLOBALS['TL_HOOKS']['catalogFrontendUpdate'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
$GLOBALS['TL_HOOKS']['catalogFrontendInsert'][] = array('Extrafunktionen', 'gruppenzuweisungcat');
</source>

In diesem Beispiel wird unsere Funktion nach dem Abschicken eines Formulars ausgeführt und nachdem der User (im FE) <br>einen neuen KatalogItem erstellt hat. Je nach dem was man erreichen möchte setzt man es hier fest.

Catalog mit Frontend-Editing und Workflow erstellen

2011-12-01T17:19:37Z

MacKP: /* Benötigte Erweiterungen */

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

=Kurzbeschreibung=
Hier geht es darum, wie man Items im Frontend erstellen und bearbeiten kann. Anhand eines Immobilienkataloges wird auch noch die Einrichtung eines Workflows vorgestellt. Zum Schluss soll es dem Besucher der Seite noch möglich sein Kontakt zu dem Seitenbetreiber aufzunehmen (mithilfe eines Formulars bei dem Item).
Hier bei dem Beispiel werden exemplarisch zwei Arten von Immobilien angelegt (Haus zum Kaufen und Hotelzimmer).
Bei diesem Beispiel ist die Backend-Ansicht von den Items nicht wirklich wichtig und wurde auch vernachlässigt, da alle Items über das Frontend verwaltet werden.

=Benötigte Erweiterungen=
* catalog
** backend_filterwiz
** backend_tabletree
** DC_DynamicTable
** taxonomy
* catalogitemuseridfield (für den Workflow wichtig, da damit die Items dem User zugewiesen werden)
* catalog_mailer

=Voraussetzungen für das Tutorial=
* wie ein Katalog erstellt wird sollte von anderen Tutorials klar sein und man sollte die Beschreibung der einzelnen Felder gelesen haben.
* Erstellung von Taxonomie
* der Umgang mit Contao sollte bekannt sein
** Seitenstruktur bearbeiten
** Module anlegen
** Templates bearbeiten
** Mitgliederbereich einrichten (für 2 Gruppen:Makler und Makler-Admins)

=Erstellen der Grundlagen im Backend=

==Erstellung von neuen Seiten in der Seitenstruktur==

* Startseite (Hier wird catalogfeatured eingesetzt)
** Immobilien Liste (Filter und Liste der Immobilien)
*** Immobilien Details (die Detailseite von einem Item)
* Geschützer Bereich
** Immobilien Anlegen (Für normale Makler)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten
** Immobilien Anlegen Administration (Für Makler-Admins)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten

[[Datei:cat-fe-wf-sitestructure.png|Cat Sitestructure]]

==Taxonomie (Bedingung)==

Die Taxonomien sind für die Kategorien und für die Gebiete der Items

Man erstellt sich zuerst die Kategorien und die Optionen. Wobei man hier wie bei einem Baum Verschachtelungen vornimmt:

* Immobilien
** Immo Art
*** Haus
**** Miethaus
**** Ferienhaus
**** Haus zum kaufen
*** Hotel
**** Hotelzimmer
** Immo Gebiete
*** Bizerte
*** Jendouba
*** Beja
*** etc.

Das Ergebniss sollte ungefähr so aussehen wie auf diesem Bild:

[[Datei:cat-fe-wf-taxonomy.png|Cat Taxonomy]]

==Erstellen von einem Katalog mit Feldtypen==

===Neuer Katalog===

Zuerst erstellt man mit einem Klick auf Neuer Katalog einen neuen Katalog und stellt den wie folgt ein:
* Name von dem Katalog angeben
* einen Tabellennamen angeben (die Tabelle wird automatisch erzeugt). Bitte '''keine Tabellen mit tl_* anlgegen''', da diese dann von Contao immer als zu löschen vorgemerkt werden beim aktualisieren der Datenbank.
* Alias und Felder veröffentlichen kann erst später angegeben werden, wenn diese Felder vorhanden sind.
* Sprung zur Seite: Angabe der Detailansicht
* Suche - Suchbar -> aktivieren (keine Bedingung angeben)
* Alle weiteren Einstellungen werden erst später vorgenommen.

[[Datei:cat-fe-wf-newcat1.png|Cat erstellen Bild1]]

[[Datei:cat-fe-wf-newcat2.png|Cat erstellen Bild2]]

===Felder definieren für den Katalog Merkzettel===
Es werden folgende Felder angelegt (Einstellungen die nicht vorgenommen werden, sind nicht aufgelistet):

[[Datei:cat-fe-wf-fields1.png|Cat Felder erstellen]]

[[Datei:cat-fe-wf-fields2.png|Cat Neues Feld]]

{| border="1" cellpadding="20" cellspacing="0"
|+ align="bottom" style="color:#e76700;" |''Feldtypen für die Items''
|-
!Bezeichnung
!Spaltenname
!Typ
!Einstellungen
|-
|Titel
|immo_titel
|text
|
* Sichtbar in der Backend-Listen-Ansicht
* Sortierungs-Dropdown aktivieren
** Sortier-Modus -> Gruppieren anhand der ersten zwei Buschstaben und absteigend
** Backend-Suche aktivieren
* Pflichtfeld
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Alias
|immo_alias_auto
|alias
| * Alias-Titel-Feld -> '''Titel'''
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Benutzer ID
|userid
|Frontend-Benutzer
|-
|Art
|immo_art
|Auswahl
|
* Pflichtfeld
* Tabelle für Optionen -> '''tl_taxonomy'''
* Option Spaltenwert -> '''name'''
* Option Sortierspalte -> name
* Sichtbar in der Backend-Listen-Ansicht
* Die Optinsauswahl individualisieren
** Auswahl der Stamm-Einträge -> Immo Art
** Modus für Unter-Auswahl -> ''Zeigen Sie die Kindelemente von ausgewählten Einträgen ausgeklappt an.'''
** Filter des Elternelements -> leer lassen
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Umgebungsbeschreibung
|immo_umgebung
|langtext
|
* HTML erlauben
* Rich Text
* TinyMCE-Editor-Template -> tinyMCE
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bild
|immo_bild
|file
|
* Sichtbar in der Backend-Listen-Ansicht -> aktivieren
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Produktbild
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bildergalerie
|immo_bildergalerie
|file
|
* Mehrfach-Auswahl
* Anordnung nach Dateiname (aufsteigend)
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Veröffentlichen
|immo_veroeffentlichen
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Online
|immo_online
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Hervorheben
|immo_besonders
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Immobilie entfernen
|immo_delete
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|}

====Erklärung====
* Natürlich sind hier noch viel mehr Felder und Feldtypen angelegt. Diese paar sollten aber reichen um das prinzip zu verdeutlichen.
** Jede Art hat da ihre eigenen Felder (z.B. ist die Grundstücksfläche für Hotelzimmer nicht wichtig und wird daher dann später nicht mit ausgegeben)
* Bild und die Galerie sind getrennt, damit später in der Listenansicht ein bestimmtes Bild ausgegeben werden kann.
* Die Checkboxen '''Veröffentlichen''', '''Online''', '''Hervorheben''' und '''Immobilien entfernen''' sind besonders wichtig für die Verwaltung der Immobilien.
** Nur Makler-Admins bekommen später die Möglichekeit Immobilien online zu stellen ('''Online''') und diese auf der Startseite anzuzeiben ('''Hervorheben''')

===die Katalog Einstellungen noch einmal überarbeiten===
Da jetzt die Feldtypen definiert wurden, kann man im Katalog selbst noch weiter Einstellungen vornehmen:
* Alias-Feld -> Alias
* Feld veröffentlichen -> NICHTS '''hier nicht angeben, da die Makler im Frontend sonst ihre Items nicht sehen können!'''
* Meta-Title-Feld -> Titel
* Meta-Beschreibungs-Feld -> Umgebungsbeschreibung
* Zeichenkette des Titels formatieren -> <nowiki>{{immo_titel}} - {{immo_gebiet}} - {{immo_art}}<br />
{{immo_bild::w=100&h=80}}</nowiki>

==Einstellen von ein paar Items (Produkten)==
Nun können ein paar Immobilien erstellt werden. Zu beachten ist: diese Immobilien gehören erst einmal '''keinem''' Mitglied. Erst wenn ein Mitglied das Item bearbeitet und speichert ist es ihm Zugeordnet!

[[Datei:cat-fe-wf-new-item1.png|Cat new item1]]

[[Datei:cat-fe-wf-new-item2.png|Cat new item2]]

==Die nötigen Module==

===Katalog-Filter===
Damit die Benutzer und die Mitglieder das angezeigt bekommen was sie wollen, sollte man mit einem Filter die Immobilien Einschränkbar machen.
Damit auch alle die passende Einstellung haben bei der Weiterleitungsseite muss man dieses Modul 3 mal anlegen und jeweils zur passenden Seite mit der Liste weiterleiten (eins anlegen und kopieren erleichtert einem die arbeit enorm *g*)

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Liste (je nachdem für welche Gruppe der Filter gerade erstellt wird)
* Benützen Sie Filterkonditionen des Listers auf der selben Seite -> aktivieren (dadurch sind nur die Filter aktiv, die auch passende Immobilien beinhalten)
* Filter pro Abschnitt aktivieren
** Gebiet -> Auswahlmenü
** Art -> Auswahlmenü
* Such-Filter
** Suchbox aktivieren -> aktivieren
** Kopfzeile suchen -> Suche (h3)
** Suchfelder
*** Alle Felder die man durchsuchbar haben möchte ankreuzen (z.B. Titel, Gebiet, Art, Umgebungsbeschreibung)
* Filter-Layout -> filter_default

===Katalog-Liste===
Nun muss man mehrere Listenmodule anlegen. Einmal eine Liste für die Besucher. Dort sind alle Immobilien vorhanden, die online sind.
Für die Makler und Makler-Admins muss man nun für jede Art eine passende Liste erstellen.
Bei 5 verschiedenen Arten sind das also 5 Listen für Makler, 5 Listen für Makler-Admins.
Zusammengenommen also 11 Listen. Das ganze kann man sicher auch mittels PHP und MySQL etwas zusammenfassen. Hier geht es jedoch darum, das Prinzip aufzuzeigen und jedem zu ermöglichen so einen Katalog ohne viel Programmierkenntisse anzulegen.

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Suchfelder
*** nach Bedarf anklicken
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung''' Je nach Liste etwas anders:
** Liste für Besucher der Seite: <nowiki>immo_online=1 and immo_freigeben=1 and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items, die online sind, die freigegeben sind und die nicht Entfernt sind (also als solche Markiert)
** Liste für Makler <nowiki>immo_art='136' and immo_delete!='1' AND (userid={{user::id}} OR userid=0)</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt wo die UserID gleich der eigenen oder keiner ist (alle Items von dem Mitglied und Items die noch keinem zugeordnet sind)
** Liste für Makler-Admin <nowiki>immo_art='136' and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt sind an. Hier wird nicht die UserID abgefangen! Dadurch können Makler-Admins alle Immobilien sehen.
** Elemente pro Seite -> 6
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_cataloglist

===Katalog-Leser===
Hiervon gibt es nur ein Modul. Die Makler und Makler-Admins bekommen das Modul Katalog-Edit.
Die Ausgabe der verschiedenen Arten und deren besonderheit regel ich über das Teplate mit einer extra if-Abfrage (lasse also nur die Felder anzeigen, die überhaupt einen Inhalt haben).

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Umgebungsbeschreibung
* Template-Einstellungen
** Katalog-Layout -> catalog_full
** Katalog-Template -> mod_catalogreader

===Katalog-Featured===
Hiermit werden die hervorgehobenen Items auf der Startseite dargestellt.

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung'''
** <nowiki>immo_online=1 and immo_besonders and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online, besonders und nicht Entfernt sind.
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogfeatured

===Katalog-Related===

Hiermit werden ähnliche Immobilien auf der Detailseite einer Immobilie angezeigt. Übereinstimmen muss in diesem Beispiel nur das Gebiet. Bei vielen Items sollte die Liste hier weiter eingeschränkt werden (Sinnvoll wäre zum Beispiel die Art der Immobilie)

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Betroffene Felder, die übereinstimmen müssen -> Gebiet
** Anzahl der Tags die zusammengehöhren müssen -> 0 (macht nur sinn bei mehreren. Dann werden nur Items angezeigt, die zum Beispiel 2 Gleiche Felder haben bei der Angabe von 2)
** '''Bedingung''' -> <nowiki>immo_online=1 and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online und nicht Entfernt sind.
** Anzahl der Einträge -> 5
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogrelated

===Katalog-Edit===
{{Achtung|Hier muss auf das passende Template geachtet werden -> '''catalog_edit.tpl''' sonst kommt eine Fehlermeldung in der Art 'No valid Item ID'}}

Hier sind wieder mehrere Module nötig.

Für Makler in jeder Art eins -> 5

Für Makler-Admins -> 5

(für jede Art, da die sich ja wie oben genannt in den Feldern unterscheiden)

'''Felder die einen Standardwert bekommen dürfen nicht bearbeitet werden können!'''

Außerdem lasse ich das Alias Feld nicht bearbeiten, damit da keine unschönen Aliase generiert werden.

'''Einstellungen für Makler:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Benutzer id [userid:useridfield]''' (Nur dadurch wird die ID des Maklers erfasst. Wird aber nicht im Frontend angezeigt)
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)
** '''Online -> nein'''

'''Einstellungen für Makler-Admins:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Online'''
** '''Hervorheben'''
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)

Mit diesen unterschiedlich eingestellten Katalog-Edit Modulen erreichen wir den Workflow:

Makler können eine Immobilie bearbeiten und neu anlegen. Die Immobilie können Makler aber nicht online stellen oder hervorheben. Beim Bearbeiten wird durch den Standardwert Online=nein die Immobilie offline gestellt.

Makler-Admins können Immobilien bearbeiten und neu anlegen. Die Immobilien können von Makler-Admins online gestellt werden und hervorgehoben werden (diese können ja die Felder sehen und bearbieten, die dafür zuständig sind).

[[Datei:cat-fe-wf-modules.png|Cat Module]]

==Die Module in Artikeln den passenden Seiten zuordnen==
Nun müssen die Module noch auf die jeweils passende Seite gebracht werden:

* Startseite -> Catalog-Featured
** Immobilien Liste -> Catalog-Filter und Catalog Liste (für Besucher!)
*** Immobilien Details -> Catalog-Leser
* '''Geschützer Bereich'''
** Immobilien Anlegen -> mit Navigation für die Unterseiten (Für Makler und Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit
** Immobilien Anlegen Administration -> mit Navigation für Unterseiten (Für Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit

Ich kann nur aus eigener Erfahrung sprechen: Spätestens jetzt ist man froh, wenn man eine Eindeutige Benennung der Module vorgenommen hat! Hier muss man mit vielen ähnlichen Modulen arbeiten und da ist es auf dauer sehr mühselig, wenn man nicht auf den 1. Blick erkennen kann was es ist.
Ich selber benenne die Module daher zum Beispiel so: 'Katalog - Makler - Edit - Haus zum kaufen'
Dadurch ist die automatische Sortierung im Backend außreichend gut. Man sieht was für ein Modul es ist (Katalog) für welche Gruppe es ist (Makler) was genau es machen soll (Edit) und für welchen Bereich es gedacht und eingestellt ist (Haus zum kaufen).

==Templates==
Tutorial zum Anpassen der Templates : [[Catalog_Templates_anpassen|Catalog Templates anpassen]]

== Fehlermeldungen / FAQ ==
=== tinyFrontend.php TinyMCE konfiguration ===
<nowiki>Cannot find rich text editor configuration file "tinyFrontend.php". You can copy system/config/tinyMCE.php to this name </nowiki>

Einfach die tinyMCE.php in /system/config/ kopieren und in tinyFrontend.php umbenennen. Dann kann diese Datei nach Wunsch angepasst werden und ist Vorlage für den WYSIWIG Editor im Frontend-Editing.
----

--[[Benutzer:MacKP|MacKP]] 14:52, 18. Mai 2010 (UTC)

Catalog

2011-11-29T23:22:49Z

MacKP:

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)

=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 der Alias genutzt bei den Links
* 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)

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. 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.

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

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

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

Catalog Templates anpassen

2011-11-21T11:01:04Z

MacKP: /* Wert nur Ausgeben, wenn Mitglied in einer bestimmten Gruppe ist */

Catalog Templates anpassen

2011-11-18T10:47:27Z

MacKP: /* Alle Werte ausgeben und nur einen anpassen und als Bild ausgeben (Taxonomie mit verlinkten Icons) */

Templates bearbeiten

2011-10-17T12:43:41Z

MacKP: /* Links zum Thema */

{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]
Es gibt 2 Möglichkeiten, um in Contao Templates zu bearbeiten.
=Direkt in Contao über das Backend=
Die Template-Sektion ist im Backend unter Layout --> Templates zu finden. Um ein Template zu bearbeiten, klickt man im Main-Bereich auf ''Neues Template''. Im darauffolgend angezeigten Dropdown Feld findet man eine Liste aller z.Z. existierenden Templates (sowohl die des Cores als auch die der Erweiterungen, die man einsetzt).

[[Datei:be_template_1.jpg|Templateauswahl]]

Man sucht sich das Template, das man bearbeiten will, aus dem Dropdown Feld aus und klickt anschliessend auf den Button ''Template erstellen'' (in diesem Fall das Template ''nav_default.tpl'', das für das Menü zuständig ist).

[[Datei:be_template_2.jpg]]

In der Übersicht sieht man nur das gewählte Template. Rechts davon sind 3 Icons zu finden.
* '''Template umbennenen:''' Man kann (muss aber nicht!) das gewählte Template umbenennen.
* '''Template bearbeiten:''' Über diesen Button kann man den Quellcode des Templates bearbeiten
* '''Template löschen:''' Löscht das entsprechende Template

=Mit einem Editor über FTP=
Wer lieber mit einem Editor arbeitet, kann Templates auch manuell bearbeiten. Dazu eignet sich am besten ein Editor, welcher direkt auf dem FTP-Server arbeitet, die Template-Dateien von dort öffnet und auch wieder speichert. Z.B. [http://www.pspad.com/ PsPad], [http://notepad-plus-plus.org/ Notepad++] u.a.
{{Achtung| Niemals [[Contao-Core-Dateien|Core-Dateien]] verändern. Templates, welche man bearbeitet liegen immer im Ordner TL_ROOT/templates/}}

=Mehrere Templates verwenden=
Contao macht nun folgendes: Wenn bei der Modul-Erstellung das Orginal-Template (nav_default.tpl) ausgewählt wurde, schaut das System zuerst nach, ob in /template/ ein modifiziertes nav_default.tpl liegt. Wenn ja, wird dieses verwendet. Wenn nein, wird das Orginal-Template von /system/modules/frontend/templates/ genommen.

Es ist auch möglich, mehrere modifizierte Templates zu erstellen, wenn z.B. mehrere Menü-Module angelegt werden, die unterschiedliche Templates benötigen. Hier ist es wichtig, beim Umbennenen das '''nav_''' zu erhalten. Die Templatenamen könnten z.B. so lauten: nav_custom1.tpl, nav_modify.tpl usw. Wenn man nun das Menü-Modul erstellt, werden bei der Templateauswahl alle Templates aufgelistet, die ein nav_ davor haben.

{{Achtung| Nochmals zur Erinnerung: Alle modifizierten Templates, egal ob im Orginalnamen oder umbenannt, müssen im Ordner /templates/ abgespeichert werden. NIE das Orginaltemplate überschreiben!. Das hat den Vorteil, dass bei Updates die Templates in /templates/ nicht überschrieben werden, die Orginaltemplates (z.B. system/modules/frontend/templates/nav_default.tpl) jedoch schon.}}

=Links zum Thema=
[[Eigene_Templates_trotz_fehlender_Auswahlmöglichkeit|Eigene Templates trotz fehlender Auswahlmöglichkeit]]

[[Template_Variablen_anzeigen|Template Variablen anzeigen]]

Catalog

2011-04-27T13:00:41Z

MacKP: /* Catalog aus dem Entwicklungs-Repository */

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 Dokumantationen in der Kategorie [[:Category:Catalog|Catalog]].

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

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

=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 der Alias genutzt bei den Links
* 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)

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

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

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

==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 brauchst 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)'''

==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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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 Exel nicht direkt so gemacht.

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

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

Catalog

2011-02-27T21:38:30Z

MacKP:

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 Dokumantationen in der Kategorie [[:Category:Catalog|Catalog]].

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

=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 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!).

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!

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

=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 der Alias genutzt bei den Links
* 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)

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

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

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

==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 brauchst 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)'''

==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" 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 bei den "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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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 Exel nicht direkt so gemacht.

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

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

Catalog

2011-02-02T07:35:42Z

MacKP: /* Welche Variablen hat man in einem Template zur Verfügung? */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

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

=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 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!).

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!

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

=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 der Alias genutzt bei den Links
* 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)

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

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

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

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

==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 brauchst 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)'''

==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" 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 bei den "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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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 Exel nicht direkt so gemacht.

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

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

Soll diese Seite wirklich verlassen werden / JavaScript im Backend geht nicht

2011-01-23T18:52:23Z

MacKP: /* Contao ist in einem Unterordner installiert */

[[Category:Fehlersuche]]
Es gibt mehrere Gründe, warum diese Fehlermeldung kommen kann oder warum im Backend das JavaScript nicht richtig funktioniert:
=Contao ist in einem Unterordner installiert=
Contao ist in einem Unterordner installiert und im übergeordneten Ordner ist eine .htaccess aktiv (die .htaccess der betroffenen Contao-Installation ist nicht aktiv)

'''Lösung:'''
"URL Umschreiben" im Contao-Backend einschalten (unter Einstellungen) und die eigene .htaccess im Root-Verzeichnis der Contao-Installation aktivieren indem man die Datei ".htaccess.default" in ".htaccess" umbenennt. Zusätzlich muss in der .htaccess noch die RewriteBase angepasst werden. Dazu öffnet man die .htaccess in einem Editor und sucht nach der Zeile:

<source lang="text">
#RewriteBase /
</source>

Diese ändert man dann in:

<source lang="text">
RewriteBase /unterordner/
</source>

oder (falls man eine subdomain direkt auf den Unterordner zeigen lässt):
<source lang="text">
RewriteBase /
</source>

und speichert die Änderung ab

= Url's umschreiben=
Man hat die Einstellung "URL Umschreiben" im Contao-Backend eingeschaltet aber die .htaccess noch nicht aktiviert und angepasst.

'''Lösung:'''
Die .htaccess aktivieren und die Zeile RewriteBase anpassen (siehe obigen Abschnitt)
=Kompression=
Die .js und .css Kompression funktioniert auf dem Server nicht (ist im Backend unter Einstellungen eingeschaltet und die .htaccess ist aktiv).

'''Lösung:'''
In der .htaccess diese Bereiche entfernen:

<source lang="text">
##
# Compress .js and .css files
##
AddEncoding gzip .gz
AddType "text/javascript" .gz
AddType "text/css" .gz
RewriteCond %{HTTP:Accept-encoding} gzip
RewriteCond %{REQUEST_FILENAME} \.(js|css)$
RewriteCond %{REQUEST_FILENAME}.gz -f
RewriteRule ^(.*)$ $1.gz [L]
</source>

=Angepasstes Backend-Template=
Man hat das Backend-Template be_main.tpl angepasst und nach einem Update funktioniert dieses nicht mehr richtig (aktuell kann dieser Fehler bei einen Update von 2.7.x auf 2.8 passieren).

'''Lösung:'''
Der mootools Aufruf funktioniert nicht mehr im Header. Um diesen Fehler zu beheben, muss der alte mootools-Code entfernt werden und an der Stelle der neue mootools-Code eingefügt werden. Dieser besteht aus folgenden 2 Zeilen:

<source lang="text">
<script type="text/javascript" src="plugins/mootools/mootools-core.js"></script>
<script type="text/javascript" src="plugins/mootools/mootools-more.js"></script>
</source>

--[[Benutzer:MacKP|MacKP]] 10:34, 7. Mär. 2010 (UTC)

Benutzer:MacKP

2011-01-08T17:35:50Z

MacKP:

Nick: MacKP

Real Name: Marc Reimann

Beruf(ung): Webdesigner seit 2005

Firma: [http://www.mediendepot-ruhr.de Mediendepot Ruhr - Agentur für Kommunikation]

Internetseite: [http://www.mediendepot-ruhr.de www.mediendepot-ruhr.de]

Profil im TYPOlight Forum: [http://www.typolight-community.de/member.php?u=23 MacKP]

Interessen:
* (X)HTML/CSS die Möglichkeiten von Semantischem Webdesign
* Barrierefreie Internetseiten
* SEO (Search Engine Optimisation)
* Contao Open Source CMS
* YAML als CSS-Framework

[http://www.amazon.de/registry/wishlist/XN4TIB5T82DC/ref=cm_wl_search_1 Wunschliste bei Amazon (Ich freue mich immer über kleine Spenden *g*)]

Catalog

2010-12-17T23:28:05Z

MacKP: /* Catalog Navigation */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

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

=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 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!).

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!

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

=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 der Alias genutzt bei den Links
* 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)

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

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

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

=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>
Damit bekommt man das komplette Array ausgegeben.

==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 brauchst 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)'''

==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" 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 bei den "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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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 Exel nicht direkt so gemacht.

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

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

Catalog

2010-12-09T21:54:12Z

MacKP: /* Mehrsprachige Filter mit dem Taxonomie Modul */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

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

=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 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!).

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!

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

=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 der Alias genutzt bei den Links
* 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)

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

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

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

===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 Select- oder Tagfield aus dem gewählten Katalog.
* 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.

=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>
Damit bekommt man das komplette Array ausgegeben.

==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 brauchst 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)'''

==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" 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 bei den "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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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 Exel nicht direkt so gemacht.

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

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

Eigene Templates trotz fehlender Auswahlmöglichkeit

2010-11-04T21:12:01Z

MacKP:

{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]

Es gibt den ein oder anderen Fall, wo man gerne verschiedene Templates in Modulen nutzen möchte, aber leider nicht die Auswahl hat im Modul selber.

Da kann man sich mit einem kleinen Trick behelfen.

Man vergibt der Stelle wo man ein extra Template nutzen möchte eine bestimmte CSS Klasse und fragt diese ab. Je nach dem, läd man dann die passende eigene Template Datei.

=Vorgehen '''Möglichkeit 1'''=

# Kopie des Original Templates anlegen (siehe auch [[Templates_bearbeiten|Templates_bearbeiten]])
# Zwei neue Templates anlegen (oder mehr.. wenn man das braucht) die man dann später benutzen möchte:
#* template_1.tpl mit dem Oringinal Code
#* template_2.tpl mit dem geänderten
# Jetzt nimmt man sich das Template was immer geladen wird und bringt dort die If-Abfrage ein, welches Template man nun wirklich laden möchte:

<source lang="php">
<?php
$pos = strpos($this->class, 'klasse_die_man_abfragen_will');
if ($pos === false)
{
include('template_1.tpl');
}
else
{
include('template_2.tpl');
}
?>
</source>

=Vorgehen '''Möglichkeit 2''' (mit nur einer Datei)=

Man kopiert das entsprechende Core-Template in den Ordner '''roots/templates/''' (per FTP oder übers BE) und erzeugt darin folgende Struktur.

<source lang="php">
<?php if (strpos($this->class, 'klasse-die-man-abfragen-will') !== false): ?>
eigenes Template
<?php else: ?>
default Template
<?php endif; ?>
</source>

Wichtig ist eben, das man die Klasse auch richtig vergibt ;-)

'''Möglichkeit 2''' ist mehrfach getestet.

Dann hier noch ein paar Zusatzinfos warum mit strpos gearbeitet wird: [http://php.net/manual/de/function.strpos.php]
Kurz und knapp: mit einem einfachen Vergleich wie $this->class == 'meineklasse' kommt man nur dann klar, wenn nur eine Klasse vergeben wurde. strpos funktioniert aber auch dann, wenn mehr als nur eine Klasse da drinn vorhanden ist.

----

--[[Benutzer:MacKP|MacKP]] 17:36, 29. Sep. 2010 (CEST)

Diskussion:Suckerfishalternative

2010-11-03T19:03:38Z

MacKP:

Der Artikel erscheint mir nicht fundiert genug.

Das Javascript, welches schon immer dafür da war, damit es auch in IEs kleiner gleich IE7 funktioniert (IE7 im Quirks-Mode) wird einfach ohne Hinweis darauf weggelassen. Was folgt ist kein Ersatz für dieses Javascript. Es erweckt den Eindruck, dass mit dieser "Alternative" kein JS nötig ist.

Die altbewährte suckerfish-Regel zum Verstecken der UL-Elemente, welches ursprünglich mittels '''display:none;''' erreicht wurde und zwecks Usability auf '''left:-999em;''' geändert wurde, wird hier mit '''margin-left:-99999px;''' erreicht. Liegt darin irgendein entscheidender Vorteil?

Die wichtige Eigenschaft '''width''' für LI-Elemente fehlt. Kann das sein, dass die im Original wirklich unnötig war? (sieht nach Problemen aus)

Das Menü wird nur in '''main''' präsentiert. Das ist nicht realitätsnah. Meistens werden solche Menüs in den Header platziert. Und auf den meisten Seiten befinden sich auch noch Fußzeile und 2 bis 3 Spalten. Ein großes Problem war immer schon, die aufklappenden Untermenüs auch über allen anderen Inhalten anzuzeigen.

'''span.active''' ist überflüssig '''span''' genügt, da nur die aktiven Punkte innerhalb von SPANs sind. UL und LI brauchen nicht auf display:block; gesetzt zu werden, das sind sie sowieso schon. ul.level_2 li wird auf 100% Breite gesetzt, alle LIs sind default bereits auf 100% Breite. SPANs und As werden doppelt auf display:block; gesetzt (redundant). Die Reihenfolge der Pseudoklassen ist nicht einheitlich. Korrekt wäre focus,hover,active. visited fehlt hier ganz. Dem Menü sollte noch eine Klasse mitgegeben werden, damit nicht alle Menüs davon angesprochen werden.

Das Menü ist lediglich für eine Unterebene ausgelegt.

Gehören die invaliden CSS-Eigenschaften -moz-... und -webkit-... in ein Wiki?

Eine Prüfung in den gängigen Browsern scheint nicht stattgefunden zu haben.

----

Hallo katgirl,
danke für den Artikel :)
Kleine Anmerkung:
CSS Zeile 2 : dort sollte nicht span.active sondern li.active genommen werden (damit die Umrandung so groß ist wie beim normalen hover. sonst ist die zu klein)

Bezüglich invalide CSS-Eigenschaften: ich finde auch sowas gehöhrt in ein Wiki, denn die sind nicht wirklich invalide. Das kann nur ein automatisches Tool nicht verarbeiten... Validatoren sollte man also immer hinterfragen.

Eigene Templates trotz fehlender Auswahlmöglichkeit

2010-10-26T17:24:59Z

MacKP: /* Vorgehen Möglichkeit 1 */

{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]

Es gibt den ein oder anderen Fall, wo man gerne verschiedene Templates in Modulen nutzen möchte, aber leider nicht die Auswahl hat im Modul selber.

Da kann man sich mit einem kleinen Trick behelfen.

Man vergibt der Stelle wo man ein extra Template nutzen möchte eine bestimmte CSS Klasse und fragt diese ab. Je nach dem, läd man dann die passende eigene Template Datei.

=Vorgehen '''Möglichkeit 1'''=

# Kopie des Original Templates anlegen (siehe auch [[Templates_bearbeiten|Templates_bearbeiten]])
# Zwei neue Templates anlegen (oder mehr.. wenn man das braucht) die man dann später benutzen möchte:
#* template_1.tpl mit dem Oringinal Code
#* template_2.tpl mit dem geänderten
# Jetzt nimmt man sich das Template was immer geladen wird und bringt dort die If-Abfrage ein, welches Template man nun wirklich laden möchte:

<source lang="php">
<?php
$pos = strpos($this->class, 'klasse_die_man_abfragen_will');
if ($pos === false)
{
include('template_1.tpl');
}
else
{
include('template_2.tpl');
}
?>
</source>

=Vorgehen '''Möglichkeit 2''' (mit nur einer Datei)=

Man kopiert das entsprechende Core-Template in den Ordner '''roots/templates/''' (per FTP oder übers BE) und erzeugt darin folgende Struktur.

<source lang="php">
<?php if (strpos($this->class, 'klasse-die-man-abfragen-will') !== false): ?>
eigenes Template
<?php else: ?>
default Template
<?php endif; ?>
</source>

Wichtig ist eben, das man die Klasse auch richtig vergibt ;-)

'''Möglichkeit 2''' ist mehrfach getestet.
----

--[[Benutzer:MacKP|MacKP]] 17:36, 29. Sep. 2010 (CEST)

Catalog mit Frontend-Editing und Workflow erstellen

2010-10-15T20:51:37Z

MacKP:

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

=Kurzbeschreibung=
Hier geht es darum, wie man Items im Frontend erstellen und bearbeiten kann. Anhand eines Immobilienkataloges wird auch noch die Einrichtung eines Workflows vorgestellt. Zum Schluss soll es dem Besucher der Seite noch möglich sein Kontakt zu dem Seitenbetreiber aufzunehmen (mithilfe eines Formulars bei dem Item).
Hier bei dem Beispiel werden exemplarisch zwei Arten von Immobilien angelegt (Haus zum Kaufen und Hotelzimmer).
Bei diesem Beispiel ist die Backend-Ansicht von den Items nicht wirklich wichtig und wurde auch vernachlässigt, da alle Items über das Frontend verwaltet werden.

=Benötigte Erweiterungen=
* catalog
** backend_filterwiz
** backend_tabletree
** DC_DynamicTable
** taxonomy
* catalogitemuseridfield (für den Workflow wichtig, da damit die Items dem User zugewiesen werden)
* catalog_mailer (hier gibt es im Moment noch das Problem einer blöden abhängigkeit von catalog_ext. also noch nicht installieren!)

=Voraussetzungen für das Tutorial=
* wie ein Katalog erstellt wird sollte von anderen Tutorials klar sein und man sollte die Beschreibung der einzelnen Felder gelesen haben.
* Erstellung von Taxonomie
* der Umgang mit Contao sollte bekannt sein
** Seitenstruktur bearbeiten
** Module anlegen
** Templates bearbeiten
** Mitgliederbereich einrichten (für 2 Gruppen:Makler und Makler-Admins)

=Erstellen der Grundlagen im Backend=

==Erstellung von neuen Seiten in der Seitenstruktur==

* Startseite (Hier wird catalogfeatured eingesetzt)
** Immobilien Liste (Filter und Liste der Immobilien)
*** Immobilien Details (die Detailseite von einem Item)
* Geschützer Bereich
** Immobilien Anlegen (Für normale Makler)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten
** Immobilien Anlegen Administration (Für Makler-Admins)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten

[[Datei:cat-fe-wf-sitestructure.png|Cat Sitestructure]]

==Taxonomie (Bedingung)==

Die Taxonomien sind für die Kategorien und für die Gebiete der Items

Man erstellt sich zuerst die Kategorien und die Optionen. Wobei man hier wie bei einem Baum Verschachtelungen vornimmt:

* Immobilien
** Immo Art
*** Haus
**** Miethaus
**** Ferienhaus
**** Haus zum kaufen
*** Hotel
**** Hotelzimmer
** Immo Gebiete
*** Bizerte
*** Jendouba
*** Beja
*** etc.

Das Ergebniss sollte ungefähr so aussehen wie auf diesem Bild:

[[Datei:cat-fe-wf-taxonomy.png|Cat Taxonomy]]

==Erstellen von einem Katalog mit Feldtypen==

===Neuer Katalog===

Zuerst erstellt man mit einem Klick auf Neuer Katalog einen neuen Katalog und stellt den wie folgt ein:
* Name von dem Katalog angeben
* einen Tabellennamen angeben (die Tabelle wird automatisch erzeugt). Bitte '''keine Tabellen mit tl_* anlgegen''', da diese dann von Contao immer als zu löschen vorgemerkt werden beim aktualisieren der Datenbank.
* Alias und Felder veröffentlichen kann erst später angegeben werden, wenn diese Felder vorhanden sind.
* Sprung zur Seite: Angabe der Detailansicht
* Suche - Suchbar -> aktivieren (keine Bedingung angeben)
* Alle weiteren Einstellungen werden erst später vorgenommen.

[[Datei:cat-fe-wf-newcat1.png|Cat erstellen Bild1]]

[[Datei:cat-fe-wf-newcat2.png|Cat erstellen Bild2]]

===Felder definieren für den Katalog Merkzettel===
Es werden folgende Felder angelegt (Einstellungen die nicht vorgenommen werden, sind nicht aufgelistet):

[[Datei:cat-fe-wf-fields1.png|Cat Felder erstellen]]

[[Datei:cat-fe-wf-fields2.png|Cat Neues Feld]]

{| border="1" cellpadding="20" cellspacing="0"
|+ align="bottom" style="color:#e76700;" |''Feldtypen für die Items''
|-
!Bezeichnung
!Spaltenname
!Typ
!Einstellungen
|-
|Titel
|immo_titel
|text
|
* Sichtbar in der Backend-Listen-Ansicht
* Sortierungs-Dropdown aktivieren
** Sortier-Modus -> Gruppieren anhand der ersten zwei Buschstaben und absteigend
** Backend-Suche aktivieren
* Pflichtfeld
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Alias
|immo_alias_auto
|alias
| * Alias-Titel-Feld -> '''Titel'''
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Benutzer ID
|userid
|Frontend-Benutzer
|-
|Art
|immo_art
|Auswahl
|
* Pflichtfeld
* Tabelle für Optionen -> '''tl_taxonomy'''
* Option Spaltenwert -> '''name'''
* Option Sortierspalte -> name
* Sichtbar in der Backend-Listen-Ansicht
* Die Optinsauswahl individualisieren
** Auswahl der Stamm-Einträge -> Immo Art
** Modus für Unter-Auswahl -> ''Zeigen Sie die Kindelemente von ausgewählten Einträgen ausgeklappt an.'''
** Filter des Elternelements -> leer lassen
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Umgebungsbeschreibung
|immo_umgebung
|langtext
|
* HTML erlauben
* Rich Text
* TinyMCE-Editor-Template -> tinyMCE
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bild
|immo_bild
|file
|
* Sichtbar in der Backend-Listen-Ansicht -> aktivieren
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Produktbild
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bildergalerie
|immo_bildergalerie
|file
|
* Mehrfach-Auswahl
* Anordnung nach Dateiname (aufsteigend)
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Veröffentlichen
|immo_veroeffentlichen
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Online
|immo_online
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Hervorheben
|immo_besonders
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Immobilie entfernen
|immo_delete
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|}

====Erklärung====
* Natürlich sind hier noch viel mehr Felder und Feldtypen angelegt. Diese paar sollten aber reichen um das prinzip zu verdeutlichen.
** Jede Art hat da ihre eigenen Felder (z.B. ist die Grundstücksfläche für Hotelzimmer nicht wichtig und wird daher dann später nicht mit ausgegeben)
* Bild und die Galerie sind getrennt, damit später in der Listenansicht ein bestimmtes Bild ausgegeben werden kann.
* Die Checkboxen '''Veröffentlichen''', '''Online''', '''Hervorheben''' und '''Immobilien entfernen''' sind besonders wichtig für die Verwaltung der Immobilien.
** Nur Makler-Admins bekommen später die Möglichekeit Immobilien online zu stellen ('''Online''') und diese auf der Startseite anzuzeiben ('''Hervorheben''')

===die Katalog Einstellungen noch einmal überarbeiten===
Da jetzt die Feldtypen definiert wurden, kann man im Katalog selbst noch weiter Einstellungen vornehmen:
* Alias-Feld -> Alias
* Feld veröffentlichen -> NICHTS '''hier nicht angeben, da die Makler im Frontend sonst ihre Items nicht sehen können!'''
* Meta-Title-Feld -> Titel
* Meta-Beschreibungs-Feld -> Umgebungsbeschreibung
* Zeichenkette des Titels formatieren -> <nowiki>{{immo_titel}} - {{immo_gebiet}} - {{immo_art}}<br />
{{immo_bild::w=100&h=80}}</nowiki>

==Einstellen von ein paar Items (Produkten)==
Nun können ein paar Immobilien erstellt werden. Zu beachten ist: diese Immobilien gehören erst einmal '''keinem''' Mitglied. Erst wenn ein Mitglied das Item bearbeitet und speichert ist es ihm Zugeordnet!

[[Datei:cat-fe-wf-new-item1.png|Cat new item1]]

[[Datei:cat-fe-wf-new-item2.png|Cat new item2]]

==Die nötigen Module==

===Katalog-Filter===
Damit die Benutzer und die Mitglieder das angezeigt bekommen was sie wollen, sollte man mit einem Filter die Immobilien Einschränkbar machen.
Damit auch alle die passende Einstellung haben bei der Weiterleitungsseite muss man dieses Modul 3 mal anlegen und jeweils zur passenden Seite mit der Liste weiterleiten (eins anlegen und kopieren erleichtert einem die arbeit enorm *g*)

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Liste (je nachdem für welche Gruppe der Filter gerade erstellt wird)
* Benützen Sie Filterkonditionen des Listers auf der selben Seite -> aktivieren (dadurch sind nur die Filter aktiv, die auch passende Immobilien beinhalten)
* Filter pro Abschnitt aktivieren
** Gebiet -> Auswahlmenü
** Art -> Auswahlmenü
* Such-Filter
** Suchbox aktivieren -> aktivieren
** Kopfzeile suchen -> Suche (h3)
** Suchfelder
*** Alle Felder die man durchsuchbar haben möchte ankreuzen (z.B. Titel, Gebiet, Art, Umgebungsbeschreibung)
* Filter-Layout -> filter_default

===Katalog-Liste===
Nun muss man mehrere Listenmodule anlegen. Einmal eine Liste für die Besucher. Dort sind alle Immobilien vorhanden, die online sind.
Für die Makler und Makler-Admins muss man nun für jede Art eine passende Liste erstellen.
Bei 5 verschiedenen Arten sind das also 5 Listen für Makler, 5 Listen für Makler-Admins.
Zusammengenommen also 11 Listen. Das ganze kann man sicher auch mittels PHP und MySQL etwas zusammenfassen. Hier geht es jedoch darum, das Prinzip aufzuzeigen und jedem zu ermöglichen so einen Katalog ohne viel Programmierkenntisse anzulegen.

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Suchfelder
*** nach Bedarf anklicken
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung''' Je nach Liste etwas anders:
** Liste für Besucher der Seite: <nowiki>immo_online=1 and immo_freigeben=1 and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items, die online sind, die freigegeben sind und die nicht Entfernt sind (also als solche Markiert)
** Liste für Makler <nowiki>immo_art='136' and immo_delete!='1' AND (userid={{user::id}} OR userid=0)</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt wo die UserID gleich der eigenen oder keiner ist (alle Items von dem Mitglied und Items die noch keinem zugeordnet sind)
** Liste für Makler-Admin <nowiki>immo_art='136' and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt sind an. Hier wird nicht die UserID abgefangen! Dadurch können Makler-Admins alle Immobilien sehen.
** Elemente pro Seite -> 6
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_cataloglist

===Katalog-Leser===
Hiervon gibt es nur ein Modul. Die Makler und Makler-Admins bekommen das Modul Katalog-Edit.
Die Ausgabe der verschiedenen Arten und deren besonderheit regel ich über das Teplate mit einer extra if-Abfrage (lasse also nur die Felder anzeigen, die überhaupt einen Inhalt haben).

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Umgebungsbeschreibung
* Template-Einstellungen
** Katalog-Layout -> catalog_full
** Katalog-Template -> mod_catalogreader

===Katalog-Featured===
Hiermit werden die hervorgehobenen Items auf der Startseite dargestellt.

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung'''
** <nowiki>immo_online=1 and immo_besonders and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online, besonders und nicht Entfernt sind.
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogfeatured

===Katalog-Related===

Hiermit werden ähnliche Immobilien auf der Detailseite einer Immobilie angezeigt. Übereinstimmen muss in diesem Beispiel nur das Gebiet. Bei vielen Items sollte die Liste hier weiter eingeschränkt werden (Sinnvoll wäre zum Beispiel die Art der Immobilie)

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Betroffene Felder, die übereinstimmen müssen -> Gebiet
** Anzahl der Tags die zusammengehöhren müssen -> 0 (macht nur sinn bei mehreren. Dann werden nur Items angezeigt, die zum Beispiel 2 Gleiche Felder haben bei der Angabe von 2)
** '''Bedingung''' -> <nowiki>immo_online=1 and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online und nicht Entfernt sind.
** Anzahl der Einträge -> 5
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogrelated

===Katalog-Edit===
{{Achtung|Hier muss auf das passende Template geachtet werden -> '''catalog_edit.tpl''' sonst kommt eine Fehlermeldung in der Art 'No valid Item ID'}}

Hier sind wieder mehrere Module nötig.

Für Makler in jeder Art eins -> 5

Für Makler-Admins -> 5

(für jede Art, da die sich ja wie oben genannt in den Feldern unterscheiden)

'''Felder die einen Standardwert bekommen dürfen nicht bearbeitet werden können!'''

Außerdem lasse ich das Alias Feld nicht bearbeiten, damit da keine unschönen Aliase generiert werden.

'''Einstellungen für Makler:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Benutzer id [userid:useridfield]''' (Nur dadurch wird die ID des Maklers erfasst. Wird aber nicht im Frontend angezeigt)
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)
** '''Online -> nein'''

'''Einstellungen für Makler-Admins:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Online'''
** '''Hervorheben'''
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)

Mit diesen unterschiedlich eingestellten Katalog-Edit Modulen erreichen wir den Workflow:

Makler können eine Immobilie bearbeiten und neu anlegen. Die Immobilie können Makler aber nicht online stellen oder hervorheben. Beim Bearbeiten wird durch den Standardwert Online=nein die Immobilie offline gestellt.

Makler-Admins können Immobilien bearbeiten und neu anlegen. Die Immobilien können von Makler-Admins online gestellt werden und hervorgehoben werden (diese können ja die Felder sehen und bearbieten, die dafür zuständig sind).

[[Datei:cat-fe-wf-modules.png|Cat Module]]

==Die Module in Artikeln den passenden Seiten zuordnen==
Nun müssen die Module noch auf die jeweils passende Seite gebracht werden:

* Startseite -> Catalog-Featured
** Immobilien Liste -> Catalog-Filter und Catalog Liste (für Besucher!)
*** Immobilien Details -> Catalog-Leser
* '''Geschützer Bereich'''
** Immobilien Anlegen -> mit Navigation für die Unterseiten (Für Makler und Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit
** Immobilien Anlegen Administration -> mit Navigation für Unterseiten (Für Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit

Ich kann nur aus eigener Erfahrung sprechen: Spätestens jetzt ist man froh, wenn man eine Eindeutige Benennung der Module vorgenommen hat! Hier muss man mit vielen ähnlichen Modulen arbeiten und da ist es auf dauer sehr mühselig, wenn man nicht auf den 1. Blick erkennen kann was es ist.
Ich selber benenne die Module daher zum Beispiel so: 'Katalog - Makler - Edit - Haus zum kaufen'
Dadurch ist die automatische Sortierung im Backend außreichend gut. Man sieht was für ein Modul es ist (Katalog) für welche Gruppe es ist (Makler) was genau es machen soll (Edit) und für welchen Bereich es gedacht und eingestellt ist (Haus zum kaufen).

==Templates==
Tutorial zum Anpassen der Templates : [[Catalog_Templates_anpassen|Catalog Templates anpassen]]

== Fehlermeldungen / FAQ ==
=== tinyFrontend.php TinyMCE konfiguration ===
<nowiki>Cannot find rich text editor configuration file "tinyFrontend.php". You can copy system/config/tinyMCE.php to this name </nowiki>

Einfach die tinyMCE.php in /system/config/ kopieren und in tinyFrontend.php umbenennen. Dann kann diese Datei nach Wunsch angepasst werden und ist Vorlage für den WYSIWIG Editor im Frontend-Editing.
----

--[[Benutzer:MacKP|MacKP]] 14:52, 18. Mai 2010 (UTC)

Eigene Templates trotz fehlender Auswahlmöglichkeit

2010-09-29T18:36:58Z

MacKP: hat „Templates ohne Auswahl“ nach „Eigene Templates trotz fehlender Auswahlmöglichkeit“ verschoben

Templates ohne Auswahl

2010-09-29T18:36:58Z

MacKP: hat „Templates ohne Auswahl“ nach „Eigene Templates trotz fehlender Auswahlmöglichkeit“ verschoben

#WEITERLEITUNG [[Eigene Templates trotz fehlender Auswahlmöglichkeit]]

Diskussion:Eigene Templates trotz fehlender Auswahlmöglichkeit

2010-09-29T18:36:58Z

MacKP: hat „Diskussion:Templates ohne Auswahl“ nach „Diskussion:Eigene Templates trotz fehlender Auswahlmöglichkeit“ verschoben

Der Titel hat vielleicht zu wenig Aussagekraft. Was hälst du von sowas in der Art?

'''Eigene Templates trotz fehlender Auswahlmöglichkeit'''

Meistens reicht sowas hier, das finde ich etwas übersichtlicher. Das !== ist auch irgendwie logischer.

<?php if (strpos($this->class, 'klasse-die-man-abfragen-will') !== false): ?>
eigenes Template
<?php else: ?>
default Template
<?php endif; ?>

Grüße

Eigene Templates trotz fehlender Auswahlmöglichkeit

2010-09-29T15:36:41Z

MacKP: Die Seite wurde neu angelegt: „{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}} Category: Admin_HOWTOS Es gibt den ein oder anderen Fall, wo man gerne verschiedene Templates in Module…“

News und Kommentare in verschiedenen Layoutbereichen

2010-09-18T18:50:58Z

MacKP:

[[Category:Dev_Snippets]]

{{AppliesTo
|Version=ab 2.9
}}

=Basiert auf:=

root/system/module/news/templates/mod_newsreader.tpl (Contao 2.9.1)

==Kurzbeschreibung:==

Eröffnet die Möglichkeit die Kommentare und das Formular von den News zu trennen und in einem anderen Layoutbereich zu präsentieren, z.B. in der rechten Spalte.

=Ausführliche Beschreibung/Sonstige Infos:=
Hier das mod_newsreader.tpl leicht modifiziert, natürlich nicht im Core, sondern eine Kopie im Ordner roots/templates/

<pre>

<?php if(strpos($this->class, 'comments-only') === false): ?>
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?><?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>
<?php if ($this->headline): ?>

<<?php echo $this->hl; ?>><?php echo $this->headline; ?></<?php echo $this->hl; ?>>
<?php endif; ?>
<?php echo $this->articles; ?>


<p class="back"><a href="<?php echo $this->referer; ?>" title="<?php echo $this->back; ?>"><?php echo $this->back; ?></a></p>

<?php endif; ?>



<?php if(strpos($this->class, 'news-only') === false): ?>

<?php if ($this->allowComments && ($this->comments || !$this->requireLogin)): ?>

<div class="ce_comments block">

<<?php echo $this->hlc; ?>><?php echo $this->addComment; ?></<?php echo $this->hlc; ?>>
<?php foreach ($this->comments as $comment) echo $comment; ?>
<?php echo $this->pagination; ?>
<?php if (!$this->requireLogin): ?>


<div class="form">
<?php if ($this->confirm): ?>

<p class="confirm"><?php echo $this->confirm; ?></p>
<?php else: ?>

<form action="<?php echo $this->action; ?>" id="<?php echo $this->formId; ?>" method="post">
<div class="formbody">
<input type="hidden" name="FORM_SUBMIT" value="<?php echo $this->formId; ?>" />
<div class="widget">
<?php echo $this->fields['name']->generateWithError(); ?> <?php echo $this->fields['name']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['email']->generateWithError(); ?> <?php echo $this->fields['email']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['website']->generateWithError(); ?> <?php echo $this->fields['website']->generateLabel(); ?>
</div>
<?php if (isset($this->fields['captcha'])): ?>
<div class="widget">
<?php echo $this->fields['captcha']->generateWithError(); ?> <label for="ctrl_captcha"><?php echo $this->fields['captcha']->generateQuestion(); ?><span class="mandatory">*</span></label>
</div>
<?php endif; ?>
<div class="widget">
<?php echo $this->fields['comment']->generateWithError(); ?> <label for="ctrl_<?php echo $this->fields['comment']->id; ?>" class="invisible"><?php echo $this->fields['comment']->label; ?></label>
</div>
<div class="submit_container">
<input type="submit" class="submit" value="<?php echo $this->submit; ?>" />
</div>
</div>
</form>
<?php if ($this->hasError): ?>

<script type="text/javascript">
<![CDATA[//><!]]>
</script>
<?php endif; ?>
<?php endif; ?>

</div>

<?php endif; ?>

</div>
<?php endif; ?>
<?php endif; ?>



<?php if(strpos($this->class, 'comments-only') === false): ?>

</div>
<?php endif; ?>

</pre>

Ich habe nur IF-Abfragen mit den entsprechenden ENDIFs eingefügt. Habe einen HTML-Kommentar dazu geschrieben, kann man natürlich entfernen. Vergibt man keine Klassen, funktioniert das Template wie im Original (Contao 2.9.1).

Jetzt noch den Artikel mit dem Newsreader kopieren, einfügen und den neuen auf rechte Spalte einstellen. Jetzt noch den Inhaltselementen dieser Artikel die Klassen news-only und comments-only mitgeben. Alles so, wie in den Screenshots zu sehen ist.

[[Datei:Frontend_News_Kommentare_getrennt.png]][[Datei:Article_News_Newsreader.png]][[Datei:Eingabe_der_Klasse.png]]

Die Funktion einen Kommentar hinzuzufügen funktioniert einwandfrei.

----
Freundlicherweise zur Verfügung gestellt von [http://www.contao-community.de/member.php?72-Andreas Andreas Burg] burgtech [http://andreasburg.de/ (http://andreasburg.de/)]

Datei:Frontend News Kommentare getrennt.png

2010-09-18T18:48:48Z

MacKP: News und die Kommentare in getrennten Bereichen im Frontend

News und die Kommentare in getrennten Bereichen im Frontend

Datei:Eingabe der Klasse.png

2010-09-18T18:47:17Z

MacKP: Eingabe der speziellen Klasse bei News

Eingabe der speziellen Klasse bei News

Datei:Article News Newsreader.png

2010-09-18T18:44:37Z

MacKP: News und Newsreader in der Artikel Ansicht

News und Newsreader in der Artikel Ansicht

News und Kommentare in verschiedenen Layoutbereichen

2010-09-18T18:42:09Z

MacKP: Die Seite wurde neu angelegt: „Category:Dev_Snippets {{AppliesTo |Version=ab 2.9 }} =Basiert auf:= root/system/module/news/templates/mod_newsreader.tpl (Contao 2.9.1) ==Kurzbeschreibung…“

[[Category:Dev_Snippets]]

{{AppliesTo
|Version=ab 2.9
}}

=Basiert auf:=

root/system/module/news/templates/mod_newsreader.tpl (Contao 2.9.1)

==Kurzbeschreibung:==

Eröffnet die Möglichkeit die Kommentare und das Formular von den News zu trennen und in einem anderen Layoutbereich zu präsentieren, z.B. in der rechten Spalte.

=Ausführliche Beschreibung/Sonstige Infos:=
Hier das mod_newsreader.tpl leicht modifiziert, natürlich nicht im Core, sondern eine Kopie im Ordner roots/templates/

<pre>

<?php if(strpos($this->class, 'comments-only') === false): ?>
<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?><?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>
<?php if ($this->headline): ?>

<<?php echo $this->hl; ?>><?php echo $this->headline; ?></<?php echo $this->hl; ?>>
<?php endif; ?>
<?php echo $this->articles; ?>


<p class="back"><a href="<?php echo $this->referer; ?>" title="<?php echo $this->back; ?>"><?php echo $this->back; ?></a></p>

<?php endif; ?>



<?php if(strpos($this->class, 'news-only') === false): ?>

<?php if ($this->allowComments && ($this->comments || !$this->requireLogin)): ?>

<div class="ce_comments block">

<<?php echo $this->hlc; ?>><?php echo $this->addComment; ?></<?php echo $this->hlc; ?>>
<?php foreach ($this->comments as $comment) echo $comment; ?>
<?php echo $this->pagination; ?>
<?php if (!$this->requireLogin): ?>


<div class="form">
<?php if ($this->confirm): ?>

<p class="confirm"><?php echo $this->confirm; ?></p>
<?php else: ?>

<form action="<?php echo $this->action; ?>" id="<?php echo $this->formId; ?>" method="post">
<div class="formbody">
<input type="hidden" name="FORM_SUBMIT" value="<?php echo $this->formId; ?>" />
<div class="widget">
<?php echo $this->fields['name']->generateWithError(); ?> <?php echo $this->fields['name']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['email']->generateWithError(); ?> <?php echo $this->fields['email']->generateLabel(); ?>
</div>
<div class="widget">
<?php echo $this->fields['website']->generateWithError(); ?> <?php echo $this->fields['website']->generateLabel(); ?>
</div>
<?php if (isset($this->fields['captcha'])): ?>
<div class="widget">
<?php echo $this->fields['captcha']->generateWithError(); ?> <label for="ctrl_captcha"><?php echo $this->fields['captcha']->generateQuestion(); ?><span class="mandatory">*</span></label>
</div>
<?php endif; ?>
<div class="widget">
<?php echo $this->fields['comment']->generateWithError(); ?> <label for="ctrl_<?php echo $this->fields['comment']->id; ?>" class="invisible"><?php echo $this->fields['comment']->label; ?></label>
</div>
<div class="submit_container">
<input type="submit" class="submit" value="<?php echo $this->submit; ?>" />
</div>
</div>
</form>
<?php if ($this->hasError): ?>

<script type="text/javascript">
<![CDATA[//><!]]>
</script>
<?php endif; ?>
<?php endif; ?>

</div>

<?php endif; ?>

</div>
<?php endif; ?>
<?php endif; ?>



<?php if(strpos($this->class, 'comments-only') === false): ?>

</div>
<?php endif; ?>

</pre>

Ich habe nur IF-Abfragen mit den entsprechenden ENDIFs eingefügt. Habe einen HTML-Kommentar dazu geschrieben, kann man natürlich entfernen. Vergibt man keine Klassen, funktioniert das Template wie im Original (Contao 2.9.1).

Jetzt noch den Artikel mit dem Newsreader kopieren, einfügen und den neuen auf rechte Spalte einstellen. Jetzt noch den Inhaltselementen dieser Artikel die Klassen news-only und comments-only mitgeben. Alles so, wie in den Screenshots zu sehen ist.

Die Funktion einen Kommentar hinzuzufügen funktioniert einwandfrei.

----
Freundlicherweise zur Verfügung gestellt von [http://www.contao-community.de/member.php?72-Andreas Andreas Burg] burgtech [http://andreasburg.de/ (http://andreasburg.de/)]

ModulNavigation

2010-08-24T10:41:48Z

MacKP: /* Hauptmenü bis Ebene 3 und Ebene 4 im Untermenü */

{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}}
[[Category: Core]]
Das Modul "Navigationsmenü" erzeugt eine strukturierte Ansicht von Links auf eine gewählte Seitenunterstruktur.

=Konfiguration=
'''Abkürzungen:'''

FE = Frontend (die Internetseite aus User Sicht)

BE = Backend (die Administrationsoberfläche)

== Wie erstellt man mit dem Modul Navigationsmenü verschiedene Navigationen? ==
Seit einiger Zeit sind die Module "Navigation Hauptpunkte" und "Navigation Unterpunkte" nicht mehr nötig. In TYPOlight 2.7 werden diese sogar ganz entfernt. Man nutzt nun immer das Modul "Navigationsmenü" mit den folgenden verschiedenen Einstellungsarten:
* Startlevel
* Stoplevel
* Hard Limit
* Geschütze Menüpunkte anzeigen
* Referenzseite festlegen

Was diese Einstellungen bewirken, wird hier an einer Beispielseite gezeigt.

Es wird davon ausgegangen, dass schon ein Seitenlayout, eine Seitenstruktur und verschiedene Module vorhanden sind. Wie man diese macht, kann man in anderen Tutorials lesen oder sehen.

== Der Aufbau der Seite ==
=== Das Frontend oder wie sieht die Seite aus? ===

[[Datei:Internetseite_grundlage.png]]

Die Seite ist in 5 Bereiche unterteilt:
* ganz oben befindet sich der Header mit einer Navigation (meist der "Servicenavigation"),
* darunter ein Navigationspfad (Breadcrumb- oder Brotkrummennavigation),
* links unterhalb der Breadcrumbnavigation ist die Hauptnavigation der Seite (hier in der Vertikalen),
* rechts von der Hauptnavigation liegt der Contentbereich (Artikel) mit dem Inhalt der Seite
* und am unteren Ende der Seite ist wie meistens der Footer.

==== Die Seitenstruktur ====

Die Seitenstruktur besteht aus 3 Ebenen und einem zusätzlichen Bereich Service_Navi. Die Service_Navi ist im Menü ausgeblendet, damit diese nicht im Hauptmenü angezeigt wird.

[[Datei:Seitenstruktur.png]]

Die Seiten sind zum leichteren Verständnis so benannt, dass zuerst die Ebene und dann der Menüpunkt im Seitennamen stehen.

Ebene 1 hat also 4 Menüpunkte (Ebene_1 Punk_1 / Ebene_1 Punk_2 / Ebene_1 Punk_3 / Ebene_1 Punk_4).

Unter Ebene_1 Punk_2 sind weitere Menüpunkte angelegt (Ebene_2 Punk_1 / Ebene_2 Punk_2 / Ebene_2 Punk_3 / Ebene_2 Punk_4).

Und so weiter …

=== Die Module ===

[[Datei:Module.png]]

In diesem Beispiel sind 4 Module angelegt.
* TL-test_Footer -> "Eigener HTML-Code", der den Footer der Seite bildet. (unwichtig)
* TL-test_hauptnavi_links -> Diese Navigation wird die Hauptnavigation sein, in der sich am meisten ändern wird.
* TL-test_Headernavi -> Hier ist eine Navigation für den Header.
* TL-test_navigationspfad > Navigationspfad, der hilft zu sehen, wo man gerade ist. ;) (unwichtig)

==== Das Modul "Navigationsmenü" (für das Modul TL-test_hauptnavi_links) ====
Die Standardeinstellung sieht wie folgt aus:

[[Datei:Modul_hauptnavi_links_starteinstellung.png]]

{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 0 || Nein || keine angegeben
|}

Diese Einstellungen ergeben dieses Bild im FE - Ansicht nur für das Hauptmenü:

[[Datei:Internetseite_starteinstellung.png]]

* Der Startlevel legt fest, ab welchem Level die Menüpunkte im FE generiert werden. In diesem Fall wird ab der 1. Ebene angezeigt.
* Der Stoplevel besagt in diesem Fall das alle Menüpunkte angezeigt werden.
* Das Hard Limit ist aus und hat daher keine Auswirkung.
* Eine Referenzseite wurde nicht festgelegt, deshalb wird hier von dem Startpunkt dieser Internetseite ausgegangen.

== Der Stoplevel ==
Der Stoplevel legt fest bis zu welchem Level die Menüpunkte angezeigt werden. Was bedeutet das nun? In der Regel möchte man ein Menü mit vielen Unterpunkten nicht direkt dem User zumuten, daher zeigt man ihm nur einen Teil der Seiten und erst später mehr. Typischerweise ist es so, das man erst die 2. Ebene sieht, wenn man auf einen Punkt der 1. Ebene geklickt hat usw.

=== Stoplevel auf 1 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 1 || Nein || keine angegeben
|}

Diese Einstellungen ergeben dies im FE:

[[Datei:Internetseite_stoplevel_1_ebene1_punkt1.png]]

Der User ist hier auf der Seite Ebene1_Punk1 und sieht nur die Hauptpunkte der Navigation

[[Datei:Internetseite_stoplevel_1_ebene1_punkt3.png]]

Der User ist hier auf der Seite Ebene1_Punk2 und sieht die Unterpunkte von Punkt2 sowie die Menüpunkte der Ebene 1 darüber.

[[Datei:Internetseite_stoplevel_1_ebene2_punkt2.png]]

Und so geht es weiter, wenn der User dann in Ebene 2 auf Punkt 2 ist.

=== Stoplevel auf 2 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 2 || Nein || keine angegeben
|}

Jetzt wird im FE die 1. und die 2. Ebene angezeigt. Der Rest ist wie bei Stoplevel 1. Und so geht es weiter, daher wird hier auf weitere Beispiele verzichtet.

== Der Startlevel ==
Der Startlevel legt fest, ab welchem Level die Menüpunkte angezeigt werden. Genau diese Einstellung wird benötigt, um zum Beispiel ein Untermenü (früher das Modul "Navigation Untermenü") zu erstellen.

=== Startlevel auf 1 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 1 || 0 || Nein || keine angegeben
|}
Im FE sieht das dann so aus:

[[Datei:Internetseite_startlevel_1_ebene1_punkt2.png]]

Ab Level 1 bedeutet also, dass das Menü erst angezeigt wird, wenn man in Ebene 1 in einem Punkt ist, der Unterpunkte hat -
hier in dem Beispiel also auf Seite Ebene1_Punk2 (in der oberen Navigation zu sehen). Alles, was darunter ist, wird angezeigt - hier in der linken Hauptnavigation, so wie es gerade eingestellt wurde. Wenn man also in Ebene1_Punk4 ist, werden alle Unterpunkte unter Punkt 4 der 1. Ebene angezeigt und so weiter.

=== Startlevel auf 2 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 2 || 0 || Nein || keine angegeben
|}
FE:

[[Datei:Internetseite_startlevel_2_ebene2_punkt2.png]]

Erst wenn Unterpunkte unter Ebene 2 vorhanden sind, wird jetzt das Menü angezeigt - hier in dem Fall bei der Seite Ebene2_Punk2.

=== Startlevel auf 3 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 3 || 0 || Nein || keine angegeben
|}
Und so geht es wieder weiter. Bei Startlevel 3 wird das Menü erst angezeigt, wenn unter Ebene 3 noch weitere Unterpunkte sind...

== Eine Referenzseite festlegen ==
"Eine Referenzseite als Quell- oder Zielseite des Moduls festlegen." Mit der Referenzseite legt mal fest, was der Startpunkt der Navigation ist. Sobald man eine '''Referenzseite''' festgelegt hat, funktioniert das '''Startlevel''' nicht mehr! Das bildet dann also immer die Ebenen direkt ab der Referenzseite ab.

=== Referenzseite auf Seite Ebene1_Punk2 ===

[[Datei:Modul_referenzseite_ebene1_punkt2.png]]

{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 0 || Nein || Seite Ebene1_Punk2
|}

[[Datei:Internetseite_referenzseite_ebene1_punkt3_ebene1_punkt1.png]]

Jetzt wird die Navigation immer die Unterpunkte von Seite Ebene1_Punk2 anzeigen, auch wenn man auf der Seite Ebene1_Punk1 ist oder irgendwo anderes. Das ist also eine einfache Möglichkeit, so etwas wie eine Service Navigation (mit immer den gleichen Seiten wie Kontakt / Impressum o.ä.) anzulegen. Wenn man nun dem Modul TL-test_Headernavi die Referenzseite "Service Navi" gibt,

{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 0 || Nein || Seite "Service Navi"
|}

bekommt man im FE diese Ausgabe:

[[Datei:Internetseite_referenzseite_service_navi.png]]

==== Theoretisches Beispiel ====
Wenn man jetzt eine Internetseite mit 3 Navigationen hat, die gleichzeitig angezeigt werden sollen, kann man also im BE unter der Seitenstruktur 3 verschiedene Seiten anlegen: Menue1 / Menue2 / Menue3, und dann unter diesen Seiten die jeweils gewünschten Unterseiten. Nun legt man 3 Module an, jedes Modul mit einer anderen Referenzseite (Modul1 -> Menue1 etc.). Und schon hat man auf der Internetseite 3 komplett verschiedene Navigationen, die sich nicht gegenseitig beeinflussen.

== Das Hard Limit ==
Das Hard Limit legt fest, das keine Menüpunkte (auch keine aktiven Menüpunkte) jenseits des Stoplevels angezeigt werden. Was soll das nun wieder? Wenn man das Hard Limit einschaltet, ohne irgendwelche anderen Parameter beim Stoplevel, ändert sich die Anzeige überhaupt nicht im Vergleich zu dem Beispiel ohne eingeschaltetes Hard Limit (s.o.).

{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 0 || Ja || keine angegeben
|}

[[Datei:Internetseite_grundlage.png]]

'''Das Hard Limit ergibt nur einen Sinn im Zusammenhang mit einem zugewiesenen Stoplevel!'''

=== Das Hard Limit mit einem Stoplevel von 1 ===
{| class="wikitable"
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 1 || Ja || keine angegeben
|}

[[Datei:Internetseite_stoplevel_1_ebene1_punkt1.png]]

Jetzt bewirkt das Hard Limit, das keine Seiten unterhalb des Stoplevels angezeigt werden. Hier in dem Beispiel wird nur Ebene 1 angezeigt, auch wenn man in der Struktur eine oder zwei Ebenen tiefer ist. Das Menü erweitert sich also nicht mehr beim Navigieren.

'''So kann man dann auch das Modul "Navigation Hauptpunkte" nachbilden.'''

(Wie sie jetzt gerade auch im Bild oben bei der Headernavi zu sehen ist.)

= Praxisbeispiele =

== Hauptmenü / Untermenü / Service Navigation ==
{| class="wikitable"
|+ Hauptmenü
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 1 || Ja || keine angegeben
|}
{| class="wikitable"
|+ Untermenü
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 1 || 1 || Ja || keine angegeben
|}
{| class="wikitable"
|+ Service Navigation
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 1 || Ja || Service Navi
|}
Das ist eine der häufigsten Verwendungen:
* Das Hauptmenü ist als horizontale Navigation auf der Seite und zeigt nur die Punkte der Ebene 1 an.
* Das Untermenü ist meist auf der linken Seite neben dem Content und beinhaltet alle Unterseiten, wobei auch nur die Unterpunkte in Ebene 3 angezeigt werden, wenn man in Ebene 2 auf einer Seite ist mit Unterseiten.
* Die Service Navigation zeigt nur die Seiten an, die innerhalb der Seite "Service Navi" liegen, also direkt untergeordnet sind. Der Stoplevel und das Hard Limit dienen hier dazu auf keinen Fall Seiten unterhalb dieser anzuzeigen. Ein Beispiel wäre eine "Vielen Dank"-Seite, die innerhalb der "Kontakt"-Seite liegt, um angezeigt zu werden, wenn das Formular erfolgreich versendet wurde.

== Hauptmenü bis Ebene 3 und Ebene 4 im Untermenü ==
{| class="wikitable"
|+ Hauptmenü
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 1 ||Nein || keine angegeben
|}
{| class="wikitable"
|+ Untermenü
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 3 || 1 || Nein || keine angegeben
|}
* Das Hauptmenü wird so alles anzeigen, wie weiter oben besprochen: Die unteren Ebenen werden erst eingeblendet, wenn man auf einer Seite ist, die auch Unterseiten hat.
=== Ausblenden der 4. Ebene in dem Hauptmenü: ===
====Das kann man ganz einfach per CSS machen mit ====

#left ul li ul li ul li ul li {
position: absolute;
top: -1000em;
left: -1000em;
height: 1px;
width: 1px;
}

====Per Template Anpassung nur die Ebenen Anzeigen die man in dem Hauptmenü braucht====

<?php $ebenen = array('level_1', 'level_2', 'level_3'); ?>
<?php if(in_array($this->level, $ebenen)) :?>
Die normale Navigationsausgabe
<?php endif; ?>

Am Anfang wird in eine Array geschrieben, welche Ebenen man ausgeben möchte. Danach wird anhand des Navigationslevels überprüft ob eine Ausgabe stattfinden soll oder nicht.

* Das Untermenü zeigt erst die Seiten in Ebene 4 und darunter an. Diese kann man auch wunderbar als Content Element einfach in den Artikeln einbinden, wo man es gerade braucht.

== Menü zum Ausklappen (per Hover like Suckerfish oder eine Hybridnavigation etc.) ==
{| class="wikitable"
|+ Hauptmenü
|-
! Startlevel !! Stoplevel !! Hard Limit !! Referenzseite festlegen
|-
| 0 || 2 || Ja || keine angegeben
|}

So hat man dann ein Menü was man per CSS (und ein wenig JavaScript) zum Ausklappmenü machen kann. Hier nur bis Ebene 2 und nicht mehr. Für mehr Ebenen einfach den Stoplevel hochsetzen.

=Wichtige Style Klassen=

Kurzfassung (Klasse die Vergeben wird = Zustand):
* Keine Klasse = nicht ausgewählt
* active = die aktive Seite
* trail = Übergeordnete Seite der aktiven Seite
* first = erstes Listen-Element einer Liste
* last = letztes Listen-Element einer Liste

Zusätzlich kann man noch unter Seitenstruktur den einzelnen Seiten und Navigationspunkten eine extra Klasse vergeben.

Tutorial erstellt von --[[Benutzer:MacKP|MacKP]] 22:37, 10. Mär. 2010 (UTC)

= Wichtige Hinweise (nach TYPOlight / Contao Versionen): =
== TYPOLight 2.8.1 ==
Hier hat das Navigationsmodul einen Bug, der das richtige Setzen von einer Referenzseite verhindert:

http://dev.contao.org/issues/1635

Die Lösung ist hier beschrieben:

http://dev.contao.org/issues/1635#note-6

Man muss dazu die ModuleNavigation.php in /system/modules/frontend/ bearbeiten.

----

--[[Benutzer:MacKP|MacKP]] 12:58, 5. Apr. 2010 (UTC)

Navigationspunkte nicht verlinken

2010-08-22T22:38:58Z

MacKP:

{{AppliesTo|TLVersion=2.8.x|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]
Wenn man in der [[ModulNavigation|Navigation]] bestimmte Seiten nicht verlinkt, sondern nur als Überschrift haben will, ist eine Anpassung des Templates notwendig.

Dazu das Template nav_default.tpl kopieren und neu benennen (z.b. nav_partiallinked.tpl). Eine Anleitung für die Templatebearbeitung ist [[Templates bearbeiten|hier]] zu finden.

Das Template nun wie folgt ändern:
<pre>
<ul class="<?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; ?>"><span class="active<?php if ($item['class']): ?> <?php echo $item['class']; ?><?php endif; ?>"><?php echo $item['link']; ?></span><?php echo $item['subitems']; ?></li>
<?php else: ?>
<li<?php if ($item['class']): ?> class="<?php echo $item['class']; ?>"<?php endif; ?>><?php if(strpos($item['class'], 'nonavlink')===false):?> <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 endif; ?><?php echo $item['link']; ?><?php if(strpos($item['class'], 'nonavlink')===false):?></a><?php endif; ?><?php echo $item['subitems']; ?></li>
<?php endif; ?>
<?php endforeach; ?>
</ul>
</pre>

Als nächster Schritt muss im Modul "Navigation" als Template ''nav_partiallinked.tpl'' gewählt werden.

Abschliessend müssen in der Seitenstruktur allen Seiten, die nicht verlinkt werden sollen, die Klasse ''nonavlink'' hinzugefügt werden.

[[Datei:howto_menu_nicht_verlinken.jpg|Der Seite die Klasse hinzufügen]]

Catalog

2010-08-19T13:28:48Z

MacKP: /* Titel so beeinflussen, das die aktuelle Kategorie einer Liste dort steht */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

=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 der Alias genutzt bei den Links
* 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

===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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

==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:
<nowiki>
<?php if(strlen($this->Input->get('kategorie')))
{
global $objPage;
$objPage->pageTitle = "".$entry['data']['kategorie']['value']." - XYZ";
} ?>
</nowiki>
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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

===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:
<pre>ROUND(datum)</pre>
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:
<pre>ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

==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 Exel nicht direkt so gemacht.

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

Catalog mit Frontend-Editing und Workflow erstellen

2010-08-18T22:55:21Z

MacKP: /* Katalog-Edit */

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

=Kurzbeschreibung=
Hier geht es darum, wie man Items im Frontend erstellen und bearbeiten kann. Anhand eines Immobilienkataloges wird auch noch die Einrichtung eines Workflows vorgestellt. Zum Schluss soll es dem Besucher der Seite noch möglich sein Kontakt zu dem Seitenbetreiber aufzunehmen (mithilfe eines Formulars bei dem Item).
Hier bei dem Beispiel werden exemplarisch zwei Arten von Immobilien angelegt (Haus zum Kaufen und Hotelzimmer).
Bei diesem Beispiel ist die Backend-Ansicht von den Items nicht wirklich wichtig und wurde auch vernachlässigt, da alle Items über das Frontend verwaltet werden.

=Benötigte Erweiterungen=
* catalog
** backend_filterwiz
** backend_tabletree
** DC_DynamicTable
** taxonomy
* catalogitemuseridfield (für den Workflow wichtig, da damit die Items dem User zugewiesen werden)
* catalog_mailer (hier gibt es im Moment noch das Problem einer blöden abhängigkeit von catalog_ext. also noch nicht installieren!)

=Voraussetzungen für das Tutorial=
* wie ein Katalog erstellt wird sollte von anderen Tutorials klar sein und man sollte die Beschreibung der einzelnen Felder gelesen haben.
* Erstellung von Taxonomie
* der Umgang mit Contao sollte bekannt sein
** Seitenstruktur bearbeiten
** Module anlegen
** Templates bearbeiten
** Mitgliederbereich einrichten (für 2 Gruppen:Makler und Makler-Admins)

=Erstellen der Grundlagen im Backend=

==Erstellung von neuen Seiten in der Seitenstruktur==

* Startseite (Hier wird catalogfeatured eingesetzt)
** Immobilien Liste (Filter und Liste der Immobilien)
*** Immobilien Details (die Detailseite von einem Item)
* Geschützer Bereich
** Immobilien Anlegen (Für normale Makler)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten
** Immobilien Anlegen Administration (Für Makler-Admins)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten

[[Datei:cat-fe-wf-sitestructure.png|Cat Sitestructure]]

==Taxonomie (Bedingung)==

Die Taxonomien sind für die Kategorien und für die Gebiete der Items

Man erstellt sich zuerst die Kategorien und die Optionen. Wobei man hier wie bei einem Baum Verschachtelungen vornimmt:

* Immobilien
** Immo Art
*** Haus
**** Miethaus
**** Ferienhaus
**** Haus zum kaufen
*** Hotel
**** Hotelzimmer
** Immo Gebiete
*** Bizerte
*** Jendouba
*** Beja
*** etc.

Das Ergebniss sollte ungefähr so aussehen wie auf diesem Bild:

[[Datei:cat-fe-wf-taxonomy.png|Cat Taxonomy]]

==Erstellen von einem Katalog mit Feldtypen==

===Neuer Katalog===

Zuerst erstellt man mit einem Klick auf Neuer Katalog einen neuen Katalog und stellt den wie folgt ein:
* Name von dem Katalog angeben
* einen Tabellennamen angeben (die Tabelle wird automatisch erzeugt). Bitte '''keine Tabellen mit tl_* anlgegen''', da diese dann von Contao immer als zu löschen vorgemerkt werden beim aktualisieren der Datenbank.
* Alias und Felder veröffentlichen kann erst später angegeben werden, wenn diese Felder vorhanden sind.
* Sprung zur Seite: Angabe der Detailansicht
* Suche - Suchbar -> aktivieren (keine Bedingung angeben)
* Alle weiteren Einstellungen werden erst später vorgenommen.

[[Datei:cat-fe-wf-newcat1.png|Cat erstellen Bild1]]

[[Datei:cat-fe-wf-newcat2.png|Cat erstellen Bild2]]

===Felder definieren für den Katalog Merkzettel===
Es werden folgende Felder angelegt (Einstellungen die nicht vorgenommen werden, sind nicht aufgelistet):

[[Datei:cat-fe-wf-fields1.png|Cat Felder erstellen]]

[[Datei:cat-fe-wf-fields2.png|Cat Neues Feld]]

{| border="1" cellpadding="20" cellspacing="0"
|+ align="bottom" style="color:#e76700;" |''Feldtypen für die Items''
|-
!Bezeichnung
!Spaltenname
!Typ
!Einstellungen
|-
|Titel
|immo_titel
|text
|
* Sichtbar in der Backend-Listen-Ansicht
* Sortierungs-Dropdown aktivieren
** Sortier-Modus -> Gruppieren anhand der ersten zwei Buschstaben und absteigend
** Backend-Suche aktivieren
* Pflichtfeld
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Alias
|immo_alias_auto
|alias
| * Alias-Titel-Feld -> '''Titel'''
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Benutzer ID
|userid
|Frontend-Benutzer
|-
|Art
|immo_art
|Auswahl
|
* Pflichtfeld
* Tabelle für Optionen -> '''tl_taxonomy'''
* Option Spaltenwert -> '''name'''
* Option Sortierspalte -> name
* Sichtbar in der Backend-Listen-Ansicht
* Die Optinsauswahl individualisieren
** Auswahl der Stamm-Einträge -> Immo Art
** Modus für Unter-Auswahl -> ''Zeigen Sie die Kindelemente von ausgewählten Einträgen ausgeklappt an.'''
** Filter des Elternelements -> leer lassen
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Umgebungsbeschreibung
|immo_umgebung
|langtext
|
* HTML erlauben
* Rich Text
* TinyMCE-Editor-Template -> tinyMCE
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bild
|immo_bild
|file
|
* Sichtbar in der Backend-Listen-Ansicht -> aktivieren
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Produktbild
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bildergalerie
|immo_bildergalerie
|file
|
* Mehrfach-Auswahl
* Anordnung nach Dateiname (aufsteigend)
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Veröffentlichen
|immo_veroeffentlichen
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Online
|immo_online
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Hervorheben
|immo_besonders
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Immobilie entfernen
|immo_delete
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|}

====Erklärung====
* Natürlich sind hier noch viel mehr Felder und Feldtypen angelegt. Diese paar sollten aber reichen um das prinzip zu verdeutlichen.
** Jede Art hat da ihre eigenen Felder (z.B. ist die Grundstücksfläche für Hotelzimmer nicht wichtig und wird daher dann später nicht mit ausgegeben)
* Bild und die Galerie sind getrennt, damit später in der Listenansicht ein bestimmtes Bild ausgegeben werden kann.
* Die Checkboxen '''Veröffentlichen''', '''Online''', '''Hervorheben''' und '''Immobilien entfernen''' sind besonders wichtig für die Verwaltung der Immobilien.
** Nur Makler-Admins bekommen später die Möglichekeit Immobilien online zu stellen ('''Online''') und diese auf der Startseite anzuzeiben ('''Hervorheben''')

===die Katalog Einstellungen noch einmal überarbeiten===
Da jetzt die Feldtypen definiert wurden, kann man im Katalog selbst noch weiter Einstellungen vornehmen:
* Alias-Feld -> Alias
* Feld veröffentlichen -> NICHTS '''hier nicht angeben, da die Makler im Frontend sonst ihre Items nicht sehen können!'''
* Meta-Title-Feld -> Titel
* Meta-Beschreibungs-Feld -> Umgebungsbeschreibung
* Zeichenkette des Titels formatieren -> <nowiki>{{immo_titel}} - {{immo_gebiet}} - {{immo_art}}<br />
{{immo_bild::w=100&h=80}}</nowiki>

==Einstellen von ein paar Items (Produkten)==
Nun können ein paar Immobilien erstellt werden. Zu beachten ist: diese Immobilien gehören erst einmal '''keinem''' Mitglied. Erst wenn ein Mitglied das Item bearbeitet und speichert ist es ihm Zugeordnet!

[[Datei:cat-fe-wf-new-item1.png|Cat new item1]]

[[Datei:cat-fe-wf-new-item2.png|Cat new item2]]

==Die nötigen Module==

===Katalog-Filter===
Damit die Benutzer und die Mitglieder das angezeigt bekommen was sie wollen, sollte man mit einem Filter die Immobilien Einschränkbar machen.
Damit auch alle die passende Einstellung haben bei der Weiterleitungsseite muss man dieses Modul 3 mal anlegen und jeweils zur passenden Seite mit der Liste weiterleiten (eins anlegen und kopieren erleichtert einem die arbeit enorm *g*)

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Liste (je nachdem für welche Gruppe der Filter gerade erstellt wird)
* Benützen Sie Filterkonditionen des Listers auf der selben Seite -> aktivieren (dadurch sind nur die Filter aktiv, die auch passende Immobilien beinhalten)
* Filter pro Abschnitt aktivieren
** Gebiet -> Auswahlmenü
** Art -> Auswahlmenü
* Such-Filter
** Suchbox aktivieren -> aktivieren
** Kopfzeile suchen -> Suche (h3)
** Suchfelder
*** Alle Felder die man durchsuchbar haben möchte ankreuzen (z.B. Titel, Gebiet, Art, Umgebungsbeschreibung)
* Filter-Layout -> filter_default

===Katalog-Liste===
Nun muss man mehrere Listenmodule anlegen. Einmal eine Liste für die Besucher. Dort sind alle Immobilien vorhanden, die online sind.
Für die Makler und Makler-Admins muss man nun für jede Art eine passende Liste erstellen.
Bei 5 verschiedenen Arten sind das also 5 Listen für Makler, 5 Listen für Makler-Admins.
Zusammengenommen also 11 Listen. Das ganze kann man sicher auch mittels PHP und MySQL etwas zusammenfassen. Hier geht es jedoch darum, das Prinzip aufzuzeigen und jedem zu ermöglichen so einen Katalog ohne viel Programmierkenntisse anzulegen.

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Suchfelder
*** nach Bedarf anklicken
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung''' Je nach Liste etwas anders:
** Liste für Besucher der Seite: <nowiki>immo_online=1 and immo_freigeben=1 and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items, die online sind, die freigegeben sind und die nicht Entfernt sind (also als solche Markiert)
** Liste für Makler <nowiki>immo_art='136' and immo_delete!='1' AND (userid={{user::id}} OR userid=0)</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt wo die UserID gleich der eigenen oder keiner ist (alle Items von dem Mitglied und Items die noch keinem zugeordnet sind)
** Liste für Makler-Admin <nowiki>immo_art='136' and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt sind an. Hier wird nicht die UserID abgefangen! Dadurch können Makler-Admins alle Immobilien sehen.
** Elemente pro Seite -> 6
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_cataloglist

===Katalog-Leser===
Hiervon gibt es nur ein Modul. Die Makler und Makler-Admins bekommen das Modul Katalog-Edit.
Die Ausgabe der verschiedenen Arten und deren besonderheit regel ich über das Teplate mit einer extra if-Abfrage (lasse also nur die Felder anzeigen, die überhaupt einen Inhalt haben).

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Umgebungsbeschreibung
* Template-Einstellungen
** Katalog-Layout -> catalog_full
** Katalog-Template -> mod_catalogreader

===Katalog-Featured===
Hiermit werden die hervorgehobenen Items auf der Startseite dargestellt.

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung'''
** <nowiki>immo_online=1 and immo_besonders and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online, besonders und nicht Entfernt sind.
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogfeatured

===Katalog-Related===

Hiermit werden ähnliche Immobilien auf der Detailseite einer Immobilie angezeigt. Übereinstimmen muss in diesem Beispiel nur das Gebiet. Bei vielen Items sollte die Liste hier weiter eingeschränkt werden (Sinnvoll wäre zum Beispiel die Art der Immobilie)

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Betroffene Felder, die übereinstimmen müssen -> Gebiet
** Anzahl der Tags die zusammengehöhren müssen -> 0 (macht nur sinn bei mehreren. Dann werden nur Items angezeigt, die zum Beispiel 2 Gleiche Felder haben bei der Angabe von 2)
** '''Bedingung''' -> <nowiki>immo_online=1 and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online und nicht Entfernt sind.
** Anzahl der Einträge -> 5
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogrelated

===Katalog-Edit===
{{Achtung|Hier muss auf das passende Template geachtet werden -> '''catalog_edit.tpl''' sonst kommt eine Fehlermeldung in der Art 'No valid Item ID'}}

Hier sind wieder mehrere Module nötig.

Für Makler in jeder Art eins -> 5

Für Makler-Admins -> 5

(für jede Art, da die sich ja wie oben genannt in den Feldern unterscheiden)

'''Felder die einen Standardwert bekommen dürfen nicht bearbeitet werden können!'''

Außerdem lasse ich das Alias Feld nicht bearbeiten, damit da keine unschönen Aliase generiert werden.

'''Einstellungen für Makler:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Benutzer id [userid:useridfield]''' (Nur dadurch wird die ID des Maklers erfasst. Wird aber nicht im Frontend angezeigt)
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)
** '''Online -> nein'''

'''Einstellungen für Makler-Admins:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Online'''
** '''Hervorheben'''
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)

Mit diesen unterschiedlich eingestellten Katalog-Edit Modulen erreichen wir den Workflow:

Makler können eine Immobilie bearbeiten und neu anlegen. Die Immobilie können Makler aber nicht online stellen oder hervorheben. Beim Bearbeiten wird durch den Standardwert Online=nein die Immobilie offline gestellt.

Makler-Admins können Immobilien bearbeiten und neu anlegen. Die Immobilien können von Makler-Admins online gestellt werden und hervorgehoben werden (diese können ja die Felder sehen und bearbieten, die dafür zuständig sind).

[[Datei:cat-fe-wf-modules.png|Cat Module]]

==Die Module in Artikeln den passenden Seiten zuordnen==
Nun müssen die Module noch auf die jeweils passende Seite gebracht werden:

* Startseite -> Catalog-Featured
** Immobilien Liste -> Catalog-Filter und Catalog Liste (für Besucher!)
*** Immobilien Details -> Catalog-Leser
* '''Geschützer Bereich'''
** Immobilien Anlegen -> mit Navigation für die Unterseiten (Für Makler und Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit
** Immobilien Anlegen Administration -> mit Navigation für Unterseiten (Für Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit

Ich kann nur aus eigener Erfahrung sprechen: Spätestens jetzt ist man froh, wenn man eine Eindeutige Benennung der Module vorgenommen hat! Hier muss man mit vielen ähnlichen Modulen arbeiten und da ist es auf dauer sehr mühselig, wenn man nicht auf den 1. Blick erkennen kann was es ist.
Ich selber benenne die Module daher zum Beispiel so: 'Katalog - Makler - Edit - Haus zum kaufen'
Dadurch ist die automatische Sortierung im Backend außreichend gut. Man sieht was für ein Modul es ist (Katalog) für welche Gruppe es ist (Makler) was genau es machen soll (Edit) und für welchen Bereich es gedacht und eingestellt ist (Haus zum kaufen).

==Templates==
Tutorial zum Anpassen der Templates : [[Catalog_Templates_anpassen|Catalog Templates anpassen]]

----

--[[Benutzer:MacKP|MacKP]] 14:52, 18. Mai 2010 (UTC)

Catalog

2010-08-18T22:51:23Z

MacKP: /* Wie kann man in der Detail Ansicht den meta-title so beeinflussen, das dieser den Namen von dem Item nimmt? */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

=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 der Alias genutzt bei den Links
* 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

===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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

==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:
<nowiki>
<?php
global $objPage;
$objPage->pageTitle = 'dein neuer title den du haben willst';
?>
</nowiki>

==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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

===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:
<pre>ROUND(datum)</pre>
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:
<pre>ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

==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 Exel nicht direkt so gemacht.

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

Google Analytics

2010-07-21T09:15:38Z

MacKP:

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

=Allgemeines=
[[w:de:Google_Analytics|Google Analytics]] ist ein kostenloser Dienst, welcher der Analyse von Zugriffen auf Webseiten dient (Es gillt nur ein Monatliches Limit an Seitenaufrufen in Höhe von 5.000.000 Aufrufen).

{{Hinweis|Um Verfälschungen auszuschließen, wird der Google Analytics Code erst im Frontend angezeigt, wenn man sich aus dem Backend ausgeloggt hat.}}

==Rechtliches==
'''Anmerkung:'''Dies ist keine Rechtsberatung. Genaue Angaben dazu kann nur ein Rechtsanwalt tätigen (am besten in dem Fachgebiet Internet)

Es ist rechtlich noch nicht klar ob es nun Verboten ist die Daten in Deutschland mit Google-Analytics zu erfassen. 2 Dinge sprechen erst einmal dagegen: Die Google Server sind nicht unbedingt in Deutschland. Die IP wird erfasst und die gewonnenen Daten können nicht einfach von einem Seitenbetreiber gelöscht werden, wenn ein Besucher dies verlangt.

Es gibt inzwischen ein Addon für einige Browser von Google, die Analytics Datensammlung Deaktivieren: http://tools.google.com/dlpage/gaoptout?hl=de

Wer sicher gehen möchte, der kann die IP von den Besuchern Anonymisieren und so dem Datenschutz genügen.

=Google Analytics Konto erstellen=
Um den Dienst ''Google Analytics'' (nachfolgend GA) nutzen zu können, muss man sich zuerst ein GA-Konto [http://www.google.com/analytics/ erstellen].<br />
Nach dem Erstellen eines Accounts gibt man GA die Domain bekannt, auf der der Dienst laufen soll. Dazu klickt man auf ''Neues Konto'' ...

[[Datei:ga_createaccount.png|Google Analytics Account erstellen]]

... und anschließend auf ''Anmelden''.

[[Datei:ga_login.png|Webseite hinzufügen]]

Anschließend erfolgen die Angaben zur Webseite, auf der GA laufen soll.

[[Datei:ga_websitesettings.png|Webseiten Angaben]]

Nachdem man den Geschäftsbedingungen zugestimmt hat, kommt man zur Seite mit dem Tracking-Code. In diesem Code notiert man sich die Account-Nummer; die wird später noch benötigt.

{{Hinweis| In den Google Geschäftsbedingungen (PUnkt 8.1) wird man Aufgefordert einen dort angegebenen Satz auf seiner Webseite einzubringen. Das sollte man auf jeden Fall machen, da es dort um die Datenschutzrichtlinien geht, die eh jeder auf seiner Internetseite auszeichnen sollte! }}

[[Datei:ga_trackingcode.png|Tracking Code]]

Nach dem Speichern der Eingaben kommt man zur Übersicht, wo nun die erstellte Webseite auf scheint.

[[Datei:ga_overview.png]]

=Typolight bis 2.8.x=
Um GA in TYPOlight bis 2.8.x einzubinden, bearbeitet man das entsprechende Seitenlayout und fügt unter ''Experten-Einstellungen'' im Feld ''Google Analytics Id'' die vorhin notierte GA-ID ein.

[[Datei:ga_layout_tl.png|Seitenlayout]]

Anschließend speichert und schließt man das Layout.

=Contao ab 2.9=
Seit Contao 2.9 wird GA über das Template ''moo_analytics.tpl'' eingebunden. Wie man ein Template über den im Core integrierten Template-Editor einbindet, ist [[Templates_bearbeiten|hier]] beschrieben. Nachdem das Template ausgewählt wurde, wird das Template bearbeitet.

[[Datei:ga_templateedit.png|Template bearbeiten]]

Wie schon in dem Kommentar des Templates vermerkt ist, braucht nur die im Code eingefügte Blind-ID (UA-XXXXX-X) gegen die vorhin notierte GA-ID ausgetauscht werden. Anschließend kann das Template gespeichert und geschlossen werden.

Nun muss im Seitenlayout das Script eingebunden werden. Dazu setzt man unter ''Skript-Einstellungen'' einen Haken bei dem Punkt ''moo_analytics''. Es muss darauf geachtet werden, dass dieses Skript als letztes eingebunden wird! Anschließend wird das Layout gespeichert und geschlossen.

[[Datei:ga_layout.png|Seitenlayout]]

==IP-Adressen anonymisieren==
Aus Datenschutzgründen bietet GA seit geraumer Zeit die Möglichkeit, die geloggten IP-Adressen der Besucher zu anonymisieren. Dazu muss nochmal das Template bearbeitet werden und zwischen der Zeile <code>_gaq.push(['_setAccount', 'UA-XXXXX-X']);</code> und der Zeile <code>_gaq.push(['_trackPageview']);</code> eine neue Zeile mit folgendem Inhalt eingefügt werden:

<pre>_gaq.push(['_gat._anonymizeIp']);</pre>

Das ganze Template sieht dann wie folgt aus:
<pre>
<?php

/**
* To use the script, replace UA-XXXXX-X in the code below with your Google
* Analytics ID and then add it to a Contao page layout. Make sure to insert
* it as the last moo_ script (!) and note that it will only be added to the
* page if you are not logged into the back end.
*/
if (!BE_USER_LOGGED_IN && sha1(session_id() . (!$GLOBALS['TL_CONFIG']['disableIpCheck'] ? $this->Environment->ip : '') . 'BE_USER_AUTH') != $this->Input->cookie('BE_USER_AUTH')):

?>

<script type="text/javascript">
<![CDATA[//><!]]>
</script>
<?php endif; ?>
</pre>

Google Analytics

2010-07-21T09:14:56Z

MacKP:

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

=Allgemeines=
[[w:de:Google_Analytics|Google Analytics]] ist ein kostenloser Dienst, welcher der Analyse von Zugriffen auf Webseiten dient (Es gillt nur ein Monatliches Limit an Seitenaufrufen in Höhe von 5.000.000 Aufrufen).

{{Hinweis|Um Verfälschungen auszuschließen, wird der Google Analytics Code erst im Frontend angezeigt, wenn man sich aus dem Backend ausgeloggt hat.}}

==Rechtliches==
'''Anmerkung:'''Dies ist keine Rechtsberatung. Genaue Angaben dazu kann nur ein Rechtsanwalt tätigen (am besten in dem Fachgebiet Internet)

Es ist rechtlich noch nicht klar ob es nun Verboten ist die Daten in Deutschland mit Google-Analytics zu erfassen. 2 Dinge sprechen erst einmal dagegen: Die Google Server sind nicht unbedingt in Deutschland. Die IP wird erfasst und die gewonnenen Daten können nicht einfach von einem Seitenbetreiber gelöscht werden, wenn ein Besucher dies verlangt.

Es gibt inzwischen ein Addon für einige Browser von Google, die Analytics Datensammlung Deaktivieren: http://tools.google.com/dlpage/gaoptout?hl=de

Wer sicher gehen möchte, der kann die IP von den Besuchern Anonymisieren und so dem Datenschutz genügen.

=Google Analytics Konto erstellen=
Um den Dienst ''Google Analytics'' (nachfolgend GA) nutzen zu können, muss man sich zuerst ein GA-Konto [http://www.google.com/analytics/ erstellen].<br />
Nach dem Erstellen eines Accounts gibt man GA die Domain bekannt, auf der der Dienst laufen soll. Dazu klickt man auf ''Neues Konto'' ...

[[Datei:ga_createaccount.png|Google Analytics Account erstellen]]

... und anschließend auf ''Anmelden''.

[[Datei:ga_login.png|Webseite hinzufügen]]

Anschließend erfolgen die Angaben zur Webseite, auf der GA laufen soll.

[[Datei:ga_websitesettings.png|Webseiten Angaben]]

Nachdem man den Geschäftsbedingungen zugestimmt hat, kommt man zur Seite mit dem Tracking-Code. In diesem Code notiert man sich die Account-Nummer; die wird später noch benötigt.

{{Hinweis| In den Google Geschäftsbedingungen (PUnkt 8.1) wird man Aufgefordert einen dort angegebenen Satz auf seiner Webseite einzubringen. Das sollte man auf jeden Fall machen, da es dort um die Datenschutzrichtlinien geht, die eh jeder auf seiner Internetseite auszeichnen sollte! }}

[[Datei:ga_trackingcode.png|Tracking Code]]

Nach dem Speichern der Eingaben kommt man zur Übersicht, wo nun die erstellte Webseite auf scheint.

[[Datei:ga_overview.png]]

=Typolight bis 2.8.x=
Um GA in TYPOlight bis 2.8.x einzubinden, bearbeitet man das entsprechende Seitenlayout und fügt unter ''Experten-Einstellungen'' im Feld ''Google Analytics Id'' die vorhin notierte GA-ID ein.

[[Datei:ga_layout_tl.png|Seitenlayout]]

Anschließend speichert und schließt man das Layout.

=Contao ab 2.9=
Seit Contao 2.9 wird GA über das Template ''moo_analytics.tpl'' eingebunden. Wie man ein Template über den im Core integrierten Template-Editor einbindet, ist [[Templates_bearbeiten|hier]] beschrieben. Nachdem das Template ausgewählt wurde, wird das Template bearbeitet.

[[Datei:ga_templateedit.png|Template bearbeiten]]

Wie schon in dem Kommentar des Templates vermerkt ist, braucht nur die im Code eingefügte Blind-ID (UA-XXXXX-X) gegen die vorhin notierte GA-ID ausgetauscht werden. Anschließend kann das Template gespeichert und geschlossen werden.

Nun muss im Seitenlayout das Script eingebunden werden. Dazu setzt man unter ''Skript-Einstellungen'' einen Haken bei dem Punkt ''moo_analytics''. Es muss darauf geachtet werden, dass dieses Skript als letztes eingebunden wird! Anschließend wird das Layout gespeichert und geschlossen.

[[Datei:ga_layout.png|Seitenlayout]]

==IP-Adressen anonymisieren==
Aus Datenschutzgründen bietet GA seit geraumer Zeit die Möglichkeit, die geloggten IP-Adressen der Besucher zu anonymisieren. Dazu muss nochmal das Template bearbeitet werden und zwischen der Zeile <code>_gaq.push(['_setAccount', 'UA-XXXXX-X']);</code> und der Zeile <code>_gaq.push(['_trackPageview']);</code> eine neue Zeile mit folgendem Inhalt eingefügt werden:

<pre>_gaq.push(['_gat._anonymizeIp']);</pre>

Das ganze Template sieht dann wie folgt aus:
<pre>
<?php

/**
* To use the script, replace UA-XXXXX-X in the code below with your Google
* Analytics ID and then add it to a Contao page layout. Make sure to insert
* it as the last moo_ script (!) and note that it will only be added to the
* page if you are not logged into the back end.
*/
if (!BE_USER_LOGGED_IN && sha1(session_id() . (!$GLOBALS['TL_CONFIG']['disableIpCheck'] ? $this->Environment->ip : '') . 'BE_USER_AUTH') != $this->Input->cookie('BE_USER_AUTH')):

?>

<script type="text/javascript">
<![CDATA[//><!]]>
</script>
<?php endif; ?>
</pre>

Catalog Templates anpassen

2010-07-14T14:15:41Z

MacKP: /* Alle Werte ausgeben und nur einen Anpassen (als Beispiel Bilder mit eigenem */

Catalog

2010-07-13T07:12:48Z

MacKP: /* Tipps und Tricks zur Umsetzung */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

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

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

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

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

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

=Erstellen von einem Katalog (Backend)=
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 der Alias genutzt bei den Links
* 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 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

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

==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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

===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:
<pre>ROUND(datum)</pre>
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:
<pre>ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

==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 Exel nicht direkt so gemacht.

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

Catalog

2010-07-12T21:21:44Z

MacKP: /* Filtern nach Datum */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

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

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

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

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

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

=Erstellen von einem Katalog (Backend)=
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 der Alias genutzt bei den Links
* 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 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

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

==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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

===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:
<nowiki>ROUND(datum)</nowiki>
Damit wird auf einen Zahlenwert gerundet (da es sich schon um Integer Werte handelt geht dabei nichts verlohren).

Beispiel (von do_while) aus dem Forum:
<nowiki>ROUND(datum) BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</nowiki>
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 wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

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

Catalog

2010-07-12T11:28:38Z

MacKP: /* Erstellen von einem Katalog (Backend) */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

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

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

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

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

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

=Erstellen von einem Katalog (Backend)=
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 der Alias genutzt bei den Links
* 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 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

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

==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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

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

Catalog Templates anpassen

2010-07-09T16:28:32Z

MacKP: /* Beispiel Anpassungen */

Catalog Templates anpassen

2010-07-09T16:26:48Z

MacKP: /* Beispiel Anpassungen */

Catalog

2010-07-07T18:22:16Z

MacKP: /* Tipps und Tricks zur Umsetzung */

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 [http://www.tunesien-immobilien.de Immobilienlisten].

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

=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 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!).

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!

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

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

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

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

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

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

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

=Erstellen von einem Katalog (Backend)=
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 der Alias genutzt bei den Links
* 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.}}
* 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)
** 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 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)

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

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

===URL===
Der Feldtyp URL hat keine besonderen Parameter. Er dient lediglich der Ein- und Ausgabe einer URL.

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

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

===Bewertungen===
Die Besucher der Internetseite können bei Angabe eines solchen Feldtypes eine Bewertung vornehmen
* ajaxratingfield (Angabe von maximalen Punkten die ein Besucher vergeben kann)

===Zugriffszähler===
Ohne Optionen. Hiermint wird einfach gezählt und ausgegeben wie oft auf dieses Item zugegriffen wurde. Es ist auf ein Klick per IP pro 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.

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

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 Filds (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 Select- oder Tagfield aus dem gewählten Katalog.
* 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)
* 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.

=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?==
<pre><?php print_r($this->entries); ?></pre>
Damit bekommt man das komplette Array ausgegeben.

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

==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 brauchst 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)'''

==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" 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 bei den "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)

==Items im Backend verschieben==
Damit man Items im Backend verschieben kann darf man '''nicht''' die Sortierungs Option bei einem Feld eingeschaltet haben (Backend Filter Einstellungen > Sortiereung-Dropdown aktivieren)

==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 ->
<pre>FIND_IN_SET(7, kategorie)</pre>
D.h.: es soll innerhlab von kategorie nach der ID 7 gesucht werden.

==Formatierung von Zahlen in den Backend Einstellungen==

Um Zahleneingaben zu formatieren, wird mit php gearbeitet.

Hier finden sich Anleitungen dazu -> [http://php.net/manual/en/function.money-format.php]

Beispiel:
* Zahleneingabe -> 1023934
* Formatierung -> <nowiki>2, ',', ' ' </nowiki>
* Ausgabe -> 10.239,34

==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:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('{{date::Y}}-01-01') AND UNIX_TIMESTAMP('{{date::Y}}-12-31')</pre>
So kommt man an die Daten des aktuellen Jahres, um die Daten von 2009 auszugeben:
<pre>meinedatumsvariable BETWEEN UNIX_TIMESTAMP('2009-01-01') AND UNIX_TIMESTAMP('2009-12-31')</pre>

==Mit DCA Felder besser einschränken==
Inzwischen ist es möglich Felder über DCA zu steuern. Der Vorteil: dadurch kann man wesendlich besser Fehleingaben abfangen.
Hier unter 'Felder' kann mna 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:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['readonly'] = true;

Oder die Eingabe von einer E-Mail überprüfen:
$GLOBALS['TL_DCA']['tabellenname']['fields']['spaltenname']['eval']['rgxp'] = 'email';

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

Catalog mit Frontend-Editing und Workflow erstellen

2010-07-04T11:12:02Z

MacKP: /* Katalog-Edit */

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

=Kurzbeschreibung=
Hier geht es darum, wie man Items im Frontend erstellen und bearbeiten kann. Anhand eines Immobilienkataloges wird auch noch die Einrichtung eines Workflows vorgestellt. Zum Schluss soll es dem Besucher der Seite noch möglich sein Kontakt zu dem Seitenbetreiber aufzunehmen (mithilfe eines Formulars bei dem Item).
Hier bei dem Beispiel werden exemplarisch zwei Arten von Immobilien angelegt (Haus zum Kaufen und Hotelzimmer).
Bei diesem Beispiel ist die Backend-Ansicht von den Items nicht wirklich wichtig und wurde auch vernachlässigt, da alle Items über das Frontend verwaltet werden.

=Benötigte Erweiterungen=
* catalog
** backend_filterwiz
** backend_tabletree
** DC_DynamicTable
** taxonomy
* catalogitemuseridfield (für den Workflow wichtig, da damit die Items dem User zugewiesen werden)
* catalog_mailer (hier gibt es im Moment noch das Problem einer blöden abhängigkeit von catalog_ext. also noch nicht installieren!)

=Voraussetzungen für das Tutorial=
* wie ein Katalog erstellt wird sollte von anderen Tutorials klar sein und man sollte die Beschreibung der einzelnen Felder gelesen haben.
* Erstellung von Taxonomie
* der Umgang mit Contao sollte bekannt sein
** Seitenstruktur bearbeiten
** Module anlegen
** Templates bearbeiten
** Mitgliederbereich einrichten (für 2 Gruppen:Makler und Makler-Admins)

=Erstellen der Grundlagen im Backend=

==Erstellung von neuen Seiten in der Seitenstruktur==

* Startseite (Hier wird catalogfeatured eingesetzt)
** Immobilien Liste (Filter und Liste der Immobilien)
*** Immobilien Details (die Detailseite von einem Item)
* Geschützer Bereich
** Immobilien Anlegen (Für normale Makler)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten
** Immobilien Anlegen Administration (Für Makler-Admins)
*** Haus zum kaufen Liste
**** Haus zum kaufen anlegen / bearbeiten
*** Hotelzimmer Liste
**** Hotelzimmer anlegen / bearbeiten

[[Datei:cat-fe-wf-sitestructure.png|Cat Sitestructure]]

==Taxonomie (Bedingung)==

Die Taxonomien sind für die Kategorien und für die Gebiete der Items

Man erstellt sich zuerst die Kategorien und die Optionen. Wobei man hier wie bei einem Baum Verschachtelungen vornimmt:

* Immobilien
** Immo Art
*** Haus
**** Miethaus
**** Ferienhaus
**** Haus zum kaufen
*** Hotel
**** Hotelzimmer
** Immo Gebiete
*** Bizerte
*** Jendouba
*** Beja
*** etc.

Das Ergebniss sollte ungefähr so aussehen wie auf diesem Bild:

[[Datei:cat-fe-wf-taxonomy.png|Cat Taxonomy]]

==Erstellen von einem Katalog mit Feldtypen==

===Neuer Katalog===

Zuerst erstellt man mit einem Klick auf Neuer Katalog einen neuen Katalog und stellt den wie folgt ein:
* Name von dem Katalog angeben
* einen Tabellennamen angeben (die Tabelle wird automatisch erzeugt). Bitte '''keine Tabellen mit tl_* anlgegen''', da diese dann von Contao immer als zu löschen vorgemerkt werden beim aktualisieren der Datenbank.
* Alias und Felder veröffentlichen kann erst später angegeben werden, wenn diese Felder vorhanden sind.
* Sprung zur Seite: Angabe der Detailansicht
* Suche - Suchbar -> aktivieren (keine Bedingung angeben)
* Alle weiteren Einstellungen werden erst später vorgenommen.

[[Datei:cat-fe-wf-newcat1.png|Cat erstellen Bild1]]

[[Datei:cat-fe-wf-newcat2.png|Cat erstellen Bild2]]

===Felder definieren für den Katalog Merkzettel===
Es werden folgende Felder angelegt (Einstellungen die nicht vorgenommen werden, sind nicht aufgelistet):

[[Datei:cat-fe-wf-fields1.png|Cat Felder erstellen]]

[[Datei:cat-fe-wf-fields2.png|Cat Neues Feld]]

{| border="1" cellpadding="20" cellspacing="0"
|+ align="bottom" style="color:#e76700;" |''Feldtypen für die Items''
|-
!Bezeichnung
!Spaltenname
!Typ
!Einstellungen
|-
|Titel
|immo_titel
|text
|
* Sichtbar in der Backend-Listen-Ansicht
* Sortierungs-Dropdown aktivieren
** Sortier-Modus -> Gruppieren anhand der ersten zwei Buschstaben und absteigend
** Backend-Suche aktivieren
* Pflichtfeld
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Alias
|immo_alias_auto
|alias
| * Alias-Titel-Feld -> '''Titel'''
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Benutzer ID
|userid
|Frontend-Benutzer
|-
|Art
|immo_art
|Auswahl
|
* Pflichtfeld
* Tabelle für Optionen -> '''tl_taxonomy'''
* Option Spaltenwert -> '''name'''
* Option Sortierspalte -> name
* Sichtbar in der Backend-Listen-Ansicht
* Die Optinsauswahl individualisieren
** Auswahl der Stamm-Einträge -> Immo Art
** Modus für Unter-Auswahl -> ''Zeigen Sie die Kindelemente von ausgewählten Einträgen ausgeklappt an.'''
** Filter des Elternelements -> leer lassen
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Umgebungsbeschreibung
|immo_umgebung
|langtext
|
* HTML erlauben
* Rich Text
* TinyMCE-Editor-Template -> tinyMCE
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bild
|immo_bild
|file
|
* Sichtbar in der Backend-Listen-Ansicht -> aktivieren
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Produktbild
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Bildergalerie
|immo_bildergalerie
|file
|
* Mehrfach-Auswahl
* Anordnung nach Dateiname (aufsteigend)
* Format Einstellungen
** Als Bildfeld mit Miniaturansicht erstellen
** Bildbreite und -höhe -> 200 / 100 / Exaktes Format
** Links als Dateidownload oder Bilder-Lightbox erstellen -> aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Veröffentlichen
|immo_veroeffentlichen
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|-
|Online
|immo_online
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Hervorheben
|immo_besonders
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Makler-Admin'''
|-
|Immobilie entfernen
|immo_delete
|checkbox
|
* Sichtbar in der Backend-Listen-Ansicht
* Beschriftungsgruppe beginnen -> aktivieren
** Titel der Beschriftung -> Online
** Backend-Filter aktivieren
* '''Gruppen für Frontend-Bearbeitung'''
** '''Beide Gruppen auswählen'''
|}

====Erklärung====
* Natürlich sind hier noch viel mehr Felder und Feldtypen angelegt. Diese paar sollten aber reichen um das prinzip zu verdeutlichen.
** Jede Art hat da ihre eigenen Felder (z.B. ist die Grundstücksfläche für Hotelzimmer nicht wichtig und wird daher dann später nicht mit ausgegeben)
* Bild und die Galerie sind getrennt, damit später in der Listenansicht ein bestimmtes Bild ausgegeben werden kann.
* Die Checkboxen '''Veröffentlichen''', '''Online''', '''Hervorheben''' und '''Immobilien entfernen''' sind besonders wichtig für die Verwaltung der Immobilien.
** Nur Makler-Admins bekommen später die Möglichekeit Immobilien online zu stellen ('''Online''') und diese auf der Startseite anzuzeiben ('''Hervorheben''')

===die Katalog Einstellungen noch einmal überarbeiten===
Da jetzt die Feldtypen definiert wurden, kann man im Katalog selbst noch weiter Einstellungen vornehmen:
* Alias-Feld -> Alias
* Feld veröffentlichen -> NICHTS '''hier nicht angeben, da die Makler im Frontend sonst ihre Items nicht sehen können!'''
* Meta-Title-Feld -> Titel
* Meta-Beschreibungs-Feld -> Umgebungsbeschreibung
* Zeichenkette des Titels formatieren -> <nowiki>{{immo_titel}} - {{immo_gebiet}} - {{immo_art}}<br />
{{immo_bild::w=100&h=80}}</nowiki>

==Einstellen von ein paar Items (Produkten)==
Nun können ein paar Immobilien erstellt werden. Zu beachten ist: diese Immobilien gehören erst einmal '''keinem''' Mitglied. Erst wenn ein Mitglied das Item bearbeitet und speichert ist es ihm Zugeordnet!

[[Datei:cat-fe-wf-new-item1.png|Cat new item1]]

[[Datei:cat-fe-wf-new-item2.png|Cat new item2]]

==Die nötigen Module==

===Katalog-Filter===
Damit die Benutzer und die Mitglieder das angezeigt bekommen was sie wollen, sollte man mit einem Filter die Immobilien Einschränkbar machen.
Damit auch alle die passende Einstellung haben bei der Weiterleitungsseite muss man dieses Modul 3 mal anlegen und jeweils zur passenden Seite mit der Liste weiterleiten (eins anlegen und kopieren erleichtert einem die arbeit enorm *g*)

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Liste (je nachdem für welche Gruppe der Filter gerade erstellt wird)
* Benützen Sie Filterkonditionen des Listers auf der selben Seite -> aktivieren (dadurch sind nur die Filter aktiv, die auch passende Immobilien beinhalten)
* Filter pro Abschnitt aktivieren
** Gebiet -> Auswahlmenü
** Art -> Auswahlmenü
* Such-Filter
** Suchbox aktivieren -> aktivieren
** Kopfzeile suchen -> Suche (h3)
** Suchfelder
*** Alle Felder die man durchsuchbar haben möchte ankreuzen (z.B. Titel, Gebiet, Art, Umgebungsbeschreibung)
* Filter-Layout -> filter_default

===Katalog-Liste===
Nun muss man mehrere Listenmodule anlegen. Einmal eine Liste für die Besucher. Dort sind alle Immobilien vorhanden, die online sind.
Für die Makler und Makler-Admins muss man nun für jede Art eine passende Liste erstellen.
Bei 5 verschiedenen Arten sind das also 5 Listen für Makler, 5 Listen für Makler-Admins.
Zusammengenommen also 11 Listen. Das ganze kann man sicher auch mittels PHP und MySQL etwas zusammenfassen. Hier geht es jedoch darum, das Prinzip aufzuzeigen und jedem zu ermöglichen so einen Katalog ohne viel Programmierkenntisse anzulegen.

'''Einstellungen:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Suchfelder
*** nach Bedarf anklicken
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung''' Je nach Liste etwas anders:
** Liste für Besucher der Seite: <nowiki>immo_online=1 and immo_freigeben=1 and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items, die online sind, die freigegeben sind und die nicht Entfernt sind (also als solche Markiert)
** Liste für Makler <nowiki>immo_art='136' and immo_delete!='1' AND (userid={{user::id}} OR userid=0)</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt wo die UserID gleich der eigenen oder keiner ist (alle Items von dem Mitglied und Items die noch keinem zugeordnet sind)
** Liste für Makler-Admin <nowiki>immo_art='136' and immo_delete!='1'</nowiki> Das bedeutet -> Zeige alle Items der Art 136 (ID der Taxonomie 'Haus zum kaufen'), und nicht Entfernt sind an. Hier wird nicht die UserID abgefangen! Dadurch können Makler-Admins alle Immobilien sehen.
** Elemente pro Seite -> 6
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_cataloglist

===Katalog-Leser===
Hiervon gibt es nur ein Modul. Die Makler und Makler-Admins bekommen das Modul Katalog-Edit.
Die Ausgabe der verschiedenen Arten und deren besonderheit regel ich über das Teplate mit einer extra if-Abfrage (lasse also nur die Felder anzeigen, die überhaupt einen Inhalt haben).

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Umgebungsbeschreibung
* Template-Einstellungen
** Katalog-Layout -> catalog_full
** Katalog-Template -> mod_catalogreader

===Katalog-Featured===
Hiermit werden die hervorgehobenen Items auf der Startseite dargestellt.

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Abfrage-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
** Tags-Modus -> Alle Treffer (AND) - so werden nur die Immobilien angezeigt, die der Region, der Art '''und''' der Suche entsprechen!
* '''Bedingung'''
** <nowiki>immo_online=1 and immo_besonders and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online, besonders und nicht Entfernt sind.
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogfeatured

===Katalog-Related===

Hiermit werden ähnliche Immobilien auf der Detailseite einer Immobilie angezeigt. Übereinstimmen muss in diesem Beispiel nur das Gebiet. Bei vielen Items sollte die Liste hier weiter eingeschränkt werden (Sinnvoll wäre zum Beispiel die Art der Immobilie)

* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Sichtbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Bild
** Art
* Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Ich möchte hier aber den Titel und das Bild verlinkt haben)
** Titel
** Bild
* Feld-Filter
** Betroffene Felder, die übereinstimmen müssen -> Gebiet
** Anzahl der Tags die zusammengehöhren müssen -> 0 (macht nur sinn bei mehreren. Dann werden nur Items angezeigt, die zum Beispiel 2 Gleiche Felder haben bei der Angabe von 2)
** '''Bedingung''' -> <nowiki>immo_online=1 and immo_delete!='1'</nowiki> Das bedeutet, das hier nur Immobilien angezeigt werden, die Online und nicht Entfernt sind.
** Anzahl der Einträge -> 5
* Template-Einstellungen
** Katalog-Layout -> catalog_simple
** Katalog-Template -> mod_catalogrelated

===Katalog-Edit===
Hier sind wieder mehrere Module nötig.

Für Makler in jeder Art eins -> 5

Für Makler-Admins -> 5

(für jede Art, da die sich ja wie oben genannt in den Feldern unterscheiden)

'''Felder die einen Standardwert bekommen dürfen nicht bearbeitet werden können!'''

Außerdem lasse ich das Alias Feld nicht bearbeiten, damit da keine unschönen Aliase generiert werden.

'''Einstellungen für Makler:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Benutzer id [userid:useridfield]''' (Nur dadurch wird die ID des Maklers erfasst. Wird aber nicht im Frontend angezeigt)
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)
** '''Online -> nein'''

'''Einstellungen für Makler-Admins:'''
* Modul-Konfiguration -> Katalog -> Immobilien (den gerade eben erstellen Katalog auswählen)
* Weiterleitungsseite -> Immobilien Details
* Bearbeitbare Felder (in diesem Beispiel):
** Titel
** Gebiet
** Art
** Bild
** Bildergalerie
** Umgebungsbeschreibung
** Veröffentlichen
** Immobilie entfernen
** '''Online'''
** '''Hervorheben'''
* Weiterleitungsseite -> auf die jeweilige Liste (Makler oder Makler-Admin)
* Sicherheitsabfrage deaktivieren (da die Seiten ja nur von Mitgliedern benutzt werden können. Ist bei öffenltich Zugänglichen Catalog-Edit-Modulen nicht zu empfehlen!)
* Auf Standardwerte beschränken
** Eingeschränkte Felder -> aktivieren
*** Art
*** Online
** Standardwerte für eingeschränkte Felder
** Art -> Haus zum kaufen oder Hotelzimmer (kommt auf das Modul an welches man gerade anlegt)

Mit diesen unterschiedlich eingestellten Katalog-Edit Modulen erreichen wir den Workflow:

Makler können eine Immobilie bearbeiten und neu anlegen. Die Immobilie können Makler aber nicht online stellen oder hervorheben. Beim Bearbeiten wird durch den Standardwert Online=nein die Immobilie offline gestellt.

Makler-Admins können Immobilien bearbeiten und neu anlegen. Die Immobilien können von Makler-Admins online gestellt werden und hervorgehoben werden (diese können ja die Felder sehen und bearbieten, die dafür zuständig sind).

[[Datei:cat-fe-wf-modules.png|Cat Module]]

==Die Module in Artikeln den passenden Seiten zuordnen==
Nun müssen die Module noch auf die jeweils passende Seite gebracht werden:

* Startseite -> Catalog-Featured
** Immobilien Liste -> Catalog-Filter und Catalog Liste (für Besucher!)
*** Immobilien Details -> Catalog-Leser
* '''Geschützer Bereich'''
** Immobilien Anlegen -> mit Navigation für die Unterseiten (Für Makler und Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit
** Immobilien Anlegen Administration -> mit Navigation für Unterseiten (Für Makler-Admins)
*** Haus zum kaufen Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Haus zum kaufen anlegen / bearbeiten -> Catalog-Edit
*** Hotelzimmer Liste -> Catalog-Liste mit Verweis auf Catalog-Edit
**** Hotelzimmer anlegen / bearbeiten -> Catalog-Edit

Ich kann nur aus eigener Erfahrung sprechen: Spätestens jetzt ist man froh, wenn man eine Eindeutige Benennung der Module vorgenommen hat! Hier muss man mit vielen ähnlichen Modulen arbeiten und da ist es auf dauer sehr mühselig, wenn man nicht auf den 1. Blick erkennen kann was es ist.
Ich selber benenne die Module daher zum Beispiel so: 'Katalog - Makler - Edit - Haus zum kaufen'
Dadurch ist die automatische Sortierung im Backend außreichend gut. Man sieht was für ein Modul es ist (Katalog) für welche Gruppe es ist (Makler) was genau es machen soll (Edit) und für welchen Bereich es gedacht und eingestellt ist (Haus zum kaufen).

==Templates==
Tutorial zum Anpassen der Templates : [[Catalog_Templates_anpassen|Catalog Templates anpassen]]

----

--[[Benutzer:MacKP|MacKP]] 14:52, 18. Mai 2010 (UTC)

Mootools Aufklappmenü MenuMatic

2010-06-29T20:06:32Z

MacKP: /* Vorgehen: */

{{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.

==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):
Code:

<nowiki><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>
</nowiki>
'''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:
Code:
<nowiki>

<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></nowiki>

(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:
<nowiki>var myMenu = new MenuMatic({ orientation:'vertical' });</nowiki>

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

2010-06-29T20:06:09Z

MacKP: /* Vorgehen: */