MetaModels Beispiel: FE-Template anpassen

2014-12-02T08:55:24Z

Zonky: /* 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? */

[[Category:Extensions]]
[[Category:MetaModels|T]]
MetaModels (MM) bringt für die Ausgabe einer Liste ein Standard-Template mit. Mit diesem Template lassen sich alle Attribute ausgeben und prüfen. Für viele Anwendungen wird man das Template aber anpassen müssen z.B. um die HTML-Struktur umzubauen, Attribute doppelt auszugeben, bestimmte Formatierungen vorzunehmen, Daten aus weiteren MetaModels zu beziehen u.v.a.m.

Im Folgenden sollen eine Tipps den Einstieg in die Bearbeitung des Templates erleichtern.

'''Voraussetzung:''' das oder die MetaModels sind angelegt, mit einigen (Test-) Daten gefüllt und über das Content-Element "MetaModel-Liste" werden die Daten (Attribute) im Frontend (FE) ausgegeben.

== 1. Wo finde ich das Template? ==

In dem Content-Element "MetaModel-Liste" kann ein FE unter " MetaModel-Rendering" ausgewählt werden (ce_metamodel_list). An der Stelle hat man Zugriff auf die Überschrift und Paginierung der Liste - um die Ausgabe der Items zu beeinflussen, muss man einen Schritt "vorher einsteigen".

In den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste kann in den "Grundeinstellungen" ein eigenes Template ausgewählt werden (metamodel_prerendered). Um ein eigens Template anzulegen, wechseln wir zu Layout > Template und legen eine Kopie von "metamodel_prerendered" an. Der Dateiname kann individuell angepasst werden - starten muss der Dateiname mit "metamodel_". Zum Beispiel kann die Datei als "metamodel_pr_spezialliste" bezeichnet werden.

Anschließend muss das erstellte Template wieder in den MetaModels-Einstellungen > Rendereinstellungen des MM > Eigenschaften (Stift) der FE-Liste > Grundeinstellungen ausgewählt werden.

Damit ist die Vorbereitung in diesem Punkt abgeschlossen und das Template kann an die individuellen Wünsche angepasst werden.

Hinweis zur Länge des Dateinamens: der Dateiname kann über das BE nur eine bestimmte Länge haben - bis Contao 3.3.x sind das 32 Zeichen und ab 3.4.x 64 Zeichen.

== 2. Wie sehe ich, was alles an Attributen (Werten) zur Verfügung steht? ==

Für das "Debugging" der Listenausgabe gibt es verschiedene Möglichkeiten - eine einfache Methode ist eine "Echo-Ausgabe" in den HTML-Quelltext. Dazu gehen wir zu den Templates und öffnen das neu angelegte Template "metamodel_pr_spezialliste".

In den Quelltext fügen wir ein "print_r" ein (Zeile 6 bis 10):

<source lang="php">
<?php $strRendersettings = isset($this->settings)? 'settings' : 'view'; ?>
<?php if (count($this->data)): ?>

<div class="layout_full">

<?php
echo "";
?>

<?php foreach ($this->data as $arrItem): ?>
<div class="item <?php echo $arrItem['class']; ?>">

<?php foreach ($arrItem['attributes'] as $field => $strName): ?>
...
</source>

Anschließend kann die Seite in der FE-Ausgabe neu geladen und im HTML-Quelltext (Shortcut FF und IE: Strg-u) das ausgegebene Array analysiert werden.

In dem Array gibt es (z.Z.) drei verschiedene Knoten, die sich anhand der Ausgabevarianten ergeben. Das sind [raw], [text] und [html5] - in [raw] werden alle vorhanden Attribute ausgegeben und in [text] und [html5] nur die vorhanden Attribute, die auf "Sichtbar" (Auge grün) gestellt sind.

Für Fragen im [https://community.contao.org/de/forumdisplay.php?149-MetaModels Forum] kann die Ausgabe - oder Teile davon - gepostet werden (unbedingt als "Quelltext" formatieren) oder man stellt einen Link zur Testseite zur Verfügung mit dem Hinweis, auf die Quelltext-Ausgabe.

Easyupdate

2014-09-22T12:50:52Z

Schnaub:

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.2.14
}}

{{ExtInfo
| Dev=Lutz Schoening und Glen Larger
| ExtVersion=3.0.1 stable
| Version=3.0.6 - 3.3.1
| ERLink=https://contao.org/de/extension-list/view/easyupdate3.de.html
}}
[[Kategorie:Installation_und_Updates]]
[[Kategorie:Extensions]]

== Was ist easyUpdate3? ==
easyUpdate3 ist eine Erweiterung um Contao3 mit speziellen ZIP-Dateien aus dem Backend heraus zu aktualisieren

== Funktionsweise und Erläuterungen ==

=== easyUpdate3 installieren ===

Nach der normalen Installation unter Contao erscheint im Backend ein neuer Menüeintrag, links unter System.

[[Datei:Easyupdate_install_0040.png|Installation von easyUpdate, Schritt 1]]

=== Sicherheitshinweise ===

Folgend der Sicherheitshinweis des Autors von "easyUpdate3".
{{Achtung|Hinweistext nach der easyUpdate3 Installation:
Es gibt keine 100%-ige Sicherheit, dass alles einwandfrei funktioniert. Seien Sie sich also bewusst, was Sie tun!
Machen Sie bei der ersten Verwendung dieses Tools ruhig eine zusätzliche Sicherung der Datenbank.
Das Tool greift auf das Dateisystem zu, das kann zu DATENVERLUST führen!
Alles was Sie machen, tun Sie auf eigene Gefahr.}}
Das ist ist sehr guter und richtiger Hinweis, sollte jedoch, beim Einhalten dieser Vorgehensweise, den Anwender nicht Abschrecken "easyUpdate3" zu verwenden

=== Kompatibilität ===

*Getestete und funktionierende Vorgänge:
Getestet wurde eine Installation bis zur Contao Version 3.0.1. ( in der hier dargestellten Fassung auch bis 3.2.14 )

3.0.6 ====> 3.3.1

*Getestete und fehlerhafte Vorgänge:

2.x.x ====> 2.x.x ( Nicht mit Contao 2.x möglich! )

=== Update vorbereiten - ZIP Dateien Downloaden und Ablegen ===

*Download der richtigen ZIP-Dateien

Die entsprechenden ZIP-Dateien finden sich unter folgendem Link:
[http://www.contao.glen-langer.de/ Webseiten von Glen Larger]

Nach dem Download der ZIP-Dateien werden diese über die Dateiverwaltung im Verzeichnis "easyupdate3" abgelegt.

[[Datei:Easyupdate setfolder.png|Backend-Ablage im Verzeichnis]]

=== Update durchführen ===

*Auswahl der Zip-Datei

Durch Klick auf den Menüpunkt "Easyupdate" wird folgendes Dialogfeld angezeigt.

[[Datei:Easyupdate select file.png|Auswahl der ZIP-Datei]]

{{Hinweis| Wenn eine Versionsnummer X.X.X erscheint, dann ist wahrscheinlich die ZIP-Datei beschädigt}}

Nach Auswahl der ZIP-Datei wird mitgeteilt welche Dateien nicht im folgenden Update aktualisiert werden

[[Datei:Easyupdate selectfiles noupdate.png|Anzeige der Dateien die nicht aktualisiert werden]]

Im weiteren Verlauf werden diverse Dialoggrafiken dargestellt, diese werden jeweils mit der Schaltfläche "Nächsten Schritt ausführen" bestätigt.

[[Datei:Easyupdate changelog view.png|Anzeige des Changelog zwischen den Versionen]]

[[Datei:Easyupdate data contant view.png|Anzeige der Inhalte der Archivdatei]]

[[Datei:Easyupdate save data.png|Anzeige der Dateien die gesichert werden]]

=== Update überprüfen - Install-Tool ===

== Autor der Erweiterung eaysupdate3 ==

Glen Larger [[Benutzer:BugBuster|BugBuster]]

== Weiterführende Links ==

[https://contao.org/de/extension-list/view/easyupdate3.de.html easyUpdate3 in der Erweiterungsliste]

[http://www.contao.glen-langer.de Webseite von BugBuster]

[https://community.contao.org/de/showthread.php?1607-easyUpdate-Updates-noch-einfacher&highlight=easyupdate easyUpdate im Contao-Forum]

Contao Community Documentation - Neue Seiten [de]

MetaModels Beispiel: FE-Template anpassen

Easyupdate