Major version upgrade - Revision history

Han: Marked this version for translation

2025-08-12T14:26:52Z

Marked this version for translation

← Older revision		Revision as of 16:26, 12 August 2025
Line 5:		Line 5:
	__TOC__		__TOC__

	~~=Notes for specific LimeSurvey versions=~~ <!--T:2-->		<!--T:2-->
			=Notes for specific LimeSurvey versions=
	==LimeSurvey 6==		==LimeSurvey 6==
	We updated LimeSurvey with a new design, which also includes an upgrade to the Bootstrap version being used for the admin- and surveytheme from Bootstrap 3 to 5. <br>		We updated LimeSurvey with a new design, which also includes an upgrade to the Bootstrap version being used for the admin- and surveytheme from Bootstrap 3 to 5. <br>
	After this upgrade, all custom survey themes will be uninstalled and reset to use our new default theme "Fruity TwentyThree", this also affects extended themes. Admin themes will be reset to the already existing "sea_green" theme which has been updated as well.		After this upgrade, all custom survey themes will be uninstalled and reset to use our new default theme "Fruity TwentyThree", this also affects extended themes. Admin themes will be reset to the already existing "sea_green" theme which has been updated as well.

	=How to prepare for a major version upgrade= ~~<!--T:3-->~~		<!--T:3-->
			=How to prepare for a major version upgrade=
	To be on the safe side when performing an upgrade and be able to continue surveys with the least amount of interruption, we recommend first testing all your customized code on the new version of LimeSurvey you want to upgrade to.<br>		To be on the safe side when performing an upgrade and be able to continue surveys with the least amount of interruption, we recommend first testing all your customized code on the new version of LimeSurvey you want to upgrade to.<br>
	This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>		This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>
Line 19:		Line 21:


	~~==Custom survey themes==~~ <!--T:4-->		<!--T:4-->
			==Custom survey themes==
	All custom survey themes (this includes extended themes) will be uninstalled and the theme options in the global, group and survey settings will be reset to the new default.		All custom survey themes (this includes extended themes) will be uninstalled and the theme options in the global, group and survey settings will be reset to the new default.

Line 32:		Line 35:
	# Now you can delete the old survey theme and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.		# Now you can delete the old survey theme and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.

	~~==Custom admin themes==~~ <!--T:6-->		<!--T:6-->
			==Custom admin themes==
	All custom admin themes will be uninstalled and the new default will be used.		All custom admin themes will be uninstalled and the new default will be used.

Line 48:		Line 52:
	Please contact our support.		Please contact our support.

	~~==Custom question themes==~~ <!--T:9-->		<!--T:9-->
			==Custom question themes==
	Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.		Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.
	More information about question themes can be found here [[Question_themes\|Question themes]]. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.		More information about question themes can be found here [[Question_themes\|Question themes]]. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.
Line 64:		Line 69:
	Try to see if an update is available from the website or developer that provided it		Try to see if an update is available from the website or developer that provided it

	~~==Custom plugins==~~ <!--T:12-->		<!--T:12-->
			==Custom plugins==
	Custom plugins that do not match the current version will be deactivated during the upgrade process.		Custom plugins that do not match the current version will be deactivated during the upgrade process.

C schmitz: Text replacement - "https://manual.limesurvey.org/Question_themes" to "Question themes"

2024-10-15T08:28:27Z

Text replacement - "https://manual.limesurvey.org/Question_themes" to "Question themes"

← Older revision		Revision as of 10:28, 15 October 2024
Line 50:		Line 50:
	==Custom question themes== <!--T:9-->		==Custom question themes== <!--T:9-->
	Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.		Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.
	More information about question themes can be found here ~~https://manual.limesurvey.org/~~Question_themes. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.		More information about question themes can be found here [[Question_themes\|Question themes]]. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.

	<!--T:10-->		<!--T:10-->

P teichmann at 08:27, 14 September 2023

2023-09-14T08:27:08Z

← Older revision		Revision as of 10:27, 14 September 2023
Line 50:		Line 50:
	==Custom question themes== <!--T:9-->		==Custom question themes== <!--T:9-->
	Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.		Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.
	More information about question themes can be found here https://manual.limesurvey.org/Question_themes. Custom JavaScript inserted will likely not work anymore as well.		More information about question themes can be found here https://manual.limesurvey.org/Question_themes. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.

	<!--T:10-->		<!--T:10-->

P teichmann at 08:26, 14 September 2023

2023-09-14T08:26:23Z

← Older revision		Revision as of 10:26, 14 September 2023
Line 50:		Line 50:
	==Custom question themes== <!--T:9-->		==Custom question themes== <!--T:9-->
	Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.		Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.
	More information about question themes can be found here https://manual.limesurvey.org/Question_themes		More information about question themes can be found here https://manual.limesurvey.org/Question_themes. Custom JavaScript inserted will likely not work anymore as well.

	<!--T:10-->		<!--T:10-->

C schmitz: Fixed spelling mistakes

2023-09-13T13:11:28Z

Fixed spelling mistakes

← Older revision		Revision as of 15:11, 13 September 2023
Line 11:		Line 11:

	=How to prepare for a major version upgrade= <!--T:3-->		=How to prepare for a major version upgrade= <!--T:3-->
	To be on ~~save~~ side when performing an upgrade and be able to continue surveys with the least amount of interruption we ~~reccommend~~ first testing all your customized code on the new version of LimeSurvey ~~oyu wnat~~ to upgrade to.<br>		To be on the safe side when performing an upgrade and be able to continue surveys with the least amount of interruption, we recommend first testing all your customized code on the new version of LimeSurvey you want to upgrade to.<br>
	This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>		This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>
	''https://www.limesurvey.org/'' <br>		''https://www.limesurvey.org/'' <br>
Line 28:		Line 28:
	# Import it into the new application		# Import it into the new application
	# Check the code you customized for the survey theme and update it in accordance with the new version of the application you want to use.		# Check the code you customized for the survey theme and update it in accordance with the new version of the application you want to use.
	# Export your updated customized ~~surveytheme~~ from the new application		# Export your updated customized survey theme from the new application
	# After upgrading your old application to the new version, the current survey themes will be uninstalled and marked as incompatible.		# After upgrading your old application to the new version, the current survey themes will be uninstalled and marked as incompatible.
	# Now you can delete the old ~~surveytheme~~ and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.		# Now you can delete the old survey theme and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.

	==Custom admin themes== <!--T:6-->		==Custom admin themes== <!--T:6-->
Line 36:		Line 36:

	<!--T:7-->		<!--T:7-->
	<b>for self hosted application:</b>		<b>for self-hosted application:</b>
	# Before copying the admin theme to the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Admin_themes''		# Before copying the admin theme to the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Admin_themes''
	# Copy the existing admin theme from the old application to the new application ''https://manual.limesurvey.org/Custom_Admin_Themes''		# Copy the existing admin theme from the old application to the new application ''https://manual.limesurvey.org/Custom_Admin_Themes''
Line 42:		Line 42:
	# After upgrading your old application, our new admin theme is displayed by default. To update your previously installed admin theme, either:		# After upgrading your old application, our new admin theme is displayed by default. To update your previously installed admin theme, either:
	#* Manually update the code of the admin theme currently marked as incompatible		#* Manually update the code of the admin theme currently marked as incompatible
	#* Delete the old admin theme and install the new one you previously updated in your test environment		#* Delete the old admin theme and install the new one you previously updated in your test environment.

	<!--T:8-->		<!--T:8-->
Line 53:		Line 53:

	<!--T:10-->		<!--T:10-->
	<b>Upgrading your ~~own~~ question theme:</b>		<b>Upgrading your customized question theme:</b>
	# Download the question theme from a website or export the current question theme		# Download the question theme from a website or export the current question theme
	# Before uploading, make sure the compatibility of your custom question theme is set correctly https://manual.limesurvey.org/Extension_compatibility#Question_themes		# Before uploading, make sure the compatibility of your custom question theme is set correctly https://manual.limesurvey.org/Extension_compatibility#Question_themes
	# Try to upload your question theme into the new application.		# Try to upload your question theme into the new application.
	# If it is ~~your own~~ question theme, make the necessary adjustments		# If it is a self-created question theme, make the necessary adjustments
	# ~~after~~ successfully uploading, please check if the question theme is displayed and working as expected.		# After successfully uploading, please check if the question theme is displayed and working as expected.

	<!--T:11-->		<!--T:11-->
Line 68:		Line 68:

	<!--T:13-->		<!--T:13-->
	<b>for self hosted application:</b>		<b>for self-hosted application:</b>
	# Check if the plugin can be installed on the new version.		# Check if the plugin can be installed on the new version.
	# Update the plugin or contact the plugin author to update the plugin.		# Update the plugin or contact the plugin author to update the plugin.

C schmitz: Marked this version for translation

2023-09-13T13:07:58Z

Marked this version for translation

← Older revision		Revision as of 15:07, 13 September 2023
Line 5:		Line 5:
	__TOC__		__TOC__

	=Notes for specific LimeSurvey versions=<!--T:2-->		=Notes for specific LimeSurvey versions= <!--T:2-->
	==LimeSurvey 6==		==LimeSurvey 6==
	We updated LimeSurvey with a new design, which also includes an upgrade to the Bootstrap version being used for the admin- and surveytheme from Bootstrap 3 to 5. <br>		We updated LimeSurvey with a new design, which also includes an upgrade to the Bootstrap version being used for the admin- and surveytheme from Bootstrap 3 to 5. <br>
	After this upgrade, all custom survey themes will be uninstalled and reset to use our new default theme "Fruity TwentyThree", this also affects extended themes. Admin themes will be reset to the already existing "sea_green" theme which has been updated as well.		After this upgrade, all custom survey themes will be uninstalled and reset to use our new default theme "Fruity TwentyThree", this also affects extended themes. Admin themes will be reset to the already existing "sea_green" theme which has been updated as well.

	=How to prepare for a major version upgrade=<!--T:3-->		=How to prepare for a major version upgrade= <!--T:3-->
	To be on save side when performing an upgrade and be able to continue surveys with the least amount of interruption we reccommend first testing all your customized code on the new version of LimeSurvey oyu wnat to upgrade to.<br>		To be on save side when performing an upgrade and be able to continue surveys with the least amount of interruption we reccommend first testing all your customized code on the new version of LimeSurvey oyu wnat to upgrade to.<br>
	This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>		This will require you to create a new application to test on, you can either create one through our cloud hosting:<br>
Line 19:		Line 19:


	==Custom survey themes==		==Custom survey themes== <!--T:4-->
	All custom survey themes (this includes extended themes) will be uninstalled and the theme options in the global, group and survey settings will be reset to the new default.		All custom survey themes (this includes extended themes) will be uninstalled and the theme options in the global, group and survey settings will be reset to the new default.

			<!--T:5-->
	<b>Upgrade Strategy:</b>		<b>Upgrade Strategy:</b>
	# Export the survey theme from the old application		# Export the survey theme from the old application
Line 31:		Line 32:
	# Now you can delete the old surveytheme and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.		# Now you can delete the old surveytheme and import the new survey theme which you updated. Please ensure you have a backup of the deleted theme.

	==Custom admin themes==		==Custom admin themes== <!--T:6-->
	All custom admin themes will be uninstalled and the new default will be used.		All custom admin themes will be uninstalled and the new default will be used.

			<!--T:7-->
	<b>for self hosted application:</b>		<b>for self hosted application:</b>
	# Before copying the admin theme to the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Admin_themes''		# Before copying the admin theme to the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Admin_themes''
Line 42:		Line 44:
	#* Delete the old admin theme and install the new one you previously updated in your test environment		#* Delete the old admin theme and install the new one you previously updated in your test environment

			<!--T:8-->
	<b>for Cloud users:</b><br>		<b>for Cloud users:</b><br>
	Please contact our support.		Please contact our support.

	==Custom question themes==		==Custom question themes== <!--T:9-->
	Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.		Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade.
	More information about question themes can be found here https://manual.limesurvey.org/Question_themes		More information about question themes can be found here https://manual.limesurvey.org/Question_themes

			<!--T:10-->
	<b>Upgrading your own question theme:</b>		<b>Upgrading your own question theme:</b>
	# Download the question theme from a website or export the current question theme		# Download the question theme from a website or export the current question theme
Line 56:		Line 60:
	# after successfully uploading, please check if the question theme is displayed and working as expected.		# after successfully uploading, please check if the question theme is displayed and working as expected.

			<!--T:11-->
	<b>Upgrading a theme you do not own:</b><br>		<b>Upgrading a theme you do not own:</b><br>
	Try to see if an update is available from the website or developer that provided it		Try to see if an update is available from the website or developer that provided it

	==Custom plugins==		==Custom plugins== <!--T:12-->
	Custom plugins that do not match the current version will be deactivated during the upgrade process.		Custom plugins that do not match the current version will be deactivated during the upgrade process.

			<!--T:13-->
	<b>for self hosted application:</b>		<b>for self hosted application:</b>
	# Check if the plugin can be installed on the new version.		# Check if the plugin can be installed on the new version.
Line 67:		Line 73:
	# Manually override the plugin with new files in your application which will preserve settings or uninstall the old version and reinstall the new version, in that case all settings will be reentered.		# Manually override the plugin with new files in your application which will preserve settings or uninstall the old version and reinstall the new version, in that case all settings will be reentered.

			<!--T:14-->
	<b>for Cloud users:</b>		<b>for Cloud users:</b>
	# Check if the plugin can be installed on the new version.		# Check if the plugin can be installed on the new version.

P teichmann: /* Custom survey themes */

2023-08-25T09:26:49Z

Custom survey themes

← Older revision		Revision as of 11:26, 25 August 2023
Line 20:		Line 20:

	==Custom survey themes==		==Custom survey themes==
	All custom survey themes (this includes extended themes) will be uninstalled and the theme options ~~configured~~ will be reset to the default.		All custom survey themes (this includes extended themes) will be uninstalled and the theme options in the global, group and survey settings will be reset to the new default.

	<b>Upgrade Strategy:</b>		<b>Upgrade Strategy:</b>

P teichmann: /* Custom plugins */

2023-08-25T09:23:57Z

Custom plugins

← Older revision		Revision as of 11:23, 25 August 2023
Line 60:		Line 60:

	==Custom plugins==		==Custom plugins==
	Custom plugins that do not match the current version ~~cannot be activated or installed, but~~ will ~~still~~ be ~~active after~~ the upgrade~~. It should be checked if they are still working as expected and be updated if possible~~.		Custom plugins that do not match the current version will be deactivated during the upgrade process.

	<b>for self hosted application:</b>		<b>for self hosted application:</b>
	# Check if the plugin can be installed on the new version.		# Check if the plugin can be installed on the new version.
	# Update the plugin or contact the plugin author to update the plugin.		# Update the plugin or contact the plugin author to update the plugin.
	# Manually override the plugin with new files in your application or uninstall the old version and reinstall the new version (all settings will be ~~lost and have to be reapplied)~~		# Manually override the plugin with new files in your application which will preserve settings or uninstall the old version and reinstall the new version, in that case all settings will be reentered.

	<b>for Cloud users~~(enterprise and above)~~:</b>		<b>for Cloud users:</b>
	# Check if the plugin can be installed on the new version.		# Check if the plugin can be installed on the new version.
	# Update the plugin or contact the plugin author to update the plugin.		# Update the plugin code or contact the plugin author to update the plugin.
	# ~~Contact support to make an update to the plugin without loosing configuration data or uninstall~~ the old version and reinstall the new version (all settings will be lost and have to be reapplied)		# Installation options:
			#* Uninstall the old version and reinstall the new version (all settings will be lost and have to be reapplied)
			#* Contact support to make an update to the plugin without loosing configuration data


	</translate>		</translate>

P teichmann: /* Custom admin themes */

2023-08-25T09:11:36Z

Custom admin themes

← Older revision		Revision as of 11:11, 25 August 2023
Line 38:		Line 38:
	# Copy the existing admin theme from the old application to the new application ''https://manual.limesurvey.org/Custom_Admin_Themes''		# Copy the existing admin theme from the old application to the new application ''https://manual.limesurvey.org/Custom_Admin_Themes''
	# Check the code you customized for the admin theme and update it in accordance with the new version of the application you want to use.		# Check the code you customized for the admin theme and update it in accordance with the new version of the application you want to use.
	# After upgrading your old application, ~~by default~~ our new admin theme is ~~now~~ displayed. To update your previously installed admin theme, either:		# After upgrading your old application, our new admin theme is displayed by default. To update your previously installed admin theme, either:
	#* ~~manually~~ update the code of the currently marked as incompatible ~~admin theme~~		#* Manually update the code of the admin theme currently marked as incompatible
	#* ~~delete~~ the old admin theme and install the new one you previously updated in your test environment		#* Delete the old admin theme and install the new one you previously updated in your test environment

	<b>for Cloud users:</b><br>		<b>for Cloud users:</b><br>

P teichmann: /* Custom survey themes */

2023-08-25T09:10:05Z

Custom survey themes

← Older revision		Revision as of 11:10, 25 August 2023
Line 25:		Line 25:
	# Export the survey theme from the old application		# Export the survey theme from the old application
	# Before importing it into the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Survey_themes''		# Before importing it into the new application, make sure the compatibility tag is set correctly: ''https://manual.limesurvey.org/Extension_compatibility#Survey_themes''
	# Import into the new application		# Import it into the new application
	# Check the code you customized for the survey theme and update it in accordance with the new version of the application you want to use.		# Check the code you customized for the survey theme and update it in accordance with the new version of the application you want to use.
	# Export your updated customized surveytheme from the new application		# Export your updated customized surveytheme from the new application