Meta editor: Unterschied zwischen den Versionen
Aus Contao Community Documentation
| Zeile 2: | Zeile 2: | ||
{{AppliesTo|TLVersion=ab 2.9.3}} | {{AppliesTo|TLVersion=ab 2.9.3}} | ||
| − | Mit | + | Mit dieser Erweiterung werden Metadaten von Dateien verwaltet. Zum Beispiel bei Bildern in einer Bildergallerie können Beschreibung, Titel und deren Reihenfolge festgelegt werden. Die Metadaten werden in einer meta.txt in einem von contao vorgeschriebenen Format gespeichert. Viele Erweiterungen verwenden die Informationen aus der meta.txt. So zum Beispiel catalog, Downloadelemente und gallery. |
| − | =meta-Datei | + | meta_editor hat folgende Features: |
| − | In einer meta-Datei werden zusätzliche Angaben zu Bilddateien gespeichert. Für jedes Bild | + | * Verschieben der Elemente per Drag & Drop, automatisches speichern der neuen Reihenfolge |
| + | * Importieren bestehender meta Dateien | ||
| + | * Eingabevalidierung mit aufschlussreichen Fehlermeldungen | ||
| + | * Publish / Unpublish Mechanismus erlaubt es Daten zu bearbeiten, aber noch nicht gegen Aussen verfügbar zu machen | ||
| + | * Automatisches suchen / hinzufügen neuer Dateien | ||
| + | |||
| + | |||
| + | Diese Erweiterung ist eine Weiterentwicklung der MetaCreator Erweiterung. | ||
| + | |||
| + | =Definition meta-Datei= | ||
| + | In einer meta-Datei werden zusätzliche Angaben zu Bilddateien gespeichert. In einer meta-Datei werden nur Bilderbeschreibungen verwaltet, von Bildern die im gleichen Verzeichnis sind. | ||
| + | Pro Sprache kann eine meta-Datei angelegt werden. meta.txt ist dabei die Standard-Datei. Für Englisch zum Beispiel, wird eine Datei meta_en.txt angelegt. | ||
| + | ==Syntax== | ||
| + | Für jedes Bild gibt es eine Beschreibung und ein Titel . Pro Zeile wird eine Datei beschrieben. Das Format einer Zeile ist wie folgt: | ||
<Dateiname> = <Beschreibung> || <Dateiname mit Pfad> | <Dateiname> = <Beschreibung> || <Dateiname mit Pfad> | ||
| − | Das Feld 'Beschreibung' wird als Bildunterschrift in der lightbox verwendet. Andere Erweiterungen verwenden die Beschreibung auch im | + | Das Feld 'Beschreibung' wird als Bildunterschrift in der lightbox verwendet. Andere Erweiterungen verwenden die Beschreibung auch im alt Attribut von img-Tags (HTML Element für Bilder). Da ist es sinnvoll die HTML-Ausgabe von meta_editor auszuschalten. Wie das geht steht weiter unten. |
=meta_editor Installation= | =meta_editor Installation= | ||
Version vom 21. Januar 2012, 20:25 Uhr
| betrifft | |
|---|---|
| TYPOlight Version | ab 2.9.3 |
Mit dieser Erweiterung werden Metadaten von Dateien verwaltet. Zum Beispiel bei Bildern in einer Bildergallerie können Beschreibung, Titel und deren Reihenfolge festgelegt werden. Die Metadaten werden in einer meta.txt in einem von contao vorgeschriebenen Format gespeichert. Viele Erweiterungen verwenden die Informationen aus der meta.txt. So zum Beispiel catalog, Downloadelemente und gallery.
meta_editor hat folgende Features:
- Verschieben der Elemente per Drag & Drop, automatisches speichern der neuen Reihenfolge
- Importieren bestehender meta Dateien
- Eingabevalidierung mit aufschlussreichen Fehlermeldungen
- Publish / Unpublish Mechanismus erlaubt es Daten zu bearbeiten, aber noch nicht gegen Aussen verfügbar zu machen
- Automatisches suchen / hinzufügen neuer Dateien
Diese Erweiterung ist eine Weiterentwicklung der MetaCreator Erweiterung.
Inhaltsverzeichnis
Definition meta-Datei
In einer meta-Datei werden zusätzliche Angaben zu Bilddateien gespeichert. In einer meta-Datei werden nur Bilderbeschreibungen verwaltet, von Bildern die im gleichen Verzeichnis sind. Pro Sprache kann eine meta-Datei angelegt werden. meta.txt ist dabei die Standard-Datei. Für Englisch zum Beispiel, wird eine Datei meta_en.txt angelegt.
Syntax
Für jedes Bild gibt es eine Beschreibung und ein Titel . Pro Zeile wird eine Datei beschrieben. Das Format einer Zeile ist wie folgt:
<Dateiname> = <Beschreibung> || <Dateiname mit Pfad>
Das Feld 'Beschreibung' wird als Bildunterschrift in der lightbox verwendet. Andere Erweiterungen verwenden die Beschreibung auch im alt Attribut von img-Tags (HTML Element für Bilder). Da ist es sinnvoll die HTML-Ausgabe von meta_editor auszuschalten. Wie das geht steht weiter unten.
meta_editor Installation
Die Installation kann vom ER aus gemacht werden. Die Seite im ER ist: http://www.contao.org/de/extension-list/view/meta_editor.de.html
Die Quelldateien sind auf github: https://github.com/ideadapt/meta_editor
HTML Ausgabe ein- / ausschalten
Per Default wird tinyMCE als Editor für die Beschreibung verwendet. Dass bedeutet, dass die Beschreibung HTML mindestens das von tinyMCE erstellte p Tag enthält. Bei Download-, wie auch Galerie-Ausgaben wird diese HTML-Beschreibung als title bzw. alt Attributwert verwendet. Die Ausgabe ist dann natürlich nicht standartkonform oder führt zu ungewünschten Formatierungen. Die HTML Ausgabe kann einfach deaktiviert werden. Dazu in der Datei system/modules/meta_editor/dca/tl_metaitem.php beim Feld 'description', das 'rte'=>'tinyMCE' aus dem 'eval' Array löschen.
