Contao Community Documentation - Benutzerbeiträge [de]

MetaModels Beispiel 4

2014-08-07T18:46:54Z

Tschero: /* Frontend-Modul aktualisieren */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Weiteres MetaModel einrichten=
Wer mit Catalog arbeitet, ist es gewohnt, Selects einzusetzen, um Datensätze zu kategorisieren. In unserem Fall wäre es z.B. sinnvoll, unsere Musikstücke bestimmten Stilrichtungen zuzuordnen. <br>
Bei Catalog wird hierfür die Erweiterung [https://contao.org/de/extension-list/view/taxonomy.10089.de.html Taxonomy] eingesetzt, um Hierarchien von Taxonomie-Bedingungen (oder besser bekannt als Tags) zu erstellen, die dann über ein Select bei der Datensatz-Erfassung abgerufen werden können. Im Wesentlichen wird über Taxonomy eine separate Tabelle mit den später abzurufenden Kategorien erfasst. <br>
Mit MetaModels entfällt der Rückgriff auf Taxonomy. Mit MetaModels kann man eigene Tabellen erfassen, die die Einträge der HTML-Selects enthalten.

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

=Neues MetaModel erstellen=

==Leeres MetaModel==
[[File:mm_neues_metamodel.png|thumb|400px]]

Wir beginnen damit, dass wir unter MetaModels ein neues MetaModel anlegen:
* Klick auf '''Neues MetaModel'''
* Wir geben dem neuen MetaModel den Namen '''Musicbox - Stilrichtungen''' und den Tabellennamen '''mm_select_style'''
* Des weiteren aktivieren wir die '''Übersetzung''' setzen als Sprache '''Deutsch''' ein und aktivieren das '''Fallback'''
* Speichern und schliessen
<div style="clear: both"></div>
[[File:mm_neues_metamodel2.png|thumb|400px]]

* Nun steht uns ein neues, leeres MetaModel (mit null Datensätzen) zur Verfügung, das wir mit den Begriffen der benötigten Stilrichtungen füllen können.<br>
<div style="clear: both"><br><br></div>

==MM-Funktion: Attribute==

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

Wir erfassen zuerst die benötigen Attribute für die Eingabe.
[[File:mm_neues_metamodel_attribute.png|thumb|400px]]

Hierzu geben wir folgende Felder ein:
* '''Stilrichtung'''
** Attribute Type= Text
** Column name= style
** Name (deutsch)= Stilrichtung
** Description (deutsch)= Pop, Rock, New Wave, Jazz, etc.

* '''Alias'''
** Attribute Type= Alias
** Column name= alias
** Name (deutsch)= Alias
** Description (deutsch)= Wird für URL benötigt.
** Unique values= aktiviert
** Alias fields= Titel
<div style="clear: both"><br><br></div>

==MM Funktion: Ausgabevorgaben==
[[File:icons_ausgabevorgaben.png|left|32px]]
Es wird eine neue Ausgabevorgabe benötigt.

[[File:mm_neues_metamodel_ausgabevorgaben.png|thumb|400px]]
* Auf '''Neu''' klicken
* Die neue Ausgabevorgabe mit '''BE Listenansicht''' benennen
* speichern und schließen
* über die Attributeinstellungen alle Attribute hinzufügen
* Sichtbarkeit(Auge) herstellen
<div style="clear: both"></div>

==MM Funktion: Eingabemaske==
[[File:icons_paletteneinstellungen.png|left|32px]]
Es wird eine neue Eingabemaske benötigt.

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

* Auf '''Neu''' klicken
* Die neue Eingabemaske mit '''BE Erfassung''' benennen
* Alle Attribute hinzufügen
* Speichern und schliessen
<div style="clear: both"></div>

==MM Funktion: Filter==
[[File:icons_filter.png|left|32px]]
Es wird kein Filter benötigt.

==MM Funktion: Ansichtseinstellungen==
[[File:icons_ansichtseinstellungen.png|left|32px]]
Es werden wie gewohnt die Zugriffsberechtigung zugewiesen, damit über die Backend-Navigation auf die Tabelle zugegriffen werden kann.

[[File:mm_neues_metamodel_ansichtseinstellungen.png|thumb|400px]]
<div style="clear: both"></div>

=Neues MetaModel 'MyMusik - Stilrichtungen' steht zum Abfüllen bereit=

[[File:mm_neues_metamodel_navi.png|left|600px]]

[[File:mm_neues_metamodel_navi2.png|left|600px]]

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

==BE Liste==
[[File:mm_neues_metamodel_BE_liste.png|thumb|400px]]
* Über '''Neuer Datensatz''' wird die Liste befüllt
* Für unserem Fall werden nun die späteren Kategorien erfasst: Pop/Rock, Italo-Rock, New Wave, Fat Beat, Cantautore, Soul/Blues und Jazz
<div style="clear: both"></div>

==BE Formular==
[[File:mm_neues_metamodel_BE_formular.png|thumb|400px]]
* Das BE Formular sieht ziemlich simpel aus
* Ein separates Feld "ID" braucht nicht erfasst zu werden, denn dieses wird im Hintergrund automatisch generiert
<div style="clear: both"></div>

=Auswahlfeld bei 'Musicbox' hinzufügen=
Wir klicken unser altes MetaModel '''Musicbox''' an und wählen dort die MM-Funktion '''Attribute''' an.
==Neues Attribut 'Stilrichtung'==
[[File:mm_attribut_erfassen_style.png|thumb|400px]]
* Das neue Attribut ist vom Typ '''Auswahl'''
* Column name: style
* Name: Stilrichtung
* Description:... wie es euch gefällt

Nun kommt der eigentlich wichtige Teil: Man stellt eine Verbindung zum neu geschaffenen MetaModel her

* '''Source Table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* '''Value column''': Den Namen der Spalte '''style''' auswählen
* '''Id column''': '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* '''Alias column''': '''alias''' auswählen
* ''' Auswahl-Sortierung''': Sortierkriterium auswählen

Ergänzung:

* In '''BE Listenansicht''' des ersten MetaModel Musicbox '''sollte''' das neue Attribut Stilrichtung mit aufgenommen werden damit es in der BE Listenansicht überhaupt angezeigt wird.

* In der BE Eingabemaske '''BE Erfassung''' des ersten MetaModel Musicbox '''muss''' das neue Attribut Stilrichtung mit aufgenommen werden damit eine Bearbeitung überhgaupt möglich ist.
<div style="clear: both"></div>

[[File:mm_neues_atribut_musicbox.png|thumb|400px]]
Ab sofort steht nun in der BE Erfassung von '''MyMusic''' ein neues Feld '''Stilrichtung''' mit einem Select zur Verfügung. Das Select enthält nun alle Werte, die unter '''MyMusic - Stilrichtungen''' erfasst wurden.
<div style="clear: both"></div>

=Zusätzlichen Select-Filter im Frontend definieren=

==Filter bei MyMusic anpassen==
[[File:mm_neues_attribut_filter.png|thumb|400px]]
* Der bereits exisitierende Name des Filters '''FE Filter Published''' wird kurz zu "FE Filter Published/Selects" angepasst
* Der Filter '''FE Filter Published''' wird um weitere Einstellungen ergänzt, nämlich...
** eine Einzelauswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einzelauswahl''' für das Attribut '''Stilrichtung'''
* Standardmässig wird im Hintergrund einfach der '''URL-Parameter''' des Feldes (im obigen Beispiel 'country' und 'style') mitgegeben. Dieser lässt sich hier umdefinieren.
<div style="clear: both"></div>

==Frontend-Modul aktualisieren==

[[File:mm_neues_attribut_FE-Modul.png|thumb|400px]]
Das bereits existierende FE-Modul '''MM - MyMusik Filter''' muss noch angepasst werden:
* Anzuwendende Filtereinstellungen: Hier hat sich der Name des Filters bereits selbst aktualisiert
* Filterparameter(Attribute): den neu hinzugekommene Parameter '''Stilrichtung''' anklicken
<div style="clear: both"></div>

=Frontend Ansicht=
Im Frontend wird ein weiteres Select angezeigt, aus dem zusätzlich auch die '''Stilrichtungen''' angewählt werden können.
Die darunter liegende Liste wird entsprechend den oben ausgewählten Kriterien eingegrenzt.

[[Datei:mm_frontend_beispiel_2_selects.jpg|link=|700px]]

[[MetaModels_Beispiel_3|Zurück zum Beispiel 3]] |
[[MetaModels_Beispielprojekt|Zurück zur Beispiel-Übersicht]]

MetaModels Beispiel 4

2014-08-06T20:58:20Z

Tschero: /* Neues Attribut 'Stilrichtung' */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Weiteres MetaModel einrichten=
Wer mit Catalog arbeitet, ist es gewohnt, Selects einzusetzen, um Datensätze zu kategorisieren. In unserem Fall wäre es z.B. sinnvoll, unsere Musikstücke bestimmten Stilrichtungen zuzuordnen. <br>
Bei Catalog wird hierfür die Erweiterung [https://contao.org/de/extension-list/view/taxonomy.10089.de.html Taxonomy] eingesetzt, um Hierarchien von Taxonomie-Bedingungen (oder besser bekannt als Tags) zu erstellen, die dann über ein Select bei der Datensatz-Erfassung abgerufen werden können. Im Wesentlichen wird über Taxonomy eine separate Tabelle mit den später abzurufenden Kategorien erfasst. <br>
Mit MetaModels entfällt der Rückgriff auf Taxonomy. Mit MetaModels kann man eigene Tabellen erfassen, die die Einträge der HTML-Selects enthalten.

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

=Neues MetaModel erstellen=

==Leeres MetaModel==
[[File:mm_neues_metamodel.png|thumb|400px]]

Wir beginnen damit, dass wir unter MetaModels ein neues MetaModel anlegen:
* Klick auf '''Neues MetaModel'''
* Wir geben dem neuen MetaModel den Namen '''Musicbox - Stilrichtungen''' und den Tabellennamen '''mm_select_style'''
* Des weiteren aktivieren wir die '''Übersetzung''' setzen als Sprache '''Deutsch''' ein und aktivieren das '''Fallback'''
* Speichern und schliessen
<div style="clear: both"></div>
[[File:mm_neues_metamodel2.png|thumb|400px]]

* Nun steht uns ein neues, leeres MetaModel (mit null Datensätzen) zur Verfügung, das wir mit den Begriffen der benötigten Stilrichtungen füllen können.<br>
<div style="clear: both"><br><br></div>

==MM-Funktion: Attribute==

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

Wir erfassen zuerst die benötigen Attribute für die Eingabe.
[[File:mm_neues_metamodel_attribute.png|thumb|400px]]

Hierzu geben wir folgende Felder ein:
* '''Stilrichtung'''
** Attribute Type= Text
** Column name= style
** Name (deutsch)= Stilrichtung
** Description (deutsch)= Pop, Rock, New Wave, Jazz, etc.

* '''Alias'''
** Attribute Type= Alias
** Column name= alias
** Name (deutsch)= Alias
** Description (deutsch)= Wird für URL benötigt.
** Unique values= aktiviert
** Alias fields= Titel
<div style="clear: both"><br><br></div>

==MM Funktion: Ausgabevorgaben==
[[File:icons_ausgabevorgaben.png|left|32px]]
Es wird eine neue Ausgabevorgabe benötigt.

[[File:mm_neues_metamodel_ausgabevorgaben.png|thumb|400px]]
* Auf '''Neu''' klicken
* Die neue Ausgabevorgabe mit '''BE Listenansicht''' benennen
* speichern und schließen
* über die Attributeinstellungen alle Attribute hinzufügen
* Sichtbarkeit(Auge) herstellen
<div style="clear: both"></div>

==MM Funktion: Eingabemaske==
[[File:icons_paletteneinstellungen.png|left|32px]]
Es wird eine neue Eingabemaske benötigt.

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

* Auf '''Neu''' klicken
* Die neue Eingabemaske mit '''BE Erfassung''' benennen
* Alle Attribute hinzufügen
* Speichern und schliessen
<div style="clear: both"></div>

==MM Funktion: Filter==
[[File:icons_filter.png|left|32px]]
Es wird kein Filter benötigt.

==MM Funktion: Ansichtseinstellungen==
[[File:icons_ansichtseinstellungen.png|left|32px]]
Es werden wie gewohnt die Zugriffsberechtigung zugewiesen, damit über die Backend-Navigation auf die Tabelle zugegriffen werden kann.

[[File:mm_neues_metamodel_ansichtseinstellungen.png|thumb|400px]]
<div style="clear: both"></div>

=Neues MetaModel 'MyMusik - Stilrichtungen' steht zum Abfüllen bereit=

[[File:mm_neues_metamodel_navi.png|left|600px]]

[[File:mm_neues_metamodel_navi2.png|left|600px]]

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

==BE Liste==
[[File:mm_neues_metamodel_BE_liste.png|thumb|400px]]
* Über '''Neuer Datensatz''' wird die Liste befüllt
* Für unserem Fall werden nun die späteren Kategorien erfasst: Pop/Rock, Italo-Rock, New Wave, Fat Beat, Cantautore, Soul/Blues und Jazz
<div style="clear: both"></div>

==BE Formular==
[[File:mm_neues_metamodel_BE_formular.png|thumb|400px]]
* Das BE Formular sieht ziemlich simpel aus
* Ein separates Feld "ID" braucht nicht erfasst zu werden, denn dieses wird im Hintergrund automatisch generiert
<div style="clear: both"></div>

=Auswahlfeld bei 'Musicbox' hinzufügen=
Wir klicken unser altes MetaModel '''Musicbox''' an und wählen dort die MM-Funktion '''Attribute''' an.
==Neues Attribut 'Stilrichtung'==
[[File:mm_attribut_erfassen_style.png|thumb|400px]]
* Das neue Attribut ist vom Typ '''Auswahl'''
* Column name: style
* Name: Stilrichtung
* Description:... wie es euch gefällt

Nun kommt der eigentlich wichtige Teil: Man stellt eine Verbindung zum neu geschaffenen MetaModel her

* '''Source Table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* '''Value column''': Den Namen der Spalte '''style''' auswählen
* '''Id column''': '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* '''Alias column''': '''alias''' auswählen
* ''' Auswahl-Sortierung''': Sortierkriterium auswählen

Ergänzung:

* In '''BE Listenansicht''' des ersten MetaModel Musicbox '''sollte''' das neue Attribut Stilrichtung mit aufgenommen werden damit es in der BE Listenansicht überhaupt angezeigt wird.

* In der BE Eingabemaske '''BE Erfassung''' des ersten MetaModel Musicbox '''muss''' das neue Attribut Stilrichtung mit aufgenommen werden damit eine Bearbeitung überhgaupt möglich ist.
<div style="clear: both"></div>

[[File:mm_neues_atribut_musicbox.png|thumb|400px]]
Ab sofort steht nun in der BE Erfassung von '''MyMusic''' ein neues Feld '''Stilrichtung''' mit einem Select zur Verfügung. Das Select enthält nun alle Werte, die unter '''MyMusic - Stilrichtungen''' erfasst wurden.
<div style="clear: both"></div>

=Zusätzlichen Select-Filter im Frontend definieren=

==Filter bei MyMusic anpassen==
[[File:mm_neues_attribut_filter.png|thumb|400px]]
* Der bereits exisitierende Name des Filters '''FE Filter Published''' wird kurz zu "FE Filter Published/Selects" angepasst
* Der Filter '''FE Filter Published''' wird um weitere Einstellungen ergänzt, nämlich...
** eine Einzelauswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einzelauswahl''' für das Attribut '''Stilrichtung'''
* Standardmässig wird im Hintergrund einfach der '''URL-Parameter''' des Feldes (im obigen Beispiel 'country' und 'style') mitgegeben. Dieser lässt sich hier umdefinieren.
<div style="clear: both"></div>

==Frontend-Modul aktualisieren==

[[File:mm_neues_attribut_FE-Modul.png|thumb|400px]]
Das bereits existierende FE-Modul '''MM - MyMusik Filter''' muss noch angepasst werden:
* Anzuwendende Filtereinstellungen: Hier hat sich der Name des Filters bereits selbst aktualisiert
* Filterparameter: den neu hinzugekommene Parameter '''Stilrichtung''' anklicken
<div style="clear: both"></div>

=Frontend Ansicht=
Im Frontend wird ein weiteres Select angezeigt, aus dem zusätzlich auch die '''Stilrichtungen''' angewählt werden können.
Die darunter liegende Liste wird entsprechend den oben ausgewählten Kriterien eingegrenzt.

[[Datei:mm_frontend_beispiel_2_selects.jpg|link=|700px]]

[[MetaModels_Beispiel_3|Zurück zum Beispiel 3]] |
[[MetaModels_Beispielprojekt|Zurück zur Beispiel-Übersicht]]

MetaModels Beispiel 4

2014-08-06T20:55:36Z

Tschero: /* Neues Attribut 'Stilrichtung' */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Weiteres MetaModel einrichten=
Wer mit Catalog arbeitet, ist es gewohnt, Selects einzusetzen, um Datensätze zu kategorisieren. In unserem Fall wäre es z.B. sinnvoll, unsere Musikstücke bestimmten Stilrichtungen zuzuordnen. <br>
Bei Catalog wird hierfür die Erweiterung [https://contao.org/de/extension-list/view/taxonomy.10089.de.html Taxonomy] eingesetzt, um Hierarchien von Taxonomie-Bedingungen (oder besser bekannt als Tags) zu erstellen, die dann über ein Select bei der Datensatz-Erfassung abgerufen werden können. Im Wesentlichen wird über Taxonomy eine separate Tabelle mit den später abzurufenden Kategorien erfasst. <br>
Mit MetaModels entfällt der Rückgriff auf Taxonomy. Mit MetaModels kann man eigene Tabellen erfassen, die die Einträge der HTML-Selects enthalten.

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

=Neues MetaModel erstellen=

==Leeres MetaModel==
[[File:mm_neues_metamodel.png|thumb|400px]]

Wir beginnen damit, dass wir unter MetaModels ein neues MetaModel anlegen:
* Klick auf '''Neues MetaModel'''
* Wir geben dem neuen MetaModel den Namen '''Musicbox - Stilrichtungen''' und den Tabellennamen '''mm_select_style'''
* Des weiteren aktivieren wir die '''Übersetzung''' setzen als Sprache '''Deutsch''' ein und aktivieren das '''Fallback'''
* Speichern und schliessen
<div style="clear: both"></div>
[[File:mm_neues_metamodel2.png|thumb|400px]]

* Nun steht uns ein neues, leeres MetaModel (mit null Datensätzen) zur Verfügung, das wir mit den Begriffen der benötigten Stilrichtungen füllen können.<br>
<div style="clear: both"><br><br></div>

==MM-Funktion: Attribute==

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

Wir erfassen zuerst die benötigen Attribute für die Eingabe.
[[File:mm_neues_metamodel_attribute.png|thumb|400px]]

Hierzu geben wir folgende Felder ein:
* '''Stilrichtung'''
** Attribute Type= Text
** Column name= style
** Name (deutsch)= Stilrichtung
** Description (deutsch)= Pop, Rock, New Wave, Jazz, etc.

* '''Alias'''
** Attribute Type= Alias
** Column name= alias
** Name (deutsch)= Alias
** Description (deutsch)= Wird für URL benötigt.
** Unique values= aktiviert
** Alias fields= Titel
<div style="clear: both"><br><br></div>

==MM Funktion: Ausgabevorgaben==
[[File:icons_ausgabevorgaben.png|left|32px]]
Es wird eine neue Ausgabevorgabe benötigt.

[[File:mm_neues_metamodel_ausgabevorgaben.png|thumb|400px]]
* Auf '''Neu''' klicken
* Die neue Ausgabevorgabe mit '''BE Listenansicht''' benennen
* speichern und schließen
* über die Attributeinstellungen alle Attribute hinzufügen
* Sichtbarkeit(Auge) herstellen
<div style="clear: both"></div>

==MM Funktion: Eingabemaske==
[[File:icons_paletteneinstellungen.png|left|32px]]
Es wird eine neue Eingabemaske benötigt.

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

* Auf '''Neu''' klicken
* Die neue Eingabemaske mit '''BE Erfassung''' benennen
* Alle Attribute hinzufügen
* Speichern und schliessen
<div style="clear: both"></div>

==MM Funktion: Filter==
[[File:icons_filter.png|left|32px]]
Es wird kein Filter benötigt.

==MM Funktion: Ansichtseinstellungen==
[[File:icons_ansichtseinstellungen.png|left|32px]]
Es werden wie gewohnt die Zugriffsberechtigung zugewiesen, damit über die Backend-Navigation auf die Tabelle zugegriffen werden kann.

[[File:mm_neues_metamodel_ansichtseinstellungen.png|thumb|400px]]
<div style="clear: both"></div>

=Neues MetaModel 'MyMusik - Stilrichtungen' steht zum Abfüllen bereit=

[[File:mm_neues_metamodel_navi.png|left|600px]]

[[File:mm_neues_metamodel_navi2.png|left|600px]]

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

==BE Liste==
[[File:mm_neues_metamodel_BE_liste.png|thumb|400px]]
* Über '''Neuer Datensatz''' wird die Liste befüllt
* Für unserem Fall werden nun die späteren Kategorien erfasst: Pop/Rock, Italo-Rock, New Wave, Fat Beat, Cantautore, Soul/Blues und Jazz
<div style="clear: both"></div>

==BE Formular==
[[File:mm_neues_metamodel_BE_formular.png|thumb|400px]]
* Das BE Formular sieht ziemlich simpel aus
* Ein separates Feld "ID" braucht nicht erfasst zu werden, denn dieses wird im Hintergrund automatisch generiert
<div style="clear: both"></div>

=Auswahlfeld bei 'Musicbox' hinzufügen=
Wir klicken unser altes MetaModel '''Musicbox''' an und wählen dort die MM-Funktion '''Attribute''' an.
==Neues Attribut 'Stilrichtung'==
[[File:mm_attribut_erfassen_style.png|thumb|400px]]
* Das neue Attribut ist vom Typ '''Auswahl'''
* Column name: style
* Name: Stilrichtung
* Description:... wie es euch gefällt

Nun kommt der eigentlich wichtige Teil: Man stellt eine Verbindung zum neu geschaffenen MetaModel her

* '''Source Table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* '''Value column''': Den Namen der Spalte '''style''' auswählen
* '''Id column''': '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* '''Alias column''': '''alias''' auswählen
* ''' Auswahl-Sortierung''': Sortierkriterium auswählen
<div style="clear: both"></div>
Ergänzung:
In '''BE Listenansicht''' des ersten MetaModel Musicbox '''sollte''' das neue Attribut Stilrichtung mit aufgenommen damit es in der BE Listenansicht überhaupt angezeigt wird.

In der BE Eingabemaske'''BE Erfassung''' des ersten MetaModel Musicbox '''muss''' das neue Attribut Stilrichtung mit aufgenommen damit eine Bearbeitung überhgaupt möglich ist.

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

[[File:mm_neues_atribut_musicbox.png|thumb|400px]]
Ab sofort steht nun in der BE Erfassung von '''MyMusic''' ein neues Feld '''Stilrichtung''' mit einem Select zur Verfügung. Das Select enthält nun alle Werte, die unter '''MyMusic - Stilrichtungen''' erfasst wurden.
<div style="clear: both"></div>

=Zusätzlichen Select-Filter im Frontend definieren=

==Filter bei MyMusic anpassen==
[[File:mm_neues_attribut_filter.png|thumb|400px]]
* Der bereits exisitierende Name des Filters '''FE Filter Published''' wird kurz zu "FE Filter Published/Selects" angepasst
* Der Filter '''FE Filter Published''' wird um weitere Einstellungen ergänzt, nämlich...
** eine Einzelauswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einzelauswahl''' für das Attribut '''Stilrichtung'''
* Standardmässig wird im Hintergrund einfach der '''URL-Parameter''' des Feldes (im obigen Beispiel 'country' und 'style') mitgegeben. Dieser lässt sich hier umdefinieren.
<div style="clear: both"></div>

==Frontend-Modul aktualisieren==

[[File:mm_neues_attribut_FE-Modul.png|thumb|400px]]
Das bereits existierende FE-Modul '''MM - MyMusik Filter''' muss noch angepasst werden:
* Anzuwendende Filtereinstellungen: Hier hat sich der Name des Filters bereits selbst aktualisiert
* Filterparameter: den neu hinzugekommene Parameter '''Stilrichtung''' anklicken
<div style="clear: both"></div>

=Frontend Ansicht=
Im Frontend wird ein weiteres Select angezeigt, aus dem zusätzlich auch die '''Stilrichtungen''' angewählt werden können.
Die darunter liegende Liste wird entsprechend den oben ausgewählten Kriterien eingegrenzt.

[[Datei:mm_frontend_beispiel_2_selects.jpg|link=|700px]]

[[MetaModels_Beispiel_3|Zurück zum Beispiel 3]] |
[[MetaModels_Beispielprojekt|Zurück zur Beispiel-Übersicht]]

MetaModels Beispiel 2

2014-08-05T09:21:48Z

Tschero: /* Frontend-Module erstellen */

[[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
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}
<div style="clear: both"></div>
Das Problem ist mittlerweile behoben. Man kann Attribute per Drag and Drop an die erste Stelle bewegen.

==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]]
Frontend-Modul für Detailansicht einrichten:

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

MetaModels Beispiel 2

2014-08-05T09:21:20Z

Tschero: /* Frontend-Module erstellen */

[[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
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}
<div style="clear: both"></div>
Das Problem ist mittlerweile behoben. Man kann Attribute per Drag and Drop an die erste Stelle bewegen.

==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]]
Frontend-Modul für Detailansicht einrichten:
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]]

MetaModels Beispiel 2

2014-08-05T09:03:35Z

Tschero: /* Attribute zur Detailansicht hinzufügen */

[[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
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}
<div style="clear: both"></div>
Das Problem ist mittlerweile behoben. Man kann Attribute per Drag and Drop an die erste Stelle bewegen.

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

MetaModels Beispiel 2

2014-08-05T09:03:04Z

Tschero: /* Attribute zur Detailansicht hinzufügen */

[[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
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}
<div style="clear: both"></div>
Das Problem ist mittlerweile behoben. Man kann Attribute per Drag and Drop an die erte Stelle bewegen.

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

MetaModels Beispiel 2

2014-08-05T08:21:51Z

Tschero: /* Einfachen Filter erstellen */

[[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
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}

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

MetaModels Beispiel 2

2014-08-05T08:20:42Z

Tschero: /* Einfachen Filter erstellen */

[[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
* Einen Haken bei dem Kästchen '''Aktivieren''' setzen
* 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>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 01:40, 5. Jun. 2014 (CEST)}}

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

MetaModels Beispiel 1

2014-08-05T06:54:59Z

Tschero: /* BE-Formular */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=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===
# [[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

=Eine leere Datenbank erstellen=

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

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

* In unserem Beispiel aktivieren wir die Mehrsprachigkeit, um nachträglich weitere Sprachen anlegen zu können. Falls man im Vorfeld weiß, dass man keine weiteren Sprachen benötigt, muss der Haken nicht gesetzt werden. MetaModels ist auch ohne Mehrprachigkeit komplett funktionstüchtig.
* '''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.

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

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

[[File:mm_backend_funktionen_icons.png|link=|border]]

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

Hier gelangt man wieder zurück zum gleichen Screen, wie bei der Erstellung eines neuen MetaModels. Hier kann man jederzeit sowohl den '''Namen''' als auch den '''Tabellennamen''' des MetaModels ändern.

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Attribute für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Render-Einstellungen für MetaModel ID x definieren)
# [[MetaModels_Backend:_Eingabemaske|'''Eingabemaske''']] (Eingabemaske für das MetaModel ID x definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Filter für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''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==

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

Hier erfasst man die benötigen Felder für die Eingabe.
s. [[MetaModels_Backend:_Attribute|allgemeine Infos]] zu den Attributen

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

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

<div>

==MM-Funktion: Ausgabevorgaben (aka Render-Einstellungen)==
[[File:icons_ausgabevorgaben.png|left|32px]]
Hier wird die Ansicht erfasst: Eine Listendarstellung für das Backend.

[[File:mm_ausgabe_definieren.png|right|thumb|400px]]

* Auf '''neu''' klicken
* '''BE Listenansicht''' eingeben
* Der Rest kann so stehen bleiben, denn für die BE Listenansicht braucht man weder eine '''Zielseite''' noch '''Filter settings'''.

(s. [[MetaModels_Backend:_Ausgabevorgaben|allgemeine Ausgabe-Vorgaben]])

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

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

Um auszuwählen, welche Felder in der BE Listenansicht angezeigt werden sollen, klickt man einfach auf das entsprechende Icon rechts:

* '''Add all''' fügt alle Felder auf einen Rutsch hinzu. Man kann auch '''Neu''' wählen und die Felder einzeln hinzufügen, aber mit '''Add all''' gehts am schnellsten.
* Die Frage, ob alle Attribute hinzugefügt werden sollen("''Add all attributes to render setting''"), wird mit '''Weiter''' bestätigt.
* Nun werden alle Attribute aufgelistet, die im vorangegangenen Schritt erfasst worden sind.

Über das übliche 'Auge' werden nur die Attribute sichtbar gemacht, die in der Backend-Liste angezeigt werden sollen.
Für dieses Tutorial wählen wir : '''Titel''', '''Interpret''', '''Land''' und '''Jahr'''.

(( alter Screen, wird ersetzt ))
<div style="clear: both"></div>

</div>

==MM-Funktion: Eingabemaske (fka Paletteneinstellungen)==

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

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

===BE-Liste===
[[File:mm_paletten_BE_liste.png|thumb|400px]]
Nach Klick auf '''Neue Eingabemaske''' öffnet sich ein [[MetaModels_Backend:_Eingabemaske|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.<br>
Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
{{Hinweis|Mit der Erweiterung '''MetaModels Boilerplate''' (Nightly Build) kann man die MetaModels in einem separaten '''Backend-Bereich''' in der BE-Navigation unterbringen.}}{{Hinweis|Die Option '''Sortierung''' ist beim erstmaligen Bearbeiten der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s (hier: Inhalte) die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.}}
<div style="clear: both"></div>

===BE-Formular===
[[File:mm_paletten_BE_formular.png|thumb|400px]]

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 kann man hier auch die Reihenfolge umstellen und so bestimmen, wie die Daten erfasst werden sollen.
* Angefangen wird mit dem ersten Eintrag '''Titel [text]'''
<div style="clear: both"></div>

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

Folgendes Beispiel zeigt, was man bei der Erfassung des Attributs '''Titel''' alles einstellen kann.<br>
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.
<div style="clear: both"></div>

==MM-Funktion: Zugriffsrechte definieren==

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

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

[[File:mm_neues_metamodel_ansichtseinstellungen.png|730px]]

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=

[[File:mm_backend_erfassen.png|thumb|600px]]

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

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

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

MetaModels

2014-07-27T09:54:43Z

Tschero: /* Verfügbare Attribute und Filter */

[[Category:Extensions]]
[[Category:MetaModels|B]]
{{ExtInfo
| Dev=Metamodels Team
| DevSite=
| Version=ab 2.11.X
| ERLink=
| VCSLink=https://github.com/MetaModels/core
| TrackerLink=https://github.com/MetaModels/core/issues
| Depending=[[DC_General]] [[Justtextwidgets]] [[MultiColumnWizard]] [[MetaPalettes]]
}}

=Vorwort: Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)=
Die Erweiterung MetaModels ist der Nachfolger der Catalog-Extension. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zum Catalog besteht nicht.

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

=Download & Installation=

==Download von der Demosite==
[[Datei:logo-metamodels.png|link=|left|105px]]
Unter der URL [http://now.metamodel.me now.metamodel.me] findet sich die Webseite zur Extension mit einer Frontentdemo und der Möglichkeit, Installationsarchive in den Formaten '''tgz''', '''tbz''' und '''zip''' mit so genannten Nightly Builds zu laden. Diese Archive beinhalten die MetaModels-Dateien, Attribute, Filter sowie sämtliche anderen Erweiterungen, die für den Betrieb nötig sind und ansonsten separat heruntergeladen und installiert werden müssen.
<div style="clear: both"><br><br></div>

==Installation via Composer==

MetaModels kann vollständig über [http://de.contaowiki.org/Composer Composer] installiert werden. Alle Attribute liegen auf [https://packagist.org/ Packagist] und werden vom offiziellen MetaModels Team betreut. Für die Installation von MetaModels über Composer muss man lediglich nach "metamodels" suchen, alle verfügbaren Pakete werden danach aufgelistet.

==Download aus dem Entwicklungsrepository GitHub==

[[Datei:logo-github.png|link=|left|105px]]
Zu finden ist die Erweiterung MetaModels auf GitHub:
[https://github.com/MetaModels github.com/Metamodels]<br>
Aktuell können das Core, dazu abhängige weitere Erweiterungen und alle weiteren MetaModels Attribute/Filter manuell installiert werden.
<div style="clear: both"><br></div>

===Core===
* [https://github.com/MetaModels/core MetaModels (Das Core-Modul)]
* [https://github.com/MetaModels/boilerplate Boilerplate (Erzeugt einen separaten Bereich in der Backend-Navigation)]

===Abhängigkeiten===
Benötigt werden folgende Erweiterungen:
* [https://github.com/MetaModels DC_General]
* [https://contao.org/de/extension-list/view/MetaPalettes.html MetaPalettes]
* [http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html MultiColumnWizard]
* [https://github.com/Discordier/justtextwidgets justtextwidgets]
* [https://contao.org/de/extension-list/view/geoprotection.de.html geoprotection] (wird nur für das Attribut '''Geoprotection''' benötigt)

===Verfügbare Attribute und Filter===
Sobald der Core und alle benötigten sonstigen Erweiterungen installiert sind, werden die weiteren Attributs- und Filterextensions des MetaModels benötigt.
Dazu gehören:
{| style="width:100%"
|-
! '''Attribute''' !! '''Attribute (translated)''' !! '''Filter'''
|-
|
* [https://github.com/MetaModels/attribute_alias Attribut: Alias]
* [https://github.com/MetaModels/attribute_checkbox Attribut: Checkbox (Kontrollkästchen)]
* [https://github.com/MetaModels/attribute_combinedvalues Attribut: Combined Values (Kombinierte Einträge)]
* [https://github.com/MetaModels/attribute_color Attribut: Color (Farbe)]
* [https://github.com/MetaModels/attribute_country Attribut: Country (Land)]
* [https://github.com/MetaModels/attribute_decimal Attribut: Decimal (Dezimal)]
* [https://github.com/MetaModels/attribute_file Attribut: File (Datei)]
* [https://github.com/MetaModels/attribute_geoprotection Attribut: Geoprotection (Länderzuordnung)]
* [https://github.com/MetaModels/attribute_langcode Attribut: Langcode (Sprachschlüssel)]
* [https://github.com/MetaModels/attribute_longtext Attribut: Longtext (Langtext, Textarea)]
* [https://github.com/MetaModels/attribute_select Attribut: Select (Auswahl)]
* [https://github.com/MetaModels/attribute_numeric Attribut: Numeric (Numerisch)]
* [https://github.com/MetaModels/attribute_rating Attribut: Rating (Bewertung)]
* [https://github.com/MetaModels/attribute_tags Attribut: Tags (Mehrfachauswahl)]
* [https://github.com/MetaModels/attribute_text Attribut: Text]
* [https://github.com/MetaModels/attribute_timestamp Attribut: Timestamp (Datum)]
* [https://github.com/MetaModels/attribute_url Attribut: URL]
|
* [https://github.com/MetaModels/attribute_translatedalias Attribut: Translated Alias]
* [https://github.com/MetaModels/attribute_translatedfile Attribut: Translated File]
* [https://github.com/MetaModels/attribute_translatedlongtext Attribut: Translated Longtext]
* [https://github.com/MetaModels/attribute_translatedselect Attribut: Translated Select]
* [https://github.com/MetaModels/attribute_translatedtags Attribut: Translated Tags]
* [https://github.com/MetaModels/attribute_translatedtext Attribut: Translated Text]
|
* [https://github.com/MetaModels/filter_checkbox Filter: Checkbox]
* [https://github.com/MetaModels/filter_fromto Filter: FromTo]
* [https://github.com/MetaModels/filter_range Filter: Range]
* [https://github.com/MetaModels/filter_select Filter: Select]
* [https://github.com/MetaModels/filter_tags Filter: Tags]
* [https://github.com/MetaModels/filter_text Filter: Text]
|}
Attribut- und Filterextensions werden für den Betrieb von MetaModels benötigt. Welche dieser Erweiterungen in einem Projekt zu Einsatz kommen sollen ist abhängig von den benötigten Funktionen.
{{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_geoprotection '''Geoprotection'''] ist nicht mehr Teil der Nightly Builds. Es kann aber jederzeit über den oben angegeben Link separat geladen werden.}}{{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_rating '''Rating'''] benötigt die Extension [https://packagist.org/packages/leounglaub/contao-simple-ajax '''SimpleAjax'''] von leo-unglaub. Das Rating Attribut wird seit einiger Zeit nicht mehr in der Nightly ausgeliefert.}}

==Download via git und Kommandozeile==
In einer bash (Linux Kommandozeile bzw. cygwin Kommandozeile) kann man sich auch alle Unterprojekte der MetaModels via git clonen. Man sollte jedoch vorher in den Ordner wechseln, wohin die Projekte heruntergeladen werden sollen.

{| style="width:100%"
|-
! '''Linux''' !! '''MacOS'''
|-
|
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen.
<source lang="bash">
cd ~
mkdir MetaModels
cd MetaModels
</source>
|
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen.
<source lang="bash">
cd ~
mkdir MetaModels
cd MetaModels
</source>
|-
|
Alle MetaModel Repos holen
<source lang="bash">
for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \
grep clone_url | \
cut -d \" -f4`; do \
git clone $i; \
done;
</source>
|
Alle MetaModel Repos holen
<source lang="bash">
for i in `curl https://api.github.com/orgs/MetaModels/repos | \
grep clone_url | \
cut -d \" -f4`; do \
git clone $i; \
done;
</source>
|}

=Installation=
Die zu installieren Ordner und Dateien müssen zur Installation im Contao-System wie folgt hochgeladen werden:
{| style="width:80%"
|-
! '''Module''' (/system/modules) !! '''Drivers''' (/system/drivers)
|-
|
* generalDriver
* justtextwidgets
* metamodels
* metamodels_boilerplate
* metamodelsattribute_alias
* metamodelsattribute_checkbox
* metamodelsattribute_combinedvalues
* metamodelsattribute_color
* metamodelsattribute_country
* metamodelsattribute_decimal
* metamodelsattribute_file
* metamodelsattribute_geoprotection
* metamodelsattribute_langcode
* metamodelsattribute_longtext
* metamodelsattribute_numeric
* metamodelsattribute_rating
* metamodelsattribute_select
* metamodelsattribute_tags
* metamodelsattribute_text
* metamodelsattribute_timestamp
* metamodelsattribute_translatedalias
* metamodelsattribute_translatedfile
* metamodelsattribute_translatedlongtext
* metamodelsattribute_translatedselect
* metamodelsattribute_translatedtags
* metamodelsattribute_translatedtext
* metamodelsattribute_url
* metamodelsfilter_checkbox
* metamodelsfilter_fromto
* metamodelsfilter_range
* metamodelsfilter_select
* metamodelsfilter_tags
* metamodelsfilter_text
* metapalettes
* multicolumnwizard
|
* DC_General.php
|}
Danach muss mittels des Installtools ein Update der Datenbank gemacht werden.

=Backend Ansichten=

===Leeres MetaModel===
[[Datei:MetaModels_Backend_System.png|right|600px]]
Nach Aktualisierung der Datenbank erscheint '''MetaModels''' neu als eigenständige Einstellung in der Backend-Navigation links.
<div style="clear: both"></div>

===Erweiterungsverwaltung===
[[Datei:MetaModels_Backend_System_ER.png|right|600px]]
In der Erweiterungsverwaltung findet sich hingegen nichts, was auf MetaModels hinweist. Aber das ist gut so (Stand Mai 2013).
<div style="clear: both"></div>

===MetaModel mit null Datensätzen===
[[Datei:MetaModels_Backend_System_Beispiel.png|right|600px]]
Nachdem ein erstes neues MetaModel erstellt wurde, erscheint folgende Darstellung:
Weiterführende Informationen zu einem einfachen Praxisbeispiel findet man unter [[MetaModels_Beispielprojekt|MetaModels Beispielprojekt]]
<div style="clear: both"></div>

=Konfiguration=

===Dokumentation der Attribute===
[[File:icons_attribute.png|left|link=|32px]]
Zur [[MetaModels_Backend:_Attribute|Dokumentation der Attribute]].

===Dokumentation der Ausgabevorgaben===
[[File:icons_ausgabevorgaben.png|left|link=|32px]]
Den Überblick findest du [[MetaModels_Backend:_Ausgabevorgaben|hier]].

===Dokumentation der Eingabemaske (fka Paletteneinstellungen)===
[[File:icons_paletteneinstellungen.png|left|link=|32px]]
Den Überblick findest du [[MetaModels_Backend:_Eingabemaske|hier]].

===Dokumentation der Filter===
[[File:icons_filter.png|left|link=|32px]]
Zum [[MetaModels_Backend:_Filter|Überblick über die Filter]].

===Dokumentation der Ansichtseinstellungen===
[[File:icons_ansichtseinstellungen.png|left|link=|32px]]
Zum [[MetaModels_Backend:_Ansichtseinstellungen|Überblick der Ansichtseinstellungen]].

=Basics=
Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kann, findet man hier:
# [[MetaModels_Beispiel_1| Backend einrichten]] - am Beispiel einer Musiksammlung, Eingeben der Sammlung
# [[MetaModels_Beispiel_2| Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3| Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4| Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
# [[MetaModels Insert-Tags| Insert-Tags]] - Insert-Tags in MetaModels

=Tipps und Tricks=
Umsetzung-Beispiele, wie man MetaModels ausbauen kann, findet man hier:
# [[MetaModels_Beispiel:_Übersetzter_select| Übersetzer select]] - "Übersetzter select"-Attribut eingerichtet werden.
# [[MetaModels_Beispiel:_Referenced_items| Referenced items]] - MetaModels miteinder verknüpfen

=Frontendausgabe=
{{Hinweis|Die Dokumentation sollte in eine andere Seite ausgelagert werden}}
----
started by: [[Benutzer:Planepix|Planepix]] 00:49, 28. Nov. 2012 (CET)<br>
completed by [[Benutzer:Luis|Luis]], [[Benutzer:lucina|Lucina]]

Insert-Tags

2014-03-18T22:29:46Z

Tschero: /* Weitere Inserttags */

{{AppliesTo
|Version=Alle Versionen
}}
[[Category: Core]]
[[Category:Dev HOWTOS]]
[[Category:Anwender und Redakteure]]

= Insert-Tags =
Contao bietet die Möglichkeit, mittels so genannter Insert-Tags Inhalte oder Funktionen zu referenzieren.

Der Aufbau ist in der Regel <nowiki>{{Tagname::Argument}}</nowiki>.
{{Achtung|Eine Verschachtelung – also der Aufruf eines Insert-Tags innerhalb eines anderen – ist nur mit <nowiki>{{iflng::*}}</nowiki> möglich. Andere Insert-Tags können nicht verschachtelt werden.}}
{{Achtung|Werden Elemente inkludiert, die auf Javascript basieren, wird das Javascript nicht geladen. Abhilfe: [[Inserttags_Javascript_Support]]}}

== Liste der Insert-Tags ==
Die Liste stammt im Wesentlichen von [http://www.contao.org/typolight-insert-tags.html Contao.org]. Über die dort dokumentierten Insert-Tags hinaus gibt es weitere Insert-Tags. Bitte vervollständige die Liste.
=== Link-Elemente ===
{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{link::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer internen Seite oder einer externen URL ersetzt (ersetzen Sie * mit der ID oder dem Alias der Seite oder der URL).
|-
|<nowiki>{{link::back}}</nowiki> || Dieses Tag wird mit der zuletzt besuchte Seite ersetzt. Kann auch mit link_open, link_url und link_title verwendet werden.
|-
|<nowiki>{{link::login}}</nowiki> || Dieses Tag wird mit einem Link zur Anmeldeseite des aktuellen Frontend-Benutzers (falls vorhanden) ersetzt.
|-
|<nowiki>{{link_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer internen Seite ersetzt: <nowiki>{{link_open::12}}</nowiki>Click here<nowiki>{{link_close}}</nowiki>.
|-
|<nowiki>{{link_url::*}}</nowiki> || Dieses Tag wird mit der URL einer internen Seite ersetzt: <nowiki><a href="{{link_url::12}}">Click here</a>.</nowiki>
|-
|<nowiki>{{link_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer internen Seite ersetzt: <nowiki><a title="{{link_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{article::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{article_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Artikel ersetzt: <nowiki>{{article_open::12}}Click here{{link_close}}.</nowiki>
|-
|<nowiki>{{article_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Artikels ersetzt: <nowiki><a href="{{article_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{article_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Artikels ersetzt: <nowiki><a title="{{article_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{news::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer Nachricht ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{news_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Nachricht ersetzt: <nowiki>{{news_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{news_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Nachricht ersetzt: <nowiki><a href="{{news_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{news_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Nachricht ersetzt: <nowiki><a title="{{news_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{event::*}}</nowiki> || Dieses Tag wird mit einem Link zu einem Event ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{event_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einem Event ersetzt: <nowiki>{{event_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{event_url::*}}</nowiki> || Dieses Tag wird mit der URL eines Events ersetzt: <nowiki><a href="{{event_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{event_title::*}}</nowiki> || Dieses Tag wird mit dem Titel eines Events ersetzt: <nowiki><a title="{{event_title::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{faq::*}}</nowiki> || Dieses Tag wird mit einem Link zu einer häufig gestellten Frage ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
|<nowiki>{{faq_open::*}}</nowiki> || Wird mit dem öffnenden Tag eines Links zu einer Frage ersetzt: <nowiki>{{faq_open::12}}Click here{{link_close}}</nowiki>.
|-
|<nowiki>{{faq_url::*}}</nowiki> || Dieses Tag wird mit der URL einer Frage ersetzt: <nowiki><a href="{{faq_url::12}}">Click here</a></nowiki>.
|-
|<nowiki>{{faq_title::*}}</nowiki> || Dieses Tag wird mit dem Titel einer Frage ersetzt: <nowiki><a title="{{faq_title::12}}">Click here</a>.</nowiki>
|-
| colspan="2" |
|}

=== Benutzereigenschaften ===

Mit den folgenden Inserttags können Eigenschaften des angemeldeten Benutzers ausgebeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{user::firstname}}</nowiki> ||Dieses Tag wird mit dem Vornamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::lastname}}</nowiki> || Dieses Tag wird mit dem Nachnamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::company}}</nowiki> || Dieses Tag wird mit dem Firmennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::phone}}</nowiki> || Dieses Tag wird mit der Telefonnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::mobile}}</nowiki> || Dieses Tag wird mit der Handynummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::fax}}</nowiki> || Dieses Tag wird mit der Faxnummer des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::email}}</nowiki> || Dieses Tag wird mit der E-Mail-Adresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::website}}</nowiki> || Dieses Tag wird mit der Internetadresse des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::street}}</nowiki> || Dieses Tag wird mit dem Staßennamen des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::postal}}</nowiki> || Dieses Tag wird mit der Postleitzahl des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::city}}</nowiki> || Dieses Tag wird mit der Stadt des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::country}}</nowiki> || Dieses Tag wird mit dem Land des angemeldeten Benutzers ersetzt.
|-
| <nowiki>{{user::username}}</nowiki> || Dieses Tag wird mit dem Benutzernamen des angemeldeten Benutzers ersetzt.
| colspan="2" |
|}
Mit der Insert-Tag-Methode <nowiki>{{user::variable}}</nowiki> können auch andere Eigenschaften von Usern abgefragt werden.

=== Umgebungsvariablen ===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname oder der Request-String ausgegeben werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{env::page_id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_name}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_title}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::page_language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::parent_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_alias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_name}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::main_title}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || || 2.10.x
|-
| <nowiki>{{env::website_title}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. || ||
|-
| <nowiki>{{env::host}}</nowiki> || Dieses Tag wird mit dem aktuellen Hostnamen ersetzt. || 2.9.0||
|-
| <nowiki>{{env::http_host}}</nowiki> || Dieses Tag wird mit dem aktuellen HTTP-Host ersetzt. || unbekannt||
|-
| <nowiki>{{env::url}}</nowiki> || Dieses Tag wird mit dem Hostnamen und dem Protokoll ersetzt. || ||
|-
| <nowiki>{{env::path}}</nowiki> || Dieses Tag wird mit der aktuellen Basis-URL samt Pfad zum Contao-Verzeichnis ersetzt. || ||
|-
| <nowiki>{{env::request}}</nowiki> || Dieses Tag wird mit dem aktuellen Request-String ersetzt. || ||
|-
| <nowiki>{{env::referer}}</nowiki> || Dieses Tag wird mit der URL der zuletzt besuchten Seite ersetzt. || ||
|-
| <nowiki>{{env::ip}}</nowiki> || Dieses Tag wird mit der IP-Adresse des aktuellen Besuchers ersetzt. || ||
|-
| colspan="2" |
|}

=== Seitenbezogene Inserttags===

Mit den folgenden Inserttags können Umgebungsvariablen wie z.B. der Seitenname.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{page::id}}</nowiki> || Dieses Tag wird mit der ID der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::alias}}</nowiki> || Dieses Tag wird mit dem Alias der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::title}}</nowiki> || Dieses Tag wird mit dem Namen der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::pageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::language}}</nowiki> || Dieses Tag wird mit der Sprache der aktuellen Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Seite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::parentPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Seite ersetzt. || 2.11.x||
|-
| <nowiki>{{page::mainAlias}}</nowiki> || Dieses Tag wird mit dem Alias der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainTitle}}</nowiki> || Dieses Tag wird mit dem Namen der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::mainPageTitle}}</nowiki> || Dieses Tag wird mit dem Titel der übergeordneten Hauptseite ersetzt. || 2.11.x ||
|-
| <nowiki>{{page::rootTitle}}</nowiki> || Dieses Tag wird mit dem Titel der Webseite ersetzt. || 2.11.x ||
|-
| colspan="2" |
|}

=== Include-Elemente ===

Mit den folgenden Inserttags können Ressourcen wie z.B. Artikel, Module oder Dateien aus dem /templates-Verzeichnis eingebunden werden.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{insert_article::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Artikel ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| <nowiki>{{insert_content::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Inhaltselement ersetzt (ersetzen Sie * mit der ID des Elements).
|-
| <nowiki>{{insert_module::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Modul ersetzt (ersetzen Sie * mit der ID des Moduls).
|-
| <nowiki>{{article_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Artikels ersetzt (ersetzen Sie * mit der ID des Artikels).
|-
| <nowiki>{{news_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser einer Nachricht ersetzt (ersetzen Sie * mit der ID der Nachricht).
|-
| <nowiki>{{event_teaser::*}}</nowiki> || Dieses Tag wird mit dem Teaser eines Events ersetzt (ersetzen Sie * mit der ID des Events).
|-
| <nowiki>{{file::*}}</nowiki> || Dieses Tag wird mit dem Inhalt einer .php- oder .tpl-Datei aus dem templates-Verzeichnis ersetzt (ersetzen Sie * mit dem Namen). Bei Bedarf können Sie Argumente übergeben: <nowiki>{{file::file.php?arg1=val&arg2=val}}</nowiki>
|-
| <nowiki>{{insert_form::*}}</nowiki> || Dieses Tag wird mit dem referenzierten Formular ersetzt (ersetzen Sie * mit der ID oder dem Alias).
|-
| colspan="2" |
|}

=== Systempfade ===

Mit den folgenden Inserttags können Systempfade referenzenziert werden:

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung'''
|-
| <nowiki>{{files_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /files
|-
| <nowiki>{{assets_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /assets
|-
| <nowiki>{{plugins_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /plugins
|-
| <nowiki>{{script_url}}</nowiki> || Liefert den Pfad zum Verzeichnis für /scripts
|-
| colspan="2" |
|}

=== Verschiedenes ===

Mit den folgenden Inserttags können Sie verschiedene Aufgaben erledigen und z.B. das aktuelle Datum oder ein Lightbox-Bild einfügen.

{| border="0" cellspacing="1" cellpadding="2"
! '''Insert-Tag''' !! '''Beschreibung''' !! '''ab Version''' || '''bis Version'''
|-
| <nowiki>{{date}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{date::*}}</nowiki> || Dieses Tag wird mit dem aktuellen Datum gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update}}</nowiki> || Dieses Tag wird mit dem Datum der letzten Aktualisierung gemäß des globalen Datumsformats ersetzt. || ||
|-
| <nowiki>{{last_update::*}}</nowiki> || Dieses Tag wird mit Datum der letzten Aktualisierung gemäß eines individuellen Datumsformats ersetzt. || ||
|-
| <nowiki>{{email::*}}</nowiki> || Dieses Tag wird mit einem verschlüsselten Link zu einer E-Mail-Adresse ersetzt. || ||
|-
| <nowiki>{{email_open::*}}</nowiki> || Erstellt einfach nur ein öffenden Link || 2.11 ||
|-
| <nowiki>{{news_feed::*}}</nowiki> || Bindet den Newsfeed aus /share/ID über die ID ein || 3.1.3 ||
|-
| <nowiki>{{calendar_feed::*}}</nowiki> || Bindet den Kalenderfeed aus /share/ID über die ID ein || 3.1.3 ||
|-

| <nowiki>{{lang::*}}</nowiki> || Mit diesem Tag können fremdsprachige Wörter in einem Text markiert werden: <nowiki>{{lang::fr}}Au revoir{{lang}}</nowiki><br />
Wird ersetzt mit <nowiki><span lang="fr" xml:lang="fr">Au revoir</span></nowiki>. || ||
|-
| <nowiki>{{iflng::*}}</nowiki> || Dieses Tag wird komplett entfernt, wenn die Sprache der Seite nicht mit der Tag-Sprache übereinstimmt. Sie können so sprachspezifische Bezeichnungen erstellen:<br />
<nowiki>{{iflng::en}}Your name{{iflng}}{{iflng::de}}Ihr Name{{iflng}}
</nowiki> || ||
|-
| <nowiki>{{image::*}}</nowiki> || Dieses Tag wird mit der Vorschauansicht eines Bildes ersetzt: <nowiki>{{image::tl_files/image.jpg?width=200&height=150}}</nowiki><br />
Argumente sind:<br />
*width - Breite des Vorschaubildes
*height - Höhe des Vorschaubildes
*alt - Alternativer Text
*class CSS-Klasse
*rel rel-Attribut (z.B. "lightbox")
*mode Modus ("proportional", "crop" oder "box") || 2.8.2 ||
|-
| <nowiki>{{label::*}}</nowiki> || Dieses Tag wird mit einer Übersetzung ersetzt: <nowiki>{{label::CNT:au}}</nowiki> oder <nowiki>{{label::tl_article:title:0}}</nowiki>.<br />Beachten Sie, dass innerhalb des Pfads zur Bezeichnung nur einfache Doppelpunkte verwendet werden. || ||
|-
| <nowiki>{{abbr::Abkürzungserklärung}}Abkürzung{{abbr}}</nowiki> || - Mit diesem Tag können Abkürzungen in einem Text markiert werden: <nowiki>{{abbr::AGG}}Allgemeines Gleichstellungsgesetz{{abbr}}</nowiki> wird ersetzt mit <nowiki><span abbr="AGG">Allgemeines Gleichstellungsgesetz</span></nowiki>. || 2.9.2 ||
|-
| <nowiki>{{acronym::Akronymerklärung}}Akronym{{acronym}}</nowiki> || - Mit diesem Tag können Akronyme in einem Text markiert werden: <nowiki>{{acronym::PISA}}Programme for International Student Assessment{{acronym}}</nowiki> wird ersetzt mit <nowiki><span acronym="PISA">Programme for International Student Assessment</span></nowiki>. || 2.9.2 ||
| colspan="3" |
|}

=== Weitere Inserttags ===
*<nowiki>{{env::ua}}</nowiki> - liefert den Useragent zurück
*<nowiki>{{env::plugins_url}}</nowiki> - liefert TL_PLUGINS_URL;
*<nowiki>{{env::script_url}}</nowiki> - liefert TL_SCRIPT_URL;
*<nowiki>{{env::files_url}}</nowiki> - liefert TL_FILES_URL;
*<nowiki>{{env::ip}}</nowiki> - liefert IP
*<nowiki>{{env::http_host}}</nowiki> - liefert den HTTP-Host
*<nowiki>{{ifnlng::XX}}</nowiki> - if '''not''' language
*<nowiki>{{request_token}}</nowiki> - Request Token
*<nowiki>{{version}}</nowiki> - Version
*<nowiki>{{last_update}}</nowiki> - letztes Update
*<nowiki>{{post}} - $arrCache[$strTag] = \Input::post($elements[1]);</nowiki>
*<nowiki>{{toggle_view}}</nowiki> - Wechselt das Seitenlayout von Desktop zu Mobil und vice versa
*<nowiki>{{br}}</nowiki> - fügt einen Zeilenumbruch ein (ab Version 3.2. RC1, nützlich in Elementen, die kein HTML erlauben)

== Inserttags in Templates verwenden ==

{{Hinweis|Dieser Abschnitt richtet sich eher an Entwickler.}}

Falls man einmal ein Insert-Tags innerhalb eines Templates verwenden möchte. Ist folgender Contao-Methode sehr wichtig.

<source lang="php"><?php echo $this->replaceInsertTags('{{link::1}}'); //Hier würde ein Link zum Artikel 1 erzeugt ?></source>

== Eigene Insert-Tags erstellen ==
Darüber hinaus gibt es Möglichkeiten, um eigene Insert-Tags zu erstellen Siehe auch: [[Eigene_insert_tags_erstellen]].

== Insert-Tags von Extensions ==

=== dlstats ===
Die Insert-Tags der Extension "dlstats" sind unter [[Dlstats#Insert-Tag_Nutzung]] aufgelistet.

=== LastLogin ===
Die Insert-Tags der Extension "LastLogin" sind ab [[LastLogin#Letzter_Login]] aufgelistet.

=== Visitors ===
Die Insert-Tags der Extension "Visitors" sind unter [[Visitors#Insert-Tags]] aufgelistet.

=== Tags ===

Die Insert-Tags der Extension "Tags" sind unter [[Tags#Insert_Tags]] aufgelistet.

=== MetaModels ===

Die Insert-Tags der Extensions "MetaModels" sind unter [[MetaModels_Insert-Tags]] aufgelistet.

Templates bearbeiten

2014-01-13T22:00:48Z

Tschero: Erweiterte Erklärung zu Contao V. 3.2.3 inkl. Bilder eingefügt

{{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}}
[[Category: Admin_HOWTOS]]
Es gibt 2 Möglichkeiten, um in Contao Templates zu bearbeiten.
=Direkt in Contao über das Backend=
Die Template-Sektion ist im Backend unter Layout --> Templates zu finden. Um ein Template zu bearbeiten, klickt man im Main-Bereich auf ''Neues Template''. Im darauffolgend angezeigten Dropdown Feld findet man eine Liste aller z.Z. existierenden Templates (sowohl die des Cores als auch die der Erweiterungen, die man einsetzt).

Das folgende Bild erklärt die Contao/TL Version 2.8.0

[[Datei:be_template_1.jpg|Templateauswahl]]

Das folgende Bild erklärt die Contao Version 3.2.3

[[Datei:be_template_1_contao_3_x.jpg|Templateauswahl]]

Man sucht sich das Template, das man bearbeiten will, aus dem Dropdown Feld aus und klickt anschliessend auf den Button ''Template erstellen'' (in diesem Fall das Template ''nav_default.tpl'', das für das Menü zuständig ist - weitere mögliche Dateinamenserweiterungen für Systeme ab Contao 2.10.x sind *.xhtml und *.html5).

{{msgWarning|Die Dateinamenerweiterung *.tpl entfällt mit der Version 2.10.x! Es sind nur die Dateierweiterungen *.xhtml und *.html5 enthalten.}}

'''Ab Contao 3: Unter ''Zielverzeichnis'' werden der Ordner ''templates'' und ein Unterodner mit Deinen Themes angzeigt. Hier unbedingt Dein Theme wählen! Templates im Ordner ''Templates'' werden nicht eingebunden.'''

Das folgende Bild erklärt die Contao/TL Version 2.8.0

[[Datei:be_template_2.jpg]]

Das folgende Bild erklärt die Contao Version 3.2.3

[[Datei:be_template_2_contao_3_x.jpg|Templateauswahl]]

In der Übersicht sieht man nur das gewählte Template. Rechts davon sind 3 Icons zu finden.
* '''Template umbennenen:''' Man kann (muss aber nicht!) das gewählte Template umbenennen.
* '''Template bearbeiten:''' Über diesen Button kann man den Quellcode des Templates bearbeiten
* '''Template löschen:''' Löscht das entsprechende Template

=Mit einem Editor über FTP=
Wer lieber mit einem Editor arbeitet, kann Templates auch manuell bearbeiten. Dazu eignet sich am besten ein Editor, welcher direkt auf dem FTP-Server arbeitet, die Template-Dateien von dort öffnet und auch wieder speichert. Z.B. [http://www.pspad.com/ PsPad], [http://notepad-plus-plus.org/ Notepad++] u.a.
{{Achtung| Niemals [[Contao-Core-Dateien|Core-Dateien]] verändern. Templates, welche man bearbeitet liegen immer im Ordner TL_ROOT/templates/}}

=Mehrere Templates verwenden=
Contao macht nun folgendes: Wenn bei der Modul-Erstellung das Orginal-Template (nav_default.tpl) ausgewählt wurde, schaut das System zuerst nach, ob in /template/ '''(Contao 3: /templates/DeinThemeName)''' ein modifiziertes nav_default.tpl liegt. Wenn ja, wird dieses verwendet. Wenn nein, wird das Orginal-Template von /system/modules/frontend/templates/ genommen.

Es ist auch möglich, mehrere modifizierte Templates zu erstellen, wenn z.B. mehrere Menü-Module angelegt werden, die unterschiedliche Templates benötigen. Hier ist es wichtig, beim Umbennenen das '''nav_''' zu erhalten. Die Templatenamen könnten z.B. so lauten: nav_custom1.tpl, nav_modify.tpl usw. Wenn man nun das Menü-Modul erstellt, werden bei der Templateauswahl alle Templates aufgelistet, die ein nav_ davor haben.

{{Achtung| Nochmals zur Erinnerung: Alle modifizierten Templates, egal ob im Orginalnamen oder umbenannt, müssen im Ordner /templates/ '''(Contao 3: /templates/DeinThemeName)''' abgespeichert werden. NIE das Orginaltemplate überschreiben!. Das hat den Vorteil, dass bei Updates die Templates in /templates/ nicht überschrieben werden, die Orginaltemplates (z.B. system/modules/frontend/templates/nav_default.tpl) jedoch schon.}}

=Links zum Thema=
[[Eigene_Templates_trotz_fehlender_Auswahlmöglichkeit|Eigene Templates trotz fehlender Auswahlmöglichkeit]]

[[Template_Variablen_anzeigen|Template Variablen anzeigen]]

[[Templates|Templates]]

Datei:Be template 2 contao 3 x.jpg

2014-01-13T21:42:52Z

Tschero:

Datei:Be template 1 contao 3 x.jpg

2014-01-13T21:41:49Z

Tschero: