Andreas
09.08.2007, 17:32
Um was geht es?
vBulletin bietet seit Version 3.5 die Möglichkeit, das Menü-Frame des Administrator-Kontrollzentrums (links) mit Hilfe von XML-Dateien auf einfache Art und Weise zu erweitern.
Diese Anleitung beschreibt wie das funktioniert.
Wozu brauche ich das?
Viele Modifikationen benötigten ein Admin-Backend. Um ein durchgängiges Bedienkonzept zu realisieren ist es daher nötig weitere Menüpunkte im Navigations-Frame einzublenden.
Wie funktioniert das im Detail?
Um eigene Menüpunkte einzublenden muss im Verzeichnis includes/xml eine Datei cpnav_myhack.xml mit entsprechenden Definitionen angelegt werden.
Diese XML-Datei besteht aus überwiegend aus 6 wichtigen Tags:
<navgroups>
Dies ist der Container des XML und zeigt an dass es sich um ein Navigations-XML handelt.
Das Tag hat einen Parameter product. Dieser muss mit der ProduktID des zugehörigen Produkts übereinstimmen.
Für Einträge die keinem bestimmten Produkt zugeodrnet sind kann vbulletin verwendet werden.
Wichtig: Einträge nicht installierte bzw. inaktiver Produkte werde nicht angezeigt.
<navgroup>
Dies ist der Container für eine Gruppe von Links wie z.B. vBulletin Einstellungen oder Styles & Templates.
Dieses Tag hat 4 wichtige Parameter: phrase, text, permissions and hr.
Falls Phrasen verwendet werden, so muss für den Parameter Phrase ein gültiger Variablenname angegeben werden; für hardcodierten Text kann hingegen der Parameter text verwendet werden.
Der Parameter permissions (optional) dient der Prüfung von Rechten, sodass einige Gruppen nur dann angezeigt werden wenn entsprechende Rechte vorhanden sind, wie z.B. canadminoptions für vBulletin Einstellungen.
Der Parameter hr gibt schließlich an ob nach der Gruppe eine Leerzeile angezeigt werden soll.
<navoption>
Dies bezeichnet einen einzelenen Menüeintrag.
<phrase> bzw <text>
Hier muss der Variablenname der Phrase oder der Text des jewiligen Menüeintrags angegeben werden.
<link>
Der Parameter link enthält schließlich die URL.
Hier ist zu beachten dass Entities verwendet werden müssen, d.h. statt &blah=blubb mus &blau=blubb geschrieben werden.
Falls auf das Moderatoren-Kontrollzentrum verwiesen werden soll so kann {$vbulletin->config[Misc][modcpdir]} eingesetzt werden, unabhängig davon wie das Verzeichnis benannt ist.
Beispiel
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Für die Tags navgroup und navoption gibt es darüber hinaus den Parameter displayorder.
Über diesen Parameter wird die Reihenfolge der Gruppen bzw. Einträge bestimmt (in aufsteigender Reigenfolge).
Mit diesem Parameter ist es auch möglich neue Einträge zu bestehenden Gruppen hinzuzufügen - hierfür muss die displayorder und der Phrasenname der bestehenden Gruppe angegeben werden.
Beispiel
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Der Eintrag "Erster Eintrag in Foren & Moderatoren" wird dann an erster Stelle in der Gruppe Foren & Moderatoren (Displayorder: 60) angezeigt.
Die displayorder vorhandener Gruppen bzw. Einträge kann der Datei cpnav_vbulletin.xml im Verzeichnis includes/xml entnommen werden.
Bei der Erstellung eigener XMLs sollte displayorder immer gesetzt sein, mit jeweils 10 Abstand zwischen den einzelnen Werten.
vBulletin bietet seit Version 3.5 die Möglichkeit, das Menü-Frame des Administrator-Kontrollzentrums (links) mit Hilfe von XML-Dateien auf einfache Art und Weise zu erweitern.
Diese Anleitung beschreibt wie das funktioniert.
Wozu brauche ich das?
Viele Modifikationen benötigten ein Admin-Backend. Um ein durchgängiges Bedienkonzept zu realisieren ist es daher nötig weitere Menüpunkte im Navigations-Frame einzublenden.
Wie funktioniert das im Detail?
Um eigene Menüpunkte einzublenden muss im Verzeichnis includes/xml eine Datei cpnav_myhack.xml mit entsprechenden Definitionen angelegt werden.
Diese XML-Datei besteht aus überwiegend aus 6 wichtigen Tags:
<navgroups>
Dies ist der Container des XML und zeigt an dass es sich um ein Navigations-XML handelt.
Das Tag hat einen Parameter product. Dieser muss mit der ProduktID des zugehörigen Produkts übereinstimmen.
Für Einträge die keinem bestimmten Produkt zugeodrnet sind kann vbulletin verwendet werden.
Wichtig: Einträge nicht installierte bzw. inaktiver Produkte werde nicht angezeigt.
<navgroup>
Dies ist der Container für eine Gruppe von Links wie z.B. vBulletin Einstellungen oder Styles & Templates.
Dieses Tag hat 4 wichtige Parameter: phrase, text, permissions and hr.
Falls Phrasen verwendet werden, so muss für den Parameter Phrase ein gültiger Variablenname angegeben werden; für hardcodierten Text kann hingegen der Parameter text verwendet werden.
Der Parameter permissions (optional) dient der Prüfung von Rechten, sodass einige Gruppen nur dann angezeigt werden wenn entsprechende Rechte vorhanden sind, wie z.B. canadminoptions für vBulletin Einstellungen.
Der Parameter hr gibt schließlich an ob nach der Gruppe eine Leerzeile angezeigt werden soll.
<navoption>
Dies bezeichnet einen einzelenen Menüeintrag.
<phrase> bzw <text>
Hier muss der Variablenname der Phrase oder der Text des jewiligen Menüeintrags angegeben werden.
<link>
Der Parameter link enthält schließlich die URL.
Hier ist zu beachten dass Entities verwendet werden müssen, d.h. statt &blah=blubb mus &blau=blubb geschrieben werden.
Falls auf das Moderatoren-Kontrollzentrum verwiesen werden soll so kann {$vbulletin->config[Misc][modcpdir]} eingesetzt werden, unabhängig davon wie das Verzeichnis benannt ist.
Beispiel
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Für die Tags navgroup und navoption gibt es darüber hinaus den Parameter displayorder.
Über diesen Parameter wird die Reihenfolge der Gruppen bzw. Einträge bestimmt (in aufsteigender Reigenfolge).
Mit diesem Parameter ist es auch möglich neue Einträge zu bestehenden Gruppen hinzuzufügen - hierfür muss die displayorder und der Phrasenname der bestehenden Gruppe angegeben werden.
Beispiel
HTML:
----------
Der Inhalt dieses Abschnitts ist nur für Lizenznehmer sichtbar, Sie werden derzeit jedoch nicht als Lizenzinhaber erkannt.<br />
<br />
Bitte öffnen Sie den <a href="http://members.vbulletin-germany.com/membersupport_priority.php">Kundenbereich</a>, tragen Sie Ihre E-Mail-Adresse ein, mit der Sie sich hier registriert haben und aktivieren Sie die Lizenzüberprüfung für http://www.vbulletin-germany.org.
----------
Der Eintrag "Erster Eintrag in Foren & Moderatoren" wird dann an erster Stelle in der Gruppe Foren & Moderatoren (Displayorder: 60) angezeigt.
Die displayorder vorhandener Gruppen bzw. Einträge kann der Datei cpnav_vbulletin.xml im Verzeichnis includes/xml entnommen werden.
Bei der Erstellung eigener XMLs sollte displayorder immer gesetzt sein, mit jeweils 10 Abstand zwischen den einzelnen Werten.