Upgrade

Phspark is periodically updated with new versions of itself. It is a good idea to update your website with each new version released to take advantage of bug fixes and new features. It may seem like a hassle to update the site every time a new version comes out, but it is worth the effort in the long run. There are ways to avoid the pain of upgrades, such as using quality themes and modules that do not modify your Phspark core, or using PSMod/vQmod.

This guide will explain how to upgrade from the v1.x.x up to the latest version.

Requirements

Web Server (Apache suggested), PHP version 7.3 or higher is required, Database (MySQLi suggested) with the following extensions installed:

• [PDO](https://www.php.net/manual/en/book.pdo.php)

• [intl](http://php.net/manual/en/intl.requirements.php)

• [curl](http://php.net/manual/en/curl.requirements.php) if you plan to use the HTTPCURLRequest library

• zip

• zlib

• GD library

• [mbstring](http://php.net/manual/en/mbstring.installation.php)

• mcrypt

Updating from 1.x.x to 2.x.x

1. Download the latest version of Phspark and upload ALL new files on top of your current install EXCEPT your config.php and backend/config.php.

   • Before upgrade the latest version, you should double check the existing extensions, themes are compatibility with latest version or not. Please contact the developer for enquiry before you upgrade.

   • Before upgrade the latest version, You should set your website theme to default theme and disabled all of the extensions first.

2. Browse to https://[yourwebsite.com]/install Replacing yourwebsite.com with your actual site (and subdirectory if applicable).

3. You should see the Phspark Upgrade script.

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

4. 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.

5. Clear any cookies in your browser

6. Goto the backend side of your website 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 backend as the main administrator.

7. Goto Backend -> Human Resources -> Roles and edit the Top Administrator group. Check All boxes.

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

8. Goto Backend -> Extensions -> Extensions -> Theme enabled and save the default theme again.

9. Goto Backend -> 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.

10. 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.

11. Load the website 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 8, you may get the error message.)

12. If you use vQmod (by now everyone should be) you should first check for a new version at http://vQmod.com. Be sure to download the version that is marked for “phspark”. You will also need to re-run the vQmod installer, even if you have the latest version. You should already have the installer on your site as it isn’t meant to be deleted from the first time you run it. Simply browse to: http://yoursite.com/vqmod/install and you should see a success message. If you do not see a success message, follow the full install guide from the http://vQmod.com site.

Note that some of your vQmod scripts may need to be updated for the new core changes. So run through your site catalog and backend areas and check in FTP for the vqmod/vqmod.log file. If you see errors, then you will need to address them.

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 Phspark. 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.

That’s It!

Phspark Dev Team