Document Localizer Pro – Externe PDFs & Links lokalisieren

Borban Document Localizer Pro ist eine professionelle Shopware-6-Erweiterung zum Prüfen, Lokalisieren, Ersetzen und dauerhaften Überwachen externer Dokument- und URL-Verknüpfungen in Produktbeschreibungen. Externe PDF-Dateien können automatisiert in den eigenen Shop übernommen, über eine eigene Shop-Domain ausgeliefert und bei späteren Änderungen der Quelldatei erneut geprüft werden.

Produktdaten aus Warenwirtschaft, PIM, Großhandel, Dropshipping oder Herstellerimporten enthalten häufig externe Links zu Gebrauchsinformationen, Beipackzetteln, Sicherheitsdatenblättern, Datenblättern, Zertifikaten, Anleitungen oder weiteren Produktdokumenten. Dadurch verlassen Kunden beim Öffnen eines Dokuments den Shop, fremde Domains werden sichtbar beworben und der Händler bleibt von der dauerhaften Erreichbarkeit der ursprünglichen Quelle abhängig.

Borban Document Localizer Pro löst dieses Problem direkt in Shopware. Das Plugin analysiert Live- Produktbeschreibungen, erkennt externe URLs, lokalisiert freigegebene PDF-Dokumente, ersetzt ausschließlich die gewünschte Adresse und stellt das Dokument anschließend unter einer stabilen URL des eigenen Shops bereit. Linktext, Produktbeschreibung und übrige HTML-Struktur bleiben erhalten.

Externe Produktdokumente unter der eigenen Shop-Domain bereitstellen

Statt Kunden auf fremde Hersteller-, Lieferanten- oder Großhandelsdomains zu schicken, werden freigegebene PDF-Dokumente lokal gespeichert und über eine neutrale URL des eigenen Shops ausgeliefert.

Aus einer externen Adresse wie https://lieferant.example/media/gebrauchsinformation.pdf kann beispielsweise eine interne Shop-Adresse wie https://www.mein-shop.de/datenblatt/gebrauchsinformation.pdf werden. Der Kunde bleibt auf der eigenen Domain, während das Dokument weiterhin direkt aus der Produktbeschreibung erreichbar ist.

Vollständiger URL-Audit für Produktbeschreibungen

Das Plugin durchsucht die Live-Produktbeschreibungen und ihre Übersetzungen nach absoluten URLs. Dabei werden nicht nur klassische Links innerhalb eines -Tags erkannt. Auch URLs in Bildern, HTML-Attributen, eingebetteten Elementen oder anderen Stellen innerhalb der Beschreibung werden separat erfasst.

Zu jedem Ziel werden Domain, URL, Anzahl der Vorkommen, betroffene Produktbeschreibungen, Produktnummer, Produktname, Sprache und – sofern vorhanden – der sichtbare Linktext angezeigt. Dadurch lässt sich auch bei umfangreichen Datenbeständen nachvollziehen, woher eine Verknüpfung stammt und ob sie beabsichtigt ist.

PDF-Dokumente automatisiert lokalisieren

Freigegebene PDF-Links aus definierten Quelldomains können gesammelt heruntergeladen, geprüft, lokal gespeichert und in den betroffenen Produktbeschreibungen ersetzt werden.

Vor dem eigentlichen Lauf steht ein Testlauf zur Verfügung. Dieser zeigt ausschließlich die erkannten PDF-URLs und betroffenen Produktbeschreibungen an, ohne Daten zu verändern. Erst nach ausdrücklicher Bestätigung startet die vollständige Verarbeitung.

Eigene Dokument-URLs für eine saubere Marken- und Nutzerführung

Lokalisierte Dokumente werden über einen neutralen Pfad des eigenen Shops bereitgestellt, beispielsweise:

Der öffentliche Link verweist damit auf den eigenen Shop. Die ursprüngliche Lieferanten- oder Hersteller-URL bleibt lediglich intern gespeichert, damit das Plugin die Quelle später erneut prüfen kann. Kunden sehen beim Öffnen des Dokuments keine fremde Domain und werden nicht auf eine externe Produkt- oder Shopseite geführt.

Das Dokument wird direkt über die eigene Shop-Adresse ausgeliefert. Es erfolgt keine sichtbare Weiterleitung zu einer technischen Medienadresse oder zur ursprünglichen Quelle. Für lokalisierte PDFs werden passende HTTP-Header gesetzt, damit die Dokumente nicht unnötig als eigenständige Suchergebnisse indexiert werden.

Öffnungsart für Dokumente einfach festlegen

Shopbetreiber können zentral auswählen, wie lokalisierte Dokumente für Kunden geöffnet werden sollen. Dadurch muss das Verhalten nicht in jeder Produktbeschreibung einzeln angepasst werden.

Erreichbarkeit interner und externer URLs prüfen

Ein Link kann optisch korrekt aussehen und trotzdem nicht erreichbar sein. Document Localizer Pro prüft deshalb interne und externe Ziele auf ihren tatsächlichen technischen Status.

Statuscode, Antwortzeit, Weiterleitungsziel und Zeitpunkt der letzten Prüfung werden nachvollziehbar angezeigt. Problematische Ziele können gefiltert und anschließend direkt über die sichere URL-Ersetzung korrigiert werden.

Einzelne URL sicher ersetzen

Eine gefundene URL kann gezielt durch eine neue interne oder externe Adresse ersetzt werden. Vor der Änderung zeigt eine Vorschau exakt, wie viele Vorkommen und Produktbeschreibungen betroffen sind.

Linktexte, HTML-Attribute, Bilder, Formatierungen und alle anderen Inhalte werden dabei nicht neu aufgebaut. Es wird ausschließlich die gewählte Adresse ausgetauscht.

URL-Präfixe als Massenregel ersetzen

Wiederholen sich fehlerhafte Domains oder Verzeichnisse in vielen Produktbeschreibungen, kann das gemeinsame URL-Präfix in einem kontrollierten Massenlauf ersetzt werden.

Beispiel:

Der verbleibende Dateiname oder Unterpfad bleibt erhalten. Dadurch wird beispielsweise aus https://alte-domain.example/GHS06.png automatisch https://www.mein-shop.de/GHS06.png.

Auch hier stehen Vorschau, Trefferzahlen, Vorher-/Nachher-Beispiele, Sicherungen und Rückgängig-Funktion zur Verfügung. Die Zieldateien müssen unter der neuen Adresse bereits vorhanden sein.

Änderungen an Quelldokumenten automatisch erkennen

Externe Dokumente können später vom Hersteller oder Lieferanten aktualisiert werden. Document Localizer Pro speichert technische Vergleichswerte und kann die Quelle regelmäßig erneut prüfen.

Wird eine Änderung erkannt, kann die lokale Datei aktualisiert werden, ohne erneut sämtliche Produktbeschreibungen anzupassen. Die öffentliche Shop-URL bleibt stabil.

Große PDF-Dateien speicherschonend verarbeiten

Große Gebrauchsinformationen, technische Handbücher oder umfangreiche Sicherheitsdokumente können klassische PHP-Downloads schnell an Speicher- oder Laufzeitgrenzen bringen. Das Plugin verwendet deshalb einen speicherschonenden Stream-Download.

Defekte oder offene Quellen übersichtlich verwalten

Nicht erreichbare, ungültige oder zu große Quelldokumente werden nicht stillschweigend übersprungen. Sie erscheinen mit Status, Quelladresse und konkreter Fehlermeldung in einer eigenen Übersicht.

Nicht mehr verwendete PDFs sicher aufräumen

Wird ein lokaler Dokumentlink entfernt oder durch ein anderes Dokument ersetzt, bleibt die alte Datei zunächst erhalten. Das schützt vor versehentlichem Datenverlust und ermöglicht eine kontrollierte Bereinigung.

Die Aufräumfunktion prüft die tatsächlichen Live-Produktbeschreibungen. Nur Dokumente, auf deren interne Shop-URL keine Live-Beschreibung mehr verweist, werden als nicht mehr verwendet angeboten.

Interne Sicherungen und Rückgängig-Funktionen

Massenänderungen an Produktbeschreibungen müssen nachvollziehbar und kontrollierbar bleiben.

Vor Änderungen werden interne Sicherungen der betroffenen Produktübersetzungen angelegt. Einzelne URL- Ersetzungen und Präfix-Regeln werden zusätzlich in einer Historie protokolliert.

Automatische Hintergrundprüfung über Shopware

Neue externe PDF-Links, geänderte Quellen und Linkstatus können regelmäßig über Shopware Scheduled Tasks geprüft werden. Dadurch muss der Händler den Datenbestand nicht täglich manuell kontrollieren.

Für Dropshipping, Großhandel, PIM-Importe und umfangreiche Produktkataloge

Borban Document Localizer Pro eignet sich besonders für Shops, die Produkttexte oder Dokumente regelmäßig aus externen Datenquellen übernehmen. Das Plugin ist jedoch nicht an eine bestimmte Branche oder Lieferquelle gebunden.

Nachvollziehbarer Workflow statt unkontrollierter Massenänderung

Das Plugin arbeitet nicht nach dem Prinzip „Start drücken und hoffen“. Kritische Aktionen werden in klar getrennte Schritte aufgeteilt: scannen, prüfen, freigeben, ausführen und anschließend erneut kontrollieren.

Dieser transparente Ablauf unterstützt eine verantwortungsvolle Datenpflege und erleichtert die technische Kontrolle auch in professionellen Shopware-Projekten mit vielen tausend Produkten.

SEO-, Marken- und Qualitätsvorteile

Die Funktionen unterstützen eine saubere technische Grundlage, ersetzen jedoch keine individuelle SEO-Strategie. Rankings, Sichtbarkeit oder eine bestimmte Verarbeitung durch Suchmaschinen und KI-Systeme können nicht garantiert werden.

Entwickelt aus realer Händlerpraxis

Borban Document Localizer Pro entstand aus einem konkreten E-Commerce-Problem: Tausende Produktbeschreibungen enthielten externe Dokumentlinks eines Lieferanten. Eine manuelle Bereinigung wäre wirtschaftlich kaum durchführbar gewesen. Aus dieser praktischen Anforderung wurde ein wiederverwendbares System für Audit, Lokalisierung, Prüfung, Ersetzung und dauerhafte Pflege externer Dokumente entwickelt.

Dadurch liegt der Fokus nicht nur auf einer theoretischen Importfunktion, sondern auf typischen Anforderungen des laufenden Shopbetriebs: Testlauf, große Datenmengen, defekte Quellen, verständliche Statusanzeigen, sichere Wiederholungen, Sicherungen, Linkprüfung und kontrollierte Aufräumprozesse.

Wichtige Hinweise und Verantwortlichkeiten

Kompatibilität und technische Voraussetzungen

• entwickelt für Shopware 6
• vorgesehen für Shopware 6.7
• keine Änderung an Shopware-Core-Dateien
• Bedienung vollständig über die Shopware Administration
• vorkompilierte Administration enthalten
• kein eigener Administration-Build über die Konsole erforderlich
• PHP-Zugriff auf die konfigurierten Quelldomains erforderlich
• ausreichender Speicherplatz für lokal gespeicherte Dokumente erforderlich
• laufende Scheduled Tasks und Message Queue für automatische Prüfungen erforderlich
• Ghostscript nur für optionale PDF-Komprimierung erforderlich

Lieferumfang

FAQ zu Borban Document Localizer Pro

Borban Document Localizer Pro verbindet Dokumentlokalisierung, URL-Audit, Linkprüfung, Quellenüberwachung, sichere Massenersetzung und kontrollierte Datenpflege in einer zentralen Shopware-6-Erweiterung.

Das Plugin eignet sich für Händler, Dropshipping-Shops, Großhandelsprojekte, Agenturen und Betreiber großer Produktkataloge, die externe Dokumentlinks nicht länger unkontrolliert in ihren Produktbeschreibungen belassen möchten.

Für Shopware-Händler, die externe PDFs unter der eigenen Domain bereitstellen, defekte Links erkennen und umfangreiche Produktbeschreibungen dauerhaft kontrollierbar halten möchten, bietet Borban Document Localizer Pro einen sicheren und nachvollziehbaren Workflow.