Logged Out
Create an Account
Login:
Password:

Forgot your password?
<!--System:Menus-->

View Version History
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):
  1. The ability to change the ordering of Menus and the menu will adjust accordingly
  2. The ability to rename a menu category and the menu will continue to show
  3. The ability to add new menu categories and they will show


Incoming Guide Links
  • Layout File


  • Last Modified: 4/2/2008 9:41am
    Contributors: Chops
    Easy Link
    BBCode Link: [guide=SystemMenus][/guide]
    URL: http://www.dkpsystem.com/guide/SystemMenus