Contao Community Documentation - Benutzerbeiträge [de]

MetaModels Beispiel 2

2014-02-19T19:20:54Z

AgentK: /* HTML-Konstrukt */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Frontend einrichten=
Wir haben im Backend bereits ein paar Daten (Musikstücke) erfasst und möchten diese nun im Frontend anzeigen lassen. Hierfür benötigen wir eine Übersichtseite (Liste) und eine Detailsansicht. Plus noch eine minimale Navigation, um zwischen Liste und Detailansicht hin- und herklicken zu können.
Hierbei werden wir auch die Filtertechnik von MetaModels einsetzen.

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

=Seiterstruktur anpassen=
== In der Seitenstruktur zwei leere Seiten einrichten==

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

Zuerst richten wir in der Seitenstruktur zwei neue (leere) Seiten ein.

* '''Musicbox''' (diese Seite wird die Listenansicht aufnehmen)
* '''Music''' (diese Seite wird für die Darstellung der Detailansicht verantwortlich sein)

Sowohl MetaModels als auch die später benötigten Frontend-Module werden auf diese Seiten zugreifen müssen, deswegen richten wir diese vorab ein, auch wenn noch kein Inhalt definiert ist.

==Einfachen Filter erstellen==

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

Wir steigen nun wieder bei MetaModels bei '''Musicbox''' ein und gehen zur [[MetaModels_Backend:_Filter|MM-Backend Funktion: Filter]]

[[File:mm_backend_filter_einrichten.png|thumb|400px]]
Hier müssen wir thematisch etwas vorausgreifen, und ein Instrument bereitstellen, das bei der Einrichtung der Frontend-Ansichten in MetaModels benötigt wird: '''Wir brauchen einen Filter'''.
Bei MetaModels haben Filter eine breitere Bedeutung als dies umgangssprachlich der Fall ist. Filter steuern jede Art von Ansichtsdarstellung, sowohl im Backend als auch im Frontend. Aus der Sicht von MetaModels gibt es nicht eine Listen- und eine separate Archivansicht, wie man das z.B. von News oder Catalog her kennt. Für MetaModels ist jede Ansicht eine Listenansicht. Es ist der Filter, der bestimmt ob n Datensätze (aka Liste) oder nur 1 Datensatz (aka Detailansicht) angezeigt wird. Mit anderen Worten: Der Filter und nicht das Frontend-Modul macht den Unterschied.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden)
* Auf '''Neu''' klicken
* Den Namen eingeben, z.B. "FE Link Detail" (FE steht für Frontend) und speichern
* Die Filterübersicht zeigt nun diesen Eintrag. Wähle das rechte Icon ''Filterattribute für Filtereinstellung definieren''.
* Auf '''Neu''' klicken und das Icon (mit Pfeil) für '''einsetzen''' wählen
* Nun kann man den Typ '''Einfache Abfrage''' auswählen
* Das '''Attribut''' Alias auswählen und den URL-Parameter '''auto_item''' eingeben
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als '''Template''' den Standard '''mm_filteritem_default''' auswählen
* Speichern und Schliessen

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

===URL-Parameter auto_item===
[[File:mm_backend_filter_einrichten2.png|thumb|400px]]
Der URL-Parameter '''auto_item''' ist in Kombination mit dem Attribut '''Alias''' dann interessant, wenn man in der URL das '/alias' raushaben möchte.
<source lang="html4strict">
aus...
meineDomain.com/album/alias/born-to-die.html
wird...
meineDomain.com/album/born-to-die.html
</source>

'''Hinweis'''<br>
Wenn der URL-Parameter '''auto_item''' verwendet werden soll, dann muss in den System-Einstellungen im BE im Abschnitt ''Frontend-Einstellungen'' die Option '''Den auto_item-Parameter verwenden''' angehakt sein, sonst erfolgt keine Ausgabe des Details ( =>There are no items matching your search.)

'''Fazit'''<br>
Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.
<div style="clear: both"></div>

==Listenansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Listenansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" an. Auf '''Neu''' klicken.
* Den Namen '''FE Listenansicht''' eingeben
* Als Template '''metamodel_prerendered (global scope)" wählen
* Als '''Zielseite''' die vorhin definierte Seite "Music" angeben. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Unter '''Filtereinstellungen''' wählen wir den vorhin definierten Filter "FE Link Detail".<br>(''sollte der Filter zunächst nicht angezeigt werden, dann hilft =>speichern weiter'')
* Speichern und schliessen
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legt man grob fest, welches Aussehen (Template) die Seite haben soll, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>

'''Hinweis'''<br>
Wenn man hier kein Filter angibt, wird später im Frontend kein '''Details'''-Link erscheinen.<br>

'''Tipp'''<br>
Weitere Infos zum Details-Link siehe [[MetaModels_Beispiel_2#Detail-Link_anpassen|unten]]

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

==Attribute zur Listenansicht hinzufügen==

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

* Klick auf das Icon rechts '''Attribute hinzufügen'''
* Wähle '''Alle hinzufügen''' (geht schneller und einfacher als alle über "Neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]] (aka Rendereinstellungen).

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.
* Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Optional kann auch eine Weiterleitungsseite definiert und ein Filter angegeben werden, wenn man einen Link "Zurück" generieren will
* Speichern und schliessen

'''Tipp'''<br>
Weitere Infos wie man einen Zurück-Link erstellt, siehe [[MetaModels_Beispiel_2#Detail-Link_anpassen|unten]]
<div style="clear: both"></div>

[[File:mm_backend_FE_Detailansicht_einrichten_liste.png|thumb|400px]]
Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

==Attribute zur Detailansicht hinzufügen==

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

Das Vorgehen ist analog zum Punkt 4 zu verstehen. Einzig, dass wir hier am Ende alle Attribute anzeigen lassen (inkl. Bild und Beschreibung).
<div style="clear: both"></div>

==Frontend-Module erstellen==
{{Hinweis|Einige Einstellmöglichkeiten in den nachstehend beschriebenen Modulen sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}
[[File:mm_backend_FE-Module_Liste.png|thumb|400px]]

Frontend-Modul für Listenansicht einrichten:

* Wähle den ''Modultyp'' "MetaModels-Liste" aus
* Wähle das entsprechend ''MetaModel'' aus, in unserem Fall "Musicbox"
* Bei ''Sortieren nach'' und ''Sortierreihenfolge'' das gewünschte Attribut festlegen bzw. ob auf- oder absteigend sortiert werden soll
* ''Anzuwendende Filtereinstellungen'' bleibt vorläuftig leer. Das heißt soviel wie, dass wir in unserer Liste alle Datensätze (Musikstücke), die wir in unserer Musicbox erfasst haben, in der Liste anzeigen möchten
* Bei ''Eigenes Template für Datensatzliste auswählen'' den vorgegebenen Default "mod_metamodel_list" nehmen
* Bei ''Anzuwendende Rendereinstellung'' nehmen wir nun die zuvor definierte Ausgabevoreinstellung "FE Listenansicht". Damit werden nur die Daten der Felder ausgegeben, die wir unter Punkt 9 als sichtbar gekennzeichnet haben, und zwar in der dort definierten Reihenfolge

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

[[File:mm_backend_FE-Module_Detail.png|thumb|400px]]

Dieses FE-Modul richten wir analog dem FE-Modul der Listenansicht ein, allerdings mit zwei wichtigen Unterschieden:

* Bei ''Anzuwendende Filtereinstellungen'' muss nun der Filter "FE Link Detail" angewählt werden. Dieser bewirkt, dass man hier, in der Detailansicht, auch nur den Datenansatz angezeigt bekommt, den man in der Listenansicht angeklickt hatte.
* Bei ''Anzuwendende Rendereinstellungen'' wählen wir die in den Ansichtsdarstellungen definierte Einstellung "FE Detailansicht". Hier werden alle Daten angezeigt, die wir unter Punkt ... als sichtbar angegeben haben. In diesem Falle alle.

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

==Frontend-Module einbinden und Seitenvorschau==
[[File:mm_backend_FE-Module_einsetzen.png|thumb|400px]]
Zum Schluss bindet man die beiden Frontend-Module in den gewünschten Artikel ein.
Done.

<div style="clear: both"></div>
== Detail-Link anpassen==
Wenn der Rendereinstellung für die FE-Ansicht der passende Filter mitgegeben wurde, wird am Ende des Items standardmässig ein Link namens '''Details''' generiert.
Im Standard-Template '''metamodel_prerendered.html5''' sieht der PHP-Code, wo der Link vorkommt, so aus:
<source lang="php">
<?php if ($arrItem['jumpTo']['deep']): ?>
<a href="<?php echo $arrItem['jumpTo']['url']; ?>"><?php echo $this->details; ?></a>
<?php endif; ?>
</source>
Die Bezeichnung des Links lässt sich umbenennen, ohne in das Template eingreifen zu müssen.<br>
Hierzu kann man bei '/system/config/'''langconfig.php'''' folgende Anpassungen machen. 3 Beipiele...
<source lang="php">
$GLOBALS['TL_LANG']['MSC']['details'] = '...mehr Details';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle']['details'] = 'weiter...';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle'][id]['details'] = 'Zurück zur Liste';
</source>
'''1. Fal'''l: Jeder Link in MetaModels wird zu '... mehr Details' umbenannt<br>
'''2. Fall''': Nur die Links in der MetaModel-Tabelle 'mm_meineTabelle' werden zu 'weiter...' umbeannt<br>
'''3. Fall''': Interessant, wenn man von der FE Detailansicht zurück zur FE Listenansicht gelangen will. In diesem Fall kann man nicht nur die MM Tabelle angeben, sondern auch die '''id''' der [[MetaModels_Backend:_Ausgabevorgaben#Einstieg|Rendereinstellung]] angeben.

Beispiel für langconfig.php:<br>
<source lang="php">
<?php
/* Put your custom configuration here */
$GLOBALS['TL_LANG']['MSC']['mm_musicbox']['details'] = 'weiter...';
$GLOBALS['TL_LANG']['MSC']['mm_musicbox'][4]['details'] = 'Zurück zur Liste';
?>
</source>

=Mögliches Endresultat=

==Frontend Ansicht==
Und so könnte es aussehen
* links: Die Daten werden standardmässig in kompakter Form ausgegeben
* rechts: mit etwas CSS lassen sich die Daten sowohl in der Listen- wie Detailsicht gut formatieren
* die Labels lassen sich auch ausschalten. Siehe [[MetaModels_Backend:_Eingabemaske#Backend_Liste_gestalten|hier]]
[[File:mm_frontend_beispiel.png|link=|900px]]

==HTML-Konstrukt==
Die Daten werden über das Template "metamodel_prerendered.html5" ausgegeben. Jeder Datensatz wird als '''item''' ausgegeben, dieser besteht aus den Attributen, die in den Rendereinstellungen definiert wurden. Bei jedem Attribut wird standardmässig '''label''' und '''value''' ausgegeben.

<source lang="html4strict">

<div class="item">
<div class="field attribut1">
<span class="label">Titel des attributs1</span>
<span class="value">Wert des attribut1</span>
</div>
<div class="field attribut2">
<span class="label">Titel des attribut2</span>
<span class="value">Wert des attribut2</span>
</div>
<div class="field attribut3">
...
</div>
</div>
<div class="item">
...
</div>
<div class="item">
...
</div>

</source>

[[MetaModels_Beispiel_1|Zurück zur Beispiel 1]] | [[MetaModels_Beispiel_3|Weiter zum Beispiel 3: Weitere Filter hinzufügen]]

Catalog mit Frontend-Editing und Workflow erstellen

2010-06-11T22:41:27Z

AgentK: /* Katalog-Liste */

{{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
* 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 mit Frontend-Editing und Workflow erstellen

2010-05-26T10:46:18Z

AgentK: /* Felder definieren für den Katalog Merkzettel */

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

=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 TYPOlight 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 TYPOlight 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 (der Standard)

===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 <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_list_gast_immo (Original: catalog_simple)
*** oder -> catalog_list_immo (für Makler und Makler-Admins - muss nicht gemacht werden, ich habe da nur die Klasse der Immobilien verändert, so das ich die Zustände der Immobilien besser sehen kann)
** 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_immo (Original: catalog_full )
** Katalog-Template -> mod_catalogreader_immo (Original: 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_list_gast_immo (Original: catalog_simple)
** Katalog-Template -> mod_catalogfeatured (ist das Original)

===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_list_gast_immo (Original: catalog_simple)
** Katalog-Template -> mod_catalogrelated (ist das Original)

===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
* 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 von den Templates : [http://de.contaowiki.org/Catalog_Templates_anpassen Catalog Templates anpassen]

----

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