Upgrading to Runway 4
Perch Runway 4 is a new major version of Perch Runway with some big interface changes. A lot of the underlying structure is backwards compatible, so upgrading to Perch Runway 4 is not complex.
Before you start
Follow these instructions to help make your upgrade as smooth as possible.
1. Make a backup
Before making any changes, make a backup of your files and your database. This means that come what may, you can always revert to your current position without doing any damage.
2. Work on your dev or staging site
We don’t recommend upgrading a live site in-place. Not because the upgrade process is risky, but because that’s not the most sensible way to work for any website updates. Get your staging or dev site up to date (perhaps using the backup of the live site you’ve just made) and try the upgrade there first. If all is well, you can deploy those changes to the live site without worrying and with minimal disruption.
With that done, we should be ready to begin.
1. Replace Perch core
Download the latest version of Perch Runway and copy the new
perch/core folder over your old
2. Check your apps file
If you have a very old install to upgrade, your
perch/config/config.apps file might contain lots of
include() statements. You need to update it or you’ll get errors. A basic starting point
apps.php file looks like this:
<?php $apps_list = [ ];
You don’t need the Content or Categories apps listed like in the past. Just add an entry to the list for any add-ons you need installed. For example, an install with Blog and Twitter apps would have:
<?php $apps_list = [ 'perch_blog', 'perch_twitter', ];
3. Remove unnecessary add-ons
Perch Runway 4 contains the MarkItUp and Redactor edits as part of core, so you can remove:
You can remove the default apps, as they’re now internal too:
And update your
perch/config/runway.php file to change the
handler_path for those apps to begin with
'handler_path' => PERCH_CORE.'/runway/apps/perch_dropbox/PerchDropbox_ResourceBucket.class.php',
4. Update your apps
Changes in Runway 4 mean that your Runway 3 apps won’t work without being updated. Therefore you need to download the latest versions of your apps from the new add-ons site.
5. Log in
When you log in to the control panel, the updater will run as usual and you should be all set to go.