Major version upgrade/en - Revision history

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

2024-10-15T08:28:07Z

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

← Older revision		Revision as of 10:28, 15 October 2024
Line 45:		Line 45:
	==Custom question themes==		==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 ~~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.

	<b>Upgrading your customized question theme:</b>		<b>Upgrading your customized question theme:</b>

FuzzyBot: Updating to match new version of source page

2024-04-02T15:06:19Z

Updating to match new version of source page

← Older revision		Revision as of 17:06, 2 April 2024
Line 45:		Line 45:
	==Custom question themes==		==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 https://manual.limesurvey.org/Question_themes		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.

	<b>Upgrading your customized question theme:</b>		<b>Upgrading your customized question theme:</b>

FuzzyBot: Updating to match new version of source page

2023-09-13T13:13:21Z

Updating to match new version of source page

FuzzyBot: Updating to match new version of source page

2023-09-13T13:08:25Z

Updating to match new version of source page

New page

<languages />

__TOC__

=Notes for specific LimeSurvey versions=
==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. 
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=
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. 
This will require you to create a new application to test on, you can either create one through our cloud hosting: 
''https://www.limesurvey.org/'' 
or host one up by yourself: 
''https://manual.limesurvey.org/Installation_-_LimeSurvey_CE'' 

==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.

Upgrade Strategy:
# 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''
# 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.
# Export your updated customized surveytheme from the new application
# 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.

==Custom admin themes==
All custom admin themes will be uninstalled and the new default will be used.

for self hosted application:
# 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''
# 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, 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
#* Delete the old admin theme and install the new one you previously updated in your test environment

for Cloud users: 
Please contact our support.

==Custom question themes==
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

Upgrading your own 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
# Try to upload your question theme into the new application.
# If it is your own question theme, make the necessary adjustments
# after successfully uploading, please check if the question theme is displayed and working as expected.

Upgrading a theme you do not own: 
Try to see if an update is available from the website or developer that provided it

==Custom plugins==
Custom plugins that do not match the current version will be deactivated during the upgrade process.

for self hosted application:
# Check if the plugin can be installed on the new version.
# Update the plugin or contact the plugin author to update the plugin.
# 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.

for Cloud users:
# Check if the plugin can be installed on the new version.
# Update the plugin code or contact the plugin author to update the plugin.
# 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

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

	=How to prepare for a major version upgrade=		=How to prepare for a major version upgrade=
	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 25:		Line 25:
	# 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==		==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.

	<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 38:		Line 38:
	# 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.

	<b>for Cloud users:</b><br>		<b>for Cloud users:</b><br>
Line 47:		Line 47:
	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

	<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.

	<b>Upgrading a theme you do not own:</b><br>		<b>Upgrading a theme you do not own:</b><br>
Line 60:		Line 60:
	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.

	<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.