The AdminCP Navigation is now controlled through XML files.
To add custom entries, you must create a new file cpnav_yourhack.xml and place it in directory includes/xml.
This XML-File constist of 6 important tags:
<navgroups>
This indicates that this is a XML File containing navgroups.
It has one parameter product that should be set to your product identifier or vbulletin if it does not belong to any product.
<navgroup>
This is the container for one Settings-Group, like Styles & Templates, vBulletin Options, etc.
It has three parameters: phrase/text, permissions and hr.
If you are using phrases, phrase must contain the variable name, if you are using hardcoded text then text must contain the label.
Parameter permissions (optional) can be used to check an administrator permission, like canadminoptions.
Parameter hr (optional) can be used to put a spacer below this navgroup.
<navoption>
This is one Menu-Entry.
<phrase> or <text>
This must contain the varname or hardcoded text for the menuetry.
<link>
Tag link must contain the URL.
You can use {$vbulletin->config[Misc][modcpdir]} to point to the ModCP directory here, no matter how it is actually called
Update for Beta 3
With Beta 3 a new parameter displayorder has been introduced. This parameter is valid for Tags navgroup and navoption.
This way it is possible to control in which order the Navgroups and Links will be displayed, and you can also add custom Links to existing Navgroups.
To do so, your navgroup must have them same displayorder and Phrase Varname as the existing group:
HTML Code:
<?xml version="1.0" encoding="ISO-8859-1"?><navgroups product="vbulletin"><navgroup phrase="forums_and_moderators" displayorder="60"><navoption displayorder="1"><text>Top-Link Forums & Moderators</text><link>demohack.php?do=foo</link></navoption></navgroup></navgroups>
Then Top-Link Forums & Moderators will be the first link in Navgroup Forums & Moderators (Displayorder: 60).
To find out the Displayorder for existing groups, take a look at cpnav_vbulletin.xml.
This How-To is (C) 2005 by KirbyDE and you are not allowed to redistribute it in any way without my explicit consent.
This one is not directly related to the subject, but it also is, somehow.
In the past, I modified the AdminCP menu of a hack of mine, depending on a parameter the user entered, adding or removing a line in the menu. If the condition of this parameter was changed, then I forced a reload of admincp, by redirecting the program to admincp/index.php.
Obviously this method can no longer be used, and I have to have two different cpnav_xxx.xml files, one with the additional line and one with out it, and copy the one I need to the /includes/xml directory. However, my php knowledge is not that extensive, so can some one please tell me how I can do something like (in pseudo code):
I believe this can easily be solved by offering the else-excluded option anyways, and then have this parameter check before any other code in the section in the file, and print out a cp message in the event that the option would not have been shown on the old menu.
It would be really nice to be able to add options to existing groups. It's just much more organized than forcing every tiny little hack to have its own group. Any chance of this being added in the future?
06-07-2005, 10:00 PM
07-02-2005, 10:23 PM
