Menu configuration

=General=

If you would like to create a new menu or add new entries to a preexisting menu, access Menu configuration from the Configuration dialog.



If you are unhappy with the existing survey menus or you wish to create a special survey menu for a certain user group, edit the default ones or create new menus. You can also add new menu entries or edit the existing ones.

=Survey Menu=

Once accessed, you can see in the Menu Configuration panel a table with all the existing survey menus.



Four actions are available:
 * Create a menu
 * Edit a menu
 * Delete a menu
 * Reset to default values

Create a menu
If you would like to create a new menu, press on the green button (+ New) located in the upper left part of the window. The following window will pop-up:



A group of options is available:
 * Parent: Use this option to select the parent menu of another survey menu. In this way, a survey menu will be displayed within another menu once clicked. For example, the plugin menu is a survey menu that has as parent menu the mainmenu, being displayed the bottom of it due to its order.
 * Survey: You can choose the survey the menu will be available for. It comes automatically set up for All surveys;
 * Ordering: If you use more menus that have the same position, ordering them would help you better organize them.
 * Title: The tile of the menu;
 * Description: A short summary of the entries that will be added to that menu can be added - useful for other LimeSurvey administrators that wish to later change the configuration of the survey menus;
 * Position: Four positions are available:
 * Sidemenu : The menu will be located on the left side of the window;
 * Collapsed menu : A collapsed menu will display only the icons of the survey menu entries;
 * Top bar : The menu is going to be on a bar located in the upper part of the window;
 * Bottom bar : The menu is going to be on a bar located in the lower part of the window.

Edit a menu
If you would like to change the details of an already existing menu, click on the green button located in the Action column. Once done



Delete a menu
If you want to delete a menu, click on the red trash button that corresponds to that respective menu (located in the Action column). If you click Delete now, all the menu entries of that menu will also be deleted.

Reset to default values
In the case in which you edited the default menus and you want to return back to the default values, click on the Reset button located in the upper right part of the window. Once clicked, you will be asked to confirm the operation. Please note that all the custom menus will be lost if you decide to proceed.



=Examples=

Check the following examples to better understand how you can edit survey menus.

I want the default collapsed menu to become the new sidemenu
The default sidemenu (located under the survey settings tab) is:



To change it, access the menu configuration panel. Edit the mainmenu and change its position from sidemenu to collapsed menu, and the position of the quickmenumenu from collapsed to sidemenu.

Once the changes are done, the sidemenu of the survey (the options displayed under the settings tab) will become the following one:



Display a list button menu
Let's suppose that you wish to add a new (sub)menu to easily access from the settings tab the list question and question groups options. To do that, you have to create the menu option:

We wish to have it displayed in front of the Plugin menu, so we select "Survey menu" to be the parent menu,order "2", to be displayed before the plugin menu, and position "sidemenu" (similar to the position of the parent menu).

Now, the menu is empty. We have to add menu entries to the newly created menu. To do that, we have to access the menu entries panel and add the two links that correspond to "list questions" and "list question groups":


 * List questions


 *  List question groups

I want to change the icons and add new menu entries to the default main menu
To do that, you need to configure the LimeSurvey menu entries. To do that, please continue reading the following wiki section.