MetaModels: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(→‎Erweiterungsverwaltung)
K (Hinweis Handbuch)
 
(33 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
{{stub}}
+
{{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 13: Zeile 15:
  
 
=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.<br/>
+
Die Erweiterung MetaModels ist der Nachfolger der Catalog-Extension. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zum Catalog besteht nicht.
−
<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===
 
===Vorgehensschritte===
 
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
 
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
−
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - Eingeben der Sammlung
+
# [[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
−
# [[MetaModels_Beispiel:_Übersetzter_select|Weiteres Beispiel: Übersetzter select]] - Mehrsprachiges Select-Attribut einrichten
 
  
−
=Download=
+
=Download & Installation=
  
 
==Download von der Demosite==
 
==Download von der Demosite==
Zeile 31: 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 42: 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 52: Zeile 56:
  
 
===Verfügbare Attribute und Filter===
 
===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.
+
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 60: 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_combinedvalues Attribut: Combined Values]
+
* [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_country Attribut: Country (Land)]
−
* [https://github.com/MetaModels/attribute_decimal Attribut: Decimal]
+
* [https://github.com/MetaModels/attribute_decimal Attribut: Decimal (Dezimal)]
−
* [https://github.com/MetaModels/attribute_file Attribut: File]
+
* [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 (Sprachencode)]
+
* [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_rating Attribut: Rating]
+
* [https://github.com/MetaModels/attribute_rating Attribut: Rating (Bewertung)]
−
* [https://github.com/MetaModels/attribute_tags Attribut: Tags]
+
* [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 91: 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 144: Zeile 150:
 
* justtextwidgets
 
* justtextwidgets
 
* metamodels
 
* metamodels
 +
* metamodels_boilerplate
 
* metamodelsattribute_alias
 
* metamodelsattribute_alias
 
* metamodelsattribute_checkbox
 
* metamodelsattribute_checkbox
 
* metamodelsattribute_combinedvalues
 
* metamodelsattribute_combinedvalues
 +
* metamodelsattribute_color
 
* metamodelsattribute_country
 
* metamodelsattribute_country
 
* metamodelsattribute_decimal
 
* metamodelsattribute_decimal
Zeile 192: Zeile 200:
  
 
===MetaModel mit null Datensätzen===
 
===MetaModel mit null Datensätzen===
−
[[Datei:MetaModels_Backend_System_Beispiel.png|link=|right|600px]]
+
[[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 201: Zeile 209:
 
===Dokumentation der Attribute===
 
===Dokumentation der Attribute===
 
[[File:icons_attribute.png|left|link=|32px]]
 
[[File:icons_attribute.png|left|link=|32px]]
−
Den Überblick findest du [[MetaModels_Backend:_Attribute|hier]].
+
Zur  [[MetaModels_Backend:_Attribute|Dokumentation der Attribute]].
  
 
===Dokumentation der Ausgabevorgaben===
 
===Dokumentation der Ausgabevorgaben===
Zeile 207: 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:_Paletteneinstellungen|hier]].
+
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]]
−
Den Überblick findest du [[MetaModels_Backend:_Filter|hier]].
+
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]]
−
Den Überblick findest du [[MetaModels_Backend:_Ansichtseinstellungen|hier]].
+
Zum [[MetaModels_Backend:_Ansichtseinstellungen|Überblick der Ansichtseinstellungen]].
  
−
=Beispiele=
+
=Basics=
−
Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kannst, findest du hier:
+
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.png 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


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

  1. Start: Installation - Download und Installation von MetaModels
  2. Beispiel 1: Backend einrichten - MetaModel erstellen, Daten erfassen
  3. Beispiel 2: Frontend einrichten - Die Inhalte im Frontend anzeigen (Liste und Detail)
  4. Beispiel 3: Weitere Filter einrichten – Inhalte auf Published setzen, einfache Select-Filter
  5. Beispiel 4: Weiteres MetaModels einrichten - komplexe Select-Filter einsetzen

Download & Installation

Download von der Demosite

Logo-metamodels.png

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

Logo-github.png

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:

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:

Attribute Attribute (translated) Filter

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.png Hinweis: Das Attribut Geoprotection ist nicht mehr Teil der Nightly Builds. Es kann aber jederzeit über den oben angegeben Link separat geladen werden.
Hinweis.png 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)
  • 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

MetaModels Backend System.png

Nach Aktualisierung der Datenbank erscheint MetaModels neu als eigenständige Einstellung in der Backend-Navigation links.

Erweiterungsverwaltung

MetaModels Backend System ER.png

In der Erweiterungsverwaltung findet sich hingegen nichts, was auf MetaModels hinweist. Aber das ist gut so (Stand Mai 2013).

MetaModel mit null Datensätzen

MetaModels Backend System Beispiel.png

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

Icons attribute.png

Zur Dokumentation der Attribute.

Dokumentation der Ausgabevorgaben

Icons ausgabevorgaben.png

Den Überblick findest du hier.

Dokumentation der Eingabemaske (fka Paletteneinstellungen)

Icons paletteneinstellungen.png

Den Überblick findest du hier.

Dokumentation der Filter

Icons filter.png

Zum Überblick über die Filter.

Dokumentation der Ansichtseinstellungen

Icons ansichtseinstellungen.png

Zum Überblick der Ansichtseinstellungen.

Basics

Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kann, findet man hier:

  1. Backend einrichten - am Beispiel einer Musiksammlung, Eingeben der Sammlung
  2. Frontend einrichten - Die Inhalte im Frontend anzeigen (Liste und Detail)
  3. Weitere Filter einrichten – Inhalte auf Published setzen, einfache Select-Filter
  4. Weiteres MetaModels einrichten - komplexe Select-Filter einsetzen
  5. Insert-Tags - Insert-Tags in MetaModels

Tipps und Tricks

Umsetzung-Beispiele, wie man MetaModels ausbauen kann, findet man hier:

  1. Übersetzer select - "Übersetzter select"-Attribut eingerichtet werden.
  2. Referenced items - MetaModels miteinder verknüpfen
  3. FE-Template anpassen - FE-Template anpassen

Frontendausgabe

Hinweis.png Hinweis: Die Dokumentation sollte in eine andere Seite ausgelagert werden

started by: Planepix 00:49, 28. Nov. 2012 (CET)
completed by Luis, Lucina

Von „https://de.contaowiki.org/index.php?title=MetaModels&oldid=8678“
Ansichten
Meine Werkzeuge

Contao Community Documentation

Dann sollte da auch 3.1.5 stehen. Wenn nicht mach mal Systemwartung, dreh dich im Kreis, ruf: "uga uga uga" und opfer ein kleines huhn... aber nur ein KLEINES, ist ja kein major.

Marc Reimann
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge