MM-Handbuch (DE)

**zonky** · 22.10.2015, 21:45

Hallo,

seit September 2015 wird an einem neuen Handbuch gewerkelt und die erste Version ist freigegeben - Link: http://metamodels.readthedocs.org/de/latest/index.html

Die Dokumentation wird weiter wachsen und mit der aktuellen Version von MetaModels abgeglichen. Wer automatisch eine Info über Updates bekommen möchte, kann diesen Thread abonnieren - dazu in der "grauen Zeile" über dem ersten Posting "Themen-Optionen > Thema abonnieren..." anklicken.

Hinweise, Korrekturen, Texte bitte an mich per PN senden oder besser bei Github docs-de melden.

Die Arbeit am Handbuch verlangt einiges an Arbeitszeit - die kontinuierliche Weiterentwicklung kann mit einer Spende/Sponsoring unterstützt werden - s.u. bei "Spenden".

Dank & Gruss

zonky

Update:

17.07.2024: MM 2.3 Featurelist, Symfony Translation, Defaultwerte
28.05.2024: Überarbeitung Infos für MM 2.4 für Contao 5.3
11.04.2024: Aktualisierung der Debug-Hinweise, XLIFF-Export u.v.a.m.
28.11.2023: div. Fixes: FEE: Inserttags bei Parameter, Filtersets: Einstellungsparameter - insbesondere die URL-Parameter, Filter-URLs ausschließen von Indexierung
01.11.2023: div. Fixes im Text, Umbau Konfiguration für neue Read-the-docs-Version
13.05.2023: Upload/Dropbox in FEE
13.05.2023: Daten in Tabellenkalkulation übernehmen
24.04.2023: Filter mit Weiterleitung
21.04.2023: Setzen der Routenpriorität
05.04.2023: Update Liste Erweiterungen und neue Artikel und Artikel zu Schema.org
24.03.2023: CE Templates in MM verwenden
09.02.2023: Sortierung und automatische Sortierlinks
09.02.2023: FEE - Berechtigungen
31.01.2023: MM-Lageplan aus Workshop-Unterlagen hier...
02.12.2022: Neues Kapitel im Kochbuch Einzelauswahl um weitere Werte ergänzen
02.08.2022: Infos zu MM 2.3 auf der Seite Installation
27.07.2022: div. Anpassungen für MM 2.2, Seite Installation aktualisiert
13.04.2022: div. Anpassungen für MM 2.2, SQL-Snippets zu Sortierung
21.01.2022: Ergänzung beim CE/Modul Filter
27.12.2021: Neue Seite zu Löschen von Kinddatensätzen https://metamodels.readthedocs.io/de...ild-items.html
14.12.2021: Neue Seite zu Beschleunigung bei vielen Datensätzen https://metamodels.readthedocs.io/de...kend-list.html
23.11.2021: Neue Seite zu Listenparametern https://metamodels.readthedocs.io/de...arameters.html
23.10.2021: Update SQL-Beispiele - Neu: Beispiel für Eingabemaske
17.10.2021: Update Standardwerte auf Contao 4.9 https://metamodels.readthedocs.io/de...lt-values.html
01.09.2021: Anpassung Referenz: Beispiele Filter
26.05.2021: Anpassung Referenz MetaModel Interface durch ITranslated
18.05.2021: Referenz ergänzt mit Translated MetaModel Interface
25.04.2021: es gibt eine neue MM 2.2 Featureseite
28.03.2021: verschiedene Anpassungen an MM 2.2-Debug und Verlinkung und Erweiterung MM-Start + Checkliste
14.01.2021: Update FEE Einstellungen MM-Liste
19.11.2020: Update Install MM 2.2 und Sortierung nach referenziertem MM (Eig. SQL)
29.10.2020: Update FEE für eig. Buttons, NC
29.10.2020: Update Sonderseiten Erweiterungen: Notelist, MM-2-Iso, XLIFF-Ex-Import
25.10.2020: Update Seite Erweiterungen; Template breiter
08.09.2020: Update Infos zu MM 2.2
22.07.2020: Anpassung "catch all" bei Zuweisungen - in MM 2.2 "*" statt "-"
25.06.2020: Seite zu Installation und Update neu
28.03.2020: Update eig. SQL und weitere Korrekturen
29.02.2020: Hinweise zu MM 2.2 und MM 2.1
09.12.2029: Hinweis zum MCW beim Updaten
27.08.2019: Beschreibung XLIFF-Ex-Import
22.08.2019: Beschreibung File-Metadata-Extractor
21.08.2019: Beschreibung Filter-Parent
13.05.2019: Anpassung Refernz/MM-API
04.02.2019: Anleitung "MM 2.1 alpha-Test"
26.01.2019: Anpassungen an MM 2.1 inkl. Installation, Umzug usw. sowie weiteren Anpassungen im Text an MM 2.1
05.09.2018: Div. Textkorrekturen und genauere Beschreibungen, Tipps im Kochbuch u.a. bei "Eig. SQL" und "Symfony Tipps"
27.06.2018: neue Seite für MetaModels-2-Isotope
28.02.2018: Update bei Symfony-Tipps, Merkliste, Textkorrekturen
25.01.2018: E-Mail mit Contao-Funktion verschlüsselt ausgeben
24.01.2018: Update Noteliste: neue Funktionen: Löschen nach Formularverarbeitung und Speicherung zusätzlicher Daten je Item
23.01.2018: Update Datei-Attribute bei Umstieg von MM 1.x auf 2.x (Dank an Johannes)
09.01.2018: Tipps für MM 2.1
27.11.2017: Update bei API und SQL, Frontend-Editing neu, Notelist/Merkliste neu, sowie kleinere Korrekturen
05.08.2017: Update bei PDF-Generierung, Videos und Kochbuch: E-Mail-Verschlüsseln sowie kleinere Korrekturen
05.05.2017: Update bei Kochbuch: neue Checklisten, Tipps für (My)SQL, Textkorrekturen
21.03.2017: Update bei Kochbuch: FE-Template: Array-Helper
09.01.2017: Update bei Kochbuch: Tipps für (My)SQL, Textkorrekturen, Update Sphinx-Template
13.10.2016: Update bei Kochbuch: Tipps für (My)SQL, Textkorrektur bei Idexierungen
12.07.2016: Update bei Kochbuch: Checkliste: Start mit MetaModels
02.07.2016: Update bei Kochbuch: Anzeigebedingung bei Checkboxen umkehren
28.06.2016: Update bei Kochbuch: Eigenes SQL
30.05.2016: Erweiterung: Attribut Color, Update bei Kochbuch
23.05.2016: Erweiterung: MetaModels "Boilerplate"
19.05.2016: Eingabemaske: automatische Wertevorgaben
22.04.2016: Erweiterung: Attribut Multi-Column-Wizard, Update bei Kochbuch: SQL-Filter
20.03.2016: Screenshots bei "Das erste MetaModel" aktualisiert (neue Icons und Bezeichnungen)
08.03.2016: Weitere Tutorials und Tipps, kleinere Korrekturen
26.01.2016: weitere bekannte Erweiterungen
17.01.2016: Textsuche über zwei Felder, Anzeigeeigenschaften / Sub-Paletten, eigene RegEx-Prüfung, Filterregel als Ausschluß, Debug Templates, kleinere Korrekturen
21.12.2015: Update Begriffe Metamodels vs. Metamodel (s.u.), Kochbuch: neue Checkliste, Eig. SQL, kleinere Korrekturen
05.12.2015: Umstellung auf neue Bezeichnungen und Icons; erste Einträge beim "Kochbuch"; kleinere Korrekturen
04.12.2015: Vorankündigung: Neue Bezeichnungen und Icons
12.11.2015: Update Installation; Update API (Interfaces)
29.10.2015: Erweiterung Umkreissuche; C2g-Pakete
26.10.2015: Planung Handbuch

Spenden:

Wer den Ausbau des Handbuches unterstützen möchte, kann das auf der MM-Spendenseite oder über diesen Spendenlink machen Ihr bekommt eine Rechnung inkl. MwSt, Spendenbetrag ist also BRUTTO, d.h. vom überwiesenen Betrag kommen 19% weniger an.
Alternativ auch über die Spendenseite von Github https://github.com/sponsors/zonky2/

Dank für Spenden vorab!
Start: 05.09.2015
Stand: 17.07.2024

Spendenticker*:
Alles...1.802,27 €
2015......122,85 €
2016......670,87 €
2017......309,61 €
2018......252,10 €
2019......248,16 €
2020........86,21 €
2021..........8,40 €
2022......105,07 €
2023.........0,00 €
2024.........0,00 €

Zeitticker: 394h

* "Netto-Angabe" - also abzgl. Umsatzsteuer und PP-Gebühren ... und vor ESt :-(

**css-umsetzung** · 25.10.2015, 23:48

Schön, das macht auf den ersten Blick einen guten Eindruck.

Ich wäre eher dafür öffentlich Hinweise oder Ideen zu bringen, so sehen alle, das sich etwas bewegt und ob es in die Richtung geht, die man als Anwender gerne hätte, nicht das ihr euch in Bereichen groß auslasst, die für jeden klar sind.

Ich beispielsweise würde mir wünschen, das das Filterthema noch etwas mehr vertieft wird, andere wiederum wollen bestimmt mehr zur Installation wissen.
Ich beispielsweise bräuchte zwei Composer Anläufe und weiss noch immer nicht warum.

Aber trotzdem, toll das jemand das in die Hand nimmt, gerade zu diesem Zeitpunkt, bin ich ständig am schimpfen, weil man alles mühsam ausprobieren muss um zu wissen wie man vorgehen muss.
Vielen Dank dafür.

**zonky** · 26.10.2015, 06:55

Zitat von css-umsetzung

1.) Ich wäre eher dafür öffentlich Hinweise oder Ideen zu bringen, so sehen alle, das sich etwas bewegt und ob es in die Richtung geht, die man als Anwender gerne hätte, ...

2.) Ich beispielsweise würde mir wünschen, das das Filterthema noch etwas mehr vertieft wird,..

3.) gerade zu diesem Zeitpunkt, bin ich ständig am schimpfen, weil man alles mühsam ausprobieren muss um zu wissen wie man vorgehen muss...

zur 1.: das Thema "mehr Kommunikation" haben wir letzte Woche besprochen - siehe MM-News...

zu 2.: insbesondere mit den Filtereinstellungen gibt es sehr viele Möglichkeiten und Anwendungsfälle - hier wird sicher ein Teil über Rubriken im "Kochbuch" abgedeckt werden "müssen"... es wäre schön, hier entsprechende Kapitel zu erhalten - like "wie kann man..."

zu 3.: hier im Forum ist üblicher Weise schnell eine Antwort auf Fragen zu bekommen - ggf. auch in Mumble...

**css-umsetzung** · 26.10.2015, 07:49

zur 1.: das Thema "mehr Kommunikation" haben wir letzte Woche besprochen - siehe MM-News...

es gibt MM-News?

Es bezog sich auch nur auf das "Hinweise, Korrekturen.... per PN"

zu 3.: hier im Forum ist üblicher Weise schnell eine Antwort auf Fragen zu bekommen - ggf. auch in Mumble...

Hab kein Mumble, will auch kein Mumble, hab genug Haustiere

Ich weiss das schnell geholfen wird, habe ich erst kürzlich feststellen können, aber wenn ich bei jeder Frage erst ins Forum kommen und auf Antworten warten muss (was ja nicht lange dauert aber dennoch)
komm ich nicht zum Arbeiten, daher ist eine tolle Dokumentation überlebenswichtig

**zonky** · 26.10.2015, 08:04

Zitat von css-umsetzung

es gibt MM-News?

* https://now.metamodel.me/de/aktuelles
* https://community.contao.org/de/show...2015-Endlich!-!

**MacKP** · 26.10.2015, 08:10

Eventuell sollen wir dann ein Fundraising für die Doku machen. Leider macht ja sonst keiner bei der Dokumentation mit und die Arbeit erledigt sich ja auch nicht von alleine ;-)

Was haltet Ihr von dieser Idee?

Viele Grüße

**gregor** · 26.10.2015, 12:10

Gute Idee,
würde mich auch finanziell beteiligen.

VG,
Gregor

**MacKP** · 26.10.2015, 12:35

Hmm wobei das glaube ich dann eher ein Spenden Button sein müsste.. ich glaub ein Fundraising wird da schwierig.. da müsste man dann ja die Leistung genau definieren, was glaub ich relativ schwierig wird/ist.

Viele Güße

**zonky** · 26.10.2015, 13:03

ein Fundraising im üblichen Sinne wird sicher schwierig zu kalkulieren - zumal die Dokumentation auch immer wieder erweitert bzw. berichtigt werden muss... aktuell ist seit September etwa "eine Mannwoche" in das Handbuch geflossen

ggf. ist ein Spendenbutton like "Danke!" die bessere Variante

**zonky** · 12.11.2015, 07:35

11.11.2015: Update Installation; Update API (Interfaces)

**raye** · 12.11.2015, 09:23

Vielen Dank für das Handbuch-Update.

Ich habe gerade mal eine Installation gemacht und im Handbuch steht:

Bei den Paketen ist aktuell für Core die Version “2.0.0alphaX” und für Bundle die “1.0.X” auszuwählen.

Ich habe den Core 2.0.0alpha4 installiert. Wenn ich dann den Bundle 1.0.1 installieren gibt es Fehlermeldungen im Composer (siehe Screenshot).

Wenn ich Bundle 2.0.0 nehme geht es.

Gruß
René

**zonky** · 12.11.2015, 09:30

nichts ist so Alt wie das Handbuch von gestern ;-)

das Thema hat sich "über Nacht" geändert - sollte eigentlich später umgestellt werden... muss aber nochmal mit xtra sprechen!

Ich würde sagen: bundle_all reicht als Auswahl aus (MM-Core kommt als Abhängikeit automatisch dazu)

**raye** · 12.11.2015, 10:09

Ok, dann hat es sich einfach unglücklich überschnitten

**zonky** · 12.11.2015, 21:56

* aktuallisiert: http://metamodels.readthedocs.org/de...n-via-composer

**raye** · 13.11.2015, 13:37

Prima, danke.

**zonky** · 13.11.2015, 15:05

Zitat von gregor

Gute Idee,
würde mich auch finanziell beteiligen.

VG,
Gregor

Für das Handbuch sind nun auch eigene Spenden möglich
* Spendenseite MetaModels
* direkter Link zu PP

Dank vorab!

**zonky** · 04.12.2015, 18:38

Achtung!

Die Bezeichnungen von MetaModels und die Icons ändern sich!

Im letzten MM-Call haben wir beschlossen, die im Backend verwendeten Bezeichnungen und die Icons anzupassen. Damit soll eine einheitliche "Nomenklatur" der Elemente von MetaModels erreicht und ein leichtere Assoziation zwischen Bezeichnung/Icon und dem Inhalt möglich sein.

Als Anhang gibt es ein Schaubild als Vergleich zwischen der alten (aktuellen) Version und der neuen Version.

Die Bezeichnungen und Icons werden nach und nach mit den jeweiligen Updates der MetaModel-Komponenten ausgetauscht - sowie auch im Handbuch.

Gruss zonky

Neue-Bezeichnung-Uebersicht_DE_v2.jpg

Die wichtigsten Begriffe wie folgt:

Attribute
Render-Einstellungen
Eingabemasken
Indexierungen
Filtersets
- Filterregel
Eingabe-/Render-Zuordnungen

**zonky** · 06.12.2015, 11:30

Update Handbuch

05.12.2015: Umstellung auf neue Bezeichnungen und Icons; erste Einträge beim "Kochbuch"; kleinere Korrekturen

Dank an Pyropixel für die grafische Überarbeitung der Icons.

Spende von Gregor Gerlach für das Handbuch - Dank dafür!

**zonky** · 21.12.2015, 09:24

Update Handbuch

21.12.2015: Update Begriffe Metamodels vs. Metamodel (s.u.), Kochbuch: neue Checkliste, Eig. SQL, kleinere Korrekturen

Zum Kochbuch "Eigenes SQL": hier wäre es schön, wenn mir interessante SQL-Queries gesendet werden, die hier im Forum "versteckt" sind oder ihr im Einsatz habt...

Auszug aus dem Handbuch zur Abgrenzung der zwei Begriffe MetaModels vs. MetaModel:

Zunächst eine Einordnung von zwei Begriffen: mit MetaModel (Singular) soll im Folgenden eine Datentabelle mit ihren Attributen, Ein-/Ausgabe-Möglichkeiten, Filtern usw. bezeichnet werden. Ein MetaModel wird in den folgenden Texten ohne “s” geschrieben, auch wenn dies z.B. durch den Genitiv erforderlich wäre.

Der Begriff MetaModels (Plural) steht allein als Bezeichnung für das Erweiterungspaket für Contao.

Die C2g-Pakete für "Mein erstes Metamodel" wurden auf Contao 3.5.6 und MM 2.0.0-alpha8 aktualisiert.

**KlausGrenoble** · 21.12.2015, 12:41

Zitat von zonky

Zum Kochbuch "Eigenes SQL": hier wäre es schön, wenn mir interessante SQL-Queries gesendet werden, die hier im Forum "versteckt" sind oder ihr im Einsatz habt...

Hier ein kleines Beispiel:
http://contao.klausgraf.fr/metamodel...-angebote.html
Auf alle Faelle: Ein grosses Lob fuer die Arbeit, die Du Dir mit dem Handbuch machst.
Gruss Klaus

**Contao-Academy** · 21.12.2015, 15:22

Von meiner Seite auch ein herzliches Dankeschön!

**zonky** · 18.01.2016, 11:57

aktualisiert:

17.01.2016: Textsuche über zwei Felder, Anzeigeeigenschaften / Sub-Paletten, eigene RegEx-Prüfung, Filterregel als Ausschluß, Debug Templates, kleinere Korrekturen

**zonky** · 26.01.2016, 12:18

aktualisiert:

26.01.2016: weitere bekannte Erweiterungen

**zonky** · 08.03.2016, 09:11

aktualisiert:

08.03.2016: Weitere Tutorials und Tipps, kleinere Korrekturen

Wer noch weitere Webseiten mit Tutorials, Tipps&Tricks zu MM kennt, bitte mir zusenden

**zonky** · 22.03.2016, 14:02

aktualsiert:

20.03.2016: Screenshots bei "Das erste MetaModel" aktualisiert (neue Icons und Bezeichnungen)

**zonky** · 22.04.2016, 09:53

aktualsiert:

22.04.2016: Erweiterung: Attribut Multi-Column-Wizard, Update bei Kochbuch: SQL-Filter

**hmx** · 29.04.2016, 20:58

Ich finde diese Auflistung sehr gut. Ist immer mein erster Anlaufpunkt, wenn ich mal wieder ins Zweifeln gerate...

Danke Zonky!

**zonky** · 29.04.2016, 22:57

Dank für die Blumen! :-)

Edit: ... und die Spende (Info für Klaus)

**KlausGrenoble** · 30.04.2016, 18:54

Hast Du nicht zu Ende geschrieben:

Zitat von hmx

Ich finde diese Auflistung sehr gut. Ist immer mein erster Anlaufpunkt, wenn ich mal wieder ins Zweifeln gerate...
Danke Zonky!
Ich schau' mir mal Deine Wunschliste näher an...

**zonky** · 30.04.2016, 21:28

eine Spende von Fa. BIADES aus Berlin - Dank für die Unterstützung!

**zonky** · 09.05.2016, 22:23

eine Spende von Hendrik Müller mit der arg.net GmbH - Dank für die Unterstützung!

**zonky** · 18.05.2016, 11:08

... kurzer Ausblick:

in den letzten Wochen war ich mit Fehlersuche und Testen von MM und DCG beschäftigt, so dass die Arbeit am Handbuch hinten angestanden hat - lt. Plan soll diese Woche (KW20) für den DCG die beta35 kommen und bis Ende des Monats (KW22) für MM (core) die alpha11

Mit den zwei Versionen wird ein großes Stück Arbeit an MetaModels geschafft sein und ich werde meinen Fokus wieder mehr der Dokumentation widmen. Zwei kleine Artikel sind aktuell "in der Pipeline": Arbeit mit Templates in MM (welche gibt es und in welcher Hierarchie greifen diese ineinander) sowie das Attribut "color" (wurde mit alpha2 für MM 2.0 fit gemacht).

Gruss zonky