MetaModels Beispiel 2

Aus Contao Community Documentation


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 - Eingeben der Sammlung
  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

Seiterstruktur anpassen

In der Seitenstruktur zwei leere Seiten einrichten

Mm backend seitenstruktur einrichten.png

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

Icons filter.png

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

Mm backend filter einrichten.png

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)
  • Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon Filterattribute für Filtereinstellungen 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.

Listenansicht erstellen

Icons ausgabevorgaben.png

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

Mm backend FE Listenansicht einrichten.png
  • Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" an. Wir klicken auf "neu"
  • Gib den Namen "FE Listenansicht" an
  • Als Template wähen wir "metamodel_prerendered (global scope) an.
  • 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.
  • Als Filtersettting 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

Mm backend FE Listenansicht einrichten2.png
  • 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

Icons ausgabevorgaben.png

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

Mm backend FE Detailansicht einrichten.png
  • 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
  • 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

Mm backend FE Detailansicht einrichten2.png

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.png Hinweis: Einige Einstellmöglichkeiten in den nachstehend beschriebenen Modulen sind erst nach einer Zwischenspeicherung des Moduls erreichbar.
Mm backend FE-Module Liste.png

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
Mm backend FE-Module Detail.png

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

Mm backend FE-Module einsetzen.png

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

Mm frontend beispiel.png

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

Ansichten
Meine Werkzeuge

Contao Community Documentation

ich hook' mich gleich in die Abstraktion

Martin Mildner
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge