Quelltext der Seite MetaModels

{{stub}}
[[Category:Extensions]]
[[Category:MetaModels]]
{{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.</span> 

===Vorgehensschritte===
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten

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

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

==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
* metamodelsattribute_alias
* metamodelsattribute_checkbox
* metamodelsattribute_combinedvalues
* 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 Paletteneinstellungen===
[[File:icons_paletteneinstellungen.png|left|link=|32px]]
Den Überblick findest du [[MetaModels_Backend:_Paletteneinstellungen|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]]