Personnalisation Produit (gravure, texte, image) — Guide complet

Présentation

Le module Personnalisation Produit permet à vos clients de personnaliser un article directement depuis la fiche produit : saisie d’un texte / gravure (avec police et couleur) ou upload d’une image. La personnalisation s’affiche en aperçu live sur la photo produit — positionnement par glisser-déposer, taille et rotation réglables — et chaque option peut appliquer une surcharge de prix (montant fixe ou pourcentage) ajoutée automatiquement au panier.

Le module est compatible PrestaShop 8.x et 9.x. Il crée ses propres tables et n’écrase pas les fiches produit existantes : la personnalisation est pilotée par des options que vous créez, ciblées par catégorie et affinables produit par produit.

Installation

1. Zippez le dossier dfcustomizer (ou utilisez directement l’archive dfcustomizer.zip fournie).
2. Depuis le back-office, ouvrez Modules > Gestionnaire de modules.
3. Cliquez sur Installer un module et déposez l’archive ZIP.
4. Une fois l’installation terminée, cliquez sur Configurer pour créer vos options.

À l’installation, le module crée les tables nécessaires (dfc_option et ses tables liées, dfc_product_override, dfc_customization) et enregistre les hooks d’affichage sur la fiche produit, le panier et la commande.

Configuration : créer une option

Rendez-vous dans Modules > dfcustomizer > Configurer pour créer et gérer vos options de personnalisation. Chaque option définit un type de personnalisation, son impact sur le prix et son périmètre d’application.

Type de personnalisation

• Texte / gravure : le client saisit un texte. Vous pouvez proposer un choix de police et de couleur (tous deux optionnels).
• Upload d’image : le client téléverse un fichier au format JPG, PNG ou WEBP.

Impact prix

Chaque option peut ajouter un supplément au prix du produit :

• un montant fixe HT, ou
• un pourcentage du prix produit.

Le supplément s’affiche en temps réel côté client et est répercuté dans le panier (voir la section Panier & prix).

Ciblage par catégorie

Cochez les catégories auxquelles l’option doit s’appliquer : l’option n’apparaîtra que sur les produits de ces catégories. Si aucune catégorie n’est cochée, l’option s’applique à l’ensemble du catalogue.

Override produit

Sur la fiche produit (onglet Modules), chaque produit dispose d’un réglage de surcharge. Il peut :

• hériter des options définies par les catégories (comportement par défaut) ;
• choisir ses propres options spécifiquement pour ce produit ;
• désactiver totalement la personnalisation pour ce produit.

Côté client (front-office)

Sur la fiche produit, le client saisit son texte (police, couleur) ou téléverse son image. La personnalisation s’affiche immédiatement en aperçu live sur la photo produit :

• positionnement par glisser-déposer sur l’image ;
• curseurs de taille et de rotation pour ajuster le rendu.

Le supplément de prix lié aux options choisies s’affiche en direct. À l’ajout au panier, la personnalisation ainsi qu’un aperçu aplati au format PNG sont enregistrés pour être retrouvés en commande.

Panier & prix

Le supplément est ajouté au prix de l’article dans le panier via une règle de prix liée au panier (SpecificPrice rattaché à l’id_cart). Cette surcharge est recalculée à chaque sauvegarde du panier et supprimée automatiquement si le produit est retiré du panier.

Côté commande

Back-office

Sur la page d’une commande, un encart « Personnalisations produit » récapitule chaque personnalisation : le texte saisi, le fichier client téléchargeable et l’aperçu généré. Vous disposez ainsi de tout le nécessaire pour la production (gravure, impression, etc.).

Front-office

Le client retrouve un rappel de ses personnalisations sur le détail de sa commande.

Notes techniques

• Tables créées : dfc_option (+ dfc_option_lang et dfc_option_category), dfc_product_override, dfc_customization.
• Surcharge de prix : appliquée via SpecificPrice lié au panier (id_cart), recalculée à chaque sauvegarde du panier et supprimée si le produit est retiré.
• Fichiers clients : stockés dans modules/dfcustomizer/uploads/, dossier dont l’exécution PHP est bloquée par un fichier .htaccess pour la sécurité.

Dépannage

L’option de personnalisation n’apparaît pas sur la fiche produit

Vérifiez que l’option est bien active et que ses catégories incluent la catégorie du produit (ou qu’aucune catégorie n’est cochée pour viser tout le catalogue). Contrôlez ensuite l’override produit (onglet Modules de la fiche) : la personnalisation ne doit pas être désactivée pour ce produit. Videz enfin le cache de PrestaShop.

Le supplément de prix n’apparaît pas dans le panier

La surcharge est recalculée à la sauvegarde du panier. Vérifiez que l’option a bien un impact prix (montant fixe ou pourcentage) et rechargez le panier. Si le produit a été retiré puis réajouté, la personnalisation doit être refaite.

L’upload d’image est refusé

Seuls les formats JPG, PNG et WEBP sont acceptés. Vérifiez le format du fichier ainsi que la taille maximale d’upload autorisée par votre hébergement (upload_max_filesize / post_max_size PHP).

Désinstallation

La désinstallation retire les hooks et la configuration du module. Pensez à sauvegarder au préalable les fichiers clients présents dans modules/dfcustomizer/uploads/ et les données de personnalisation des commandes si vous souhaitez les conserver.

FAQ

Le module est-il compatible PrestaShop 9 ?

Oui, le module est compatible PrestaShop 8.x et 9.x.

Puis-je facturer la personnalisation ?

Oui. Chaque option peut appliquer un supplément, sous forme de montant fixe HT ou de pourcentage du prix produit, ajouté automatiquement au panier.

Peut-on limiter une option à certains produits ?

Oui, de deux façons : par le ciblage catégorie de l’option, et par l’override produit qui permet à chaque fiche d’hériter, de choisir ses propres options ou de désactiver la personnalisation.

Le client peut-il ajouter plusieurs personnalisations sur un même article ?

Une seule personnalisation est enregistrée par couple produit/déclinaison et par panier.