search

cmroanirgo / epub-reader

An ePub Reader plugin for WordPress
GNU General Public License v2.0
19 stars 6 forks source link
epub-reader wordpress-plugin

readme

=== ePub Reader === Contributors: cmroanirgo Donate link: https://kodespace.com Tags: epub Requires WP: 3.0.1 Tested up to: 4.8.2 Stable tag: master License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

An ePub Reader for your WordPress posts and pages.

== Description ==

An ePub Reader for WordPress. This plugin provides a simple shortcode entry as well as a custom post type to give you control over how the epub is displayed.

The underlying code uses a fork of the framework provided by Futurepress' epub.js.

=== Note ===

There are two ways this plugin can read an epub:

  1. As an .epub. This is clearly the easiest way, just upload and link to the file directly. However, this is not the most efficient way for the user (because extra code is needed to download the whole epub in one go and the unzip it and then their browser can use it).
  2. As an extracted .epub. Upload the epub as normal, but use an 'unzip' tool to extract the contents of the epub to files and folders on your server. This is the most efficient for the end user. (It also has the benefit of stopping 3rd parties easily downloading the whole book easily, if that's important to you).

=== Short Code ===

Just drop in the shortcode into your blog posts or pages to embed an iFrame with fullscreen reader capabilities.

eg.

[epub-reader src="https://github.com/cmroanirgo/epub-reader/raw/master/some/path.epub" width="640" height="480"]

=== Custom Post Type ===

In the admin area, you'll see 'ePub Reader Pages' which are pages that are designed to give a full-browser view of the epub. These pages are largely theme-indepdendant.

== Installation ==

This section describes how to install the plugin and get it working. Choose one method.

Use Github Updater

If you have already installed Github Updater, then use that.

  1. Open Github Updater settings and click the 'Install Plugin' tab.
  2. Enter cmroanirgo/epub-reader as the Plugin URI and then Install.
  3. Go to the Plugins screen and click Activate.

If you do not have Github Updater, then you may wish to do so. It is the recommended way to install and keep up-to-date.

Upload

  1. Download the latest tagged archive (choose the "zip" option).
  2. Unzip the archive, rename the folder correctly to epub-reader, then re-zip the file.
  3. Go to the Plugins -> Add New screen and click the Upload tab.
  4. Upload the zipped archive directly.
  5. Go to the Plugins screen and click Activate.

Manual

  1. Download the latest tagged archive (choose the "zip" option).
  2. Unzip the archive, rename the folder to epub-reader.
  3. Copy the folder to your /wp-content/plugins/ directory.
  4. Go to the Plugins screen and click Activate.

Check out the Codex for more information about installing plugins manually.

Git

  1. Using git, browse to your /wp-content/plugins/ directory and clone this repository:

git clone https://github.com/cmroanirgo/epub-reader.git

  1. Go to the Plugins screen and click Activate.

== Usage ==

  1. Place [epub-reader src="https://github.com/cmroanirgo/epub-reader/raw/master/some/path.epub"] in your posts or pages, OR you can also use 'ePub Reader Pages'

== Frequently Asked Questions ==

= Does it have full browser support? =

Unfortunately, the underlying epub.js library has several known IE incompatibilities. However, in general the plugin should work on most modern browsers and phones without issue.

= Does it support mobile devices? =

Yes. Although there may be some issues, the plugin is responsive in design and reflows accordingly.

= What shortcode options are there? =

The shortcode supports the following attributes:

  1. src="path/to/epub". This is mandatory

== Screenshots ==

!https://kodespace.com/epub-reader/images/screenshot1.png!

== Changelog ==

= 0.9.1 =

= 0.9.0 =

== Upgrade Notice ==

== Thanks ==

Thanks to: