This documentation relates to CiviCRM version 2.2. It's not maintained anymore.
Current version of documentation.


Upgrade Joomla Sites to 2.2

Aller directement à la fin des métadonnées
Aller au début des métadonnées

This page refers to outdated version of CiviCRM. Check current version of documentation.

Documentation Search

CiviCRM 2.2 Documentation

Support and Participation

Developer Resources

Use this document to UPGRADE CiviCRM installations on Joomla from version 2.1.x to 2.2.x OR from any revision of 2.2 to the latest release

IMPORTANT: CiviCRM 2.2 requires Joomla 1.5.x.

Version 2.2 Requirements

Before beginning this upgrade, verify that your server meets the requirements for CiviCRM 2.2.

  • Joomla 1.5. : CiviCRM 2.2 (like 2.1) is been built to run under Joomla 1.5.x and is not compatible with Joomla 1.0.x sites.
  • PHP 5.2.x : Starting with the 1.9 release, CiviCRM will NOT run on PHP4 servers* (more info...).
  • MySQL 5.0.x or higher : CiviCRM is compatible the current generally available MySQL release.
Upgrade a Copy of Your Site First and Make a Complete Backup

We strongly recommend that you create a copy of your existing site (directories and database) - and upgrade that copy first in order to make sure you can complete the upgrade successfully. In any case, you should create a full backup of the installed civicrm directory tree and civicrm database before beginning the upgrade process.

If you are on CiviCRM (2.2?) Beta1 or Beta2 or uninstalling a failed 2.2 upgrade

You need to make following changes before you uninstall.

Modify JOOMLA_ROOT/administrator/components/com_civicrm/uninstall.civicrm.php

If you don't make above changes, UNINSTALL process using the Extension Manager WILL DELETE ALL CiviCRM TABLES AND DATA..

1. Download and Un-tar CiviCRM Code

All CiviCRM code and packages used by CiviCRM (such as PEAR libraries) are included in the compressed CiviCRM distribution files ('tarballs'). Follow these steps to download and install the codebase:

  • Download the appropriate tarball file from here with your browser. Tarball file-names include the CiviCRM version. For example,
  • You may notice a file on the named something like the -alt version DOES NOT require .zip functions compiled into PHP by your hosting company.  If you get errors like "Your PHP version is missing zip functionality. Please ask your system administrator / hosting provider to recompile PHP with zip support." - Try the -alt version.
  • Upload this file to your: JOOMLA_1.5.x_ROOT/tmp/.  Unzipping will create a directory called: com_civicrm.

2. Backup your CiviCRM database

Refer to the or {|phpMyAdmin documentation] if you need information on backing up your database.

3. Run the Installer

  • Login to your Joomla Administrator site.
  • Go to Extensions >> Install/Uninstall
  • Click Components >> Select existing "CiviCRM". Click Uninstall.
  • You should see "Uninstall Component Success".
  • Click Install.
  • Use Install from Directory and enter the full path to the un-zipped com_civicrm directory, which should be something like JOOMLA_1.5.x_ROOT/tmp/com_civicrm. It is likely that the full root path to the /tmp/ directory is auto-filled in the install from directory field, in which case you simply add /com_civicrm
  • You should see "CiviCRM successfully installed" message and a link to upgrade the database to the current version. Click the link and initiate the database upgrade script on the following screen (This step is critical to ensure your upgraded site functions properly).
  • You should see a message confirming the database was updated correctly and a link to return to the CiviCRM homepage. Click the link. The CiviCRM menus will now be rebuilt.
  • You should now be running the current version of CiviCRM. Check the footer on the bottom of any CiviCRM page to confirm the version number.
  • Take some time to browse the CiviCRM features that your organization uses. If you notice unexpected behaviors or error messages, refer to the trouble-shooting section below.

*If you get the following error when installing or upgrading CiviCRM 2.2 for Joomla!, download and use the package. Repeat the install steps starting with step 3 above, including the uninstall of CiviCRM (if the script finds the zip file from a previous installthen it will check for zip functionality, and you'll get this error message again).
Your PHP version is missing zip functionality. Please ask your system administrator / hosting provider to recompile PHP with zip support.

MySQL 4.0 and 4.1 are Not Supported

Support for MySQL versions 4.0 and 4.1 has been discontinued. This means that you may encounter various issues and/or unexpected behavior if you atempt to run CiviCRM under these versions, and the CiviCRM engineering team will not provide support for debugging or resolving these issues. You are strongly encouraged to upgrade to the current generally available release of MySQL.

If you receive an error message when updating your database, you may need to reinstall your v2.1 database from backup, correct errors, and rerun the database upgrade script. Make sure you are logged into the Joomla administration and point your web browser to the following URL:

4. Verify and Update Resource URL Settings

If you are running this installation in a different directory from your 2.1 site you may need to update the configured CiviCRM Resource URL (Missing icons and images, as well as problems with javascript functions and stylesheets are all symptoms that this setting needs to be updated.)

  • Go to Administer CiviCRM » Global Settings » Resource URLs
  • Refer to the field help on that screen for instructions.

5. Enable Components

If you plan on using the new CiviCase component, or any components that you weren't using in the prior version (e.g. CiviPledge or CiviGrant for grant management) - you'll need to enable these component(s):

  • Go to Administer CiviCRM » Global Settings » Enable Components

If you have been using Cases in 2.1 and / or want to start using the CiviCase component, you will also need to complete additional configuration steps. Learn more...


Reset Session

If you are seeing unexpected behavior after completing the upgrade, you may need to reset your session. First simply log-out of your Administrator session and log back in. This may resolve the issues. If this doesn't help, use this procedure to force a session reset:

  1. Temporarily enable CiviCRM debug features:
    • Go to Administer CiviCRM » Global Settings » Debugging
    • Set Enable Debugging to Yes and click Save.
  2. Click the Administer CiviCRM menu (or any other CiviCRM menu item). After the page is loaded, add an additional query string value (&sessionReset=2) to the URL in your browser's location bar, and reload the page.
  3. Clear template cache by adding an additional query string value (&directoryCleanupReset=1)
  4. Now reset Enable Debugging to No and click Save.
    Do Not Leave Debug Features Enabled for a Public Site

    Debugging should be disabled for publicly available sites as it may allow browsers to view system configuration information.

Remove cached copies of old templates

It may be that the install did not clear out the template cache. Try removing the cache contents. For example, with Linux, use with a command like ...

This will force CiviCRM to load the new templates rather than cached copies of the old ones.

Need More Help?

If you have any problems with these procedures, try searching the community forums and this wiki for solutions. If you've gotten an error message, use that message in your search. If you can not resolve the problem, then post your problem to the forum. Be sure to include the CiviCRM version and revision you are upgrading FROM and TO; your Joomla version; your PHP and MySQL versions; the steps you've taken and a the exact error message or problem that resulted.

Related Resources

Configuring Front-end Profile Listings and Forms in Joomla\! Sites
Displaying Online Contribution Pages in Joomla! Frontend Sites

  • Aucun