MetaModels: Unterschied zwischen den Versionen

Aus Contao Community Documentation
K (Hinweis Handbuch)
 
(143 dazwischenliegende Versionen von 9 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!
−
'''Start der Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)
+
Im [http://metamodels.readthedocs.io/de/latest/ MetaModels-Handbuch] sind aktuelle Angaben zu finden.}}
−
'''
+
 
−
{{Hinweis|Installation von MetaModels aus GitHub}}
+
[[Category:Extensions]]
 +
[[Category:MetaModels|B]]
 +
{{ExtInfo
 +
| Dev=Metamodels Team
 +
| DevSite=
 +
| Version=ab 2.11.X
 +
| ERLink=
 +
| VCSLink=https://github.com/MetaModels/core
 +
| TrackerLink=https://github.com/MetaModels/core/issues
 +
| Depending=[[DC_General]] [[Justtextwidgets]] [[MultiColumnWizard]] [[MetaPalettes]]
 +
}}
 +
 
 +
=Vorwort: Wiki-Dokumentation der Erweiterung MetaModels (Nachfolger des Catalog)=
 +
Die Erweiterung MetaModels ist der Nachfolger der Catalog-Extension. Der Code wurde komplett neu entwickelt. Eine Kompatibilität zum Catalog besteht nicht.
 +
 
 +
===Vorgehensschritte===
 +
# [[MetaModels|Start: Installation]] - Download und Installation von MetaModels
 +
# [[MetaModels_Beispiel_1|Beispiel 1: Backend einrichten]] - MetaModel erstellen, Daten erfassen
 +
# [[MetaModels_Beispiel_2|Beispiel 2: Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
 +
# [[MetaModels_Beispiel_3|Beispiel 3: Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
 +
# [[MetaModels_Beispiel_4|Beispiel 4: Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
 +
 
 +
=Download & Installation=
 +
 
 +
==Download von der Demosite==
 +
[[Datei:logo-metamodels.png|link=|left|105px]]
 +
Unter der URL [http://now.metamodel.me now.metamodel.me] findet sich die Webseite zur Extension mit einer Frontentdemo und der Möglichkeit, Installationsarchive in den Formaten '''tgz''', '''tbz''' und '''zip''' mit so genannten Nightly Builds zu laden. Diese Archive beinhalten die MetaModels-Dateien, Attribute, Filter sowie sämtliche anderen Erweiterungen, die für den Betrieb nötig sind und ansonsten separat heruntergeladen und installiert werden müssen.
 +
<div style="clear: both"><br><br></div>
 +
 
 +
==Installation via Composer==
 +
 
 +
MetaModels kann vollständig über [http://de.contaowiki.org/Composer Composer] installiert werden. Alle Attribute liegen auf [https://packagist.org/ Packagist] und werden vom offiziellen MetaModels Team betreut. Für die Installation von MetaModels über Composer muss man lediglich nach "metamodels" suchen, alle verfügbaren Pakete werden danach aufgelistet.
 +
 
 +
==Download aus dem Entwicklungsrepository GitHub==
 +
 
 +
[[Datei:logo-github.png|link=|left|105px]]
 +
Zu finden ist die Erweiterung MetaModels auf GitHub:
 +
[https://github.com/MetaModels github.com/Metamodels]<br>
 +
Aktuell können das Core, dazu abhängige weitere Erweiterungen und alle weiteren MetaModels Attribute/Filter manuell installiert werden.
 +
<div style="clear: both"><br></div>
 +
 
 +
===Core===
 +
* [https://github.com/MetaModels/core MetaModels (Das Core-Modul)]
 +
* [https://github.com/MetaModels/boilerplate Boilerplate (Erzeugt einen separaten Bereich in der Backend-Navigation)]
 +
 
 +
===Abhängigkeiten===
 +
Benötigt werden folgende Erweiterungen:
 +
* [https://github.com/MetaModels DC_General]
 +
* [https://contao.org/de/extension-list/view/MetaPalettes.html MetaPalettes]
 +
* [http://www.contao.org/erweiterungsliste/view/MultiColumnWizard.html MultiColumnWizard]
 +
* [https://github.com/Discordier/justtextwidgets justtextwidgets]
 +
* [https://contao.org/de/extension-list/view/geoprotection.de.html geoprotection] (wird nur für das Attribut '''Geoprotection''' benötigt)
 +
 
 +
===Verfügbare Attribute und Filter===
 +
Sobald der Core und alle benötigten sonstigen Erweiterungen installiert sind, werden die weiteren Attributs- und Filterextensions des MetaModels benötigt.
 +
Dazu gehören:
 +
{| style="width:100%"
 +
|-
 +
! '''Attribute''' !! '''Attribute (translated)''' !! '''Filter'''
 +
|-
 +
|
 +
* [https://github.com/MetaModels/attribute_alias Attribut: Alias]
 +
* [https://github.com/MetaModels/attribute_checkbox Attribut: Checkbox (Kontrollkästchen)]
 +
* [https://github.com/MetaModels/attribute_combinedvalues Attribut: Combined Values (Kombinierte Einträge)]
 +
* [https://github.com/MetaModels/attribute_color Attribut: Color (Farbe)]
 +
* [https://github.com/MetaModels/attribute_country Attribut: Country (Land)]
 +
* [https://github.com/MetaModels/attribute_decimal Attribut: Decimal (Dezimal)]
 +
* [https://github.com/MetaModels/attribute_file Attribut: File (Datei)]
 +
* [https://github.com/MetaModels/attribute_geoprotection Attribut: Geoprotection (Länderzuordnung)]
 +
* [https://github.com/MetaModels/attribute_langcode Attribut: Langcode (Sprachschlüssel)]
 +
* [https://github.com/MetaModels/attribute_longtext Attribut: Longtext (Langtext, Textarea)]
 +
* [https://github.com/MetaModels/attribute_select Attribut: Select (Auswahl)]
 +
* [https://github.com/MetaModels/attribute_numeric Attribut: Numeric (Numerisch)]
 +
* [https://github.com/MetaModels/attribute_rating Attribut: Rating (Bewertung)]
 +
* [https://github.com/MetaModels/attribute_tags Attribut: Tags  (Mehrfachauswahl)]
 +
* [https://github.com/MetaModels/attribute_text Attribut: Text]
 +
* [https://github.com/MetaModels/attribute_timestamp Attribut: Timestamp (Datum)]
 +
* [https://github.com/MetaModels/attribute_url Attribut: URL]
 +
|
 +
* [https://github.com/MetaModels/attribute_translatedalias Attribut: Translated Alias]
 +
* [https://github.com/MetaModels/attribute_translatedfile Attribut: Translated File]
 +
* [https://github.com/MetaModels/attribute_translatedlongtext Attribut: Translated Longtext]
 +
* [https://github.com/MetaModels/attribute_translatedselect Attribut: Translated Select]
 +
* [https://github.com/MetaModels/attribute_translatedtags Attribut: Translated Tags]
 +
* [https://github.com/MetaModels/attribute_translatedtext Attribut: Translated Text]
 +
|
 +
* [https://github.com/MetaModels/filter_checkbox Filter: Checkbox]
 +
* [https://github.com/MetaModels/filter_fromto Filter: FromTo]
 +
* [https://github.com/MetaModels/filter_range Filter: Range]
 +
* [https://github.com/MetaModels/filter_select Filter: Select]
 +
* [https://github.com/MetaModels/filter_tags Filter: Tags]
 +
* [https://github.com/MetaModels/filter_text Filter: Text]
 +
|}
 +
Attribut- und Filterextensions werden für den Betrieb von MetaModels benötigt. Welche dieser Erweiterungen in einem Projekt zu Einsatz kommen sollen ist abhängig von den benötigten Funktionen.
 +
{{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_geoprotection '''Geoprotection'''] ist nicht mehr Teil der Nightly Builds. Es kann aber jederzeit über den oben angegeben Link separat geladen werden.}}{{Hinweis|Das Attribut [https://packagist.org/packages/metamodels/attribute_rating '''Rating'''] benötigt die Extension [https://packagist.org/packages/leounglaub/contao-simple-ajax '''SimpleAjax'''] von leo-unglaub. Das Rating Attribut wird seit einiger Zeit nicht mehr in der Nightly ausgeliefert.}}
 +
 
 +
==Download via git und Kommandozeile==
 +
In einer bash (Linux Kommandozeile bzw. cygwin Kommandozeile) kann man sich auch alle Unterprojekte der MetaModels via git clonen. Man sollte jedoch vorher in den Ordner wechseln, wohin die Projekte heruntergeladen werden sollen.
 +
 
 +
{| style="width:100%"
 +
|-
 +
! '''Linux'''  !! '''MacOS'''
 +
|-
 +
|
 +
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen.
 +
<source lang="bash">
 +
cd ~
 +
mkdir MetaModels
 +
cd MetaModels
 +
</source>
 +
|
 +
In Benutzerverzeichnis wechseln und für den Pull ein Verzeichniss anlegen.
 +
<source lang="bash">
 +
cd ~
 +
mkdir MetaModels
 +
cd MetaModels
 +
</source>
 +
|-
 +
|
 +
Alle MetaModel Repos holen
 +
<source lang="bash">
 +
for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \
 +
grep clone_url | \
 +
cut -d \" -f4`; do \
 +
git clone $i; \
 +
done;
 +
</source>
 +
|
 +
Alle MetaModel Repos holen
 +
<source lang="bash">
 +
for i in `curl https://api.github.com/orgs/MetaModels/repos | \
 +
grep clone_url | \
 +
cut -d \" -f4`; do \
 +
git clone $i; \
 +
done;
 +
</source>
 +
|}
 +
 
 +
=Installation=
 +
Die zu installieren Ordner und Dateien müssen zur Installation im Contao-System wie folgt hochgeladen werden:
 +
{| style="width:80%"
 +
|-
 +
! '''Module''' (/system/modules) !! '''Drivers''' (/system/drivers)
 +
|-
 +
|
 +
* generalDriver
 +
* justtextwidgets
 +
* metamodels
 +
* metamodels_boilerplate
 +
* metamodelsattribute_alias
 +
* metamodelsattribute_checkbox
 +
* metamodelsattribute_combinedvalues
 +
* metamodelsattribute_color
 +
* metamodelsattribute_country
 +
* metamodelsattribute_decimal
 +
* metamodelsattribute_file
 +
* metamodelsattribute_geoprotection
 +
* metamodelsattribute_langcode
 +
* metamodelsattribute_longtext
 +
* metamodelsattribute_numeric
 +
* metamodelsattribute_rating
 +
* metamodelsattribute_select
 +
* metamodelsattribute_tags
 +
* metamodelsattribute_text
 +
* metamodelsattribute_timestamp
 +
* metamodelsattribute_translatedalias
 +
* metamodelsattribute_translatedfile
 +
* metamodelsattribute_translatedlongtext
 +
* metamodelsattribute_translatedselect
 +
* metamodelsattribute_translatedtags
 +
* metamodelsattribute_translatedtext
 +
* metamodelsattribute_url
 +
* metamodelsfilter_checkbox
 +
* metamodelsfilter_fromto
 +
* metamodelsfilter_range
 +
* metamodelsfilter_select
 +
* metamodelsfilter_tags
 +
* metamodelsfilter_text
 +
* metapalettes
 +
* multicolumnwizard
 +
|
 +
* DC_General.php
 +
|}
 +
Danach muss mittels des Installtools ein Update der Datenbank gemacht werden.
 +
 
 +
=Backend Ansichten=
 +
 
 +
===Leeres MetaModel===
 +
[[Datei:MetaModels_Backend_System.png|right|600px]]
 +
Nach Aktualisierung der Datenbank erscheint '''MetaModels''' neu als eigenständige Einstellung in der Backend-Navigation links.
 +
<div style="clear: both"></div>
 +
 
 +
===Erweiterungsverwaltung===
 +
[[Datei:MetaModels_Backend_System_ER.png|right|600px]]
 +
In der Erweiterungsverwaltung findet sich hingegen nichts, was auf MetaModels hinweist. Aber das ist gut so (Stand Mai 2013).
 +
<div style="clear: both"></div>
 +
 
 +
===MetaModel mit null Datensätzen===
 +
[[Datei:MetaModels_Backend_System_Beispiel.png|right|600px]]
 +
Nachdem ein erstes neues MetaModel erstellt wurde, erscheint folgende Darstellung:
 +
Weiterführende Informationen zu einem einfachen Praxisbeispiel findet man unter [[MetaModels_Beispielprojekt|MetaModels Beispielprojekt]]
 +
<div style="clear: both"></div>
 +
 
 +
=Konfiguration=
 +
 
 +
===Dokumentation der Attribute===
 +
[[File:icons_attribute.png|left|link=|32px]]
 +
Zur  [[MetaModels_Backend:_Attribute|Dokumentation der Attribute]].
 +
 
 +
===Dokumentation der Ausgabevorgaben===
 +
[[File:icons_ausgabevorgaben.png|left|link=|32px]]
 +
Den Überblick findest du [[MetaModels_Backend:_Ausgabevorgaben|hier]].
 +
 
 +
===Dokumentation der Eingabemaske (fka Paletteneinstellungen)===
 +
[[File:icons_paletteneinstellungen.png|left|link=|32px]]
 +
Den Überblick findest du [[MetaModels_Backend:_Eingabemaske|hier]].
 +
 
 +
===Dokumentation der Filter===
 +
[[File:icons_filter.png|left|link=|32px]]
 +
Zum [[MetaModels_Backend:_Filter|Überblick über die Filter]].
 +
 
 +
===Dokumentation der Ansichtseinstellungen===
 +
[[File:icons_ansichtseinstellungen.png|left|link=|32px]]
 +
Zum [[MetaModels_Backend:_Ansichtseinstellungen|Überblick der Ansichtseinstellungen]].
 +
 
 +
=Basics=
 +
Einführende Beispiele, wie man MetaModels einrichten und konfigurieren kann, findet man hier:
 +
# [[MetaModels_Beispiel_1| Backend einrichten]] - am Beispiel einer Musiksammlung, Eingeben der Sammlung
 +
# [[MetaModels_Beispiel_2| Frontend einrichten]] - Die Inhalte im Frontend anzeigen (Liste und Detail)
 +
# [[MetaModels_Beispiel_3| Weitere Filter einrichten]] – Inhalte auf Published setzen, einfache Select-Filter
 +
# [[MetaModels_Beispiel_4| Weiteres MetaModels einrichten]] - komplexe Select-Filter einsetzen
 +
# [[MetaModels Insert-Tags| Insert-Tags]] - Insert-Tags in MetaModels
 +
 
 +
=Tipps und Tricks=
 +
Umsetzung-Beispiele, wie man MetaModels ausbauen kann, findet man hier:
 +
# [[MetaModels_Beispiel:_Übersetzter_select| Übersetzer select]] - "Übersetzter select"-Attribut eingerichtet werden.
 +
# [[MetaModels_Beispiel:_Referenced_items| Referenced items]] - MetaModels miteinder verknüpfen
 +
# [[MetaModels_Beispiel:_FE-Template_anpassen| FE-Template anpassen]] - FE-Template anpassen
 +
 
 +
=Frontendausgabe=
 +
{{Hinweis|Die Dokumentation sollte in eine andere Seite ausgelagert werden}}
 +
----
 +
started by: [[Benutzer:Planepix|Planepix]] 00:49, 28. Nov. 2012 (CET)<br>
 +
completed by [[Benutzer:Luis|Luis]], [[Benutzer:lucina|Lucina]]

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

Irgendwie wird es im Mumble immer ruhiger wenn sich der Kim-Faktor verkleinert.

Sascha Müller
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge