The <!--System:Menus--> Command is the preferred mechanism to display the majority of your menus. This utilizes the
Menu File for displaying the menus.
The syntax is rather simple:
<!--System:Menus:(Left|Right|All)[:MenusToIgnore]-->Keep in mind that
[:MenusToIgnore] is optional, you may not want to filter certain menus.
Also note, that the "Left" and "Right" are derived from the Menu Administration section, and the left-and-right orientation of the Menu Categories.
Ultimately, this command will be replaced by the appropriate menus.
So for example,
<!--System:Menus:Left-->Will be replaced by all of the menus on the left. For example, if on the right, you had the menus "Menu","Resources", "Calendar", and "Links" (in that order), then
<!--System:Menus:Left-->
is the functional equivalent of
<!--System:Menu:Menu-->
<!--System:Menu:Resources-->
<!--System:Menu:Calendar-->
<!--System:Menu:Links-->
The optional
MenusToIgnore argument allows you to specify one or more menu categories (delimited by semi-colons(;) ) to be ignored by this function.
For example:
<!--System:Menus:Left:Resources-->
is the equivalent of
<!--System:Menu:Menu-->
<!--System:Menu:Calendar-->
<!--System:Menu:Links-->
As another quick example, specifying more than one ignored menu:
<!--System:Menus:Left:Resources;Calendar-->
is the equivalent of
<!--System:Menu:Menu-->
<!--System:Menu:Links-->
You can just as easily use this function for displaying the menus on the right side of the Menu Administration section by specifying "Right" instead of "Left"
<!--System:Menus:Right-->
Additionally, you can quickly display all of the menus, regardless of their orientation by entering
<!--System:Menus:All-->
There are several advantages to using this approach, over specifying the menus manually (with the <!--System:Menu--> command):
- The ability to change the ordering of Menus and the menu will adjust accordingly
- The ability to rename a menu category and the menu will continue to show
- The ability to add new menu categories and they will show
Last Modified: 4/2/2008 9:41am
Contributors:
Chops
Easy Link
BBCode Link: [guide=SystemMenus][/guide]
URL: http://dkpsystem.com/guide/SystemMenus
|