Add a new plugin that supports adding a link to the menubar.

Closes #20

Author: iTerminate

src/java/LogrPortal/src/java/gov/anl/aps/logr/portal/plugins/CdbPluginManager.java

@@ -110,6 +110,17 @@ public void loadInfoActionForPropertyValue(PropertyValue propertyValue) {
         }
     }
 
+    public List<Object> getAllMenuBarItems() {
+        List<Object> allItems = new ArrayList<>();
+        for (PluginManagerBase pluginManager : pluginManagerSet) {
+            List<?> items = pluginManager.getMenuBarItems();
+            if (items != null && !items.isEmpty()) {
+                allItems.addAll(items);
+            }
+        }
+        return allItems;
+    }
+
     public PluginManagerBase getPluginManagerByName(String pluginName) {
         for (PluginManagerBase pluginManager : pluginManagerSet) {
             if (pluginManager.getPluginName().equals(pluginName)) {

src/java/LogrPortal/src/java/gov/anl/aps/logr/portal/plugins/PluginManagerBase.java

@@ -8,6 +8,8 @@
 import gov.anl.aps.logr.portal.model.jsf.handlers.PropertyTypeHandlerInterface;
 import gov.anl.aps.logr.portal.utilities.ConfigurationUtility;
 import gov.anl.aps.logr.portal.utilities.SessionUtility;
+import java.util.Collections;
+import java.util.List;
 import java.util.Properties;
 
 /**
@@ -97,8 +99,17 @@ public static Properties getDefaultPropertiesForPlugin(String pluginName) {
     }
 
     /**
-     * Override to display an extras tab for configuration on the multi edit screen. 
-     * 
+     * Override to provide menu bar items from a plugin.
+     *
+     * @return list of menu bar item objects, empty list by default
+     */
+    public List<?> getMenuBarItems() {
+        return Collections.emptyList();
+    }
+
+    /**
+     * Override to display an extras tab for configuration on the multi edit screen.
+     *
      * @return display the extra tab when true
      */
     public boolean pluginHasCatalogMultiEditExtras() {

src/java/LogrPortal/web/templates/portalViewMenubarTemplate.xhtml

@@ -56,7 +56,6 @@ See LICENSE file.
                 </c:forEach>              
             </p:submenu>
 
-
             <f:facet name="options">
                 <p:menubar styleClass="menuBarSupportingItems"> 
 
@@ -79,8 +78,27 @@ See LICENSE file.
                                 value="Advanced Search"
                                 update="@form"
                                 styleClass="onlyIconMenuItem"
-                                action="#{searchController.performInputBoxSearchAdvamced()}" /> 
-                    
+                                action="#{searchController.performInputBoxSearchAdvamced()}" />
+
+                    <c:forEach items="#{cdbPluginManager.allMenuBarItems}" var="pluginMenuItem">
+                        <c:if test="#{!pluginMenuItem.hasChildren}">
+                            <p:menuitem value="#{pluginMenuItem.text}"
+                                        icon="#{pluginMenuItem.icon}"
+                                        url="#{pluginMenuItem.href}"
+                                        target="_blank"/>
+                        </c:if>
+                        <c:if test="#{pluginMenuItem.hasChildren}">
+                            <p:submenu label="#{pluginMenuItem.text}"
+                                       icon="#{pluginMenuItem.icon}">
+                                <c:forEach items="#{pluginMenuItem.children}" var="childItem">
+                                    <p:menuitem value="#{childItem.text}"
+                                                icon="#{childItem.icon}"
+                                                url="#{childItem.href}"
+                                                target="_blank"/>
+                                </c:forEach>
+                            </p:submenu>
+                        </c:if>
+                    </c:forEach>
 
                     <ui:include src="portalViewSupplementalMenubar.xhtml"/>                                           
                     <p:menuitem value="Login" id="loginButton" onclick="PF('loginDialogWidget').show()" rendered="#{!loginController.loggedIn}" icon="fa fa-sign-in"/>

tools/developer_tools/logr_plugins/plugins/menuBarLinks/java/MenuBarItemObject.java

@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) UChicago Argonne, LLC. All rights reserved.
+ * See LICENSE file.
+ */
+package gov.anl.aps.logr.portal.plugins.support.menuBarLinks;
+
+import java.util.List;
+
+public class MenuBarItemObject {
+
+    private String icon;
+    private String text;
+    private String href;
+    private List<MenuBarItemObject> children;
+
+    public MenuBarItemObject() {
+    }
+
+    public String getIcon() {
+        return icon;
+    }
+
+    public void setIcon(String icon) {
+        this.icon = icon;
+    }
+
+    public String getText() {
+        return text;
+    }
+
+    public void setText(String text) {
+        this.text = text;
+    }
+
+    public String getHref() {
+        return href;
+    }
+
+    public void setHref(String href) {
+        this.href = href;
+    }
+
+    public List<MenuBarItemObject> getChildren() {
+        return children;
+    }
+
+    public void setChildren(List<MenuBarItemObject> children) {
+        this.children = children;
+    }
+
+    public boolean getHasChildren() {
+        return children != null && !children.isEmpty();
+    }
+
+}

tools/developer_tools/logr_plugins/plugins/menuBarLinks/java/MenuBarLinksPluginManager.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) UChicago Argonne, LLC. All rights reserved.
+ * See LICENSE file.
+ */
+package gov.anl.aps.logr.portal.plugins.support.menuBarLinks;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.reflect.TypeToken;
+import gov.anl.aps.logr.portal.plugins.PluginManagerBase;
+import java.lang.reflect.Type;
+import java.util.LinkedList;
+import java.util.List;
+import java.util.Properties;
+
+public class MenuBarLinksPluginManager extends PluginManagerBase {
+
+    private static final Properties MENU_BAR_LINKS_PROPERTIES = getDefaultPropertiesForPlugin("menuBarLinks");
+
+    private static final String MENU_ITEMS_KEY = "menuItems";
+
+    private static List<MenuBarItemObject> MENU_BAR_ITEMS;
+
+    public String getMenuItemsJsonTextProperty() {
+        return MENU_BAR_LINKS_PROPERTIES.getProperty(MENU_ITEMS_KEY, "");
+    }
+
+    private void loadMenuBarItems() {
+        Type resultType = new TypeToken<LinkedList<MenuBarItemObject>>() {}.getType();
+        String json = getMenuItemsJsonTextProperty();
+
+        Gson gson = new GsonBuilder().create();
+        MENU_BAR_ITEMS = gson.fromJson(json, resultType);
+    }
+
+    @Override
+    public List<?> getMenuBarItems() {
+        if (MENU_BAR_ITEMS == null) {
+            loadMenuBarItems();
+        }
+        return MENU_BAR_ITEMS;
+    }
+
+}

tools/developer_tools/logr_plugins/plugins/menuBarLinks/java/menuBarLinks.properties

@@ -0,0 +1,2 @@
+# JSON array of menu bar items [{ icon, text, href, children (optional) }]
+menuItems=[{"icon": "fa fa-external-link", "text": "Example App", "href": "https://example.com"}]