Global settings - Revision history

Fabiorosa at 22:29, 27 May 2026

2026-05-27T22:29:46Z

← Older revision		Revision as of 00:29, 28 May 2026
Line 105:		Line 105:
	**''Plugin'': Using this you can select a custom email plugin to use.		**''Plugin'': Using this you can select a custom email plugin to use.
	</translate><translate>		</translate><translate>

	<!--T:28-->		<!--T:28-->
	*'''SMTP host''': If you use 'SMTP' as email method, then you have to put your SMTP server here. If you are using a different port than port 25 (standard for SMTP), then you have to add the port number separated be a colon (example: 'smtp.gmail.com:465')		*'''SMTP host''': If you use 'SMTP' as email method, then you have to put your SMTP server here. If you are using a different port than port 25 (standard for SMTP), then you have to add the port number separated be a colon (example: 'smtp.gmail.com:465')

C schmitz: Updated documentantion for new time zone

2026-05-27T09:27:17Z

Updated documentantion for new time zone

← Older revision		Revision as of 11:27, 27 May 2026
Line 47:		Line 47:
	*'''Create example question group and question''': This setting specifies if an example question group and question should be created automatically after creating a new survey.		*'''Create example question group and question''': This setting specifies if an example question group and question should be created automatically after creating a new survey.
	*'''Administration template''': This setting specifies the default design template used for the LimeSurvey administration. To use a customized template, add it in '/limesurvey/upload/admintheme/'		*'''Administration template''': This setting specifies the default design template used for the LimeSurvey administration. To use a customized template, add it in '/limesurvey/upload/admintheme/'
	*'''~~Time difference (in hours)~~''': ~~If your web server~~ is in ~~a different time zone to the location where your~~ surveys ~~will be based~~, ~~put the difference between your server~~ and ~~your home time zone here. For example, I live in Australia, but I got a US web server. The web server is 14 hours behind my local time zone. So, my setting here~~ is ~~"+14"~~. In ~~other words, it adds 14 hours to~~ the time ~~of the web server. This setting is particularly important when surveys timestamp the responses~~.		*'''Default time zone:''': Determines what time zone is used for displaying dates and times in surveys, and it is used for new administration users. In the personal user settings each user can set their own time zone.

	<!--T:36-->		<!--T:36-->

Han: Marked this version for translation

2025-08-05T19:31:19Z

Marked this version for translation

Show changes

Tibor.pacalat: added breadcrumb mode description

2025-04-08T11:59:46Z

added breadcrumb mode description

← Older revision		Revision as of 13:59, 8 April 2025
Line 84:		Line 84:
	<!--T:42-->		<!--T:42-->
	*'''Template editor''': Choose 'Full template editor' to get an enhanced editor (with syntax-highlighting) when editing survey templates and 'Simple template editor' to get a plain editor field		*'''Template editor''': Choose 'Full template editor' to get an enhanced editor (with syntax-highlighting) when editing survey templates and 'Simple template editor' to get a plain editor field

			<!--T:46-->
			*'''Default breadcrumb mode''': Choose between defaulting to short or long breadcrumb representation. Short is the common breadcrumb representation, and long variant provides additional information (survey id, group id, question id).

	<!--T:21-->		<!--T:21-->

Marcolombardo: Add Storage section to the page.

2025-01-31T15:21:34Z

Add Storage section to the page.

← Older revision		Revision as of 17:21, 31 January 2025
Line 208:		Line 208:
	<!--T:24-->		<!--T:24-->
	<div class='simplebox'>[[File:help.png]] '''Note:''' Please note that the remote control functionality is generally used by developers to access LimeSurvey from other applications (in this way, you are not restricted only to PHP). It is only recommended for advanced users. For more details on its usage, check the following [[RemoteControl 2 API\|wiki section]] or join the [https://www.limesurvey.org/community/forums LimeSurvey forums].</div>		<div class='simplebox'>[[File:help.png]] '''Note:''' Please note that the remote control functionality is generally used by developers to access LimeSurvey from other applications (in this way, you are not restricted only to PHP). It is only recommended for advanced users. For more details on its usage, check the following [[RemoteControl 2 API\|wiki section]] or join the [https://www.limesurvey.org/community/forums LimeSurvey forums].</div>

			==Storage== <!--T:45-->
			The '''Storage''' settings in LimeSurvey's Global Settings allow administrators to manage file storage and database export limits.

			* '''Calculate storage''' – This button recalculates the total storage used by all uploaded files in LimeSurvey. Depending on the number of files, this process may take some time.
			* '''Overwrite files with the same name''' – When enabled, files with the same name will be overwritten if uploaded, moved, or copied through the file manager. By default, this setting is disabled to prevent accidental data loss.
			* '''Set limit in megabytes for direct download of the database''' – This option sets the maximum file size (in MB) for direct database downloads. The recommended value is '''256 MB''', but a lower limit can be set if needed. A higher value may lead to performance issues, depending on the system configuration.

			These settings help manage file storage, prevent unnecessary duplicates, and optimize database downloads in LimeSurvey.

	</translate>		</translate>

C schmitz: Marked this version for translation

2024-03-08T15:15:52Z

Marked this version for translation

← Older revision		Revision as of 17:15, 8 March 2024
Line 117:		Line 117:
	</translate>		</translate>
	<translate>		<translate>
			<!--T:43-->
	* '''Email plugin''': If you choose 'Plugin' as sending method you can set here which plugin should be used. Currently there are two bundled email plugins in LimeSurvey. If the plugin cannot be found, check if it is activated.		* '''Email plugin''': If you choose 'Plugin' as sending method you can set here which plugin should be used. Currently there are two bundled email plugins in LimeSurvey. If the plugin cannot be found, check if it is activated.
	**'''[[AzureOAuthSMTP_Plugin\|AzureOAuthSMTP]]''': Use this to send emails using Azure/Microsoft and OAuth over SMTP		**'''[[AzureOAuthSMTP_Plugin\|AzureOAuthSMTP]]''': Use this to send emails using Azure/Microsoft and OAuth over SMTP
Line 125:		Line 126:
	</translate>		</translate>
	<translate>		<translate>
			<!--T:44-->
	* '''Email sending rate''': This setting determines the number of seconds until the next batch is automatically sent in the interface.		* '''Email sending rate''': This setting determines the number of seconds until the next batch is automatically sent in the interface.

C schmitz: Added information on email plugins

2024-03-08T15:15:09Z

Added information on email plugins

← Older revision		Revision as of 17:15, 8 March 2024
Line 97:		Line 97:
	***Make sure that you are using your SMTP configured email (Global settings ⇒ Email settings) if you use SMTP; otherwise there might be a chance that the following error is displayed: 'SMTP -> ERROR: RCPT not accepted from server: 553 5.7.1 : Sender address rejected: not owned by user'		***Make sure that you are using your SMTP configured email (Global settings ⇒ Email settings) if you use SMTP; otherwise there might be a chance that the following error is displayed: 'SMTP -> ERROR: RCPT not accepted from server: 553 5.7.1 : Sender address rejected: not owned by user'
	**''Qmail'': Set this if you are running the Qmail mailer		**''Qmail'': Set this if you are running the Qmail mailer
			**''Plugin'': Using this you can select a custom email plugin to use.
	</translate><translate>		</translate><translate>
	<!--T:28-->		<!--T:28-->
Line 114:		Line 115:
	**''Always'': It provides valuable information on how an SMTP relay works. If an error occurs, further details are provided		**''Always'': It provides valuable information on how an SMTP relay works. If an error occurs, further details are provided
	{{Note\|Debug part is shown when [[Survey_participants#Send_email_invitation\|sending email to participant]].}}		{{Note\|Debug part is shown when [[Survey_participants#Send_email_invitation\|sending email to participant]].}}
			</translate>
			<translate>
			* '''Email plugin''': If you choose 'Plugin' as sending method you can set here which plugin should be used. Currently there are two bundled email plugins in LimeSurvey. If the plugin cannot be found, check if it is activated.
			**'''[[AzureOAuthSMTP_Plugin\|AzureOAuthSMTP]]''': Use this to send emails using Azure/Microsoft and OAuth over SMTP
			**'''GoogleOAuthSMTP''': Use this to send emails using google and OAuth over SMTP
	</translate><translate>		</translate><translate>
	<!--T:30-->		<!--T:30-->
	*'''Email batch size''': When sending invitations or reminders to survey participants, this setting helps the administrator determine how many emails can be sent in one bunch. Different web servers have different email capacities, and if your script takes too long to send many emails, the script could time out and cause errors. Most web servers can send 100 emails in one go within the default 30 second time limit for a PHP script. If you get script timeout errors when sending large numbers of emails, reduce the email batch size using this setting. Clicking the 'send email invitation' button that is located on the survey participant toolbar sends one batch of invitations, displaying a list of the addresses to which the email was already delivered and a warning that ''"There are more emails pending than could be sent in one batch. Continue sending emails by clicking below. There are ### emails still to be sent."'' and provides a "Continue" button to proceed with the next batch. So, the user determines when to send the next batch after each batch gets emailed. It is not necessary to wait with this screen active. The admin could log off and come back at a later time to send the next batch of invitations.		*'''Email batch size''': When sending invitations or reminders to survey participants, this setting helps the administrator determine how many emails can be sent in one bunch. Different web servers have different email capacities, and if your script takes too long to send many emails, the script could time out and cause errors. Most web servers can send 100 emails in one go within the default 30 second time limit for a PHP script. If you get script timeout errors when sending large numbers of emails, reduce the email batch size using this setting. Clicking the 'send email invitation' button that is located on the survey participant toolbar sends one batch of invitations, displaying a list of the addresses to which the email was already delivered and a warning that ''"There are more emails pending than could be sent in one batch. Continue sending emails by clicking below. There are ### emails still to be sent."'' and provides a "Continue" button to proceed with the next batch. So, the user determines when to send the next batch after each batch gets emailed. It is not necessary to wait with this screen active. The admin could log off and come back at a later time to send the next batch of invitations.
			</translate>
			<translate>
			* '''Email sending rate''': This setting determines the number of seconds until the next batch is automatically sent in the interface.

	==Bounce settings== <!--T:8-->		==Bounce settings== <!--T:8-->

DenisChenu: ome server configuration restrict iframe embedded by default.

2023-11-28T09:58:50Z

ome server configuration restrict iframe embedded by default.

← Older revision		Revision as of 11:58, 28 November 2023
Line 141:		Line 141:
	{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}		{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}
	{{Hint\|Text=When set to Same Origin : LimeSurvey add header<code>X-Frame-Options: SAMEORIGIN</code>, else LimeSurvey don't add any X-Frame-Options. You can restrict yourself X-Frame-Options with server settings. [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options More information on X-Frame-Options] }}		{{Hint\|Text=When set to Same Origin : LimeSurvey add header<code>X-Frame-Options: SAMEORIGIN</code>, else LimeSurvey don't add any X-Frame-Options. You can restrict yourself X-Frame-Options with server settings. [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options More information on X-Frame-Options] }}
	{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not.}}		{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not. Some server configuration restrict iframe embedded by default. }}
	*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS		*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS
	{{Alert\|title=Attention\|text=If your server doesn't support HTTPS properly, you can lock yourself from the system! Therefore, click on the '''"check if this link works"''' located below the option. If the link does not work and you turn on HTTPS, LimeSurvey will break and you won't be able to access it.}}		{{Alert\|title=Attention\|text=If your server doesn't support HTTPS properly, you can lock yourself from the system! Therefore, click on the '''"check if this link works"''' located below the option. If the link does not work and you turn on HTTPS, LimeSurvey will break and you won't be able to access it.}}

DenisChenu: Add hint about X-Frame-Options

2023-11-28T09:56:55Z

Add hint about X-Frame-Options

← Older revision		Revision as of 11:56, 28 November 2023
Line 140:		Line 140:
	*'''IFrame embedding allowed''': This option can be used to indicate whether a browser should be allowed to render the survey page in a <frame>, <iframe> or <object>. You can use this to avoid clickjacking attacks, by ensuring that your survey is not embedded into other sites. If you set it to 'Allow' (the default value), there is no restriction. Setting this to 'Same origin' will make the content to be loaded only if the survey runs on the same domain and port as the including <frame>, <iframe> or <object>		*'''IFrame embedding allowed''': This option can be used to indicate whether a browser should be allowed to render the survey page in a <frame>, <iframe> or <object>. You can use this to avoid clickjacking attacks, by ensuring that your survey is not embedded into other sites. If you set it to 'Allow' (the default value), there is no restriction. Setting this to 'Same origin' will make the content to be loaded only if the survey runs on the same domain and port as the including <frame>, <iframe> or <object>
	{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}		{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}
			{{Hint\|Text=When set to Same Origin : LimeSurvey add header<code>X-Frame-Options: SAMEORIGIN</code>, else LimeSurvey don't add any X-Frame-Options. You can restrict yourself X-Frame-Options with server settings. [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options More information on X-Frame-Options] }}
	{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not.}}		{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not.}}
	*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS		*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS

DenisChenu: Marked this version for translation

2023-11-08T09:16:08Z

Marked this version for translation

← Older revision		Revision as of 11:16, 8 November 2023
Line 70:		Line 70:
	*'''Side-menu behavior'''{{ObsoleteIn\|3.0}}: How the side-menu should behave while editing surveys. The default value is 'Adaptive', meaning that the side-menu can be changed when and how the users want. The other values are 'Always open' and 'Always closed'		*'''Side-menu behavior'''{{ObsoleteIn\|3.0}}: How the side-menu should behave while editing surveys. The default value is 'Adaptive', meaning that the side-menu can be changed when and how the users want. The other values are 'Always open' and 'Always closed'

			<!--T:39-->
	* '''Clear assets cache:''' Reset the css and js assets url, be sure to have all new css and js file updated.		* '''Clear assets cache:''' Reset the css and js assets url, be sure to have all new css and js file updated.

			<!--T:40-->
	*'''Default HTML editor mode:''' Sets the default mode for integrated HTML editor. The valid settings are:		*'''Default HTML editor mode:''' Sets the default mode for integrated HTML editor. The valid settings are:
	** ''inline'' (default): Inline replacement of fields by an HTML editor. Slow, but convenient and user-friendly		** ''inline'' (default): Inline replacement of fields by an HTML editor. Slow, but convenient and user-friendly
Line 77:		Line 79:
	** ''HTML source'' : No HTML editor used, just the plain HTML source		** ''HTML source'' : No HTML editor used, just the plain HTML source

			<!--T:41-->
	*'''Question type selector''': Choose 'Full selector' to get a question type selector with preview and 'Simple' to get a plain select box		*'''Question type selector''': Choose 'Full selector' to get a question type selector with preview and 'Simple' to get a plain select box

			<!--T:42-->
	*'''Template editor''': Choose 'Full template editor' to get an enhanced editor (with syntax-highlighting) when editing survey templates and 'Simple template editor' to get a plain editor field		*'''Template editor''': Choose 'Full template editor' to get an enhanced editor (with syntax-highlighting) when editing survey templates and 'Simple template editor' to get a plain editor field

← Older revision		Revision as of 11:58, 28 November 2023
Line 141:		Line 141:
	{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}		{{Alert\|title=Attention\|text=You need to update config.php file to really allow cookies to be used in iframe. See [[Optional_settings#Allow_usage_of_session_and_Csrf_Validation_in_iFrame_.28New_in_3.24.3_.29\|Allow usage of session and CSRF Validation in iFrame]]}}
	{{Hint\|Text=When set to Same Origin : LimeSurvey add header<code>X-Frame-Options: SAMEORIGIN</code>, else LimeSurvey don't add any X-Frame-Options. You can restrict yourself X-Frame-Options with server settings. [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options More information on X-Frame-Options] }}		{{Hint\|Text=When set to Same Origin : LimeSurvey add header<code>X-Frame-Options: SAMEORIGIN</code>, else LimeSurvey don't add any X-Frame-Options. You can restrict yourself X-Frame-Options with server settings. [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options More information on X-Frame-Options] }}
	{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not.}}		{{Hint\|Text=Theoretically, it is working. However, this function might not work when it is enabled because it heavily depends on the used web browser and whether it allows iframes or not. Some server configuration restrict iframe embedded by default. }}
	*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS		*'''Force HTTPS''': This is set by default to "Don't force on/off". Switch the setting to "On" to force the connection to use HTTPS
	{{Alert\|title=Attention\|text=If your server doesn't support HTTPS properly, you can lock yourself from the system! Therefore, click on the '''"check if this link works"''' located below the option. If the link does not work and you turn on HTTPS, LimeSurvey will break and you won't be able to access it.}}		{{Alert\|title=Attention\|text=If your server doesn't support HTTPS properly, you can lock yourself from the system! Therefore, click on the '''"check if this link works"''' located below the option. If the link does not work and you turn on HTTPS, LimeSurvey will break and you won't be able to access it.}}