User Tools

Site Tools


how_to_upgrade

How To Upgrade LiteCart

To upgrade LiteCart simply download the latest master release from the official website and follow the instructions inside the UPGRADE.md file. Particular knowledge in hosting your own applications is needed. For example configuring Apache2, setting up accounts and access for FTP, MySQL, files and folder permissions, etc.

How To Prevent Losing Your Changes

When upgrading, the only changes you will lose are are hard modified core files. By hard modifications we mean the actual core files themselves and not soft modding through vQmod. Please note any third party files are not overwritten by upgrading.

The only way to prevent losing your hard modifications is to turn them into soft modifications by converting them to vQmods.

How To Transfer Your Modifications Into vQmods

  1. Download an unmodified zipped archive of LiteCart (same version as you are running). And unzip it on your local drive.
  2. Use a file comparison software such as WinMerge to compare the untouched set of files against your modified set of files.
  3. Files that show conflicts are assumingly files you have modified. Create a vQmod that performs the same changes and restore your modified files to the original. See: How To Create a vQMod
  4. You are now good to go and can easily carry modifications between platforms.

Will My Add-ons and vQmods Stop Working?

Both yes, and no. Some will be affected, some not. It all depends on what changes were made to the new version of LiteCart. This is a perfectly natural cause from upgrading. If an add-on or modification stopped working it indicates that there most probably were changes made to LiteCart to improve the original feature, and for users' best experience.

We recommend running a development platform for testing. Meaning an exact copy of your production but used for experimenting. The Add-ons Store has a great tool for transfering changes between the two platforms, see Deploy Changes.

All application errors are logged in the ~/data/errors.log file. When loading a page with errors, append ?debug to the URL and you should see extended information regarding the error.

how_to_upgrade.txt · Last modified: 2017/07/17 23:14 by admin