Actions

Menu entries configuration: Difference between revisions

From LimeSurvey Manual

mNo edit summary
mNo edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 9: Line 9:


<!--T:9-->
<!--T:9-->
{{Box|The wiki is incomplete. More details have to be provided. If you would like to contribute to this wiki.}}
{{Box|The wiki is incomplete. More details have to be provided. If you would like to, you can contribute to this wiki.}}


=General= <!--T:2-->  
=General= <!--T:2-->  


<!--T:10-->
<!--T:10-->
To access the Menu entries table, click on '''Configuration''' and then on '''Menu entries configuration'''
To access the Menu entries table, click '''Configuration''' and then '''Menu entries configuration'''.




Line 22: Line 22:


<!--T:12-->
<!--T:12-->
This function allows you to create, edit or delete menu entries. In order to be shown, these entries have to be added into a [[Menu configuration|menu]].
This function allows you to create, edit or delete menu entries. To be visible/displayed, these entries have to be added into a [[Menu configuration|menu]].


=Menu entries configuration= <!--T:3-->
=Menu entries configuration= <!--T:3-->
Line 32: Line 32:


<!--T:14-->
<!--T:14-->
The following actions are available to the users:
The following actions are available:
*[[Menu entries configuration#Create a menu entry|Create a menu entry]]
*[[Menu entries configuration#Create a menu entry|Create a menu entry]]
*[[Menu entries configuration#Edit menu entry|Edit menu entry]]
*[[Menu entries configuration#Edit menu entry|Edit menu entry]]
Line 43: Line 43:


<!--T:15-->
<!--T:15-->
To create a new menu entry, click on the '''+ New''' button located on the top-left side of the window. Once clicked, you the following menu options will be displayed:
To create a new menu entry, click the '''+ New''' button located on the top-left side of the window. The following menu options will be displayed:
*'''Menu''': Select the menu where the new entry will be located ([[Menu configuration#Create a menu|read our wiki on how to create menus here]]);
*'''Menu''': Select the menu where the new entry will be located ([[Menu configuration#Create a menu|read our wiki on how to create menus here]]);
*'''Name''': Type in the name of the menu entry;
*'''Name''': Type in the name of the menu entry;
*'''Title''': The title of the respective entry which will be displayed in the menu or under certain tabs (e.g., under the survey settings tab)
*'''Title''': The title of the respective entry which will be displayed in the menu or under certain tabs (e.g., under the survey settings tab)
*'''Ordering''': If more menu entries are added to a menu, use this function to order them.
*'''Ordering''': If more menu entries are added to a menu, use this function to order them.
*'''Menu title''': Once you accessed a tab or a menu entry, the menu title will be displayed on the first line. For example, if you click on '''Overview''' which is located under the '''Survey settings''' tab, the overview panel will be displayed with the ''(menu) title'': Survey overview  
*'''Menu title''':On a tab or a menu entry, the menu title will be displayed on the first line. For example, if you click '''Overview''', located under the '''Survey settings''' tab, the overview panel will be displayed with the ''(menu) title'': Survey overview  
*'''Menu name''': It is displayed when you hover the mouse over the respective entry. For example, if you hover the mouse over '''Theme options''', the following message will show up: ''Edit theme options for this survey''.  
*'''Menu name''': Displayed when you hover the mouse over the respective entry. For example, if you hover the mouse over '''Theme options''', the following message will show up: ''Edit theme options for this survey''.  
*'''Menu icon''': All the used icons are fontawesome icons by default. To find other available icons, check the following [https://www.w3schools.com/icons/fontawesome_icons_text.asp link]. Introduce in the box the string located after "fa fa-". E.g., for a floppy disk, we have "fa fa-floppy-o". To use it as an icon for a menu entry, type in this box only "floppy-o".
*'''Menu icon''': All the used icons are fontawesome icons by default. To find other available icons, check the following [https://www.w3schools.com/icons/fontawesome_icons_text.asp link]. Introduce in the box the string located after "fa fa-". E.g., for a floppy disk, we have "fa fa-floppy-o". To use it as an icon for a menu entry, type in this box only "floppy-o".
*'''Menu icon types''': It depends on the ones used within your current theme. For further details, check the following [[Themes|wiki section]].
*'''Menu icon types''': It depends on the ones used within your current theme. For further details, check the following [[Themes|wiki section]].
Line 63: Line 63:


<!--T:17-->
<!--T:17-->
If you would like to change the details of an already existing menu entry, click on the green button located in the '''Action''' column. The respective menu will get selected and you can do the edits.
To change the details of an already existing menu entry, click the green button located in the '''Action''' column. The respective menu will get selected and you can do the edits.


==Delete menu entry== <!--T:6-->
==Delete menu entry== <!--T:6-->
   
   
If you want to delete a menu entry, click on the red trash button that corresponds to that respective menu entry (located in the '''Action''' column).
To delete a menu entry, click the red trash button that corresponds to that respective menu entry (located in the '''Action''' column).
 


==Reorder menu entries== <!--T:22-->
==Reorder menu entries== <!--T:22-->


<!--T:23-->
<!--T:23-->
The ordering process takes first into account the '''menu''' an entry belongs to, and then it orders the entries according to the value from the '''order field'''. Once you change these values, click on the '''reorder''' button to get the entries rearranged in the table.
The ordering process takes first into account the '''menu''' an entry belongs to, and then it orders the entries according to the value from the '''order field'''. Once you change these values, click the '''reorder''' button to get the entries rearranged in the table.




<!--T:24-->
<!--T:24-->
<center>[[File:Reorder survey menu entries.png]]</center>
<center>[[File:Reorder survey menu entries.png]]</center>


==Reset menu entries to the default values== <!--T:25-->
==Reset menu entries to the default values== <!--T:25-->


<!--T:26-->
<!--T:26-->
If you wish to reset all the values of the survey menu entries to their default values, click on the '''reset''' button located in the upper right part of the screen. A message will pop up asking you to confirm the action. Please note that once you confirm the action, all the custom menu entries will be lost.
To reset all the values of the survey menu entries to their default values, click the '''reset''' button located in the upper right part of the screen. A message will be displayed asking you to confirm the action. Please note that once you confirm the action, all the custom menu entries will be lost.




Line 91: Line 89:
=Examples= <!--T:7-->
=Examples= <!--T:7-->


==I want to add a new menu entry to the default survey menu== <!--T:28-->
==Add a new menu entry to the default survey menu== <!--T:28-->


<!--T:29-->
<!--T:29-->
In this example, it will be shown how to add a [[Label sets]] menu entry to the default survey menu.
This example demonstrates how to add a [[Label sets]] menu entry to the default survey menu.


<!--T:30-->
<!--T:30-->
First, click on the '''+ New''' button located on the top left side of the screen and start completing the fields:
First, click the '''+ New''' button located on the top left side of the screen and start completing the fields:
*''Menu'': Select from the dropdown list the menu you wish to add to the menu entry.
*''Menu'': Select from the dropdown list the menu you wish to add to the menu entry.
*''Name'': labelsets.
*''Name'': labelsets.
Line 103: Line 101:
*''Menu title'': Label sets.
*''Menu title'': Label sets.
*''Menu name'': "Click here to edit the available sets."
*''Menu name'': "Click here to edit the available sets."
*''Menu icon'': Check the following [https://www.w3schools.com/icons/fontawesome_icons_text.asp link] to find the right icon for the new menu entry. In the screenshot from above, I used "fa fa-battery-three-quarters".
*''Menu icon'': Check out the following [https://www.w3schools.com/icons/fontawesome_icons_text.asp link] to find the right icon for the new menu entry. In the screenshot from above, I used "fa fa-battery-three-quarters".
*''Menu icon type'': Select from the dropdown box the "Fontawesome icon" option.
*''Menu icon type'': Select from the dropdown box the "Fontawesome icon" option.
*''Menu link'': Find the URL of the option you wish to link the entry to, and copy everything after the website name (admin/labels/sa/view in our case):  
*''Menu link'': Find the URL of the option you wish to link the entry to, and copy everything after the website name (admin/labels/sa/view in our case):  
Line 112: Line 110:


<!--T:32-->
<!--T:32-->
Click on the create button and see if the new survey menu entry was added:
Click the create button to verify that the new survey menu entry was added:




Line 120: Line 118:


<!--T:34-->
<!--T:34-->
Once done, check the survey menu and see if the survey menu entry is functional:
Check the survey menu to verify that the survey menu entry is functional:




Line 133: Line 131:


<!--T:19-->
<!--T:19-->
When creating or editing a menu entry, you may find in the lower right part of the dialog the '''Toggle advanced options''' button. The following extra fields will be shown once you press it:
When creating or editing a menu entry, you may find in the lower right part of the dialog the '''Toggle advanced options''' button. The following extra fields will be shown once you click it:
*'''Action'''
*'''Action'''
*'''Template'''
*'''Template'''
Line 143: Line 141:


<!--T:20-->
<!--T:20-->
Once the edits are done, do not forget to click on the '''Save''' button.
Once the edits are done, do not forget to click '''Save'''.




</translate>
</translate>

Latest revision as of 09:46, 31 May 2021

Other languages:
  Under construction


The wiki is incomplete. More details have to be provided. If you would like to, you can contribute to this wiki.


General

To access the Menu entries table, click Configuration and then Menu entries configuration.


Menu Entries Configuration.png


This function allows you to create, edit or delete menu entries. To be visible/displayed, these entries have to be added into a menu.

Menu entries configuration


The following actions are available:


Create a menu entry

To create a new menu entry, click the + New button located on the top-left side of the window. The following menu options will be displayed:

  • Menu: Select the menu where the new entry will be located (read our wiki on how to create menus here);
  • Name: Type in the name of the menu entry;
  • Title: The title of the respective entry which will be displayed in the menu or under certain tabs (e.g., under the survey settings tab)
  • Ordering: If more menu entries are added to a menu, use this function to order them.
  • Menu title:On a tab or a menu entry, the menu title will be displayed on the first line. For example, if you click Overview, located under the Survey settings tab, the overview panel will be displayed with the (menu) title: Survey overview
  • Menu name: Displayed when you hover the mouse over the respective entry. For example, if you hover the mouse over Theme options, the following message will show up: Edit theme options for this survey.
  • Menu icon: All the used icons are fontawesome icons by default. To find other available icons, check the following link. Introduce in the box the string located after "fa fa-". E.g., for a floppy disk, we have "fa fa-floppy-o". To use it as an icon for a menu entry, type in this box only "floppy-o".
  • Menu icon types: It depends on the ones used within your current theme. For further details, check the following wiki section.
  • Menu class:
  • Menu link: Link the menu entry to the URL of that function
  • Permission:
  • Permission grade:
See the last section of this page for information on advanced options.

Edit menu entry

To change the details of an already existing menu entry, click the green button located in the Action column. The respective menu will get selected and you can do the edits.

Delete menu entry

To delete a menu entry, click the red trash button that corresponds to that respective menu entry (located in the Action column).

Reorder menu entries

The ordering process takes first into account the menu an entry belongs to, and then it orders the entries according to the value from the order field. Once you change these values, click the reorder button to get the entries rearranged in the table.


Reset menu entries to the default values

To reset all the values of the survey menu entries to their default values, click the reset button located in the upper right part of the screen. A message will be displayed asking you to confirm the action. Please note that once you confirm the action, all the custom menu entries will be lost.


  Attention : Please note that in order to backup your survey menu entries configuration, create a LimeSurvey database backup. A separate option will be introduced in the near future to facilitate only the backup of the survey menus.


Examples

Add a new menu entry to the default survey menu

This example demonstrates how to add a Label sets menu entry to the default survey menu.

First, click the + New button located on the top left side of the screen and start completing the fields:

  • Menu: Select from the dropdown list the menu you wish to add to the menu entry.
  • Name: labelsets.
  • Order: 20.
  • Menu title: Label sets.
  • Menu name: "Click here to edit the available sets."
  • Menu icon: Check out the following link to find the right icon for the new menu entry. In the screenshot from above, I used "fa fa-battery-three-quarters".
  • Menu icon type: Select from the dropdown box the "Fontawesome icon" option.
  • Menu link: Find the URL of the option you wish to link the entry to, and copy everything after the website name (admin/labels/sa/view in our case):


Click the create button to verify that the new survey menu entry was added:



Check the survey menu to verify that the survey menu entry is functional:



  Attention : Do not forget to check the LimeSurvey installation permissions to see which users can access and edit label sets. For more details, check the following wiki section.


Advanced options - menu entries

When creating or editing a menu entry, you may find in the lower right part of the dialog the Toggle advanced options button. The following extra fields will be shown once you click it:

  • Action
  • Template
  • Partial
  • Classes
  • Data
  • Get data method
  • Language

Once the edits are done, do not forget to click Save.


Retrieved from "http://manual.limesurvey.org/index.php?title=Menu_entries_configuration&oldid=164069"