Actions

Difference between revisions of "What version of Joomla! should you use?"

From Joomla! Documentation

m (another update)
 
(18 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Normally, you should use the latest version of Joomla! for a new site unless you have a specific reason not to. The latest version can be downloaded from the [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=3846 Joomla! download site]. If you are running an earlier release of the current version (for example, you are running 1.5.2 and the current version is 1.5.5), you should upgrade to the current version if you experience any problems. Each minor release fixes a number of bugs, so it is always good practice to upgrade to the latest minor version as a first step in troubleshooting a problem.
+
{{RightTOC}}
 +
{{:Joomla! CMS versions}}
  
If you have a site that is working well on an older Joomla! version, you do not need to upgrade the site. At the time of this writing, both Joomla! version 1.0 and 1.5 are supported, although all new development effort is going into version 1.5. Version 1.6 is planned for release in a few months time.
+
==Included External Libraries==
 +
{{:External Libraries in Joomla}}
  
Many Joomla! Extensions have been released for version 1.5, with more being offered each week. However, there may be specific cases where an Extension is available for version 1.0 and not available for version 1.5, and this could be a reason to use version 1.0.
+
==Joomla! versions explained==
 +
{{:Release_and_support_cycle}}
  
[[Category:Version 1.0 FAQ]] [[Category:Version 1.5 FAQ]] [[Category:Getting Started FAQ]]
+
==References and Notes==
 +
<references/>
 +
 
 +
<noinclude>[[Category:FAQ]]
 +
[[Category:Version 1.0 FAQ]]
 +
[[Category:Version 1.5 FAQ]]
 +
[[Category:Version 1.6 FAQ]]
 +
[[Category:Version 1.7 FAQ]]
 +
[[Category:Version 2.5 FAQ]]
 +
[[Category:Version 3.0 FAQ]]
 +
[[Category:Version 3.1 FAQ]]
 +
[[Category:Getting Started FAQ]]
 +
[[Category:Joomla! versions]]
 +
</noinclude>

Latest revision as of 02:03, 29 June 2013

Contents

Check for the latest Joomla! CMS version. If you are not on the latest release, read the release notes to see if you need to upgrade. If a release is being made in order to address security issues then it is strongly advised that you upgrade as soon as possible. You can see the release history of each series in the table below. Click the version history link in the notes column to find details on exact release date, release notes and package and MD5s.

  • Normally, you should use the latest version of Joomla! for a new site unless you have a specific reason not to.
  • The latest version can be downloaded from the Joomla! download site.
  • Make sure you subscribe to the Joomla! Security Announcements feed. This RSS feed is used to make announcements, including the availability of new releases, that could affect the security of your site. You have the option to subscribe to this feed by RSS or email.
  • If you are running an earlier release of the current version (for example, you are running 2.5.1 and the current version is 2.5.6), you should upgrade to the current version. Each minor release fixes a number of bugs and/or security issues. It is always good practice to upgrade to the latest maintenance version as a first step in troubleshooting a problem and fixing any newly discovered security issues.

Joomla! CMS versions

CMS Version Available Support End of Life Upgrade Type Notes Latest Release
Bugs Security
1.5
X-mark.png
X-mark.png
X-mark.png
Sept 2012 Migration to 2.5 Plan to migrate to 2.5 now
Joomla 1.5 version history
EOL at 1.5.26
1.6
X-mark.png
X-mark.png
X-mark.png
Aug 2011 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.6 version history
1.6.6
1.7
X-mark.png
X-mark.png
X-mark.png
Feb 2012 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.7 version history
1.7.5
2.5
Checkmark.png
Checkmark.png
Checkmark.png
December 31st, 2014 One-click to 3.x Recommended as-needed basis for new installs
Joomla 2.5 version history
2.5.19
3.0
X-mark.png
X-mark.png
X-mark.png
May 2013 One-click to 3.1 You should use the one click upgrade to Joomla 3.1
Joomla 3.0 version history
3.0.4
3.1
X-mark.png
X-mark.png
X-mark.png
Dec 2013 One-click to 3.2 You should use the one click upgrade to Joomla 3.2
Joomla 3.1 version history
3.1.6
3.2 Checkmark.png
Checkmark.png
Checkmark.png
Oct 2014[1] One-click to 3.3 Recommended for most new installs
Joomla 3.2 version history
3.2.3
3.3 Mar 2014 - - Oct 2014 One-click to 3.5
3.5 Sept 2014 - - December 31st, 2016 One-click to 4.0
4.0 Q2 2015 - -


Included External Libraries

A Joomla! installation contain external libraries which are included with Joomla! CMS version releases. These external libraries are not part of the core code. Please read the Notes section as they may contain more information, such as a external library version change released with a maintenance release.

External Libraries by Joomla Release

CMS Version CMS Version Supported Mootools Mootools More jQuery jQuery UI
(Core, Widget, Mouse, Position, and Sortable)
Bootstrap Simple Pie PHP Mailer PHP UTF-8 IDNA Convert Rapid Application Development (RAD) Framework
Akeeba's Framework on Framework(FOF)
password_compat[2]
2.5
Checkmark.png
1.4.5[3] 1.4.0.1 N/A[4] N/A[4] N/A[4] 1.2 5.2.1 0.5 N/A[4] N/A[5] N/A[6]
3.0
X-mark.png
1.4.5 1.4.0.1 1.8.1 1.8.23 2.1.0 1.2 5.2.1 0.5 N/A[7] N/A[5] N/A[6]
3.1
X-mark.png
1.4.5 1.4.0.1 1.8.3 1.8.23 2.1.0 1.2[8] 5.2.3 0.5 N/A[7] N/A[5] N/A[6]
3.1.2
X-mark.png
1.4.5 1.4.0.1 1.8.3 1.8.23 2.3.2[9] 1.2[8] 5.2.6 0.5 0.8.0 N/A[5] N/A[6]
3.2
Checkmark.png
1.4.5 1.4.0.1 1.10.2[10] 1.9.2 2.3.2[9] 1.2[8] 5.2.6 0.5 0.8.0 2.1 1.0.3


Joomla! versions explained

Joomla! is developed using a fixed release cycle. Every six months, the Joomla! Project releases a new minor or major version of Joomla!. Joomla!'s version format is:

[major].[minor].[maintenance]

Each version of Joomla! is supported by the Joomla! Project for a limited amount of time. There are two classifications for support: short term support (STS) and long term support (LTS). Every fourth release will be assigned long term support.

  • STS (short term support) releases are supported for seven months. Their support ends one month after the next release of Joomla is released. They are one click upgrades to the next STS or LTS version.
  • LTS (long term support) releases are supported for twenty-seven months.

Please note that both STS and LTS releases, once they have reached the GA (General Availability) status, are fully functional and ready to be used in production environment. The disadvantage of using STS releases is that you will need to update your installation of Joomla! every six months, while the advantage is that you will have access to new features and extensions earlier.

Generally, the first STS release after an LTS release indicates the beginning of a new major release cycle. This STS release introduces fundamentally new features and changes that break compatibility with the previous LTS. Two more STS releases follow (usually compatible with the first STS release), and the release cycle is finished by the release of an LTS release which finalizes the work of the three STS releases. The four releases in one cycle will usually be numbered [major].0,[major].1 and [major].2 (STS) and [major].5 (LTS). For example, the STS release 3.0 will include breaking changes from 2.5, and 3.5 will include matured versions of the changes in 3.0, 3.1 and 3.2.

Usually, there will be a migration path (an officially supported way of migrating to the next version) between two LTS releases (from [major].5 to [next major].5) and between an LTS release and the STS releases in its major release cycle (from [major].2 to [major].5, for example), but not necessarily to the following STS releases (from [major].5 to [next major].0). In the case of 1.5 to 2.5 (LTS to LTS), for example, there is a migration path. Note that in the case of 2.5 to 3.0 (LTS to STS), there is also built-in migration path, since the changes aren't too incompatible.

For more information, see the official Development Strategy.

The latest STS version documented on this Wiki is 3.2.3 (see Category:Joomla! 3.2). The latest LTS version documented on this Wiki is 2.5.19 (see Category:Joomla! 2.5).


References and Notes

  1. Bug fixes will cease April 2014, security fixes only, see http://community.joomla.org/blogs/leadership/1798-raising-the-bar-on-security.html.
    "Also, for the six months after Joomla! 3.3 is released, the Joomla! Project will be releasing Security Updates for both 3.2 AND 3.3 (as well as 2.5) so any new vulnerabilities can be promptly patched with a one-click update without the need to immediately update to Joomla! 3.3, giving you time to request your hosting provider to update their PHP version."
  2. This library is intended to provide forward compatibility with the password_* functions which were added to PHP 5.5. See [1] for further information. password_compat git
  3. Contains a 1.2 compatibility layer
  4. 4.0 4.1 4.2 4.3 Not applicable, this library was not included with Joomla! CMS version 2.5.
  5. 5.0 5.1 5.2 5.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2. The version of FOF included in Joomla 3.2 is compatible with Joomla 2.5 however.
  6. 6.0 6.1 6.2 6.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2
  7. 7.0 7.1 Not applicable, this library was not included with the Joomla! CMS prior to version 3.1.2.
  8. 8.0 8.1 8.2 This library was deprecated for JFeedFactory in Joomla! CMS version 3.1.0
  9. 9.0 9.1 Contains some 2.1 backward compatibility defaults
  10. Includes jQuery Migrate plugin 1.2.1 for backwards compatibility