MW Quick PDF Viewer ist ein leistungsstarkes und benutzerfreundliches Joomla 5/6 Content-Plugin, das die Verwaltung und Präsentation von PDF-Dokumenten auf Ihrer Website revolutioniert. Mit nur einem einfachen Shortcode können Sie professionelle PDF-Bibliotheken erstellen, die Ihre Besucher mit einem modernen Modal-Viewer durchsuchen können.

Entwickelt von Mertsch-Web

Version: 1.0.2
Veröffentlichung: 8. Januar 2026
Kompatibilität: Joomla 5.0 - 6.999
PHP-Version: 8.1+

Hauptmerkmale

? Einfache Bedienung

• Ein-Zeilen-Integration: Fügen Sie einfach {gallery path='pdfs/ordner'} in Ihren Artikel ein
• Keine Programmierung erforderlich: Perfekt für Redakteure ohne technische Kenntnisse
• Automatische Erkennung: Scannt Ordner und listet alle PDF-Dateien automatisch auf
• Flexible Syntax: Verwenden Sie {gallery} oder {pdflist} - beides funktioniert

? PDF-Management

• Intelligente Dateierkennung: Automatisches Scannen von Ordnern nach PDF-Dokumenten
• Dateiinformationen: Zeigt Dateiname und Größe für jedes Dokument an
• Sortierung: Alphabetische Sortierung der Dateien
• Ordnerstruktur: Unterstützt Unterordner und komplexe Verzeichnisstrukturen
• Keine Datenbank: Arbeitet direkt mit Ihrem Dateisystem

?️ Professioneller Modal-Viewer

• Eingebettete Anzeige: PDFs werden direkt im Browser angezeigt (iframe-basiert)
• Nativer Browser-Viewer: Nutzt die integrierten PDF-Funktionen Ihres Browsers
• Vollbildmodus: Maximale Lesbarkeit für Ihre Dokumente
• Smooth Animations: Elegante Einblend- und Ausblendeffekte
• Loading-Feedback: Spinner-Animation während des Ladevorgangs

? Anpassbares Design

• Drei Button-Stile:
  • Standard: Klassischer weißer Button mit grauem Rahmen und rotem Hover
  • Minimal: Dezenter transparenter Stil mit feiner Umrandung
  • Solid: Auffälliger roter Button mit weißem Text
• Responsive Grid: 1-4 Spalten Layout, vollständig anpassbar
• PDF-Icons: Optional ein/ausschaltbare PDF-Symbole auf Buttons
• Moderne UI: Sauberes, professionelles Design für 2026
• Hover-Effekte: Visuelles Feedback bei Mausberührung
• Dark-Mode-Ready: Optimiert für helle und dunkle Themes

? Mobile Optimierung

• Touch-Friendly: Optimiert für Touchscreen-Bedienung
• Responsive Breakpoints: Passt sich automatisch an Bildschirmgrößen an
• Mobile-First-Ansatz: Entwickelt mit Priorität auf mobile Geräte
• Swipe-Gesten: Intuitive Bedienung auf Smartphones und Tablets

⚡ Funktionalität

• Download-Funktion: Direkter Download-Button für jedes PDF
• Druck-Funktion: Sofortiges Ausdrucken aus dem Viewer heraus
• Keyboard-Navigation: ESC-Taste zum Schließen des Modals
• Mehrsprachig: Vollständig übersetzt (Deutsch & Englisch)
• Accessibility: Screenreader-freundlich und barrierefrei

? Technische Highlights

• Keine Abhängigkeiten: Kein jQuery oder externe Frameworks erforderlich
• Vanilla JavaScript: Schnell und leichtgewichtig
• CSS Grid Layout: Moderne Layout-Technologie
• Sauberer Code: PSR-12 kompatibel, gut dokumentiert
• Performance: Optimiert für schnelle Ladezeiten
• Sicherheit: HTML-Escaping und Input-Validierung

Installation

Voraussetzungen

• Joomla 5.0 oder höher (bis Joomla 6.999)
• PHP 8.1 oder höher
• PDF-Dateien in einem zugänglichen Ordner

Installationsschritte

1. Download: Laden Sie die neueste Version als ZIP-Datei herunter
2. Joomla-Backend: Navigieren Sie zu System → Erweiterungen → Installieren
3. Upload: Laden Sie die ZIP-Datei hoch (Drag & Drop oder Browse)
4. Aktivierung: Gehen Sie zu System → Plugins → Filter: Content
5. Plugin finden: Suchen Sie nach "MW Quick PDF Viewer"
6. Aktivieren: Klicken Sie auf den Status, um das Plugin zu aktivieren
7. Fertig: Das Plugin ist nun einsatzbereit!

Verwendung

Schnellstart

Fügen Sie in einem beliebigen Joomla-Artikel oder Modul folgenden Shortcode ein:

{pdflist path='pdfs/mein-ordner'}

```

Wichtig: Der Pfad ist relativ zum Joomla-Wurzelverzeichnis.

Parameter-Referenz

| Parameter | Typ | Erforderlich | Standardwert | Beschreibung |
|-----------|-----|--------------|--------------|--------------|
| path | String | Ja | - | Relativer Pfad zum PDF-Ordner ab Joomla-Root |
| columns | Integer | Nein | 2 | Anzahl der Spalten (1-4), überschreibt Plugin-Einstellung |
| title | String | Nein | - | Überschrift über der PDF-Liste |

Verwendungsbeispiele

Einfachste Variante:
{pdflist path='pdfs/handbuecher'}
→ Zeigt alle PDFs aus dem Ordner "pdfs/handbuecher" in 2 Spalten (Standard)

Mit Spaltenanzahl:
{pdflist path='pdfs/formulare' columns='3'}
→ Zeigt PDFs in 3 Spalten

Mit Titel:
{pdflist path='pdfs/berichte' title='Jahresberichte 2025'}
→ Zeigt eine Überschrift über der PDF-Liste

Alle Parameter:
{pdflist path='pdfs/dokumente/wichtig' columns='4' title='Wichtige Downloads'}
→ Komplette Konfiguration mit allen Optionen

Unterordner:
{pdflist path='pdfs/abteilungen/marketing/2025'}
→ Unterstützt beliebig tiefe Ordnerstrukturen

Plugin-Konfiguration

Öffnen Sie die Plugin-Einstellungen unter System → Plugins → MW Quick PDF Viewer

Basis-Einstellungen

Anzahl Spalten (Standard: 2)
- Bestimmt die Anzahl der Button-Spalten im Grid-Layout
- Optionen: 1, 2, 3 oder 4 Spalten
- Kann pro Shortcode individuell überschrieben werden
- Responsive: Auf mobilen Geräten automatisch weniger Spalten

Button-Stil (Standard: Standard)
- Standard: Weißer Hintergrund, grauer Rahmen, roter Hover-Effekt
- Minimal: Transparenter Hintergrund, dezente Umrandung, minimalistisch
- Solid: Roter Hintergrund, weißer Text, auffällig und modern

Icons anzeigen (Standard: Ja)
- Zeigt PDF-Icon auf jedem Button
- SVG-basiertes Icon für scharfe Darstellung
- Kann deaktiviert werden für minimalistisches Design

Support-Bereich

Das Plugin enthält einen integrierten Support-Bereich mit:
- Informationen zum Entwickler
- Direkte Kontaktmöglichkeiten
- PayPal-Spendenbutton zur Unterstützung der Entwicklung

Modal-Viewer im Detail

Öffnen des Viewers

• Klick auf einen beliebigen PDF-Button
• Modal erscheint mit sanfter Fade-In-Animation
• Hintergrund wird abgedunkelt (Overlay)
• Hauptinhalt bleibt im Hintergrund sichtbar (verschwommen)

Viewer-Funktionen

PDF-Anzeige
- Nutzt nativen Browser-PDF-Viewer (iframe)
- Vollständige Browser-Funktionen verfügbar
- Zoomen, Scrollen, Textsuche möglich
- Automatische Größenanpassung

Aktions-Buttons

1. Download-Button (⬇)

   • Lädt die PDF-Datei herunter
   • Verwendet den originalen Dateinamen
   • Kompatibel mit allen Browsern
   • HTML5-Download-Attribut

2. Druck-Button (?)

   • Öffnet Browser-Druckdialog
   • Direkt aus dem Viewer heraus
   • Nutzt natives window.print()
   • Optimiert für PDF-Druck

3. Schließen-Button (×)

   • Schließt das Modal
   • Alternativ: ESC-Taste drücken
   • Alternativ: Auf Hintergrund klicken
   • Sanfte Fade-Out-Animation

Loading-Status

• Spinner-Animation während des Ladens
• Visuelles Feedback für den Nutzer
• Verschwindet automatisch nach dem Laden

Keyboard-Shortcuts

• ESC: Modal schließen
• Weitere Browser-Shortcuts im PDF-Viewer aktiv

Design-System

Farbpalette

Standard-Theme:
- Primärfarbe: #dc2626 (Rot)
- Hover: #ef4444 (Hellrot)
- Text: #1f2937 (Dunkelgrau)
- Border: #d1d5db (Hellgrau)
- Background: #ffffff (Weiß)
- Overlay: rgba(0, 0, 0, 0.5) (Halbtransparent Schwarz)

Typografie

• System-Font-Stack für optimale Lesbarkeit
• Sans-Serif-Schriften: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto
• Responsive Schriftgrößen
• Optimale Zeilenhöhen für Lesbarkeit

Abstände & Grid

• CSS Grid mit gap für konsistente Abstände
• Responsive Breakpoints für alle Bildschirmgrößen
• Padding und Margins im 8px-Raster
• Maximale Container-Breite für optimale Lesbarkeit

Animationen

• Smooth Transitions (0.2s - 0.3s)
• Fade-In/Fade-Out-Effekte
• Hover-Animationen für interaktive Elemente
• Loading-Spinner mit CSS-Animation

Technische Details

Architektur

• Plugin-Typ: Content Plugin (Event: onContentPrepare)
• Namespace: Standard Joomla-Plugin-Struktur
• Pattern: Observer Pattern (Joomla Event System)
• Code-Standard: PSR-12 Compatible

JavaScript-API

```javascript
// Modal öffnen
function openMWPDFModal(id, url, filename)

// Modal schließen
function closeMWPDFModal(id)

// PDF herunterladen
function downloadMWPDF(url, filename)

// PDF drucken
function printMWPDF(id)
```

Styling-Klassen

css .mw-pdf-grid /* Grid-Container */ .mw-pdf-button /* Basis-Button */ .mw-pdf-button-default /* Standard-Stil */ .mw-pdf-button-minimal /* Minimal-Stil */ .mw-pdf-button-solid /* Solid-Stil */ .mw-pdf-modal /* Modal-Overlay */ .mw-pdf-modal-content /* Modal-Inhalt */

Performance

• Dateioperationen: Gecacht in PHP-Variablen
• CSS: Inline, minimiert
• JavaScript: Inline, Vanilla JS
• Keine externen Requests: Alles lokal
• Lazy Loading: iframes laden PDFs on-demand

Sicherheit

• Input-Validierung: Alle Pfade werden validiert
• Directory Traversal Protection: realpath()-Prüfung
• XSS-Schutz: HTML-Escaping für alle Ausgaben
• File-Type-Check: Nur PDF-Dateien werden akzeptiert
• Permissions: Prüfung auf lesbare Dateien

Browser-Kompatibilität

| Browser | Version | PDF-Anzeige | Download | Druck |
|---------|---------|-------------|----------|-------|
| Chrome | 90+ | ✅ Ja | ✅ Ja | ✅ Ja |
| Firefox | 88+ | ✅ Ja | ✅ Ja | ✅ Ja |
| Safari | 14+ | ✅ Ja | ✅ Ja | ✅ Ja |
| Edge | 90+ | ✅ Ja | ✅ Ja | ✅ Ja |
| Opera | 76+ | ✅ Ja | ✅ Ja | ✅ Ja |
| Mobile Safari | iOS 14+ | ✅ Ja | ✅ Ja | ⚠️ Eingeschränkt |
| Chrome Mobile | Android 11+ | ✅ Ja | ✅ Ja | ✅ Ja |

Hinweise:
- Ältere Browser könnten PDFs nicht inline anzeigen (Download statt Anzeige)
- Mobile Browser haben teilweise eingeschränkte Druckfunktionen
- PDF.js Fallback kann bei Bedarf integriert werden

Häufig gestellte Fragen (FAQ)

Allgemeine Fragen

Q: Funktioniert das Plugin mit Joomla 4?
A: Nein, MW Quick PDF Viewer wurde speziell für Joomla 5 und 6 entwickelt. Für Joomla 4 müsste eine separate Version erstellt werden.

Q: Kann ich andere Dateitypen anzeigen?
A: Nein, das Plugin ist ausschließlich für PDF-Dokumente optimiert. Andere Dateitypen werden ignoriert.

Q: Wie viele PDFs kann ich in einem Ordner haben?
A: Theoretisch unbegrenzt, aber aus Performance-Gründen empfehlen wir maximal 50-100 PDFs pro Ordner.

Q: Werden Unterordner unterstützt?
A: Ja, Sie können beliebig tiefe Ordnerstrukturen angeben (z.B. pdfs/jahr/monat/kategorie).

Technische Fragen

Q: Muss ich jQuery installieren?
A: Nein, das Plugin verwendet Vanilla JavaScript und hat keine Abhängigkeiten.

Q: Werden PDFs in eine Datenbank hochgeladen?
A: Nein, das Plugin arbeitet direkt mit Ihrem Dateisystem. Einfach PDFs in einen Ordner legen und fertig!

Q: Kann ich das Design anpassen?
A: Ja, Sie können eigene CSS-Regeln in Ihr Template einbinden, um das Aussehen zu überschreiben.

Q: Funktioniert es mit allen PDF-Dateien?
A: Ja, solange der Browser PDFs anzeigen kann. Bei sehr großen Dateien (>50MB) kann es zu Ladezeiten kommen.

Problembehandlung

Q: PDFs werden nicht angezeigt
A: Prüfen Sie:
- Ist das Plugin aktiviert?
- Existiert der angegebene Pfad?
- Sind die Dateiberechtigungen korrekt (lesbar)?
- Enthält der Ordner tatsächlich PDF-Dateien?

Q: Der Pfad funktioniert nicht
A: Der Pfad muss relativ zum Joomla-Wurzelverzeichnis sein. Beispiel: Wenn Ihre PDFs unter www.ihreseite.de/dokumente/pdfs/ liegen, verwenden Sie path='dokumente/pdfs'.

Q: Modal öffnet sich nicht
A: Prüfen Sie die Browser-Konsole auf JavaScript-Fehler. Möglicherweise gibt es Konflikte mit anderen Erweiterungen.

Q: Download funktioniert nicht
A: Stellen Sie sicher, dass der Browser Pop-ups und Downloads von Ihrer Domain erlaubt.

Changelog

Version 1.0.2 (8. Januar 2026)

• ✅ Stabile Release-Version
• ? Erweiterte Dokumentation (Deutsch & Englisch)
• ? Update-Server konfiguriert und getestet
• ? Kleine Bugfixes

Roadmap

Geplante Features für zukünftige Versionen

Version 1.1.0 (geplant Q1 2026)
- ? Suchfunktion für PDF-Dokumente
- ?️ Tag-System für Kategorisierung
- ? Sortieroptionen (Name, Datum, Größe)
- ? Weitere Button-Styles

Version 1.2.0 (geplant Q2 2026)
- ? PDF-Beschreibungen/Metadaten
- ?️ Thumbnail-Vorschau (erste Seite)
- ? Mehrere Ordner in einer Galerie
- ? Zugriffsschutz für bestimmte PDFs

Version 2.0.0 (geplant Q3 2026)
- ? PDF-Statistiken (Downloads, Aufrufe)
- ? PDF-Upload direkt aus dem Frontend
- ? Template-System für Custom Designs
- ? API für externe Integrationen

Wünsche und Vorschläge sind willkommen! Kontaktieren Sie uns unter [email protected]

Support & Community

Offizielle Kanäle

Website
https://mertsch-web.de

E-Mail-Support
[email protected]

Dokumentation
Diese README.md-Datei (wird ständig aktualisiert)

Update-Server
https://mertsch-web.de/updates/mwquickpdf.xml

Support-Anfragen

Bei Support-Anfragen bitte folgende Informationen bereitstellen:
- Joomla-Version
- PHP-Version
- Plugin-Version
- Fehlermeldung (falls vorhanden)
- Browser und Version
- Schritte zur Reproduktion des Problems

Bug-Reports

Wenn Sie einen Fehler gefunden haben:
1. Prüfen Sie, ob der Fehler in der neuesten Version noch existiert
2. Suchen Sie in bekannten Issues (falls verfügbar)
3. Kontaktieren Sie uns mit einer detaillierten Beschreibung
4. Fügen Sie Screenshots oder Fehlermeldungen bei

Feature-Requests

Haben Sie eine Idee für ein neues Feature?
- Beschreiben Sie den Anwendungsfall
- Erklären Sie, welches Problem gelöst werden soll
- Senden Sie uns Ihre Idee per E-Mail

Spenden & Unterstützung

MW Quick PDF Viewer ist ein kostenloses Open-Source-Plugin, das mit viel Liebe und Zeit entwickelt wurde. Wenn Sie die Entwicklung unterstützen möchten, freuen wir uns sehr über eine kleine Spende!

Warum spenden?
- ☕ Kaffee für lange Entwicklungsnächte
- ? Server- und Hosting-Kosten
- ? Weiterbildung und neue Technologien
- ? Entwicklung neuer Features
- ? Bugfixes und Support
- ? Verbesserte Dokumentation

Spenden via PayPal:

Jeder Betrag hilft und wird sehr geschätzt! Vielen Dank für Ihre Unterstützung! ❤️

Über den Entwickler

Mertsch-Web ist ein Web-Entwicklungsstudio mit Fokus auf Joomla-Erweiterungen und maßgeschneiderte Web-Lösungen.

Expertise:
- Joomla-Plugin & Module-Entwicklung
- Custom Joomla-Templates
- PHP-Backend-Entwicklung
- Frontend-Development (HTML, CSS, JavaScript)
- Responsive Webdesign
- Performance-Optimierung

Weitere Projekte:
- MW Quick Gallery (Vorgänger dieses Plugins)
- Weitere Joomla-Erweiterungen in Planung

Kontakt:
- ? Website: https://mertsch-web.de
- ? E-Mail: [email protected]
- ? Standort: Deutschland

Lizenz & Copyright

```
MW Quick PDF Viewer - Joomla Plugin
Copyright (C) 2025-2026 Mertsch-Web

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see .
```

GNU General Public License v2.0 oder höher

Das bedeutet:
- ✅ Kostenlose Nutzung (privat & kommerziell)
- ✅ Änderungen am Code erlaubt
- ✅ Weitergabe erlaubt
- ✅ Quellcode verfügbar
- ⚠️ Änderungen müssen dokumentiert werden
- ⚠️ Gleiche Lizenz bei Weitergabe
- ⚠️ Keine Garantie oder Haftung

Credits & Danksagungen

Entwickelt mit:
- PHP 8.1+
- Joomla 5/6 Framework
- Vanilla JavaScript (ES6+)
- CSS Grid & Flexbox
- SVG-Icons
- Viel Kaffee ☕

Besonderer Dank an:
- Die Joomla-Community für Feedback und Support
- Alle Beta-Tester der ersten Versionen
- Die Nutzer, die Bugs gemeldet haben
- Alle Spender, die die Entwicklung unterstützen

Inspiriert von:
- Modernen PDF-Viewer-Lösungen
- Material Design Principles
- Best Practices in UX/UI-Design

Wichtige Hinweise

Haftungsausschluss

Das Plugin wird "wie besehen" zur Verfügung gestellt ohne jegliche Garantie. Der Entwickler übernimmt keine Haftung für:
- Datenverlust
- Server-Probleme
- Konflikte mit anderen Erweiterungen
- Sicherheitslücken durch Fehlkonfiguration
- Indirekte oder direkte Schäden

Sicherheitshinweise

• Stellen Sie sicher, dass PDF-Ordner nicht sensible Daten enthalten
• Setzen Sie angemessene Dateiberechtigungen
• Prüfen Sie regelmäßig auf Updates
• Verwenden Sie HTTPS für Ihre Website
• Implementieren Sie Zugriffsbeschränkungen falls nötig

Best Practices

1. Ordnerstruktur: Organisieren Sie PDFs in logischen Ordnern
2. Dateinamen: Verwenden Sie aussagekräftige Namen ohne Sonderzeichen
3. Dateigröße: Optimieren Sie PDFs vor dem Upload (empfohlen < 5MB)
4. Updates: Halten Sie das Plugin aktuell
5. Backups: Sichern Sie regelmäßig Ihre Joomla-Installation
6. Testing: Testen Sie das Plugin nach Joomla-Updates

Vielen Dank, dass Sie MW Quick PDF Viewer verwenden! ?

Bei Fragen oder Problemen stehen wir Ihnen gerne zur Verfügung.