A menu presents buttons for actions in an This page is for application developers who want to provide one or more menus for application users.

Overview

You can add menus to help the users of your Application or Stream View.

In When you create an application, a number of menus can be created. Typically, one menu is created for use on PCs, and one is created for use on mobile devices - in some cases, a single menu is enough as a default on both types of devices (or when only one type of device will be used). However, it is possible to create more than this - different, non-default menus in the application can be accessed using a URL that specifies the menu.To make a menu in an application a defaultPhixFlow automatically creates an empty menu item in the repository. When you add an menu items to this menu and refresh the browser window, PhixFlow displays the menu(s) for the loaded application. 

For applications that are designed for use on both PCs and mobile devices, consider the usability of your menu on a small screen. A single menu may work in both form-factors. However, it can be helpful to have an alternative menu for mobile display. 

To specify a default menu for an application, In the repository, right-click on it in the repository browser menu name and select:

• either Make Default Desktop Menu
• or Make Default Mobile Menu.

To specify an alternative menu to display instead of the default, provide users with a URL to the application that specifies the alternative menu.

Adding Menu Items to the Repository

To add menu items, in the repository for your application, find the Menus branch. For a new application there is always one menu item, which is created by Phixflow when you create the application.

1. Double-click the menu item to open its properties.
2. Optionally, you can change its Name.
3. In the Menu Items section  

   Insert excerpt
   _add _add nopanel true

    , click 

   Insert excerpt
   _add _add nopanel true

   .
4. Select one of:
   • Add a new sub-menu
   • Add a new menu item 
5. PhixFlow opens a new menu item properties.
   • For a menu item, select an action and specify the order for the menu in the menu bar.
   • For a sub-menu, enter a name, a display name and an order then add the sub-menu items.

The structure of the menu items in the repository reflects the menu structure you have created, for example:

Image Added

• Top-level menu
  Top of a tree of menus in the repository. The menu items listed in the top-level menu populates the menu bar at the top of the screen. The top-level menu does not have a display name because it acts as a container for the menus, rather than being a menu option itself.
• Menu options
  Menu options are associated with an action. Actions are often linked to underlying streams. When a use clicks the option PhixFlow runs the action. For example, if your application has a form to which a user can add data, the menu option "Save Changes" would save the data to the underlying stream.
• Sub-menu:
  A sub-menu contains more menu options. It is not associated with an action.

You can add 

• top-level menu items
• sub-menus
• sub-menu items

PhixFlow displays menu options on the menu bar. 

Image Added

Menu Properties

Top-level

...

Application Menus

For each top level application menu, the following fields are configured:

Field	Description
Name	The name of the menu	Order	The Enter the repository name for the menu.
Display Name	When you have selected an action, PhixFlow shows the name that will appear in the menu bar or menu.  To change the display name,  find the action in the repository change the action properties Basic Settings → Display Name.
Order	Enter the order in which the menu will appear on the menu bar.
Default Action	The Select an action that will run when the menu is opened.
Hide the Menu Bar	Insert excerpt _check_box_untick _check_box_untick nopanel true  to display the menu bar at the top of your application. The menu bar displays the PhixFlow application menu, Image Added and the menus for your application. Insert excerpt _check_box_untick _check_box_untick nopanel true  to hide the menu bar. Use this option for a cleaner look to your application if it does not require menu options for the user. The application menu icon moves to the bottom right bar.  As you cannot have application menus when this option is ticked, PhixFlow removes the Menu Items section of the properties tab.

Menu Items

This section is available as long as Hide the Menu Bar is not ticked. A list of menu items. You can add sub-menus and menu items as required. See below for details of configuring menu items.

Order - the order in which items appear 

either on the menu bar. 1 means the option appears at the right of the line of the menu options. The highest number order appears on the far left of the menu bar

or in a sub-menu, the order in the list, with 1 at the top.

List - ticked indicates a sub-menu. unticked

Sub-menus and menu items

In stream views and under top level application menus, you can create sub-menus and menu items. Menu items make actions available to users on forms.

...