# DataFirefly Custom Textile Printing : marquage textile personnalisé pour PrestaShop

> Présentation Le module ajoute un bloc de marquage sous le bouton d'ajout au panier des produits que vous choisissez. Le client saisit ses quantités par taille, coche ses emplacements, choisit…

- Page: <https://www.datafirefly.com/documentation/dftextileprint/>
- Langue: fr
- Mis à jour le: 2026-09-24
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dftextileprint/index.md), [es](https://www.datafirefly.com/es/documentation/dftextileprint/index.md), [de](https://www.datafirefly.com/de/documentation/dftextileprint/index.md), [it](https://www.datafirefly.com/it/documentation/dftextileprint/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftextileprint/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftextileprint/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftextileprint/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

## Présentation

Le module ajoute un bloc de marquage sous le bouton d'ajout au panier des produits que vous choisissez. Le client saisit ses quantités par taille, coche ses emplacements, choisit une technique et un nombre de couleurs, envoie son fichier et voit le prix calculé en direct. Le détail du marquage suit la commande jusqu'à la facture grâce à la personnalisation native de PrestaShop. Après la commande, un suivi par statut gère l'envoi de fichier, le BAT et la production.

## Installation

1. Dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et envoyez le ZIP `dftextileprint`.
2. Le module crée ses tables, un produit caché `DF-TEXTILE-SETUP` qui porte les frais de mise en place, et un menu **Catalogue > Marquage textile**.
3. Des données de démonstration sont créées : sérigraphie, broderie et flocage avec leurs grilles, et six emplacements (cœur, devant, dos, nuque, deux manches). Modifiez-les ou supprimez-les librement.

Ne supprimez pas le produit `DF-TEXTILE-SETUP`. S'il disparaît, le module le recrée à l'enregistrement des réglages.

## Réglages

Onglet **Réglages** du module :

- **Frais de mise en place dans le panier** : ligne séparée (une par marquage) ou répartis dans le prix par pièce. Le choix s'applique aux nouveaux marquages.
- **Règle de taxe des frais** : taxe appliquée au produit de frais.
- **Groupe d'attributs des tailles** : laissez sur détection automatique si votre groupe s'appelle Taille, Size, Talla, Größe, etc.
- **Taille max. du fichier** et **types acceptés**. La limite réelle est plafonnée par la configuration PHP du serveur (upload_max_filesize, post_max_size) ; une alerte s'affiche si votre réglage la dépasse.
- **Fichier obligatoire** : sans cette option, le client peut commander et envoyer son fichier plus tard.
- **Marquage de texte** : polices proposées et couleurs de texte (une par ligne, au format Nom=#hex).
- **Après la commande** : suivi et BAT dans le compte client, délai de relance automatique, statuts de commande automatiques, email de notification de l'atelier.

## Techniques et grilles de prix

Chaque technique possède :

- une **grille de prix par pièce HT** : une ligne par palier de quantité (« dès 10 », « dès 25 »...) et une colonne par nombre de couleurs ;
- une **quantité minimum** (par exemple 10 pièces pour la sérigraphie) ;
- un **mode de frais de mise en place** : par couleur (écrans de sérigraphie), par visuel (programmation de broderie, fichier de découpe) ou aucun ;
- une **grille de frais** dégressive selon la quantité.

La quantité prise en compte est le total de toutes les tailles et couleurs du produit dans le marquage. Les prix sont saisis HT dans la devise par défaut et convertis automatiquement.

## Emplacements

Un emplacement a un nom, une face (devant ou dos), une position sur l'aperçu, une taille maximale d'impression en millimètres, un éventuel supplément par pièce et la liste des techniques autorisées (aucune cochée signifie toutes). Placez-le à la souris dans l'éditeur : faites glisser le rectangle, et son coin pour le redimensionner.

L'option **Marquage de texte** permet au client de saisir un texte identique sur toutes les pièces ou une ligne par pièce (noms et numéros), à la place d'un fichier ou en plus.

## Produits et catégories

Activez le marquage par règle, sur un produit ou une catégorie. Une règle produit prime sur les règles catégorie, et une règle produit inactive désactive le marquage pour ce produit. Pour chaque règle :

- **Forme du vêtement** : t-shirt, sweat à capuche, tote bag ou casquette ;
- **Marquage obligatoire** : masque le bouton d'ajout au panier natif, le client passe forcément par le bloc de marquage ;
- **Emplacements et techniques proposés** : restreignez la liste si besoin ;
- **Aperçu** : silhouette teintée à la couleur de la déclinaison, ou photos du produit.

### Aperçu sur photos et calage des zones

En mode photos, indiquez la position de la photo de face et celle de la photo de dos dans l'ordre des images du produit (0 pour garder la silhouette au dos). Les images associées à une déclinaison passent en premier, chaque couleur affiche donc sa photo. Placez ensuite chaque zone sur la photo dans l'éditeur ; pour une règle catégorie, choisissez un produit exemple photographié comme les autres.

## Le parcours du client

1. Il saisit ses quantités par taille. Les autres couleurs déjà saisies restent listées dans « Aussi dans cette commande ».
2. Il coche un ou plusieurs emplacements, choisit la technique et le nombre de couleurs, consulte les prix par palier.
3. Il envoie son fichier par bouton ou glisser-déposer, place et redimensionne son logo sur l'aperçu. Un indicateur de résolution signale un fichier trop faible pour la taille d'impression.
4. Le récapitulatif affiche textiles, marquage, frais et total, avec l'incitation au palier suivant. Il peut **télécharger un devis** ou **ajouter au panier**.

Les remises quantité natives du produit et les pièces déjà dans le panier sont prises en compte. Si le même fichier est déjà dans le panier sur un autre produit, au même emplacement avec la même technique et le même nombre de couleurs, le palier se calcule sur le total et les frais de mise en place ne sont comptés qu'une fois.

## Panier, commande et facture

Chaque ligne taille et couleur porte le prix du marquage par pièce et le récapitulatif du marquage. La ligne de frais de mise en place est verrouillée à une unité et ne peut pas être supprimée seule ; elle disparaît avec le marquage. Si une promotion en pourcentage s'applique au produit, le module compense pour que le marquage reste au prix de votre grille.

## Après la commande : fichiers, BAT et statuts

Chaque marquage commandé suit un statut : fichier attendu, fichier reçu, BAT à valider, modifications demandées, BAT validé, en production, terminé.

- **Côté client** : dans le détail de sa commande ou via le lien sécurisé reçu par email (valable aussi pour les invités), il envoie un fichier manquant, ouvre le BAT, le valide ou demande des modifications avec un commentaire, et peut recommander le même marquage en un clic.
- **Côté boutique** : le panneau **Marquage textile** de la page commande affiche la maquette, la répartition par taille, les fichiers, les consignes et l'historique. Vous y envoyez le BAT (image ou PDF) et changez le statut, avec email au client en option.
- **Relances** : un email de rappel part une fois quand un BAT ou un fichier attend depuis le délai choisi. Les relances tournent sur le trafic de la boutique ; vous pouvez aussi appeler l'URL de cron affichée dans les Réglages.
- **Statut de commande** : choisissez le statut PrestaShop à appliquer quand tous les marquages sont en production, puis terminés.

## Onglet Production et fiche atelier

L'onglet **Production** liste tous les marquages commandés, triés par urgence, avec filtres par statut et recherche par commande, client ou produit. Cochez plusieurs lignes pour changer leur statut en une fois ou imprimer leurs fiches. La **fiche atelier** reprend la maquette, la répartition par taille avec cases à cocher, les emplacements, la vignette du fichier, les consignes et la liste des noms. Les listes de noms s'exportent aussi en CSV depuis la commande.

## Dépannage

- **Le bloc n'apparaît pas** : vérifiez qu'une règle active couvre le produit et qu'au moins un emplacement et une technique actifs sont proposés.
- **Les tailles ne sont pas détectées** : choisissez le groupe d'attributs des tailles dans les Réglages.
- **Un envoi de fichier échoue** : comparez la taille du fichier à la limite affichée ; augmentez upload_max_filesize et post_max_size chez votre hébergeur si besoin.
- **Les modifications de templates n'apparaissent pas après une mise à jour** : videz le cache dans **Paramètres avancés > Performances**.
- **Un employé ne peut pas envoyer de BAT** : il lui faut le droit de modification sur les commandes ou sur le module.
