Médias et documents
Importer des images ou documents, choisir leur rôle et contrôler qui peut les ouvrir.
Rôle et visibilité sont distincts
Un fichier peut porter plusieurs rôles : image principale, galerie, miniature, pièce jointe, preuve, document de commande, etc. Le rôle décide où il apparaît ; seule la visibilité décide qui peut lire son URL.
Un document marqué ATTACHMENT mais laissé public n’apparaît pas dans une galerie, tout en restant
accessible à quiconque possède son URL. Placez toujours un document interne en Privé.
Rôles courants
| Rôle | Usage |
|---|---|
MAIN-IMAGE | Image principale d’un produit, d’une variante ou d’un entrepôt. |
GALLERY | Image ou vidéo d’une galerie. |
MINIATURE | Vignette de carte ou d’email. |
BANNER | Image de catégorie affichée par le shop. |
SWATCH | Échantillon visuel d’une valeur. |
ATTACHMENT, DOCUMENT | Document associé sans affichage automatique. |
INVOICE, SHIPPING-LABEL, CUSTOMS | Documents de commande. |
PROOF, PROOF-OF-PAYMENT | Justificatif de remboursement ou de paiement. |
CLIENT-UPLOADED | Marque ajoutée automatiquement à un dépôt client. |
Les rôles visuels refusent les formats qu’ils ne savent pas afficher : GALLERY accepte image ou
vidéo ; image principale, miniature, bannière, swatch et photo exigent une image.
Les catégories utilisent actuellement leur rôle BANNER. Leurs rôles ICON et GALLERY peuvent
être conservés sans être rendus par le shop livré.
Formats acceptés
Le dialogue d’import affiche la règle effective et fait foi. La configuration courante autorise :
- marchand : JPG, JPEG, PNG, GIF statique, WebP statique, PDF, documents bureautiques, TXT, CSV, MP4 et MOV selon le rôle ;
- client : JPG, JPEG, PNG et PDF selon le parcours.
Le serveur vérifie le contenu réel, pas seulement l’extension. HTML, SVG, JavaScript, archives exécutables et autres formats actifs sont toujours refusés. Renommer un fichier dangereux ne le rend pas acceptable.
Public ou privé
| Visibilité | Accès |
|---|---|
| Public | URL directe accessible sans authentification, adaptée aux visuels du catalogue. |
| Privé | Équipe du marchand et personnes disposant d’un droit nominatif. |
Un fichier privé lié à une commande est lisible par son client ; lié à une demande de remboursement, par son demandeur ; lié à un avis, par son auteur. Un fichier déposé par un client reste lisible par ce client. L’accès produit une URL temporaire valable une heure : ne la conservez ni ne la partagez.
Un même fichier peut être lié à plusieurs éléments. S’il est public sur au moins un lien, son objet reste public. Les vues privées ne le listent qu’aux personnes autorisées, mais une URL publique déjà connue reste accessible.
Changer un fichier de public à privé bloque les nouvelles lectures anonymes, sans rappeler les copies déjà mises en cache. Pour un document nominatif, importez donc un fichier distinct par destinataire et ne le rendez jamais public.
Visibilité conseillée
| Élément | Défaut utile |
|---|---|
| Produit, variante, catégorie | Public pour les visuels destinés au shop. |
| Avis marchand | Public. |
| Avis client | Privé jusqu’à son acceptation, puis public ; redevient privé s’il est rejeté. |
| Commande et remboursement | Privé, avec accès au client concerné. |
| Entrepôt | Privé pour les documents internes. |
Le badge de chaque vignette indique sa visibilité. Modifier cette visibilité depuis la galerie s’applique au fichier partout où il est lié.
Import marchand
Depuis la galerie d’un élément, choisissez les fichiers, leurs rôles et la visibilité. Un lot est traité fichier par fichier : les réussites restent acquises si un autre fichier échoue. Corrigez puis relancez seulement les lignes refusées.
Une association accepte plusieurs rôles. Certains sont uniques par élément : ajouter une nouvelle bannière de catégorie ou image principale d’entrepôt retire ce rôle à l’ancienne. Si l’ancien fichier n’a plus aucun rôle ni autre lien, il est retiré de cet élément.
Un traitement déjà occupé peut demander de réessayer après quelques secondes. Attendez avant de renvoyer le fichier afin d’éviter les doublons visibles.
Dépôts client
Un client inscrit peut joindre :
- jusqu’à cinq images à un avis ; elles deviennent publiques seulement si l’avis est accepté ;
- jusqu’à cinq images ou PDF à une demande de remboursement ;
- une preuve ou un document à une commande lorsque le parcours le propose.
Ces dépôts naissent privés et portent automatiquement le rôle CLIENT-UPLOADED. Le marchand peut
les requalifier. Un invité peut lire les documents privés de sa commande, mais ne peut pas importer de
nouveau fichier.
Traitement des images
Les images sont réencodées sans métadonnées, notamment EXIF et position GPS, tout en respectant leur orientation. Elles sont refusées au-delà de 16 mégapixels, de 8 192 pixels sur un côté ou si elles sont animées.
Les PDF, vidéos et documents bureautiques ne sont pas nettoyés de leurs métadonnées. Retirez vous-même auteur, logiciel ou localisation avant de les publier.
Retirer ou supprimer
Retirer un média d’un élément enlève seulement ce lien. Le fichier survit tant qu’un autre élément l’utilise. La suppression définitive du fichier est le seul geste qui détruit tous ses liens ; elle est irréversible.
Chaque élément accepte au maximum 100 fichiers. Les quotas d’import et de stockage sont propres au rôle ; supprimer un fichier ne rend pas le quota journalier d’imports réussis.
Résoudre un problème
| Symptôme | Action |
|---|---|
| Rôle visuel indisponible | Choisir une image ou vidéo compatible avec ce rôle. |
| Fichier absent de la galerie | Vérifier son rôle, puis sa visibilité et le statut de l’élément. |
| Document interne accessible par URL | Le passer en Privé ; considérer qu’une copie publique mise en cache peut subsister. |
| Une nouvelle bannière a remplacé l’ancienne | Réattribuer le rôle voulu : ce rôle est unique sur l’élément. |
| Lot partiellement importé | Garder les succès et relancer uniquement les fichiers refusés. |