Document Localizer Pro – Externe PDFs & Links lokalisieren

Lieferantendokumente über Ihre eigene Shop-Domain anbieten

Klickt ein Kunde in der Produktbeschreibung auf eine Anleitung oder ein Datenblatt, soll er möglichst nicht auf einer unbekannten Lieferantendomain landen. Borban Document Localizer Pro kann freigegebene externe PDF-Dateien herunterladen, als lokale Dokumente verwalten und die ursprünglichen Links in Produktbeschreibungen durch Shop-URLs ersetzen.

Dabei bleibt der sichtbare Linktext erhalten. Der Kunde öffnet weiterhin „Bedienungsanleitung“ oder „Datenblatt“, erhält das Dokument aber aus der Infrastruktur Ihres Shops. Es entstehen keine pauschalen Weiterleitungen auf den ursprünglichen PDF-Anbieter.

• Lokale Bereitstellung unterstützter PDF-Dokumente
• Neutrale eigene Dokument-URLs
• Bestehenden Linktext und übrige Beschreibung erhalten
• Dieselbe Quelldatei nicht unnötig mehrfach speichern

Kompletter URL-Audit für Produktbeschreibungen und Übersetzungen

Der integrierte URL-Audit durchsucht Produktbeschreibungen einschließlich ihrer Übersetzungen nach absoluten URLs. Er findet nicht nur klassische anklickbare Links, sondern auch URLs in HTML-Attributen, Bildern oder eingebetteten Elementen.

Die Übersicht trennt interne Shopziele, ausdrücklich erlaubte Fremddomains, bekannte PDF-Quellen und bislang unbekannte externe Adressen. So erkennen Sie, welche Lieferantenlinks bewusst gewollt sind und welche näher geprüft werden sollten.

• URLs in Links und weiteren HTML-Bereichen erfassen
• Vorkommen und betroffene Produkte nachvollziehbar zählen
• Interne, erlaubte externe, unbekannte und PDF-fähige Quellen unterscheiden
• Mehrsprachige Produktbeschreibungen einbeziehen

PDF-Import mit Dateiprüfung und freigegebenen Quelldomains

Für unterstützte Quelldomains lassen sich PDF-Dateien gezielt lokalisieren. Der Import prüft Domain und Dateityp, verarbeitet Downloads speicherschonend und kontrolliert unter anderem den PDF-Header sowie ein konfigurierbares Dateilimit.

Nach erfolgreichem Import speichert Shopware eine Zuordnung zwischen Ausgangsquelle und lokaler Datei. Dadurch kann das Plugin erkennen, wenn dieselbe Datei bereits vorhanden ist. Nicht erlaubte, defekte oder ungeeignete Quellen werden nicht stillschweigend zu einem vermeintlich gültigen PDF erklärt.

• Freigabeliste für Quelldomains
• PDF-Header, Dateityp und Dateigröße überprüfen
• Stream-Download für größere Dokumente
• Quell- und lokale Datei miteinander verknüpfen

Linköffnung für Kunden passend einstellen

Für lokal gespeicherte PDF-Dokumente kann der Händler wählen, ob sie im selben Tab, in einem neuen Tab oder als Download geöffnet werden sollen.

Je nach Einstellung stehen passende Hinweise beziehungsweise Symbole für einen neuen Tab oder den Download zur Verfügung. Bereits lokalisierte Links lassen sich auf das gewünschte Öffnungsverhalten abstimmen; die produktindividuellen Linktexte bleiben bestehen.

• Gleicher Tab, neuer Tab oder direkter Download
• Kennzeichnung der gewählten Öffnungsart
• Geeignete Sicherheitsattribute beim Öffnen neuer Tabs
• Keine manuelle Umgestaltung jeder einzelnen Produktbeschreibung nötig

Erreichbarkeit von Dokumenten, Bildern und Links kontrollieren

Ein technisch korrekt aussehender Link kann längst ins Leere führen. Document Localizer Pro prüft sowohl interne als auch externe Ziele und dokumentiert ihre Erreichbarkeit. So lassen sich unter anderem 404-Fehler, Redirects, gesperrte Zugriffe, Serverfehler und Timeouts unterscheiden.

Die Diagnose berücksichtigt auch DNS-, SSL-/TLS- und Weiterleitungsprobleme. Eine nicht verfügbare Quelle erscheint in der Arbeitsübersicht, statt dass der Händler erst von Kunden auf die defekte PDF-Anleitung aufmerksam gemacht wird.

• HTTP-Status und Ziel von Weiterleitungen erfassen
• 404, 403 und 5xx sowie Timeout- und Verbindungsfehler differenzieren
• Interne Dokument- und Bild-URLs prüfen
• Offene Problemfälle gezielt erneut kontrollieren

Einzelne URLs punktgenau austauschen

Eine veraltete PDF-Adresse oder ein falscher Link lässt sich zunächst als Vorschau betrachten: Wie viele konkrete URL-Vorkommen und Produktbeschreibungen wären betroffen? Erst nach ausdrücklicher Freigabe wird die exakt ausgewählte Quelladresse ersetzt.

Vor sensiblen Änderungen werden Beschreibungssicherungen angelegt und Ersetzungen protokolliert. Das Plugin soll nicht die gesamte HTML-Struktur umschreiben, nur weil ein einzelner Dokumentlink korrigiert werden muss.

• Quell- und Ziel-URL festlegen
• Treffer und betroffene Produkte vorab ansehen
• Gezielte Freigabe statt automatischer Massenänderung
• Sicherung, Historie und kontrolliertes Rückgängigmachen

Falsche Domains und Pfade per Präfix-Regel korrigieren

Sind in Tausenden Produktbeschreibungen die gleichen alten Domains oder Verzeichnispfade hinterlegt, unterstützt Document Localizer Pro auch eine Präfix-Ersetzung. Damit lässt sich beispielsweise eine veraltete Hersteller-Dokumentdomain in eine neue, freigegebene Struktur überführen.

Gerade hier ist die Vorschau entscheidend: Eine Präfixregel kann viele URLs erfassen. Der Händler prüft deshalb die betroffenen Vorkommen, bestätigt den geplanten Schritt und kontrolliert anschließend das Ergebnis.

Änderungen am Original-PDF erkennen

Hersteller aktualisieren Datenblätter und Anleitungen. Das Plugin hält deshalb technische Vergleichsinformationen vor und kann später kontrollieren, ob sich das externe Quelldokument geändert hat.

Berücksichtigt werden unter anderem SHA-256-Dateihash, Dateigröße sowie – falls vorhanden – ETag und Last-Modified. Auch dauerhaft entfernte, zeitweise nicht erreichbare oder plötzlich ungültige PDF-Quellen werden im Status nachvollziehbar.

• Hash, Dateigröße und HTTP-Metadaten vergleichen
• Zeitpunkt der letzten Dokumentprüfung speichern
• Unveränderte, geänderte und nicht mehr erreichbare Quellen unterscheiden
• Aktualisierungsbedarf ohne blindes Überschreiben erkennen

Große PDF-Dateien speicherschonend herunterladen

Um umfangreiche Anleitungen oder technische Unterlagen zu verarbeiten, verwendet die Erweiterung Stream-Downloads statt große Dokumente vollständig in den PHP-Arbeitsspeicher zu laden. Das maximale Importvolumen ist konfigurierbar.

Optional kann eine PDF-Optimierung mit Ghostscript aktiviert werden. Diese Funktion setzt eine passende Serverumgebung voraus; optimierte Dateien werden nur übernommen, wenn die PDF gültig und tatsächlich kleiner ist. Ohne verfügbare Optimierung bleibt das brauchbare Original erhalten.

Problemquellen finden und gezielt nacharbeiten

Kann eine Quelle nicht geladen werden, ist das Dokument zu groß oder entspricht es keinem gültigen PDF, erscheint der Fall mit konkreter Ursache in einer eigenen Übersicht.

Der Händler kann den Download wiederholen, eine neue URL eintragen, das Dateilimit prüfen, die betreffende Produktbeschreibung bearbeiten oder einen geeigneten internen Ersatz bereitstellen. Fehlende Dokumente werden nicht durch frei erfundene Dateien ersetzt.

Verwaiste PDF-Dateien kontrolliert bereinigen

Wird ein lokalisierter Link später entfernt, löscht das Plugin die ursprüngliche lokale Datei nicht sofort automatisch. Zunächst zeigt eine Vorschau mögliche, nicht mehr referenzierte Dokumente mit Dateiname, Quelle und Größe.

Die Löschung erfordert eine bewusste Freigabe. Unmittelbar davor wird die Verwendung erneut geprüft, damit weiterhin referenzierte Dateien nicht versehentlich verloren gehen.

Sicherung und Rückgängig-Funktion für Produktbeschreibungen

Jede URL-Korrektur kann zahlreiche Produktseiten betreffen. Deshalb verbindet Document Localizer Pro Vorschauen, interne Beschreibungssicherungen, Vorher-/Nachher-Informationen und eine nachvollziehbare Ersetzungshistorie.

Beim Zurücknehmen berücksichtigt das System auch später vorgenommene manuelle Änderungen, statt fremde Bearbeitungen unbeachtet zu überschreiben. Für umfangreiche Aktionen empfiehlt sich zusätzlich ein vollständiges Datenbank-Backup.

Regelmäßige Prüfungen über Shopware im Hintergrund

Neue externe PDF-Links, geänderte Quelldokumente und die Erreichbarkeit von Linkzielen können über Shopware Scheduled Tasks erneut überprüft werden. So behalten Händler auch bei regelmäßigen PIM-, CSV- oder API-Produktimports den Überblick.

Der Arbeitsablauf bleibt kontrolliert: Quellen definieren, Audit durchführen, Vorschau prüfen, PDFs freigeben, Veränderungen durchführen und abschließend den Audit erneut ausführen.

Für Dropshipping, Großhandel und umfangreiche Sortimente

Besonders wertvoll ist die Erweiterung, wenn viele Produktdaten von Herstellern, Distributoren oder Großhändlern stammen: Bedienungsanleitungen, Sicherheits- und Datenblätter, Konformitätsunterlagen, Zertifikate oder weitere PDF-Produktinformationen.

Wichtig: Document Localizer Pro prüft die technische Verfügbarkeit und verarbeitet Dokumentlinks. Es übernimmt keine fachliche Prüfung, ob ein PDF rechtlich aktuell, inhaltlich korrekt oder für das angebotene Produkt vorgeschrieben ist. Ebenso werden Bilder nicht automatisch wie PDF-Dokumente aus Fremdquellen heruntergeladen.

Kompatibilität und Vorbereitung

Die Erweiterung ist für Shopware 6.7.x vorgesehen. Für Hintergrundprüfungen müssen Shopware Scheduled Tasks und Message Queue laufen; außerdem benötigt der Server ausgehenden Zugriff auf freigegebene Quelldomains und ausreichend Speicherplatz für die lokalen Dokumente. Eine optional aktivierte PDF-Optimierung setzt Ghostscript voraus. Vor großen Eingriffen sollten Quell- und Zielregeln auf einer Testumgebung geprüft werden.

Die zentrale Arbeitsoberfläche ermöglicht die Prüfung und Pflege, ohne jeden Produktdatensatz einzeln zu öffnen. Die Verantwortung für die Verwendung und Veröffentlichung fremder Dokumente sowie für deren Rechte und Aktualität verbleibt beim Shopbetreiber.

Häufige Fragen

Antworten auf wichtige Fragen vor der Einrichtung und beim Einsatz im laufenden Shop.