Version vom 29. Mai 2010, 08:27 Uhr

betrifft
TYPOlight Version	ab 2.8
Contao Version	ab 2.9

Extensions	Catalog ab 2.0beta1

Inhaltsverzeichnis

1 Kurzbeschreibung
2 Benötigte Erweiterungen
3 Voraussetzungen für das Tutorial
4 Erstellen der Grundlagen im Backend

Kurzbeschreibung

Mit einem Merkzettel ist es möglich einem Benutzer eine Auswahl von Varianten zu einem Produkt anzugeben, aus welchen er auswählen kann um sich diese dann auf eine Merkliste zu setzen. Die Merkliste kann zum Schluss an eine beliebige Email versendet werden.

Hier werden exemplarisch Items angelegt, die maximal 3 Optionen zur Auswahl haben.

Benötigte Erweiterungen

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
- Formulare erstellen
- Seitenstruktur bearbeiten
- Module anlegen
- Templates bearbeiten

Erstellen der Grundlagen im Backend

Erstellung von neuen Seiten in der Seitenstruktur

Seitenstruktur

Startseite von der Merkliste (Hier werden die Kategorien erscheinen)
- Merkzettel Liste (die Listen mit den Items aus einer Kategorie)
  - Merkzettel Leser (die Detailseite von einem Item)
Ihr Merkzettel (Seite zum Anzeigen von dem Merkzettel)
- Angebot angefordert (Seite die erscheint, wenn man über den Merkzettel ein Angebot angefordert hat)

Taxonomie (Bedingung)

Ergebnis der Tags

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

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

Merkzettel
- kategorien
  - Laminat
    - Laminat-Doppelstufen
    - Montageprofile
    - Laminatboden
  - Massivholz
    - Massivhilz-Doppelstufen
    - Holzstufen-Zubehör
    - Wangenverkleidung
- Optionen
  - Material
    - Metall
    - Plastik
    - Gold
  - Größe
    - 80cm
    - 100cm
    - 120cm
  - Maße
    - 2600 x 22 x 40 mm
    - 2600 x 22 x 80 mm
    - 2600 x 22 x 120 mm

Das Ergebniss sollte ungefähr so aussehen wie auf dem Bild rechts.

Erstellen von einem Katalog mit Feldtypen

Neuer Katalog

Katalog Merkzettel ohne "Suche aktivieren"

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.

Felder definieren für den Katalog Merkzettel

Screenshot der Felder

Es werden folgende Felder angelegt (Einstellungen die nicht vorgenommen werden, sind nicht aufgelistet):

*Feldtypen für die Items*
Bezeichnung	Spaltenname	Typ	Einstellungen
Name	produkt_name	text	Sichtbar in der Backend-Listen-Ansicht Sortierungs-Dropdown aktivieren Sortier-Modus -> Gruppieren anhand des Anfangsbuchstabens und absteigend Backend-Filter aktivieren Backend-Suche aktivieren Pflichtfeld
Alias	produkt_alias	alias	* Alias-Titel-Feld -> Name
Kategorie	produkt_kategorie	select	Tabelle für Optionen -> tl_taxonomy Option Spaltenwert -> name Option Sortierspalte -> leer lassen Die Optinsauswahl individualisieren Auswahl der Stamm-Einträge -> Optionen aktivieren Modus für Unter-Auswahl -> Baum nur mit auswählbaren Kindeinträgen Filter des Elternelements -> leer lassen
Beschreibung	produkt_beschreibung	langtext	HTML erlauben Rich Text TinyMCE-Editor-Template -> tinyMCE
Produktbild	produkt_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
Galerie	produkt_galerie	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
Option 1 auswählen	produkt_optionen_1_check	checkbox	Beschriftungsgruppe beginnen -> aktivieren Titel der Beschriftung -> Optionen
Option 1	produkt_option_1	tags	Kontroll-Checkbox -> Option 1 auswählen Tabelle für Optionen -> tl_taxonomy Option Spaltenwert -> name Option Sortierspalte -> leer lassen Die Optionsauswahl individualisieren -> aktivieren Auswahl der Stamm-Einträge -> Optionen (die Gruppe, welche in Taxonomien eingerichtet wurde) Modus für Unter-Auswahl -> Baum nur mit auswählbaren Kindeinträgen
Option 2 auswählen	produkt_optionen_2_check	checkbox	keine weiteren Einstellungen
Option 2	produkt_option_2	tags	Kontroll-Checkbox -> Option 2 auswählen Tabelle für Optionen -> tl_taxonomy Option Spaltenwert -> name Option Sortierspalte -> leer lassen Die Optionsauswahl individualisieren -> aktivieren Auswahl der Stamm-Einträge -> Optionen (die Gruppe, welche in Taxonomien eingerichtet wurde) Modus für Unter-Auswahl -> Baum nur mit auswählbaren Kindeinträgen
Option 3 auswählen	produkt_optionen_3_check	checkbox	keine weiteren Einstellungen
Option 3	produkt_option_3	tags	Kontroll-Checkbox -> Option 3 auswählen Tabelle für Optionen -> tl_taxonomy Option Spaltenwert -> name Option Sortierspalte -> leer lassen Die Optionsauswahl individualisieren -> aktivieren Auswahl der Stamm-Einträge -> Optionen (die Gruppe, welche in Taxonomien eingerichtet wurde) Modus für Unter-Auswahl -> Baum nur mit auswählbaren Kindeinträgen
Merkliste	produkt_merkliste	Merkliste und Varianten	notelistvariants -> Alle Optionen Auswählen und in die passende Reihenfolge bringen (Option 1 / Option 2 / Option 3) Beschriftungsgruppe beginnen -> aktivieren Titel der Beschriftung -> Merkliste und Zusätzliche Angaben
Online	produkt_online	checkbox	Sichtbar in der Backend-Listen-Ansicht Beschriftungsgruppe beginnen -> aktivieren Titel der Beschriftung -> Online Backend-Filter aktivieren

Erklärung

Produktbild und die Galerie sind getrennt, damit später in der Listenansicht ein bestimmtes Bild ausgegeben werden kann.
die Checkboxen 'Option 1 auswählen' etc. sind nur für die Übersicht beim Eingeben eines Items im Backend.
Nur wenn Felder Sichtbar in der Backend-Listen-Ansicht sind, werden diese auch bei der Zeichenkette des Titels formatieren angezeigt.

die Katalog Einstellungen noch einmal überarbeiten

Catalog editieren

Da jetzt die Feldtypen definiert wurden, kann man im Katalog selbst noch weiter Einstellungen vornehmen:

Alias-Feld -> Alias
Feld veröffentlichen -> Online
Meta-Title-Feld -> Name
Meta-Beschreibungs-Feld -> Beschreibung

Zeichenkette des Titels formatieren:

<strong>{{produkt_name}}</strong> - <em>{{produkt_online}}</em><br />{{produkt_bild::w=100&h=80}}

Einstellen von ein paar Items (Produkten)

Nun können ein paar Produkte erstellt werden. Zu beachten ist: Die Optionen müssen einzeln ausgewählt werden, da es sich um den Feldtyp Tags handelt. Dadurch ist es möglich in Taxonomie selber die Gruppierung nicht für jedes Produkt extra zu machen, sondern allgemeine Gruppen. Denn nicht jedes Produkt ist zum Beispiel in dem Material 'Gold' vorhanden.

Formularansicht 1. Screenie
Formularansicht 2. Screenie
Formularansicht 3. Screenie

Erstellen von einem Formular

Mit Hilfe von dem Formulargenerator legt man nun ein neues Formular an:

Feldtyp -> Katalog-Merkliste
- Feldname -> produkt_merkliste (frei wählbar)
- Feldbezeichnung -> nichts angeben (diese hat an dieser Stelle keinen Sinn)
- Text -> Ihre Merkliste
- Katalog -> Merkzettel (den Katalog mit den angelegten Items auswählen)
- Sichtbare Felder -> Name / Merkliste / Produktbild (Reihenfolge ist beliebig, kann auch über das Template bestimmt werden)
  - Varianten nicht auswählen, da diese schon mit diesem Feldtypen ausgegeben werden.
alle Weiteren Feldtypen die man braucht / haben möchte bei dem Formular. Als Beispiel:
- Überschrift -> Fordern Sie jetzt Ihr Angebot an!
- Select-Menü -> Anrede
- Textfeld -> Vorname
- Textfeld -> Nachname
- Texterea -> Anmerkungen
- Sicherheitsabfrage -> Wichtig!
- Absendefeld

Formulargenerator 1. Screenie
Formulargenerator 2. Screenie

Die nötigen Module

Katalog-Navigation

Hier wird einfach nur die Navigation genutzt um die Kategorien Auswahl zu ermöglichen.

Zum besseren Verständnis kann man sich das Navigationsmodul noch mal ansehen

Einstellungen:

Modul-Konfiguration -> Katalog -> Merkzettel (den gerade eben erstellen Katalog auswählen)
Weiterleitungsseite -> Merkzettel Liste
Navigations-Feld -> Kategorie [produkt_kategorie:select]
Startlevel 0
Stoplevel 0
Template-Einstellunen
- nav_default
- mod_catalognavigation

Katalog-Liste

In dieser Liste werden die Produkte als Liste ausgegeben. Da das Menü vorgeschaltet ist, sind diese nach Kategorien gefiltert.

Einstellungen:

Modul-Konfiguration -> Katalog -> Merkzettel (den gerade eben erstellen Katalog auswählen)
Weiterleitungsseite -> Merkzettel Details
Sichtbare Felder (in diesem Beispiel):
- Name
- Kategorie
- Produktbild
Standard-Link überschreiben (normalerweise wird ein Links 'Details' erzeugt. Hier soll aber der Name und das Bild verlinkt sein.)
- Name
- Produktbild
Feld-Filter
- Suchfelder
  - Name
  - Kategorie
  - Beschreibung
  - Option 1
  - Option 2
  - Option 3
- Abfrage-Modus -> Alle Treffer (AND) - in dem Fall egal, da nur eine Kategorie ausgewählt werden kann
- Tags-Modus -> Alle Treffer (AND) - in dem Fall egal, da nur eine Kategorie ausgewählt werden kann
- Elemente pro Seite -> 10
Miniaturbild-Übersteuerung (um das Bild in der Liste in einer anderen Liste größer darzustellen)
- Bildgröße überschreiben
  - Bildfeld (einfach) -> Produktbild
  - Bild-Breite und Höhe (einfach) -> 100/50 Exaktes Format
Template-Einstellungen
- Katalog-Layout -> catalog_simple
- Katalog-Template -> mod_cataloglist

Katalog-Leser

Modul-Konfiguration -> Katalog -> Merkzettel (den gerade eben erstellen Katalog auswählen)
Weiterleitungsseite -> Merkzettel Details
Sichtbare Felder (in diesem Beispiel):
- Name
- Kategorie
- Produktbild
- Beschreibung
- Produktbild
- Galerie
- Merkliste Wichtig: Sonst kann man die Optionen nicht auswählen
Template-Einstellungen
- Katalog-Layout -> catalog_full
- Katalog-Template -> mod_catalogreader

Die Module in Artikeln den passenden Seiten zuordnen

Nun müssen die Module noch auf die jeweils passende Seite gebracht werden:

Startseite von der Merkliste -> Katalog-Navigation
- Merkzettel Liste -> Katalog-Liste
  - Merkzettel Leser -> Katalog-Leser
Ihr Merkzettel -> Formular mit dem Merkzettel
- Angebot angefordert -> Kein Modul. Einfach nur die Seite wie bei einem Normalen Formular.

Templates

Tutorial zum anpassen von den Templates : Catalog Templates anpassen

--MacKP 14:52, 18. Mai 2010 (UTC)

@@ Zeile 287: / Zeile 287: @@
 * Stoplevel 0
 *Template-Einstellunen
-** nav_merkzettel_liste (Abgewandeltes Template um level_1 als Überschift zu formatieren)
+** nav_default
 ** mod_catalognavigation

Catalog Merkzettel erstellen: Unterschied zwischen den Versionen

Aus Contao Community Documentation