Maxcode_ProductAttachment Magento 2.4.xPHP 8.2+Multi-boutiquesFR + EN

Vos documents, sur chaque fiche produit, pour les bonnes personnes.

Product Attachment réunit vos fiches techniques, notices et certificats dans une bibliothèque, les rattache à autant de produits que vous voulez, et les montre dans un onglet de la fiche produit. Chaque document peut être réservé à certains groupes clients et à certaines vues de magasin.

75 € licence par installation de production

Acheter le module Lire la documentation

Le constat

Un PDF, cent produits, zéro contrôle.

Fiches techniques, notices, certificats : sans bibliothèque, chaque fichier se renvoie produit par produit, et celui qui ne devait être vu que par certains clients reste accessible à qui connaît son adresse.

Sans le module

  • Le même PDF est téléversé à nouveau pour chaque produit
  • Un document réservé à vos clients professionnels reste accessible par son adresse
  • Pas de différence entre vos groupes de clients ni entre vos vues de magasin
  • Le même avertissement pour toutes les langues

Avec Product Attachment

  • Un document créé une fois, rattaché à autant de produits que nécessaire
  • Chaque document limité à des groupes clients et à des vues de magasin
  • Fichiers hors de la racine web, servis après contrôle des droits à chaque téléchargement
  • Un onglet « Documents » sur la fiche produit, avec un avertissement par vue de magasin

Pour qui

Boutiques B2B

Des documents réservés à vos clients pro

Un document réservé à un groupe client n'est ni listé ni téléchargeable pour les autres : une adresse fabriquée ou devinée renvoie un 404 et ne révèle jamais qu'il existe.

Catalogues techniques

Fiches techniques, notices, certificats

Une bibliothèque partagée entre produits, avec un fichier ou un lien externe, un ordre de tri et un interrupteur Activé.

Fonctionnalités

Une bibliothèque, plusieurs produits.

Bibliothèque

Un document, plusieurs produits

Vous créez un document une fois, un fichier ou un lien externe, et vous le rattachez à autant de produits que vous voulez, depuis le document ou depuis la fiche produit.

Droits

Qui voit quoi

Chaque document peut être limité à certains groupes clients et à certaines vues de magasin. Un document que le client n'a pas le droit de voir n'est pas listé et ne peut pas être téléchargé.

Fiche produit

Un onglet Documents

Les documents sont listés en tableau ou en liste, avec le libellé d'onglet de votre choix, par vue de magasin.

Mention légale

Un avertissement configurable

Une mention au-dessus des documents, par vue de magasin (donc traduisible), avec la raison sociale de votre boutique renseignée pour vous.

Sécurité

Des téléchargements sécurisés

Les fichiers sont stockés hors de la racine web et servis par un contrôleur qui rejoue les règles d'accès à chaque téléchargement. Ils sont envoyés en pièce jointe : un autre site ne peut pas les intégrer.

Envois

Des envois et des liens sûrs

Nom de fichier contrôlé, seules les extensions que vous autorisez sont acceptées, 32 Mo au plus par fichier, et un lien ne peut être qu'en http ou https.

Gestion

Rapide à gérer

Ajoutez un nouveau document sans quitter la fiche produit (une fenêtre s'ouvre, la ligne apparaît dans la liste du produit), ou rattachez des documents existants depuis une grille filtrable.

Compatibilité

Avec Maxcode Product Visibility

Si vous l'avez, un produit masqué pour un groupe client reste masqué pour ses documents. Les deux modules restent indépendants.

Qualité

Traduit, testé

Interface en anglais et en français. Tests unitaires inclus.

Documentation

Tout ce qu’il faut pour démarrer.

Le détail complet, en français et en anglais, est livré avec le module (README et documentation intégrée à l’administration Magento).

Installation

Product Attachment est un module payant : le code source et l'accès Composer vous sont remis avec l'achat.

composer require maxcode/module-product-attachment
bin/magento module:enable Maxcode_ProductAttachment
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Prérequis : Magento Open Source ou Adobe Commerce 2.4.x, PHP 8.2 ou supérieur.

Mise à niveau depuis une version antérieure à 2.4.0 (une fois par environnement) : les fichiers étaient dans pub/media, lisible par tous. Déplacez-les hors de la racine web :

bin/magento maxcode:product-attachment:relocate-files --dry-run   # simuler d'abord
bin/magento maxcode:product-attachment:relocate-files
bin/magento cache:flush

Les anciennes adresses média directes cessent de fonctionner : c'est voulu. Les liens de téléchargement des fiches produit continuent de fonctionner.

Gérer les documents

Catalogue > Product Attachments > Manage Attachments. Un document a un nom, une description, un type (fichier ou lien), le fichier ou l'adresse, les groupes clients et vues de magasin autorisés (vide = tout le monde), un ordre de tri et un interrupteur *Activé*.

Pour rattacher un document à des produits, au choix :

  • ouvrez le document et choisissez les produits dans la grille filtrable ;
  • ou ouvrez un produit, allez dans sa section Documents et utilisez Ajouter un document existant ou Ajouter un nouveau document. Enregistrez le produit pour conserver les modifications.
Réglages

Stores > Configuration > Maxcode > Documents Produit (aussi accessible depuis Catalogue > Product Attachments > Configuration).

RéglageRôle
Activer le moduleActive ou désactive tout le module.
Afficher l'onglet sur la fiche produitAffiche ou masque l'onglet.
Libellé de l'ongletLe titre de l'onglet, par vue de magasin.
AvertissementLa mention au-dessus des documents, par vue de magasin. %1 est remplacé par la raison sociale. Vide : texte par défaut.
AffichageLes documents en tableau ou en liste.
Extensions autoriséesLes types de fichiers acceptés à l'envoi.
Pour les développeurs
  • maxcode_attachment et maxcode_attachment_product : les documents et leur lien aux produits (schéma déclaratif).
  • Controller/Attachment/Download : la seule voie de téléchargement. Elle rejoue les règles de visibilité, de groupe et de vue, et vérifie que le document est lié au produit demandé. Refus : 404.
  • Model/FileUploader, FileNameSanitizer, LinkUrlValidator : envoi (32 Mo, extensions autorisées), contrôle du nom de fichier, liens http/https seulement. Stockage sous var/maxcode/attachment/.
  • maxcode:product-attachment:relocate-files [--dry-run] : idempotent.

Caractéristiques techniques

Ce qu’il vous faut.

Plateforme
Magento 2Open Source et Adobe Commerce 2.4.x
PHP
8.2+Comme Magento 2.4.8
Fichiers
32 Mo au plusExtensions autorisées au choix
Stockage
Hors racine webvar/maxcode/attachment/
Langues
FR + ENAdministration et boutique
Qualité
Tests unitairesInclus avec le module

Licence

  • Une installation Magento de production par licence. Installations de test, de développement et de préproduction illimitées, multi-boutiques comprises.
  • 12 mois de mises à jour et de support dans le prix de la licence.
  • Code source complet et accès Composer remis à l’achat. Contrat de licence utilisateur final : la version française prévaut.

Vos documents, aux bonnes personnes.

Une installation de production · 12 mois de mises à jour et de support inclus

75 €

TVA non applicable, art. L. 223-3 du CIBS

Ou par téléphone : 07 83 977 377