=== ChimpJar Flipbook Maker ===
Contributors: chimpjar
Plugin URI: https://chimpjar.com
Tags: flipbook, pdf viewer, 3d flipbook, interactive pdf, digital catalog
Requires at least: 5.9
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn static PDFs into interactive 3D Flipbooks! Enjoy a realistic reading experience on any device with ChimpJar Flipbook Maker. No API needed.

== Description ==

Stop using boring, static PDF links! **ChimpJar Flipbook Maker** brings your digital content to life with a highly realistic 3D book-reading experience. 

Whether you are displaying magazines, product catalogs, brochures, or portfolios, our smart engine renders everything seamlessly on any device—without needing any external 3rd-party API!

### 🌟 Free Features (Included)
* **Unlimited Books:** Create as many Flipbooks as your website needs without any intended restrictions.
* **3D Page Flip Effect:** Extremely smooth and realistic page-turning animations with natural, soft book-fold shadows and page-flip sounds.
* **Direct PDF & Image Support:** Upload a PDF or multiple images, and the plugin automatically converts them. No external conversion needed!
* **AI Text-to-Speech (Audiobook):** Built-in voice reader that reads the book out loud to the user.
* **Custom Branding & Colors:** Change the background, control bars, and icon colors to perfectly match your brand identity.
* **High-Res Zoom & Pan:** Crystal-clear text rendering when zooming in.
* **Keyword Search:** Built-in search engine that highlights text instantly inside the book.
* **Smart Landscape Splitting:** Automatically detects wide pages and splits them into two facing pages.
* **100% Mobile Responsive:** Optimized touch interactions (swipe to turn, pinch to zoom) for mobile and tablet users.

### 👑 Premium Features (PRO Add-on)
Take your Flipbooks to the next level by upgrading to the PRO version and unlock:
* **Visual Interactive Studio:** Add Shoppable Hotspots (with Buy Now popups) and embed Media (YouTube, Video, Audio, Google Maps) directly onto your pages.
* **Lead Generation (Content Lock):** Lock your Flipbook at a specific page and force users to submit their Name & Email to continue reading.
* **Custom Covers:** Override the default cover with high-quality custom images.

[Get Flipbook Maker PRO Here](https://chimpjar.com)

== Installation ==

1. Go to **Plugins > Add New** in your WordPress dashboard.
2. Search for `ChimpJar Flipbook Maker` and install it.
3. Click **Activate**.
4. Go to the new **Flipbook Maker** menu on the left sidebar and click **Add New Book**.
5. Upload your PDF or Images, save the post, and copy the shortcode `[flipbook id="123"]`.
6. Paste the shortcode into any post or page.

== Frequently Asked Questions ==

= Does it require a 3rd party API to convert PDFs? =
No! The plugin uses a built-in Javascript engine to render your PDFs directly in the browser. Your files never leave your server, ensuring 100% privacy and fast loading.

= Are the Flipbooks responsive on mobile? =
Yes. The plugin dynamically adjusts to any screen size and supports mobile gestures like pinch-to-zoom and swipe-to-flip.

= How do I add Shoppable Hotspots and Lead Generation Forms? =
Interactive items like Hotspots, Media Embeds, and Lead Generation are premium features. You can easily unlock them by upgrading to the PRO version from our official website.

== Screenshots ==

1. The interactive 3D Flipbook in action on the frontend.
2. The Visual Studio Editor in the WordPress backend.
3. Adding a Shoppable Hotspot with the visual drag-and-drop tool (PRO).
4. Custom Branding and Lead Generation settings.

== Changelog ==

= 1.0.0 =
* Initial Release.
* Added native PDF rendering and 3D flip effects.
* Added Custom Branding and Colors functionality.
* Added High-Res Zoom and Keyword Search features.

== Source Code for Third-Party Libraries ==

To comply with WordPress.org guidelines regarding human-readable code and build tools, the unminified source code, repository links, and build instructions are provided below:

1. StPageFlip (used as page-flip.browser.js)
- Official GitHub Repository: https://nodlik.github.io/StPageFlip/
- Original Source Code: The complete, original TypeScript source code and package.json are physically included inside this plugin directory at: `/js/source/stpageflip-source/`
- Build Instructions (How to compile):
  1. Open your terminal and navigate to the directory: `/js/source/stpageflip-source/`
  2. Run `npm install` to install all required dependencies.
  3. Run `npm run build` or `npm run dev` to generate the final `page-flip.browser.js` file used in this plugin.

2. PDF.js (v4.3.136 - used as pdf.min.js & pdf.worker.min.js)
- Official Project Website: https://mozilla.github.io/pdf.js/

3. Font Awesome
- Official Website: https://fontawesome.com/