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

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

• MetaModels (Das Core-Modul)
• Boilerplate (Erzeugt einen separaten Bereich in der Backend-Navigation)

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 benötigten sonstigen Erweiterungen installiert sind, werde 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.

cd ~
mkdir MetaModels
cd MetaModels

cd ~
mkdir MetaModels
cd MetaModels

for i in `wget -qO- https://api.github.com/orgs/MetaModels/repos | \
grep clone_url | \
cut -d \" -f4`; do \
git clone $i; \
done;

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:

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:

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

Frontendausgabe

Hinweis: Die Dokumentation sollte in eine andere Seite ausgelagert werden

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