Store
Community Documentation

v3 Knowledgebase

Upgrading the Product from v2 to v3

This article is only intended if you are upgrading from v2 to v3.

Notice: Be sure to backup your site and your database before attempting to upgrade.

Running step 14 more than one time will mess up your site. Running step 16 more than one time will mess up your site.

If you want to save the hassle of upgrading your website, just order the Upgrade Service and our technicians will do it for you!

After some tests performed by me and by data66, we have found that some extra steps are needed to perform a proper upgrade from v2 to v3.

The steps from 1 to 10 are required because most of the add-ons for phpFox v2 are not compatible with phpFox v3, causing problems during the upgrade.

Here is the list of steps you need to perform to complete your upgrade properly:

1. Disable every non-default or 3rd-party plug-in from the plug-ins list, by removing the checkbox from the "active" column, and then clicking on "update". This can be done into at:
AdminCP >> Extension >> Plugins >> Manage Plugins


2. Remove every non-default or 3rd-party module from the modules list, by clicking on the drop-down icon next to the module and selecting "uninstall". This can be done into at:
AdminCP >> Extension >> Modules >> Manage Modules


3. Remove every non-default or 3rd-party product from the product list, by clicking on the drop-down icon next to the product and selecting "Delete". This can be done into at:
AdminCP >> Extension >> Products >> Manage Product


4. Move all 3rd-party folders out from the folder "module/" on the server as well. For example, create a folder called "backups" outside the folder "module/" and move all the 3rd-party folders from here to "backups".


5. Revert back to the default theme. This can be done at:
AdminCP >> Extension >> Themes >> Manage Themes


6. Disable all 3rd-party themes in the same place:
AdminCP >> Extension >> Themes >> Manage Themes


7. Revert to default all template & css changes performed to the default theme through the AdminCP. This can be done at:
AdminCP >> Extension >> Themes >> Manage Themes >> (click on drop-down icon next to the default theme) >> Edit Templates

Look for all templates marked in red (modified) and select "revert" at the bottom of the text box.


8. Clear the site's cache.


9. Check for errors (enabling the debug mode) in the home page of your site, the AdminCP, the profile pages and any other page you consider necessary.


10. In case you have custom blocks, disable all of them. This can be done at:
AdminCP >> CMS >> Blocks >> Manage Blocks

There is no need to delete them, just disable them by clicking on the green button next to the block (it will turn red when the block is disabled).


11. At this step, follow the normal instructions to upgrade the site.


12. If you are upgrading to Beta 5, follow the instructions found in this bug report: http://www.phpfox.com/tracker/view/7850 (by Raymond Benc):
Quote:

Temporary fix is to download this ZIP file:
http://50.57.108.11/file/attachment/fix-theme2.zip

This contains 1 PHP file that needs to be uploaded to your sites root directory. The name of the file is "fix-theme.php".

Once you have uploaded the file to your sites root visit the file via your web browser. Example: http://www.yoursite.com/fix-theme.php

Once you execute the script it should say "Done!". Visit your site and see if you can now load the default v3 theme.

Note this script will remove all themes/styles and install the supported default styles we provide.

Please remove this file after you have used it.

Addressed in 3.0.0RC1.

13. Once upgraded, turn your site offline, to proceed with the next steps:
AdminCP >> Settings >> System Settings >> Global Settings >> Site Offline/Online


14. After that, run the option Update Privacy for v3 Upgrade (Only run this if you have just upgraded to v3 and make sure to only run this once.) at:
AdminCP >> Tools >> Counters


15. Clear the site's cache one more time.


16. Run the option Import Groups from v2 to v3 Pages (Only run this if you have just upgraded to v3 and make sure to only run this once.) at:
AdminCP >> Tools >> Counters


17. Clear the site's cache again.

Not working? Best would be to get the "Upgrade Service" and our technicians will upgrade it for you.