Contao Community Documentation - Benutzerbeiträge [de]

MetaModels Beispiel: Referenced items

2013-09-10T07:47:40Z

Luis: /* 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:40:59Z

Luis: /* 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 gezeigt. 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:39:37Z

Luis: /* Zwei MetaModels zueinander referenzieren */

[[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==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:38:56Z

Luis: /* Zwei MetaModels zu einander referenzieren */

[[Category:MetaModels|T2]]
=Zwei MetaModels zueinander referenzieren=
==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==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. 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:

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

MetaModels

2013-09-10T07:37:43Z

Luis: /* Beispiele */

[[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.<br/>
<span style="color:red; font-size:18px; font-weight:bold">MetaModels läuft mit Contao 2.11.x und setzt PHP 5.3 voraus. </span> <br/>
<span style="color:black; font-size:18px; font-weight:bold">MetaModels ist (noch) nicht mit Contao 3.x kompatibel. Wer die Entwicklung voran treiben möchte, kann es [http://now.metamodel.me/en/fundraising hier] per Fundraising tun. </span>

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

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

==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 benötigten sonstigen Erweiterungen installiert sind, werde 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 '''Geoprotection''' ist nicht mehr Teil der Nightly Builds. Kann aber jederzeit über den oben angegeben Link separat geladen werden.}}{{Hinweis|Das Attribut '''Rating''' benötigt die beiden PHP-Dateien '''SimpleAjax.php''' und '''SimpleAjaxFrontend.php''', welche mit dem aktuellen Nightly Build ausgeliefert werden. Die beiden PHP-Dateien müssen im Root-Verzeichnis der Contao-Installation abgelegt werden.}}

==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]]
Den Überblick findest du [[MetaModels_Backend:_Attribute|hier]].

===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]]
Den Überblick findest du [[MetaModels_Backend:_Filter|hier]].

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

=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

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

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

MetaModels Beispiel 4

2013-09-10T07:33:14Z

Luis: /* Vorgehensschritte */

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

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

=Neues MetaModel erstellen=

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

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

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

==MM-Funktion: Attribute==

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

=Zusätzlichen Select-Filter im Frontend definieren=

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

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

==Frontend-Modul aktualisieren==

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

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

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

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

MetaModels Beispiel 3

2013-09-10T07:33:00Z

Luis: /* Vorgehensschritte */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|B]]

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

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

=Published Filter im Backend einbauen=

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

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

==MM-Funktion: Attribute anpassen==

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

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

[[File:mm_backend_anpassen1.png|thumb|400px]]
* Wähle '''Neues Attribut'''
* Wähle als ''Attribut-Typ'' '''Checkbox''' aus gib als Spaltenname z.B. '''published''' ein
* Wichtig: '''Veröffentlichen''' muss angeklickt sein
* In der Attributsübersicht erscheint jetzt das neu angelegte Feld '''Veröffentlicht'''

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

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

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

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

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

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

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

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

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

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

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

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

==Frontend-Modul anpassen==

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

Dort nehmen wir an folgende Änderungen vor:

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

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

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

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

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

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

==Neues Frontend-Modul erstellen==

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

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

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

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

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

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

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

MetaModels Beispiel 2

2013-09-10T07:32:45Z

Luis: /* Vorgehensschritte */

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

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

Frontend-Modul für Listenansicht einrichten:

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

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

[[File:mm_backend_FE-Module_Detail.png|thumb|400px]]

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

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

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

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

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

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

=Mögliches Endresultat=

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

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

<source lang="html4strict">

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

</source>

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

MetaModels

2013-09-10T07:32:23Z

Luis: /* Vorgehensschritte */

[[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.<br/>
<span style="color:red; font-size:18px; font-weight:bold">MetaModels läuft mit Contao 2.11.x und setzt PHP 5.3 voraus. </span> <br/>
<span style="color:black; font-size:18px; font-weight:bold">MetaModels ist (noch) nicht mit Contao 3.x kompatibel. Wer die Entwicklung voran treiben möchte, kann es [http://now.metamodel.me/en/fundraising hier] per Fundraising tun. </span>

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

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

==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 benötigten sonstigen Erweiterungen installiert sind, werde 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 '''Geoprotection''' ist nicht mehr Teil der Nightly Builds. Kann aber jederzeit über den oben angegeben Link separat geladen werden.}}{{Hinweis|Das Attribut '''Rating''' benötigt die beiden PHP-Dateien '''SimpleAjax.php''' und '''SimpleAjaxFrontend.php''', welche mit dem aktuellen Nightly Build ausgeliefert werden. Die beiden PHP-Dateien müssen im Root-Verzeichnis der Contao-Installation abgelegt werden.}}

==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]]
Den Überblick findest du [[MetaModels_Backend:_Attribute|hier]].

===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]]
Den Überblick findest du [[MetaModels_Backend:_Filter|hier]].

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

=Beispiele=
Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kannst, findest du 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

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

2013-09-10T07:31:59Z

Luis: /* Vorgehensschritte */

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

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

===Auszuführen===

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

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

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

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

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

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

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

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

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

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

==MM-Funktion: Zugriffsrechte definieren==

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

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

[[File:mm_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: Übersetzter select

2013-09-10T07:31:14Z

Luis: /* Hinweis */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|T]]
=Aufgabenstellung: Übersetzter select einrichten=
Es soll ein "Übersetzter select"-Attribut eingerichtet werden.

==Voraussetzung==
Es wird von Vorwissen aus den anderen Basics-Beispielen ausgegangen!

=Neue MetaModels erstellen=
[[File:Mm_translatedselect_Ubersicht.png|thumb|400px]]
Wir legen zwei neue MetaModels an:
# enthält die übersetzten Einträge für das select Feld (Hier: Mehrsprachige Einträge)
# zur Anwendung des select Feldes (Hier: Data)

<div style="clear: both"></div>
== MM für die mehrsprachigen Einträge ==
[[File:Mm_translatedselect_entriestable.png|thumb|400px]]
Erst legen wir das MetaModel an.
<div style="clear: both"></div>
[[File:Mm_translatedselect_entriesattribute.png|thumb|400px]]
In diesem erzeugen wir ein "Übersetzter Text" Attribut.
<div style="clear: both"></div>
[[File:Mm_translatedselect_entrie1de.png|thumb|200px]]
[[File:Mm_translatedselect_entrie1en.png|thumb|200px]]
[[File:Mm_translatedselect_entries.png|thumb|400px]]
Nach dem Bearbeiten der Eingabemasken und Rendereinstellungen (Wie in den anderen Beispielen) fügen wir die gewünschten Einträge in den gewünschten Sprachen hinzu.
Hier wurden zwei Einträge in jeweils zwei Sprachen benutzt.
<div style="clear: both"></div>
[[File:Mm_translatedselect_phpmyadmin.png|thumb|400px]]
Anschließend gehen wir auf den mysql server und betrachten die Tabelle "tl_metamodel_translatedtext". Dort suchen wir die gerade erstellten Einträge und merken uns den Wert "att_id".
<div style="clear: both"></div>
== MM zur Anwendung des select Feldes ==
[[File:Mm_translatedselect_datatable.png|thumb|400px]]
Erst legen wir das MetaModel an.
<div style="clear: both"></div>
[[File:Mm_translatedselect_dataattribute.png|thumb|400px]]
[[File:Mm_translatedselect_dataattributes.png|thumb|400px]]
In diesem erzeugen wir ein "Übersetzter Select" Attribut.
Wir wählen die Tabelle "tl_metamodel_translatedtext" aus.
Bei der Bedingung wird "att_id=[Der Wert von oben]" eingetragen.
Wenn die Sortierung eine Rolle spielt kann die Spalte "sorting" aus der Tabelle aus dem ersten MetaModel benutzt werden.
<div style="clear: both"></div>
[[File:Mm_translatedselect_data1de.png|thumb|400px]]
Nach dem Bearbeiten der Eingabemasken und Rendereinstellungen (Wie in den anderen Beispielen) fügen wir ein Datenelement hinzu. Bei der Auswahl erscheinen immer die Einträge aus der BE-Sprache (Hier Deutsch). Das ist unabhängig von der Sprache die wir gerade bearbeiten.
<div style="clear: both"></div>
=Frontend Ansicht=
[[File:Mm_translatedselect_FEoutput.png|thumb|400px]]
Wenn wir das zweite MM im Frontend ausgeben lassen, erscheinen nun die Dateneinträge mit dem jeweiligen selektierten Wert in der richtigen FE-Sprache.
<div style="clear: both"></div>

MetaModels Beispiel: Übersetzter select

2013-09-10T07:30:41Z

Luis: /* Vorgehensschritte */

[[Category:Admin HOWTOS]]
[[Category:MetaModels|T]]
=Aufgabenstellung: Übersetzter select einrichten=
Es soll ein "Übersetzter select"-Attribut eingerichtet werden.

===Hinweis===
Es wird von Vorwissen aus den anderen Beispielen ausgegangen!

=Neue MetaModels erstellen=
[[File:Mm_translatedselect_Ubersicht.png|thumb|400px]]
Wir legen zwei neue MetaModels an:
# enthält die übersetzten Einträge für das select Feld (Hier: Mehrsprachige Einträge)
# zur Anwendung des select Feldes (Hier: Data)

<div style="clear: both"></div>
== MM für die mehrsprachigen Einträge ==
[[File:Mm_translatedselect_entriestable.png|thumb|400px]]
Erst legen wir das MetaModel an.
<div style="clear: both"></div>
[[File:Mm_translatedselect_entriesattribute.png|thumb|400px]]
In diesem erzeugen wir ein "Übersetzter Text" Attribut.
<div style="clear: both"></div>
[[File:Mm_translatedselect_entrie1de.png|thumb|200px]]
[[File:Mm_translatedselect_entrie1en.png|thumb|200px]]
[[File:Mm_translatedselect_entries.png|thumb|400px]]
Nach dem Bearbeiten der Eingabemasken und Rendereinstellungen (Wie in den anderen Beispielen) fügen wir die gewünschten Einträge in den gewünschten Sprachen hinzu.
Hier wurden zwei Einträge in jeweils zwei Sprachen benutzt.
<div style="clear: both"></div>
[[File:Mm_translatedselect_phpmyadmin.png|thumb|400px]]
Anschließend gehen wir auf den mysql server und betrachten die Tabelle "tl_metamodel_translatedtext". Dort suchen wir die gerade erstellten Einträge und merken uns den Wert "att_id".
<div style="clear: both"></div>
== MM zur Anwendung des select Feldes ==
[[File:Mm_translatedselect_datatable.png|thumb|400px]]
Erst legen wir das MetaModel an.
<div style="clear: both"></div>
[[File:Mm_translatedselect_dataattribute.png|thumb|400px]]
[[File:Mm_translatedselect_dataattributes.png|thumb|400px]]
In diesem erzeugen wir ein "Übersetzter Select" Attribut.
Wir wählen die Tabelle "tl_metamodel_translatedtext" aus.
Bei der Bedingung wird "att_id=[Der Wert von oben]" eingetragen.
Wenn die Sortierung eine Rolle spielt kann die Spalte "sorting" aus der Tabelle aus dem ersten MetaModel benutzt werden.
<div style="clear: both"></div>
[[File:Mm_translatedselect_data1de.png|thumb|400px]]
Nach dem Bearbeiten der Eingabemasken und Rendereinstellungen (Wie in den anderen Beispielen) fügen wir ein Datenelement hinzu. Bei der Auswahl erscheinen immer die Einträge aus der BE-Sprache (Hier Deutsch). Das ist unabhängig von der Sprache die wir gerade bearbeiten.
<div style="clear: both"></div>
=Frontend Ansicht=
[[File:Mm_translatedselect_FEoutput.png|thumb|400px]]
Wenn wir das zweite MM im Frontend ausgeben lassen, erscheinen nun die Dateneinträge mit dem jeweiligen selektierten Wert in der richtigen FE-Sprache.
<div style="clear: both"></div>

MetaModels Beispiel: Referenced items

2013-09-10T07:28:53Z

Luis: /* Aufgabenstellung */

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==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==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:27:53Z

Luis: /* Lösungsansatz */

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==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.
==Lösungsansatz==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:26:39Z

Luis: /* Lösungsansatz */

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==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.
==Lösungsansatz==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. Die Projekte werden überdies über einen Filter sortiert:<br>
$objFilter = $objMetaModel->prepareFilter(10, array()); <br>
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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:25:41Z

Luis: /* Lösungsansatz */

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==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.
==Lösungsansatz==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt. Die Projekte werden überdies über einen Filter sortiert ( $objFilter = $objMetaModel->prepareFilter(10, array());). 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:

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

MetaModels Beispiel: Referenced items

2013-09-10T07:22:26Z

Luis:

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==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.
==Lösungsansatz==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden. Die Projekte werden jeweils mit einem Titel-Link (h3), einer Kurzbeschreibung und der dazu gehörigen Bildgalerie gezeigt.

Das MetaModels-Template könnte wie folgt aussehen:

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

MetaModels Beispiel: Referenced items

2013-09-10T06:59:21Z

Luis:

[[Category:MetaModels|T2]]
=Zwei MetaModels zu einander referenzieren=
==Ausgangslage==
Es gibt ein MetaModel mit "Kunden" und eines mit "Projekte".
==Aufgabenstellung==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden.
==Lösungsansatz==
Man möchte, dass auf der Detailansicht des Kunden, auch die jeweils dazu gehörigen Projekte angezeigt werden.

MetaModels Beispiel: Referenced items

2013-09-10T06:49:37Z

Luis: Die Seite wurde neu angelegt: „REferenced Items“

REferenced Items

Kategorie:MetaModels

2013-07-04T20:37:21Z

Luis:

B = Basics |
M = MetaModels Backend-Einstellungen |
T = Tipps & Tricks

MetaModels Backend: Filter

2013-07-04T20:32:13Z

Luis:

[[Category:MetaModels|M4]]
=Allgemeines zu den Filtern=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

==Was sind eigentlich Filter?==
[[File:icons_filter.png|left|32px]]
Bei MetaModels haben Filter eine breitere Bedeutung als dies umgangssprachlich der Fall ist. Filter steuern jede Art von Ansichtsdarstellung (Renderings), sowohl im Backend als auch im Frontend. Z.B. ob ein Datensatz als 'Published' erscheinen soll oder nicht.

Ein weiteres Einsatzgebiet ist klar das Ausfiltern von Listen in der Frontend-Darstellung. Beispielsweise, wenn man sich über eine Auswahl (Select, Radio-Buttons, Links) - einzeln oder kombiniert - gewisse Datensätze anzeigen lassen will.

Ein ganz anderes Einsatzgebiet beschäftigt sich mit der Navigation von der Listen- zur Detailansicht. Aus der Sicht MetaModels gibt es keine separaten Listen- und Archivansichten (respektive separate Frontend-Module), wie man diese z.B. von Contao-News oder Catalog her kennt. Für MetaModels ist jede Ansicht eine Listenansicht. Der Filter 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.

=Einstieg=
[[File:mm_backend_filter_einstieg.png|thumb|365px]]
Mit Klick auf '''Neu''' erstellt man einen leeren Filter.
# Name editieren
# Einstellungen editieren.
<div style="clear: both"></div>

==Name editeren==
[[File:mm_backend_filter_name_editieren.png|thumb|365px]]
Der Name kann jederzeit geändert werden, ohne dass man später im den Renderings oder Frontend-Modulen eine Anpassung vornehmen muss.
<div style="clear: both"></div>

==Einstellungen editeren==
[[File:mm_backend_filter_einstellungen.png|thumb|365px]]
Jeder Filter besteht aus mindestens einer Einstellung. Ein Filter kann auch aus einer Kombination von Einstellungen aufgebaut sein.

Nachfolgend die möglichen Einstellungen:
<div style="clear: both"></div>

=Filter=

==Vordefiniertes Filterset==
[[File:mm_filter_vordefinierte_einstellung.png|thumb|365px]]
<div style="clear: both"></div>

==Einfache Abfrage==
[[File:mm_filter_einfache_abfrage.png|thumb|365px]]
<div style="clear: both"></div>

==Eigenes SQL==
[[File:mm_filter_eigenes_SQL.png|thumb|365px]]
<div style="clear: both"></div>

==Und-Bedingung (AND)==
[[File:mm_filter_und_bedingung.png|thumb|365px]]
<div style="clear: both"></div>

==Oder-Bedingung (OR)==
[[File:mm_filter_oder_bedingung.png|thumb|365px]]
<div style="clear: both"></div>

==Veröffentlichungsstatus==
[[File:mm_filter_published_state.png|thumb|365px]]
<div style="clear: both"></div>

==Geoprotection==
[[File:mm_filter_geoprotection.png|thumb|365px]]
<div style="clear: both"></div>

==Ja/Nein==
[[File:mm_filter_ja_nein.png|thumb|365px]]
<div style="clear: both"></div>

==Wert von-/bis==
[[File:mm_filter_wert_von_bis.png|thumb|365px]]
<div style="clear: both"></div>

==2 Felder mit Werten==
[[File:mm_filter_wert_innerhalb_2_felder.png|thumb|365px]]
<div style="clear: both"></div>

==Einzelauswahl==
[[File:mm_filter_einfache_auswahl.png|thumb|365px]]
<div style="clear: both"></div>

==Mehrfachauswahl==
[[File:mm_filter_mehrfachauswahl.png|thumb|365px]]
<div style="clear: both"></div>

==Textfilter==
[[File:mm_filter_textfilter.png|thumb|365px]]
<div style="clear: both"></div>

MetaModels Backend: Eingabemaske

2013-07-04T20:31:53Z

Luis:

[[Category:MetaModels|M3]]
=Allgemeines zur Eingabemaske (fka Paletteneinstellungen)=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

==Was ist eigentlich eine Eingabemaske ?==
[[File:icons_paletteneinstellungen.png|left|32px]]
Mit der Eingabemaske wird im Wesentlichen das Aussehen der Datenerfassung im Backend gesteuert. Es beantwortet die folgenden Fragen:
* Wo werden die Daten erfasst?
* Wie sieht die Übersichtsliste aus?
* Wie kann ich die Übersichtliste organisieren?
* Wie sieht das Erfassungsformular aus?
* Wie kann ich das Aussehen des Erfassungsformulars beeinflussen?

=Einstieg=
[[File:mm_backend_paletteneinstellungen.png|thumb|400px]]
Nachdem man über '''Neue Eingabemaske''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
# Eingabemaske bearbeiten: Erstellen und organisieren der BE Liste
# Einstellungen der Eingabemaske bearbeiten: Erstellen und organisieren des BE Formulars
<div style="clear: both"></div>

=Backend Liste=
==Eingabemaske==
[[File:mm_backend_paletteneinstellungen_palette.png|thumb|400px]]
Nachdem man über '''Neue Eingabemaske''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
* '''Name''': Name der Palette
* '''Panel-Layout''': Damit lässt sich die BE Liste organisieren. 4 Werte stehen zur Verfügung: filter, sort, search und limit. Mit Komma oder Semikolon steuert man die Darstellung (siehe nächster Screen)
* '''Integration''': Unabhängig, Als Kind-Tabelle
* '''Sortiermodus''':
** 0 Datensätze werden nicht sortiert
** 1 Datensätze nach festem Feld sortieren,
** 2 Datensätze nach variablen Feld sortieren,
** 5 Einträge werden als Baumstruktur dargestellt (siehe Seitenstruktur)
* '''Sortier-Flag''': diverse Optionen
* '''Backend-Bereich''': Hier kann man auswählen, wo in der Backend-Navigation (links) der Eintrag 'Musicbox' erscheinen soll. Neu lässt sich das eigene MetaModel auch in eine Bereich namens "MetaModel Boilerplate" packen
* '''Backend-Icon''': Optional kann man sein eigenes Icon anzeigen lassen
* '''Backend-Beschreibung''': Sprache, Labeltext (Name deiner BE Liste), Beschreibungstext (Tooltip)
<div style="clear: both"></div>

==Panel-Layout==
[[File:mm_backend_paletteneinstellungen_panel.png|thumb|400px]]
Die Einträge unter dem Panel-Layout bestimmen, ob und wie die einzelnen Funktionen erscheinen.
<div style="clear: both"></div>

==Backend Liste gestalten==
[[File:mm_backend_liste_rendereinstellungen.png|thumb|400px]]
Es besteht die Möglichkeit, die BE-Liste etwas user-freundlicher zu gestalten, indem man eine spezifische CSS-Datei einbettet. Mit wenigen CSS-Anweisungen kriegt man recht schnell eine anständige Ansicht hin. Hier folgend ein Beispiel.

'''CSS-Datei laden'''<br />
Die CSS-Datei kann irgendwo im Verzeichnis '''tl_files''' (Contao 2) bzw. '''files''' (Contao 3) abgelegt werden. Über '''Zusätzliche CSS-Dateien''' kann die Datei geladen und anschliessend die Option '''Veröffentlichen''' angewählt werden. Nützlich ist in diesem Fall auch die Option '''Labels verbergen'''.

Über die HTML-Source Ansicht der BE-Liste kann man sich die verwendeten CSS-Klassen anzeigen lassen und in der CSS-Datei entsprechend formatieren. Ein Beispiel folgt unten.

Das Ganze funktioniert selbstredend auch für FE-Ansichten.
<div style="clear: both"></div>

'''Das Beispiel musicbox.css'''
[[File:mm_backend_liste.png|thumb|400px]]
<source lang="css">
.item {
overflow: hidden;
padding: 10px 0;
}
.item .field {
margin-bottom: 2px;
}
.item .cover {
float: left;
margin-right: 20px;
}
.item .title .value {
font-size: 13px;
font-weight: bold;
}
.item .composer .value {
color: #c00;
}
</source>
<div style="clear: both"></div>

=Backend Formular=
==Attribute==
[[File:mm_backend_paletteneinstellungen_liste.png|thumb|400px]]
Nachdem man über '''Alle hinzufügen''' alle Attribute hinzugefügt hast, kann man die Liste per Drag&Drop organisieren. Die Reihenfolge legt fest, in welcher Reihenfolge die Eingabefelder im Erfassungsformular erscheinen.
<div style="clear: both"></div>

==Attribut bearbeiten==
[[File:mm_backend_paletteneinstellungen_attribut.png|thumb|400px]]
Jedes Attribut hat gemäss seinem Typ spezifische Einstelloptionen. Was sie jedoch alle gemein haben, sind die so genannten '''Backend-Classes'''. Darüber lassen sich die Eingabefelder ein wenig gestalten. Folgende CSS-Klassen stehen zur Verfügung:
* '''w50''': Die Breite auf 50% festlegen und nach links floaten.
* '''clr''': Alle Floats clearen.
* '''long''': Vergrößert das Eingabefeld, sodass es zwei Spalten umfasst.
* '''wizard''': Das Eingabefeld kürzen, sodass Platz für einen Wizard ist (z.B. einen Date-Picker).
* '''m12''': Dem Element einen oberen Abstand (top-margin) von 12 Pixel geben (für einzelne Checkboxen).
<div style="clear: both"></div>

==Das Backend-Formular==
[[File:mm_backend_paletteneinstellungen_formular.png|thumb|400px]]
Und so könnte das Backend-Formular in etwa aussehen. Rot gekennzeichnet die Backend-Klassen, die den Attributen mitgegeben wurden.
<div style="clear: both"></div>

==Das Backend-Formular mit Legenden==
[[File:mm_backend_eingabemaske_legenden.png|thumb|400px]]
Das Backend-Formular lässt sich noch weiter organisieren, indem man Eingabefelder, etc. über '''Legenden''' gruppiert (siehe nebenstehendes Beispiel).
<div style="clear: both"></div>

[[File:mm_backend_eingabemaske_legende_erfassen1.png|thumb|400px]]
Hierzu auf der Attributsübersicht auf '''Neu''' klicken.
<div style="clear: both"></div>

[[File:mm_backend_eingabemaske_legende_erfassen2.png|thumb|400px]]
Als Typ kann man nun den Typ '''Legende''' wählen und gibt anschliessend einen '''Legenden-Titel''' ein.
<div style="clear: both"></div>

[[File:mm_backend_eingabemaske_legende_erfassen3.png|thumb|400px]]
Die '''Legenden-Titel''' können nun per Drag&Drop an die gewünschte Position verschoben werden. Sie können auch jederzeit umbenannt werden.
<div style="clear: both"></div>

=Einstellungen der Eingabefelder (Attribute)=

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

==Auswahl (Select)==
[[File:mm_paletteneinstellungen_select.png|thumb|400px]]
<div style="clear: both"></div>

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

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

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

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

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

==Longtext==
[[File:mm_paletteneinstellungen_longtext.png|thumb|400px]]
Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.
<div style="clear: both"></div>

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

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

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

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

==Timestamp (Datum/Zeit)==
[[File:mm_paletteneinstellungen_timestamp.png|thumb|400px]]
<div style="clear: both"></div>

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

==Übersetztes Alias==
Details folgen

==Übersetzte Datei==
Details folgen

==Übersetzter Longtext==
Details folgen

==Übersetzte Auswahl==
Details folgen

==Übersetzte Tags==
Details folgen

==Übersetzter Text==
Details folgen

MetaModels Backend: Ausgabevorgaben

2013-07-04T20:30:53Z

Luis:

[[Category:MetaModels|M2]]
=Allgemeines zu den Ausgabevorgaben (aka Rendereinstellungen)=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

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

=Einstieg=
[[File:mm_backend_ausgabevorgaben.png|thumb|365px]]
Nachdem man über '''Neu''' einen Eintrag generiert hat, stehen 2 Funktionen zur Verfügung:
# Ausgabe bearbeiten: Erstellen und organisieren von Ansichten
# Attributseinstellungen bearbeiten: Hinzufügen und organisieren von Attributen
'''Hinweis'''<br>
Die ID der Rendereinstellung (Tool-Tip bei Icon 'Info) ist nützlich, wenn man den Detail-Link anpassen möchte. Siehe [[MetaModels_Beispiel_2#Detail-Link_anpassen|hier]]
<div style="clear: both"></div>

=Ansicht=
==Einstellungen==
[[File:mm_backend_ausgabevorgaben_formular.png|thumb|365px]]
Hier legt man die Einstellungen fest, die später in den Frontend-Modulen als so genannte '''Anzuwendende Rendereinstellungen''' zum Tragen kommen.

* '''Name''': Name der Ansicht
* '''Als Standard verwenden''': Optional
* '''Template''': Standardmässig stehen 2 Templates zur Verfügung
** metamodel_prerendered (Globaler Gültigkeitsbereich)... nimmt Rücksicht auf die Reihenfolge, die man in den Attributseinstellungen vornimmt
** metamodel_unrendered (Globaler Gültigkeitsbereich) ... ignoriert die Rendersettings, man kann das Template den eigenen Wünschen anpassen
** hier tauchen auch die selbsterstellten metamodel_Templates auf
*'''Ausgabeformat''': HTML5, XHTML, Text
* '''Zielseite''': Wichtig, wenn man von einer Liste zu einer Detailseite springen will
** '''Springe zu Seite''': Interner Link oder URL, der zur Zielseite führt
** '''Filtereinstellungen''': Hier kann man den Filter angeben, der den Link zur Zielseite anzeigt. Gibt man keinen Filter an, wird im Frontend kein "Detail"-Link angezeigt.
* '''Leere Einträge verbergen'''
* '''Labels verbergen'''
* '''Zusätzliche CSS-Dateien'''
* '''Zusätzliche JavaScript-Dateien'''
<div style="clear: both"></div>

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

==Attribut-Templates==
[[File:mm_backend_ausgabevorgaben_liste_detail.png|thumb|365px]]
Jedes Attribute verfügt über ein eigenes Template. Auf Wunsch kannt man natürlich auch hierauf Zugriff nehmen.
<div style="clear: both"></div>

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

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

<div class="layout_full">

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

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
<?php if (($strValue = $arrItem[$this->getFormat()][$field]) || ($strValue = $arrItem['text'][$field])): ?>
<div class="field <?php echo $field; ?>">
<?php if(!$this->$strRendersettings->get('hideLabels')): ?>
<div class="label"><?php echo $strName; ?>: </div>
<?php endif; ?>
<div class="value"> <?php echo $strValue; ?></div>
</div>
<?php endif; ?>
<?php endforeach; ?>
<?php if ($arrItem['jumpTo']['deep']): ?>
<a href="<?php echo $arrItem['jumpTo']['url']; ?>"><?php echo $this->details; ?></a>
<?php endif; ?>
</div>
<?php endforeach; ?>
</div>
<?php else: ?>
<p class="info"><?php echo $this->noItemsMsg; ?></p>
<?php endif; ?>
<?php endif; ?>

</source>

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

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

<source lang="php">

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

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

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

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

</source>

==Mögliches Tabellentemplate==
Ein weiteres Umsetzungsbeispiel, dass im [https://community.contao.org/de/showthread.php?39668-Template-f%FCr-Ausgabe-als-Tabelle diesem Thread] behandelt wurde. Bei diesem Beispiel erkennt man auch, dass man gänzlich auf die vorgegebenen CSS-Klassen verzichten und ein komplett eigenes Template erstellen kann.
<source lang="php">

<?php if (count($this->data)): /* display only if there is data. */ ?>
<?php $arrItem = $this->data[0]; /* fetch first item for title columns. */ ?>

<table class="termintabelle">
<thead>
<tr>
<th><?php echo $arrItem['attributes']['title']; ?></th>
<th><?php echo $arrItem['attributes']['startdatum']; ?></th>
<th><?php echo $arrItem['attributes']['enddatum']; ?></th>
<th><?php echo $arrItem['attributes']['meldeschluss']; ?></th>
<th><?php echo $arrItem['attributes']['ort']; ?></th>
<th><?php echo $arrItem['attributes']['kontaktperson']; ?></th>
<th><?php echo $arrItem['attributes']['email']; ?></th>
</tr>
</thead>

<tbody>
<?php?>
<?php foreach ($this->data as $arrItem): /* loop over all items. */ ?>

<tr>
<td><?php echo $arrItem['text']['title']; ?></td>
<td><?php echo $arrItem['text']['startdatum']; ?></td>
<td><?php echo $arrItem['text']['enddatum']; ?></td>
<td><?php echo $arrItem['text']['meldeschluss']; ?></td>
<td><?php echo $arrItem['text']['ort']; ?></td>
<td><?php echo $arrItem['text']['kontaktperson']; ?></td>
<td><a href="mailto:<?php echo $arrItem['text']['email']; ?>"><?php echo $arrItem['text']['email']; ?></a></td>
</tr>

<?php endforeach; /* item loop */ ?>
</tbody>
</table>

<?php endif; ?>

</source>

MetaModels Backend: Ansichtseinstellungen

2013-07-04T20:30:19Z

Luis:

[[Category:MetaModels|M5]]
=Allgemeines zu den Ansichteinstellungen=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

=Was sind eigentlich Ansichtseinstellungen?=
[[File:icons_ansichtseinstellungen.png|left|32px]]
Für jedes MetaModel müssen die Zugriffsberechtigungen definiert werden, damit über die Backend-Navigation darauf zugegriffen und die jeweiligen Daten eingeben werden können. Es kann mehr als eine Backend-Gruppe definiert werden. Nur der Administrator hat aber vollen Zugriff auf alle Backend-Funktionen eines MetaModels.

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

MetaModels Backend: Attribute

2013-07-04T20:29:40Z

Luis:

[[Category:MetaModels|M1]]
=Allgemeines zu den Attributen=
# [[MetaModels_Backend:_Attribute| MetaModels Attribute]]
# [[MetaModels_Backend:_Ausgabevorgaben| MetaModels Ausgabevorgaben]]
# [[MetaModels_Backend:_Eingabemaske| MetaModels Eingabemaske]]
# [[MetaModels_Backend:_Filter| MetaModels Filter]]
# [[MetaModels_Backend:_Ansichtseinstellungen| MetaModels Ansichtseinstellungen]]

==Was sind eigentlich Attribute?==
[[File:icons_attribute.png|left|32px]]
Grob gesagt: die Datenbank-Objekte (aka Datensatz), die in den MetaModels erfasst werden, setzen sich aus den verschiedensten Attributen (aka Eigenschaften oder Feldern) zusammen.
<div style="clear: both"></div>

=Einstieg=
[[File:mm_backend_attribute_liste.png|thumb|365px]]
Über '''Neues Attribut''' erfasst man die gewünschten Attribute. Name und Beschreibung eines Objektes, die Fotos, die das Objekt illustrieren, eine Checkbox, mit der ein Eintrag veröffentlicht werden kann - all das wird in Attributen abgelegt. Jedes Attribut entspricht also einer Spalte in der Datenbank-Tabelle.
Aus den verschiedenen Attributen stellt man die Eingabemaske für die einzelnen Datensätze zusammen. Für jeden Attributtyp gibt es diverse Einstellungen, die im Folgenden beim jeweiligen Attribut erläutert werden.
<div style="clear: both"></div>

==Attribut definieren==
[[File:mm_attribut_settings_eingabemaske.png|thumb|365px]]
Mit einem Klick auf das Icon Bearbeiten fängt man an. Zuerst wird der Attributtyp ausgewählt. Für '''jedes''' Attribut müssen dann '''Basis-Attributkonfigurationen''' festgelegt werden:

* '''Attribut-Typ''': Typ (gesamte Liste siehe weiter unten)
* '''Spaltenname''' (Name der Tabellenspalte in der Datenbank)
* '''Name''' (Name der Feldüberschrift bei der Erfassung des Datensatzes)
* '''Beschreibung''' (Beschreibung unterhalb des Feldes bei der Erfassung des Datensatzes)

Bei allen Attributen findet man unter den '''Erweiterten Einstellungen''' (Advanced settings) noch die Checkbox '''Eindeutige Werte''' (Unique values) - wird diese angehakt, kann für das betreffende Attribut jeder Wert nur einmal verwendet werden.

Den Einträgen, die man unter '''Name''' und '''Beschreibung''' eingibt, begegnet man später in der Eingabemaske wieder (siehe rote Markierung im Screenshot).
<div style="clear: both"></div>

=Attribute=
==Alias==
[[File:mm_attribut_alias.png|thumb|365px]]

Das Attribut '''Alias''' erzeugt ein einzeiliges Eingabefeld. Dieses Attribut sollte erst dann erzeugt werden, wenn mindestens ein Textfeld (vorzugsweise ein Titel-Feld) vorhanden ist, aus dem sich das Alias automatisch bilden kann.

'''Advanced Settings'''
*'''Eindeutige Werte'''
*'''Neuerstellung des Alias erzwingen.''': Anhaken, wenn sich das Alias automatisch anpassen soll, wenn immer der Wert des zugewiesenen Feldes geändert wird (ist etwas buggy, Stand:März 2013)
*'''Alias-Felder''': Attribut, aus dem das Alias generiert wird. Es können auch mehrere Attribute definiert werden. In diesem Fall werden die einzelnen Attribute über einen Bindestrich zu einem Alias zusammengefügt.
<div style="clear: both"></div>

==Auswahl (Select)==

[[File:mm_attribut_select.png|thumb|365px]]
Das Attribut '''Auswahl''' erzeugt ein HTML-Select.

'''Anzeigeeinstellungen'''
* '''select_table''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen, auch die mit MetaModels erstellten (siehe Hinweis weiter unten)
* '''select_id''': Vorzugsweise '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* '''select_column''': Namen der Spalte auswählen, der die Werte des Selects zur Verfügung stellt
* '''select_alias''': Vorzugsweise das '''alias''' auswählen
*'''Auswahl-Sortierung''': Hier lässt sich einstellen, in welcher Reihenfolge die Begriffe im Select erscheinen sollen
*'''SQL''': Die Auswahlmöglichkeiten lassen sich per SQL einschränken

Hinweis: Um das Attribut '''Auswahl''' anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die Select-Werte angelegt werden.
Die genaue Vorgehensweise ist [[MetaModels_Beispiel_4|hier]] beschrieben. Erst dann kann man unter '''select_table''' die betreffende Tabelle auswählen.

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

==Bewertung (Rating)==
[[File:mm_attribut_rating.png|thumb|365px]]
Das Attribut '''Bewertung''' erzeugt eine Aufzählung von Icons. Standardmässig werden Sterne angezeigt. Man kann aber auch eigene definieren.

'''Beispiel'''<br>
[[File:mm_attribut_rating_beispiel.png|link=]]

'''Bitte beachten'''<br>
Das Attribut benötigt die beiden PHP-Dateien '''SimpleAjax.php''' und '''SimpleAjaxFrontend.php''', welche mit dem aktuellen Nightly Build ausgeliefert werden.<br>
Die beiden PHP-Dateien müssen im Root-Verzeichnis der Contao-Installation abgelegt werden.
<div style="clear: both"></div>

==Color picker (Farbe)==
[[File:mm_attribut_color.png|thumb|365px]]
Das Attribut '''Color picker''' erzeugt zwei Eingabefelder (Hex Farbangabe) und einen Farbwähler
<div style="clear: both"></div>

==Datei (File)==
[[File:mm_attribut_datei.png|thumb|365px]]
Das Attribut '''Datei''' erzeugt ein Wurzelverzeichnis, aus dem sich einzelne Dateien oder Order anwählen lassen.
<div style="clear: both"></div>

==Dezimal (Decimal)==
[[File:mm_attribut_dezimal.png|thumb|365px]]
Das Attribut '''Dezimal''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor
<div style="clear: both"></div>

==GeoProtection==
[[File:mm_attribut_geoprotection.png|thumb|365px]]
Das Attribut '''GeoProtection''' erzeugt ein HTML-Select. Als Optionen stehen die angewählten Länder zur Verfügung.<br />
Es bietet die Möglichkeit Datensätze so zu konfigurieren, das sie für ausgewählte Länder sichtbar sind oder versteckt werden.

'''Bitte beachten'''<br>
Dieses Attribut benötigt die Extension [https://contao.org/de/extension-list/view/geoprotection.de.html geoprotection], ansonsten wird eine [https://community.contao.org/de/showthread.php?38172-Erste-Gehversuche&p=248078&viewfull=1#post248078 Fehlermeldung] rausgeworfen.
Und wird nicht mit den Nightly Builds geladen, kann aber bei [https://github.com/MetaModels/attribute_geoprotection GitHub] separat runtergeladen werden
<div style="clear: both"></div>

==Kombinierte Einträge (Combined Values)==
[[File:mm_attribut_combinedvalues.png|thumb|365px]]

Das Attribut '''Kombinierte Einträge''' erzeugt ein...

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

==Kontrollkästchen (Checkbox)==
[[File:mm_attribut_checkbox.png|thumb|365px]]
Das Attribut '''Kontrollkästchen''' erzeugt eine einfache HTML-Checkbox.

'''Erweiterte Einstellungen'''
*'''Eindeutige Werte'''
*'''Veröffentlichen''': Erzeugt im Backend (in der Listenansicht mit Icon 'Auge') die Option, einen Datensatz für das Frontend freizugeben. Hierzu muss aber auch ein Filter definiert werden. Die genaue Vorgehensweise ist [[MetaModels_Beispiel_3#Published_Filter_im_Frontend_einbauen|hier]] beschrieben.
<div style="clear: both"></div>

==Land (Country)==
[[File:mm_attribut_land.png|thumb|365px]]
Das Attribut '''Land''' erzeugt ein HTML-Select, welches alle Länder enthält.
<div style="clear: both"></div>
[[File:mm_attribut_land_filter.png|thumb|365px]]
'''Verfügbare Länder filtern'''<br>
Wenn dieses Feld leer ist, werden automatisch alle Länder im Select angezeigt. Die Auflistung lässt sich verkürzen, indem man nur die gewünschten Länder hier auflistet.
<div style="clear: both"></div>

==Langtext (Longtext)==
[[File:mm_attribut_longtext.png|thumb|365px]]
Das Attribut '''Langtext''' erzeugt eine Textarea.

<span style="color:red">Es stehen 3 Richtext-Editoren zur Verfügung: tinyFlash, tinyMCE und tinyNews.</span>
<div style="clear: both"></div>

[[File:mm_paletteneinstellungen_longtext.png|thumb|365px]]
Die <span style="color:red">Richtext-Editoren</span> können über die [[MetaModels_Backend:_Eingabemaske#Longtext|Eingabemaske]] (fka Paletteneinstellungen) aktiviert werden.
* Paletteneinstellungen
* Paletteneinstellungen bearbeiten (also auf das Palettenicon ganz rechts klicken)
* Formular auswählen
* Bleistiftsymbol beim Attribut "Longtext" anklicken
* unter '''presentation_legend''' gibt es einen Punkt '''Enable richtext editor on this'''
* hier kann der Richtext-Editor ausgewählt werden
<div style="clear: both"></div>

==Mehrfachauswahl (Tags)==
[[File:mm_attribut_tags.png|thumb|365px]]
Das Attribut '''Mehrfachauswahl (Tags)''' erzeugt Checkboxen mit Mehrfachauswahl.

'''Anzeigeeinstellungen'''
* '''Datenbanktabelle''': Hier erscheinen alle in der Contao-Installation verfügbaren Tabellen (siehe Hinweis weiter unten)
* '''Tabellenspalte''': Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
* '''ID der Mehrfachauswahl''': Vorzugsweise '''id''' auswählen. Standardmässig führt jede Contao-Tabelle eine ID mit
* '''Alias der Mehrfachauswahl''': Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
* '''Sortierung der Mehrfachauswahl''': Namen der Spalte auswählen, die die Werte der Tags zur Verfügung stellt
*'''SQL''': Die Auswahlmöglichkeiten können per SQL eingeschränkt werden

Hinweis: Um das Attribut '''Tags''' anlegen zu können, muss man zuerst eine neue Tabelle (sprich ein neues MetaModel) erstellen, in der die verschiedenen Tags angelegt werden. Die genaue Vorgehensweise ist - am Beispiel des Attributes '''Auswahl''' - [[MetaModels_Beispiel_4|hier]] beschrieben. Erst dann kann man unter '''Datenbanktabelle''' die betreffende Tabelle auswählen.
<div style="clear: both"></div>

==Numerisch (Numeric)==
[[File:mm_attribut_numerisch.png|thumb|365px]]
Das Attribut '''Numerisch''' erzeugt ein einzeiliges Eingabefeld und nimmt eine Feldprüfung vor

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

==Sprachschlüssel (Langcode)==
[[File:mm_attribut_sprachcode.png|thumb|365px]]
Das Attribut '''Sparchcode''' erzeugt ein HTML-Select. Als Optionen stehen die angewählten Sprachen (langcodes) zur Verfügung.
<div style="clear: both"></div>

==Text==
[[File:mm_attribut_text.png|thumb|365px]]
Das Attribut '''Text''' erzeugt ein einzeiliges Eingabefeld.
<div style="clear: both"></div>

==Timestamp (Datum)==
[[File:mm_attribut_timestamp.png|thumb|365px]]
Das Attribut '''Timestamp''' erzeugt ein einzeiliges Eingabefeld mit Datumsprüfung.

'''Datum und Zeit > Schema'''
*'''Datum''' erzeugt z.B. 2013-03-06
*'''Datum und Zeit''' erzeugt z.B. 2013-03-06 08:15
Das Datum wird so konfiguriert, wie es in den Backend-Einstellungen von Contao definiert ist. Im Frontend richtet es sich nach den allgemeinen Einstellungen oder je nach Konfiguration nach den Einstellungen in der Seitenstruktur.

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

==URL==
[[File:mm_attribut_url.png|thumb|365px]]
Das Attribut '''URL''' erzeugt zwei einzeilige Eingabefelder. Eines für den Linktext und eines für die URL.
Mit dabei ist auch noch ein Icon, über das sich eine Seite aus der Seitenstruktur auswählen lässt.

'''Bitte beachten'''<br>
Externe Links müssen mit einem http:// (oder https://) versehen sein, anderfalls interpretiert MetaModels die URL als relativen Link.

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

==Übersetztes Alias==
[[File:mm_attribut_translated_alias.png|thumb|365px]]
Das Attribut '''translatedalias''' erzeugt ein einzeiliges Eingabefeld.
<div style="clear: both"></div>

==Übersetzte Datei==
[[File:mm_attribut_translated_datei.png|thumb|365px]]
Das Attribut '''Übersetzte Datei''' erzeugt ein einzeiliges Eingabefeld.
<div style="clear: both"></div>

==Übersetzter Longtext==
[[File:mm_attribut_translated_longtext.png|thumb|365px]]
Das Attribut '''Übersetzter Longtext''' erzeugt eine mehrzeilige Textarea.
<div style="clear: both"></div>

==Übersetzte Auswahl==
[[File:mm_attribut_translated_auswahl.png|thumb|365px]]
Das Attribut '''Übersetzte Auswahl''' erzeugt ein HTML Select.

Ein Beispiel zur Verwendung ist hier zu finden:
[[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten
<div style="clear: both"></div>

==Übersetzte Tags==
[[File:mm_attribut_translated_tags.png|thumb|365px]]
Das Attribut '''Übersetzte Tags''' erzeugt ein....
<div style="clear: both"></div>

==Übersetzter Text==
[[File:mm_attribut_translated_text.png|thumb|365px]]
Das Attribut '''Übersetzter Text''' erzeugt ein einzeiliges Eingabefeld.
<div style="clear: both"></div>

Kategorie:MetaModels Basics

2013-07-04T20:26:36Z

Luis: Die Seite wurde geleert.

2013-06-19T20:13:26Z

Luis: /* Anmerkung */

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

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - 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
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten

=Eine leere Datenbank erstellen=

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

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

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

===Anmerkungen===

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

===Auszuführen===

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

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

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

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

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

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

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

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (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
{{Hinweis|Mit der Erweiterung '''MetaModels Boilerplate''' (Nightly Build) kann man die eigenen MetaModels in einem separaten Bereich in der BE-Navigation unterbringen.}}

===Anmerkung===
Die Option '''Sortierung''' ist beim erstmaligen Bearbeiten der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s (hier: Inhalte) die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.

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

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<div style="clear: both"></div>

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

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

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

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

==MM-Funktion: Zugriffsrechte definieren==

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

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

[[File:mm_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 1

2013-06-19T20:11:33Z

Luis: /* BE-Liste */

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

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - 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
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten

=Eine leere Datenbank erstellen=

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

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

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

===Anmerkungen===

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

===Auszuführen===

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

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

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

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

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

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

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

# [[MetaModels_Backend:_Attribute|'''Attribute''']] (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
{{Hinweis|Mit der Erweiterung '''MetaModels Boilerplate''' (Nightly Build) kann man die eigenen MetaModels in einem separaten Bereich in der BE-Navigation unterbringen.}}

===Anmerkung===
Die Option '''Sortierung''' ist beim erstmaligen Bearbeiten der Seite noch nicht sichtbar. Es empfiehlt sich daher, nach Auswahl des '''Backend-Bereich'''s (hier: Inhalte) die Seite zu speichern. Jetzt kann die Sortierung festgelegt werden.

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

Im letzten Kapitel auf dieser Seite ('''Die Daten erfassen''') sieht man, wie die Liste/das Formular zwecks Erfassung der Musikstücke aussieht.
<div style="clear: both"></div>

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

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

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

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

==MM-Funktion: Zugriffsrechte definieren==

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

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

[[File:mm_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]]