Описание
MaxtDesign PDF Viewer is a performance-focused PDF embedding solution for WordPress. Unlike other PDF plugins that load heavy JavaScript libraries upfront, this plugin uses a smart lazy-loading approach that keeps your pages fast.
Key Features
- Instant Preview — Server-generated WebP preview images display immediately
- Zero Layout Shift — CSS aspect-ratio reserves exact space before content loads
- Lazy Loading — Full PDF.js viewer loads only when needed
- Gutenberg Block — Native block editor integration
- Shortcode Support — Works in classic editor and widgets
- Keyboard Navigation — Full keyboard and screen reader accessibility
- Mobile Optimized — Touch gestures for page navigation and zoom
Performance
- Initial page load: < 10KB JavaScript
- First paint: < 200ms
- Full viewer: Loads on-demand
- Preview images: Optimized WebP format
How It Works
- Upload a PDF to your media library
- The plugin automatically extracts the first page as a WebP preview
- Insert the PDF using the Gutenberg block or shortcode
- Visitors see an instant preview image
- Clicking «View Document» loads the interactive PDF.js viewer
Requirements
For automatic preview generation, your server needs one of:
- ImageMagick with PDF support (recommended)
- Ghostscript
The plugin will detect available options and use the best method automatically.
Shortcode Usage
[pdf_viewer id=»123″]
Attributes:
- id (required) — Attachment ID of the PDF
- width — CSS width value (default: 100%)
- load — When to load viewer: click, visible, immediate (default: click)
- toolbar — Show toolbar: true/false (default: true)
Privacy
This plugin:
- Does not collect any personal data
- Does not send data to external services
- Stores preview images locally on your server
- Uses PDF.js library loaded from your own server
Скриншоты
PDF viewer with preview image and activation button 
Full interactive viewer with toolbar 
Gutenberg block in the editor 
Settings page — General tab 
Settings page — Server Info tab
Блоки
Этот плагин предоставляет 1 блок.
- PDF Viewer Embed PDFs with instant preview and zero layout shift.
Установка
- Upload the plugin files to
/wp-content/plugins/maxtdesign-pdf-viewer/ - Activate the plugin through the ‘Plugins’ menu in WordPress
- Go to Settings PDF Viewer to configure options
- Check the Server Info tab to verify your server can generate previews
From WordPress Admin
- Go to Plugins Add New
- Search for «MaxtDesign PDF Viewer»
- Click Install Now, then Activate
Часто задаваемые вопросы
-
Why aren’t previews being generated?
-
Preview generation requires ImageMagick or Ghostscript on your server. Go to Settings PDF Viewer Server Info to check your server capabilities. Many shared hosts have ImageMagick pre-installed.
-
Can I regenerate previews for existing PDFs?
-
Yes! Go to Settings PDF Viewer Tools and click «Process Unprocessed PDFs» to generate previews for all PDFs in your media library.
-
How do I change the preview quality?
-
Go to Settings PDF Viewer and change the «Preview Quality» setting. Higher quality means sharper previews but larger file sizes.
-
Does this work with page builders?
-
Yes! Use the shortcode [pdf_viewer id=»123″] in any page builder that supports shortcodes. The Gutenberg block works natively in the WordPress editor.
-
Is it accessible?
-
Yes! The viewer includes full keyboard navigation, ARIA labels, screen reader announcements, and respects reduced motion preferences.
-
Can visitors download or print the PDF?
-
Yes, the toolbar includes download, print, and fullscreen buttons. You can disable these in the block settings or plugin options.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«MaxtDesign PDF Viewer» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
Перевести «MaxtDesign PDF Viewer» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.0.0
- Initial release
- Gutenberg block for easy PDF embedding
- Shortcode support for classic editor
- Automatic WebP preview generation
- PDF.js integration for full viewing
- Keyboard navigation and accessibility
- Admin settings page
- Bulk processing tool
- Cache management