Order Attachment para Magento 2

MAGENTO 2 · CHECKOUT · ARCHIVOS · PEDIDOS

Kowal Order Attachment

Añade al checkout un campo para una imagen o PDF, visible para todos los pedidos o solo para productos seleccionados. Vincula el adjunto con la compra y ponlo a disposición del personal autorizado en el panel de Magento.

JPG, PNG y PDF · Validación backend · Archivos fuera de pub/media

CÓMO FUNCIONA EN LA PRÁCTICA

Order Attachment es un práctico módulo Magento 2 para tiendas que necesitan recopilar de sus clientes archivos adicionales vinculados al pedido. La extensión resulta especialmente útil cuando para completar la compra se necesitan fotos, escaneos, documentos PDF, diseños gráficos, confirmaciones, recetas, formularios u otros materiales enviados por el cliente.

El módulo añade un campo seguro de adjunto en el checkout y guarda el archivo junto con el pedido. El formulario puede mostrarse para todos los pedidos o solo cuando el carrito contiene un producto marcado como que requiere adjunto. Así, la tienda no obliga a subir archivos donde no es necesario y, al mismo tiempo, puede gestionar con precisión los productos que requieren datos adicionales.

La principal ventaja del módulo es el control sobre el momento y la seguridad del envío del archivo. El adjunto se valida en el backend, se almacena fuera del directorio público y se pone a disposición de los administradores únicamente mediante acciones protegidas del panel de Magento. Esto reduce el riesgo de exposición accidental de los archivos de los clientes y elimina el problema de enlaces públicos a documentos privados.

Después de realizar el pedido, el administrador ve el adjunto directamente en la vista previa del pedido. Puede descargar el archivo o abrir su vista previa si el formato es compatible. Se admiten formatos de imagen populares y PDF, y las extensiones permitidas y el tamaño máximo del archivo se pueden configurar en el panel de administración.

• Activación o desactivación global del módulo en la configuración de Magento.
• Visualización condicional del campo de upload en el checkout.
• Compatibilidad con configuración por producto mediante atributo de producto.
• Posibilidad de exigir un adjunto solo para SKU seleccionados.
• Upload de imágenes y archivos PDF.
• Validación backend de la extensión, MIME type y tamaño del archivo.
• Almacenamiento seguro de archivos fuera del directorio público.
• Vinculación del adjunto con un pedido concreto.
• Enlace de descarga del archivo en el panel de administración.
• Vista previa de los archivos compatibles en la vista del pedido.
• Limpieza automática de archivos temporales antiguos.

El módulo está pensado para tiendas Magento 2 que venden productos o servicios que requieren un archivo adicional del cliente, por ejemplo:

• productos personalizados,
• impresión y artes gráficas,
• servicios gráficos,
• productos médicos u ópticos que requieren documentos,
• pedidos que requieren una foto de referencia,
• productos B2B que requieren confirmaciones o formularios.

• Menos comunicación manual por correo electrónico después de realizar el pedido.
• Menor riesgo de perder el archivo, porque el adjunto queda asociado directamente al pedido.
• Mejor proceso de gestión de productos que requieren datos adicionales.
• Mayor control sobre la seguridad de los archivos de los clientes.
• Trabajo más sencillo para el equipo administrativo en el panel de Magento.

El administrador puede configurar en el panel:

• si el módulo está activo,
• cuándo debe mostrarse el campo de adjunto,
• si el adjunto es obligatorio,
• qué extensiones de archivo están permitidas,
• cuál es el tamaño máximo del archivo,
• si el adjunto debe mostrarse en la vista previa del pedido,
• si está disponible la vista previa del archivo.

El módulo se ha diseñado partiendo de la premisa de que cualquier archivo enviado no es de confianza. Por eso, los archivos se validan en el servidor, reciben nombres técnicos seguros y no se publican como URL directas en pub/media. La descarga y la vista previa se realizan mediante controladores administrativos protegidos por permisos de Magento.

Stores → Configuration → Sales → Order Attachments permite definir la visibilidad, la obligatoriedad, el título, la descripción, los formatos, el límite y la vista previa. Por defecto, el módulo está desactivado, el formulario se aplica a productos seleccionados y el límite es de 10 MB.

Las extensiones compatibles son jpg, jpeg, png y pdf. requires_order_attachment indica un producto que requiere el campo; el carrito también comprueba los productos secundarios. La visibilidad del formulario y la obligación de añadir el archivo son ajustes independientes.

El checkout actual admite un archivo, su eliminación y un nuevo upload. El validador rechaza archivos vacíos o demasiado grandes, comprueba la extensión y el MIME a partir del contenido, y para PDF también la firma %PDF-.

Se rechazan los nombres con más de un punto, por ejemplo proyecto.version.pdf. La lista de configuración no amplía la compatibilidad a formatos sin mapa MIME en el módulo. Estos controles no sustituyen a un escáner de archivos adicional si el proceso de la tienda lo requiere.

El upload se asigna al quote y se guarda temporalmente fuera del directorio público. Tras crear el pedido, el archivo se traslada a su ubicación y cron elimina los archivos temporales antiguos.

La vista previa y la descarga requieren el permiso View Order Attachments y acceso al pedido. Configuration del módulo es un permiso independiente. También se puede acceder a través de kowal.store → Modules → Order Attachments → Configuration.

El formulario es un componente del checkout estándar de Magento. Hyvä, los checkouts alternativos y headless requieren revisión e integración propia de la interfaz de upload.

La obligatoriedad también se controla durante quote submit, por lo que los pedidos mediante API u otras rutas deben garantizar una vinculación compatible del adjunto. No debe asumirse que la ausencia del formulario en una interfaz concreta desactiva la validación del backend.

Paquete kowal/module-order-attachment, módulo Kowal_OrderAttachment. Tras configurar el acceso al repositorio de Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la cache. En producción, incluye la compilación y el despliegue de contenido estático de acuerdo con el proceso de la tienda.

1. Defines la visibilidad y la obligatoriedad
Configuras el modo y marcas los productos seleccionados.

2. El cliente sube el archivo
El backend verifica el formato, el contenido y el tamaño.

3. El equipo recibe el adjunto
Tras la compra, el archivo aparece en la vista del pedido.

Marcas el producto con el atributo Requires Order Attachment. Con ese carrito, el cliente ve el campo de upload y sube la foto antes de la compra.

Después de realizar el pedido, un administrador autorizado puede descargar el archivo o abrir una vista previa compatible. El material permanece vinculado al pedido concreto.