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 ^{(New in 3.0 )}: 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 ^{(Obsolete since 3.0)}: 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 ^{(New in 3.0 )}: 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. They are the survey users defined in the User Control panel
  • Nobody : Nobody can see those boxes. It can be used when you would like, for example, to hide boxes from a specific user group
  • 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 later edited by clicking on the green pen button located on the last column of the Boxes table.

Check the example provided below to better understand this functionality.

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 in 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:

The destination URL can be found in the address bar. In this example, the URL leads to the General settings of a survey:

• 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, re-check its destionation URL):