zinejs Flipbook
| 开发者 | isdipesh |
|---|---|
| 更新时间 | 2026年9月30日 18:50 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
zinejs Flipbook embeds a fast, GPU-accelerated page-flip reader in your posts and pages. Point it at a
PDF from your Media Library and readers can flip, zoom, and page through it like a real book. A CSS
fallback keeps it working on devices without WebGL.
Ways to add a flipbook:
- The Zine PDF Flipbook block: pick a PDF and set options in the editor.
- The Zine Image Flipbook block: pick a set of images.
- The [zinejs] shortcode: for the Classic editor, theme templates, and page builders.
[zinejs pdf="https://example.com/brochure.pdf" spread="cover" curl="silk" controls-position="top"]
The shortcode accepts the same options as the blocks. Source: pdf (URL) or images
(comma-separated URLs). Layout: spread (cover | double | single | book), direction (ltr | rtl),
fit (contain | fill), gutter-overlap (auto, or a percent of page width such as 2), responsive (true | false), threshold (px), max-width (px), aspect
(e.g. 3/2, or auto). Interaction: click-to-flip (edge | half | off), curl (cone | simple | roll
| leaf | flick | silk), flip-duration (ms), start-page (0-based). Zoom: zoom (true | false),
zoom-max, zoom-wheel, zoom-double-click. Controls: controls (true | false),
controls-position (top | bottom | left | right), controls-scheme (auto | light | dark),
controls-arrows, context-menu, loading, hints, deep-link. Permissions: allow-download,
allow-print, allow-share. Covers: front-cover (URL), back-cover (URL). Sound: sound
(true | false), sound-volume (0..1), sound-muted, sound-persist.
By default the book drops to one page per spread when its container is narrower than 500px
(threshold), so it stays readable on phones and in narrow theme columns. If your column is narrow
but you still want two-page spreads (for example in cover mode), set responsive="false", or use
the block's Wide/Full alignment to give it more room.
安装:
- Upload the
zinejs-flipbookfolder to/wp-content/plugins/, or install the plugin through the Plugins screen in WordPress. - Activate it through the Plugins screen.
- Add a "Zine Flipbook" block to a post or page, or use the
[zinejs]shortcode.
屏幕截图:
常见问题:
Can I show more than one flipbook on a page?
Yes. Add multiple blocks or shortcodes; each mounts independently.
The PDF does not render on my server
pdf.js loads its worker as an ES module. A few servers serve .mjs files with the wrong MIME type,
which blocks the worker. If pages stay blank, add this to your server config (Apache .htaccess):
AddType text/javascript .mjs
更新日志:
1.1.0
- New "Print gutter overlap" option (block and
gutter-overlapshortcode attribute): hides artwork a print PDF repeats on both sides of the spine. Auto finds it per spread, or set a fixed percent. - Bundles zinejs engine 1.0.0.
- Two blocks (PDF and Images) plus the [zinejs] shortcode, with the full zinejs option set.