Custom Menus

Administration Module

Overview

To create custom menus in the Administration Module, you must create and modify an XML file called admin.xml in the CustomMenu folder located in the \wwwroot\wfgen\App_Data\customMenus folder.

These custom menus will then be available as extra menu options in the Administration Module. WorkflowGen supports two levels of custom menu items.

Menu items can be secured by user profile.

XML content

Parameter

Description

Title

Specifies the title of the node The title of the menuItem node will be the name used for the menu item on the Administration Module home page.

Profile

Specifies if the link will be visible to users with an Administrator or User profile

Possible values: user or admin

✏️ Note: If user is specified, it does not grant access to all users but only to those that have access to the Administration Module (for example, folder managers).

URL

Specifies the URL to add as a custom link

📌 Example: http://www.workflowgen.com/

Description

Specifies a description for the custom link.

📌 Example: Visit the WorkflowGen website!

Target

Specifies if the custom link will be opened within the WorkflowGen page (default) or in a new browser

Possible values: "" (default) or _new

showInHomepage

Specifies if the custom link will be displayed in the new menu item only or also on the Administration Module home page (default)

Possible values: true (default) or false

Icon

Specifies the path to a custom icon to be displayed instead of the default circular arrow icon

Images

You can also use images in a custom theme. To do this, create a new Theme package for WorkflowGen and direct the icon path to its location in the \wfgen\App_Themes\MYTHEME\admin\images folder.

The default path is \wfgen\App_Themes\Default\admin\images. You can also add your custom images to this folder and use them from the Default theme folder (see the example below).

Sample admin.xml file

<?xml version="1.0" encoding="utf-8" ?>
<menu>
<menuItem title="My links..." profile="user">
<menuItem title="Advantys" url="http://www.advantys.com/" target="_new" description="Advantys Web Site" profile="user" showInHomepage="true" />
<menuItem title="WorkflowGen" url="http://www.workflowgen.com/" target="" description="WorkflowGen Web Site" profile="admin" icon="myicon.gif" showInHomepage="false" />
</menuItem>
</menu>

User Portal

Overview

To create custom menus in the User Portal, you must create and modify an XML file called portal.xml in the CustomMenu folder located in the \wwwroot\wfgen\App_Data\customMenus folder.

These custom menus will then be available as extra Menu options on the User Portal home page.

Menu items can be secured by user profile.

XML content

Parameter

Description

Title

Specifies the title of the node The title of the menuItem node will be the name used for the menu item on the User Portal home page.

Profile

Specifies if the link will be visible to users with a User, Supervisor, Manager, or Administrator profile

Possible values:

  • user

  • supervisor

  • manager

  • admin

URL

Specifies the URL to add as a custom link

📌 Example: http://www.workflowgen.com/

Description

Specifies a description for the custom link.

📌 Example: Visit the WorkflowGen website!

Target

Specifies if the custom link will be opened within the WorkflowGen page (default) or in a new browser

Possible values: "" (default) or _new

Icon

Specifies the path to a custom icon to be displayed instead of the default "Earth" icon

Images

You can also use images in a custom theme. To do this, create a new Theme package for WorkflowGen and direct the icon path to its location in the \wfgen\App_Themes\MYTHEME\portal\images folder .

The default path is \wfgen\App_Themes\Default\portal\images. You can also add your custom images to this folder and use them from the Default theme folder (see the example below).

Sample portal.xml file

<?xml version="1.0" encoding="utf-8" ?>
<menu>
<menuItem title="WorkflowGen Resource Center" profile="user" url="http://www.workflowgen.com/resources" description="Open the WorkflowGen Resource Center web site" target="_new" icon="" />
<menuItem title="WorkflowGen" profile="supervisor" url="http://www.workflowgen.com/" description="Open the WorkflowGen website" target="_blank" icon="" />
<menuItem title="Advantys" profile="manager" url="http://www.advantys.com/" description="Open the Advantys web site" target="_self" icon="" />
<menuItem title="Google Search" profile="admin" url="http://www.google.com/" description="Open Google Search" target="_parent" icon="search_l.gif" />
<menuItem title="Yahoo!" profile="user" url="http://www.yahoo.com/" description="Open the Yahoo! website" target="_top" icon="" />
<menuItem title="New Leave Application" profile="user" url="/wfgen/show.aspx?QUERY=START&amp;P=LEAVE_APPLICATION" description="Launch a new leave application" target="_new" icon="http://dev4/wfgen/App_Themes/Default/portal/images/request_followup_form_l.gif" />
</menu>