Wenn deine Dokumentenbibliothek auf ihrer eigenen Seite einwandfrei funktioniert, die Schaltflächen Download (und manchmal Vorschau) jedoch nichts bewirken, sobald du sie auf einer anderen Website einbettest, erklärt dieser Artikel, woran das liegt und was du dagegen tun kannst.
Was passiert
Einige Website-Plattformen laden eingebettete Inhalte in einem Sandbox- iframe, einem abgeschotteten Container, in dem der Webbrowser bestimmte Aktionen absichtlich verhindert, darunter das Herunterladen von Dateien. Wenn deine Dokumentbibliothek in einer solchen Sandbox liegt, blockiert der Browser den Download ohne Hinweis. Deshalb scheint die Schaltfläche nicht zu funktionieren.
Auch die Vorschau kann betroffen sein. Standardmäßig wird sie in einem neuen Browser-Tab geöffnet. Die Sandbox verhindert jedoch auch das Öffnen neuer Tabs.
Diese Einschränkung wird von der Hosting-Plattform vorgegeben und vom Browser durchgesetzt. Sie ist kein Fehler in Document Library Pro. Dieselbe Bibliothek ermöglicht Downloads problemlos über ihre eigene URL und auf jeder Plattform, die eingebettete Inhalte nicht in einer Sandbox ausführt.
Wix ist das häufigste Beispiel. Beide Einbettungsoptionen von Wix (“Embed HTML/Code” und “Embed a Site”) führen deine Bibliothek in einer Sandbox aus, die keine Downloads erlaubt.
So bestätigst du die Ursache
Bitte prüfe dies zuerst, denn bei abweichenden Symptomen kann ein anderes Problem vorliegen, das wir für dich beheben können :
- Öffne die direkte URL der Dokumentenbibliothek. Kopiere die Adresse aus deinem Einbettungscode (zum Beispiel
https://your-library.documentlibrary.app/?dlp_embed=1) und öffne sie in einem neuen Browser-Tab. Klicke auf Download. Funktioniert der Download dort, aber nicht im eingebetteten Zustand, ist die Einbettungs-Sandbox die Ursache. - Prüfe die Browser-Konsole (optional, technisch). Öffne auf der eingebetteten Seite die Entwicklerkonsole deines Browsers. Eine Meldung wie „Download is disallowed. The frame… is sandboxed and the 'allow-downloads' permission is not set" oder
ERR_BLOCKED_BY_CLIENTbestätigt dies.
Wenn die Datei sich auch über die direkte URL nicht herunterladen lässt, ist dies nicht das Sandbox-Problem. Bitte kontaktiere den Support , und wir helfen dir, der Sache auf den Grund zu gehen.
So behebst du das Problem
Wix
Installiere und verwende die Document Library Pro Wix-App, anstatt einen Einbettungscode einzufügen. Die App fügt deine Dokumentenbibliothek als natives Wix-Element ein, das nicht in einer Sandbox liegt, sodass Download und Vorschau normal funktionieren. Wenn du den Einbettungscode eingefügt hast und dieses Problem siehst, kontaktiere den Support , und wir helfen dir beim Wechsel.
Selbst gehostetes WordPress, Webflow, Framer oder einfache HTML-Websites
Diese Plattformen führen eingebettete Inhalte nicht in einer Sandbox aus. Deshalb funktioniert der Standard-Einbettungscode einschließlich der Downloads. Wenn das Problem auf einer dieser Plattformen auftritt, hat es eine andere Ursache. Bitte kontaktiere den Support.
Andere Website-Baukästen (Squarespace, Notion und ähnliche)
Wenn die Plattform eine offizielle Document Library Pro-App oder -Integration anbietet, verwende sie. Bietet sie nur ein allgemeines Feld für “embed code” an und führt den Inhalt in einer Sandbox aus, können Downloads auf dieser Plattform nicht aktiviert werden. Du kannst Besucher trotzdem ansehen lassen (siehe unten).
Nur-Ansicht-Option (funktioniert auch in einer Sandbox)
Lassen sich auf deiner Plattform keine Downloads aktivieren, können Besucher Dokumente trotzdem in einem Viewer direkt auf der Seite öffnen und lesen. Schalte dazu einfach die Download-Schaltfläche in deinen Bibliothekseinstellungen aus die Download-Schaltfläche im Tab Anzeige deiner Einstellungen und lasse die Vorschau aktiviert. In einer Sandbox öffnet die Vorschau jedes Dokument automatisch in einem Viewer auf der Seite (statt in einem neuen Tab), sodass sie auch dort funktioniert, wo Downloads es nicht tun.
Das funktioniert für PDFs und Bilder. Word- und Excel-Dateien lassen sich auf diese Weise nicht im Browser anzeigen, daher eignet sich eine Nur-Ansicht-Einrichtung für Dokumentenbibliotheken aus PDFs und Bildern. Wenn du dabei Hilfe möchtest, kontaktiere den Support.
Immer noch nicht gelöst?
Melde dich über den Support und nenn uns die Plattform und die Seiten-URL, dann empfehlen wir dir die beste Option für dein Setup.