Let professionals install TastyIgniter for you! Learn more

  Documentation
  Help Center
  Premium Support
  Support Services
  Contact
Select A Version
v4.x Latest (v3.x)

Upgrade Guide

As of TastyIgniter 2.0 or later, When a new version of TastyIgniter is available you will receive an update message in your TastyIgniter Admin Panel. All you have to do to update TastyIgniter is to click the Update notification button at the right top. After that you will be redirected to the Update Center page.

There are two methods for updating - the easiest is through the Update Center, which will work in most cases. If it doesn't work, or you just prefer to be more hands-on, you can follow the manual update process.

This is a huge release. It contains a massive change in the codebase from CodeIgniter to Laravel with some new features and plenty bug fixes.

Listing all the improvements in v3 would be great but its a lot I lost track. So straight to upgrade!

  1. Follow the back up TastyIgniter steps below to back up your files and database.
  2. Delete all your existing v2+ files
  3. Follow the quick installation instructions to install a fresh instance of v3.x.x
  4. Make sure you enter the credentials for the database where your v2 data are stored, to upgrade the data structure.
  5. Access your newly upgraded website.
After UPDATE make sure your layout modules are displaying on the storefront. You can use the new layout modules drag and drop under Design > Layouts.

Before you get started, it's a good idea to back up your website. This means if there are any issues you can restore your website.

Visit your TastyIgniter admin page at /admin. Go to Maintenance under System -> Tools and Select tables to backup then click the Backup button. On the next page, make sure Add DROP TABLE statement is No, click the Backup button again and your backed up database file will appear under the Exisiting Backups Tab. You can download and keep the file on your computer.

Backup your files using FTP clients or cPanel file manager to copy or create a zip of all the existing TastyIgniter files and folders.

Visit your TastyIgniter admin maintenance page. Under Exisiting Backups tab click the Restore button next to the database backup you wish to restore.

If the one-click upgrade doesn't work for you, don't panic! Just try a manual update.

  1. Get the latest TastyIgniter zip file
  2. Unpack the downloaded zip file
  3. Open the unpacked folder TastyIgniter-2.x.x
  4. Locate and delete the database.php file in system/tastyigniter/config/ folder
  5. Using your FTP client, upload all the files and folders inside the TastyIgniter-2.x.x folder to your web host. Uploading all the files might take a few minutes on the FTP client.
  6. Do NOT replace/overwrite your existing system/tastyigniter/config/database.php file.

After uploading the files of the new version to your web host, visit the setup page at "/setup" like: www.myrestaurant.com/setup. Following the instructions on the setup page will update your database to be compatible with the latest code.

Clear your site (if enabled) and browser cache at this point so the changes will go live immediately. Otherwise, visitors to your site (including you) will continue to see the old version (until the cache updates).

Your TastyIgniter installation is successfully updated..

  1. BACKUP YOUR EXISTING STORE FILES AND DATABASE!!

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

  2. Download the latest version of TastyIgniter and upload ALL new files on top of your current install EXCEPT your system/tastyigniter/config/database.php.

    • Make sure your system/tastyigniter/config/database.php old file was not overwritten.

  3. Go to http://myrestaurant.com/ Replacing myrestaurant.com with your actual site (and subdirectory if applicable).

  4. You should see the TastyIgniter Setup script.

  5. Click Continue. After a few seconds you should see the installation success page.

    • If you see the database configuration and/or site settings TastyIgniter Setup page, then that means you have replaced your old system/tastyigniter/config/database.php file. Restore them from your backup first. Then try again.

  6. Clear any cookies in your browser

  7. Go to the administrator panel and login as the main administrator. Press Ctrl+F5 3x times to refresh your browser cache. That will prevent oddly shifted elements due to stylesheet changes.

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

  8. Go to 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.

If you have any upgrade script errors, post them in the forum You should always visit the forum immediately after a fresh upgrade to see if there are any immediate bug fixes If nobody has reported your bug, then please report it.

Did this answer your question?
See a mistake? Edit this page
Help Center

Read our extensive documentation and tutorials.

Community Forums

Get support from other members of the TastyIgniter community.

Developer chat on Discord

Chat live with other developers on the official TastyIgniter Discord.

Twitter

Follow the TastyIgniter Twitter account for news and updates.

Continue