Seit Dezember 2024 verlangt die GPSR (Verordnung über die allgemeine Produktsicherheit), dass sicherheitsrelevante Informationen zum Produkt verfügbar sind — viele Marktplätze wie Kaufland fordern zusätzlich Sicherheitsdatenblätter je Artikel. Die Erweiterung gibt Händlern ein zentrales Werkzeug, um Datenblätter, Anleitungen, Sicherheitsdatenblätter und Konformitätserklärungen im Shop-Admin hochzuladen, mit Titel und Typ zu versehen und einem oder mehreren Artikeln zuzuordnen.
Eine Datei kann mehreren Artikelnummern zugeordnet werden (n:m) — praktisch bei Variantenartikeln, bei denen z. B. ein Sicherheitsdatenblatt für alle Varianten gilt. Wer viele Artikel auf einmal pflegen muss, nutzt die CSV-Massenzuordnung (Artikelnummer, Dateiname, Titel, Typ je Zeile) statt jede Zuordnung einzeln im Admin zu setzen.
Auf der Produktseite erscheint eine Downloads-Box mit Typ-Badge, Dateiendung und Dateigröße — nur wenn tatsächlich Dateien zugeordnet sind, keine leere Box. Der Abruf läuft über einen eigenen Download-Handler mit Zähler je Datei; sobald eine Datei keinem Artikel mehr zugeordnet ist, ist sie sofort nicht mehr erreichbar. Uploads werden per Endungs-Whitelist, MIME-Prüfung und zufälligem Dateinamen abgesichert, der Upload-Ordner ist per .htaccess gesperrt.
Funktionen im Überblick:
- Upload & Zuordnung von PDF/ZIP/PNG/JPG im Admin, Typ Datenblatt/Anleitung/Sicherheitsdatenblatt/Konformitätserklärung/Sonstiges
- CSV-Massenzuordnung mit Fehlerbericht je Zeile
- Eine Datei für beliebig viele Artikelnummern, inkl. Vater-Artikel-Vererbung bei Varianten
- Downloads-Box auf der Produktseite, nur bei zugeordneten Dateien sichtbar
- Eigener Download-Handler mit Zähler je Datei, sicheres Upload-Handling
Das Plugin liefert die Dokumente aus — es prüft nicht deren rechtliche Vollständigkeit oder Richtigkeit; welche Dokumente konkret erforderlich sind, ist im Einzelfall rechtlich zu klären. Keine externen Dienste, keine CDN-Loads.
Ihre Vorteile
- Ein zentraler Ort im Admin für Sicherheitsdatenblätter und Konformitätserklärungen
- CSV-Massenzuordnung erspart manuelles Verknüpfen bei großen Artikelbeständen
- Eine Datei für mehrere Artikelnummern, inkl. Vererbung an Variantenkinder vom Vater-Artikel
- Download-Handler mit Zähler je Datei, sofortige Sperrung bei entfernter Zuordnung
- Sicheres Upload-Handling: Endungs-Whitelist, MIME-Prüfung, zufällige Dateinamen
Key Facts
-
Risikomanagement
Zentrale, nachvollziehbare Verwaltung sicherheitsrelevanter Produktdokumente unterstützt Händler dabei, GPSR- und Marktplatz-Anforderungen an Datenblätter organisatorisch abzudecken — die rechtliche Vollständigkeit bleibt Aufgabe des Händlers.
-
Lizenz
Standard JTL Plugin License
-
Kompatibel mit JTL-Wawi ab
Keine Abhängigkeit
-
Kompatibel mit JTL-Shop 5 ab
5.2.0 - 5.8.*
Installation & EinrichtungInstallation
- Erweiterung über den JTL-Extension Store beziehen bzw. das Plugin-Paket im JTL-Shop-Backend unter Plugins → Plugin-Manager hochladen.
- Im Plugin-Manager unter Vorhanden das Plugin Datenblätter und Produkt-Downloads auswählen und installieren.
- Nach der Installation erscheint das Plugin unter Installiert — dort aktivieren, falls nicht bereits aktiv.
Einrichtung
- Unter Plugins → Datenblätter und Produkt-Downloads → Downloads verwalten Dateien hochladen, Titel und Typ vergeben und Artikelnummern zuordnen (einzeln oder per CSV-Massenzuordnung).
- Unter Einstellungen die Überschrift der Downloads-Box, die maximale Dateigröße und bei Bedarf den CSS-Selektor für die Einfüge-Position anpassen.
- Optional Dateien des Vater-Artikels bei Varianten anzeigen aktivieren, wenn Dokumente für alle Varianten gelten sollen.
Hinweise
- Eine Datei ist nur erreichbar, solange sie mindestens einem Artikel zugeordnet ist — Zuordnung entfernen sperrt den Download sofort.
- Der maximale Upload richtet sich zusätzlich nach den PHP-Limits
upload_max_filesize und post_max_size des Hostings.
- Bei Nginx-Hosting die
.htaccess-Sperre des Upload-Ordners durch eine äquivalente Server-Konfiguration ersetzen.
NutzungsvoraussetzungenJTL-Shop ab Version 5.2.0, PHP ab 8.1. Keine externen Dienste, keine CDN-Loads. Es werden Dateinamen, Titel, Typ und Download-Zähler gespeichert — keine personenbezogenen Kundendaten. Wichtig: Das Plugin liefert die zugeordneten Dokumente lediglich aus; es prüft nicht deren inhaltliche Vollständigkeit oder Rechtskonformität (z. B. GPSR-Anforderungen) — das bleibt in der Verantwortung des Händlers.
SystemvoraussetzungenJTL-Shop: 5.2.0 oder neuer. PHP: 8.1 oder neuer. Datenbank: eigene Tabellen wppd_files (Datei-Metadaten, Zähler) und wppd_map (Zuordnung Datei ↔ Artikelnummer). Sonstiges: Upload-Ordner wird per .htaccess gesperrt (funktioniert auf Apache/LiteSpeed; bei Nginx ist eine manuelle deny-all-Regel nötig).
Externe DokumentationenInstallationKonfiguration
1.0.0 - 15.07.2026- Kompatibel mit JTL-Wawi: Keine Abhängigkeit
- Kompatibel mit JTL-Shop 5:von 5.2.0 - 5.8.*
Erste Veröffentlichung.
