Module Menu

This module contains webpart Menu, that will appear in the webparts selection screen in the design of ObjectGears page. Webpart is used for creation of menu with several columns. References can be inserted to various tabs. Each category has its own title.

Particular references will be displayed only if the user has access right to the referred object. The only execption is htmllink, that is always displayed.

Following syntax is used to configure the webpart.

• state the commands on particular rows
• values in row are separated by the pipe sign |
• hodnoty se nastavují ve formátu:

            name_1=value_1|name_2=value_2|name_3=value_3

• rows that do not contain sign "=" are ignored, including empty rows
• in order menu item is displayed two conditions have to be met:
  • there has to be ObjectGears object with the given code
  • user has to have access right to the object
• when entering more categories they will be displayed each next another and automatically wrapped according to the page breadth

Commands:

group=Group name

• name of group, name can be localized
• command group is not mandatory
• when you use this command state it as the first command

cat=Category name

• name of category, name can be localized
• everything before the first category is ignored

Commands for displaying objects:

text=name - enables to display custom name, name is localized
img=url to icon - if it is defined than icon is displayed before the name
tooltip = tooltip text -  enables to define a localized text that will appear in the context menu after moving mouse over the menu text 

Example:

cat=cs-CZ::Úkoly 1~en-US::Tasks 1
classdef=easytask.ukol|typeUrl=l|img=imagesdata/system/sum.png
classdef=easytask.task|typeUrl=n|text=cs-CZ::Nový úkol~en-US::New task|img=imagesdata/system/plugin.png
htmllink=http://www.objectgears.en|text=objectgears.eu

Parameters in URL

You can add text strings at the end of the command that will be added at the end of the URL as a URL parameter.

Example:

classdef=easytask.task|typeUrl=n|text=de-DE::Neue Aufgabe~en-US::New task|img=imagesdata/system/plugin.png|filter=all

Styles

Styles for display in webpart Menu are stored in the file Module_Menu.css in folder of the module. Styles can be changed and will impact all the webparts from the same module. If you want to have more colour schemes, install the module to more folders. You can set different styles for each folder.

Dynamic settings

Menu definition can be set firmly in the webpart configuration. However, it can be also defined dynamically on page by means of webpart property DefinitionItems.

function OnLoad()
{
    OGWebParts['code_1'].DefinitionItems = 'cat=IT catalogue|text=kategorie 1\nclassdef=it.incident|typeUrl=l|img=imagesdata/system/exclamation.png';
}

Example of menu appearance

Example of using links without categories and groups.

Example of three groups (big buttons) and categories (red headlines). Links are below categories.

Example of webpart configuration.