Updated on May 10, 2023
SocialEngine is a script written in PHP that aims to cover a certain niche for website development, mainly social networks. Since PHP is involved, you would want to keep your SocialEngine installation always up-to-date. In this post, we will help with the upgrade of your SocialEngine, as well as cover the troubleshooting process of some common errors that may occur after upgrading.
This post includes:
First and foremost, whenever you are making changes to any files and database, always perform a backup. That rule applies to all software, including SocialEngine. If you are not entirely sure how to make a backup of your SocialEngine database and files, contact our technical support team, and they will gladly assist you.
After you have backed up your data, you can proceed with your upgrade. You may refer to our comprehensive tutorial on How to Upgrade SocialEngine.
SocialEngine upload packages have a .tar extension. If you see a .zip file, you are not using the proper upgrade package and will need to download the correct file from the client area. See below for troubleshooting tips if the file won't finish uploading.
Additionally, you need to upgrade the SocialEngine core themes (required after version 4.9.0). To do that, navigate to Appearance → Theme Editor and click Upgrade Theme (version) for each one that has the button as shown.
In the popup that opens, read the warning and note that this will overwrite the theme and remove any changes if you edit the core theme. We recommend making clones of the main themes and working on those, so you don't have any issues with upgrades. Click Upgrade Theme when you are ready to upgrade the theme.
If you find that you can't get the file to upload, it either keeps spinning or keeps saying you've not selected a file; you'll want to have your host raise the PHP settings for
post_max_size as the upgrade file is large. Alternatively, you can use FTP to upload the upgrade file in order to proceed. Mainly in Ubuntu servers, you may see a white screen or an error message about "
cache_dir is not writable" set full permissions on temporary/cache." As the error message suggests, this is an issue with the write permissions of the "temporary/cache" directory.
One way around this problem is to upload the file directly to SocialEngine using an FTP client. Log into your website over FTP and locate the "
/temporary/package/archives/" directory in your SocialEngine path. Upload the tar file to this directory, and set the permissions of the file to 777. Then, proceed to the Manage → Packages & Plugins page. SocialEngine should be able to detect the file and extract its contents, allowing you to proceed with the rest of the installation.
Your server may not have sufficient memory allocated to PHP to upgrade all the packages selected. Try only checking 4 or 5 packages at a time until all packages have been upgraded.
Proceed with caution! You assume any and all risks and liability in customizing your SocialEngine files and in re-applying customizations. SocialEngine does not recommend altering the SocialEngine files. The following basic guide is provided as a general learning tool. SocialEngine assumes no liability for damages to your website as a result of following this guide.
It is recommended that those with advanced experience with the SocialEngine script continue with these steps. If you are a novice or don't know how to edit and/or compare files, you should seek expert help for your upgrade.
In addition to a copy of the SocialEngine files, we recommend that you have the following:
Once you know which files need to be edited, follow the next steps.
Modifications may need to be updated. Be prepared to have to update your own code. Also note that deprecated functions, hooks, and features may have been removed, and your code might not work if it relies on those. You would need to either make new code or seek Expert help in cases like this.
Upgrades are usually mandatory, especially when the security and speed of your website are at stake. Upgrading SocialEngine doesn't take long, and from this guide, you can perform the task with no hassle, so why wait?
We hope you find this article useful. Discover more about FastCloud - the top-rated Hosting Solutions for personal and small business websites in four consecutive years by the HostAdvice Community!