Strands PDF Embed
| 开发者 |
strands
LordFren |
|---|---|
| 更新时间 | 2026年10月13日 19:23 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Continuous vertical scroll across all pages, with lazy rendering via IntersectionObserver
- Page navigation, zoom, fit-to-width, download, and print controls (these toggle which buttons render in the toolbar; they're a UI choice, not access control; see the Security section)
- Global sizing modes: Responsive, Fixed, or Fixed Aspect Ratio (A4, Letter, 16:9, 4:3, 1:1, or custom)
- Light, Dark, or Auto color mode (Auto follows the visitor's OS/browser
prefers-color-scheme) - Per-mode color customization (with alpha/transparency support on the Page Shadow field), plus a safely-scoped Custom CSS field for power users
- Live preview on the settings page
- Editors: Gutenberg block, Classic Editor TinyMCE button, Enfold ALB element, Elementor widget, WPBakery element, and
[pdf_embed]shortcode - Media Library picker filtered to PDFs only
- Translation-ready (English + Hungarian included)
- Theme-overridable viewer template
[pdf_embed id="123" sizing="responsive" download="yes" navigation="yes" zoom="yes"]
All attributes are optional except id. Per-embed attrs override the global defaults on the Sizing and Appearance tabs.
安装:
- Upload the
pdf-embed/folder towp-content/plugins/ - Activate the plugin via the Plugins screen
- Visit Settings → PDF Embed to configure default sizing and appearance
屏幕截图:
常见问题:
Can I override the viewer markup in my theme?
Yes. Copy wp-content/plugins/pdf-embed/templates/viewer.php to wp-content/themes/your-theme/pdf-embed/viewer.php and edit.
Does it work with private / draft attachments?
It mirrors WordPress's own permission model. The viewer only renders for visitors who have permission to read the underlying post (current_user_can('read_post', $id)). In practice that means:
- Logged-in admins, editors, and the post's author: drafts and private posts render in their post-preview screens, exactly like the rest of the post content.
- Anonymous visitors: drafts and private posts are blocked (an HTML comment is emitted, no viewer). This is a deliberate security boundary; leaked draft URLs cannot expose embedded PDFs.
How do I add translations?
Drop a .po / .mo / .l10n.php file into the plugin's languages/ folder using the pdf-embed text domain.
Does it work on multisite?
Yes. Activation seeds defaults per site, and uninstall cleans options on each site (including the legacy pdfembed_source from older versions). No network-wide tables, no add_site_option use; per-site settings stay independent.
Where does the Enfold ALB element show up?
In Enfold's Advanced Layout Builder, look for PDF Embed under the Media Elements tab. If your Enfold runs in a non-English language, Enfold groups elements by localized tab name and ours stays in English — so PDF Embed may show up in its own auto-created group instead. The element itself works identically either way.
How does the Print button work?
The viewer renders PDFs safely via PDF.js (canvas pixels, no PDF-side JS executes). The Print button, however, hands the raw PDF to the browser's native PDF renderer; that's the only way to get a browser's print dialog. Don't rely on Print for security-sensitive documents.
Is my PDF.js version patched for CVE-2024-4367?
Yes. PDF Embed ships PDF.js 6.4.299, well past the 4.2.67 patch.
If I set download="no", can visitors still save the PDF?
Yes, technically. The Download button is removed from the toolbar, but the PDF bytes are loaded into the browser by PDF.js to render the document, so a visitor with browser developer tools can still extract them. Use download="no" to remove the button as a UX choice (e.g. on pages where you don't want to encourage downloads), not as a security boundary. The same applies to navigation="no" and zoom="no": they remove buttons; they don't prevent a determined visitor from re-enabling those interactions in their browser. To actually keep a PDF private, restrict the post that embeds it (private/draft, role-restricted, members-only plugin).
更新日志:
PDFDocumentProxy.destroy(), so the viewer now tears down through the loading task instead. Bonus: a viewer removed while its PDF is still loading now shuts its worker down properly too.
PDF.js 6 raised its minimum supported browsers; very old browsers that are no longer supported upstream may not render PDFs.
1.0.5
Welcome to the WordPress.org plugin directory!
Tested with WordPress 7.0 — no code changes needed, the viewer and all integrations continue to work cleanly.
*Plugin directory listing assets prepared: banners, icons, and 5 screenshots covering the frontend viewer, Appearance/Sizing settings, the Gutenberg block, and the Enfold ALB element (Elementor and WPBakery work the same way).
1.0.4
Got feedback from reviews, and time to fix them!
Readme link issues resolved.
Readme adjustments to highlight changes across the board.
Remote file calling is a nono, so I added them to the plugin itself. Removed the capability of externally calling CDN js files entirely now.
Integrating seamlessly into AVIA / Enfold is not gonna be doable as it would require hijacking the namespace which is a nono. So I made our own, the downside is: non english enfold will have our own little category - for now.
Every variable was sanitized, but there were a few phpcs ignore annotations that should not have been left there. All integrations, markup, icons, run through a WP escape function.
Plugin check came back with an extra issue: unprefixed globals. Elementor widget class (and its file) renamed to Spdfembed_Elementor_Widget so Plugin Check stops yelling at me (And this time I am not just commenting the issue out :D).
Missed Phosphor icons attribution.
Revised UX
The light and dark mode selector and configuratior was a bit messy. Improved for clarity and functionality YAY For UX!
Settings page now caps at 1440px instead of stretching the full window; previews live next to their own colour pickers (Light next to Light, Dark next to Dark), no more "Preview as" toggle.
1.0.3
*Welp, I am old. Last time, I checked we always used the CDN versions of included libraries. I was wrong. Swapped the default options. Thank you WP Plugin guidelines reading for the 5th time.
1.0.2
*Readme missed links to the PDF js and WP Color picker projects. Duhhh...
1.0.1
- Assigned slug caused issues on online test I had to fix... Thanks LIFE! :D - assigned slug is now the default. Fingers crossed it wont change again.
- Initial public release.