docs/package/pip/menu.md

   1 # Menu Package Installation Plugin
   2
   3 Deploy and manage menus that can be placed anywhere on the site.
   4
   5 ## Components
   6
   7 Each item is described as a `<menu>` element with the mandatory attribute `identifier` that should follow the naming pattern `<packageIdentifier>.<MenuName>`, e.g. `com.woltlab.wcf.MainMenu`.
   8
   9 ### `<title>`
  10
  11 !!! info "The `language` attribute is required and should specify the [ISO-639-1](https://en.wikipedia.org/wiki/ISO_639-1) language code."
  12
  13 The internal name displayed in the admin panel only, can be fully customized by the administrator and is immutable. Only one value is accepted and will be picked based on the site's default language, but you can provide localized values by including multiple `<title>` elements.
  14
  15 ### `<box>`
  16
  17 The following elements of the [box PIP](box.md) are supported, please refer to the documentation to learn more about them:
  18
  19 * `<position>`
  20 * `<showHeader>`
  21 * `<visibleEverywhere>`
  22 * `<visibilityExceptions>`
  23 * `cssClassName`
  24
  25 ## Example
  26
  27 {jinja{ codebox(
  28     "xml",
  29     "package/pip/menu.xml",
  30     "menu.xml"
  31 ) }}