Defining the Menu and the Toolbar

In the menuBar.xml and toolBar.xml files, the menu and the toolbar of the Content Navigator are composed from individual menu items (beans). The items available are listed in the itemRegistry.xml file. Other content-specific menu items and buttons on the toolbar can be defined in the contentMenu.xml file (see Configuring Custom Commands). Take a look at this example from the menuBar.xml file:

<menu name="file">
  <title lang="en">File</title>
  <title lang="de">Datei</title>
  <group name="object" contexts="object, select.object">
    <group name="new">
      <title lang="en">New</title>
      <title lang="de">Neu</title>
      <title lang="fr">Nouveau</title>
      <item>create_object_document</item>
      <item>create_object_publication</item>
      <item>create_object_image</item>
      <item>create_object_generic</item>
      <item roles="admin">create_object_template</item>
    </group>
    <item separated="true">import_file</item>
  </group>
  <item contexts="bookmark">create_bookmark_folder</item>
  <group separated="true" name="search" contexts="*.object">
    <item contexts="object, select.object">search_objects</item>
    <!-- insert saved searches here-->
  </group>
  <item contexts="object" separated="true">logout</item>
</menu>

The definitions of the items on the toolbar is specified analogously. However, it does not include a hierarchy (submenu) because the toolbar has no subitems:

<toolBar>
  <group name="object" contexts="object">
    <item>create_object_document</item>
    <item>create_object_publication</item>
    <item roles="admin">import_file</item>
    <item separated="true">finish_tasks</item>
    <item separated="true">search_panel</item>
  </group>
  <group name="edit" separated="true">
    <item>cut_into_clipboard</item>
    <item>copy_into_clipboard</item>
    <item contexts="object">paste_objects</item>
    <item contexts="bookmark">paste_bookmarks</item>
    <item contexts="object">delete_object</item>
    <item contexts="bookmark">delete_bookmarks</item>
  </group>
  <group name="view" separated="true" roles="admin">
    <item contexts="object">browser_preview</item>
    <item>browser_tree</item>
    <item>browser_columns</item>
    <item>browser_list</item>
    <item contexts="object">browser_icons</item>
    <separator/>
    <item contexts="object">preview</item>
    <item>view_mode</item>
    <item>refresh</item>
  </group>
  <separator/>
  <item>online_help</item>
  <item>logout</item>
</toolBar>

Each item in a menu or in a toolbar refers to a bean in the beans element of itemRegistry.xml. For example

<item>about_nps</item>

refers to the following item in itemRegistry.xml and includes it in the toolbar:

<bean id="about_nps"
    class="com.infopark.cm.htmlgui.browse.menuaction.OpenSubpage">
  <property name="titles"><map>
    <entry key="de"><value>Über CMS Fiona</value></entry>
    <entry key="en"><value>About CMS Fiona</value></entry></map>
  </property>
  <property name="subpage"><value>AboutNPS</value></property>
  <property name="selectionType"><value>none</value></property>
  <property name="dialogSize"><value>large</value></property>
</bean>

The group element gives you the possibility to group elements together without making this grouping visible in the menu or toolbar. If the group contains a dividing line (separator), and none of the items it contains (see below) can be selected (due to restrictions), the group will be completely hidden, i. e. including the separator. This helps to avoid two adjacent separators (without menu items between them).

Furthermore, the group element can be used to restrict the visibility of the items it contains to particular Content Navigator pages. This can be achieved by means of the contexts attribute that can have the following values:

  • object: the items in this group are visible if a file has been selected in the main window of the Content Navigator.
  • bookmark: the elements in this group are visible if bookmarks are being edited in the Content Navigator.
  • select.object: the elements in the group are visible if a file is selected using the file selection dialog in the Content Navigator.
  • search.object: the elements in the group are visible if a file is being searched for on the search page.

Using the roles attribute, groups of menu commands as well as individual menu commands can be restricted to particular user interfaces. See also the gui.roles system configuration entry in the gui.xml file.

The properties of beans of the class com.infopark.cm.htmlgui.browse.menuaction.OpenSubpage have the following meaning.

  • titles determines the multi-language titles of dialog pages.
  • subpage determines the names of a dialog page.
  • selectionType determines the selection of files to which a menu command can be applied: none = globally (no file), single = a single file, extended = a list of files.
  • dialogSize determines the size of the dialog window. Permitted values are small, medium, and large.