Attribute

Bemerkung

eigene Spalten der Datenbanktabelle als Attribute erstellen und diese konfigurieren
Zum Anlegen der Attributsspalten in der mm_*-Tabelle eine DB-Migration durchführen - siehe Schemamanager

Einleitung

Die Komponente „Attribute“ ist eine der grundlegendsten Einstellung in einem MetaModel. Mit den Attributen werden die eigenen, spezifischen Datenfelder definiert und in der Datenbanktabelle als Spalten angelegt.

Bei der Erstellung eines Attributs „ Neues Attribut“ sind als Pflichtfelder die Auswahl des Attributtyps sowie die Eingabe des Spaltennamens definiert - der Spaltenname definiert, wie der Name schon sagt, die Bezeichnung der Spalte in der Datenbanktabelle. Als zusätzliche Eingaben können ein Name und eine Beschreibung ausgefüllt werden, die auch als Bezeichnung und Beschreibung in der Eingabemaske erscheinen.

Warnung

Beim Ändern des Attributtyps werden, wie auch beim Löschen des Attributs, die bisher eingegebenen Werte in der Datenbank gelöscht! Muss dennoch ein Attributtyp bei Behalt der Werte geändert werden, sollte dies direkt auf der Datenbankebene z.B. über Export/Import der Attribut-Spalte per CSV begleitet werden. Ein geändertes Attribut sollte bei den Render-Einstellungen und Eingabemasken anschließend nochmal neu hinzugefügt werden.

Je nach Attributtyp stehen nach einem Neu laden der Seite weitere Eingabemöglichkeiten bzw. Optionen zur Verfügung. Folgend eine Aufstellung der Attributtypen mit Hinweisen zu den spezifischen Optionen:

• Alias: Alias-Feld z.B. für URLs
  der Alias kann als Kombination von verschiedenen (vorhandenen) Attributen erstellt werden; als Option kann die Neuerstellung des Alias bei Änderungen der Ursprungs-Attribute erzwungen werden (Neuerstellung des Alias erzwingen); ein Alias wird nicht automatisch als eindeutiger Wert erstellt - dafür ist eine Aktivierung der Checkbox „Eindeutige Werte“ notwendig

• Kontrollkästchen (Checkbox): einzelne Checkbox für Boolsche-Werte
  mit der Checkbox können Boolsche-Werte (0|1) gesetzt werden; eine spezielle Variante ist das „Veröffentlichen“ - damit erscheint im Backend das Icon „Auge“ wobei die Filterung für die Veröffentlichung selbst erstellt werden muss; als Spaltenname für den Wert Veröffenlichung wird allgemein „published“ verwendet; über die Option „Listview checkbox“ kann ein eigenes Icon im Backend zur Anzeige des Status Verwendung finden

• Kombinierte Einträge: Kombination verschiedener Attribute
  alle vorhandenen Attribute sowie die „System-Attribute“ wie ID, PID usw. können zu einem neuen Attribut kombiniert werden; die Kombination erfolgt über eine sprintf-Formatierung; z.B. können die beiden Attribute „Name“ und „Vorname“ per Anweisung „%s, %s“ zu „Name, Vorname“; mit der Option „Aktualisierung erzwingen“ wird die Neuerstellung bei Änderungen der Werte erzwungen

• Land: Länderauswahl
  mit dem Attribut steht eine Länderauswahl zur Verfügung; die Auswahl der Länder kann mit der Option „Verfügbare Länder filtern“ eingegrenzt werden

• Dezimal: Dezimalzahlen
  das Attribut ist zur Speicherung von Dezimalzahlen wie Geldbeträge einzusetzen; es gibt zwei Dezimalstellen

• Datei: Dateipicker
  mit dem Attribute „Datei“ steht ein Dateipicker zur Auswahl von einer Datei bzw. wenn die Option „Mehrfachauswahl“ gesetzt ist von mehreren Dateien zur Verfügung; mit der Option „Passen Sie den Dateibaum an“ können während der Auswahl weitere Dateioptionen gesetzt werden; bei der Verwendung bei Bildern ist zu beachten, dass für eine (direkte) Anzeige von Vorschaubildern im Backend bzw. im Frontend die Option „Als Bildfeld mit Vorschaubild benutzen“ in den Render-Einstellungen des Dateiattributs gesetzt werden muss

• Sprachschlüssel: Auswahl von ISO-Sprachcodes
  mit dem Attribut steht eine Auswahl von Sprachcodes zur Verfügung; die Sprachcodes können per Checkbox ausgewählt werden

• Langtext: Texteingabe
  Attribut für längere Texteingaben

• Numerisch: Eingabe von ganzzahligen Werten (Integer)

• Einzelauswahl [select]: Relation (1:n) zu einer weiteren Tabelle von MetaModels oder Contao
  mit dem Attribut „Auswahl“ wird eine 1:n-Relation zu einer weiteren Tabelle erstellt; das kann sowohl eine MetaModels-Tabelle sein als auch jede andere Tabelle aus Contao z. B. tl_member

• Text-Tabelle: Eingabe von Werten als Tabelle
  mit dem Attribut „Text-Tabelle“ wird eine Anzahl von Spalten inkl. der Spaltenbezeichnung und Spaltenbreite definiert; in der Eingabemaske können dann beliebig viele Zeilen erzeugt werden z.B. um mehrere URLs oder Telefonnummern zu speichern

• Mehrfachauswahl [tags]: Relation (m:n) zu einer weiteren Tabelle von MetaModels oder Contao
  mit dem Attribut „Auswahl“ wird eine m:n-Relation zu einer weiteren Tabelle erstellt; das kann sowohl eine MetaModels-Tabelle sein als auch jede andere Tabelle aus Contao z. B. tl_page; die Auflösung der Relation erfolgt in einer speziellen Tabelle von MetaModels, so dass für das Attribut keine Spalte in der MetaModel-Tabelle angelegt wird

• Text: einfaches Textfeld

• Datum: Datum bzw. Datum und Uhrzeit
  die Daten werden als Unix-Timestamp gespeichert; bei eigenen SQL-Filterungen müssen ggf. Konvertierungen vorgenommen werden

• URL: Linktext und URL
  Eingabe von externen Links (inkl. „http://“ eingeben) oder über den Seitenpicker interne Links; optional kann mit „Titel entfernen“ nur die URL ausgegeben werden

Ist im MetaModel die Option „Übersetzung“ aktiviert, sind die folgenden Attribute zusätzlich für eine Mehrsprachigkeit vorhanden:

• Übersetzte Checkbox

• Translated kombinierte Werte

• Übersetzte Datei

• Übersetzter Langtext

• Übersetzter Select

• Übersetzter Tabellen-Text

• Übersetzte Tags

• Übersetzter Text

Diese Attribute unterscheiden sich von ihren einsprachigen Attributen im Grunde durch die Eingabe der mehrsprachigen Angaben für Name und Beschreibung. Für die übersetzten Attribute werden spezielle Tabellen der Erweiterung verwendet und nicht die von der MetaModel-Erstellung erzeugten Tabelle.

Zu beachten ist, dass bei Relationen per „Einfachauswahl“ oder „Mehrfachauswahl“ zwischen zwei Metamodel mit Übersetzungen üblicher Weise nicht ddie Optionen „Übersetzter Einzelauswahl [select]“ und „Übersetzte Mehrfachauswahl [tags]“ auszuwählen ist. Das Erkennen bzw. das Umschaltung der Sprache macht MetaModels mit den Attributen „Einfachauswahl“ und „Mehrfachauswahl“ automatisch.

Die beiden „übersetzten Varianten“ sind hauptsächlich für die Anbindung von Tabellen bestimmt, die nicht zu MetaModels gehören und ein eigenständiges Feld für die Sprachvariante besitzen - oder für den Spezialfall, dass bei dem referenzierten MetaModel je nach Sprache unterschiedliche Items ausgewählt werden sollen. Mehr dazu auf einer Sonderseite zur Mehrsprachigkeit - Sponsoren dazu gesucht!

Neben den aufgeführten Attributen können über zusätzliche Erweiterungen von MetaModels auch weitere Attributtypen zur Verfügung stehen. Die Attribute werden über den Composer installiert oder wie normale Contao-Erweiterungen per Kopie in den Ordner „modules“ (je nach Bereitstellung durch Programmierer).

Beispiele für zusätzliche Attribute sind:

• Bewertung: Bewertungsmodul mit Sternen
  das Attributmodul dient zur Ausgabe ein „Sternchen-Bewertung“ im Frontend; im Backend können verschiedene Optionen wie Anzahl der Sterne usw. gesetzt werden

• Color-Picker: Auswahl von Webfarben und Transparenz

• Levenshtein: Wortsuche nach Levenshtein
  mit dem Attribut wird eine Wortähnlichkeit für eine flexible Suche ermittelt

• Länderauswahl: Auswahlliste mit Ländern

• ContentArtikel: Möglichkeit Contao-Contentelemente analog wie ein Artikel in
  einem Widget anzulegen - gibt es auch als übersetzte Variante

• Multi-Tabelle: Ähnlich Attribut „Text-Tabelle“ nur das in jede „Zelle“ ein eigener
  Widgettyp wie Select, Radiobuttons, Checkboxen usw. eingebaut werden kann - gibt es
  auch als übersetzte Variante

• Geo-Entfernung: berechnet bei einer Umkreissuche die geogr. Entfernung zum Suchpunkt
  mit dem Wert können Listen nach der Entfernung sortiert werden

Die Reihenfolge, wie die Attribute angelegt werden, ist frei wählbar - lediglich bei Attributen, die sich auf andere Attribute beziehen wie z.B. der „Alias“ oder „Kombinierte Einträge“ ist eine nachfolgende Erstellung sinnvoll.

Bei den Attributen „Auswahl“ und „Mehrfachauswahl“ müssen zudem erst die zu referenzierenden MetaModel erstellt sein.

Optionen

Zwei Optionen sind bei allen Attributen vorhanden: „Varianten überschreiben“ und „Eindeutige Werte“.

Mit „Varianten überschreiben“ steht das Attribut auch bei den Eingabemasken der Varianteneingabe zur Verfügung. Voraussetzung dafür ist, dass beim MetaModel die Option „Varianten“ gesetzt ist - anderenfalls ist die Checkbox inaktiv.

Mit der Option „Eindeutige Werte“ werden die Attributeingaben auf Eindeutigkeit (unique) geprüft.

Ablauf

Ein neues Attribut wird über „ Neues Attribut“ geöffnet. Nachdem alle notwendigen Optionen eingetragen bzw. ausgewählt sind, wird die Einstellung gespeichert und es erscheint in der Attributliste der vorhandenen MetaModels. Die Reihenfolge in der Liste hat keinen weiteren Einfluss. Datenbank-Migration durchführen!