This guide will explain step by step how to upgrade from Projectfork 2.1 to 3.0. Please read and follow this guide very carefully! If you are already using Projectfork 3.0.x, please read the "How to update 3.0" document instead.
Things you should know before performing the upgrade
- The upgrade will overwrite every single file. If you have modified the code, these changes will be lost.
- If you have manually modified the database tables (added/removed a field), the upgrade may fail.
- The theme will be reset to new default theme because 2.1 themes are not compatible with 3.0.
- The language will be set to "english" for all users because 2.1 languages are not compatible with 3.0.
- Third party extensions will be disabled - not deleted - so you can upgrade them after having upgraded to Projectfork 3.0.
- If you rely on third party extensions, please make sure you gather all necessary extension updates before upgrading!
- Projectfork 3.0 requires PHP 5! Check your version in Joomla by going to: Backend -> Help -> System Info
Should something go wrong during the upgrade procedure or if you have further questions before migrating to 3.0, please tell us in the forum! We also recommend you read through this guide once, before starting the actual upgrade.
1. Site and extension preparations
You should put your website into offline mode (Joomla Backend -> Site -> Global Config). This is necessary to prevent any kind of intervention from other users. Alternatively, you can perform the upgrade locally and push the site back online afterwards (Advanced users and devs only). Next, you should lookup any non-core extensions you have installed and get in touch with the developers to see if any upgrades are available. These upgrades can be installed after the Projectfork 3.0 upgrade. If you are using an official Projectfork premium extension, upgrade and instructions are provided further below in this guide.
2. Take a full site backup
The migration from 2.1 to 3.0 performs a lot of file and database changes. If anything goes wrong at all, you run risk of losing data (or access to it). Please create a backup of your Joomla database and files! And keep it too. Do not delete the backup after the upgrade (in case you experience problems any time later). A great tool for this is Akeeba Backup, especially if you are new to backing up Joomla sites.
3. Download Projectfork 3.0
Download the latest Projectfork 3.0 full version release from the downloads page. Then unpack the content of the package into a temporary folder on your PC.
4. Upload the files
In the temporary folder you should see 2 folders and 4 files:
- "administrator" folder
- "views" folder
- index.html
- projectfork.php
- projectfork.xml
- router.php
Upload the "administrator" folder into your joomla root directory (there should be an "administrator" folder too) and overwrite all existing files. Then upload the 2 files "projectfork.php", "router.php" and the "views" folder from the temporary folder into "<joomla_root>/components/com_projectfork" and overwrite the existing files. And finally, upload the "projectfork.xml" to: "<joomla_root>/administrator/components/com_projectfork" and overwrite the existing file.
5. Perform the upgrade
Access your Joomla site backend, then navigate to: "Components -> Projectfork" and follow the instructions. Once the upgrade is done, should be able to see the new Projectfork 3.0 with a welcome message at the top. It may occur that the interface is broken. If that's the case, clean your browser cache and reload the page.
6. Upgrade extensions
If everything works ok, you can now continue by upgrading all your extension you've had installed in Projectfork 2.1. Upgrade instructions for our 2.1.x premium extensions are listed below. For all other third party extensions, please contact the corresponding author for updates and assistance (you should do that before upgrading Projectfork though).
- Activity Stream
- File Manager Pro
- User Status Panels
- Subscribe Messages Process
- Community Builder Integration
- JomSocial Integration
- Projectfork Joomla Modules
7. Upgrade themes
To upgrade your themes, you'll have to do a fresh install of the lastest theme. All theme records in the database are deleted during the upgrade - So no one enables an outdated theme by accident, not knowing that it will break the site. Before you can install the latest version of any theme you have installed, you must first delete all folders except the "default" in: "<joomla root>/administrator/components/com_projectfork/themes". Once you have that, you can re-install the themes in the Projectfork config. If you have any questions before doing so, or if run into difficulties, please let us know in the approriate forum:
8. Don't forget to...
... put your website back online ;)
