Aufbau einer Toolbar
Jede Toolbar besteht aus einer einfachen XML-Datei.
Diese wird auf File-Ebene im Verzeichnis "site/MANDANT/admin/toolbar/" ("MANDANT" steht für die Mandant-Bezeichnung) abgelegt und besitzt den Namen "XXX.toolbar.xml" ("XXX" steht für die eigene Bezeichnung):
- admin.toolbar.xml
- redakteur.toolbar.xml
- minimal.toolbar.xml
Toolbars können auch global für alle Mandanten einmalig angelegt werden.
Kopieren Sie dazu die Toolbar-XML-Dateien in das Verzeichnis "site/_global/admin/toolbar/"
Das Verzeichnis "toolbar" kam neu in Version 5 hinzu, in Egotec-Version 4 bleibt dieses Verzeichnis weg, d.h. die xml-Dateien liegen direkt im "admin"-Verzeichnis.
Aufbau der XML-Datei
<?xml version="1.0" encoding="UTF-8"?>
<TOOLBAR>
<ITEM>
<TYPE>blockformats</TYPE>
<ACTION>p,address,pre,h1,h2,h3,h4,h5,h6</ACTION>
</ITEM>
<ITEM>
<TYPE>button</TYPE>
<ACTION>cut</ACTION>
</ITEM>
<ITEM>
<TYPE>button</TYPE>
<ACTION>copy</ACTION>
</ITEM>
</TOOLBAR>
Der Kopf der XML-Datei beginnt mit der Zeile <?xml version="1.0" encoding="UTF-8"?> gefolgt von einem öffnenden TOOLBAR-Tag in der 2.Zeile. Ebenso findet man am Ende der Datei das schließende TOOLBAR-Tag.
Jede Schaltfläche im Editor stellt in der xml-Datei einen ITEM-Eintrag dar:
<ITEM>
<TYPE>button</TYPE>
<ACTION>copy</ACTION>
</ITEM>
Der Wert "TYPW" legt fest, um welchen Buttontyp es sich handelt. Mögliche Werte sind:
- button = normaler Button
- line = Abstandshalter
- break = Neue Zeile
- choice = Auswahlbox
Der Wert "ACTION" gibt an welche Aktion beim Klick ausgeführt werden soll. Hier finden Sie eine Liste aller möglichen Aktionen.
Eine neue Zeile ergibt damit folgenden ITEM-Block:
<ITEM>
<TYPE>break</TYPE>
<ACTION>newline</ACTION>
</ITEM>
während für einen Abstandhalter folgender Block verwendet wird:
<ITEM>
<TYPE>line</TYPE>
<ACTION>line</ACTION>
</ITEM>
Vorgehensweise beim Erstellen
Das manuelle Erstellen einer Toolbar ist zu aufwändig. Kopieren Sie daher die vollständige Standard-Toolbar aus dem Systemverzeichnis "lib/admin/toolbar/standard.xml" als Vorlage heraus und löschen Sie nicht benötigte Buttons (ITEM-Elemente) weg.
Nun bleibt nur noch jeweils, die Toolbar nach eigenem Wunsch zu benennen und in das entsprechende Verzeichnis (siehe oben) zu kopieren.
Bitte verwenden Sie für den WYSIWYG5 Editor nicht die Toolbar-XML-Datei aus Version 4.
Aufgrund von anderen Button-Bezeichnungen werden diese unter Umständen nicht korrekt erscheinen.