menu.xml
Mit der menu.xml können Sie das Menü im Administrationsbereich erweitern. Möchten Sie Einstellungen als Menüeintrag haben, sollten sie generell auf die settings.xml zurückgreifen. Die settings.xml generiert automatisiert eine Oberfläche und auch das Menü wird erweitert.
Das Anlegen von eigenen Menüeinträgen geht denkbar einfach; legen Sie im root Verzeichnis Ihres Plugins / Pakete eine menu.xml an und definieren Sie hier Ihre Menüeinträge. Bei einem Update oder bei der Installation wird diese menu.xml automatisch von QUIQQER eingelesen.
Beispiel einer menu.xml
<?xml version="1.0" encoding="UTF-8"?>
<menu>
<item parent="/extras/"
name="my_plugin"
require="package/MYPACKAGE/bin/JS_CLASS"
icon="URL_BIN_DIR/16x16/icon.png"
group="quiqqer/system"
var="menu.edit.text"
permission="quiqqer.bricks.edit"
>
huhu, here i am
</item>
</menu>WICHTIG HIERBEI ist, dass der Pfad 'package' heißt und nicht wie man vermuten könnte 'packages'! anderenfalls wird das Panel nicht gefunden.
-
<menu>- fängt eine menu.xml an -
<item>- legt ein Menüeintrag in der QUIQQER Administration an
<item>
Mit dem item Node wird ein neuer Menüeintrag in der QUIQQER Administration erstellt. Das <item> Node besitzt mehrere optionale Attribute.
Der Inhalt des <item> Nodes ist der dargestellte Text des Menüeintrages. Dieses kann aber mit den Attributen group und var überschrieben werden und variabel zur Sprache sein.
Attribute
parent=""
Legt fest, unter welchem Menüeintrag der neue Menüeintrag erscheinen soll. Die Angabe ist eine Pfadangabe der Namen der Menüeinträge. Der root Pfad wäre also /.
Die Root Einträge besitzen folgende Namen:
- quiqqer
- apps
- extras
- settings
- profile
Möchten Sie nun einen neuen Menüeintrag unter Datei erstellen müssen Sie als parent /file/ angeben.
Ein Plugin kann somit ein komplettes Menü selbst erstellen und der Pfad könnte folgendermaßen aussehen:
/extras/my_plugin/sub_menu_entry/
name=""
Legt den Namen des neuen Menüeintrages fest. Dieses ist wichtig, damit weitere Menüeinträge unter diesen gesetzt werden können.
require=""
Legt das AMD JavaScript Modul für den Menüeintrag fest. Wenn der Menüeintrag angeklickt wird, wird dieses Modul per AMD geladen, somit ist es möglich ganze Klassen oder Funktionen per click auszuführen.
icon=""
Legt das icon / Bildchen für den Menüeintrag fest
group="" und var=""
Übersetzung-Variablen für diesen Eintrag. group = Übersetzungsgruppe var = Übersetzung-Variable
permission
- Ist optional
- Hier können kommasepariert verschiedene permissions eingetragen werden welche der Benutzer besitzen muss, um diesen Eintrag zu sehen