Order Attachment pour Magento 2

MAGENTO 2 · CHECKOUT · FICHIERS · COMMANDES

Kowal Order Attachment

Ajoutez au checkout un champ pour photo ou PDF, visible pour toutes les commandes ou pour des produits sélectionnés. Associez la pièce jointe à l’achat et mettez-la à disposition du personnel autorisé dans le panneau Magento.

JPG, PNG et PDF · Validation backend · Fichiers hors pub/media

COMMENT ÇA FONCTIONNE EN PRATIQUE

Order Attachment est un module Magento 2 pratique pour les boutiques qui doivent collecter auprès des clients des fichiers supplémentaires liés à une commande. L’extension est particulièrement utile lorsque la réalisation de l’achat nécessite des photos, des scans, des documents PDF, des créations graphiques, des confirmations, des ordonnances, des formulaires ou d’autres supports transmis par le client.

Le module ajoute un champ de pièce jointe sécurisé dans le checkout et enregistre le fichier avec la commande. Le formulaire peut être visible pour toutes les commandes ou uniquement lorsque le panier contient un produit marqué comme nécessitant une pièce jointe. Ainsi, la boutique n’impose pas de téléversement là où il n’est pas nécessaire, tout en permettant de gérer précisément les produits qui exigent des données supplémentaires.

Le principal avantage du module est le contrôle du moment et de la sécurité de l’envoi du fichier. La pièce jointe est validée côté backend, stockée en dehors du répertoire public et mise à disposition des administrateurs uniquement via des actions sécurisées du panneau Magento. Cela limite le risque de divulgation accidentelle des fichiers des clients et élimine le problème des liens publics vers des documents privés.

Après la validation de la commande, l’administrateur voit la pièce jointe directement dans l’aperçu de la commande. Il peut télécharger le fichier ou ouvrir son aperçu si le format est pris en charge. Les formats d’image courants ainsi que le PDF sont pris en charge, et les extensions autorisées ainsi que la taille maximale du fichier peuvent être configurées dans le panneau d’administration.

• Activation ou désactivation globale du module dans la configuration Magento.
• Affichage conditionnel du champ de téléversement dans le checkout.
• Prise en charge de la configuration par produit via un attribut produit.
• Possibilité d’exiger une pièce jointe uniquement pour certains SKU.
• Téléversement de photos et de fichiers PDF.
• Validation backend de l’extension, du type MIME et de la taille du fichier.
• Enregistrement sécurisé des fichiers en dehors du répertoire public.
• Association de la pièce jointe à une commande précise.
• Lien de téléchargement du fichier dans le panneau d’administration.
• Aperçu des fichiers pris en charge dans la vue de la commande.
• Nettoyage automatique des anciens fichiers temporaires.

Le module est destiné aux boutiques Magento 2 qui vendent des produits ou services nécessitant un fichier supplémentaire de la part du client, par exemple :

• produits personnalisés,
• impression et arts graphiques,
• services graphiques,
• produits médicaux ou optiques nécessitant des documents,
• commandes nécessitant une photo de référence,
• produits B2B nécessitant des confirmations ou des formulaires.

• Moins d’échanges manuels par e-mail après la validation de la commande.
• Réduction du risque de perte de fichier, car la pièce jointe est directement associée à la commande.
• Meilleur processus de traitement des produits nécessitant des données supplémentaires.
• Contrôle accru de la sécurité des fichiers clients.
• Travail simplifié pour l’équipe administrative dans le panneau Magento.

L’administrateur peut définir dans le panneau :

• si le module est actif,
• quand le champ de pièce jointe doit être visible,
• si la pièce jointe est obligatoire,
• quelles extensions de fichiers sont autorisées,
• quelle est la taille maximale du fichier,
• si la pièce jointe doit être visible dans l’aperçu de la commande,
• si un aperçu du fichier est disponible.

Le module a été conçu selon le principe que chaque fichier transmis n’est pas fiable. C’est pourquoi les fichiers sont validés côté serveur, reçoivent des noms techniques sécurisés et ne sont pas publiés sous forme d’URL directes dans pub/media. Le téléchargement et l’aperçu s’effectuent via des contrôleurs d’administration protégés par les autorisations Magento.

Stores → Configuration → Sales → Order Attachments permet de définir la visibilité, l’obligation, le titre, la description, les formats, la limite et l’aperçu. Par défaut, le module est désactivé, le formulaire concerne les produits sélectionnés et la limite est de 10 MB.

Les extensions prises en charge sont jpg, jpeg, png et pdf. requires_order_attachment indique un produit nécessitant ce champ ; le panier vérifie également les produits enfants. La visibilité du formulaire et l’obligation d’ajouter un fichier sont deux paramètres distincts.

Le checkout actuel prend en charge un seul fichier, sa suppression et un nouveau téléversement. Le validateur rejette un fichier vide ou trop volumineux, vérifie l’extension et le type MIME à partir du contenu, ainsi que la signature %PDF- pour les PDF.

Un nom comportant plus d’un point est rejeté, par exemple projet.version.pdf. La liste de configuration n’étend pas la prise en charge aux formats sans correspondance MIME dans le module. Ces contrôles ne remplacent pas un scanner de fichiers supplémentaire si le processus de la boutique l’exige.

Le téléversement est associé au quote et enregistré temporairement en dehors du répertoire public. Une fois la commande créée, le fichier est déplacé vers son emplacement, et cron supprime les anciens fichiers temporaires.

L’aperçu et le téléchargement nécessitent l’autorisation View Order Attachments ainsi que l’accès à la commande. La configuration du module dispose d’une autorisation distincte. Il est également possible d’y accéder via kowal.store → Modules → Order Attachments → Configuration.

Le formulaire est un composant du checkout standard de Magento. Hyvä, un checkout alternatif et les architectures headless nécessitent une vérification et une intégration spécifique de l’interface de téléversement.

L’obligation est également contrôlée lors du quote submit ; les commandes passées via API ou par d’autres chemins doivent donc garantir une association conforme de la pièce jointe. Il ne faut pas supposer que l’absence de formulaire dans une interface donnée désactive la validation backend.

Package kowal/module-order-attachment, module Kowal_OrderAttachment. Après avoir configuré l’accès au dépôt Kowal, installez le package, activez le module, mettez Magento à jour et videz le cache. En production, prévoyez la compilation et le déploiement du contenu statique conformément au processus de votre boutique.

1. Vous définissez la visibilité et l’obligation
Vous configurez le mode et marquez les produits sélectionnés.

2. Le client transmet un fichier
Le backend vérifie le format, le contenu et la taille.

3. L’équipe reçoit la pièce jointe
Après l’achat, le fichier apparaît dans la vue de la commande.

Vous marquez le produit avec l’attribut Requires Order Attachment. Avec un tel panier, le client voit le champ de téléversement et transmet la photo avant l’achat.

Après la validation de la commande, un administrateur autorisé peut télécharger le fichier ou ouvrir un aperçu pris en charge. Le support reste associé à la commande précise.