====== Custom Menu ======

Enabling the custom menu override in [[Site configuration]] allows you to override the automatic generation of the menu, and specify the items that it should contain manually.

===== Enabling the Custom Menu Override =====
Set the "use_custom_menu" flag in the [[Site configuration]] to true.

===== Defining Custom Menu items =====
In your site configuration, set the "custom_menu" property to be an array of objects. Each object should have atleast two properties:

  * The "text" property, which is the text that will be shown on the menu item
  * Either an "exturl" or an "inturl" property. An "exturl" is an absolute link to a page that is not a part of this site, wheras "inturl" is a relative path, starting at the base url, without the "/" prefix.

Optionally, you can also define a "meta" property, which is an arbitrary JSON object that will be made available to the theme on each menu item. This can be used to hold additional information, for example, what icon to display next to the link.