ContextQMD
Back to Opencart

Upgrading from version 2.x.x

UPGRADE.md

4.1.0.33.6 KB
Original Source

Upgrading from version 2.x.x

  • For existing installs only
  • Don't use with previous versions

For previous versions

If you have 1.5.x and want to upgrade to 3.0.x, You may try to contact our dedicated support

Step by step

  1. BACKUP YOUR EXISTING STORE FILES AND DATABASE!!

    • Backup your database via your store Admin -> System -> tools -> Backup
    • Backup your files using FTP file copy or use cPanel filemanager to create a zip of all the existing opencart files and folders

  2. Download the latest version of OpenCart and upload all new files on top of your current install except your config.php and admin/config.php.

    1. Backup and Remove all of 2.x.x views files. Because OpenCart 3 is start to use TWIG to replace the TPL format.
    2. Watch this video to understand how to properly upload folder using FTP: http://docs.opencart.com/en-gb/upgrading/
    3. Before upgrade the latest version, you should double check the existing extensions (in your store) are compatibility with latest version or not. Please contact the developer for enquiry before you upgrade.
    4. Not only the extensions, all the themes in OpenCart 2 cannot use in OpenCart 3. You should set your store theme to default theme and disabled all of the extensions first.

  3. Browse to http://<yourstore.com>/install Replacing <yourstore.com> with your actual site (and subdirectory if applicable).

  4. You should see the OpenCart Upgrade script.

    • If you see the OpenCart Install page, then that means you overwrote your config.php files. Restore them from your backup first. Then try again.

  5. Click "Upgrade". After a few seconds you should see the upgrade success page.

    • If you see any errors, report them immediately in the forum before continuing.

  6. Clear any cookies in your browser

  7. Goto the admin side of your store and press Ctrl+F5 or Ctrl+Shift+R for several times to refresh your browser cache. That will prevent oddly shifted elements due to stylesheet changes. Login to your admin as the main administrator.

  8. Goto Admin -> Users -> User Groups and Edit the Top Administrator group. Check All boxes.

    • This will ensure you have permissions for all the new files

  9. Goto Admin -> Extensions -> Extensions -> Theme enabled and save the default theme again.

  10. Goto Admin -> System Settings

    • Update any blank fields and click save.
    • Even if you do not see any new fields, click save anyway to update the database with any new field names.

  11. Other Adjustments that may need to be made, depending on which version you are upgrading from and to. These are broken down by which version they were added in. So if you are not currently at that version, you may need to make changes

  12. Load the store front and again press CTRL+F5 3x times to refresh your browser cache. That will prevent oddly shifted elements due to stylesheet. (If you skip step 9, you will get the error message.)

Troubleshooting:

  1. If you have any upgrade script errors, post them in the forum
  2. If you have 3rd party addon errors, contact the mod author for an update.
  3. If you find bugs, check the "official" bug thread for this version of Opencart

Many bugs may have already been reported and fixes will be offered in the first post of this thread. You should always visit this thread immediately after a fresh upgrade to see if there are any immediate bug fixes If nobody has reported your bug, then please report it.

An online version of this file can be found here: http://www.opencart.com/index.php?route=documentation/documentation&path=98