Contao Community Documentation - Benutzerbeiträge [de]

MetaPalettes

2018-04-26T21:04:51Z

Zonky: /* MetaPalettes::appendFields(..) & MetaPalettes::prependFields(..) */

Mit der Erweiterung MetaPalettes lassen sich die DCA Paletten in einem Array, statt einem String definieren. Dadurch wird es einfacher die Paletten später zu verändern.
[[Kategorie:Extensions]]
{{ExtInfo
| Dev=Contao Community Alliance
| ExtVersion=2.0.0
| Version=4.4+ (Version 1.11 ist sowohl mit Contao >= 3.5 und Contao 4.4 kompatibel)
| ERLink=http://www.contao.org/erweiterungsliste/view/metapalettes.de.html
}}

MetaPalettes generiert aus einem Mehrdimensionalen-Array das im DCA festgelegt wird die Haupt- und Unterpaletten.

=Anwendungsbeispiel=

Beispiel für eine MetaPalette aus der Erweiterung [[htaccess]]:
<source lang="php">
/**
* DCA tl_htaccess
*/
$GLOBALS['TL_DCA']['tl_htaccess'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'default' => array
(
'htaccess_settings' => array(':hide', 'htaccess_load_settings'),
'htaccess_base' => array('htaccess_template'),
'htaccess_etag' => array('htaccess_etag_disable'),
'htaccess_mime' => array('htaccess_mime_types'),
'htaccess_deflate' => array('htaccess_deflate_files'),
'htaccess_headers' => array(),
'htaccess_expires' => array('htaccess_expires_default', 'htaccess_expires'),
'htaccess_custom' => array('htaccess_custom'),
'htaccess_rewrite' => array('htaccess_rewrite_rules', 'htaccess_rewrite_prepend_www', 'htaccess_rewrite_remove_www', 'htaccess_rewrite_gzip', 'htaccess_rewrite_suffix'),
'htaccess_h5bp' => array('htaccess_h5bp_ie_x_ua_compatible', 'htaccess_h5bp_cross_domain_ajax', 'htaccess_h5bp_concatenation_include', 'htaccess_h5bp_ie_flicker_fix')
)
),
...
);
</source>

Anstelle einer <code>palette</code> wird ein Feld <code>metapalette</code> definiert. Die Schlüssel für das Array definieren wie gewohnt die Palette, jedoch werden die einzelnen Abschnitte mit den Feldern nicht als Zeichenkette, sondern als Array definiert. Der Schlüssel aus dem Meta Array beschreibt den Abschnitt, darunter kommt wiederum als Array die Felder.

=Paletten definieren=

Am besten zeigt sich der Zusammenhang an einem kleinen Beispiel:
<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'metapalettes' => array
(
'default' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
)
)
...
);
</source>

Daraus wird:
<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'palettes' => array
(
'default' => '{chapter_one_legend},field_one,field_two;{chapter_two_legend:hide},field_three'
)
...
);
</source>

Der Array Key definieren jeweils die Legende für den Abschnitt, das '''_legend''' wird dabei automatisch hinzugefügt.

==:hide und andere Modifikatoren==

Eine Palette kann versteckt angezeigt werden, wie oben chapter_two: <code>{chapter_two_legend:hide}</code>.
Dazu muss einfach das Schlüsselwort <code>:hide</code> in das Felder-Array hinzugefügt werden.
MetaPalettes betrachtet alle mit ''':''' beginnenden Felder als Modifikatoren, diese werden aus der Feldliste extrahiert.
Zur Zeit wird aber nur das Schlüsselwort <code>:hide</code> unterstützt.

=Subpaletten definieren=

Auch Subpaletten lassen sich definieren:
<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'metasubpalettes' => array
(
'field_three' => array('field_four', 'field_five')
)
...
);
</source>

Daraus wird:
<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'palettes' => array
(
'__selector__' => array('field_three'),
...
),

'subpalettes' => array
(
'field_three' => 'field_four,field_five'
)
...
);
</source>

Das <code>__selector__</code> Array wird automatisch gefüllt, es ist also nicht mehr notwendig dieses Array von Hand zu befüllen.

=SubSelectpaletten definieren=
(seit Version 1.2.0)

Normalerweise verwendet Contao <code>select</code> Felder, die als Selectoren markiert sind dazu eine Palette auszuwählen. Das ist allerdings nicht immer sinnvoll, weil man dann viele Paletten definieren muss, die oft stark redundant sind. Mit SubSelectpaletten ist es möglich, ähnlich den Subpaletten einer Checkbox ''Untermengen'' von Feldern den einzelnen Select Werten zuzuordnen.

<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'metapalettes' => array
(
'default' => array
(
'example' => array('subselect_field')
)
),
...
'metasubselectpalettes' => array
(
'subselect_field' => array
(
'value1' => array('value1_subfield1', 'value1_subfield2'),
'value2' => array('value2_subfield1'),
'value3' => array('value3_subfield1', 'value3_subfield2', 'value3_subfield3')
)
),
...
'fields' => array
(
'subselect_field' => array
(
'label' => array('SubSelect Example', 'Switch field and see how the subfields changing'),
'inputType' => 'select',
'options' => array('value1', 'value2', 'value3'),
'eval' => array('submitOnChange'=>true)
)
)
);
</source>

Um die Definition einfacher zu gestalten, kann man mit einem '''!''' (Ausrufezeichen) vor dem Wert auch Negativ-Paletten definieren. Diese werden immer dann angezeigt, wenn ein Wert nicht ausgewählt ist.

<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'metasubselectpalettes' => array
(
'subselect_field' => array
(
'value1' => array('value1_subfield1', 'value1_subfield2'),
'!value2' => array('value2_subfield1'),
'value3' => array('value3_subfield1', 'value3_subfield2', 'value3_subfield3')
)
)
...
);
</source>
Das Feld '''value2_subfield1''' wird immer dann angezeigt, wenn '''value1''' oder '''value3''' ausgewählt sind.

=Paletten ergänzen=

Ab Version 1.1 kann man vorhandene Paletten ganz einfach ergänzen. Dazu stehen 3 '''statische''' Methoden zur Verfügung. Ab Version 1.11 ist die Klasse unter dem Namespace "ContaoCommunityAlliance\MetaPalettes\MetaPalettes" zu finden, der auch in Version 2.0 verwendet wird. Die alten Namespaces "MetaPalettes" und "Bit3\MetaPalettes\MetaPalettes" stehen in Version 2 nicht mehr zur Verfügung!
{{Hinweis|Um möglichst mit anderen Erweiterungen kompatibel zu sein, empfiehlt es sich sowohl Version 2 und 1 zu unterstützen. Mit der Versionsanforderung "^2.0 || ^1.11" ist dies möglich. Selbstredend sollten dann nur Features verwendet werden, die in beiden Versionen funktionieren.}}

==MetaPalettes::appendTo(..)==

Fügt eine Meta Palette am Ende hinzu.

<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::appendTo('tl_settings', array(
'my_custom_settings' => array(':hide', 'my_custom_field1', 'my_custom_field2', 'my_custom_field3')
));
</source>
Fügt den Block '''my_custom_settings''' am Ende der '''default''' Palette von '''tl_settings''' hinzu.

Wenn eine andere Palette gewünscht ist, kann diese als 2. Parameter angegeben werden.
<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::appendTo('tl_content', 'text', array(
'my_custom_settings' => array(':hide', 'my_custom_field1', 'my_custom_field2', 'my_custom_field3')
));
</source>
Fügt den Block '''my_custom_settings''' am Ende der '''text''' Palette von '''tl_content''' hinzu.

==MetaPalettes::appendBefore(..) & MetaPalettes::appendAfter(..)==

Fügt eine Meta Palette vor oder nach einem Block ein.

<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::appendBefore('tl_settings', 'title', array(
'my_custom_settings' => array(':hide', 'my_custom_field1', 'my_custom_field2', 'my_custom_field3')
));
</source>
Fügt den Block '''my_custom_settings''' vor den Block '''title_legend''' der '''default''' Palette von '''tl_settings''' hinzu.

Wenn eine andere Palette gewünscht ist, kann diese als 3. Parameter angegeben werden.
<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::appendBefore('tl_content', 'published', 'text', array(
'my_custom_settings' => array(':hide', 'my_custom_field1', 'my_custom_field2', 'my_custom_field3')
));
</source>
Fügt den Block '''my_custom_settings''' vor den Block '''published_legend''' der '''text''' Palette von '''tl_content''' hinzu.

Die Methode <code>MetaPalettes::appendAfter(..)</code> verhält sich äquivalent zu <code>MetaPalettes::appendBefore(..)</code>, nur dass der Block nicht vor, sondern nach dem anderen Block eingefügt wird.
{{Hinweis|Sollte der Block vor oder nach dem eingefügt werden soll nicht gefunden werden, wird die Palette am Ende hinzugefügt (wie bei <code>MetaPalettes::appendTo(..)</code>)}}

==MetaPalettes::appendFields(..) & MetaPalettes::prependFields(..)==
(seit Version 1.2.0)

Fügt eine Felder am Anfang oder Ende eines Blocks hinzu.

<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::appendFields(
'tl_settings',
'title',
array('my_custom_field1', 'my_custom_field2', 'my_custom_field3')
);
</source>
Fügt dem Block '''title_legend''' der '''default''' Palette die Felder '''my_custom_field1''', '''my_custom_field2''' und '''my_custom_field3''' hinzu.

Wenn eine andere Palette gewünscht ist, kann diese als 2. Parameter angegeben werden.
<source lang="php">
\ContaoCommunityAlliance\MetaPalettes\MetaPalettes::prependFields(
'tl_content',
'text',
'title',
array('my_custom_field1', 'my_custom_field2', 'my_custom_field3')
);
</source>
Fügt dem Block '''title_legend''' der '''text''' Palette die Felder '''my_custom_field1''', '''my_custom_field2''' und '''my_custom_field3''' am Anfang hinzu.

=Paletten vererben=
(seit Version 1.3.0)

Paletten lassen sich mit einfachen regeln vererben, die ererbten Regeln

<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'chapter_three' => array('field_four', 'field_five')
)
),
...
);
</source>
{{Hinweis|Die ''_X_'' Notation mit den Unterstrichen ist '''nicht''' obligatorisch. Sie soll nur zeigen, dass diese Palette niemals direkt verwendet wird sondern nur als Basis für eine andere Palette dient!}}

Daraus wird:
<source lang="php">
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
'palettes' => array
(
'_base_' => '{chapter_one_legend},field_one,field_two;{chapter_two_legend:hide},field_three',
'default' => '{chapter_one_legend},field_one,field_two;{chapter_two_legend:hide},field_three;{chapter_three_legend},field_four,field_five'
)
...
);
</source>

Um eine Palette zu erben wird also die einfache Notation '''''<palette>'' extends ''<base>''''' verwendet.

==fein granulare Vererbung==

===Gruppe überschreiben===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'chapter_two' => array('field_four')
)
),
...
);
</source>
→ die Gruppe ''chapter_two'' enthält später das Feld ''field_four''.

===Löschen von Gruppen===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'chapter_two' => array()
)
),
...
);
</source>
→ die Gruppe ''chapter_two'' wird gelöscht (leer gesetzt und damit nicht angezeigt).

===Gruppe positionieren===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'chapter_three before chapter_two' => array('field_four')
)
),
...
);
</source>
→ die Gruppe ''chapter_three'' wird vor der Gruppe ''chapter_two'' eingefügt. Mit dem ''after'' Schlüsselwort wird die Gruppe nach einer anderen Gruppe eingefügt.

===Einzelne Felder hinzufügen===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'+chapter_two' => array('field_four')
)
),
...
);
</source>
→ der Gruppe ''chapter_two'' wird das Feld ''field_four'' am Ende hinzugefügt.

===Einzelne Felder entfernen===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'-chapter_two' => array('field_three')
)
),
...
);
</source>
→ aus der Gruppe ''chapter_two'' wird das Feld ''field_three'' entfernt.

===Felder an bestimmter Position hinzufügen und entfernen===
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'+chapter_one' => array('field_four before field_one', '-field_two')
)
),
...
);
</source>
→ fügt der Gruppe ''chapter_two'' das Feld ''field_four'' vor dem Feld ''field_one'' hinzu und entfernt das Feld ''field_two''. Mit ''after'' kann ein Feld auch nach einem anderen hinzugefügt werden.

Der Operator (+/-) im Palettennamen definiert die Operation für alle Felder ohne eigenem Operator. Die Operatoren können also auch umgekehrt werden.
<source lang="php">
/**
* DCA tl_example
*/
$GLOBALS['TL_DCA']['tl_example'] = array
(
...
// meta pallettes
'metapalettes' => array
(
'_base_' => array
(
'chapter_one' => array('field_one', 'field_two'),
'chapter_two' => array(':hide', 'field_three')
),
'default extends _base_' => array
(
'-chapter_one' => array('+field_four before field_one', 'field_two')
)
),
...
);
</source>
Hat die gleiche Bedeutung wie im vorherigen Beispiel.
{{Hinweis|Wenn einzelne Felder hinzugefügt oder entfernt werden sollen, dann ist ein Operator (+/-) im Palettenname zwingend erforderlich, weil MetaPalettes sonst annimmt das die Palette überschrieben und nicht verändert werden soll!}}

MetaModels Insert-Tags

2017-01-26T12:17:54Z

Zonky:

MetaModels Beispiel 4

2017-01-26T12:17:32Z

Zonky:

MetaModels Beispiel 3

2017-01-26T12:17:16Z

Zonky:

MetaModels Beispiel 2

2017-01-26T12:16:50Z

Zonky:

{{Hinweis|Die Angaben, Beschreibungen und Screenshot beziehen sich auf MetaModels bis etwa Mitte 2016 und sind nicht aktuell!
Im [http://metamodels.readthedocs.io/de/latest/ MetaModels-Handbuch] sind aktuelle Angaben zu finden.}}

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Frontend einrichten=
Wir haben im Backend bereits ein paar Daten (Musikstücke) erfasst und möchten diese nun im Frontend anzeigen lassen. Hierfür benötigen wir eine Übersichtseite (Liste) und eine Detailsansicht. Plus noch eine minimale Navigation, um zwischen Liste und Detailansicht hin- und herklicken zu können.
Hierbei werden wir auch die Filtertechnik von MetaModels einsetzen.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen

=Seiterstruktur anpassen=
== In der Seitenstruktur zwei leere Seiten einrichten==

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

Zuerst richten wir in der Seitenstruktur zwei neue (leere) Seiten ein.

* '''Musicbox''' (diese Seite wird die Listenansicht aufnehmen)
* '''Music''' (diese Seite wird für die Darstellung der Detailansicht verantwortlich sein)

Sowohl MetaModels als auch die später benötigten Frontend-Module werden auf diese Seiten zugreifen müssen, deswegen richten wir diese vorab ein, auch wenn noch kein Inhalt definiert ist.

==Einfachen Filter erstellen==

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

Wir steigen nun wieder bei MetaModels bei '''Musicbox''' ein und gehen zur [[MetaModels_Backend:_Filter|MM-Backend Funktion: Filter]]

[[File:mm_backend_filter_einrichten.png|thumb|400px]]
Hier müssen wir thematisch etwas vorausgreifen, und ein Instrument bereitstellen, das bei der Einrichtung der Frontend-Ansichten in MetaModels benötigt wird: '''Wir brauchen einen Filter'''.
Bei MetaModels haben Filter eine breitere Bedeutung als dies umgangssprachlich der Fall ist. Filter steuern jede Art von Ansichtsdarstellung, sowohl im Backend als auch im Frontend. Aus der Sicht von MetaModels gibt es nicht eine Listen- und eine separate Archivansicht, wie man das z.B. von News oder Catalog her kennt. Für MetaModels ist jede Ansicht eine Listenansicht. Es ist der Filter, der bestimmt ob n Datensätze (aka Liste) oder nur 1 Datensatz (aka Detailansicht) angezeigt wird. Mit anderen Worten: Der Filter und nicht das Frontend-Modul macht den Unterschied.

* Die Filterübersicht ist noch leer (Keine Einträge gefunden)
* Auf '''Neu''' klicken
* Den Namen eingeben, z.B. "FE Link Detail" (FE steht für Frontend) und speichern
* Die Filterübersicht zeigt nun diesen Eintrag. Wähle das rechte Icon ''Filterattribute für Filtereinstellung definieren''.
* Auf '''Neu''' klicken und das Icon (mit Pfeil) für '''einsetzen''' wählen
* Nun kann man den Typ '''Einfache Abfrage''' auswählen
* Einen Haken bei dem Kästchen '''Aktiviert''' setzen
* Das '''Attribut''' Alias auswählen und den URL-Parameter '''auto_item''' eingeben
* Alle weiteren Optionen bleiben leer oder nicht angeklickt. Als '''Template''' den Standard '''mm_filteritem_default''' auswählen
* Speichern und Schliessen

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

===URL-Parameter auto_item===
[[File:mm_backend_filter_einrichten2.png|thumb|400px]]
Der URL-Parameter '''auto_item''' ist in Kombination mit dem Attribut '''Alias''' dann interessant, wenn man in der URL das '/alias' raushaben möchte.
<source lang="html4strict">
aus...
meineDomain.com/album/alias/born-to-die.html
wird...
meineDomain.com/album/born-to-die.html
</source>

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

'''Fazit'''<br>
Der Filter "FE Link Detail" besteht nun aus einer einzigen Definition. Wir werden in einem späteren Beispiel sehen, dass ein Filter auch aus mehreren Definitionen bestehen kann. Das ist eine weitere Neuerung in MetaModels, nämlich, dass man sich im Wesentlichen seine eigenen Filter zusammenbauen kann.
<div style="clear: both"></div>

==Listenansicht erstellen==

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

[[File:mm_backend_FE_Listenansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir bereits einen Eintrag "BE Listenansicht" an. Auf '''Neu''' klicken.
* Den Namen '''FE Listenansicht''' eingeben
* Als Template '''metamodel_prerendered (global scope)" wählen
* Als '''Zielseite''' die vorhin definierte Seite "Music" angeben. Klicke hierzu auf das Icon "Globus" und wähle die Seite aus dem Pulldown-Menu aus.{ {link_url::xx} } wird dann automatisch eingesetzt.
* Unter '''Filtereinstellungen''' wählen wir den vorhin definierten Filter "FE Link Detail".<br>(''sollte der Filter zunächst nicht angezeigt werden, dann hilft =>speichern weiter'')
* Speichern und schliessen
* Nun erscheinen zwei Einträge in der Liste der Ausgabevorgaben

Mit diesen Einstellungen legt man grob fest, welches Aussehen (Template) die Seite haben soll, wohin die Reise gehen wird (Zielseite) und was bei dieser Zielseite angezeigt werden soll (was durch den Filter bestimmt wird).<br>

'''Hinweis'''<br>
Wenn man hier kein Filter angibt, wird später im Frontend kein '''Details'''-Link erscheinen.<br>

'''Tipp'''<br>
Weitere Infos zum Details-Link siehe [[MetaModels_Beispiel_2#Detail-Link_anpassen|unten]]

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

==Attribute zur Listenansicht hinzufügen==

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

* Klick auf das Icon rechts '''Attribute hinzufügen'''
* Wähle '''Alle hinzufügen''' (geht schneller und einfacher als alle über "Neu" hinzufügen)
* Bestätige die folgenden Screens
* Lege fest, welche Attribute in der Listenansicht angezeigt werden sollen (Icon "Auge")

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

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

==Detailansicht erstellen==
[[File:icons_ausgabevorgaben.png|left|32px]]
Wähle die MM-Backend-Funktion [[MetaModels_Backend:_Ausgabevorgaben|"Ausgabevorgaben"]] (aka Rendereinstellungen).

[[File:mm_backend_FE_Detailansicht_einrichten.png|thumb|400px]]
* Die Übersichtsseite zeigt dir die Einträge "BE Listenansicht" und "FE Listenansicht" an.
* Wir klicken auf "neu"
* Gib den Namen "FE Detailansicht" an
* Als Template wähen wir "metamodel_prerendered (global scope) an.
* In diesem Fall brauchen wir weder eine Zielseite noch ein Filtersettting anzugeben, denn bis hierher und nicht weiter wollen wir gelangen
* Optional kann auch eine Weiterleitungsseite definiert und ein Filter angegeben werden, wenn man einen Link "Zurück" generieren will
* Speichern und schliessen

'''Tipp'''<br>
Weitere Infos wie man einen Zurück-Link erstellt, siehe [[MetaModels_Beispiel_2#Detail-Link_anpassen|unten]]
<div style="clear: both"></div>

[[File:mm_backend_FE_Detailansicht_einrichten_liste.png|thumb|400px]]
Es erscheinen nun drei Einträge in der Liste der Ausgabevorgaben.
* BE Listenansicht
* FE Detailansicht
* FE Listenansicht

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

==Attribute zur Detailansicht hinzufügen==

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

Das Vorgehen ist analog zum Punkt 4 zu verstehen. Einzig, dass wir hier am Ende alle Attribute anzeigen lassen (inkl. Bild und Beschreibung).
<div style="clear: both"></div>
{{Anmerkung|
Das Drag & Drop eines Attributes auf den 1. Platz funktioniert momentan nicht. Ein Ticket dazu ist in Bearbeitung. https://github.com/MetaModels/core/issues/259
Man kann das Attribut auf den 2. Platz schieben und dann das von dem 1. Platz runter auf den 2.

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

==Frontend-Module erstellen==
{{Hinweis|Einige Einstellmöglichkeiten in den nachstehend beschriebenen Modulen sind erst nach einer Zwischenspeicherung des Moduls erreichbar.}}
[[File:mm_backend_FE-Module_Liste.png|thumb|400px]]

Frontend-Modul für Listenansicht einrichten:

* Wähle den ''Modultyp'' "MetaModels-Liste" aus
* Wähle das entsprechend ''MetaModel'' aus, in unserem Fall "Musicbox"
* Bei ''Sortieren nach'' und ''Sortierreihenfolge'' das gewünschte Attribut festlegen bzw. ob auf- oder absteigend sortiert werden soll
* ''Anzuwendende Filtereinstellungen'' bleibt vorläuftig leer. Das heißt soviel wie, dass wir in unserer Liste alle Datensätze (Musikstücke), die wir in unserer Musicbox erfasst haben, in der Liste anzeigen möchten
* Bei ''Eigenes Template für Datensatzliste auswählen'' den vorgegebenen Default "mod_metamodel_list" nehmen
* Bei ''Anzuwendende Rendereinstellung'' nehmen wir nun die zuvor definierte Ausgabevoreinstellung "FE Listenansicht". Damit werden nur die Daten der Felder ausgegeben, die wir unter Punkt 9 als sichtbar gekennzeichnet haben, und zwar in der dort definierten Reihenfolge

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

[[File:mm_backend_FE-Module_Detail.png|thumb|400px]]
Frontend-Modul für Detailansicht einrichten:

Dieses FE-Modul richten wir analog dem FE-Modul der Listenansicht ein, allerdings mit zwei wichtigen Unterschieden:

* Bei ''Anzuwendende Filtereinstellungen'' muss nun der Filter "FE Link Detail" angewählt werden. Dieser bewirkt, dass man hier, in der Detailansicht, auch nur den Datenansatz angezeigt bekommt, den man in der Listenansicht angeklickt hatte.
* Bei ''Anzuwendende Rendereinstellungen'' wählen wir die in den Ansichtsdarstellungen definierte Einstellung "FE Detailansicht". Hier werden alle Daten angezeigt, die wir unter Punkt ... als sichtbar angegeben haben. In diesem Falle alle.

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

==Frontend-Module einbinden und Seitenvorschau==
[[File:mm_backend_FE-Module_einsetzen.png|thumb|400px]]
Zum Schluss bindet man die beiden Frontend-Module in den gewünschten Artikel ein.
Done.

<div style="clear: both"></div>
== Detail-Link anpassen==
Wenn der Rendereinstellung für die FE-Ansicht der passende Filter mitgegeben wurde, wird am Ende des Items standardmässig ein Link namens '''Details''' generiert.
Im Standard-Template '''metamodel_prerendered.html5''' sieht der PHP-Code, wo der Link vorkommt, so aus:
<source lang="php">
<?php if ($arrItem['jumpTo']['deep']): ?>
<a href="<?php echo $arrItem['jumpTo']['url']; ?>"><?php echo $this->details; ?></a>
<?php endif; ?>
</source>
Die Bezeichnung des Links lässt sich umbenennen, ohne in das Template eingreifen zu müssen.<br>
Hierzu kann man bei '/system/config/'''langconfig.php'''' folgende Anpassungen machen. 3 Beipiele...
<source lang="php">
$GLOBALS['TL_LANG']['MSC']['details'] = '...mehr Details';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle']['details'] = 'weiter...';
$GLOBALS['TL_LANG']['MSC']['mm_meineTabelle'][id]['details'] = 'Zurück zur Liste';
</source>
'''1. Fal'''l: Jeder Link in MetaModels wird zu '... mehr Details' umbenannt<br>
'''2. Fall''': Nur die Links in der MetaModel-Tabelle 'mm_meineTabelle' werden zu 'weiter...' umbeannt<br>
'''3. Fall''': Interessant, wenn man von der FE Detailansicht zurück zur FE Listenansicht gelangen will. In diesem Fall kann man nicht nur die MM Tabelle angeben, sondern auch die '''id''' der [[MetaModels_Backend:_Ausgabevorgaben#Einstieg|Rendereinstellung]] angeben.

Beispiel für langconfig.php:<br>
<source lang="php">
<?php
/* Put your custom configuration here */
$GLOBALS['TL_LANG']['MSC']['mm_musicbox']['details'] = 'weiter...';
$GLOBALS['TL_LANG']['MSC']['mm_musicbox'][4]['details'] = 'Zurück zur Liste';
?>
</source>

=Mögliches Endresultat=

==Frontend Ansicht==
Und so könnte es aussehen
* links: Die Daten werden standardmässig in kompakter Form ausgegeben
* rechts: mit etwas CSS lassen sich die Daten sowohl in der Listen- wie Detailsicht gut formatieren
* die Labels lassen sich auch ausschalten. Siehe [[MetaModels_Backend:_Eingabemaske#Backend_Liste_gestalten|hier]]
[[File:mm_frontend_beispiel.png|link=|900px]]

==HTML-Konstrukt==
Die Daten werden über das Template "metamodel_prerendered.html5" ausgegeben. Jeder Datensatz wird als '''item''' ausgegeben, dieser besteht aus den Attributen, die in den Rendereinstellungen definiert wurden. Bei jedem Attribut wird standardmässig '''label''' und '''value''' ausgegeben.

<source lang="html4strict">

<div class="item">
<div class="field attribut1">
<span class="label">Titel des attributs1</span>
<span class="value">Wert des attribut1</span>
</div>
<div class="field attribut2">
<span class="label">Titel des attribut2</span>
<span class="value">Wert des attribut2</span>
</div>
<div class="field attribut3">
...
</div>
</div>
<div class="item">
...
</div>
<div class="item">
...
</div>

</source>

[[MetaModels_Beispiel_1|Zurück zur Beispiel 1]] | [[MetaModels_Beispiel_3|Weiter zum Beispiel 3: Weitere Filter hinzufügen]]

MetaModels Beispiel 1

2017-01-26T12:16:28Z

Zonky:

{{Hinweis|Die Angaben, Beschreibungen und Screenshot beziehen sich auf MetaModels bis etwa Mitte 2016 und sind nicht aktuell!
Im [http://metamodels.readthedocs.io/de/latest/ MetaModels-Handbuch] sind aktuelle Angaben zu finden.}}

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]
=Aufgabenstellung: Backend einrichten=
Als Beispielprojekt soll eine einfache "Musikbox" gebaut werden, in der Musikstücke mit gewissen Attributen ("Eigenschaften") erfasst werden. Zu diesem Zweck wird zuerst das Backend aufgebaut. Hierzu braucht man eine Übersichtsliste und ein Erfassungsformular.

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen

=Eine leere Datenbank erstellen=

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

Zuerst wird ein neues MetaModel erstellt. Technischen gesehen wird dabei in der Contao-Datenbank eine leere Tabelle angelegt.

* Klick auf '''Neues MetaModel'''
* Name: '''Musicbox'''
* TabellenName: '''mm_musicbox'''

===Anmerkungen===

* In unserem Beispiel aktivieren wir die Mehrsprachigkeit, um nachträglich weitere Sprachen anlegen zu können. Falls man im Vorfeld weiß, dass man keine weiteren Sprachen benötigt, muss der Haken nicht gesetzt werden. MetaModels ist auch ohne Mehrprachigkeit komplett funktionstüchtig.
* '''Varianten unterstützen''' wird vorläufig nicht benötigt.... und gegebenenfalls zu einem späteren Zeitpunkt erläutert.

===Auszuführen===

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

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

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

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

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

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

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

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (Attribute für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ausgabevorgaben|'''Ausgabevorgaben''']] (Render-Einstellungen für MetaModel ID x definieren)
# [[MetaModels_Backend:_Eingabemaske|'''Eingabemaske''']] (Eingabemaske für das MetaModel ID x definieren)
# [[MetaModels_Backend:_Filter|'''Filter''']] (Filter für MetaModel ID x definieren)
# [[MetaModels_Backend:_Ansichtseinstellungen|'''Paletten- und Ansichtseinstellungen''']] (Definieren Sie die Eingabe- / Ausgabe-Optionen für MetaModel ID x)

=Das Backend konfigurieren=

Um das Backend für die Erfassung der Daten vorzubereiten benötigt man a) eine Übersichtsliste und b) ein Erfassungsformular. Hierzu braucht man 4 der 5 Backend-Funktionen von MetaModels.

* Datenbank erstellen, benennen, Sprachvariable zuweisen
* Felder definieren, Attribute festlegen, Erfassungsformular gestalten
* Übersichtsliste definieren
* Erfassung (z.B. für Redakteure) freigeben

==MM-Funktion: Attribute==

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

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

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

Hierzu gibt man folgende Felder ein (im nebenstehenden Screen ist das beispielhaft für das Attribut "Titel" dargestellt):
{|
|-
| '''Titel'''
|
* Attribute Type= Text
* Column name= title
* Name (deutsch)= Titel
* Description (deutsch)= Name des Stücks
|-
| '''Interpret'''
|
* Attribute Type= Text
* Column name= composer
* Name (deutsch)= Interpret
* Description (deutsch)= Name der Band, SängerIn oder InterpretIn
|-
| '''Land'''
|
* Attribute Type= Text
* Column name= country
* Name (deutsch)= Land
* Description (deutsch)=
|-
| '''Jahr'''
|
* Attribute Type= Dezimal
* Column name= year
* Name (deutsch)= Jahr
* Description (deutsch)= Erscheinungsjahr
|-
| '''Beschreibung'''
|
* Attribute Type= Langtext
* Column name= description
* Name (deutsch)= Beschreibung
* Description (deutsch)= Wikipedia, Kurzbeschreibung, etc.
|-
| '''Cover'''
|
* Attribute Type= Datei
* Column name= images
* Name (deutsch)= Cover
* Description (deutsch)= Cover, Bilder
|-
|colspan="2"|Bis jetzt wurde bei keinem der Attribute die Option '''Unique values''' aktiviert.<br><br>Um die Einträge eindeutig identifizieren zu können, wird zusätzlich ein Alias-Attribut erzeugt:
|-
| '''Alias'''
|
* Attribute Type= Alias
* Column name= alias
* Name (deutsch)= Alias
* Description (deutsch)=
* Unique values= aktiviert
* Alias Neuerstellung erzwingen = aktiviert<br>(dann muss kein Alias eingegeben werden, wird neu berechnet bei Änderung des Titels)
* Aliasfelder = Titel
|}

<div>

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

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

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

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

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

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

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

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

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

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

</div>

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

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

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

===BE-Liste===
[[File:mm_paletten_BE_liste.png|thumb|400px]]
Nach Klick auf '''Neue Eingabemaske''' öffnet sich ein [[MetaModels_Backend:_Eingabemaske|Erfassungsformular]]. Hier die Werte eingeben, wie nebenan abgebildet:
* Name: '''BE Erfassung'''
* Option '''Als Standard benutzen'''
* Panel-Layout: Es stehen 4 Werte ('''filter''', '''sort''', '''search''' und '''limit''') zur Verfügung. Diese können auch über das Icon rechts abgerufen werden.
**Werden hier mehrere Werte eingegeben, so sind diese entweder durch Komma (,) oder durch Semikolon (;) voneinander zu trennen - nur mit Leerzeichen getrennte Werte werden ignoriert.
**Komma => Ausgabe in der gleichen Zeile wie der vorhergehende Wert
**Semikolon => Ausgabe in neuer Zeile.
* Integration: '''Als Einzeltabelle'''
* Sortiermodus: '''2 Datensätze nach wählbarem Feld sortiert darstellen''' (Wichtig: Sowohl dieser Wert als auch '''sort''' im '''Panel-Layout''' müssen definiert sein, ansonsten erscheint die Sortier-Funktion nicht.
* Sortierung: Auf- oder Absteigend... wie es dir gefällt
* Backend-Bereich: '''Inhalte''' (oder wo soll es in der Backend-Navigation eingesetzt werden)
* Backend-Icon: Auf Wunsch kann hier ein eigenes Icon gesetzt werden
* Backend-Beschreibung: wie abgebildet

Nun wurde eine Eingabemaske namens '''BE Erfassung''' erstellt. Im Folgenden wird nun das Erfassungs-Formular ein wenig gestaltet.<br>
Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
{{Hinweis|Mit der Erweiterung '''MetaModels Boilerplate''' (Nightly Build) kann man die MetaModels in einem separaten '''Backend-Bereich''' in der BE-Navigation unterbringen.}}{{Hinweis|Die Option '''Sortierung''' ist beim erstmaligen Bearbeiten der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s (hier: Inhalte) die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.}}
<div style="clear: both"></div>

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

Man fügt nun alle Attribute zur Palette hinzu, indem man auf das Icon rechts (''Die Einstellungen der Palette ID xx bearbeiten'') klickt.
* '''Alle hinzufügen''' wählen und alle nun folgenden Screens bestätigen.
* Man erhält so eine Liste aller Attribute, die man einzeln bearbeiten kann.
* Auf Wunsch kann man hier auch die Reihenfolge umstellen und so bestimmen, wie die Daten erfasst werden sollen.
* Angefangen wird mit dem ersten Eintrag '''Titel [text]'''
<div style="clear: both"></div>

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

Folgendes Beispiel zeigt, was man bei der Erfassung des Attributs '''Titel''' alles einstellen kann.<br>
Ein Klick auf das Editier-Icon zeigt die wichtigsten Einstellungen:
* Backend-Class: Damit kann man das Formular bzw. die Erfassungfelder etwas gestalten. 5 Werte stehen zur Verfügung: '''w50''', '''clr''', '''long''', '''wizard''' und '''m12'''
* Pflichtfeld: Durch Anklicken legt man fest, ob auf diesem Feld eine Inhaltsprüfung stattfinden soll. Die Felder werden mit einem roten Asterisk gekennzeichnet.
* Filterbar, Durchsuchbar, Sortierbar: Mit diesen Optionen kann man die BE-Liste etwas organisieren. Praktisch wenn man mehrere Dutzend/Hunderte von Datensätze erfasst hat.
<div style="clear: both"></div>

==MM-Funktion: Zugriffsrechte definieren==

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

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

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

Damit die Benutzer den MM auch sehen können, muß in den Gruppen-/Benutzerrechten auch noch dieser MM freigeschaltet werden. Den MM findet man unter 'Erlaubte Module' > 'Backend Module'. Je nachdem ob man den MM einzeln oder Untergeordnet anzeigen lässt dann an der jeweiligen Stelle.

=Die Daten erfassen=

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

Und so sieht's aus:<br>Nun wird in der linken Navigationsübersicht "Backend-Module" ein neuer Eintrag angezeigt und man kann mit der Erfassung der Musikstücke beginnen.

* Mit Klick auf '''MyMusik''' gelangt man auf die BE Listenansicht. Diese ist noch leer
* Mit Klick auf '''Neuer Datensatz'''. öffnet sich ein Formular, mit dem sich nun der erste Datensatz erfassen lässt
* Die gewünschten Werte eingeben und mit '''Speichern und Schliessen''' bestätigen
* Nun erscheint der erste Eintrag in der BE Listenansicht
* Diesen Vorgang wiederholen, bis alle Datensätze erfasst wurden
* Über der BE Listenansicht stehen nun die Panel-Layout Funktionen '''Suchen''', '''Sortieren''', '''Filtern''' und '''Anzeigen''' zur Verfügung

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

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

MetaModels Beispiel: FE-Template anpassen

2017-01-26T12:15:09Z

Zonky: Hinweis Handbuch

MetaModels Beispiel: Referenced items

2017-01-26T12:14:32Z

Zonky: Hinweis Handbuch

MetaModels Beispiel: Übersetzter select

2017-01-26T12:14:03Z

Zonky: Hinweis Handbuch

MetaModels

2017-01-26T12:13:01Z

Zonky: Hinweis Handbuch

{{Hinweis|Die Angaben, Beschreibungen und Screenshot beziehen sich auf MetaModels bis etwa Mitte 2016 und sind nicht aktuell!
Im [http://metamodels.readthedocs.io/de/latest/ MetaModels-Handbuch] sind aktuelle Angaben zu finden.}}

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

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

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen

=Download & Installation=

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

==Installation via Composer==

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

==Download aus dem Entwicklungsrepository GitHub==

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

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

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

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

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

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

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

=Backend Ansichten=

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

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

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

=Konfiguration=

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

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

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

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

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

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

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

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

MetaModels Insert-Tags

2015-09-01T11:26:41Z

Zonky: Formatierung

[[Category:Extensions]]
[[Category:MetaModels|B]]
= Insert-Tags =
Der Aufbau der Insert-Tags ist relative simple. Als erste 'mm' um die Insert-Tags von MetaModels zu bekommen. Danach die gewünschte Funktion. Momentan gibt es 4 Funktionen, eine 5 befindet sich noch in der Entwicklung. Anschließen kann es 0 bzw. beliebig viele Parameter geben. Einige davon sind Pflicht andere Optional.

Die folgenden Insert-Tags stehen in MetaModels zur Verfügung:

== Allgemeine Insert-Tags ==
=== Beschreibung ===
Diese Insert-Tags geben die gesamt Anzahl an gefunden Einträge für eine MetaModels Liste aus.

=== Parameter ===
<source lang="php">
{{mm::total::mod::*}} -> mm::total::mod::[ID]
{{mm::total::ce::*}} -> mm::total::ce::[ID]
</source>

{| class="Parameter"
|-
! Parameter
! Daten Type
! Beschreibung
! Optional
|-
| mm
| String
| Allgemeiner Aufruf für die MM Insert-Tags
| Nein
|-
| total
| String
| Funktionsname
| Nein

|-
| mod|ce
| String
| Ausgabe von einem Module(mod) oder einem Contentelement(ce)
| Nein
|-
| */ID
| Integer
| ID vom Module|Contentelemen
| Nein
|}

=== Beispiel ===

<source lang="php">
{{mm::total::mod::1}}
{{mm::total::ce::1}}
</source>

=== Ausgabe ===
<source lang="php">
22
0
</source>

== Itembasierte Insert-Tags ==
<source lang="php">
{{mm::item::*::*::*}} -> mm::item::[MM Name oder ID]::[Item ID oder ID,ID,ID]::[ID Rendersetting](::[Output raw|text|html5|..])
{{mm::detail::*::*::*}} -> mm::detail::[MM Name oder ID]::[Item ID]::[ID Rendersetting](::[Output raw|text|html5|..]) // Not yet implemented
</source>

== Attributbasierte Insert-Tags ==
<source lang="php">
{{mm::attribute::*::*::*::*}} -> mm::attribute::[MM Name oder ID]::[Item ID]::[Attribute Name oder ID](::[Output raw|text|html5|..])
</source>

== Weiterleitungen ==
<source lang="php">
{{mm::jumpTo::*::*::*::*}} -> mm::jumpTo::[MM Name oder ID]::[Item ID]::[ID Rendersetting](::[Parameter (Default:url)|label|page|params.attname])
</source>

== Quelle auf Github für MM 2.x==
https://github.com/MetaModels/core/blob/master/src/MetaModels/FrontendIntegration/InsertTags.php

MetaModels Insert-Tags

2015-09-01T11:23:58Z

Zonky: Update URL

MetaModels Beispiel: FE-Template anpassen

2014-12-19T09:11:29Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

Hinweis zur Länge des Dateinamens: der Dateiname kann über das BE nur eine bestimmte Länge haben - bis Contao 3.3.x sind das 32 Zeichen und ab 3.4.x 64 Zeichen.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

In dem Array gibt es (z.Z.) drei verschiedene Knoten, die sich anhand der Ausgabevarianten ergeben. Das sind [raw], [text] und [html5] - in [raw] werden alle vorhanden Attribute ausgegeben und in [text] und [html5] nur die vorhanden Attribute, die auf "Sichtbar" (Auge grün) gestellt sind.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-19T09:10:51Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

Hinweis zur Länge des Dateinamens: der Dateiname kann über das BE nur eine bestimmte Länge haben - bis Contao 3.3.x sind das 32 Zeichen und ab 3.4.x 64 Zeichen.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

In dem Array gibt es (z.Z.) drei verschiedene Knoten, die sich anhand der Ausgabevarianten ergenen. Das sind [raw], [text] und [html5] - in [raw] werden alle vorhanden Attribute ausgegeben und in [text] und [html5] nur die vorhanden Attribute, die auf "Sichtbar" (Auge grün) gestellt sind.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-19T09:09:44Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

Hinweis zur Länge des Dateinamens: der Dateiname kann über das BE nur eine bestimmte Länge haben - bis Contao 3.3.x sind das 32 Zeichen und ab 3.4.x 64 Zeichen.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden. In dem Array gibt es (z.Z.) drei verschiedene Knoten, die sich anhand der Ausgabevarianten ergenen. Das sind [raw], [text] und [html5] - in [raw] werden alle vorhanden Attribute ausgegeben und in [text] und [html5] nur die vorhanden Attribute, die auf "Sichtbar" (Auge grün) gestellt sind.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-19T08:09:32Z

Zonky: /* 1. Wo finde ich das Template? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

Hinweis zur Länge des Dateinamens: der Dateiname kann über das BE nur eine bestimmte Länge haben - bis Contao 3.3.x sind das 32 Zeichen und ab 3.4.x 64 Zeichen.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-03T07:06:15Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-03T07:04:40Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-02T21:42:38Z

Zonky:

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

== 2. Wie sehe ich, was alles an Attributen zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-02T09:05:30Z

Zonky:

MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

== 2. Wie sehe ich, was alles an Attributen zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffenen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-02T09:02:26Z

Zonky:

MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

Voraussetzung: das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

== 2. Wie sehe ich, was alles an Attributen zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffenen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen werden und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das Array analysiert werden.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels Beispiel: FE-Template anpassen

2014-12-02T08:55:24Z

Zonky: Debug der Items im HTML-Quelltext

MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

Voraussetzung: das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

1. Wo finde ich das Template?

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

2. Wie sehe ich, was alles an Attributen zur Verfügung steht?

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffenen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

[code]
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
[/code]

Anschließend kann die Seite in der FE-Ausgabe neu geladen werden und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das Array analysiert werden.

Für Fragen im Forum kann die Ausgabe - oder Teile davon - gepostet werden oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

MetaModels

2014-12-02T08:05:19Z

Zonky: /* Tipps und Tricks */

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

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

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen

=Download & Installation=

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

==Installation via Composer==

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

==Download aus dem Entwicklungsrepository GitHub==

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

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

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

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

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

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

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

=Backend Ansichten=

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

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

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

=Konfiguration=

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

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

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

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

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

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

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

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

MetaModels Beispiel: Referenced items

2014-11-26T11:53:59Z

Zonky: /* Lösungsansatz */

[[Category:MetaModels|T2]]
=MetaModels miteinander verknüpfen=
==Ausgangslage==
Es gibt ein MetaModel mit "Kunden" (mm_customers) und eines mit "Projekte" (mm_projects). mm_projects enthält ein Attribut "customer" vom Typ "select", welches die in mm_customer erfassten Kunden anzeigt. Über dieses Feld wird das Projekt mit dem Kunden verknüpft.
==Aufgabenstellung==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Von dort möchte man auch per Link auf die Detailansicht des spezifischen Projektes springen können.

==Lösungsansatz==
Nebst den spezifischen Kunden-Detailinformationen sollen die Projekte gelistet darunter erscheinen. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie angezeigt. Die Projekte werden überdies über einen Filter sortiert:
<source lang="php">$objFilter = $objMetaModel->prepareFilter(10, array()); </source>
In diesem Fall ist '10' die ID des Filters im MetaModels 'mm_projects'. Der Filter sorgt dafür, dass die Projekte chronologisch aufgelistet werden.

Das MetaModels-Template könnte wie folgt aussehen:
{{Hinweis|Beachte das in der TNG Version MetaModels auch auf Namespace umgestellt wurde und die Factory Aufrufe entsprechend anders lauten müssen: \MetaModels\Factory s.u.}}

'''Quelltext ohne Namespace:'''
<source lang="php">
<?php
function getProjectsByCustomer($strAlias, $format='html5')
{
$objMetaModel = MetaModelFactory::byTableName('mm_projects');
$objFilter = $objMetaModel->prepareFilter(10, array());
$objFilter->addFilterRule(new MetaModelFilterRuleSearchAttribute($objMetaModel->getAttribute('customer'), $strAlias, $objMetaModel->getAvailableLanguages()));
$objItems = $objMetaModel->findByFilter($objFilter);
return $objItems->parseAll($format, $objMetaModel->getView(3));
}
?>

<div class="customer_detailview">
<?php foreach ($this->data as $arrItem): ?>

<div class="detailview">
<h1 class="ce_headline"><?php echo $arrItem['text']['customer']; ?></h1>
<p class="description"><?php echo $arrItem['text']['description']; ?></p>
<p class="year"><?php echo $arrItem['text']['year']; ?></p>
<p class="url"><?php echo $arrItem['html5']['url']; ?></p>
</div>

<div class="referenced_projects">
<h2>Projekte</h2>
<?php foreach (getProjectsByCustomer($arrItem['raw']['alias']) as $arrProjects): ?>
<?php if(!empty($arrProjects['raw']['images'])): ?>
<div class="project">
<h3>
<a href="{{env::path}}<?php echo $arrProjects['jumpTo']['url']; ?>">
<?php echo $arrProjects[$this->getFormat()]['project_name']; ?>
</a>
</h3>
<?php echo $arrProjects[$this->getFormat()]['description']; ?>
<?php echo $arrProjects[$this->getFormat()]['images']; ?>
</div>
<?php endif; ?>
<?php endforeach; ?>
</div>

<?php endforeach; ?>
</div>

</source>

'''Quelltext mit Namespace:'''
<source lang="php">
<?php
function getProjectsByCustomer($strAlias, $format='html5')
{
$objMetaModel = \MetaModels\Factory::byTableName('mm_projects');
$objFilter = $objMetaModel->prepareFilter(10, array());
$objFilter->addFilterRule(new \MetaModels\Filter\Rules\SearchAttribute($objMetaModel->getAttribute('customer'), $strAlias, $objMetaModel->getAvailableLanguages()));
$objItems = $objMetaModel->findByFilter($objFilter);
return $objItems->parseAll($format, $objMetaModel->getView(3));
}
?>

<div class="customer_detailview">
<?php foreach ($this->data as $arrItem): ?>

<div class="detailview">
<h1 class="ce_headline"><?php echo $arrItem['text']['customer']; ?></h1>
<p class="description"><?php echo $arrItem['text']['description']; ?></p>
<p class="year"><?php echo $arrItem['text']['year']; ?></p>
<p class="url"><?php echo $arrItem['html5']['url']; ?></p>
</div>

<div class="referenced_projects">
<h2>Projekte</h2>
<?php foreach (getProjectsByCustomer($arrItem['raw']['alias']) as $arrProjects): ?>
<?php if(!empty($arrProjects['raw']['images'])): ?>
<div class="project">
<h3>
<a href="{{env::path}}<?php echo $arrProjects['jumpTo']['url']; ?>">
<?php echo $arrProjects[$this->getFormat()]['project_name']; ?>
</a>
</h3>
<?php echo $arrProjects[$this->getFormat()]['description']; ?>
<?php echo $arrProjects[$this->getFormat()]['images']; ?>
</div>
<?php endif; ?>
<?php endforeach; ?>
</div>

<?php endforeach; ?>
</div>

</source>

MetaModels Beispiel: Referenced items

2014-11-17T15:49:24Z

Zonky: /* Lösungsansatz */

[[Category:MetaModels|T2]]
=MetaModels miteinander verknüpfen=
==Ausgangslage==
Es gibt ein MetaModel mit "Kunden" (mm_customers) und eines mit "Projekte" (mm_projects). mm_projects enthält ein Attribut "customer" vom Typ "select", welches die in mm_customer erfassten Kunden anzeigt. Über dieses Feld wird das Projekt mit dem Kunden verknüpft.
==Aufgabenstellung==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Von dort möchte man auch per Link auf die Detailansicht des spezifischen Projektes springen können.

==Lösungsansatz==
Nebst den spezifischen Kunden-Detailinformationen sollen die Projekte gelistet darunter erscheinen. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie angezeigt. Die Projekte werden überdies über einen Filter sortiert:
<source lang="php">$objFilter = $objMetaModel->prepareFilter(10, array()); </source>
In diesem Fall ist '10' die ID des Filters im MetaModels 'mm_projects'. Der Filter sorgt dafür, dass die Projekte chronologisch aufgelistet werden.

Das MetaModels-Template könnte wie folgt aussehen:
{{Hinweis|Beachte das in der TNG Version MetaModels auch auf Namespace umgestellt wurde und die Factory Aufrufe entsprechend anders lauten müssen: \MetaModels\Factory s.u.}}

'''Quelltext ohne Namespace:'''
<source lang="php">
<?php
function getProjectsByCustomer($strAlias, $format='html5')
{
$objMetaModel = MetaModelFactory::byTableName('mm_projects');
$objFilter = $objMetaModel->prepareFilter(10, array());
$objFilter->addFilterRule(new MetaModelFilterRuleSearchAttribute($objMetaModel->getAttribute('customer'), $strAlias, $objMetaModel->getAvailableLanguages()));
$objItems = $objMetaModel->findByFilter($objFilter);
return $objItems->parseAll($format, $objMetaModel->getView(3));
}
?>

<div class="customer_detailview">
<?php foreach ($this->data as $arrItem): ?>

<div class="detailview">
<h1 class="ce_headline"><?php echo $arrItem['text']['customer']; ?></h1>
<p class="description"><?php echo $arrItem['text']['description']; ?></p>
<p class="year"><?php echo $arrItem['text']['year']; ?></p>
<p class="url"><?php echo $arrItem['html5']['url']; ?></p>
</div>

<div class="referenced_projects">
<h2>Projekte</h2>
<?php foreach (getProjectsByCustomer($arrItem['raw']['alias']) as $arrProjects): ?>
<?php if(!empty($arrProjects['raw']['images'])): ?>
<div class="project">
<h3>
<a href="{{env::path}}<?php echo $arrProjects['jumpTo']['url']; ?>">
<?php echo $arrProjects[$this->getFormat()]['project_name']; ?>
</a>
</h3>
<?php echo $arrProjects[$this->getFormat()]['description']; ?>
<?php echo $arrProjects[$this->getFormat()]['images']; ?>
</div>
<?php endif; ?>
<?php endforeach; ?>
</div>

<?php endforeach; ?>
</div>

</source>

'''Quelltext mit Namespace:'''
<source lang="php">
<?php
function getProjectsByCustomer($strAlias, $format='html5')
{
$objMetaModel = \MetaModel\Factory::byTableName('mm_projects');
$objFilter = $objMetaModel->prepareFilter(10, array());
$objFilter->addFilterRule(new \MetaModels\Filter\Rules\SearchAttribute($objMetaModel->getAttribute('customer'), $strAlias, $objMetaModel->getAvailableLanguages()));
$objItems = $objMetaModel->findByFilter($objFilter);
return $objItems->parseAll($format, $objMetaModel->getView(3));
}
?>

<div class="customer_detailview">
<?php foreach ($this->data as $arrItem): ?>

<div class="detailview">
<h1 class="ce_headline"><?php echo $arrItem['text']['customer']; ?></h1>
<p class="description"><?php echo $arrItem['text']['description']; ?></p>
<p class="year"><?php echo $arrItem['text']['year']; ?></p>
<p class="url"><?php echo $arrItem['html5']['url']; ?></p>
</div>

<div class="referenced_projects">
<h2>Projekte</h2>
<?php foreach (getProjectsByCustomer($arrItem['raw']['alias']) as $arrProjects): ?>
<?php if(!empty($arrProjects['raw']['images'])): ?>
<div class="project">
<h3>
<a href="{{env::path}}<?php echo $arrProjects['jumpTo']['url']; ?>">
<?php echo $arrProjects[$this->getFormat()]['project_name']; ?>
</a>
</h3>
<?php echo $arrProjects[$this->getFormat()]['description']; ?>
<?php echo $arrProjects[$this->getFormat()]['images']; ?>
</div>
<?php endif; ?>
<?php endforeach; ?>
</div>

<?php endforeach; ?>
</div>

</source>