Liste de Naissance, Mariage & Cadeaux — Guide complet
Installer, configurer et exploiter les listes de naissance, mariage et cadeaux partagées : création client, lien public, réservation au panier, suivi et back-office, pour PrestaShop 8 et 9.
Présentation et prérequis
Le module Liste de Naissance, Mariage & Cadeaux ajoute à votre boutique un système complet de listes de cadeaux partagées. Vos clients créent leur liste depuis leur compte, y ajoutent des produits de votre catalogue et partagent un lien public. Leurs proches réservent les cadeaux, qui sont ajoutés au panier puis confirmés à la validation de la commande. Le propriétaire de la liste est alors notifié par email.
- Compatible PrestaShop 8.0 à 9.x.
- PHP 7.4 à 8.3, MySQL 5.7+ / MariaDB 10.3+.
- Multiboutique et multilingue (FR/EN/ES/DE/IT).
- Architecture ObjectModel et contrôleurs front legacy, sans dépendance Symfony, sans surcharge du cœur.
Le module crée trois tables dédiées (df_giftregistry, df_giftregistry_item, df_giftregistry_reservation) et n’altère aucun fichier du cœur. La désinstallation supprime ces tables, l’onglet d’administration et les réglages.
Installation
- Téléchargez l’archive
dfgiftregistry.zipdepuis votre compte client. - Dans le back-office, allez dans Modules > Gestionnaire de modules.
- Cliquez sur Installer un module et déposez l’archive.
- L’installation crée les tables, enregistre les hooks (
displayCustomerAccount,displayProductAdditionalInfo,actionFrontControllerSetMedia,actionValidateOrder) et ajoute l’onglet d’administration sous Clients.
Une fois installé, le module est immédiatement actif : le bloc de liste apparaît dans l’espace client et le bouton d’ajout sur la fiche produit.
Réglages du module
Cliquez sur Configurer depuis le Gestionnaire de modules pour accéder à la page de réglages :
- Bouton sur la fiche produit : affiche ou masque le bouton « Ajouter à une liste de cadeaux » sur les pages produit.
- Don par les invités : autorise les visiteurs non connectés à offrir un cadeau, en indiquant leur nom et un email facultatif.
- Notification du propriétaire : envoie un email au propriétaire à chaque cadeau confirmé.
- Révélation des noms : affiche le nom du donateur au propriétaire, sauf si le donateur a choisi de rester anonyme.
- Délai de rétention (
DFGR_HOLD_MINUTES, 180 min par défaut) : durée au-delà de laquelle une réservation en attente non finalisée est libérée automatiquement. - Nombre maximum de listes par client (
DFGR_MAX_PER_CUSTOMER, 5 par défaut).
Côté client : créer et gérer une liste
Créer une liste
Depuis son compte, le client ouvre la rubrique des listes de cadeaux et crée une nouvelle liste. Il choisit un type (naissance, mariage, anniversaire, crémaillère, autre), saisit un titre, et peut renseigner une date d’événement, un message d’accueil, une description et une adresse de livraison. La liste est publique par défaut, mais peut être rendue privée.
Ajouter des produits
Deux possibilités :
- Depuis la fiche produit : le client sélectionne une de ses listes, choisit la quantité souhaitée et clique sur « Ajouter ». La déclinaison sélectionnée sur la fiche est prise en compte.
- Depuis l’espace de gestion de la liste : il ajuste la quantité souhaitée et la priorité de chaque produit.
Si un produit est déjà présent dans la liste, l’ajout depuis la fiche produit incrémente simplement la quantité souhaitée.
Partager la liste
Chaque liste dispose d’un lien public unique. Un bouton « Copier » place ce lien dans le presse-papiers, prêt à être envoyé aux proches par email ou messagerie.
Suivre les cadeaux reçus
Dans l’espace de gestion, le propriétaire visualise pour chaque produit une barre de progression réservé / restant, ainsi que la liste des cadeaux reçus, avec le nom du donateur selon le réglage de révélation des noms.
Côté visiteur : offrir un cadeau
En ouvrant le lien public, un proche découvre la liste : type, nom du propriétaire, date de l’événement, message d’accueil et grille des produits. Chaque produit affiche sa progression réservé / restant.
- Le visiteur clique sur Offrir ce cadeau sous le produit choisi.
- Il indique la quantité (plafonnée au restant), un petit mot facultatif, et — s’il n’est pas connecté — son nom et un email facultatif.
- Il peut cocher « Rester anonyme » si le réglage de révélation des noms est activé.
- En validant, le produit est réservé et ajouté à son panier ; il est redirigé vers le panier pour finaliser la commande.
Si le don par les invités est désactivé, seuls les clients connectés peuvent offrir un cadeau.
Le cycle de réservation
Une réservation passe par les états suivants :
- En attente : créée dès que le visiteur clique sur « Offrir ce cadeau » et que le produit est ajouté au panier.
- Confirmée : à la validation de la commande (hook
actionValidateOrder), la réservation liée au panier est confirmée et rattachée à la commande. - Libérée : une réservation en attente non finalisée, liée à un panier abandonné, est supprimée automatiquement après le délai de rétention.
Le restant d’un produit est égal à la quantité souhaitée moins la somme des réservations en attente et confirmées. Lorsqu’un produit est entièrement réservé, il est verrouillé et ne peut plus être offert, ce qui évite les doublons.
Côté marchand : back-office
L’onglet Listes de cadeaux (sous Clients) liste toutes les listes de la boutique : client, type, nombre de produits, nombre de cadeaux, statut actif/inactif et date de création.
La vue détaillée d’une liste affiche :
- les informations de la liste et du client ;
- les produits avec quantités souhaitée, réservée et restante ;
- les réservations avec le donateur, la quantité, le message, le statut et un lien direct vers la commande associée.
Les listes sont créées par les clients : l’action de création n’est pas disponible côté back-office. Le marchand peut consulter et supprimer.
Emails de notification
Lorsque la notification du propriétaire est activée, un email est envoyé au propriétaire de la liste à chaque cadeau confirmé. Il reprend le titre de la liste, le produit offert, la quantité, le nom du donateur (selon le réglage de révélation et le choix d’anonymat) et le message éventuel. Les modèles d’email sont fournis en français et en anglais, et sont personnalisables.
Multilingue et multiboutique
Les libellés du module sont traduisibles via le système de traduction des modules PrestaShop. L’affichage respecte le contexte boutique courant : une liste créée sur une boutique reste rattachée à cette boutique.
FAQ et dépannage
Le bouton « Ajouter à une liste » n’apparaît pas sur la fiche produit
Vérifiez que l’option Bouton sur la fiche produit est activée dans les réglages, et que le hook displayProductAdditionalInfo est bien positionné sur votre thème.
La page publique affiche « liste introuvable »
La liste est peut-être privée, inactive, ou rattachée à une autre boutique. Vérifiez son statut dans l’espace client ou le back-office.
Un produit reste bloqué alors que la commande n’a pas été passée
Il s’agit d’une réservation en attente. Elle est libérée automatiquement après le délai de rétention défini dans les réglages. Vous pouvez réduire ce délai si nécessaire.
Le propriétaire ne reçoit pas d’email
Vérifiez que la notification du propriétaire est activée et que l’envoi d’emails est correctement configuré dans Paramètres avancés > E-mail.
Que se passe-t-il à la désinstallation ?
La désinstallation supprime les trois tables du module, l’onglet d’administration et les réglages. Aucune donnée résiduelle ne subsiste.