Simple Ebook Viewer

After installing this plugin, you will be able to upload various ebook formats as normal media files and to display them in your site using a shortcode. Every ebook uploaded in your site will have an "ebook slug" (by default it will be the ebook name) that you can view and edit in the Edit Media page of the Admin Panel. The full source code of the plugin is hosted on GitHub. Supported formats At the moment, the plugin will let you upload and display the following file types, provided that they are DRM-free:

• epub
• mobi
• azw
• azw3
• fb2
• fbz
• cbz

Usage Insert the shortcode [simebv_viewer book="MY_EBOOK_SLUG_HERE"] in any one of your posts. Styling You can add css styles and classes for the viewer container by adding these attributes to the shortcode:

• height
• width
• max-height
• max-width
• border
• style
• class

Height, width, max-height, max-width and border accept any valid CSS value for those property. Style and class accept any valid value for the respective HTML attributes. Some examples: [simebv_viewer book="MY_EBOOK_SLUG_HERE" style="height:30em;border:2px inset black"] [simebv_viewer book="MY_EBOOK_SLUG_HERE" max-height="100vh" height="40em"] [simebv_viewer book="MY_EBOOK_SLUG_HERE" class="my-container-class my-container-second-class"] Settings The users of your site will be able to set their preferences about the appearance of the ebook in the Viewer by opening the Viewer menu (the cog icon on the top right) and by selecting the appropriate entries. The plugin sets some reasonable defaults for these preferences, but if you're not happy with those defaults, you can change them by adding one or more of the following attributes to the shortcode, with the appropriate values:

• layout
• accepted values: "paginated" or "scrolled" (default: paginated)
• max-pages
• accepted values: 1, 2, 3 or 4 (default: 2)
• default-font-size
• accepted values: "small", "medium", "large", "x-large" (default: medium)
• font-family
• accepted_values: "auto", "serif", "sans-serif", "monospace", "opendyslexic" (default: auto)
• page-margins
• accepted values: "small", "medium", "large" (default: medium)
• show-annotations
• accepted values: "true", "false" (default: false)
• show-page-delimiters
• accepted values: "true", "false" (default: false)
• zoom
• accepted values: "fit-page", "fit-width" or a number in the range 10 - 400 (default: fit-page)
• color-scheme
• accepted values: "auto", "sepia", "light", "dark" (default: auto) Layout, max-pages, default-font-size and page-margins are only available for reflowable ebooks, while zoom is only available for fixed layout ones.

Max-pages is the maximum number of pages (in the "paginated" layout) that the user will be able to see in a single view (if there is enough screen space). Show-annotations and show-page-delimiters let the user see on the pages the Calibre annotations (as highlighted text, if there are Calibre annotations in the ebook) and the page delimiters (as short vertical bars, if the ebook contains a page list). Color-scheme: "auto" means that the Viewer will adapt to the preferred color-scheme set by the user in their device or browser (light or dark). For most ebooks these preferences should be enough, but sometimes there are ebooks with style rules that don't play well with the styles set by the Viewer, so the users have also the option to apply some filters to the Viewer's colors (with the menu entry "Color filter..."). You can set the default values for these filters with the following shortcode's attributes:

• activate-color-filter
• accepted values: "true", "false" (default: false)
• invert-color-filter
• accepted values: a number in the range 0 - 1 (default: 0)
• rotate-color-filter
• accepted values: a number in the range 0 - 360 (default: 0)
• bg-transparent-filter
• accepted values: "true", "false" (default: true)
• bg-color-filter
• accepted values: a valid CSS hex color code (default: #FFFFFF) Set activate-color-filter to "true" is necessary to enable all the other filters, and set bg-transparent-filter to false is necessary to enable bg-color-filter.

Bg-transparent-filter and bg-color-filter are available for reflowable ebooks only. Invert-color-filter inverts the lightness of the colors. With a value of 0 it has no effect, with a value of 1, the white will become black and the black will become white. Rotate-color-filter rotates the hues of all the colors in the ebook, like in a Color Wheel (so, no effect on black and white). There are some other settings that the users won't be able to change by themselves. These are:

• always-full-viewport
• accepted values: "true", "false" (default: false. If true, return-to-url is also required)
• return-to-url
• accepted values: a URL with the same hostname than the page that contains the ebook viewer (default: '')
• real-fullscreen
• accepted values: "true", "false" (default: false)
• allow-js
• accepted values: "true", "false" (default: false)
• math-styles
• accepted values: "fonts", "styles", "all" (default: '')
• ebook-author
• accepted values: any string, max 260 characters (default: '')
• ebook-title
• accepted values: any string, max 260 characters (default: '')
• popup-notes
• accepted values: "true", "false" (default: true) With always-full-viewport set to "true", the ebook viewer will automatically cover the entire webpage when it is opened, and the "full screen" icon will be replaced by a "close viewer" icon. always-full-viewport="true" requires that also return-to-url is present, with a valid URL that indicates the destination of the user when they choose to close the viewer. The URL can be relative, like "/" or "/books-gallery", or it can be absolute, but it needs to have the same hostname of the webpage that contains the ebook viewer (e.g. if the ebook viewer is opened in https://www.example.com/ebook-viewer, the URL in return-to-url needs to start with https://www.example.com).

If real-fullscreen is set to "true", the ebook viewer will cover the entire screen instead of only the viewport of the webpage when the user clicks on the "full screen" icon. With real-fullscreen set to true, always-full-viewport is ignored, since the full screen requires an explicit action by the user. Allow-js: normally, the plugin forbids, as far as possible, script execution from inside the ebooks. If you set allow-js to true, this restriction is relaxed, and scripts within the ebook can be executed. Caveat 1: you need to be absolutely certain that the code inside the ebook is not malicious, since it can harm your entire webpage. Caveat 2: the ebook viewer is not strongly equipped to deal with dynamic content created or removed after the ebook opening, so you might encounter errors or inaccuracies when jumping from one ebook location to another in such a circumstance. Math-styles: in recent years all the major browser have implemented a good deal of the MathML Core specification, so it is now possible to represent natively many mathematical expression without the use of third party libraries. However, not all browsers and systems load automatically appropriate fonts. With math-styles set to "fonts" or "all", all the contents of MathML expression will use the Latin Modern font. Another shortcoming in the current support of MathML, is that only Gecko based browsers (i.e. Firefox) implement a breaking lines algorithm, so long math expressions within small screens usually don't fit entirely. With math-styles set to "styles" or "all", the plugin will use some html+css tricks to try to allow either line breaks or horizontal scrolling. Ebook-author and ebook-title: you can use these optional values to override the ones that the ebook viewer retrieves from the ebook metadata in order to display them to the users. Popup-notes: show footnotes and endnotes as popup instead of just links. The notes (and their references) need to be marked with the appropriate epub:type attributes to ensure that they are displayed as popups (the ebook viewer will try to recognize them anyway, but without guarantees).