A Checklist for Upgrading from Shopp 1.0.x and Shopp 1.1.x to Shopp 1.2.x

To take advantage of the latest features and performance, you’ll need to be running a current version of Shopp. If you are using Shopp 1.0.x or Shopp 1.1.x, then you are missing out. Additionally, the Shopp Help Desk supports a current version of Shopp and one version prior. In this post, we’ll share a checklist for upgrading from an old version of Shopp to 1.2.x.

Here is the recommended upgrade path:

Shopp 1.0.x –> Shopp 1.1.9.1 –> Shopp 1.2.x

Important notes:

  • We recommend first performing an upgrade on a staging site. This will help you find any issues and create a plan to correct them.
  • Core plugin changes will not be transferred during the upgrade process.
  • WordPress 3.5.1 will be referenced. If you are running an older version of WordPress, then certain areas of the WordPress admin that are mentioned in the checklist may be different.
  • Shopp product and category ids will change on upgrading from Shopp 1.1.9.1 to Shopp 1.2.x.
  • Child taxonomies are not used in category URLs for Shopp 1.2.
  • Your store will be offline during the upgrade process.

Other notes for checklist:

  • Shopp 1.0.x refers to any version of Shopp under 1.0. For example Shopp 1.0.17 and 1.0.18 could be called 1.0.x. This also applies for 1.1.x (example: 1.1.8, 1.1.9.1) and 1.2.x (example: 1.2.5 or a newer version of 1.2).
  • WordPress admin = wp-admin, templates = shopp content templates

Part 1: Backing Up your WordPress website

As we proceed through the checklist, we’ll recommend you take several backups of your WordPress site. We recommend BackupBuddy for backing up WordPress.

To begin, capture a backup of your entire WordPress site.

Part 2: Upgrade to Shopp 1.1.9.1

Download the latest LEGACY version of Shopp to your computer from your Shopp store account. It will be version 1.1.9.1.

Go to your WordPress admin –> Plugins. Deactivate the Shopp plugin.

Login to your site with an FTP client (if you are on a Mac, check out Transmit).

Browse to the wp-content/plugins/ directory.

Relocate the shopp folder one level above the plugins directory. The new location should be wp-content/shopp/. Then rename the folder for reference. If the folder was for Shopp 1.0.17 then you could rename it to shopp_1017_backup.

Go back to your WordPress admin. Then go to Plugins –> Add New. Click on Upload. Click on Choose File and browse to the location of the shopp.zip file for Shopp 1.1.9.1. This is the legacy version that you downloaded earlier. Select the file and click on Install Now. Wait for upload to complete, then Activate the plugin.

Part 3: Check your Installation of Shopp 1.1.9.1

Now you need to check your products and categories. Are they there?

If so, proceed to the next part of the checklist. If they are missing, restore your site from the most recent backup (Shopp 1.0.x) and complete part 2 again.

Part 4: Upgrade to Shopp 1.2.x

Backup your WordPress site. Earlier you captured a backup for 1.0.x. Now we need one for 1.1.9.1.

Download the latest version of Shopp from your Shopp store account. It will be version 1.2.5.

Go to your WordPress admin –> Plugins. Deactivate Shopp.

Login to your site with an FTP client (if you are on a Mac, take a look at Transmit).

Browse to the wp-content/plugins/ directory.

Relocate the shopp folder one level above the plugins directory. The new location should be wp-content/shopp/. Then rename the folder for reference. If the folder was for Shopp 1.1.9.1 you could rename to shopp_1191_backup.

Now go to your WordPress admin –> Plugins –> Add New. Then upload and activate your Shopp software.

Part 5: Check your Installation of Shopp 1.2.x

Now you need to check your Shopp installation again. The menus in Shopp 1.2.x are different than 1.1.x. Shopp products and categories can be reached via Shopp Catalog.

Return to your WordPress admin and go to Shopp Catalog. Click on Products. Do you see your Shopp products? Go to Shopp Catalog –> Categories. Do you see your Shopp categories?

If so, proceed to the next part of the checklist. If they are missing, restore your site from the most recent backup (Shopp 1.1.9.1) and complete part 4 again.

Part 6: Restore any Payment Gateway, Shipping, or Storage Add-ons

The latest add-ons for Shopp can be downloaded from your Shopp store account.

They cannot currently be installed through WordPress Plugins. You will need to unzip them and use your FTP client to upload them. Refer to the locations below:

  • payment gateway add-ons –> wp-content/plugins/shopp/gateways/
  • shipping add-ons –> wp-content/plugins/shopp/shipping/
  • storage add-ons –> wp-content/plugins/shopp/storage/

Next, go to your WordPress admin and configure your Shopp add-ons.

The settings page for payment gateways can be located via Shopp Setup –> Payments. The settings page for shipping modules can be found via Shopp Setup –> Shipping –> Rates. The settings area for storage add-ons can be reached via Shopp Setup –> System.

Part 7: Update your Shopp Templates and Menus

Your templates will need updating. Go to Shopp Setup –> Presentation. Then click on the reinstall templates button. This will add any new templates (for Shopp 1.2.x) to your content templates folder at wp-content/themes/yourthemefolder/shopp.

If you only have minor customizations to the templates, then we recommend starting with a new set of templates and migrating your customizations over.

Refer to this document on updating templates for Shopp 1.2.x.

To have Shopp create a new set of templates, go to the templates folder (wp-content/themes/yourthemefolder/shopp) via FTP and rename “shopp” to something else such as “shopp1.” Then create a new shopp folder in the same place and set folder permissions so WordPress can write to it (typically 755 or 775).

Return to the WordPress admin and go to Shopp Setup –> Presentation. Click the button to reinstall a new set of templates. Then you can compare the template files via FTP and migrate your customizations.

Shopp 1.2.x does not use WordPress pages with short codes. They are virtual. Go to the WordPress admin. Remove any old Shopp pages via WordPress Pages. Then go to Appearance –> Menus and add Shopp links to your website navigation. Be sure to save changes. If you don’t see Shopp content in WordPress Menus, toggle Screen Options in the top right and place checkmarks in the options that you want to make available.

Part 8: Fix any Remaining Issues and Test Your Store

Once your templates are updated, buy some items from your store to test Shopp checkout. Here are some things to check:

  • Was the order recorded in Shopp Orders?
  • Did you receive an email notification?

Next, setup permanent redirects (301) for Shopp category URLs that have changed using the Redirection or a similar plugin.

Security, Performance, and Marketing Recommendations

  • How fast does your website load? Find out now with a WordPress speed test.
  • Upgrade to the latest version of WordPress.
  • Deactivate and remove any plugins that are not necessary for your store.
  • Audit your remaining plugins with the P3 Performance Profiler plugin. Then deactivate and replace the slowest plugins with faster alternatives from the WordPress plugins directory.
  • To improve performance in your online store, switch from database to file system storage. Shopp Image Tools can help you migrate your images.
  • Add an email marketing integration to your Shopp.

Notes: Official Shopp documentation on upgrading to 1.2.xChris Runnell’s guide to upgrading from 1.1.9.1 to 1.2.3


Filed Under: Tips & ResourcesTagged With: upgrade shopp 1.0.xupgrade shopp 1.1.xupgrade shopp plugin

A Checklist for Upgrading from Shopp 1.0.x and Shopp 1.1.x to Shopp 1.2.x