=== Toombler Flipbook ===
Contributors: toombler
Tags: flipbook, pdf, embed, page flip, interactive
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed beautiful, interactive PDF flipbooks from Toombler on your WordPress site — shortcode or Gutenberg block.

== Description ==

[Toombler](https://toombler.com) converts Google Drive PDFs into smooth, interactive page-flip viewers that look great on any device. Embed a flipbook on any post or page in seconds.

**Features:**

* Gutenberg block with live preview in the editor
* Classic shortcode for page builders and themes
* Responsive — scales to any container width
* Full control over every viewer setting (matches the Toombler dashboard)
* Two selectable page-flip sounds, hard cover, spine shadow, auto-play, and more
* Optional navigation arrows, page counter, download button, and fullscreen mode
* "Powered by Toombler" badge can be toggled on or off
* No cookies set, no user data collected by the plugin itself

**Shortcode usage:**

`[toombler id="YOUR_FILE_ID"]`

Get your File ID from your Toombler dashboard (⚙ Configure & Embed → copy the `id=` value from the embed URL).

**All shortcode parameters:**

* `id` (required) — Google Drive file ID from your Toombler dashboard
* `width` — embed width in px (default: 760)
* `height` — embed height in px (default: 540)
* `nav` — navigation arrows: 1/0 (default: 1)
* `counter` — page counter: 1/0 (default: 1)
* `sound` — page-flip sound: 1/0 (default: 0)
* `flipsound` — which flip sound: 1 / 2 (default: 1)
* `autoplay` — auto-play: 1/0 (default: 0)
* `autospeed` — auto-play seconds per page: 1–60 (default: 3)
* `brand` — "Powered by Toombler" badge: 1/0 (default: 1)
* `dl` — download button: 1/0 (default: 1)
* `fs` — fullscreen button: 1/0 (default: 0)
* `bg` — background colour: dark / light / transparent (default: dark)
* `start` — start page (default: 1)
* `bookmark` — remember page per visitor: 1/0 (default: 1)
* `zoom` — allow zoom: 1/0 (default: 1)
* `drag` — allow corner drag: 1/0 (default: 1)
* `thumbs` — thumbnail strip: 1/0 (default: 0)
* `duration` — flip animation in ms: 100–3000 (default: 650)
* `spine` — spine shadow (centre glow): 1/0 (default: 0)
* `borderless` — no rounded corners: 1/0 (default: 0)
* `adreplace` — replace page 2 with an ad: 1/0 (default: 0)
* `closed` — start with a closed book (cover only): 1/0 (default: 1)
* `hardcover` — rigid front & back cover: 1/0 (default: 1)
* `corners` — show hover corner curl: 1/0 (default: 1)
* `mscroll` — mobile scroll (swipe to scroll, not flip): 1/0 (default: 0)

**External service:**

This plugin embeds content from **toombler.com**. The flipbook viewer is loaded in an `<iframe>` from `https://toombler.com/embed`. By using this plugin you agree to the [Toombler Terms of Service](https://toombler.com/terms) and [Privacy Policy](https://toombler.com/privacy). A free Toombler account is required to create flipbooks.

== Installation ==

1. In WordPress admin, go to **Plugins → Add New → Upload Plugin** and upload the `toombler.zip` file, or search for "Toombler" in the plugin directory.
2. Click **Activate**.
3. Add the **Toombler Flipbook** block from the block inserter, or use the shortcode `[toombler id="YOUR_FILE_ID"]` in any post or page.
4. Your File ID can be found in your [Toombler dashboard](https://toombler.com/app) under ⚙ Configure & Embed.

== Frequently Asked Questions ==

= Where do I get my File ID? =

Log in at [toombler.com/app](https://toombler.com/app), open the settings panel for your flipbook (⚙ icon), click "Configure & Embed", and copy the value after `id=` in the embed URL.

= Do I need a Toombler account? =

Yes. You need a free Toombler account to upload a Google Drive PDF and get a File ID. Create one at [toombler.com](https://toombler.com).

= Is the flipbook stored on my server? =

No. Toombler hosts the flipbook viewer. This plugin simply embeds it via an iframe. Your PDF is served through Toombler's infrastructure.

= Does this plugin collect any data? =

The plugin itself sets no cookies and collects no data. The embedded Toombler viewer may record anonymous page-view counts. See the [Toombler Privacy Policy](https://toombler.com/privacy) for details.

= Does it work with page builders? =

Yes. Use the shortcode `[toombler id="…"]` in any page builder that supports shortcodes (Elementor, Divi, WPBakery, Beaver Builder, etc.).

== Screenshots ==

1. The Toombler Flipbook block in the Gutenberg editor, with sidebar settings.
2. A flipbook embedded on a post — full page-flip animation.
3. Shortcode example in the Classic Editor.

== Changelog ==

= 1.0.3 =
* Full settings parity with the Toombler embed: every viewer option is now available via shortcode and the Gutenberg block.
* New: choose between two page-flip sounds (`flipsound`), and toggle the hard cover (`hardcover`).
* Added shortcode parameters: counter, flipsound, autoplay, autospeed, start, bookmark, zoom, drag, thumbs, duration, spine, borderless, adreplace, closed, hardcover, corners, mscroll.
* Block editor sidebar now exposes all viewer settings.

= 1.0.2 =
* Updated block icon to the Toombler page-stack mark.

= 1.0.1 =
* New Toombler brand icon (open book with fanned pages) for the Gutenberg block.
* Refreshed editor placeholder styling to match Toombler's branding.

= 1.0.0 =
* Initial release — shortcode and Gutenberg block.

== Upgrade Notice ==

= 1.0.3 =
Adds full settings parity: all viewer options (incl. two flip sounds and hard cover) now work via shortcode and block.

= 1.0.2 =
New block icon matching the Toombler brand.

= 1.0.1 =
Adds the Toombler brand icon to the block editor and refreshes styling.

= 1.0.0 =
First public release.
