Extensions d'impression et personnalisation pour vos produits

Catégorie : Produits  ·  Plan min. : Pro  ·  Section : Outils de gestion

L'outil Extensions d'impression et personnalisation ajoute à la page produit des champs que le client remplit avant de commander : un texte court pour le nom à imprimer, un texte long pour un message cadeau, ou un envoi d'image pour la photo à imprimer. Un champ peut porter un prix supplémentaire en DA, et chaque réponse, image comprise, vous arrive sur la page de la commande. Une imprimerie ou un vendeur de cadeaux personnalisés reçoit ainsi la commande complète en une seule étape, sans rappeler le client pour lui demander la photo.

Tutoriel vidéo

Ce que vous pouvez demander au client

Chaque produit a sa propre liste de champs, et chaque champ est de l'un des trois types suivants :

Type de champ	Ce que voit le client	Réglages
Texte court (une ligne)	Une case d'une ligne, par exemple pour le nom à imprimer sur un mug	Texte indicatif, nombre maximum de caractères, prix supplémentaire, obligatoire
Texte long (multi-lignes)	Une case de trois lignes, par exemple pour le message d'une carte cadeau	Texte indicatif, nombre maximum de caractères, prix supplémentaire, obligatoire
Téléchargement d'image	Une zone d'envoi où le client choisit une photo et en voit l'aperçu, avec un bouton pour la retirer	Prix supplémentaire, obligatoire

• Texte indicatif (optionnel) s'affiche dans la case vide comme guide, par exemple « Écrivez le nom à imprimer ».
• Nombre maximum de caractères arrête la case à cette longueur. Laissez-le vide pour ne pas limiter.
• Prix supplémentaire (optionnel) en DA s'affiche à côté du titre du champ sur la page produit, par exemple +200 DA.
• Champ obligatoire ajoute une étoile au titre, et le client ne peut pas commander tant que le champ est vide.

L'envoi d'image accepte les fichiers JPG, PNG, GIF et WEBP jusqu'à 5 MB. Le fichier est conservé tel que le client l'a envoyé, sans compression ni changement de format : vous imprimez l'original.

Comment le configurer

1. Ouvrez Tableau de bord → Extensions. Dans la section Outils de gestion, cliquez sur Gérer les extensions sur la carte Extensions d'impression et personnalisation.
2. La page liste vos produits actifs. Chaque carte affiche le nombre de champs et un badge Activé ou Désactivé.
3. Sur le produit voulu, cliquez sur Gérer les extensions, puis sur Ajouter un nouveau champ.
4. Saisissez le Titre du champ, c'est-à-dire la question que lit le client, choisissez le Type de champ, réglez les options utiles et cliquez sur Enregistrer.
5. De retour sur la carte du produit, cliquez sur le bouton interrupteur à côté de Gérer les extensions. Le badge passe à Activé et les champs apparaissent sur votre boutique.

Chaque produit démarre avec ses champs désactivés : le client ne voit rien tant que vous n'activez pas le produit. Vous pouvez préparer les champs d'abord, et le même interrupteur les masque à nouveau sans rien supprimer.

Dans la liste des champs d'un produit, faites glisser la poignée au début d'une ligne pour changer l'ordre ; la page produit affiche les champs dans cet ordre. Le bouton crayon modifie un champ et le bouton corbeille le supprime après confirmation.

Ce que voit le client

Sur la page produit, les champs sont regroupés dans un bloc intitulé Options de personnalisation, chacun avec son titre, une étoile s'il est obligatoire et son prix supplémentaire. Le prix affiché sur la page augmente dès que le client remplit un champ payant, et redescend s'il le vide.

Sur la liste des produits et sur les pages de catégorie, le bouton d'ajout au panier d'un produit dont les champs sont activés ouvre sa page produit, pour que le client remplisse les champs avant que le produit n'arrive au panier. Les réponses restent liées au produit, que le client commande par le panier ou directement depuis la page produit.

Comment le prix supplémentaire est compté

Un prix supplémentaire n'est facturé que si le client remplit ce champ. Un champ optionnel laissé vide n'ajoute rien.

Le prix supplémentaire s'ajoute au prix d'une pièce : un client qui commande 2 mugs avec un nom payant paie ce prix deux fois. Quand le client choisit une offre de quantité, il est ajouté une seule fois au prix de l'offre.

Le montant vient toujours du champ tel que vous l'avez enregistré, jamais de ce qu'affichait la page du client.

Où lire les réponses

Ouvrez la commande depuis Commandes. Sous chaque ligne de produit, la page de la commande liste chaque titre de champ avec la réponse du client : le texte tel qu'il l'a saisi, ou une miniature de l'image. Cliquez sur la miniature pour récupérer le fichier image d'origine. Un champ payant affiche aussi son prix supplémentaire entre parenthèses, par exemple (+200 DA).

Ce que ça coûte

L'outil Extensions d'impression et personnalisation n'a pas de frais propres : il fait partie des plans Pro, Unlimited et Enterprise. Avec le plan Gratuit, la carte affiche un badge PRO et un bouton Passer à Pro qui ouvre la page d'abonnement. Voir le plan Pro.

Les prix supplémentaires que vous fixez font partie du total de la commande, payé par le client comme le produit lui-même.

Pour les développeurs

Les champs se lisent et se remplacent aussi via l'API DZBuild. Une clé API personnelle créée dans Tableau de bord → Paramètres → API demande un plan Enterprise actif et porte par défaut les deux portées ci-dessous ; les apps suivent leurs propres règles d'accès.

Endpoint	Portée	Ce qu'il fait
GET /v1/products/{id}/addons	products:read	Renvoie les champs du produit et leur interrupteur, enabled
POST /v1/products/{id}/addons	products:write	Remplace tous les champs du produit par la liste envoyée (20 au plus) et peut régler enabled

Ajoutez un nom obligatoire à 200 DA au produit 42 et activez ses champs :

curl -X POST https://api.dzbuild.app/v1/products/42/addons \
  -H "Authorization: Bearer $DZBUILD_API_KEY" \
  -H "Idempotency-Key: product-42-addons-1" \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "addons": [{"title": "Name to print", "input_type": "text", "max_length": 20, "extra_price": 200, "is_required": true}]}'

Chaque POST exige un en-tête Idempotency-Key, et envoyer "addons": [] supprime tous les champs. La page Produits de l'API liste tous les champs, avec des exemples de réponses et les codes d'erreur.

FAQ

Un produit peut-il avoir plusieurs champs ? Oui. Combinez-les selon vos besoins, par exemple un envoi d'image pour la photo et un texte court pour le nom sur le même mug. La page produit les affiche dans l'ordre que vous avez fixé.

Les champs s'affichent-ils sur mes landing pages ? Non. Ils s'affichent uniquement sur la page produit de votre boutique. Une commande passée depuis une landing page ne les recueille pas.

J'ai modifié ou supprimé un champ. Que deviennent les commandes passées ? Rien ne change pour elles. Chaque commande garde le titre du champ, la réponse et le prix supplémentaire tels qu'ils étaient au moment de la commande.

Le client peut-il envoyer un PDF ou un autre type de fichier ? Non. L'envoi accepte uniquement des images : JPG, PNG, GIF et WEBP, jusqu'à 5 MB.