[commits] [Wiki] changed: CustomizeMenu

[Ralf Lang (B1 Systems GmbH)]

rlang  Thu, 17 Jan 2013 11:32:40 +0100

Modified page: http://wiki.horde.org/CustomizeMenu
New Revision:  8
Change log:  Horde 5 menu customisations.

@@ -1,5 +1,49 @@
-+ Customizing menus
++ Customizing menus in Horde 5
+
+There are two main menus in Horde. The topbar contains links to all  
different horde applications, configuration and administration options  
available to the user.
+If the application has a search facility, the topbar will also  
provide a search field.
+The sidebar on the left contains module-specific entries.
+
+++ Topbar customisation ++
+
+You can regroup applications into submenus by adding {{heading}} and  
{{menu_parent}} entries to the {{registry.local.php}} file.
+
+For example, let's group nag and whups into a "chores" menu.
+<code type="php">
+$this->applications['chores'] = array('name' => 'chores'
+                                      'status' => 'heading'
+                                     );
+$this->applications['nag']['menu_parent'] = 'chores';
+$this->applications['whups']['menu_parent'] = 'chores';
+</code>
+
+The chores-menu will only be displayed if either nag or whups are  
available and active. You can also add an 'url' parameter to a  
'heading' to make it clickable. Unfortunately, headings which have no  
apps below them will not be shown.
+
+To work around this, register your links as apps.
+
+<code type="php">
+// Custom Menus
+  'intranet' => array(
+      'name' => _("Intranet Links"),
+      'status' => 'heading',
+  ),
+
+  'xyz' => array(
+      'webroot' => 'http://applications.horde.org/',
+      'name' => _("Application 1"),
+      'status' => 'active',
+      'target' => '_blank',
+      'menu_parent' => 'intranet',
+      'fileroot' => '/tmp',
+      'icon' => ''
+  ),
+
+</code>
+This has a side effect though. The new pseudo app will show a useless  
entry in the "preferences" menu.
+
+
++ Customizing menus in Horde 3 and 4

  There are two main menus in Horde. Each module has its 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