Home page settings

=General= The home page settings page allows every user to tweak its settings according to his or her needs. The button can be accessed from Configuration->Home page settings (located under the Settings tab):

Besides editing home page settings, new boxes (for different user groups) can be created in order to facilitate the management of your LimeSurvey installation.

=Home page settings=

The following home page settings are available:




 * Display logo: If it is turned 'Off', the logo situated above the boxes disappears (the default value is 'On')
 * Show last visited survey and question: It is turned 'On' by default. It shows the last visited question and survey, the bar being located between the logo and the boxes
 * Show survey list: The default value is 'Off'. If you switch it to 'On', a survey list will appear below the boxes from the home page
 * Show search box on survey list: If it is ticked 'Off', the search box will not be shown in the survey list. Please note that this option does not have any effect on your home page if the Show survey list option is not turned on
 * Wrap container around Boxes: If it is turned 'On', the container around each box gets smaller (useful function when more boxes are added to your home page)
 * Boxes by row: The number of boxes you would like to have on each row. The default number is '3'
 * Box offset: Box offset is a function that helps users center the boxes. For example, if you use 15 boxes, you can use the box offset function in order to better arrange them into your home page. This function does not exist anymore in LimeSurvey 3.0 (and the later versions) because the boxes are automatically centered
 * Box orientation: Three options are available: left to right, right to left, centered

Click on Save boxes settings once you are done. If everything is turned on, the home page should look like this:

=Boxes=

The LimeSurvey installation comes by default with six boxes created: Create survey, List survey, Global settings, ComfortUpdate, Label sets and Templates. They can be either edited (the green pen button) or deleted (the red trash button):



Create/Edit a box
In order to add a new box into the Boxes table, click on Create a new box, located in the upper part of the screen: .

Different fields have to be filled in:


 * Position: shows the box position (it is a numerical value)
 * Destination URL: the link via which the respective option/function is accessed. For example, the destination URL to backup the entire database is admin/dumpdb
 * Title: name of the box
 * Icon: allows the user to select one of the LimeSurvey predefined icons
 * Description: short description of the purpose of the box
 * Display this box to: allows you to choose who can see the respective box
 * Only admin : only the super administrator of the LimeSurvey installation can see those respective boxes
 * Everybody : everyone who logs in the LimeSurvey installation can see those respective boxes, i.e. survey users defined in the User Control panel
 * Nobody : nobody can see those boxes. It can be used when you would like to hide boxes from a specific user group for example
 * Other user groups : a certain user group is allowed to see those boxes. To find out more about user groups, read our wiki on how to manage them

Once done, click on the Save button that is located in the upper right part of the screen.

The fields of a box can be edited later by clicking on the green pen button located in the last column of the Boxes table.

Reset to the default settings
If you did too many changes or you broke up some of the default boxes' functionalities, click on the Reset to default boxes button, located on the upper right side of the window. This would restore the default boxes.



=Examples=

I want to create a new box

 * Access Home page settings from the Configuration dialog.
 * Click on Create new box, located in the upper right part of the window.
 * Enter the requested information


 * Save the box and access the home page of your LimeSurvey installation.


 * Click on the newly created box and check whether it is working or not (if not, recheck its destionation URL):