Contao Community Documentation - Benutzerbeiträge [de]

Mediabox auf Deutsch

2013-04-18T09:21:38Z

Kos:

[[Kategorie:Mediabox]]
{{AppliesTo|TLVersion=ab 2.8.2}}
Oft besteht der Wunsch, die Mediabox einzudeutschen.<br />Da die Buttons dabei schon auf neutrale Symbole geändert wurden, reicht es, nur den Text "x of y" zu ändern.<br />
Dazu erstellt man eine Kopie von moo_mediabox.tpl|xhtml|html5 (z.B. moo_mediabox_de.html5) direkt über das Backend:
* "Layout" - "Templates"
* Neues Template , Auswahl moo_mediabox, Template erstellen (hier je nach Ausgabeformat das richtige auswählen)
* Template umbenennen (Bleistift) nach moo_mediabox_de (die Endung fügt Contao selber an, also vorher das richtige Template auswählen)
* Template editieren, Code anpassen wie unten gezeigt, speichern

Nun muss man im Layout noch das geänderte Template aktivieren, dazu unter:
* "Layout" - "Themes" - "Seitenlayouts" - Layout bearbeiten (Contao ab 2.9)
* "Layout" - "Seitenlayouts" - Layout bearbeiten (TYPOlight bis 2.8.x)
* hier nimmt man nun bei "MooTools-Templates" das Häkchen bei "moo_mediabox" raus und bei "moo_mediabox_de" rein.
* fertig

==Variante ab Contao 2.11 (HTML5)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script>
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.getAttribute('data-lightbox') != null;
});
$$(links).mediabox({
counterText: '<p>(Bild {x} von {y})</p>'
}, function(el) {
return [el.href, el.title, el.getAttribute('data-lightbox')];
}, function(el) {
var data = this.getAttribute('data-lightbox').split(' ');
return (this == el) || (data[0] && el.getAttribute('data-lightbox').match(data[0]));
});
};
window.addEvent('domready', Mediabox.scanPage);
</script>
</source>
Die Zeile mit "counterText" wurde eingefügt, der deutsche Text wurde noch in <nowiki><p></nowiki> Tags eingebunden.
<br /><br />

==Variante ab Contao 2.10 (XHTML)==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = TL_PLUGINS_URL . 'plugins/mediabox/'. MEDIABOX .'/css/mediaboxAdvBlack21.css|screen';

?>

<script type="text/javascript" src="<?php echo TL_PLUGINS_URL; ?>plugins/mediabox/<?php echo MEDIABOX; ?>/js/mediabox.js"></script>
<script type="text/javascript">
/* <![CDATA[ */
Mediabox.scanPage = function() {
var links = $$('a').filter(function(el) {
return el.rel && el.rel.test(/^lightbox/i);
});
$$(links).mediabox({counterText: '<p>(Bild {x} von {y})</p>'}, null, function(el) {
var rel0 = this.rel.replace(/[[]|]/gi,' ');
var relsize = rel0.split(' ');
return (this == el) || ((this.rel.length > 8) && el.rel.match(relsize[1]));
});
};
window.addEvent('domready', Mediabox.scanPage);
/* ]]> */
</script>
</source>
Der deutsche Text wurde noch in <nowiki><p></nowiki> Tags eingebunden.
<br /><br />

==Variante ab Contao 2.9.1==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css?'. MEDIABOX .'|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js?<?php echo MEDIABOX; ?>"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki><p></nowiki> Tags und einem <nowiki><br></nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird.<br />
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
<br /><br />
==Variante für Contao 2.8==
<source lang="javascript">
<?php

// Add mediabox style sheet
$GLOBALS['TL_CSS'][] = 'plugins/mediabox/css/mediabox.css|screen';

?>

<script type="text/javascript" src="plugins/mediabox/js/mediabox.js"></script>
<script type="text/javascript">
<![CDATA[//><!]]>
</script>
</source>
Der deutsche Text wurde noch in <nowiki><p></nowiki> Tags und einem <nowiki><br></nowiki> eingebunden. Grund ist ein kleiner Bug in Mediabox, der dazu führen kann, dass der Beschreibungstext nicht vollständig angezeigt wird, da die Höhe dafür falsch berechnet wird.<br />
Die Tags zwingen nun die Mediabox dazu die Höhe zu erweitern. Dadurch entstehen zwar ab und zu darunter unschöne Abstände, aber der Text ist dafür vollständig, was wichtiger ist.
<br /><br />

----
--[[Benutzer:BugBuster|BugBuster]] 23:11, 2. Jan. 2012 (CET)

MetaModels Beispiel 3

2013-03-28T11:02:15Z

Kos: /* Frontend-Modul anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgende Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-28T10:52:12Z

Kos: /* Frontend-Modul anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgende Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-28T10:51:49Z

Kos: /* Frontend-Modul anpassen */

MetaModels Beispiel 3

2013-03-28T10:50:00Z

Kos: Änderung 6939 von Kos (Diskussion) wurde rückgängig gemacht.

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-28T10:38:33Z

Kos: /* Frontend-Modul anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir folgende Änderung vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

Datei:Mm backend filter anpassen2.png

2013-03-28T10:35:54Z

Kos: hat eine neue Version von „Datei:Mm backend filter anpassen2.png“ hochgeladen

MetaModels Beispiel 4

2013-03-28T10:07:34Z

Kos: /* Filter bei MyMusic anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Paletteneinstellung==
[[File:icons_paletteneinstellungen.png|left|32px]]
Es wird eine neue Paletteneinstellung benötigt.

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

* Auf '''Neu''' klicken
* Die neue Paletteneinstellung 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_neues_atribut.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

* select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* select_id: '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* select_column: Den Namen der Spalte '''style''' auswählen
* select_alias: '''alias''' auswählen
<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 Einfache Auswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einfache Auswahl''' für das Attribut '''Stilrichtung'''
<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]]

Datei:Mm neues attribut filter.png

2013-03-28T10:04:11Z

Kos: hat eine neue Version von „Datei:Mm neues attribut filter.png“ hochgeladen: Zurückgesetzt auf die Version vom 28. März 2013, 10:01 Uhr

Datei:Mm neues attribut filter.png

2013-03-28T10:02:29Z

Kos: hat eine neue Version von „Datei:Mm neues attribut filter.png“ hochgeladen: Zurückgesetzt auf die Version vom 25. Februar 2013, 15:43 Uhr

Datei:Mm neues attribut filter.png

2013-03-28T10:01:26Z

Kos: hat eine neue Version von „Datei:Mm neues attribut filter.png“ hochgeladen

MetaModels Beispiel 3

2013-03-22T08:49:35Z

Kos: /* Neues Frontend-Modul erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T08:24:47Z

Kos: /* Published Filter im Frontend einbauen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an während man im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T08:14:27Z

Kos: /* Published Filter im Frontend einbauen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Schaut man sich jetzt wiederholt die Frontend-Liste der Musicbox an, während im BE mit dem ''veröffentlicht-Auge'' herumspielt, so stellt man keine Veränderung fest.<br>Wir müssen daher in diversen MM-Backend-Funktionen Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T07:49:21Z

Kos: /* MM-Funktion: Paletteneinstellung anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_paletteneinstellungen.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

Damit das gerade hinzugefügte Attribut auch im Backend wirksam wird, muss noch die Paletteneinstellung angepasst werden.
* Wir wählen für die Palette '''BE Erfassung''' das Icon ''Die Einstellungen der Palette ID xx bearbeiten''
* Dann ''Alle hinzufügen'' und zweimal bestätigen

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen ein paar Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T07:33:03Z

Kos: /* MM-Funktion: Ausgabevorgaben anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==MM-Funktion: Paletteneinstellung anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Paletteneinstellung für das Backend an (s. [[MetaModels_Backend:_Paletteneinstellungen|Doku zum Dialog]])

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen ein paar Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T07:14:20Z

Kos: /* MM-Funktion: Attribute anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New attribute'''
* Wähle als ''Attribute Typ'' '''Checkbox''' aus gib als ''Column name'' z.B. '''published''' ein
* Wichtig: '''check_publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen ein paar Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 3

2013-03-22T07:06:10Z

Kos: /* Start */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' entspricht bisher in etwa dem nebenstehenden Screenshot.

Hier möchten wir das Icon "Auge" (=> Eintrag veröffentlichen) einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New Attribute'''
* Wähle den Typ '''Checkbox''' aus und gibt die entsprechnden Werte ein
* Wichtig: '''Check publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen ein paar Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 2

2013-03-22T07:00:12Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

'''Wichtig:''' wenn als URL-Parameter ''auto_item'' verwendet werden soll, dann muss in den System-Einstellungen im BE im Abschnitt ''Frontend-Einstellungen'' die Option '''Den auto_item-Parameter verwenden''' angehakt sein, sonst erfolgt keine Ausgabe des Details ( =>There are no items matching your search.)

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[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
* Speichern und schliessen

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>

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-22T06:51:13Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

'''Wichtig:''' wenn als URL-Parameter ''auto_item'' verwendet werden soll, dann muss in den System-Einstellungen im BE im Abschnitt ''Frontend-Einstellungen'' die Option '''Den auto_item-Parameter verwenden''' angehakt sein, sonst erfolgt keine Ausgabe des Details ( =>There are no items matching your search.)

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[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
* Speichern und schliessen

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>

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-21T11:02:33Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

'''Wichtig:''' wenn als URL-Parameter ''auto_item'' verwendet werden soll, dann muss in den System-Einstellungen im BE im Abschnitt ''Frontend-Einstellungen'' die Option '''Den auto_item-Parameter verwenden''' angehakt sein, sonst erfolgt keine Ausgabe des Details ( =>There are no items matching your search.)

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[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
* Speichern und schliessen

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>

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-21T09:59:26Z

Kos: /* Detailansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[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
* Speichern und schliessen

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>

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-21T09:42:14Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-21T09:38:33Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-21T09:33:29Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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 Backend: Ausgabevorgaben

2013-03-21T08:31:25Z

Kos: /* Einstellungen */

{{stub}}
[[Category:MetaModels]]

=Allgemeines zu den Ausgabevorgaben=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Paletteneinstellungen| MetaModels Paletteneinstellungen]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

==Was sind eigentlich Ausgabevorgaben?==
[[File:icons_ausgabevorgaben.png|left|32px]]
Mit dem Ausgabevorgaben kann man bestimmen, welche Attribute (und in welcher Reihenfolge) in einer Ansicht gezeigt werden sollen. Z.B. möchte man in einer Liste nicht alle, sondern nur die wichtigsten vier Attribute anzeigen. Im Backend sind die Ausgabevorgaben nur für die Liste relevant. Die Eingabemaske (Formular) wird über die Paletteneinstellung gesteuert.

=Einstieg=
[[File:mm_backend_ausgabevorgaben.png|thumb|365px]]
Nachdem man über '''Neu''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
# Ausgabe bearbeiten: Erstellen und organisieren von Ansichten
# Attributseinstellungen bearbeiten: Hinzufügen und organisieren von Attributen
<div style="clear: both"></div>

=Ansicht=
==Einstellungen==
[[File:mm_backend_ausgabevorgaben_formular.png|thumb|365px]]
Hier legt man die Einstellungen fest, die später in den Frontend-Modulen als so genannte '''Anzuwendende Rendereinstellungen''' zum Tragen kommen.
* '''Name''': Name der Ansicht
* '''Standard''': Optional
* '''Template''': Standardmässig stehen 2 Templates zur Verfügung
** metamodel_prerendered (global scope)... nimmt Rücksicht auf die Reihenfolge, die man in den Attributseinstellungen vornimmt
** metamodel_unrendered (global scope) ... ignoriert die Rendersettings, man kann das Template den eigenen Wünschen anpassen
* '''Zielseite''': Wichtig, wenn man von einer Liste zu einer Detailseite springen will
* '''Filter settings''': Gibt den Filter an, der bei der Ziel zur Anwendung kommt. Gibt man keinen Filter an, wird im Frontend kein "Detail"-Link angezeigt.
<div style="clear: both"></div>

==Attribute==
[[File:mm_backend_ausgabevorgaben_liste.png|thumb|365px]]
Über '''Add all''' kann man sich alle verfügbaren Attribute dazuladen. Hier legt man fest, welche Attribute in der Ansicht gezeigt werden sollen (Icon 'Auge'). Falls man oben das Template ''' metamodel_prerendered (global scope)''' gewählt hat, nimmt dieses Template Rücksicht auf die hier gezeigte Reihenfolge.
<div style="clear: both"></div>

[[File:mm_backend_ausgabevorgaben_liste_detail.png|thumb|365px]]
Jedes Attribute verfügt über ein eigenes Template. Auf Wunsch kannt man natürlich auch hierauf Zugriff nehmen.

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

=Templateanpassungen=
Die grösste Einflussmöglichkeit ein eigenes Design zu implementieren, besteht in der Anpassung des Templates '''metamodels_prerendered.html5'''.

==Original==
<source lang="php">
<?php if (count($this->data)): /* display only if there is data. */ ?>
<div class="layout_full">
<?php foreach ($this->data as $arrItem): /* loop over all items. */ ?>

<div class="item <?php echo $arrItem['class']; ?>">
<?php foreach ($arrItem['attributes'] as $field => $strName): /* loop over all attributes. */ ?>
<?php if (($strValue = $arrItem[$this->getFormat()][$field]) || ($strValue = $arrItem['text'][$field])): /* fetch the html5 value followed by the fallback to "text" as both are suitable. */ ?>
<div class="field <?php echo $field; ?>">
<span class="label"><?php echo $strName; ?></span>: <span class="value"><?php echo $strValue; ?></span>
</div>
<?php endif; ?>
<?php endforeach; /* attribute loop */ ?>
<?php if ($arrItem['jumpTo']): ?>
<a href="<?php echo $arrItem['jumpTo']['url']; ?>">Details</a>
<?php endif; ?>
</div>
<?php endforeach; /* item loop */ ?>
</div>
<?php else: /* no items found */ ?>
<p class="info"><?php echo $this->noItemsMsg; ?></p>
<?php endif; ?>

</source>

==Mögliche Anpassung==
Klassischerweise werden über ein Loop (foreach) die Attribute aus einem Objekt (item) ausgelesen. Diese werden dann in ein field gepackt und über label bzw. value ausgegeben. Wenn man hier mehr Gestaltungsfreiheiten haben möchte, muss man die Attribute eines Items einzelnen ('MeinAttribut') ansprechen:<br>
Der Feldtitel... <?php echo $arrItem['attributes']['MeinAttribut']; ?> bzw. <br>
Der Wert des Feldes... <?php echo $arrItem['text']['MeinAttribut']; ?>

Wer sich mit HTML und CSS auskennt, kann sich hier ein eigenes Template zurecht schustern.

<source lang="php">

<?php if (count($this->data)): /* display only if there is data. */ ?>
<div class="layout_full">
<?php foreach ($this->data as $arrItem): /* loop over all items. */ ?>

<div class="item <?php echo $arrItem['class']; ?>">
<h1><?php echo $arrItem['text']['title']; ?> (<?php echo $arrItem['text']['year']; ?>)</h1>
<div class="content">
<div class="field composer">
<span class="label"><?php echo $arrItem['attributes']['composer']; ?></span>
<span class="value"><strong><?php echo $arrItem['text']['composer']; ?></strong></span>
</div>
<div class="field style">
<span class="label"><?php echo $arrItem['attributes']['style']; ?></span>
<span class="value"><?php echo $arrItem['text']['style']; ?></span>
</div>
<div class="field country">
<span class="label"><?php echo $arrItem['attributes']['country']; ?></span>
<span class="value"><?php echo $arrItem['text']['country']; ?></span>
</div>
<div class="field description">
<span class="label"><?php echo $arrItem['attributes']['description']; ?></span>
<span class="value"><?php echo $arrItem['text']['description']; ?></span>
</div>
<div class="field web">
<span class="label"><?php echo $arrItem['attributes']['web']; ?></span>
<span class="value"><a href="<?php echo $arrItem['text']['web']; ?>"><?php echo $arrItem['text']['web']; ?></a></span>
</div>
<div class="field images">
<span class="label"><?php echo $arrItem['attributes']['images']; ?></span>
<span class="value"><?php echo $arrItem['html5']['images']; ?></span>
</div>
</div>
<div class="clear"></div>
</div>

<?php if ($arrItem['jumpTo']): ?><a href="<?php echo $arrItem['jumpTo']['url']; ?>">Zurück zur Liste</a><?php endif; ?>
<?php endforeach; /* item loop */ ?>
</div>

<?php else: /* no items found */ ?><p class="info"><?php echo $this->noItemsMsg; ?></p>
<?php endif; ?>

</source>

MetaModels Beispiel 3

2013-03-20T08:07:27Z

Kos: /* MM-Funktion: Attribute anpassen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=Aufgabenstellung: Weitere Filter einrichten=
Wir bauen einen Mechanismus ein, mit dem wir entscheiden können, welcher der im MetaModel '''Musikbox''' erfassten Datensätze im Frontend erscheinen soll und welcher nicht. Mit dem speziellen Attribut "Published State" lässt sich so was einrichten und über einen Filter im Frontend steuern.
Darüber hinaus möchten wir die Listenansicht im Frontend etwas interaktiver gestalten, indem wir einen Filter als HTML-Select im Frontend zur Verfügung stellen, der die Liste z.B. nach Länder ausfiltert.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[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

=Published Filter im Backend einbauen=

==Start==
[[File:mm_backend_anpassen0.png|thumb|400px]]
Die Übersichtsliste in unserer Musiksammlung '''MyMusic''' sieht noch wie nebenan aus.

Hier möchten wir das Icon "Auge" einfügen, dass wir von anderen Contao-Backend Funktionen kennen.
<div style="clear: both"></div>

==MM-Funktion: Attribute anpassen==

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

Hier erfassen wir das neue Attribut (s. auch [[MetaModels_Backend:_Attribute|Doku zum Dialog]])

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''New Attribute'''
* Wähle den Typ '''Checkbox''' aus und gibt die entsprechnden Werte ein
* Wichtig: '''Check publish''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

Nun kann man in den entsprechenden anderen MM-Backend-Funktionen, die weiteren Anpassung vornehmen.
<div style="clear: both"></div>

==MM-Funktion: Ausgabevorgaben anpassen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wir passen die Listendarstellung für das Backend an (s. [[MetaModels_Backend:_Ausgabevorgaben|Doku zum Dialog]])

[[File:mm_backend_anpassen2.png|thumb|400px]]
* Wir wählen die Attributseinstellungen von "BE Listenansicht"
* Wähle "Add all" aus
* Es gibt einen automatischen Check welche Attribute bereits in die Rendersettings geladen wurden und welche nicht. Das neue Attribut "Veröffendlicht" wird hinzugefügt
* Es wird am Ende der Attributsliste hinzugefügt

Damit sind die eigentlichen Anpassungen für das Backend schon abgeschlossen.
<div style="clear: both"></div>

==Backendliste "MyMusik" nochmals prüfen==

[[File:mm_backend_anpassen3.png|thumb|400px]]
Wenn wir jetzt unsere Übersichtsliste in unserer Musiksammlung "MyMusic" nochmals ansehen, entdecken wir das Icon "Auge".
<br>Nun können wir im Backend steuern, ob ein Musikstück im Frontend angezeigt werden soll oder nicht.

Damit das geschieht, müssen wir noch einen Filter erstellen, der den jeweiligen Frontend-Ansichten sagt, dass nur markierte Musikstücke veröffentlicht werden sollen.
<div style="clear: both"></div>

=Published Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen ein paar Veränderungen vornehmen

==MM-Funktion: [[MetaModels_Backend:_Filter|Filter definieren]]==
Wir erstellen einen neuen Filter: "FE Filter published"

[[File:mm_backend_filter_anpassen1.png|thumb|400px]]
* Wir wählen "neu", bestätigen mit weiter
* Wir wählen den Typ "Published state", wählen hierzu das vorhin erfasste Attribut " Veröffentlicht [checkbox]" und aktivieren diesen neuen Filter "FE Filter published
* ... und kehren zurück zur Filter-Übersichtsliste
<div style="clear: both"></div>

==Frontend-Modul anpassen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen2.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir wählen hier das Modul, das für unsere Frontend-Ansicht zuständig ist. In unserem Fall das FE-Modul "MM - MyMusik Liste"

Dort nehmen wir an folgenden Stellen zwei Änderungen vor:

* Bei "Anzuwendende Filtereinstellungen" wählen wir den neu erstellen Filter "FE Filter Published" an
* Als Filter Value für das Attribut "Veröffentlicht" wählen wir den Wert "1" ( 1 steht bei Checkboxen ganz allgemein für "angeklickt")

Ab sofort werden im Frontend nur noch die Datensätze angezeigt, die wir in unserer Backend-Liste "MyMusik" mit dem Icon "Auge" markiert haben.
<div style="clear: both"></div>

=Select Filter im Frontend einbauen=
Hier müssen wir in diversen MM-Backend-Funktionen diverse Veränderungen vornehmen

==MM-Funktion: Filter definieren==
Wir nehmen den neuen Filter, ergänzen diesen und geben ihm einen neuen Namen "FE Filter published/Country". Dieser angepasste Filter muss zwei Bedingungen erfüllen:
* Er soll wie bisher nur die publizierten Musikstücke anzeigen
* Er soll nur die Länder anzeigen, die wir über ein Select anwählen, das über der FE Liste angezeigt wird

[[File:mm_backend_filter_anpassen3.png|thumb|400px]]
* Wir wählen die Filtereinstellungen des "Filters FE Filter published"
* Wir wählen "neu" und setzen die neue Einstellung unterhalb der Einstellung "Published State" ein
* Wir nehmen den Typ "Einfache Auswahl", weisen das Attribut "Land [text]" zu und aktivieren diesen
* Optional wählen wir noch die Option "Leerer Wert" an. Dies bewirkt, dass im späteren Select überhalb unserer Länderauswahl ein leerer Eintrag generiert wird
* Wir "Speichern und schliessen" den Dialog

Nun erscheint uns neu der Filter "FE Filter published" als eine Kombination von 2 Filtereinstellungen. Man kann sich nun leicht vorstellen, wie komplex man sich diesen Filter bauen kann, wenn man will.
<div style="clear: both"></div>

==Neues Frontend-Modul erstellen==

[[File:mm_backend_filter_anpassen4.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir erstellen hier ein neues Frontend-Modul
* Wir wählen hierzu den Modultyp "MetaModels Filter" und geben ihm den Namen "MM - MyMusik Filter"
<div style="clear: both"></div>

==Bestehendes Frontend-Modul anpassen==
[[File:mm_backend_filter_anpassen5.png|thumb|400px]]
* Wir gehen über die Themes zu unseren Frontend-Modulen
* Wir nehmen das  Frontend-Modul "MM - MyMusik Liste"
* Wir sortieren nach "Land" und "Aufsteigend"
* Neu ist nun, dass wir hier unter "anzuwendende Filtereinstellungen" den überarbeiteten Filter "FE Filter published" nehmen

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

==Bestehenden Artikel anpassen==
[[File:mm_backend_filter_anpassen6.png|thumb|400px]]
* Wir gehen nun zu unserem Artikel, wo wir einst unser Frontend-Modul "MM - MyMusic Liste" verbaut haben
* Darüber erstellen wir neu ein weiteres Inhaltselement, ein weiteres Frontend-Modul. Diesmal das neu erstellte FE-Modul "MM - MyMusic Filter"
* to be continued
<div style="clear: both"></div>

=Frontend Ansicht=
Die FE-Liste erscheint nun neu mit einem HTML-Select. Über die Auswahl lässt sich nun die darunterliegende Liste länderspezifisch verkürzen.<br>

[[File:mm_frontend_beispiel_filter.png|link=|900px]]

[[MetaModels_Beispiel_2|Zurück zur Beispiel 2]] | [[MetaModels_Beispiel_4|Weiter Beispiel 4: Weiter MetaModels hinzufügen]]

MetaModels Beispiel 1

2013-03-19T11:13:28Z

Kos: /* BE-Liste */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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===

* Obwohl es so aussieht, als sei '''Übersetzung''' eine frei wählbare Option, ist "diese Option" ein MUSS, denn ohne Sprachenzuweisung funktioniert das ganze MetaModel nicht!
* '''Varianten unterstützen''' wird vorläufig nicht benötigt.... und gegebenenfalls zu einem späteren Zeitpunkt erläutert.

===Auszuführen===

* '''Übersetzung''' anhaken
* mindestens eine unterstützte Sprache auswählen
* eine Sprache (z.B. '''Deutsch''') zum Fallback machen
* '''Varianten aktivieren''' vorerst nicht anhaken

Man sieht nun ein MetaModel "Musicbox" mit 0 (null) Datensätzen und einer Reihe von Icons, die nun zur Weiterbearbeitung genutzt werden.

<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 bie der Erstellung eines neuen MetaModels. Hier kann man jederzeit sowohl den '''Namen''' als auch den '''Tabellennamen''' des MetaModels ändern.

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Definieren Sie die Attribute in MetaModel)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Definieren Sie Ausgabevorgaben für das MetaModel)
# [[MetaModels_Backend:_Paletteneinstellungen|'''Paletteneinstellungen''']] (Paletteneinstellungen für das MetaModel definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Definieren Sie Filter für das MetaModel)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''Paletten- und Ansichtseinstellungen''']] (Paletten- und Ansichtseinstellungen für MetaModel festlegen)

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

* Klick auf '''neu'''
* '''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: Paletteneinstellung==

[[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 Palette''' öffnet sich ein [[MetaModels_Backend:_Paletteneinstellungen|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

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

Nun wurde eine Palette namens '''BE Erfassung''' erstellt. Im Folgenden wird nun das Erfassungs-Formular ein wenig gestaltet.

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<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 kan 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_backend_zugriffsrechte_definieren.png|link=MetaModels_Backend:_Ansichtseinstellungen|600px]]

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

2013-03-14T15:28:32Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-14T15:27:42Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-14T11:49:04Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-14T11:42:28Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-14T11:17:15Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

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

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>
{{Hinweis|Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-14T11:16:28Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

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

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail".<br>(''sollte der Filter nicht angezeigt werden, dann hilft =>speichern weiter'')
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>
{{Hinweis|Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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 4

2013-03-14T10:04:08Z

Kos: /* MM Funktion: Ausgabevorgaben */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Paletteneinstellung==
[[File:icons_paletteneinstellungen.png|left|32px]]
Es wird eine neue Paletteneinstellung benötigt.

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

* Auf '''Neu''' klicken
* Die neue Paletteneinstellung 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_neues_atribut.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

* select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* select_id: '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* select_column: Den Namen der Spalte '''style''' auswählen
* select_alias: '''alias''' auswählen
<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 Und-Bedingung
** eine Einfache Auswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einfache Auswahl''' für das Attribut '''Stilrichtung'''
<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

2013-03-14T10:03:12Z

Kos: /* MM Funktion: Ausgabevorgaben */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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
<div style="clear: both"></div>

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

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

* Auf '''Neu''' klicken
* Die neue Paletteneinstellung 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_neues_atribut.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

* select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* select_id: '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* select_column: Den Namen der Spalte '''style''' auswählen
* select_alias: '''alias''' auswählen
<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 Und-Bedingung
** eine Einfache Auswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einfache Auswahl''' für das Attribut '''Stilrichtung'''
<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 1

2013-03-14T09:30:22Z

Kos: /* Anmerkung */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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===

* Obwohl es so aussieht, als sei '''Übersetzung''' eine frei wählbare Option, ist "diese Option" ein MUSS, denn ohne Sprachenzuweisung funktioniert das ganze MetaModel nicht!
* '''Varianten unterstützen''' wird vorläufig nicht benötigt.... und gegebenenfalls zu einem späteren Zeitpunkt erläutert.

===Auszuführen===

* '''Übersetzung''' anhaken
* mindestens eine unterstützte Sprache auswählen
* eine Sprache (z.B. '''Deutsch''') zum Fallback machen
* '''Varianten aktivieren''' vorerst nicht anhaken

Man sieht nun ein MetaModel "Musicbox" mit 0 (null) Datensätzen und einer Reihe von Icons, die nun zur Weiterbearbeitung genutzt werden.

<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 bie der Erstellung eines neuen MetaModels. Hier kann man jederzeit sowohl den '''Namen''' als auch den '''Tabellennamen''' des MetaModels ändern.

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Definieren Sie die Attribute in MetaModel)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Definieren Sie Ausgabevorgaben für das MetaModel)
# [[MetaModels_Backend:_Paletteneinstellungen|'''Paletteneinstellungen''']] (Paletteneinstellungen für das MetaModel definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Definieren Sie Filter für das MetaModel)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''Paletten- und Ansichtseinstellungen''']] (Paletten- und Ansichtseinstellungen für MetaModel festlegen)

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

* Klick auf '''neu'''
* '''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: Paletteneinstellung==

[[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 Palette''' öffnet sich ein [[MetaModels_Backend:_Paletteneinstellungen|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. Sie können auch über das Icon rechts abgerufen werden. Man kann diese optisch voneinander trennen, indem man zwischen die Werte entweder ein Komma (,) oder ein Semikolon (;) schreibt.
* 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
===Anmerkung===
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.

Nun wurde eine Palette namens '''BE Erfassung''' erstellt. Im Folgenden wird nun das Erfassungs-Formular ein wenig gestaltet.

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<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 kan 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_backend_zugriffsrechte_definieren.png|link=MetaModels_Backend:_Ansichtseinstellungen|600px]]

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

2013-03-14T09:06:16Z

Kos: /* MM-Funktion: Attribute */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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===

* Obwohl es so aussieht, als sei '''Übersetzung''' eine frei wählbare Option, ist "diese Option" ein MUSS, denn ohne Sprachenzuweisung funktioniert das ganze MetaModel nicht!
* '''Varianten unterstützen''' wird vorläufig nicht benötigt.... und gegebenenfalls zu einem späteren Zeitpunkt erläutert.

===Auszuführen===

* '''Übersetzung''' anhaken
* mindestens eine unterstützte Sprache auswählen
* eine Sprache (z.B. '''Deutsch''') zum Fallback machen
* '''Varianten aktivieren''' vorerst nicht anhaken

Man sieht nun ein MetaModel "Musicbox" mit 0 (null) Datensätzen und einer Reihe von Icons, die nun zur Weiterbearbeitung genutzt werden.

<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 bie der Erstellung eines neuen MetaModels. Hier kann man jederzeit sowohl den '''Namen''' als auch den '''Tabellennamen''' des MetaModels ändern.

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Definieren Sie die Attribute in MetaModel)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Definieren Sie Ausgabevorgaben für das MetaModel)
# [[MetaModels_Backend:_Paletteneinstellungen|'''Paletteneinstellungen''']] (Paletteneinstellungen für das MetaModel definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Definieren Sie Filter für das MetaModel)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''Paletten- und Ansichtseinstellungen''']] (Paletten- und Ansichtseinstellungen für MetaModel festlegen)

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

* Klick auf '''neu'''
* '''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: Paletteneinstellung==

[[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 Palette''' öffnet sich ein [[MetaModels_Backend:_Paletteneinstellungen|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. Sie können auch über das Icon rechts abgerufen werden. Man kann diese optisch voneinander trennen, indem man zwischen die Werte entweder ein Komma (,) oder ein Semikolon (;) schreibt.
* 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
===Anmerkung===
Die Option '''Sortierung''' ist beim erstmaligen Aufruf der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.

Nun wurde eine Palette namens '''BE Erfassung''' erstellt. Im Folgenden wird nun das Erfassungs-Formular ein wenig gestaltet.

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<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 kan 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_backend_zugriffsrechte_definieren.png|link=MetaModels_Backend:_Ansichtseinstellungen|600px]]

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

2013-03-13T10:52:55Z

Kos: /* MM-Funktion: Attribute */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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
* Alle Attribute hinzufügen
* Speichern und schliessen
<div style="clear: both"></div>

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

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

* Auf '''Neu''' klicken
* Die neue Paletteneinstellung 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_neues_atribut.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

* select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* select_id: '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* select_column: Den Namen der Spalte '''style''' auswählen
* select_alias: '''alias''' auswählen
<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 Und-Bedingung
** eine Einfache Auswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einfache Auswahl''' für das Attribut '''Stilrichtung'''
<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

2013-03-13T10:50:21Z

Kos: /* Leeres MetaModel */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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|link=|left|730px]]

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
* Alle Attribute hinzufügen
* Speichern und schliessen
<div style="clear: both"></div>

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

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

* Auf '''Neu''' klicken
* Die neue Paletteneinstellung 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_neues_atribut.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

* select_table: Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen. Ausgewählt wird die neue Tabelle '''mm_select_style'''
* select_id: '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* select_column: Den Namen der Spalte '''style''' auswählen
* select_alias: '''alias''' auswählen
<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 Und-Bedingung
** eine Einfache Auswahl für das Attribut (Stilrichtung)
<div style="clear: both"></div>

[[File:mm_neues_attribut_filter2.png|thumb|400px]]
* Nebenan die Anpassung der Einstellung '''Einfache Auswahl''' für das Attribut '''Stilrichtung'''
<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

2013-03-12T10:03:08Z

Kos: /* Detailansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon ''Filterattribute für Filtereinstellungen definieren''
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>
{{Hinweis|Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T09:28:24Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon ''Filterattribute für Filtereinstellungen definieren''
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>
{{Hinweis|Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T09:07:03Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>
{{Hinweis|Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}

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

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T08:47:46Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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
===Hinweis===
Einige Einstellmöglichkeiten in den Bereichen '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.
<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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T08:44:42Z

Kos: /* Frontend-Module erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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
===Hinweis===
Einige Einstellmöglichkeiten in den Bereiche '''MetaModell Filter''' und '''Template-Einstellungen''' sind erst nach einer Zwischenspeicherung des Moduls erreichbar.
<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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T07:56:07Z

Kos: /* Detailansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.<br>Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T07:40:30Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" und "FE Listenansicht" an. Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T07:31:01Z

Kos: /* Listenansicht erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klicke hierzu auf das Icon "Globus", wähle die Seite aus dem Pulldown-Menu aus, automatisch wird dann die link_url::ID eingesetzt
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Neu erscheinen nun zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" und "FE Listenansicht" an. Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-12T07:30:22Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.

<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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klick hierzu auf das Icon "Globus", wähle die Seite aus dem Pulldown-Menu aus, automatisch wird dann die link_url::ID eingesetzt
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Neu erscheinen nun zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" und "FE Listenansicht" an. Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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

2013-03-11T16:32:39Z

Kos: /* Einfachen Filter erstellen */

[[Category:Admin HOWTOS]]
[[Category:MetaModels]]

=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]] - Eingeben der Sammlung
# [[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: Möchte man mit MetaModels aus einer Liste von Einträgen einen einzigen anzeigen lassen und diese Einzelansicht vielleicht auch noch leicht anders anzeigen lassen, benötigt man einen Filter.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden). Klick auf '''neu'''
* Gib einen Namen ein, z.B. "FE Link Detail" (FE steht für Frontend)
* Die Filterübersicht zeigt nun einen ersten Eintrag. Wähle das rechte Icon "Filter einrichten"
* Klick auf '''neu''' und wähle das Icon (mit Pfeil) für '''einsetzen'''
* Nun kannst du den Typ auswählen. Wir wählen '''Einfache Abfrage'''
* Als Attribut wählen wir "Alias" und geben noch die URL-Parameter "auto_item" mit
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als Template nehmen wir was vorgegeben wird: "mm_filteritem_default"
* "Speichern und Schliessen"

Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen. 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. Wir klicken auf "neu"
* Gib den Namen "FE Listenansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* Als Zielseite geben wir die vorhin definierte Seite "Music" an. Klick hierzu auf das Icon "Globus", wähle die Seite aus dem Pulldown-Menu aus, automatisch wird dann die link_url::ID eingesetzt
* Als Filtersettting wählen wir den vorhin definierten Filter "FE Link Detail"
* "Speichern und schliessen"
* Neu erscheinen nun zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legen wir grob fest, welches Aussehen (Template) die Seite haben, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).
Hinweis: Wenn wir hier keinen Filter angeben, wird später im Frontend kein "Detail"-Link erscheinen.

<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 "Add all" (geht schneller und einfacher als alle über "neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

Man kann auch die Einstellung der Attribute anschauen, wie im letzten Screen angezeigt. Standardmäßig wird jedem Attribut zusätzlich ein Template mitgegeben. In unserem Beispiel analog dem Typ das Template "mm_attr_text (global scope)".
Man erkennt hier schon im Ansatz, dass in MetaModels praktisch jedes Detail über ein Template gesteuert wird. Was für eine mögliche Individualisierung letztlich heißt, dass man in der freien Gestaltung potentiell unendliche viele Möglichkeiten zur Verfügung gestellt bekommt.

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

==Detailansicht erstellen==

[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]]

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" und "FE Listenansicht" an. Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Speichern und schliessen

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

==Frontend-Module erstellen==

[[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 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 Anzunehmende 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 Ansichtsdarstellung 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>

=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
[[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 wir in den Rendereinstellungen definiert haben. 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 Backend: Eingabemaske

2013-03-11T16:08:03Z

Kos: /* URL */

{{stub}}
[[Category:MetaModels]]

=Allgemeines zu den Paletteneinstellungen=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Paletteneinstellungen| MetaModels Paletteneinstellungen]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

==Was sind eigentlich Paletteneinstellungen?==
[[File:icons_paletteneinstellungen.png|left|32px]]
Mit den Paletteneinstellungen wird im Wesentlichen das Aussehen der Datenerfassung im Backend gesteuert. Es beantwortet die folgenden Fragen:
* Wo werden die Daten erfasst?
* Wie sieht die Übersichtsliste aus?
* Wie kann ich die Übersichtliste organisieren?
* Wie sieht das Erfassungsformular aus?
* Wie kann ich das Aussehen des Erfassungsformulars beeinflussen?

=Einstieg=
[[File:mm_backend_paletteneinstellungen.png|thumb|400px]]
Nachdem man über '''Neue Palette''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
# Palette bearbeiten: Erstellen und organisieren der BE Liste
# Paletteneinstellungen bearbeiten: Erstellen und organisieren des BE Formulars
<div style="clear: both"></div>

=Backend Liste=
==Palette==
[[File:mm_backend_paletteneinstellungen_palette.png|thumb|400px]]
Nachdem man über '''Neue Palette''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
* '''Name''': Name der Palette
* '''Panel-Layout''': Damit lässt sich die BE Liste organisieren. 4 Werte stehen zur Verfügung: filter, sort, search und limit. Mit Komma oder Semikolon steuert man die Darstellung (siehe nächster Screen)
* '''Integration''': Als Einzeltabelle, Als Kindtabelle
* '''Sortiermodus''':
** 0 Datensätze unsortiert darstellen,
** 1 Datensätze nach bestimmtem Feld sortiert darstellen,
** 2 Datensätze nach wählbarem Feld sortiert darstellen,
** 5 Baumdarstellung (wie Seitenstruktur)
* '''Sortierung''': Aufsteigend, Absteigend
* '''Backend-Bereich''': Hier kann man auswählen, wo in der Backend-Navigation (links) der Eintrag 'MyMusic' erscheinen soll
* '''Backend-Icon''': Optional kann man sein eigenes Icon anzeigen lassen
* '''Backend-Beschreibung''': Sprache, Menutext (Name deiner BE Liste), Beschreibung (Tooltip)

==Panel-Layout==
[[File:mm_backend_paletteneinstellungen_panel.png|thumb|400px]]
Die Einträge unter dem Panel-Laout bestimmen, ob und wie die einzelnen Funktionen erscheinen.

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

=Backend Formular=
==Attribute==
[[File:mm_backend_paletteneinstellungen_liste.png|thumb|400px]]
Nachdem man über '''Alle hinzufügen''' alle Attribute hinzugefügt hast, kannt man die Liste per Drag&Drop organisieren. Die Reihenfolge legt fest, in welcher Reihenfolge die Eingabefelder im Erfassungsformular erscheinen.
<div style="clear: both"></div>

==Attribut bearbeiten==
[[File:mm_backend_paletteneinstellungen_attribut.png|thumb|400px]]
Jedes Attribut hat gemäss seinem Typ spezifische Einstelloptionen. Was sie jedoch alle gemein haben, sind die so genannten '''Backend-Classes'''. Darüber lassen sich die Eingabefelder ein wenig gestalten. Folgende CSS-Klassen stehen zur Verfügung:
* '''w50''': Die Breite auf 50% festlegen und nach links floaten.
* '''clr''': Alle Floats clearen.
* '''long''': Vergrößert das Eingabefeld, sodass es zwei Spalten umfasst.
* '''wizard''': Das Eingabefeld kürzen, sodass Platz für einen Wizard ist (z.B. einen Date-Picker).
* '''m12''': Dem Element einen oberen Abstand (top-margin) von 12 Pixel geben (für einzelne Checkboxen).
<div style="clear: both"></div>

==Das Backend-Formular==
[[File:mm_backend_paletteneinstellungen_formular.png|thumb|400px]]
Und so könnte das Backend-Formular in etwa aussehen. Rot gekennzeichnet die Backend-Klassen, die den Attributen mitgegeben wurden.
<div style="clear: both"></div>

=Paletteneinstellungen=

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

==Auswahl (Select)==
[[File:mm_paletteneinstellungen_select.png|thumb|400px]]
<div style="clear: both"></div>

==Checkbox==
Details folgen

==Datei==
Details folgen

==Dezimal==
Details folgen

==GeoProtection==
Details folgen

==Longtext==
[[File:mm_paletteneinstellungen_longtext.png|thumb|400px]]
Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.
<div style="clear: both"></div>

==Numerisch==
Details folgen

==Sprachcode==
Details folgen

==Tags==
Details folgen

==Text==
Details folgen

==Timestamp (Datum)==
[[File:mm_paletteneinstellungen_timestamp.png|thumb|400px]]
<div style="clear: both"></div>

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

==Timestamp (Datum)==
Details folgen

==URL==
Details folgen

==Übersetztes Alias==
Details folgen

==Übersetzte Datei==
Details folgen

==Übersetzter Longtext==
Details folgen

==Übersetzte Auswahl==
Details folgen

==Übersetzte Tags==
Details folgen

==Übersetzter Text==
Details folgen