Removing home stub if empty

Added an Event HomeStubNavItems
menu->subMenu() returns false if empty

EVENTS.txt

@@ -1463,3 +1463,12 @@ StartNotifyMentioned: During notice distribution, we send notifications (email,
 EndNotifyMentioned: During notice distribution, we send notifications (email, im...) to the profiles who were somehow mentioned.
 - $stored:         Notice object that is being distributed.
 - $mentioned_ids:  Array of profile IDs (not just for local users) who got mentioned by the notice.
+
+StartHomeStubNavItems: Go back Home nav items. Default includes just one item 'home'
+- $action: action being executed (for output and params)
+- $items: array of items in the nav
+
+EndHomeStubNavItems:
+- $action: action being executed (for output and params)
+- $items: array of items in the nav
+

lib/homestubnav.php

@@ -49,17 +49,18 @@ class HomeStubNav extends Menu
 {
     function getItems()
     {
-        if (Event::handle('StartHomeStubNav', array(&$this->action))) {
+        $items = array();
-            return array(array('top',
+        if (Event::handle('StartHomeStubNavItems', array($this->action, &$items))) {
-                               array(),
+            $items[] = array('top',
-                               // TRANS: Menu item in personal group navigation menu.
+                            array(),
-                               _m('MENU','Home'),
+                            // TRANS: Menu item in personal group navigation menu.
-                               // TRANS: Menu item title in personal group navigation menu.
+                            _m('MENU','Home'),
-                               // TRANS: %s is a username.
+                            // TRANS: Menu item title in personal group navigation menu.
-                               _('Back to top'),
+                            // TRANS: %s is a username.
-                               'nav_return_top'));
+                            _('Back to top'),
-            Event::handle('EndHomeStubNav', array(&$this->action));
+                            'nav_return_top');
+            Event::handle('EndHomeStubNavItems', array($this->action, &$items));
         }
-        return Null;
+        return $items;
     }
 }

lib/menu.php

@@ -150,8 +150,9 @@ class Menu extends Widget
 
     function submenu($label, $menu)
     {
-        if(!$menu->getItems())
+        if (empty($menu->getItems())){
-            return;
+            return false;
+        }
         $this->action->elementStart('li');
         $this->action->element('h3', null, $label);
         $menu->show();