Skip to content

Menu Item Package Installation Plugin#

Adds menu items to existing menus.

Components#

Each item is described as an <item> element with the mandatory attribute identifier that should follow the naming pattern <packageIdentifier>.<PageName>, e.g. com.woltlab.wcf.Dashboard.

The target menu that the item should be added to, requires the internal identifier set by creating a menu through the menu.xml.

<title>#

The language attribute is required and should specify the ISO-639-1 language code.

The title is displayed as the link title of the menu item and can be fully customized by the administrator, thus is immutable after deployment. Supports multiple <title> elements to provide localized values.

<page>#

The page that the link should point to, requires the internal identifier set by creating a page through the page.xml.

Example#

menuItem.xml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<?xml version="1.0" encoding="UTF-8"?>
<data xmlns="http://www.woltlab.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.woltlab.com http://www.woltlab.com/XSD/2019/menuItem.xsd">
    <import>
        <item identifier="com.woltlab.wcf.Dashboard">
            <menu>com.woltlab.wcf.MainMenu</menu>
            <title language="de">Dashboard</title>
            <title language="en">Dashboard</title>
            <page>com.woltlab.wcf.Dashboard</page>
        </item>
    </import>

    <delete>
        <item identifier="com.woltlab.wcf.FooterLinks" />
    </delete>
</data>

Last update: 2021-04-23