=== Interactive 3D FlipBook ===
Contributors: iberezansky
Donate link: https://www.paypal.me/iberezansky
Tags: flipbook, flip book, pdf viewer, pdf flipbook, pdf to flip book
Requires at least: 4.3
Tested up to: 5.3
Stable tag: /trunk/
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

3D FlipBook is PDF Viewer, allows to browse images, PDFs or HTMLs as a flipping book. It attracts user attention and makes more impression on him.

== Description ==

<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> is PDF Viewer or WordPress plugin that allows to browse images, PDFs or HTMLs as a flipping book.
  It can be used for demonstration magazines, books, cards, brochures, booklets and much more in natural way.
  It helps to attract user attention and make more impression on him.
</p>

[youtube https://youtu.be/meZCnPF5IdQ]

<p>
  Start from <a href="http://3dflipbook.net/">the live preview</a>.
</p>

<h2>Main features</h2>

<h3>Version 1.8</h3>
<ul>
  <li>3D FlipBook categories</li>
</ul>

<h3>Version 1.7.6</h3>
<ul>
  <li>Shortcode generator</li>
</ul>

<h3>Version 1.7</h3>
<ul>
  <li>RTL mode</li>
  <li>Default template option in General Settings</li>
</ul>

<h3>Version 1.6</h3>
<ul>
  <li>CSS Layers</li>
  <li>Languages</li>
</ul>

<h3>Version 1.5</h3>
<ul>
  <li>PDF search</li>
</ul>

<h3>Version 1.4</h3>
<ul>
  <li>Thumbnails</li>
  <li>Flip sounds</li>
  <li>Deep linking</li>
</ul>

<h3>Version 1.3</h3>
<ul>
  <li>PDF bookmarks</li>
  <li>Printing</li>
  <li>Single page mode</li>
  <li>Control customization</li>
  <li>Fit view command</li>
  <li>Controllable script for templates</li>
</ul>

<h3>Version 1.2</h3>
<ul>
  <li>PDF links</li>
  <li>Mobile-Friendly</li>
  <li>Flipping sheet animation style</li>
  <li>Loading animation and progress</li>
</ul>

<h3>Version 1.1</h3>
<ul>
  <li>Smart pan mode</li>
  <li>Skins</li>
  <li>Flipping covers together with other pages</li>
</ul>

<h3>Version 1.0</h3>
<ul>
  <li>Realistic view</li>
  <li>Natural behaviour</li>
  <li>Flixible page corners</li>
  <li>User behaviour prediction system</li>
  <li>HTML, PDF, images as sources</li>
  <li>User friendly</li>
  <li>High perfomance</li>
  <li>Lightbox effect</li>
  <li>Interactive</li>
  <li>Responsive</li>
  <li>Easy to use</li>
  <li>Well documented</li>
</ul>


<h2>Details</h2>

<h3>Realistic view</h3>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> allows to create volume book, with page thickness. It is the most exact computer model of a book or a magazine from real world.
</p>
<p>
  The plugin is able to simulate book opening process.
  Modeled book repeat the same actions as its real prototype:
    while the cover is opening or closing the internal pages are deforming as it happens in life.
  The deformation can be customized. You can reduce it or switch off.
</p>

<h3>Natural behaviour</h3>
<p>
  The plugin is called <a href="http://3dflipbook.net/">3D FlipBook</a>, for sure, it can perform page flipping animation.
</p>
<p>
  But this is very common ability so all typical plugins are able to do it.
  <a href="http://3dflipbook.net/">3D FlipBook</a> allows to customize the shape of flipping pages but it is still not enough to be unique.
</p>
<p>
  The main feature is using specially designed physics engine that perform all interaction with a user.
  This engine is based on physics laws so all user actions with the model seems realistic.
  The plugin allow you drag and throw pages together. The engine solve the collisions and show natural scene.
</p>
<p>
  Physics engine has a lot of properties: gravity, mass, flexibility, page flipping velocities and much more.
  But it is little necessary to know for using the plugin because all those properties have default presets.
</p>

<h3>Flexible page corners</h3>
<p>
  The main goal of <a href="http://3dflipbook.net/">3D FlipBook</a> is maximum user friendly. Main key of being friendly is behave in habitual for user way.
  How are we used to turn pages in books? - of course it is dragging a page while holding a corner!
  <a href="http://3dflipbook.net/">3D FlipBook</a> is one known 3D plugin that has such feature.
</p>

<h3>Skins support</h3>
<p>
  Supporting skins makes customization very easy. It is necessary just to choose appropriate skin and that is all.
  Now there are available skins for light and dark themes - the most universal ones.
</p>

<h3>Smart pan</h3>
<p>
  3d FlipBook has smart algorithm to show the book in maximum comfortable and appropriate for user way.
  It automatically chooses book scale and alignment on the screen, disallows user to drag the book out of view port.
  The pan makes only smooth moves that seems very friendly for user. All these abilities help the book to look richer.
</p>

<h3>HTML, PDF, images as sources</h3>
<p>
  The plugin can use PDF, images and HTMLs as pages. Supporting HTML format as texture is a new technology no one of other plugins support it.
  HTML allow easily create interactive books, handle user events, manage plugin behaviour. Using HTML textures is next important step in development web animation.
  Supporting PDFs allows to use the plugin as PDF Viewer.
</p>

<h3>User behaviour prediction system</h3>
<p>
  The plugin is not just pretty but it is smart. It has user behaviour prediction system.
  <a href="http://3dflipbook.net/">3D FlipBook</a> tracks user actions and try to predict next necessary pages.
  In the background it loads predicted pages and renders them. When the user go to next page it is ready to be shown.
</p>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> uses priorities for page loading. First of all it loads visible for user pages then predicted ones.
  It is possible to customize amount of pages to predict and quantity of used by user pages for predicting his behaviour.
</p>

<h3>User friendly</h3>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> is designed to be maximum user friendly. It has familiar to user page flipping control.
  Flexible corners help user to understand that he can turn the page by means drag and drop technology.
  Physics engine computes page transforms in similar to real world way.
  Modeling book is close to natural book - it has the same volume and shape.
  It is possible to use hard flat covers to create hard bending and use flexible pages, make whole book flexible or flat.
</p>
<p>
  The plugin has specially designed animation of page loading process.
  It is created automatically for different page colors.
  <a href="http://3dflipbook.net/">3D FlipBook</a> computes animation colors as inversion of page color.
  It looks nice for all colors.
</p>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> supports fullscreen mode. It is comfortable to watch magazines in this mode, they look like alive.
</p>
<p>
  Sometimes it is useful to change lightning. <a href="http://3dflipbook.net/">3D FlipBook</a> gives to its users such ability.
  User can change lightning to do it appropriate for him. It is important option for reading long texts.
</p>

<h3>High performance</h3>
<p>
  The plugin performance does not depend on number of pages because it does not manage single pages.
  <a href="http://3dflipbook.net/">3D FlipBook</a> works with blocks of pages, it allows to keep in memory just visible for user pages.
  So if the book is closed then there are 2 or 3 blocks.
  The first is left cover, the second is right cover and third is internal pages.
  If the book is opened there can be two blocks for left and right internal pages.
  There can be more blocks just when the flipping animation is performing.
  The plugin has no problem with more than 50 simultaneously flipping blocks.
  When the turn is finished the turned block merges with neighbour block.
</p>
<p>
  For fast rendering 3D graphics <a href="http://3dflipbook.net/">3D FlipBook</a> uses WebGL. WebGL is a API for creating interactive 3D graphics without using plugins.
</p>
<p>
  PDF Viewer uses lightweight Mozilla PDF.js library. It allows to render PDFs very fast and in high quality.
</p>

<h3>Interactive</h3>
<p>
  Supporting HTML opens wide abilities for creating interactive books.
  It allows to use CSS3 and JavaScript, create navigation, use hover effects and much more.
  3D FlipBook as PDF Viewer supports PDF links, highlighters and any HTMl as the second layer markup.
</p>


<h3>Responsive</h3>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> is designed to occupy whole container where you place it. So if the container size changes the plagin recompute its dimensions.
  So keep the container responsive and plugin will be responsive too.
</p>

<h3>Easy to use and customize</h3>
<p>
  <a href="http://3dflipbook.net/">3D FlipBook</a> is well documented, has a lot of examples and getting started manual. It is easy to start.
  The plugin supports skins, so it is possible to create own skins or customize style or template files of existing.
</p>
<p>
  The plugin has a lot of customization options (<a href="http://3dflipbook.net/documentation#properties">see the documentation</a>).
  If it is not enough you can edit the project. It is written in modern JavaScript (ES6) object oriented style. Very easy to understand how it works.
</p>

== Installation ==

To install the plugin use the regular WordPress plugin installation wizard. For more details see <a href="http://3dflipbook.net/wp-user-manual">the user manual</a>.

To understand how the plugin works watch next two videos:

[youtube https://youtu.be/erwZIWCU2EE]

[youtube https://youtu.be/COueCeQpeB4]

More videos on <a href="https://www.youtube.com/channel/UCRLxHMrRORwfPs9WvTOzlHQ">the plugin official video channel</a>.

== Frequently Asked Questions ==

= How does the plugin works? =

Read <a href="http://3dflipbook.net/wp-user-manual">the user manual</a>.

== Screenshots ==

1. Closed book in Lightbox mode.
2. Pages flipping.
3. Opened book in Lightbox mode.
4. Corners flexibility demonstration.
5. Fullscreen mode - short-white-skin.
6. Fullscreen mode - black-skin.
7. short-white-skin.
8. white-skin.
9. short-black-skin.
10. black-skin.

== Changelog ==

<h4>Version 1.9.21</h4>
<ul>
  <li>New pages predicting algorithm</li>
</ul>

<h4>Version 1.9.20</h4>
<ul>
  <li>Performance optimization - disabled 3D rendering for idle</li>
</ul>

<h4>Version 1.9.19</h4>
<ul>
  <li>Fixed disappearing on Android devices - Updated THREE JS library</li>
</ul>

<h4>Version 1.9.18</h4>
<ul>
  <li>Fixed the bug: "Failed to initialize plugin: 3dfbInsert"</li>
</ul>

<h4>Version 1.9.17</h4>
<ul>
  <li>Fixed disappearing edit details</li>
</ul>

<h4>Version 1.9.16</h4>
<ul>
  <li>Fixed error in classic blocks - insert dialog</li>
</ul>

<h4>Version 1.9.15</h4>
<ul>
  <li>JavaScript ready function</li>
  <li>Editing PDF url</li>
</ul>

<h4>Version 1.9.12</h4>
<ul>
  <li>Fixed an admin side styles issue</li>
</ul>

<h4>Version 1.9.11</h4>
<ul>
  <li>Fixed the zero size bug in FireFox</li>
  <li>Fixed a bug with links in doubled page PDFs</li>
</ul>

<h4>Version 1.9.10</h4>
<ul>
  <li>Fixed a bug in hits highlighting</li>
  <li>Fixed a bug in CSS Layers</li>
</ul>

<h4>Version 1.9.9</h4>
<ul>
  <li>Narrow View</li>
</ul>

<h4>Version 1.9.8</h4>
<ul>
  <li>Fixed the loading PDF issue in Edge</li>
</ul>

<h4>Version 1.9.7</h4>
<ul>
  <li>Updated PDFJS lib - faster loading for PDFs</li>
</ul>

<h4>Version 1.9.6</h4>
<ul>
  <li>Links in IE11/Edge</li>
  <li>Interactive corners for Mac</li>
</ul>

<h4>Version 1.9.5</h4>
<ul>
  <li>Fixed the iOS iframe resizing issue (wrong alignment)</li>
</ul>

<h4>Version 1.9.4</h4>
<ul>
  <li>Fixed the bug with disappearing the download button</li>
</ul>

<h4>Version 1.9.3</h4>
<ul>
  <li>Changed the PDF range chunk size - faster PDF loading</li>
</ul>

<h4>Version 1.9</h4>
<ul>
  <li>Auto resolution</li>
  <li>Double pages PDFs</li>
  <li>IE11 Fulscreen</li>
</ul>

<h4>Version 1.8.2</h4>
<ul>
  <li>Fixed bug in loading languages from global directory</li>
</ul>

<h4>Version 1.8</h4>
<ul>
  <li>3D FlipBook categories</li>
</ul>

<h4>Version 1.7.6</h4>
<ul>
  <li>Shortcode generator</li>
</ul>

<h4>Version 1.7</h4>
<ul>
  <li>RTL mode</li>
  <li>Default template option in General Settings</li>
</ul>

<h4>Version 1.6</h4>
<ul>
  <li>CSS Layers</li>
  <li>Languages</li>
</ul>

<h4>Version 1.5</h4>
<ul>
  <li>PDF search</li>
</ul>

<h4>Version 1.4</h4>
<ul>
  <li>Thumbnails</li>
  <li>Flip sounds</li>
  <li>Deep linking</li>
</ul>

<h4>Version 1.3</h4>
<ul>
  <li>PDF bookmarks</li>
  <li>Printing</li>
  <li>Single page mode</li>
  <li>Control customization</li>
  <li>Fit view command</li>
  <li>Controllable script for templates</li>
</ul>

<h4>Version 1.2</h4>
<ul>
  <li>PDF links</li>
  <li>Mobile-Friendly</li>
  <li>Flipping sheet animation style</li>
  <li>Loading animation and progress</li>
</ul>

<h4>Version 1.1</h4>
<ul>
  <li>Smart pan mode</li>
  <li>Skins</li>
  <li>Flipping covers together with other pages</li>
</ul>

<h4>Version 1.0</h4>
<ul>
  <li>Realistic view</li>
  <li>Natural behaviour</li>
  <li>Flixible page corners</li>
  <li>User behaviour prediction system</li>
  <li>HTML, PDF, images as sources</li>
  <li>User friendly</li>
  <li>High perfomance</li>
  <li>Lightbox effect</li>
  <li>Interactive</li>
  <li>Responsive</li>
  <li>Easy to use</li>
  <li>Well documented</li>
</ul>

== Upgrade Notice ==

= 1.4 =
First demo version.
