Order Attachment é um módulo prático para Magento 2 destinado a lojas que precisam de recolher dos clientes ficheiros adicionais associados à encomenda. A extensão é especialmente útil nos casos em que, para concluir a compra, são necessárias fotografias, digitalizações, documentos PDF, projetos gráficos, comprovativos, receitas, formulários ou outros materiais enviados pelo cliente.

O módulo adiciona um campo de anexo seguro no checkout e guarda o ficheiro juntamente com a encomenda. O formulário pode estar visível para todas as encomendas ou apenas quando o carrinho contém um produto marcado como exigindo anexo. Desta forma, a loja não obriga ao upload quando este não é necessário e, ao mesmo tempo, consegue tratar com precisão os produtos que exigem dados adicionais.

A principal vantagem do módulo é o controlo sobre o momento e a segurança do envio do ficheiro. O anexo é validado no backend, armazenado fora do diretório público e disponibilizado aos administradores exclusivamente através de ações protegidas do painel Magento. Isto reduz o risco de divulgação acidental dos ficheiros dos clientes e elimina o problema de links públicos para documentos privados.

Após a realização da encomenda, o administrador vê o anexo diretamente na visualização da encomenda. Pode descarregar o ficheiro ou abrir a sua pré-visualização, se o formato for suportado. São suportados formatos de imagem populares e PDF, e as extensões permitidas e o tamanho máximo do ficheiro podem ser configurados no painel de administração.

Principais funcionalidades

Ativação ou desativação global do módulo na configuração do Magento.
Apresentação condicional do campo de upload no checkout.
Suporte para configuração por produto através de atributo de produto.
Possibilidade de exigir anexo apenas para SKU selecionados.
Upload de imagens e ficheiros PDF.
Validação no backend da extensão, MIME type e tamanho do ficheiro.
Armazenamento seguro de ficheiros fora do diretório público.
Associação do anexo a uma encomenda específica.
Link para descarregar o ficheiro no painel de administração.
Pré-visualização dos ficheiros suportados na vista da encomenda.
Limpeza automática de ficheiros temporários antigos.

Para quem é este módulo

O módulo destina-se a lojas Magento 2 que vendem produtos ou serviços que exigem um ficheiro adicional do cliente, por exemplo:

produtos personalizados,
impressão e artes gráficas,
serviços gráficos,
produtos médicos ou óticos que exigem documentos,
encomendas que exigem uma fotografia de referência,
produtos B2B que exigem comprovativos ou formulários.

Vantagens para o negócio

Menos comunicação manual por email após a realização da encomenda.
Menor risco de perda do ficheiro, uma vez que o anexo é associado diretamente à encomenda.
Melhor processo de tratamento de produtos que exigem dados adicionais.
Maior controlo sobre a segurança dos ficheiros dos clientes.
Trabalho mais simples para a equipa administrativa no painel Magento.

Configuração

O administrador pode definir no painel:

se o módulo está ativo,
quando o campo de anexo deve estar visível,
se o anexo é obrigatório,
quais as extensões de ficheiro permitidas,
qual o tamanho máximo do ficheiro,
se o anexo deve estar visível na visualização da encomenda,
se a pré-visualização do ficheiro está disponível.

Segurança

O módulo foi concebido com o princípio de que cada ficheiro enviado não é de confiança. Por isso, os ficheiros são validados no lado do servidor, recebem nomes técnicos seguros e não são publicados como URL diretos em pub/media. O descarregamento e a pré-visualização são efetuados através de controladores administrativos protegidos pelas permissões do Magento.