DF Samples — Commande d’échantillons (PrestaShop 8 & 9)

Présentation

DF Samples ajoute un bouton « Commander un échantillon » sur vos fiches produit. L’échantillon peut être gratuit ou facturé quelques euros. Le module génère automatiquement un produit échantillon caché pour chaque produit inscrit au programme, applique des limites par client, trace la conversion échantillon → achat et relance automatiquement vos clients par email avec un bon de réduction optionnel.

Le module est compatible PrestaShop 8.0 à 9.x, multi-boutique et multi-langues, et n’utilise aucun override du cœur.

Installation

1. Dans le back-office, allez dans Modules > Gestionnaire de modules.
2. Cliquez sur Installer un module et déposez le fichier dfsamples.zip.
3. À l’installation, le module crée ses deux tables, ses réglages par défaut, un jeton de sécurité pour la tâche cron et un onglet d’administration Catalogue > Échantillons (DF).

Le module s’enregistre sur les hooks displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder et actionObjectProductDeleteAfter.

Ajouter un produit au programme d’échantillons

1. Ouvrez Catalogue > Échantillons (DF).
2. Cliquez sur Ajouter.
3. Recherchez un produit par nom ou par référence dans le champ d’autocomplétion, puis sélectionnez-le dans la liste. Les produits déjà inscrits au programme et les produits échantillons eux-mêmes sont automatiquement exclus des résultats.
4. Saisissez le prix de l’échantillon TTC. Saisissez 0,00 pour un échantillon gratuit.
5. Définissez le maximum par client pour ce produit (0 = illimité).
6. Enregistrez.

Ce que fait le module à l’enregistrement

Le module crée automatiquement un produit échantillon caché :

• Nom préfixé et traduit dans vos langues : Échantillon, Sample, Muestra, Muster, Campione.
• Référence dédiée au format SMPL suivi de l’identifiant du produit source.
• Prix HT calculé à partir du prix TTC saisi et du taux de TVA du produit source.
• Image de couverture du produit source recopiée et redimensionnée sur tous les formats.
• Visibilité définie sur « nulle part » : le produit n’apparaît ni en navigation ni en recherche.
• Stock illimité (autorisation de commande en rupture) pour ne jamais bloquer une demande.
• Poids d’échantillon issu du réglage global, utilisé par les transporteurs.

Si vous modifiez ensuite le prix, le poids global ou l’état actif, le produit échantillon est resynchronisé. Si le produit échantillon a été supprimé manuellement du catalogue, il est recréé au prochain enregistrement.

Réglages

Les réglages se trouvent en bas de la page Catalogue > Échantillons (DF), sous la liste des produits.

Réglages généraux

• Position du bouton — sous le bouton d’ajout au panier (displayProductActions) ou dans le bloc d’informations complémentaires (displayProductAdditionalInfo). Changez ce réglage si votre thème ne rend pas le premier hook.
• Prix d’échantillon par défaut TTC — valeur pré-remplie à la création d’un nouvel échantillon.
• Poids d’échantillon — en kilogrammes, appliqué à tous les produits échantillons générés. Utilisé pour le calcul des frais de port.
• Compte client obligatoire — recommandé et activé par défaut. Les limites par client ne peuvent être appliquées de manière fiable que sur des clients identifiés.
• Conversion comptabilisée sur — l’achat du produit échantillonné uniquement, ou n’importe quel achat ultérieur.

Limites

• Maximum d’échantillons par panier — 0 pour illimité.
• Maximum d’échantillons par client et par fenêtre — tous produits échantillons confondus. 0 pour illimité.
• Fenêtre glissante — en jours, 30 par défaut. Les compteurs par client portent sur cette période glissante.

Un même échantillon ne peut jamais être ajouté deux fois dans un même panier, quelle que soit la configuration.

Relance automatique

• Activer les emails de relance.
• Délai après la commande d’échantillon — en jours, 14 par défaut.
• Inclure un bon de réduction — un bon nominatif, à usage unique, est généré pour chaque relance.
• Montant du bon — en pourcentage, 10 par défaut.
• Validité du bon — en jours, 30 par défaut.

L’URL de la tâche cron, sécurisée par un jeton, est affichée dans cette section ainsi que dans le panneau de statistiques.

Configurer la tâche cron

Les relances sont envoyées par une tâche cron. Planifiez l’URL affichée dans les réglages toutes les heures. Exemple de crontab :

0 * * * * wget -q -O /dev/null "https://votre-boutique.com/module/dfsamples/cron?token=VOTRE_JETON"

Chaque exécution traite jusqu’à cinquante relances en attente et renvoie un résumé JSON : nombre d’enregistrements traités, envoyés, ignorés et en attente.

Règles appliquées par la tâche cron

• Seuls les échantillons non encore convertis et non encore relancés sont considérés.
• La commande d’échantillon doit avoir atteint un statut payé, expédié ou livré.
• Les commandes annulées ou en erreur de paiement sont définitivement ignorées.
• Les commandes en attente de règlement sont repoussées à l’exécution suivante.

Suivi de conversion

À la validation de chaque commande, le module enregistre les lignes d’échantillon : client, email, produit source, langue et boutique.

Lorsque ce même client passe une commande ultérieure, le module marque comme convertis les échantillons correspondants :

• En mode produit (par défaut) : uniquement si la commande contient le produit dont l’échantillon a été reçu.
• En mode tout achat : dès que la commande contient un produit réel, quel qu’il soit.

La commande courante est exclue du calcul : commander un échantillon et son produit dans le même panier ne compte pas comme une conversion.

Tableau de bord

Le panneau affiché au-dessus de la liste des produits présente :

• Échantillons commandés — nombre total de lignes d’échantillon enregistrées.
• Conversions — nombre d’échantillons suivis d’un achat, et taux de conversion associé.
• Chiffre d’affaires des conversions — somme du montant TTC des commandes de conversion.
• Relances en attente — nombre d’échantillons éligibles à une relance non encore envoyée.

La liste des produits affiche également, par produit, le nombre d’échantillons commandés et le nombre de conversions.

Emails de relance

Les modèles se trouvent dans le dossier mails du module, en cinq langues : fr, en, es, de, it. Chaque langue dispose d’une version HTML et d’une version texte du modèle dfsamples_followup.

Variables disponibles : firstname, lastname, product_name, product_link, voucher_block et shop_name. Le bloc voucher_block contient le bon de réduction mis en forme, ou une chaîne vide si le bon est désactivé.

Vous pouvez personnaliser librement ces modèles. Conservez les variables entre accolades pour que le remplacement fonctionne.

Bons de réduction

Lorsque l’option est activée, chaque relance génère une règle panier PrestaShop :

• Code au format SMPL suivi de huit caractères aléatoires.
• Restreint au client destinataire.
• Utilisable une seule fois.
• Réduction en pourcentage, sur le montant TTC.
• Durée de validité configurable.

Les bons générés sont visibles dans Promotions > Règles panier.

Désinstallation

À la désinstallation, le module supprime ses deux tables, ses réglages et son onglet d’administration. Les produits échantillons générés sont désactivés et non supprimés, afin que l’historique de vos commandes passées reste cohérent. Vous pouvez les supprimer manuellement depuis le catalogue si vous le souhaitez.

Dépannage

Le bouton n’apparaît pas sur la fiche produit

Vérifiez que le produit est bien inscrit au programme et actif dans Catalogue > Échantillons (DF). Si le produit est bien actif, changez le réglage « Position du bouton » : certains thèmes ne rendent pas le hook displayProductActions.

Les relances ne partent pas

Vérifiez que la tâche cron est bien planifiée et que l’URL contient le bon jeton. Appelez l’URL manuellement dans un navigateur : le module renvoie un résumé JSON. Vérifiez aussi que l’option de relance est activée et que le délai configuré est bien écoulé depuis les commandes d’échantillon.

Le prix de l’échantillon n’est pas celui attendu

Le prix se saisit TTC et est converti en HT selon la TVA du produit source. Si le produit source n’a pas de règle de taxe, le prix HT est égal au prix saisi.

Un client dépasse ses limites

Les limites par client ne s’appliquent qu’aux clients identifiés. Activez le réglage « Compte client obligatoire » pour les rendre effectives.