[cvs] [Wiki] changed: CustomizeMenu

[Jan Schneider]

jan  Wed, 15 Feb 2006 01:19:34 -0800

Modified page: http://wiki.horde.org/CustomizeMenu
New Revision:  2.0
Change log:  Add instructions for the sidebar menu

@@ -1,7 +1,26 @@
 + Customizing menus
+
+There are two main menus in Horde. Each module has it's own application menu on the top. And then there is what is called the "Sidebar", the menu on the left in a separate browser frame, which is always the same and contains links to the different Horde applications.
+
+++ Application menus
 
 The application menus are aggregated from several places. You can configure menus in three places:
 
 # Horde Setup, where you can configure Help, Options, Problems, and Logout/Login menu items: you need to login as an administrator and then go to {{Administration -> Setup -> Horde -> Menu Settings}}
 # Application Setup, where you can configure links to all installed applications and application-specific items: {{Adminstration -> Setup -> Application -> Menu Settings}}
 # Arbitrary items: can be configured in {{config/menu.php}}. Copy {{menu.php.dist}} to {{menu.php}}, read the comments in the file header, and create your own menu entries
+
+++ Sidebar
+
+To add new items to the sidebar menu, you need to edit {{config/registry.php}}. Make sure to read the comments at the top of {{registry.php}} carefully. The only required configuration values for a menu entry are {{'name'}} and {{'status'}}, but only the {{'webroot'}} turns it into a useful entry.
+
+Let's say you want to add a link to your intranet:
+<code type="php">
+$this->applications['intranet'] = array(
+    'webroot' => '/intranet',
+    'icon' => '',
+    'name' => 'Intranet',
+    'status' => 'active',
+);
+</code>
+This adds a top-level menu entry with the link text "Intranet" and the link target {{/intranet}} to your sidebar. We also set the {{'icon'}} value to an empty string. This is to keep the browser from loading an icon from a default location, creating a lot entries in your web server's error log. If you put an icon with a size of 16x16 pixel somewhere on your web server, you can put the (web) location into the {{'icon'}} value, and it will be displayed in the menu.