26.MediaLibrary 1.5.x Shop upgrade instructions

In this article you will find the instructions on how to upgrade from a previous version of MediaLibrary while still preserving all your existing MediaLibrary data.

General Guidelines (common sense) .

Always test upgrades first in a test environment, never in your live environment

Always make sure you have a good, recent backup before making changes

Always make backup for yours site files and database

Make regular XML exports of all categories in your MediaLibrary installation (to preserve your Media entries)

Recommended Upgrade Shop procedure

Fresh installation

Make XML exports of every category in your current live installation, and save with the category name

Copy your Media covers to a local directory from  /components/com_MediaLibrary/covers

Copy your eMedia files to a local directory from


Install MediaLibrary Free Edition in a test environment

Delete existing Medias and categories in the test environment

Recreate each category, the same as in your live environment, in the test environment

Import all XML exports made earlier into the appropriate categories

Copy your Media covers from the local directory to


Copy your eMedia files from the local directory to


Set the rights on the covers to 0644

Set all config settings as in your live environment

TEST and TEST again

If all is OK, then (and only then) proceed to repeat the procedure in your live environment.

Replacing the files in your installation

If you decide to overwrite the files in your existing installation instead (not really recommended), then follow the guidelines below.

1. If you DO NOT have shell access (command line) to your server through SSH

(e.g. shared hosting):

unzip the patchfiles somewhere

use Quixplorer, eXtplorer, Joomla 1.5 internal FTP, or similar inside Joomla

using these tools, copy the original files somewhere or rename them (e.g. with date behind them)

delete the original files

upload the new files to the proper directories using Quixplorer, eXtplorer (or Joomla internal FTP)

file ownership for the new files is automatically set right because you work inside Joomla

set the filerights on the new files to 0644 (= read/write by owner, read by group, read by others)

2. ONLY use the method below if you have shell access to your server through


unzip the patchfiles somewhere

copy the original files somewhere or rename them (e.g. with date behind them)

delete the original files

upload the new files to the proper directories using an FTP client like

FileZilla or CuteFTP or similar

set the file ownership for the newly uploaded files to the account your web server runs under (find out first!)

set the filerights on the new files to 0644 (= read/write by owner, read by group, read by others)

Upgrade Instructions from previous MediaLibrary versions .

To keep your MediaLibrary Medias data when upgrading from a previous version (deinstall-reinstall), please follow the instructions below. This will restore all existing Media data (including descriptions and reviews) to your new MediaLibrary

1.5.x Shop installation.

1. Using an FTP client or similar, copy the Media covers

from /components/com_MediaLibrary/covers/ somewhere safe.

2. Using an FTP client or similar, copy the eMedia files

from /components/com_MediaLibrary/emedia/ somewhere safe.

3. Write down your category and subcategory names and structure.

4. IMPORTANT! To keep all your edited Media descriptions in the new MediaLibrary, make very sure you set [Information from] for EVERY single Media to "On your own".

5. Do XML exports from each of your Media categories. Right-click the XML-url and save with the category name.

6. Repeat the process until you have XML exports for all your categories somewhere safe.

7. Deinstall the old version of MediaLibrary.

8. Install MediaLibrary 1.5.3.x Shop with the Joomla component installer.

9. Recreate each of your categories and subcategories using the MediaLibrary [Category Manager].

10. IMPORTANT! If you want to keep your original Media descriptions, please do the following. In [Configuration Backend] set the [Default Host] to "On your own".

11. Import each of the exports you made earlier into the proper Media


12. Copy the previously saved Media covers to


13. Copy the previously saved eMedia files to


14. Set the rights on the covers you just copied to 0644

15. Set options in [Configuration::Backend] and

[Configuration::Frontend]. There are quite a few new options, so

please check!

16. Publish the Medias in [Media Manager].

17. Your frontend will now have all Categories and the Medias in them again with all the original data.


As mentioned, MediaLibrary 1.5.x Shop now also fetches Media Descriptions (Editorial Reviews) from Amazon. This means that whenever you do [Refetch Information] for a Media from Amazon, your edited Media Description will get overwritten!

To avoid this, set Medias (after editing your descriptions) to "On your own" in the [Edit Media] interface for each Media. This will prevent changes to your Media details.

The current 1.5.x Shop versions of MediaLibrary also supports full XML exports, so future upgrades will be relatively painless. Still, we recommend using the XML export-import method, as it gives you much greater control over what goes where in your new installation. Full XML exports are great for quick total backups within the same MediaLibrary version.

What are you looking for?
Anti-spam question: How many eyes has a typical person?