Lista de Nacimiento, Boda y Regalos — Guía completa
Instalar, configurar y explotar las listas de nacimiento, boda y regalos compartidas: creación cliente, enlace público, reserva al carrito, seguimiento y back-office, para PrestaShop 8 y 9.
Presentación y requisitos
El módulo Lista de Nacimiento, Boda y Regalos añade a tu tienda un sistema completo de listas de regalos compartidas. Tus clientes crean su lista desde su cuenta, añaden productos de tu catálogo y comparten un enlace público. Sus allegados reservan los regalos, que se añaden al carrito y luego se confirman al validar el pedido. El propietario de la lista recibe entonces una notificación por email.
- Compatible con PrestaShop 8.0 a 9.x.
- PHP 7.4 a 8.3, MySQL 5.7+ / MariaDB 10.3+.
- Multitienda y multilingüe (FR/EN/ES/DE/IT).
- Arquitectura ObjectModel y controladores front legacy, sin dependencia de Symfony, sin override del núcleo.
El módulo crea tres tablas dedicadas (df_giftregistry, df_giftregistry_item, df_giftregistry_reservation) y no altera ningún archivo del núcleo. La desinstalación elimina esas tablas, la pestaña de administración y los ajustes.
Instalación
- Descarga el archivo
dfgiftregistry.zipdesde tu cuenta de cliente. - En el back-office, ve a Módulos > Gestor de módulos.
- Haz clic en Subir un módulo y suelta el archivo.
- La instalación crea las tablas, registra los hooks (
displayCustomerAccount,displayProductAdditionalInfo,actionFrontControllerSetMedia,actionValidateOrder) y añade la pestaña de administración en Clientes.
Una vez instalado, el módulo está inmediatamente activo: el bloque de listas aparece en la cuenta del cliente y el botón de añadir en la ficha de producto.
Ajustes del módulo
Haz clic en Configurar desde el Gestor de módulos para acceder a la página de ajustes:
- Botón en la ficha de producto: muestra u oculta el botón «Añadir a una lista de regalos» en las páginas de producto.
- Regalo de invitados: permite a los visitantes no conectados ofrecer un regalo indicando su nombre y un email opcional.
- Notificación al propietario: envía un email al propietario por cada regalo confirmado.
- Revelación de nombres: muestra el nombre del donante al propietario, salvo que el donante haya elegido permanecer anónimo.
- Plazo de retención (
DFGR_HOLD_MINUTES, 180 min por defecto): tiempo tras el cual una reserva pendiente no finalizada se libera automáticamente. - Número máximo de listas por cliente (
DFGR_MAX_PER_CUSTOMER, 5 por defecto).
Lado cliente: crear y gestionar una lista
Crear una lista
Desde su cuenta, el cliente abre la sección de listas de regalos y crea una nueva lista. Elige un tipo (nacimiento, boda, cumpleaños, inauguración de casa, otra), introduce un título, y puede indicar una fecha de evento, un mensaje de bienvenida, una descripción y una dirección de entrega. La lista es pública por defecto, pero puede hacerse privada.
Añadir productos
Dos opciones:
- Desde la ficha de producto: el cliente selecciona una de sus listas, elige la cantidad deseada y hace clic en «Añadir». Se tiene en cuenta la combinación seleccionada en la ficha.
- Desde el área de gestión de la lista: ajusta la cantidad deseada y la prioridad de cada producto.
Si un producto ya está en la lista, añadirlo desde la ficha de producto simplemente incrementa la cantidad deseada.
Compartir la lista
Cada lista dispone de un enlace público único. Un botón «Copiar» coloca este enlace en el portapapeles, listo para enviarse a los allegados por email o mensajería.
Seguir los regalos recibidos
En el área de gestión, el propietario visualiza para cada producto una barra de progreso reservado / restante, así como la lista de los regalos recibidos, con el nombre del donante según el ajuste de revelación de nombres.
Lado visitante: ofrecer un regalo
Al abrir el enlace público, un allegado descubre la lista: tipo, nombre del propietario, fecha del evento, mensaje de bienvenida y cuadrícula de productos. Cada producto muestra su progreso reservado / restante.
- El visitante hace clic en Ofrecer este regalo bajo el producto elegido.
- Indica la cantidad (limitada al restante), un breve mensaje opcional, y — si no está conectado — su nombre y un email opcional.
- Puede marcar «Permanecer anónimo» si el ajuste de revelación de nombres está activado.
- Al validar, el producto se reserva y se añade a su carrito; es redirigido al carrito para finalizar el pedido.
Si el regalo de invitados está desactivado, solo los clientes conectados pueden ofrecer un regalo.
El ciclo de reserva
Una reserva pasa por los siguientes estados:
- Pendiente: creada en cuanto el visitante hace clic en «Ofrecer este regalo» y el producto se añade al carrito.
- Confirmada: al validar el pedido (hook
actionValidateOrder), la reserva vinculada al carrito se confirma y se asocia al pedido. - Liberada: una reserva pendiente no finalizada, vinculada a un carrito abandonado, se elimina automáticamente tras el plazo de retención.
El restante de un producto es igual a la cantidad deseada menos la suma de las reservas pendientes y confirmadas. Cuando un producto está totalmente reservado, se bloquea y ya no puede ofrecerse, lo que evita los duplicados.
Lado comerciante: back-office
La pestaña Listas de regalos (en Clientes) enumera todas las listas de la tienda: cliente, tipo, número de productos, número de regalos, estado activo/inactivo y fecha de creación.
La vista detallada de una lista muestra:
- la información de la lista y del cliente;
- los productos con cantidades deseada, reservada y restante;
- las reservas con el donante, la cantidad, el mensaje, el estado y un enlace directo al pedido asociado.
Las listas son creadas por los clientes: la acción de creación no está disponible en el back-office. El comerciante puede consultar y eliminar.
Emails de notificación
Cuando la notificación al propietario está activada, se envía un email al propietario de la lista por cada regalo confirmado. Incluye el título de la lista, el producto ofrecido, la cantidad, el nombre del donante (según el ajuste de revelación y la elección de anonimato) y el mensaje eventual. Las plantillas de email se proporcionan en francés e inglés, y son personalizables.
Multilingüe y multitienda
Las etiquetas del módulo son traducibles mediante el sistema de traducción de los módulos PrestaShop. La visualización respeta el contexto de tienda actual: una lista creada en una tienda permanece asociada a esa tienda.
FAQ y resolución de problemas
El botón «Añadir a una lista» no aparece en la ficha de producto
Comprueba que la opción Botón en la ficha de producto está activada en los ajustes, y que el hook displayProductAdditionalInfo está bien posicionado en tu tema.
La página pública muestra «lista no encontrada»
La lista puede ser privada, inactiva, o estar asociada a otra tienda. Comprueba su estado en la cuenta de cliente o en el back-office.
Un producto permanece bloqueado aunque no se haya realizado el pedido
Se trata de una reserva pendiente. Se libera automáticamente tras el plazo de retención definido en los ajustes. Puedes reducir este plazo si es necesario.
El propietario no recibe ningún email
Comprueba que la notificación al propietario está activada y que el envío de emails está correctamente configurado en Parámetros avanzados > E-mail.
¿Qué ocurre al desinstalar?
La desinstalación elimina las tres tablas del módulo, la pestaña de administración y los ajustes. No queda ningún dato residual.