22. MediaLibrary 3.5.x Shop upgrade instructions

In this article you will find the instructions about how to upgrade from a previous version of MediaLibrary with saving all your existing MediaLibrary data.

General Guidelines

  • Always test upgrades first in a test environment, never in your work 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

New installation

  • Make XML exports of every category in your current 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 /components/com_MediaLibrary/emedia.
  • 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 work environment, in the test environment.
  • Import all XML exports made before into the appropriate categories.
  • Copy your Media covers from the local directory to /components/com_MediaLibrary/covers.
  • Copy your eMedia files from the local directory to /components/com_MediaLibrary/emedia.
  • Set the rights to 0644 on the covers.
  • Set all config settings as in your work environment.
  • TEST and TEST again.

If all is OK, then (and ONLY then) proceed to repeat the procedure in your work 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.

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 3.x 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).
  1. ONLY use the method below if you have shell access to your server through SSH:
    • unzip the patchfiles somewhere.
    • copy the original files somewhere or rename them (e.g. with date behind them).
    • delete the original files./li>
    • 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.

  • Using an FTP client or similar, copy the Media covers from /components/com_MediaLibrary/covers/ somewhere safe.
  • Using an FTP client or similar, copy the eMedia files from /components/com_MediaLibrary/emedia/ somewhere safe.
  • Write down your category and subcategory names and structure.
  • 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".
  • Do XML exports from each of your Media categories. Right-click the XML-url and save with the category name.
  • Repeat the process until you have XML exports for all your categories somewhere safe.
  • Deinstall the old version of MediaLibrary.
  • Install MediaLibrary 3.5.x Shop with the Joomla component installer.
  • Recreate each of your categories and subcategories using the MediaLibrary [Category Manager].
  • 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".
  • Import each of the exports you made earlier into the proper Media categories.
  • Copy the previously saved Media covers to /components/com_MediaLibrary/covers/.
  • Copy the previously saved eMedia files to /components/com_MediaLibrary/emedia/.
  • Set the rights on the covers you just copied to 0644.
  • Set options in [Configuration::Backend] and [Configuration::Frontend]. There are quite a few new options, so please check!
  • Publish the Medias in [Media Manager].
  • Your frontend will now have all Categories and the Medias in them again with all the original data.

As mentioned, MediaLibrary 3.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 3.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?