=== TNC FlipBook 3D Lite ===
Contributors: ThemeNcode, abdulawal39
Tags: flipbook, pdf, 3d, page flip, pdf viewer
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn PDFs and images into interactive 3D page-flip books on your WordPress site, with search, themes, links, and a table of contents.

== Description ==

**TNC FlipBook 3D** transforms your PDFs and images into beautiful, interactive 3D flipbooks with realistic page-turning physics powered by WebGL and Three.js.

TNC FlipBook 3D includes PDF links, text search, and a dark/light theme toggle.

= Live Preview =
See TNC FlipBook 3D in action: [open the live demo](https://tncflipbook.com/live-preview/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=live-preview).

= Features =
* Realistic 3D WebGL page flip with physics
* 2D CSS fallback for older devices
* PDF and image sources
* Clickable PDF hyperlinks (internal + external)
* PDF text search with highlighting
* Table of contents / PDF outline
* Thumbnail navigation panel
* 4 viewing modes: 3D, vertical scroll, horizontal scroll, reading mode
* Dark and light theme toggle with 7 color schemes
* Print, download, social sharing
* Autoplay with speed control
* Fullscreen mode
* Lightbox popup mode
* Deep linking (shareable page URLs via #page/N)
* RTL support for Arabic, Hebrew, and more
* 20 languages included
* Gutenberg blocks + shortcodes
* Per-flipbook toolbar customization
* Keyboard navigation
* Responsive design
* Unlimited flipbooks, unlimited pages
* No watermark, no branding

= TNC FlipBook 3D Pro =
Need more? The Pro version adds:

* More interface languages
* All color schemes plus brand and hardcover colors
* Merge multiple PDFs with named chapters
* Interactive hotspots (links, media, and products)
* AI read-aloud with premium voices
* Content protection and watermarks
* WooCommerce page gating
* Google Analytics 4 tracking
* Export and import flipbooks
* Page video overlays
* PDF form viewer
* User bookmarks and notes
* Priority support

[See Pro plans](https://tncflipbook.com/pricing/?utm_source=wordpress.org&utm_medium=readme&utm_campaign=upgrade)

= Why TNC FlipBook 3D? =

* **PDF links and search included** — both work out of the box
* **WebGL 3D rendering** — page flip with paper-bend physics
* **Smart fallback** — uses a lightweight 2D mode when WebGL is unavailable
* **Modern admin** — Clean wizard-based setup, no confusing settings
* **Developer friendly** — Clean code, no jQuery dependency on frontend, REST API proxy for secure file serving

= Embedding Options =

1. **Shortcode (inline):** `[flipbook id="123"]`
2. **Shortcode (popup link):** `[flipbook_link id="123"]Click to read[/flipbook_link]`
3. **Gutenberg Embed Block:** Search "Flipbook" in the block inserter
4. **Gutenberg Link Block:** Insert a clickable link that opens a flipbook popup
5. **Direct URL:** Each flipbook has its own permalink at `/flipbook/your-book/`

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/tnc-flipbook-3d-lite/` or install via **Plugins > Add New**
2. Activate the plugin through the **Plugins** screen
3. Go to **TNC FlipBook 3D > Add New**
4. Upload a PDF or select images from the Media Library
5. Click **Publish** and copy the shortcode

== Frequently Asked Questions ==

= Does it work with any PDF? =
Yes. TNC FlipBook 3D renders PDFs using PDF.js and works with any standard PDF file, including those with links, bookmarks, and text layers.

= Does it work on mobile? =
Yes. The plugin auto-detects device capability and falls back to a lightweight 2D CSS-based mode on older or less powerful devices.

= Can I customize the toolbar? =
Yes. You can choose which toolbar items appear and pick a toolbar layout for each FlipBook.

= Is it accessible? =
Yes. It includes full WCAG 2.1 AA accessibility — keyboard navigation and shortcuts, screen reader announcements, skip links, focus indicators, high-contrast mode, and reduced-motion support.

= Can I use it with page builders? =
Yes. It includes Gutenberg blocks and shortcodes that work with any page builder.

== Screenshots ==

1. Realistic 3D FlipBook with true page-turning physics (dark theme)
2. Light theme reading view - switch dark or light from the toolbar
3. Turn any PDF into a magazine-style FlipBook with real page turns
4. Global Settings - default view mode, page mode, zoom, and language
5. Per-FlipBook editor - choose a PDF or image gallery, then copy the shortcode

== Source Code ==

All of this plugin's own JavaScript and CSS is shipped unminified and
human-readable - there is no separate build or compile step for it. The 3D
viewer engine lives in assets/flipbook/tnc-flipbook.js and
assets/flipbook/tnc-flipbook.css.

The bundled third-party libraries are also included unminified, in assets/lib/:

* Three.js (MIT) - https://github.com/mrdoob/three.js
* PDF.js (Apache-2.0) - https://github.com/mozilla/pdf.js

== Changelog ==

= 1.0.0 =
First public release on WordPress.org.

* 3D WebGL page-flip rendering, with a 2D CSS fallback when WebGL is unavailable
* PDF and image sources
* Automatic PDF links, text search, and table of contents (outline)
* 7 color schemes (Slate, Paper, Midnight, Ocean, Forest, Glass, Sepia) with a dark/light theme toggle
* 20 interface languages with automatic right-to-left support
* Toolbar customization with selectable toolbar layouts
* Reading mode, vertical and horizontal scroll viewers, single-page mode, and lightbox popup
* Deep linking to a specific page (#page/N)
* Gutenberg blocks (embed, link, image-link) and shortcodes
* Full WCAG 2.1 AA accessibility (keyboard navigation, screen-reader support, focus indicators)
* Responsive design

== Upgrade Notice ==

= 1.0.0 =
First public release on WordPress.org.
