How to update

This is a tutorial on how to update ZOO without uninstalling and reinstalling the component.

Update ZOO component

No matter what distribution of ZOO you are using, the free packages, which includes the Pages and Blog apps or the full package, including all available apps of the App Bundle, the update process is the same.

1-Click Update

Since ZOO 3.3 is possible to update with just one click using the Joomla! Update Manager.

Follow these steps:

  1. First of all make a backup of your old site (files and database), so you can recover it any time.
  2. If you are using the full distribution make sure you have set your API Key in the YOOtheme Installer plugin.
  3. Go to the Update section of the Extensions Manager in the Joomla! administration, pick ZOO package and click on Update.

If you don't see any new ZOO update available click on Find Updates

Manual Update

Follow these steps:

  1. First of all make a backup of your old site (files and database), so you can recover it any time.
  2. Download the latest ZOO version (one of the distributions from above).
  3. Go to the extensions installer in the Joomla administration, pick the downloaded ZOO package and click on Upload File & Install.

That's it! Now ZOO, all language files and all bundled modules and plugins are updated to the latest version...

Depending on your installed ZOO distribution the apps, plugins and modules are also updated when updating ZOO. So any modifications to the files (PHP, CSS, Images, etc) may be lost. Therefore we recommend to duplicate an existing app (and rename it) rather than editing the original app. Thus if you don't use the original apps your custom app will remain untouched by the update process.

When you've finished the update, clear your browser cache and the Joomla cache. To clear the Joomla cache go to the Joomla administration » Tools » Clean Cache.

If you are facing this error during installation: "Fatal error: Maximum execution time of 30 seconds exceeded in ..... on line ....." you may try to install the component from a directory:

  1. Download the latest ZOO version and unpack all ZOO files to a directory on your pc.
  2. Using FTP, upload this directory to the /tmp directory of your Joomla installation on your webserver.
  3. Go to the extensions installer in the Joomla administration, use the "Install from Directory" option to set the directory of your uploaded ZOO files.
  4. Click on the Install button and Joomla will install it from the given directory.

Update ZOO apps

ZOO apps will be automatically updated when updating ZOO.

The apps are located in the folder /applications in the installation package.

We recommend updating the apps by updating your ZOO component (see first part of the tutorial) but if you want to update a single app just follow these simple steps:

  1. First of all make a backup of your app, so you can recover it at any time.
  2. Go to Components » ZOO » App manager (Tab with gearwheel).
  3. Select the app package file and click on Install.
Be careful, the update will replace any changes you made to the original applications. But it will leave any configuration files untouched (Types and Element Assignments).

To update types manually open the installation package and go to the types folder of the app (applications/APPNAME/types/) and copy all config files.

To update the element assignments manually open the installation package and go to the item renderer folder of each app template (applications/APPNAME/templates/TEMPLATENAME/renderer/item) and copy each positions.config file.

Update ZOO plugins and modules

ZOO modules and plugins will be automatically updated when updating ZOO.

The modules are located in the folder /additional in the installation package.

Documentation on Github

Help us out! If you are feeling that our documentation has errors or can be improved, fork it at Github and send us a pull request. Any contribution is much appreciated. Thank you!