Upgrading

Upgrading to Pressbooks 5.x

Pressbooks 5.0 requires McLuhan, our new default book theme. McLuhan takes the place of Luther, and will replace the theme currently known as Luther when you install the latest update on your Pressbooks network. To keep using Luther, you must make sure to install the new standalone version of Luther and network activate it on your Pressbooks network before you upgrade to Pressbooks 5.0 and McLuhan. If you do this, books that were using Luther will be switched to the new standalone version automatically. If Luther is not installed or network active when you upgrade to Pressbooks 5.0, you may have to switch books to Luther manually.

Steps

  1. Verify that upgrade are available for Pressbooks (to version 5.0.0) and Luther (to version 2.0.0).
  2. Install Luther 1.8.2 and network activate it. You will now have two versions of Luther installed (sorry).
  3. Run the upgrades for Pressbooks and Luther. This will replace the old Luther with McLuhan and switch any books that were using it to Luther 1.8.2.

Upgrading from Pressbooks 3.x to Pressbooks 4.x

Autoloader

Pressbooks 4.0 (and our other open source plugins) rely on the Human Made autoloader, which is bundled with the Pressbooks plugin. Before you can use Pressbooks 4.0, you will need to copy the file from:

/path/to/your/site/wp-content/plugins/pressbooks/hm-autoloader.php

To:

/path/to/your/site/wp-content/mu-plugins/hm-autoloader.php

This will make it available to Pressbooks and any other plugins that require it. You may need to create the wp-content/mu-plugins/ directory if it doesn’t yet exist.

Themes

Pressbooks >= 4.0 requires that themes previously bundled with Pressbooks 3.x be installed separately. For installation instructions, consult the README file of the theme(s) you need to install below. (NOTE: theme folders must not have version numbers on the end. GOOD: pressbooks-publisher. BAD: pressbooks-publisher-3.1.0. If you are installing manually, make sure that you rename the folders appropriately.)

Two themes are required for all Pressbooks installations:

The remaining themes are recommended but optional, and they are required if you used them on Pressbooks 3.x:

Edit this post on GitHub.