
Chez un vélociste, le chèque cadeau couvre un besoin concret : le proche qui veut offrir un vélo, des équipements ou un entretien sans choisir à la place du destinataire (taille, géométrie, usage). À l’approche de Noël et de la fête des pères, c’est l’un des leviers de panier moyen les plus efficaces — à condition de pouvoir le vendre en ligne sans friction.
Le module Veloland — Chèque Cadeau transforme cette mécanique commerciale en quelques minutes de configuration.
Côté client : l’expérience d’achat

L’acheteur arrive sur une page dédiée, choisit :
- Un template visuel parmi plusieurs (route, gravel, ville, enfant, atelier — modulable)
- Un montant libre ou prédéfini (50 €, 100 €, 200 €, 500 €…)
- Le destinataire (nom + email optionnel) et un message personnalisé
Une fois la commande payée, le système :
- Génère un PDF A5 portrait haute résolution (300 dpi, 1748×2480 px) avec le template choisi, le montant, le message
- Crée un code KDO unique valable en magasin et en ligne
- Pousse une règle panier PrestaShop liée à ce code, prête à l’emploi
- Envoie le PDF au client par email — il l’imprime ou le transfère au destinataire
Aucun email reçu par le destinataire avant le geste de l’offrant : le cadeau reste une surprise.
Côté technique
Le module s’appuie sur PrestaShop 9 et utilise la bibliothèque TCPDF, déjà fournie par le core, pour générer le fichier PDF. Le rendu est calibré sur un A5 portrait de 148 par 210 millimètres en orientation P à 300 dpi, ce qui garantit une impression nette sans pixellisation visible. Les modèles graphiques sont stockés en HTML et CSS dans le dossier views/templates/pdf/ du module, ce qui permet à un graphiste de les retoucher sans avoir à toucher au code PHP.
À la validation de la commande, le hook actionValidateOrder orchestre trois opérations successives. Il génère d’abord un code KDO de douze caractères numériques via Tools::passwdGen(12, 'NUMERIC'), puis vérifie son unicité grâce à un index posé sur la colonne kdo_code. Il crée ensuite dynamiquement une règle panier PrestaShop liée à ce code, configurée pour appliquer un montant fixe en remise avec une seule utilisation possible, restreinte au pays, à la devise et à la boutique en cours. Il envoie enfin le PDF au client par email via le moteur de mails natif (Mail::send()), accompagné d’un template HTML responsive qui présente le document en aperçu cliquable.
Pourquoi c’est pertinent pour un vélociste
Vendre un vélo c’est vendre un produit personnel : taille, géométrie, usage, budget. L’offrant n’a souvent pas ces infos, et imposer un modèle = risque de retour ou de cadeau qui finit au garage. Le chèque cadeau lève ce blocage : l’offrant choisit le montant, le destinataire choisit le vélo. Combiné à un guide des tailles en magasin et à un essai possible, c’est un parcours d’achat fluide même pour un cadeau à 1500 €.
Pour Veloland Lorient, ce module a permis de proposer en ligne ce qui existait déjà en magasin papier — sans démultiplier le travail de l’équipe.

