WP Manifestindependent plugin directory
manifest / media / epub-embed

ePub Embed

A WordPress plugin to easily embed eBooks published in the ePub format into your blog posts.

by r-a-y · github.com/hwdsb/epub-embed

★ 12stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/hwdsb/epub-embed/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/hwdsb/epub-embed ↗

ePub Embed is a WordPress plugin, allowing you to upload and embed eBooks in the ePub format into your blog posts.

Recommended: Install the Shortcake plugin to get instant ePub previews in the WordPress editor.

This plugin was developed for the Hamilton-Wentworth District School Board Commons. Licensed under the GPLv2 or later.

How to Use

  1. Activate the plugin.
  2. Create or edit a post. Click on the "Add Media" button.
  3. Upload an ePub file and click on the "Insert to Post" button.
  4. If you installed the Shortcake plugin, you'll see the ePub in the post editor. If not, you'll see an [epub] shortcode. To customize the shortcode, view the "Shortcode parameters" section below.

Shortcode parameters

The following are some custom parameters you can use with the shortcode:

  • "width" - By default, this tries to use your theme's content width. If this doesn't exist, the width is "100%". Fill in this value to enter a custom width.

  • "height" - Enter in a custom height for your ePub file if desired. Defaults to "700". Avoid percentages.

  • "downloadlink" - By default, shows a download link after the ePub viewer. Set to "false" to disable this.

Notes

  • If your WordPress media files are uploaded to the cloud, you'll need to ensure that you configure your bucket to handle CORS correctly.
  • Embedding ePub files with rich media is not 100% accurate. If you must embed ePubs with rich media, ensure that the format is supported on most browsers and ePub readers. For example, for audio, use MP3 instead of M4A.
  • Try to keep the size of the ePub as low as possible, since the entire ePub must be downloaded for processing and embedding.

Thanks