Toombler Flipbook

外掛說明

Toombler 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
  • Optional accessible text version below the flipbook (improves screen-reader access and SEO)
  • 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)
  • 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)
  • text — show an accessible, collapsible text version below the flipbook (good for SEO): 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. When you enable the optional text version (text="1" or the “Show accessible text version” block toggle), the plugin also requests the document’s plain text from https://toombler.com/api/text and caches it locally; only your flipbook’s File ID is sent, and the response contains your document’s own text. By using this plugin you agree to the Toombler Terms of Service and Privacy Policy. A free Toombler account is required to create flipbooks.

螢幕擷圖

適用於區塊編輯器

這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • Toombler Flipbook

安裝方式

  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 under ⚙ Configure & Embed.

常見問題集

Where do I get my File ID?

Log in at 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.

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 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.).

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Toombler Flipbook〉的開發相關工作。

參與者

〈Toombler Flipbook〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Toombler Flipbook〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.2.0

  • New: optional accessible text version. Enable it with the text="1" shortcode attribute or the “Show accessible text version” toggle in the block, and the plugin renders your flipbook’s text as a collapsible block below the viewer — improving screen-reader access and search-engine indexing of your content on your own site.
  • The text is fetched once from the Toombler API and cached locally (transient) for performance.

1.1.1

  • Removed the “Powered by Toombler” badge toggle from the plugin to comply with the WordPress.org plugin guidelines (no attribution links in plugin output).

1.1.0

  • Tested and confirmed compatible with WordPress 7.0.
  • Flipbooks now load faster and show an instant cover preview while the document loads (delivered automatically through the Toombler viewer).
  • Housekeeping and readme updates.

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.