Manually Installing Pressbooks

Pressbooks is a content management system designed for books and OERs that is built on top of WordPress Multisite. You can install the Pressbooks plugin and themes anywhere you can run WordPress, but this guide will make sure you can navigate Pressbooks' various installation requirements.

It is important that not all features of Pressbooks will be available if you try to run it in a typical cPanel account. Pressbooks requires some third-party libraries to enable its export features. These tools are not available on Shared Hosting accounts, but can be installed when setting up Pressbooks on Reclaim Cloud. For this reason, PDF, EPUB, XHTML, OpenDocument, and HTMLBook exports are not supported with Pressbooks on Shared Hosting.

Step 1: Find the required WordPress version and PHP version

Pressbooks has very specific requirements as to what version of their plugin can run on which versions of WordPress and PHP. The best way to find the requirements is to go to the GitHub page for the Pressbooks plugin, and scroll down to the Requirements section.

If you happen to be installing an older version of Pressbooks, you can also find the required version of PHP and WordPress by taking a look at lines 9 and 10 of the plugin's pressbooks.php file.

Step 2: Install a fresh WordPress Multisite using the correct PHP version

Using cPanel

In cPanel environments, you will need to change the PHP version for the domain you will be setting up Pressbooks on, using the MultiPHP Manager tool. We have a guide on how to set this here:

Changing Your PHP Version in cPanel

Once you've set your PHP version, you can use Installatron to install WordPress. Click on WordPress in the Applications section of cPanel.

Next, click Install this application.

On the install page, you will select the desired domain and URL.

Make sure to choose the correct version of WordPress that Pressbooks supports in the Version section.

Under Automatic Update, select Do not automatically update. You will want to decide when to have Installatron run WordPress updates for you manually, otherwise you may have issues with version mismatches between Pressbooks and WordPress.

In the settings section, you will want to make sure to select the option Yes, enable multi-site support for sub-directories of the selected install location.

Finally, click Install at the bottom of the Page.

Using ReclaimPress

Log in to your ReclaimPress account, and create a new WordPress site using the Create New Project button.

You will need to pick a domain name, region to host it in, and subscription plan to use. We recommend using the Diamond plan for Pressbooks sites to make sure they are fast even when they receive large amounts of traffic. After a few minutes, your WordPress site will be ready. If you need to change to a different version of PHP that Pressbooks supports, click on your new WordPress site in the ReclaimPress dashboard, and use the Redeploy button to change its PHP version.

Next, you will want to configure WordPress to be set up as a multisite network. You will need to edit two of your WordPress site's files, which you can access from the File Management tool, and clicking on All.

From here you'll need to follow steps 2, 3, 4 and for from the Create a Network guide on WordPress.org

If you need to change to a different version of WordPress that Pressbooks supports, the easiest way to do this is to first log in to ReclaimPress's advanced interface at https://app.my.reclaim.press. Then click on Add-Ons next to the AppServer node for your WordPress environment.

Find the Install Pressbooks dependencies Add-On from the list, then click Install.

Enter the version of WordPress that Pressbooks requires, then click Install.

Using Reclaim Cloud

Log in to your Reclaim Cloud account, and click on Marketplace. Search for WordPress and install the WordPress Standalone Kit.

Make sure to change the PHP version to the one supported by Pressbooks, and check the box next to Install WordPress Multisite Network. When you are ready, click Install.

After a few minutes, your WordPress site will be ready. If you need to change to a different version of WordPress that Pressbooks supports, click on Add-Ons next to the AppServer node for your WordPress environment.

Find the Install Pressbooks dependencies Add-On from the list, then click Install.

Enter the version of WordPress that Pressbooks requires, then click Install.

 

Step 3: Install the Pressbooks Themes and Plugin

Themes

Download the zip file from the releases page of the McLuhan and Aldine themes as well as any other book themes you would like to use from GitHub.

Log in to your WordPress site, and go to My Sites > Network Admin > Themes.

Click Add New, then Upload theme.

Use the Browse button to select the McLuhan theme (the file name should start with pressbooks-book) you downloaded. After selecting the theme zip file, click Install Now.

Do not Network Enable the theme just yet. Go to the themes page again and repeat this process for the Aldine theme as well as any other book themes you downloaded from GitHub.

Plugins

Download the latest zip from the releases pages of the Pressbooks plugin from GitHub.

Go to My Sites > Network Admin > Plugins.

Click Add New, then Upload plugin.

Use the Browse button to select the Pressbooks plugin you downloaded. After selecting the plugin zip file, click Install Now.

Click Network Activate to activate the Pressbooks plugin and themes.

Step 4: Install Server Dependencies (Reclaim Cloud / ReclaimPress only)

There are several dependencies that Pressbooks requires to enable import and export functionality. Unfortunately, these dependencies are incompatible with Shared Hosting, but they can be automatically installed on Reclaim Cloud with an add-on for your WordPress environment.

First lgo in to Reclaim Cloud or the Advanced ReclaImPress dashboard. Next, to the AppServer node for your WordPress environment, click on Add-Ons.

Find the Install Pressbooks dependencies Add-On from the list, then click Install. Click Install again on the confirmation window that appears.

This add-on will automatically install EpubCheck, Saxon-HE, and the free noncommercial use version of PrinceXML. You should read the End-User License Agreement for PrinceXML before using it to determine if your use case fits into the terms of its noncommercial license. If you wish to remove the watermark from PDF files it creates, or you have a commercial use case, you should buy a license for PrinceXML and follow their instructions to install the license file.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section

See more
Reclaim Hosting Support Hours
8:00 am - 5:00 pm ET, Monday through Friday
Submit a Ticket
Get a quick and helpful response from the pros.
Need Extra Support?
No problem, we're here to help! Talk to us about Professional Services or custom Service Level Agreements.