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

1. Start: Installation - Download und Installation von MetaModels
2. Beispiel 1: Backend einrichten - MetaModel erstellen, Daten erfassen
3. Beispiel 2: Frontend einrichten - Die Inhalte im Frontend anzeigen (Liste und Detail)
4. Beispiel 3: Weitere Filter einrichten – Inhalte auf Published setzen, einfache Select-Filter
5. Beispiel 4: Weiteres MetaModels einrichten - komplexe Select-Filter einsetzen
6. Weiteres Beispiel: Übersetzter select - Mehrsprachiges Select-Attribut einrichten

Seiterstruktur anpassen

In der Seitenstruktur zwei leere Seiten einrichten

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

Wir steigen nun wieder bei MetaModels bei Musicbox ein und gehen zur MM-Backend Funktion: Filter

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).
• Klick auf neu.
• Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend) und speichere.
• Die Filterübersicht zeigt nun diesen Eintrag. Wähle das rechte Icon Filterattribute für Filtereinstellung definieren.
• Klick auf neu und wähle das Icon (mit Pfeil) für einsetzen.
• Nun kannst du den Typ auswählen. Wir wählen Einfache Abfrage.
• Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit.
• Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default".
• "Speichern und Schliessen".

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.

Wichtig: wenn als 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.)

Detail-Link anpassen

Standardmässig wird am Ende des Items ein Link namens "Details" generiert. Dieser lässt sich umbenennen. Hierzu kann man bei '/system/config/langconfig.php' folgende Anpassungen machen. 3 Beipiele...

$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';

1. Fall: Jeder Link in MetaModels wird zu '... mehr Details' umbenannt
2. Fall: Nur die Links in der MetaModel-Tabelle 'mm_meineTabelle' wird zu 'weiter...' umbeannt
3. Fall: Interessant, wenn man von der BE Detailansicht zurück zur BE Listenansicht gelangen will. In diesem Fall kann man nicht nur die MM Tabelle angeben, sondern auch die id der Rendereinstellung angeben. Beispiel:

<?php 
/* Put your custom configuration here */ 
$GLOBALS['TL_LANG']['MSC']['mm_musicbox']['details'] = 'Details';
$GLOBALS['TL_LANG']['MSC']['mm_musicbox'][10]['details'] = 'Zurück zur Liste';
?>

Listenansicht erstellen

Wähle die MM-Backend-Funktion "Ausgabevorgaben"

• Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" an. Wir klicken auf "neu"
• Gib den Namen "FE Listenansicht" an
• Als Template wählen wir "metamodel_prerendered (global scope)"
• Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
• Unter Filter settings wählen wir den vorhin definierten Filter "FE Link Detail".
  (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 legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

Attribute zur Listenansicht hinzufügen

• Klick auf das Icon rechts Attribute hinzufügen
• Wähle "Add all" (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.

Detailansicht erstellen

Wähle die MM-Backend-Funktion "Ausgabevorgaben" (aka Rendereinstellungen).

• 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 eine Filter angegeben werden, wenn man einen Link "Zurück" generieren will
• Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.

• BE Listenansicht
• FE Detailansicht
• FE Listenansicht

Attribute zur Detailansicht hinzufügen

Das Vorgehen ist analog zum Punkt 4 zu verstehen. Einzig, dass wir hier am Ende alle Attribute anzeigen lassen (inkl. Bild und Beschreibung).

Frontend-Module erstellen

Hinweis: Einige Einstellmöglichkeiten in den nachstehend beschriebenen Modulen sind erst nach einer Zwischenspeicherung des Moduls erreichbar.

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

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.

Frontend-Module einbinden und Seitenvorschau

Zum Schluss bindet man die beiden Frontend-Module in den gewünschten Artikel ein. Done.

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 hier

HTML-Konstrukt

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

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

Zurück zur Beispiel 1 | Weiter zum Beispiel 3: Weitere Filter hinzufügen