MW Quick PDF Viewer - Version 1.5.1

Key Features

Three Display Modes

Version 1.5.1 introduces flexible display options for maximum compatibility with other plugins:

• Modal Window (Default): Full PDF.js viewer with zoom, navigation, and all features
• Inline Embed: PDF embedded directly on the page with browser PDF viewer (Dearflip-compatible)
• New Tab: PDF opens in new browser tab

Customizable Colors

Complete control over PDF button design in backend:
- Button background color
- Button text color
- Button border color
- Button hover background color
- Icon color

Optimized Mobile View

• iPhone Safe Area support (Notch/Dynamic Island)
• Two-row header layout on mobile devices
• Optimized touch targets
• Automatic text wrapping for long filenames

Full Multilingual Support

All UI texts loaded via Joomla language files:
- German translation (de-DE)
- English translation (en-GB)
- Easy customization by administrators

Improved Print Function

• Works reliably on iOS and Android
• Opens original PDF in new tab
• Uses native browser print dialog

Performance & Compatibility

• PDF.js only loaded in modal mode (prevents conflicts)
• Inline and new tab modes use native browser PDF viewer
• Compatible with Dearflip and other PDF plugins

All Features Overview

Core Features

• Automatic PDF detection in directories
• Responsive grid layout (1-4 columns configurable)
• File size display
• PDF icons
• Zoom function (modal mode)
• Download button
• Print button
• "Powered by der-it-blog.de" link in modal

Backend Configuration

• Define title
• Set column count (1-4 columns)
• Show/hide icons
• Choose display mode (Modal/Inline/New Tab)
• Customize colors (5 color options)
• Premium features (show/hide download/print)

Syntax

{pdflist path="path/to/pdfs"} {pdflist path="path/to/pdfs" columns="3"} {pdflist path="path/to/pdfs" columns="2" title="My PDFs"}

Technical Details

System Requirements

• Joomla: 5.x or 6.x
• PHP: 8.1.0 or higher
• Browser: Modern browsers with PDF support

Loaded Libraries

• PDF.js 3.11.174 (modal mode only)
• Native browser PDF viewer (inline/new tab modes)

New Language Keys (since 1.4.6)

PLG_CONTENT_MWQUICKPDF_PDF_DOCUMENT PLG_CONTENT_MWQUICKPDF_LOADING PLG_CONTENT_MWQUICKPDF_ZOOM_OUT PLG_CONTENT_MWQUICKPDF_ZOOM_IN PLG_CONTENT_MWQUICKPDF_DOWNLOAD PLG_CONTENT_MWQUICKPDF_PRINT PLG_CONTENT_MWQUICKPDF_CLOSE PLG_CONTENT_MWQUICKPDF_PDF_LOADING_WAIT PLG_CONTENT_MWQUICKPDF_POPUP_BLOCKED PLG_CONTENT_MWQUICKPDF_PRINT_ERROR PLG_CONTENT_MWQUICKPDF_DISPLAY_MODE_LABEL PLG_CONTENT_MWQUICKPDF_DISPLAY_MODE_DESC PLG_CONTENT_MWQUICKPDF_DISPLAY_MODE_MODAL PLG_CONTENT_MWQUICKPDF_DISPLAY_MODE_INLINE PLG_CONTENT_MWQUICKPDF_DISPLAY_MODE_NEWTAB

New Backend Options (since 1.4.8)

button_bg_color (Default: #ffffff) button_text_color (Default: #1f2937) button_border_color (Default: #e5e7eb) button_hover_bg_color (Default: #f9fafb) icon_color (Default: #6b7280) display_mode (Default: modal)

Upgrade Notes

From Version 1.4.x to 1.5.0

• No breaking changes
• Old use_modal option replaced by display_mode
• Existing installations automatically use modal mode
• Color settings retain their values

Recommended Settings

For maximum Dearflip compatibility:
- Display mode: "Inline Embed" or "New Tab"

For best user experience:
- Display mode: "Modal Window"
- Icons: Enabled
- Columns: 2-3 depending on layout

Known Limitations

1. Inline Embed Mode:

   • Zoom and navigation controlled by browser PDF viewer
   • Features depend on browser capabilities

2. Mobile Safari:

   • PDF rendering by iOS native viewer
   • Some CSS styles may differ

3. PDF.js Conflicts:

   • When using with Dearflip or other PDF.js plugins: Use inline or new tab mode

Bug Fixes

Version 1.5.0

• CSS styles now load correctly in all display modes
• Button design displayed consistently in all modes

Version 1.4.9 - 1.4.7

• Mobile print function works on iOS and Android
• iPhone Safe Area correctly respected
• Header text clipping fixed

Version 1.4.6

• Accessibility icon no longer printed
• Text wrapping for long filenames corrected
• Print output optimized (no more blank pages)

Roadmap / Planned Features

• [ ] Thumbnail preview of first PDF page
• [ ] PDF sorting (name, date, size)
• [ ] Category filter
• [ ] Search function within PDF list
• [ ] Fullscreen mode for modal
• [ ] Keyboard navigation (arrow keys)
• [ ] Dark mode support

Credits

• Developer: Mertsch-Web
• PDF.js: Mozilla Foundation
• Community Feedback: Many thanks to all users for improvement suggestions, especially for Dearflip compatibility

Support & Documentation

• Website: https://der-it-blog.de/
• Plugin Info: https://mertsch-web.de/plugins/mwquickpdf
• Joomla Extensions: https://extensions.joomla.org/

License

GNU General Public License version 2 or later

Copyright (C) 2025-2026 Mertsch-Web
All rights reserved.