menu.ini [Topmenu_content] #

The block [Topmenu_content] of settings/menu.ini, with 6 setting(s).

Example of adding a custom topmenu entry
See the commented Topmenu_custom entry at the bottom
Tabs[]=custom
Here are the settings which controls behavour of each
menuitem in top admin menu.
URL['ui_context'] - which view item points to in different contextes.
NavigationPartIdentifier - Navigation part identifier of the menu item.
Name - name which is shown on the menu item, if it is not set the default value
is used. Write it in English: it is translated like any other interface
text, in the context TranslationContext names, and shown as it is when
the current language has no translation for it.
Tooltip - tooltip which is shown for the menu item, if it is not set the default value
is used. Translated the same way as Name.
TranslationContext - (optional) the translation context Name and Tooltip are
looked up in, design/admin/pagelayout (the context of the default tab
names) when it is not set. An extension that adds a tab puts the
translations of its Name and Tooltip into its own translation.ts under
this context.
Icon - (optional) the name of an icon admin4 draws before the tab's name: a name of design.ini
[AdminDesignSettings] IconList[] (Bootstrap Icons); a name it does not know draws no icon.
Enabled[ui_context] - sets if menuitem is clickable in current ui_context.
Shown[ui_context] - sets if menuitem is clickable in current ui_context
PolicyList[] - list of policies, either in "<node_id>" or "<module>/<function>" form; a module without
policy functions (visual, class, role, workflow ...) is "<module>/*"
In case of node id, content/read is checked!

Never edit settings/menu.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

• settings/override/menu.ini.append.php for every siteaccess,
• settings/siteaccess/<siteaccess>/menu.ini.append.php for one siteaccess,
• extension/<extension>/settings/menu.ini.append.php in an extension (read when the extension is active).

Icon #

Default: diagram-3.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
Icon=diagram-3
*/ ?>

URL #

Default: a hash of 2: default=content/view/full/2, browse=content/browse/2.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
# an empty "URL[]" first replaces the shipped list; without it the items are added
URL[]
URL[default]=content/view/full/2
URL[browse]=content/browse/2
*/ ?>

NavigationPartIdentifier #

Default: ezcontentnavigationpart.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
NavigationPartIdentifier=ezcontentnavigationpart
*/ ?>

Enabled #

Name=Content structure
Tooltip=Manage the main content structure of the site.

Default: a hash of 3: default=true, browse=true, edit=false.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
# an empty "Enabled[]" first replaces the shipped list; without it the items are added
Enabled[]
Enabled[default]=true
Enabled[browse]=true
Enabled[edit]=false
*/ ?>

Shown #

Default: a hash of 3: default=true, navigation=true, browse=true.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
# an empty "Shown[]" first replaces the shipped list; without it the items are added
Shown[]
Shown[default]=true
Shown[navigation]=true
Shown[browse]=true
*/ ?>

PolicyList #

Default: a list of 1: 2.

<?php /* #?ini charset="utf-8"?
# settings/override/menu.ini.append.php
[Topmenu_content]
# an empty "PolicyList[]" first replaces the shipped list; without it the items are added
PolicyList[]
PolicyList[]=2
*/ ?>

Related #

• All blocks of menu.ini
• All INI files
• The settings page

Generated by ./console exp:help:examples from settings/menu.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.