Actions

Version guide: Difference between revisions

From LimeSurvey Manual

mNo edit summary
No edit summary
 
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Guide on how to upgrade and when from different LS versions.
<languages />
<translate>


== Semantic versioning ==
<!--T:1-->
__TOC__


Understading the semantic versioning of LimeSurvey might be a little bit tricky. First, to check all the past LimeSurvey versions, you may access the following [https://github.com/LimeSurvey/LimeSurvey/blob/master/docs/release_notes.txt] link.


The most important updates are described below:
=Version Numbering= <!--T:2-->


{| class="wikitable" style="text-align: center"
|+The most important LimeSurvey releases
!Old version (build)
!New version (build)
!How to upgrade
!Other details
|-
|LimeSurvey 1
|LimeSurvey 1.50
|If you use LimeSurvey 1, you can update to LimeSurvey 1.44. Due to the structural changes that were implemented, the only way to get to LimeSurvey 1.50 is to do a clean installation of the software. For further details, check the following [[Upgrading_from_a_previous_version#Upgrading_from_a_version_earlier_than_v1.50_.28v1.0_through_v1.44.29|link]].
|If you wish use some old survey structure files with an *.sql extension, export them from the older version and then import the respective .sql file(s) into the new LimeSurvey version.
|-
|LimeSurvey 1.50
|LimeSurvey 1.92
|Read the following [[/Upgrading_from_a_previous_version#Upgrading_from_version_1.50_or_later_to_any_later_1.xx_version|wiki section]] to find out how you can get to the latest 1.xx release.
|'''Please note that the templates system was changed in 1.92. Check if your customised templates are still working. If not, please edit them accordingly.
|-
|
|LimeSurvey 1.92
|LimeSurvey 2.00
|To correctly upgrade your installation from 1.92 to 2.00, upgrade from the latest 1.92 build: ''120919''. For further information, access the following [[Upgrading_from_a_previous_version#Upgrading_from_version_1.50_or_later_to_any_later_2.xx_version|link]]
|
|-
|LimeSurvey 2.00
|LimeSurvey 2.06
|If you wish to upgrade your installation from 2.00 to 2.06, you can either upgrade your installation [[Upgrading_from_a_previous_version|manually]] or via [[ComfortUpdate|ComfortUpdate]]
|
|-
|LimeSurvey 2.06
|LimeSurvey 2.50 or LimeSurvey 2.06 LTS
|If you wish to upgrade your installation from 2.06 to 2.50, you can either upgrade your installation [[Upgrading_from_a_previous_version|manually]] or via [[ComfortUpdate|ComfortUpdate]]
|Please note that the template structure has changed with the update from 2.0x to 2.50 or later. Your old templates will '''not''' be working anymore as the template system uses now responsive templates.
|Please note that 2.06 is the first LTS version provided by LimeSurvey. See the [[Version guide#LimeSurvey LTS]] wiki subsection below.
|-
|LimeSurvey 2.50
|LimeSurvey 2.7x.x
|If you wish to upgrade your installation from 2.50 to 2.7x.x, you can either upgrade your installation [[Upgrading_from_a_previous_version|manually]] or via [[ComfortUpdate|ComfortUpdate]]
|
|-
|LimeSurvey 2.6.0
|LimeSurvey 2.7.3
|
|
|
|-
|
|
|
|
|
|-
|
|
|
|
|
|-
|
|
|
|
|
|-
|
|
|
|
|


<!--T:3-->
To understand the version numbering, remember that version 2.06 was preceded by 1.92, 2.00, and 2.05. LimeSurvey 2.06 is our "starting point" as it is the moment in which a LTS version started to be developed too. Therefore, we have now a(n):


<!--T:4-->
*LTS version: 2.06LTS. It was later renamed to 2.6.x on October 24, 2016. This version will be supported until the launch of the next LTS version. According to this [https://www.limesurvey.org/about-limesurvey/surveyhelp/2137-limesurvey-version-lifecycle link], the next LTS version is LimeSurvey 3.x.
*up-to-date version. The first up-to-date version after 2.06 was 2.50, which was released on February 2, 2016. Since then, new features have been added with the releases of LimeSurvey 2.6x.x and 2.7x.x. After the last 2.7x release, LimeSurvey 3 was launched on December 22, 2017.


These releases


== 2.06 and 2.6 ==
==Differences== <!--T:5-->


TODO


TODO: Add pic of admin interface
<!--T:6-->
All three major LimeSurvey versions described below use different template engines. This means that a template created for LimeSurvey 2.06 cannot be used in LimeSurvey 2.73 or LimeSurvey 3, and a template created in 2.73 cannot be used in LimeSurvey 3.


== 2.73 ==
<!--T:7-->
''Why did you change the template engines and make them incompatible?''


TODO
<!--T:8-->
# LimeSurvey 2.50 (now 2.73) introduced responsive default templates, and we had to change the HTML to support this addition.
# LimeSurvey 3 introduced a Twig template system and a template inheritance system which are not compatible with older HTML-based templates.


TODO: Add pic of admin interface
<!--T:9-->
{{Note|Please note that the '''Template editor''' was renamed in LimeSurvey 3, being called now '''Themes'''.}}


== 3.x ==
<!--T:10-->
You can also observe in the screenshots from below the GUI (Graphical User Interface) changes that took place along the time.


With the release of LimeSurvey 3.x, the development and support from 2.
==2.06 and 2.6== <!--T:11-->


TODO: Add pic of admin interface


== Templates and workarounds ==
<!--T:12-->
<center>[[File:LimeSurvey 2.06 survey overview.png]]</center>


All three major versions use different template engines and templates will not be compatible between them.


Templates are called "themes" in 3.x.
== 2.73 == <!--T:13-->


== Long-term support, LTS ==


3.x will be the only LTS version.
<!--T:14-->
<center>[[File:LimeSurvey 2.73 x survey overview.png]]</center>
 
 
== 3.x == <!--T:15-->
 
 
<!--T:16-->
<center>[[File:LimeSurvey 3x survey overview.png]]</center>
 
= How to upgrade= <!--T:17-->
 
<!--T:18-->
If you wish to upgrade your installation, you can either upgrade it [[Upgrading_from_a_previous_version|manually]] or use the [[ComfortUpdate]].
 
 
=Long-term support (LTS)= <!--T:19-->
 
 
<!--T:21-->
{{Note|'''What does LTS mean for LimeSurvey?'''
If a version is marked as being LTS, then the respective version is eligible to receive bugfixes and security updates.}}
 
 
<!--T:20-->
At the moment, LimeSurvey 3 is a LTS release. There will not be any new features added.
Check out the [[LimeSurvey_roadmap|LimeSurvey Roadmap]] for information about support timelines.
 
 
</translate>

Latest revision as of 17:15, 15 January 2021

Other languages:


Version Numbering

To understand the version numbering, remember that version 2.06 was preceded by 1.92, 2.00, and 2.05. LimeSurvey 2.06 is our "starting point" as it is the moment in which a LTS version started to be developed too. Therefore, we have now a(n):

  • LTS version: 2.06LTS. It was later renamed to 2.6.x on October 24, 2016. This version will be supported until the launch of the next LTS version. According to this link, the next LTS version is LimeSurvey 3.x.
  • up-to-date version. The first up-to-date version after 2.06 was 2.50, which was released on February 2, 2016. Since then, new features have been added with the releases of LimeSurvey 2.6x.x and 2.7x.x. After the last 2.7x release, LimeSurvey 3 was launched on December 22, 2017.


Differences

All three major LimeSurvey versions described below use different template engines. This means that a template created for LimeSurvey 2.06 cannot be used in LimeSurvey 2.73 or LimeSurvey 3, and a template created in 2.73 cannot be used in LimeSurvey 3.

Why did you change the template engines and make them incompatible?

  1. LimeSurvey 2.50 (now 2.73) introduced responsive default templates, and we had to change the HTML to support this addition.
  2. LimeSurvey 3 introduced a Twig template system and a template inheritance system which are not compatible with older HTML-based templates.
Please note that the Template editor was renamed in LimeSurvey 3, being called now Themes.

You can also observe in the screenshots from below the GUI (Graphical User Interface) changes that took place along the time.

2.06 and 2.6


2.73


3.x

How to upgrade

If you wish to upgrade your installation, you can either upgrade it manually or use the ComfortUpdate.


Long-term support (LTS)

What does LTS mean for LimeSurvey? If a version is marked as being LTS, then the respective version is eligible to receive bugfixes and security updates.


At the moment, LimeSurvey 3 is a LTS release. There will not be any new features added. Check out the LimeSurvey Roadmap for information about support timelines.


Retrieved from "http://manual.limesurvey.org/index.php?title=Version_guide&oldid=160157"