借助免费的 Toombler 插件，您只需利用 Gutenberg 区块或简单的一行短代码 (shortcode)，便可将交互式 3D 翻页 PDF 文档轻松插入任何文章或页面中。
版本 1.4.0 · 免费 · GPL 许可 · 支持 WordPress 5.8 – 7.1
将共享权限设为“知道链接的任何人”，以便 Toombler 能正确读取解析。
在 WordPress 官方插件市场搜索 “Toombler Flipbook” 并点击安装与启用。
在任何位置粘贴 [toombler id="…"] 即可大功告成。
直接将 Toombler Flipbook 区块拖放至任意页面，并在区块编辑器内部即刻查看实时交互预览。
完美兼容经典编辑器 (Classic Editor)、Elementor、Divi、WPBakery 以及所有支持短代码的主流可视化页面构建器。
翻页书可自动适应并缩放至任何父级容器尺寸 — 在桌面显示器、平板和手机端皆能展现高清细腻质感。
前端无需加载臃肿脚本。仅生成单个自适应 iframe 容器 — 丝毫不拖慢您的网页测速表现。
为翻页书设置专属 PIN 密码或指定有效到期日 — 全部在 Toombler 控制面板中直观管理。
本插件完全免费且遵循 GPL 开源协议。您只需要注册一个免费的 Toombler 账号即可畅享全部功能。
方法 A： 在 WordPress 后台点击 插件 → 安装插件，搜索 “Toombler Flipbook” 并点击安装与启用。
方法 B： 下载下方的 ZIP 安装包，在后台进入 插件 → 安装插件 → 上传插件 进行安装。
⬇ 下载 toombler-wp-plugin.zip打开您的 Toombler 控制面板，点击翻页书上的 ⚙ 齿轮图标，然后打开配置与嵌入。复制嵌入链接中 id= 后面的字符串 — 这就是您的文件 ID。
在区块编辑器中点击 + 号，搜索 “Toombler” 并添加该区块。在右侧属性面板中填入您的文件 ID，即可立刻看到渲染预览。
在任何文章、页面或侧边栏小工具中加入：
附带可选自定义参数的完整写法：
| 参数 | 默认值 | 说明 |
|---|---|---|
id | required | 来自 Toombler 控制面板的翻页书专属 ID |
width | 760 | 嵌入组件宽度（像素值） |
height | 540 | 嵌入组件高度（像素值） |
nav | 1 | 左右翻页箭头 — 1 开启，0 关闭 |
counter | 1 | 当前页码指示器 — 1 开启，0 关闭 |
sound | 0 | 纸张翻动音效 — 1 开启，0 关闭 |
flipsound | 1 | 翻书音效方案选择：1 或 2 |
autoplay | 0 | 自动翻页播放 — 1 开启，0 关闭 |
autospeed | 3 | 自动播放时每页停留秒数 (1–60) |
dl | 1 | PDF 原件下载按钮 — 1 开启，0 关闭 |
fs | 0 | 全屏切换按钮 — 1 开启，0 关闭 |
bg | dark | 背景色主题：dark、light 或 transparent |
start | 1 | 初始默认打开的起始页码 |
bookmark | 1 | 记住每位访客上次阅读的页码 — 1 开启，0 关闭 |
zoom | 1 | 允许缩放浏览 — 1 开启，0 关闭 |
drag | 1 | 允许鼠标按住书角拖拽翻页 — 1 开启，0 关闭 |
thumbs | 0 | 底部微缩缩略图导航栏 — 1 开启，0 关闭 |
duration | 650 | 翻页动作动画过渡耗时 (100–3000 毫秒) |
spine | 0 | 中缝书脊立体阴影光效 — 1 开启，0 关闭 |
borderless | 0 | 直角利落无圆角模式 — 1 开启，0 关闭 |
closed | 1 | 初始以合书单封面状态呈现 — 1 开启，0 关闭 |
hardcover | 1 | 精装硬质封面及封底 — 1 开启，0 关闭 |
corners | 1 | 鼠标悬停微卷角交互动效 — 1 开启，0 关闭 |
mscroll | 0 | 移动端滑屏手势改为直接滚动 — 1 开启，0 关闭 |
adreplace | 0 | 将第 2 页替换为 Toombler 页面而非插入 — 1 开启，0 关闭 |
text | 0 | 在翻页书下方提供可折叠的纯文本版（有利于 SEO 抓取）— 1 开启，0 关闭 |
插件是你亲手放进自己安装环境里的东西，所以问清楚它带来了什么并不过分。这个插件是刻意做小的。在前台它只输出一个 <div>，里面放一个标了 loading="lazy" 的 <iframe>——长页面下方的翻页书，要等读者滚到那里才会去取。
它在前台不加载任何样式表，也不加载任何 JavaScript。它不建数据库表，也不往后台加菜单。它不往家里打电话，不统计任何东西，也不要 API 密钥。让翻页书跑起来的一切都在 iframe 里、在我们这边运行——这也是为什么你加一个之后，页面速度评分纹丝不动。
停用同样风平浪静：简码不再被识别，于是 [toombler id="…"] 会以纯文本的样子留在文章里，直到你把它删掉。数据库里什么也不会留下，因为本来就没往里写过东西。
翻页书本质上是你页面的图片。对看得见、用鼠标的读者来说没问题，对屏幕阅读器来说却毫无用处——它只找到一个框，里面没有可读的东西。在简码里加上 text="1"，书的下方就会出现一个可折叠的 Read the text version 面板，里面装的是你 PDF 里真正的文字层。
抓取发生在你的服务器上，而不是访客的浏览器里，结果会存进 WordPress 的 transient：找到文字存十二小时，没找到存一小时——这样一本文字还在提取中的翻页书，过一会儿就能拿到，而不用等到第二天。最多保存六万个字符，比一般的宣传册还多，也足以防止一本四百页的手册把你的选项表塞满。
还有第二个理由，没那么高尚但很实在：那段文字在你的页面上、在你的 HTML 里、在你的域名之下。读这篇文章的搜索引擎看到的是文档真正说了什么，而不是一个它进不去的框。如果你发布的是希望被人搜到的目录或通讯，这一个属性比本页其他所有内容加起来都管用。
它只对含有真实文字的 PDF 有效。没做 OCR 的扫描件没有文字层，这时面板干脆不出现，而不是打开一个空盒子。
插件需要 WordPress 5.8 或更新版本，以及 PHP 7.4 或更新版本，并且会针对当前的 WordPress 版本做测试。门槛定得低是有意为之：代码里没有任何冷门东西，所以在落后几年的主机上照样能跑。
因为它就是个普通简码，所以在区块编辑器、经典编辑器、文本小工具，以及 Elementor、Divi、Beaver Builder、Bricks 这类页面构建器里都能用——只要那里会解析简码。Gutenberg 区块是锦上添花，不是必需品。
它是 GPL 第 2 版或更高版本下的自由软件，和 WordPress 本身同一个许可。你可以阅读它、修改它，也可以在自己的站点上跑自己改过的版本。
凡是最终会进入页面 HTML 的东西，都值得用怀疑的眼光看一遍，所以这里说明你的属性会经历什么。文件 ID 必须符合 [A-Za-z0-9_-]，长度在十到六十个字符之间；不符合的会以可见的提示被拒绝，而不是被粘进网址里。宽和高都要过 absint()，因此一个走丢的字母只会得到默认值，而不会把版面弄乱。拼好的网址在进入 src 之前会先转义。
有一件事值得知道，因为它常让人意外：WordPress 会悄悄丢掉它不认识的简码属性。你写成 hight="600"，什么也不会坏——只是拿到默认高度，而且哪儿都不会有警告。如果某个选项看上去毫无作用，先对照上面的表格检查一下拼写。
插件从你的服务器向我们发出的请求恰好只有一个，而且只在设置了 text="1" 时才发：它要的是那一本翻页书的文字。关于你访客的任何信息都不会被送出，因为它压根就不知道他们的任何事。
两者生成的 HTML 完全一样，所以这只关乎你习惯怎么干活。区块会在编辑器里给你实时预览，侧栏里的选项是真正的控件，试尺寸的时候更顺手。简码是文本，方便在文章之间复制、粘进页面构建器，也方便以后想找出站点上每一本翻页书时直接搜索。
如果你是替别人维护站点，简码还有一个实际好处：换主题、换编辑器、迁移到页面构建器，它都能原样活下来，不用重新搭一遍。想把这个插件和另外三种嵌入方式——裸 iframe、JavaScript 片段、oEmbed——放在一起比较，可以看在 WordPress 中嵌入 PDF 这篇指南。
免费注册 Toombler 账号，将 Drive、Dropbox 或 OneDrive 中的 PDF，或 Google Docs、Slides 文件一键变身翻页书，数分钟内即可无缝嵌入您的站点。