MetaModels: Unterschied zwischen den Versionen
Aus Contao Community Documentation
Luis (Diskussion | Beiträge) (→Vorwort: Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)) |
Zonky (Diskussion | Beiträge) K (Hinweis Handbuch) |
||
(45 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | {{ | + | {{Hinweis|Die Angaben, Beschreibungen und Screenshot beziehen sich auf MetaModels bis etwa Mitte 2016 und sind nicht aktuell! |
+ | Im [http://metamodels.readthedocs.io/de/latest/ MetaModels-Handbuch] sind aktuelle Angaben zu finden.}} | ||
+ | |||
[[Category:Extensions]] | [[Category:Extensions]] | ||
− | [[Category:MetaModels]] | + | [[Category:MetaModels|B]] |
{{ExtInfo | {{ExtInfo | ||
| Dev=Metamodels Team | | Dev=Metamodels Team | ||
Zeile 14: | Zeile 16: | ||
=Vorwort: Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)= | =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. | Die Erweiterung MetaModels ist der Nachfolger der Catalog-Extension. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zum Catalog besteht nicht. | ||
− | |||
− | |||
===Vorgehensschritte=== | ===Vorgehensschritte=== | ||
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels | # [[MetaModels|Start: Installation]] - Download und Installation von MetaModels | ||
− | # [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - | + | # [[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_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_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_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen | ||
− | =Download= | + | =Download & Installation= |
==Download von der Demosite== | ==Download von der Demosite== | ||
Zeile 30: | Zeile 30: | ||
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. | 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> | <div style="clear: both"><br><br></div> | ||
+ | |||
+ | ==Installation via Composer== | ||
+ | |||
+ | MetaModels kann vollständig über [http://de.contaowiki.org/Composer Composer] installiert werden. Alle Attribute liegen auf [https://packagist.org/ Packagist] und werden vom offiziellen MetaModels Team betreut. Für die Installation von MetaModels über Composer muss man lediglich nach "metamodels" suchen, alle verfügbaren Pakete werden danach aufgelistet. | ||
==Download aus dem Entwicklungsrepository GitHub== | ==Download aus dem Entwicklungsrepository GitHub== | ||
Zeile 41: | Zeile 45: | ||
===Core=== | ===Core=== | ||
* [https://github.com/MetaModels/core MetaModels (Das Core-Modul)] | * [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=== | ===Abhängigkeiten=== | ||
Zeile 51: | Zeile 56: | ||
===Verfügbare Attribute und Filter=== | ===Verfügbare Attribute und Filter=== | ||
− | Sobald der Core und benötigten sonstigen Erweiterungen installiert sind, | + | Sobald der Core und alle benötigten sonstigen Erweiterungen installiert sind, werden die weiteren Attributs- und Filterextensions des MetaModels benötigt. |
Dazu gehören: | Dazu gehören: | ||
{| style="width:100%" | {| style="width:100%" | ||
Zeile 59: | Zeile 64: | ||
| | | | ||
* [https://github.com/MetaModels/attribute_alias Attribut: Alias] | * [https://github.com/MetaModels/attribute_alias Attribut: Alias] | ||
− | * [https://github.com/MetaModels/attribute_checkbox Attribut: Checkbox] | + | * [https://github.com/MetaModels/attribute_checkbox Attribut: Checkbox (Kontrollkästchen)] |
− | * [https://github.com/MetaModels/attribute_decimal Attribut: Decimal] | + | * [https://github.com/MetaModels/attribute_combinedvalues Attribut: Combined Values (Kombinierte Einträge)] |
− | * [https://github.com/MetaModels/attribute_file Attribut: File] | + | * [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_geoprotection Attribut: Geoprotection (Länderzuordnung)] | ||
− | * [https://github.com/MetaModels/attribute_langcode Attribut: Langcode ( | + | * [https://github.com/MetaModels/attribute_langcode Attribut: Langcode (Sprachschlüssel)] |
− | * [https://github.com/MetaModels/attribute_longtext Attribut: Longtext] | + | * [https://github.com/MetaModels/attribute_longtext Attribut: Longtext (Langtext, Textarea)] |
− | * [https://github.com/MetaModels/attribute_select Attribut: Select] | + | * [https://github.com/MetaModels/attribute_select Attribut: Select (Auswahl)] |
− | * [https://github.com/MetaModels/attribute_numeric Attribut: Numeric] | + | * [https://github.com/MetaModels/attribute_numeric Attribut: Numeric (Numerisch)] |
− | * [https://github.com/MetaModels/attribute_tags Attribut: Tags] | + | * [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_text Attribut: Text] | ||
* [https://github.com/MetaModels/attribute_timestamp Attribut: Timestamp (Datum)] | * [https://github.com/MetaModels/attribute_timestamp Attribut: Timestamp (Datum)] | ||
Zeile 87: | Zeile 96: | ||
|} | |} | ||
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. | Attribut- und Filterextensions werden für den Betrieb von MetaModels benötigt. Welche dieser Erweiterungen in einem Projekt zu Einsatz kommen sollen ist abhängig von den benötigten Funktionen. | ||
+ | {{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_geoprotection '''Geoprotection'''] ist nicht mehr Teil der Nightly Builds. Es kann aber jederzeit über den oben angegeben Link separat geladen werden.}}{{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_rating '''Rating'''] benötigt die Extension [https://packagist.org/packages/leounglaub/contao-simple-ajax '''SimpleAjax'''] von leo-unglaub. Das Rating Attribut wird seit einiger Zeit nicht mehr in der Nightly ausgeliefert.}} | ||
==Download via git und Kommandozeile== | ==Download via git und Kommandozeile== | ||
Zeile 131: | Zeile 141: | ||
=Installation= | =Installation= | ||
− | Die zu installieren Dateien müssen zur Installation im Contao-System wie folgt hochgeladen werden: | + | Die zu installieren Ordner und Dateien müssen zur Installation im Contao-System wie folgt hochgeladen werden: |
{| style="width:80%" | {| style="width:80%" | ||
|- | |- | ||
Zeile 140: | Zeile 150: | ||
* justtextwidgets | * justtextwidgets | ||
* metamodels | * metamodels | ||
+ | * metamodels_boilerplate | ||
* metamodelsattribute_alias | * metamodelsattribute_alias | ||
* metamodelsattribute_checkbox | * metamodelsattribute_checkbox | ||
+ | * metamodelsattribute_combinedvalues | ||
+ | * metamodelsattribute_color | ||
+ | * metamodelsattribute_country | ||
* metamodelsattribute_decimal | * metamodelsattribute_decimal | ||
* metamodelsattribute_file | * metamodelsattribute_file | ||
Zeile 148: | Zeile 162: | ||
* metamodelsattribute_longtext | * metamodelsattribute_longtext | ||
* metamodelsattribute_numeric | * metamodelsattribute_numeric | ||
+ | * metamodelsattribute_rating | ||
* metamodelsattribute_select | * metamodelsattribute_select | ||
* metamodelsattribute_tags | * metamodelsattribute_tags | ||
Zeile 176: | Zeile 191: | ||
===Leeres MetaModel=== | ===Leeres MetaModel=== | ||
[[Datei:MetaModels_Backend_System.png|right|600px]] | [[Datei:MetaModels_Backend_System.png|right|600px]] | ||
− | Nach Aktualisierung der Datenbank erscheint '''MetaModels''' neu als eigenständige Einstellung | + | Nach Aktualisierung der Datenbank erscheint '''MetaModels''' neu als eigenständige Einstellung in der Backend-Navigation links. |
<div style="clear: both"></div> | <div style="clear: both"></div> | ||
===Erweiterungsverwaltung=== | ===Erweiterungsverwaltung=== | ||
− | [[Datei:MetaModels_Backend_System_ER.png | + | [[Datei:MetaModels_Backend_System_ER.png|right|600px]] |
− | In der Erweiterungsverwaltung findet sich hingegen | + | In der Erweiterungsverwaltung findet sich hingegen nichts, was auf MetaModels hinweist. Aber das ist gut so (Stand Mai 2013). |
<div style="clear: both"></div> | <div style="clear: both"></div> | ||
===MetaModel mit null Datensätzen=== | ===MetaModel mit null Datensätzen=== | ||
− | [[Datei:MetaModels_Backend_System_Beispiel.png | + | [[Datei:MetaModels_Backend_System_Beispiel.png|right|600px]] |
Nachdem ein erstes neues MetaModel erstellt wurde, erscheint folgende Darstellung: | Nachdem ein erstes neues MetaModel erstellt wurde, erscheint folgende Darstellung: | ||
Weiterführende Informationen zu einem einfachen Praxisbeispiel findet man unter [[MetaModels_Beispielprojekt|MetaModels Beispielprojekt]] | Weiterführende Informationen zu einem einfachen Praxisbeispiel findet man unter [[MetaModels_Beispielprojekt|MetaModels Beispielprojekt]] | ||
Zeile 194: | Zeile 209: | ||
===Dokumentation der Attribute=== | ===Dokumentation der Attribute=== | ||
[[File:icons_attribute.png|left|link=|32px]] | [[File:icons_attribute.png|left|link=|32px]] | ||
− | + | Zur [[MetaModels_Backend:_Attribute|Dokumentation der Attribute]]. | |
===Dokumentation der Ausgabevorgaben=== | ===Dokumentation der Ausgabevorgaben=== | ||
Zeile 200: | Zeile 215: | ||
Den Überblick findest du [[MetaModels_Backend:_Ausgabevorgaben|hier]]. | Den Überblick findest du [[MetaModels_Backend:_Ausgabevorgaben|hier]]. | ||
− | ===Dokumentation der Paletteneinstellungen=== | + | ===Dokumentation der Eingabemaske (fka Paletteneinstellungen)=== |
[[File:icons_paletteneinstellungen.png|left|link=|32px]] | [[File:icons_paletteneinstellungen.png|left|link=|32px]] | ||
− | Den Überblick findest du [[MetaModels_Backend: | + | Den Überblick findest du [[MetaModels_Backend:_Eingabemaske|hier]]. |
===Dokumentation der Filter=== | ===Dokumentation der Filter=== | ||
[[File:icons_filter.png|left|link=|32px]] | [[File:icons_filter.png|left|link=|32px]] | ||
− | + | Zum [[MetaModels_Backend:_Filter|Überblick über die Filter]]. | |
===Dokumentation der Ansichtseinstellungen=== | ===Dokumentation der Ansichtseinstellungen=== | ||
[[File:icons_ansichtseinstellungen.png|left|link=|32px]] | [[File:icons_ansichtseinstellungen.png|left|link=|32px]] | ||
− | + | Zum [[MetaModels_Backend:_Ansichtseinstellungen|Überblick der Ansichtseinstellungen]]. | |
− | = | + | =Basics= |
− | Einführende Beispiele, wie man MetaModels einrichten und konfigurieren | + | 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_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_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_3| Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter | ||
# [[MetaModels_Beispiel_4| Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen | # [[MetaModels_Beispiel_4| Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen | ||
+ | # [[MetaModels Insert-Tags| Insert-Tags]] - Insert-Tags in MetaModels | ||
+ | |||
+ | =Tipps und Tricks= | ||
+ | Umsetzung-Beispiele, wie man MetaModels ausbauen kann, findet man hier: | ||
+ | # [[MetaModels_Beispiel:_Übersetzter_select| Übersetzer select]] - "Übersetzter select"-Attribut eingerichtet werden. | ||
+ | # [[MetaModels_Beispiel:_Referenced_items| Referenced items]] - MetaModels miteinder verknüpfen | ||
+ | # [[MetaModels_Beispiel:_FE-Template_anpassen| FE-Template anpassen]] - FE-Template anpassen | ||
=Frontendausgabe= | =Frontendausgabe= |
Aktuelle Version vom 26. Januar 2017, 13:13 Uhr
Hinweis: Die Angaben, Beschreibungen und Screenshot beziehen sich auf MetaModels bis etwa Mitte 2016 und sind nicht aktuell!
Im MetaModels-Handbuch sind aktuelle Angaben zu finden. |
Erweiterungs-Übersicht | |
---|---|
Name des Entwicklers | Metamodels Team |
Kompatibilität mit Contao Version | ab 2.11.X |
Link zum Tracker | https://github.com/MetaModels/core/issues |
Link zum VCS | https://github.com/MetaModels/core |
Abhängig von ff. Erweiterungen | DC_General Justtextwidgets MultiColumnWizard MetaPalettes |
Inhaltsverzeichnis
Vorwort: Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)
Die Erweiterung MetaModels ist der Nachfolger der Catalog-Extension. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zum Catalog besteht nicht.
Vorgehensschritte
- Start: Installation - Download und Installation von MetaModels
- Beispiel 1: Backend einrichten - MetaModel erstellen, Daten erfassen
- Beispiel 2: Frontend einrichten - Die Inhalte im Frontend anzeigen (Liste und Detail)
- Beispiel 3: Weitere Filter einrichten – Inhalte auf Published setzen, einfache Select-Filter
- Beispiel 4: Weiteres MetaModels einrichten - komplexe Select-Filter einsetzen
Download & Installation
Download von der Demosite
Unter der URL 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.
Installation via Composer
MetaModels kann vollständig über Composer installiert werden. Alle Attribute liegen auf Packagist und werden vom offiziellen MetaModels Team betreut. Für die Installation von MetaModels über Composer muss man lediglich nach "metamodels" suchen, alle verfügbaren Pakete werden danach aufgelistet.
Download aus dem Entwicklungsrepository GitHub
Zu finden ist die Erweiterung MetaModels auf GitHub:
github.com/Metamodels
Aktuell können das Core, dazu abhängige weitere Erweiterungen und alle weiteren MetaModels Attribute/Filter manuell installiert werden.
Core
Abhängigkeiten
Benötigt werden folgende Erweiterungen:
- DC_General
- MetaPalettes
- MultiColumnWizard
- justtextwidgets
- geoprotection (wird nur für das Attribut Geoprotection benötigt)
Verfügbare Attribute und Filter
Sobald der Core und alle benötigten sonstigen Erweiterungen installiert sind, werden die weiteren Attributs- und Filterextensions des MetaModels benötigt. Dazu gehören:
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. Es kann aber jederzeit über den oben angegeben Link separat geladen werden. |
Hinweis: Das Attribut Rating benötigt die Extension SimpleAjax von leo-unglaub. Das Rating Attribut wird seit einiger Zeit nicht mehr in der Nightly ausgeliefert. |
Download via git und Kommandozeile
In einer bash (Linux Kommandozeile bzw. cygwin Kommandozeile) kann man sich auch alle Unterprojekte der MetaModels via git clonen. Man sollte jedoch vorher in den Ordner wechseln, wohin die Projekte heruntergeladen werden sollen.
Linux | MacOS |
---|---|
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen. cd ~ mkdir MetaModels cd MetaModels |
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen. cd ~ mkdir MetaModels cd MetaModels |
Alle MetaModel Repos holen for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \ grep clone_url | \ cut -d \" -f4`; do \ git clone $i; \ done; |
Alle MetaModel Repos holen for i in `curl https://api.github.com/orgs/MetaModels/repos | \ grep clone_url | \ cut -d \" -f4`; do \ git clone $i; \ done; |
Installation
Die zu installieren Ordner und Dateien müssen zur Installation im Contao-System wie folgt hochgeladen werden:
Module (/system/modules) | Drivers (/system/drivers) |
---|---|
|
|
Danach muss mittels des Installtools ein Update der Datenbank gemacht werden.
Backend Ansichten
Leeres MetaModel
Nach Aktualisierung der Datenbank erscheint MetaModels neu als eigenständige Einstellung in der Backend-Navigation links.
Erweiterungsverwaltung
In der Erweiterungsverwaltung findet sich hingegen nichts, was auf MetaModels hinweist. Aber das ist gut so (Stand Mai 2013).
MetaModel mit null Datensätzen
Nachdem ein erstes neues MetaModel erstellt wurde, erscheint folgende Darstellung: Weiterführende Informationen zu einem einfachen Praxisbeispiel findet man unter MetaModels Beispielprojekt
Konfiguration
Dokumentation der Attribute
Zur Dokumentation der Attribute.
Dokumentation der Ausgabevorgaben
Den Überblick findest du hier.
Dokumentation der Eingabemaske (fka Paletteneinstellungen)
Den Überblick findest du hier.
Dokumentation der Filter
Zum Überblick über die Filter.
Dokumentation der Ansichtseinstellungen
Zum Überblick der Ansichtseinstellungen.
Basics
Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kann, findet man hier:
- Backend einrichten - am Beispiel einer Musiksammlung, Eingeben der Sammlung
- Frontend einrichten - Die Inhalte im Frontend anzeigen (Liste und Detail)
- Weitere Filter einrichten – Inhalte auf Published setzen, einfache Select-Filter
- Weiteres MetaModels einrichten - komplexe Select-Filter einsetzen
- Insert-Tags - Insert-Tags in MetaModels
Tipps und Tricks
Umsetzung-Beispiele, wie man MetaModels ausbauen kann, findet man hier:
- Übersetzer select - "Übersetzter select"-Attribut eingerichtet werden.
- Referenced items - MetaModels miteinder verknüpfen
- FE-Template anpassen - FE-Template anpassen
Frontendausgabe
started by: Planepix 00:49, 28. Nov. 2012 (CET)
completed by Luis, Lucina