Guides

Checklist for Successfully Upgrading PHP

This document serves as a comprehensive guide for users to successfully upgrade to PHP 8.3 and ensure that their Spaces plugin is updated and compatible with this new version. As of January 1 2025, PHP will no longer support versions earlier than 8.3, it is important to follow these guidelines for a smooth transition.

Suggest Edits

Before starting the upgrade, please ensure that:

  1. You have access to a staging version of your site. We recommend testing upgrades here before proceeding with your live site.
  2. A restorable backup of your site is created before making any updates to plugins or themes.
  3. You've downloaded the latest version of Spaces here
  4. Clients may or may not have an option to upgrade PHP, which may be done through their host with some lead time. Check that your theme and other plugins are compatible with the version of PHP you are upgrading to. Just because Spaces will run on PHP 8.3 does not mean that everything else will. Depending on the source of the plugin or theme, it may take some time for each vendor to upgrade to new PHP versions.
    • Timber: If your theme or another plugin you use also uses Timber and is on the 1.x plugin version, upgrade to the composer-based 2.x version of Timber. Using the old version in combination with Spaces is not supported.
    • ACF: If your site or theme used the Advanced Custom Fields Pro plugin before installing Spaces, either upgrade to the version supplied with Spaces or ensure your plugin is at least on version 6.3.8, which is the most recent version at the time of writing.

Upgrade Steps

  1. Backup Your Site

Ensure that you have a complete and restorable backup of your site. This will help you restore your site to its previous state in case anything goes wrong during the upgrade.

  1. Download the Update

Download the latest version of the Spaces plugin here.

  1. Install the Plugin
  • Log in to your WordPress dashboard.
  • Navigate to the Plugins section.
  • Click on Add New and then select Upload Plugin.
  • Upload the ecs-spaces.zip package.
  • When prompted to confirm the overwrite, select Replace current with uploaded.
  • Update Global Settings

After installation, navigate to the Global Settings page found under the Spaces menu.
Click the Update button to refresh styles and initialize new fields.

  1. Manage Assets
  • Go to SPACES -> Spaces Assets.
  • Click on the asset name in the index to view its details.
  • Select Clear SPACES Data Cache and then proceed with Import Sightmap Data.
  • The import process will take approximately 5 minutes, depending on the number of floor plans and units. An
  • email notification will be sent to the site administrator once the process is complete.
  • If you have multiple SPACES Assets, repeat these steps for each asset as needed.
    Final Steps

Once the upgrade is complete, SPACES should now be upgraded to the newest version.

Common Issues and Troubleshooting

  1. Appearance Issues:
  • If the front-end of your site does not appear as expected, double-check the customization values entered in the CMS. Ensure that each color code starts with a # symbol (e.g., #ffffff for white).
    Virtual Tour Group or Unit Description Group:
  • If you are unable to select a Virtual Tour Group or Unit Description Group, please contact support to enable this feature for your account.
    Feedback

By following these steps and guidelines, you can ensure a smooth upgrade process for the Spaces plugin.

Updated 7 months ago