Order Attachment para Magento 2

MAGENTO 2 · CHECKOUT · FICHEIROS · ENCOMENDAS

Kowal Order Attachment

Adicione ao checkout um campo para imagem ou PDF, visível para todas as encomendas ou para produtos selecionados. Associe o anexo à compra e disponibilize-o à equipa autorizada no painel Magento.

JPG, PNG e PDF · Validação no backend · Ficheiros fora de pub/media

COMO FUNCIONA NA PRÁTICA

Order Attachment é um módulo Magento 2 prático para lojas que precisam de recolher dos clientes ficheiros adicionais associados à encomenda. A extensão é especialmente útil quando, para processar 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 assinalado como exigindo anexo. Assim, a loja não força o upload onde ele não é necessário e, ao mesmo tempo, consegue gerir com precisão produtos que requerem 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 apenas 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.

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

• Ativação ou desativação global do módulo na configuração do Magento.
• Apresentação condicional do campo de upload no checkout.
• Suporte de configuração por produto através de atributo de produto.
• Possibilidade de exigir anexo apenas para SKU selecionados.
• Upload de fotografias e ficheiros PDF.
• Validação no backend da extensão, do tipo MIME e do tamanho do ficheiro.
• Gravação segura 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.

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.

• Menos comunicação manual por e-mail após a encomenda.
• Menor risco de perder o ficheiro, porque o anexo fica diretamente associado à encomenda.
• Melhor processo de gestão 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.

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 pré-visualização da encomenda,
• se a pré-visualização do ficheiro está disponível.

O módulo foi concebido com o princípio de que cada ficheiro enviado não é fiável. 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 download e a pré-visualização são realizados através de controladores administrativos protegidos por permissões Magento.

Stores → Configuration → Sales → Order Attachments permite definir a visibilidade, a obrigatoriedade, o título, a descrição, os formatos, o limite e a pré-visualização. Por predefinição, o módulo está desativado, o formulário aplica-se a produtos selecionados e o limite é de 10 MB.

As extensões suportadas são jpg, jpeg, png e pdf. requires_order_attachment indica um produto que exige o campo; o carrinho também verifica produtos filho. A visibilidade do formulário e a obrigação de adicionar ficheiro são definições separadas.

O checkout atual suporta um ficheiro, a sua remoção e novo upload. O validador rejeita ficheiros vazios ou demasiado grandes, verifica a extensão e o MIME a partir do conteúdo e, para PDF, também a assinatura %PDF-.

Um nome com mais de um ponto é rejeitado, por exemplo, projeto.versao.pdf. A lista de configuração não alarga o suporte a formatos sem mapa MIME no módulo. Estes controlos não substituem um scanner de ficheiros adicional, se o processo da loja o exigir.

O upload é atribuído ao quote e guardado temporariamente fora do diretório público. Após a criação da encomenda, o ficheiro é movido para a respetiva localização, e o cron remove ficheiros temporários antigos.

A pré-visualização e o download exigem a permissão View Order Attachments e acesso à encomenda. Configuration do módulo é uma permissão separada. Também pode aceder através de kowal.store → Modules → Order Attachments → Configuration.

O formulário é um componente do checkout Magento padrão. Hyvä, checkouts alternativos e headless exigem verificação e integração própria da interface de upload.

A obrigatoriedade também é controlada durante o quote submit, pelo que encomendas por API ou outros fluxos devem garantir uma associação compatível do anexo. Não se deve assumir que a ausência do formulário numa determinada interface desativa a validação no backend.

Pacote kowal/module-order-attachment, módulo Kowal_OrderAttachment. Depois de configurar o acesso ao repositório Kowal, instale o pacote, ative o módulo, atualize o Magento e limpe a cache. Em produção, inclua a compilação e a implementação de conteúdos estáticos de acordo com o processo da loja.

1. Defina a visibilidade e a obrigatoriedade
Configure o modo e marque os produtos selecionados.

2. O cliente envia o ficheiro
O backend verifica o formato, o conteúdo e o tamanho.

3. A equipa recebe o anexo
Após a compra, o ficheiro fica disponível na vista da encomenda.

Marque o produto com o atributo Requires Order Attachment. Com esse carrinho, o cliente vê o campo de upload e envia a fotografia antes da compra.

Depois de a encomenda ser efetuada, um administrador autorizado pode descarregar o ficheiro ou abrir uma pré-visualização suportada. O material permanece associado à encomenda específica.