Joomla! 1.7 is the first major Joomla! release that aims to provide users with a seamless method for easily updating their sites, without any difficult, or time consuming upgrade processes. With the new 6 Month Release Cycle from the Joomla! Project, sequential Joomla! versions will be easily updated in your site. There are several methods you can use to upgrade your site, three to be exact. We’ll take a look at each one of them starting with the easiest one, and ending with the most involved method. These methods are only for current 1.6 users. If your Joomla! site is on 1.5.x, take a look at [[Migrating from Joomla 1.5 to Joomla_1.6+|this tutorial]] that will walk you through migrating your site from 1.5 to 1.7

If your site is not already at 1.6.5 or 1.6.6, or you prefer not to use the '''Quick Update''', there are several other options shown here. Click the 'tab' of the method you would like to use for updating your Joomla 1.6 web site.

−

The new update manager in Joomla! 1.6 has been utilized to provide “one click updates” for Joomla! users. In order to perform this operation, Joomla! users will have to already be on the latest Joomla! 1.6 version (1.6.5). For those users already using Joomla! 1.6.5, the following steps will easily update your site to 1.7.0

+

==IMPORTANT!==

+

{{notice|If you are not currently on Joomla! 1.6.5/1.6.6, use [[Upgrading 1.6 from an existing 1.6x version]] to update your site to 1.6.5/1.6.6, then resume the process of updating to 1.7}}

+

:<big>'''OR'''</big>

+

{{notice|If you are still using Joomla! 1.5, please see these instructions:

+

*[[Migrating from Joomla 1.5 to Joomla 2.5]]}}

−

{{ambox|image=notice|style=notice|text=If you are not using this latest version, use [[Upgrading 1.6 from an existing 1.6x version|this tutorial]] to get from your current 1.6 version, to 1.6.5.}}

+

=Quick Update=

−

Log in to your Joomla! administrator control panel (www.example.com/administrator), and access the '''Extensions''' > '''Extensions Manager''' option in your administration menu. From here, go to the ‘Update’ tab. You should see a list of available updates for Joomla!, and any additional components that use the new udpate method. If there are no updates listed there, simply click the ‘Purge Cache’ button in the top right toolbar, then click the ‘Find Updates’ button to refresh the list of available updates. You should now see an item in the list to update your site to Joomla! 1.7

+

For sites already up-to-date running Joomla 1.6.5, upgrading to Joomla 1.7 is now very easy.

−

{{ambox|image=notice|style=notice|text=If you still don’t see an upgrade option there, use the process described in the next section.}}

+

Before you begin:

−

To update your site, simply check the box next to the 1.7 update option, and click ‘Update’!

+

* Check that all installed extensions are compatible with Joomla 1.7 by checking the JED Listing or developer site.

−

==Installation Manager ==

+

* [[Backup | Backup]] the website files and database.

−

If you aren’t yet comfortable with using the Update Manager to update your site, you’re still ok! There are more easy options to update your site. The second method to update your Joomla! 1.6.5 site to 1.7.0 is to use the extension installer, just as if you were installing a component, module, plugin, or template in your site. This method is specially handy for users updating localized distributions made available by Language Communities.

+

1. In the Administrator, select the '''Extensions-Extensions Manager''' Menu item.

−

To update your site using this method, first, download the update package from JoomlaCode. The 1.6.5 > 1.7.0 package can be found here: [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=5986].

+

[[Image:1-Extensions-ExtensionManager.png]]

−

{{ambox|image=notice|style=notice|text=If you are not currently on Joomla! 1.6.5, use [[Upgrading 1.6 from an existing 1.6x version|this tutorial]] to update your site to 1.6.5, then resume the process of updating to 1.7}}

+

2. Click the '''Update''' Sub menu.

−

After you download the update package, access your Joomla! installer by logging in to your adminstrator control panel, and navigating to the '''Extensions''' > '''Extension Manager''' option in your administrator menu. From here you can select the file you just downloaded, and install it. The Joomla! installer will upload the package, and install it, making any changes to files or the database as needed.

+

[[Image:2-Extension-Update.png]]

−

== Manual Upload/Installation ==

+

3. Click the '''Purge Cache''', then '''Find Updates''' Buttons in the Button Bar located in the upper right of the page.

+

+

[[Image:3-Extension-Manager-Update.png]]

+

+

4. Click the checkbox to the left of the Joomla line containing the latest Version Number and, next, press the Update Button in the Button Bar.

+

+

'''Be patient while the system downloads and replaces the necessary files.''' This can take several minutes or could update very quickly, depending on your system.

+

+

[[Image:4-Update-Joomla.png]]

+

+

5. When the update has finished, you will be presented with this page.

+

+

[[Image:6-Final.png]]

+

+

'''That's it!''' Follow these simple instructions next time you upgrade. Now, it's to keep your Joomla website up-to-date and safe!

+

+

= Update using the Installation Manager =

+

+

{{ambox|image=notice|style=notice|text=If you are not currently on Joomla! 1.6.5/1.6.6, use [[Upgrading 1.6 from an existing 1.6x version]] to update your site to 1.6.5/1.6.6, then resume the process of updating to 1.7}}

+

+

If you aren’t yet comfortable with using the Update Manager to update your site, you’re still ok! There are more easy options to update your site. The second method to update your Joomla! 1.6.5/1.6.6 site to 1.7.0 is to use the extension installer, just as if you were installing a component, module, plugin, or template in your site. '''This method is specially handy for users updating localized distributions made available by Language Communities.'''

+

+

To update your site using this method, first, download the update package from JoomlaCode (or your language Community Site). The 1.6.5/1.6.6 > 1.7.0 package can be found [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=5986 here].

+

+

After you download the update package, access your Joomla! installer by logging in to your administrator control panel, and navigating to the '''Extensions''' > '''Extension Manager''' option in your administrator menu. From here you can select the file you just downloaded, and install it. The Joomla! installer will upload the package, and install it, making any changes to files AND the database as needed.

+

+

= Manual Update - Uploading =

The last method available to update your site, involves a little more technical expertise, and should probably only be used if the previous methods won’t work due to a highly complex site or hosting issues (shared hosting for example). ''' As usual back-up your site and your database.''' For most Joomla! sites, the first two methods will successfully update your site. However, updating is still fairly easily, and should not be a problem.

The last method available to update your site, involves a little more technical expertise, and should probably only be used if the previous methods won’t work due to a highly complex site or hosting issues (shared hosting for example). ''' As usual back-up your site and your database.''' For most Joomla! sites, the first two methods will successfully update your site. However, updating is still fairly easily, and should not be a problem.

−

Before you begin, go to global configuration and on the server tab and in the Database Settings area find the database table prefix used by your site.

+

Before you begin, go to global configuration and on the server tab and in the Database Settings area find the database table prefix used by your site.

−

To update your site manually, you will need to download the 1.6.5 > 1.7.0 update package from JoomlaCode. You can download it here: [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=5986] Unpack the package and you will find two zip files in it. You will only need the large zip file called Joomla_1.7.0-Stable-Update_Package.zip for your update. Using an ftp client, upload the zip file to your server into the root directory of your website, and unpack the files. This will over-write any modified files with new, updated files for 1.7.0. Alternatively, you can unpack the Joomla_1.7.0-Stable-Update_Package.zip on your local computer, then copy the un-packed files into your websites root, overwriting the modified files.

+

To update your site manually, you will need to download the 1.6.5 > 1.7.0 update package from JoomlaCode. You can download it [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=5986 here]. Unpack the package and you will find two zip files in it. You will only need the large zip file called <tt>Joomla_1.7.0-Stable-Update_Package.zip</tt> for your update. Using an ftp client, upload the zip file to your server into the root directory of your website, and unpack the files. This will over-write any modified files with new, updated files for 1.7.0. Alternatively, you can unpack the <tt>Joomla_1.7.0-Stable-Update_Package.zip</tt> on your local computer, then copy the un-packed files into your websites root, overwriting the modified files.

After unpacking the files to your website you need to manually delete the files and folders listed in administrator/components/com_admin/script.php.

After unpacking the files to your website you need to manually delete the files and folders listed in administrator/components/com_admin/script.php.

After you have done this you need to manually update your site's database. To do so locate the file installation/sql/mysql/joomla_update_17ga.sql, or the files /administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06.sql and administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06-2.sql.

+

After you have done this you need to manually update your site's database. To do so locate the file <tt>installation/sql/mysql/joomla_update_17ga.sql</tt>, or the files <tt>/administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06.sql and administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06-2.sql</tt>.

As of July 16th 2011 the file(s) contains:

As of July 16th 2011 the file(s) contains:

Line 122:

Line 153:

</source>

</source>

−

Inside you will find parts like "#__languages" and "#__associations". Replace the pound sign and the first underscore (#_) with your database tables prefix. By default this is 'jos'. If you didn't get the prefix before starting, open your site's configuration.php and search for $dbprefix the string inside the single quotes behind is what you're looking for. So you need to change "#__languages" to "jos_languages" and so on.

+

Inside you will find parts like <code>#__languages</code> and <code>#__associations</code>. Replace the pound sign and the first underscore (<code>#_</code>) with your [[Database Table Prefix|database tables prefix]]. By default this is <code>jos</code>. If you didn't get the prefix before starting, open your site's <tt>configuration.php</tt> and search for <code>$dbprefix</code>. The string inside the single quotes behind it is what you're looking for. So you need to change <code>#__languages</code> to <code>jos_languages</code> and so on.

−

+

−

Once you've done this go to your site's phpmyadmin (or any way you usually manage your database) and open the database your site uses. There will be a tab called SQL, open this. Paste the content of your modified joomla_update_17ga.sql inside the text area and press go.

+

−

Your site is now updated to Joomla 1.7.

+

Once you've done this go to your site's phpmyadmin (or any way you usually manage your database) and open the database your site uses. There will be a tab called SQL, open this. Paste the content of your modified <tt>joomla_update_17ga.sql</tt> inside the text area and press go.

Updating Joomla! 1.6 Intro

If your site is not already at 1.6.5 or 1.6.6, or you prefer not to use the Quick Update, there are several other options shown here. Click the 'tab' of the method you would like to use for updating your Joomla 1.6 web site.

Update using the Installation Manager

If you aren’t yet comfortable with using the Update Manager to update your site, you’re still ok! There are more easy options to update your site. The second method to update your Joomla! 1.6.5/1.6.6 site to 1.7.0 is to use the extension installer, just as if you were installing a component, module, plugin, or template in your site. This method is specially handy for users updating localized distributions made available by Language Communities.

To update your site using this method, first, download the update package from JoomlaCode (or your language Community Site). The 1.6.5/1.6.6 > 1.7.0 package can be found here.

After you download the update package, access your Joomla! installer by logging in to your administrator control panel, and navigating to the Extensions > Extension Manager option in your administrator menu. From here you can select the file you just downloaded, and install it. The Joomla! installer will upload the package, and install it, making any changes to files AND the database as needed.

Manual Update - Uploading

The last method available to update your site, involves a little more technical expertise, and should probably only be used if the previous methods won’t work due to a highly complex site or hosting issues (shared hosting for example). As usual back-up your site and your database. For most Joomla! sites, the first two methods will successfully update your site. However, updating is still fairly easily, and should not be a problem.

Before you begin, go to global configuration and on the server tab and in the Database Settings area find the database table prefix used by your site.

To update your site manually, you will need to download the 1.6.5 > 1.7.0 update package from JoomlaCode. You can download it here. Unpack the package and you will find two zip files in it. You will only need the large zip file called Joomla_1.7.0-Stable-Update_Package.zip for your update. Using an ftp client, upload the zip file to your server into the root directory of your website, and unpack the files. This will over-write any modified files with new, updated files for 1.7.0. Alternatively, you can unpack the Joomla_1.7.0-Stable-Update_Package.zip on your local computer, then copy the un-packed files into your websites root, overwriting the modified files.

After unpacking the files to your website you need to manually delete the files and folders listed in administrator/components/com_admin/script.php.

After you have done this you need to manually update your site's database. To do so locate the file installation/sql/mysql/joomla_update_17ga.sql, or the files /administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06.sql and administrator/components/com_admin/sql/updates/mysql/1.7.0-2011-06-06-2.sql.

Inside you will find parts like #__languages and #__associations. Replace the pound sign and the first underscore (#_) with your database tables prefix. By default this is jos. If you didn't get the prefix before starting, open your site's configuration.php and search for $dbprefix. The string inside the single quotes behind it is what you're looking for. So you need to change #__languages to jos_languages and so on.

Once you've done this go to your site's phpmyadmin (or any way you usually manage your database) and open the database your site uses. There will be a tab called SQL, open this. Paste the content of your modified joomla_update_17ga.sql inside the text area and press go.

Congratulations, your site is now updated to Joomla 1.7. <headertabs/>