Si tu biblioteca de documentos funciona perfectamente en su propia página, pero los botones Descargar (y a veces Vista previa) no hacen nada una vez que la insertas en otro sitio web, este artículo explica por qué y qué hacer al respecto.
Qué está pasando
Algunas plataformas de sitios web cargan el contenido insertado dentro de un sandbox iframe, que es un contenedor aislado al que el navegador web impide deliberadamente realizar ciertas acciones, incluida la descarga de archivos. Cuando tu biblioteca de documentos se coloca dentro de uno de estos espacios aislados, el navegador bloquea la descarga sin avisar y el botón parece no hacer nada.
La vista previa también puede verse afectada. De forma predeterminada, la vista previa se abre en una pestaña nueva del navegador, y el mismo espacio aislado también impide abrir pestañas nuevas.
Esta es una restricción impuesta por la plataforma de alojamiento y aplicada por el navegador. No es un fallo de Document Library Pro. La misma biblioteca se descarga perfectamente desde su propia URL y en cualquier plataforma que no aísle los elementos insertados.
Wix es el ejemplo más habitual. Las dos opciones de inserción de Wix (“Embed HTML/Code” y “Embed a Site”) colocan tu biblioteca en un entorno aislado que no permite descargas.
Cómo confirmar que esta es la causa
Comprueba esto primero, porque si los síntomas son distintos puede tratarse de otro problema que sí podemos solucionar:
- Abre la URL directa de la biblioteca. Copia la dirección de tu Embed Code (por ejemplo
https://your-library.documentlibrary.app/?dlp_embed=1) y ábrela en una pestaña nueva del navegador. Haz clic en Descargar. Si ahí se descarga bien pero insertada no, la causa es la sandbox de inserción. - Revisa la consola del navegador (opcional, técnico). En la página insertada, abre la consola de desarrollo del navegador. Un mensaje como "Download is disallowed. The frame… is sandboxed and the 'allow-downloads' permission is not set" o
ERR_BLOCKED_BY_CLIENTlo confirma.
Si el archivo también tampoco se descarga desde la URL directa, este no el problema del entorno aislado, así que contacta con soporte y te ayudaremos a llegar al fondo del asunto.
Cómo solucionarlo
Wix
Instala y usa la app de Wix de Document Library Pro en lugar de pegar un Embed Code. La app añade tu biblioteca como un elemento nativo de Wix que no está aislado, así que la descarga y la vista previa funcionan con normalidad. Si has pegado el Embed Code y ves este problema, contacta con soporte y te ayudaremos a cambiarte.
WordPress autoalojado, Webflow, Framer o sitios HTML sencillos
Estas no aíslan las inserciones, por lo que el código de inserción estándar funciona, incluidas las descargas. Si ves el problema en una de ellas, se debe a otra cosa, así que contacta con soporte.
Otros creadores de sitios web (Squarespace, Notion y similares)
Si la plataforma ofrece una aplicación o integración oficial de Document Library Pro, úsala. Si solo ofrece un campo genérico de “embed code” y aísla el contenido, no podrás activar las descargas en esa plataforma. Aun así, puedes permitir que los visitantes vean tus documentos (ver más abajo).
Opción de solo lectura (funciona incluso dentro de una sandbox)
Si en tu plataforma no se pueden activar las descargas, tus visitantes aún pueden abrir y leer los documentos en un visor dentro de la página. Solo tienes que poner el botón de descarga, en los ajustes de tu biblioteca, en desactivado el botón de descarga en la pestaña Display de tus ajustes y deja el Vista previa activado. Dentro de una sandbox, la vista previa abre automáticamente cada documento en un visor dentro de la página (en lugar de una pestaña nueva), así que funciona incluso donde las descargas no lo hacen.
Esto funciona con PDF e imágenes. Los archivos de Word y Excel no se pueden mostrar así en un navegador, por lo que una configuración de solo lectura encaja con bibliotecas formadas por PDF e imágenes. Si quieres ayuda para configurarlo, contacta con soporte.
¿Sigues atascado?
Ponte en contacto a través del soporte indicando el nombre de tu plataforma y la URL de la página, y te aconsejaremos la mejor opción para tu caso.