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

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

Eine leere Datenbank erstellen

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.

MetaModels Backend-Funktionen

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

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.

1. Attribute (Attribute für MetaModel ID x definieren)
2. Ausgabevorgaben (Render-Einstellungen für MetaModel ID x definieren)
3. Eingabemaske (Eingabemaske für das MetaModel ID x definieren)
4. Filter (Filter für MetaModel ID x definieren)
5. 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

Hier erfasst man die benötigen Felder für die Eingabe. s. allgemeine Infos zu den Attributen

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
Bis jetzt wurde bei keinem der Attribute die Option Unique values aktiviert. 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 (dann muss kein Alias eingegeben werden, wird neu berechnet bei Änderung des Titels) Aliasfelder = Titel

MM-Funktion: Eingabemaske (fka Paletteneinstellungen)

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

BE-Liste

Nach Klick auf Neue Eingabemaske öffnet sich ein 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

Nun wurde eine Eingabemaske 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.

BE-Formular

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]

Folgendes Beispiel zeigt, was man bei der Erfassung des Attributs Titel alles einstellen kann.
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.

MM-Funktion: Zugriffsrechte definieren

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

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

Und so sieht's aus:
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

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