Premium Plugin Installation

Premium plugins are installed a little differently than the free plugins you may be used to from WordPress.org.

This document explains how to install or upgrade your plugins.

Warning: Don’t Use Automatic Update

If you’ve deactivated your Pro plugin, you may see a prompt to ‘update automatically’. Do not click it! It will overwrite your premium plugin with the free version from WordPress.org. Here’s an example of the prompt for the MapPress plugin:image

Backup

If you’ve made any changes to files in the plugin directory be sure to back them up.  WordPress will delete the entire plugin directory before installing a new version.

Upgrades

If you’re upgrading a plugin that is already installed, you’ll need to delete the old version first.

Tip: don’t worry, you won’t lose your maps when you delete the plugin.  Maps are saved in the database.
  1. Log in to your blog
  2. From the dashboard, go to the menu Plugins -> Installed Plugins.
    image
  3. Find the old version of your plugin and click the ‘Deactivate’ link to deactivate it.  Then click the ‘Delete’ link to delete it.
    image

Installation

  1. Log in to your account at http://wphostreviews.com
  2. You’ll see a menu item to go to “Your Account”. Click it.
    image
  3. In your account you should see all of the versions of your plugin. Click on the version you want to download it.
    image
  4. Save the plugin .zip file to your computer.
    image
  5. Log in to your blog
  6. From the dashboard, go to the menu Plugins -> Add New
    image
  7. You should now be at the WordPress ‘Install Plugins’ screen.  Click the ‘Upload’ link.
    image
  8. WordPress will ask you where the plugin file is. Use the ‘browse’ button to find it (wherever you saved it in step #4). Then click ‘Install Now’.
    Tip: If you’re using Safari on a Mac, be sure to turn off automatic unzipping first (see ‘Troubleshooting’ below).
  9. WordPress should now automatically install your new plugin!

Troubleshooting

  • Bad Zip File in Safari
    If you’re using a Mac, Safari is often set to unzip .zip files automatically.  If this happens you’ll see the plugin as a folder on your desktop rather than a .zip file and you won’t be able to install (you’ll get an error like ‘PCZIP_ERR_BAD_FORMAT‘).You can turn off automatic unzipping for one download by control -clicking on the file link and choose “Download Linked File as…”.  Or, you can turn it off permanently using:
    Safari->Preferences->General
    Uncheck “Open Safe Files After Downloading”
  • Destination folder already exists
    If you get this error when installing, it’s because the old plugin version needs to be deleted before installing the new one.  See the ‘Upgrades’ section above.
  • Blank Screen after Installation
    If you get a blank screen after installation, don’t panic – there is a compatibility problem or conflict with the new plugin version.  Use an FTP client to delete the plugin directory and your blog should return to normal.