DF Samples — Pedido de muestras (PrestaShop 8 y 9)

Presentación

DF Samples añade un botón «Pedir una muestra» a sus fichas de producto. La muestra puede ser gratuita o costar unos euros. El módulo genera automáticamente un producto muestra oculto para cada producto inscrito en el programa, aplica límites por cliente, registra la conversión muestra → compra y contacta automáticamente a sus clientes por email con un vale de descuento opcional.

El módulo es compatible con PrestaShop 8.0 a 9.x, multitienda y multiidioma, y no utiliza ninguna sobrescritura del núcleo.

Instalación

1. En el back-office, vaya a Módulos > Gestor de módulos.
2. Haga clic en Subir un módulo y suelte el archivo dfsamples.zip.
3. Al instalarse, el módulo crea sus dos tablas, sus ajustes predeterminados, un token de seguridad para la tarea cron y una pestaña de administración en Catálogo > Muestras (DF).

El módulo se registra en los hooks displayProductActions, displayProductAdditionalInfo, actionFrontControllerSetMedia, actionValidateOrder y actionObjectProductDeleteAfter.

Añadir un producto al programa de muestras

1. Abra Catálogo > Muestras (DF).
2. Haga clic en Añadir.
3. Busque un producto por nombre o referencia en el campo de autocompletado y selecciónelo de la lista. Los productos ya inscritos en el programa y los propios productos muestra quedan excluidos automáticamente de los resultados.
4. Introduzca el precio de la muestra con impuestos. Introduzca 0,00 para una muestra gratuita.
5. Defina el máximo por cliente para este producto (0 = ilimitado).
6. Guarde.

Qué hace el módulo al guardar

El módulo crea automáticamente un producto muestra oculto:

• Nombre prefijado y traducido a sus idiomas: Échantillon, Sample, Muestra, Muster, Campione.
• Referencia dedicada en formato SMPL seguido del identificador del producto de origen.
• Precio sin impuestos calculado a partir del precio con impuestos introducido y del tipo de IVA del producto de origen.
• Imagen de portada del producto de origen copiada y redimensionada en todos los formatos.
• Visibilidad definida en «en ninguna parte»: el producto no aparece ni en la navegación ni en la búsqueda.
• Stock ilimitado (se permiten pedidos sin existencias) para no bloquear nunca una solicitud.
• Peso de muestra tomado del ajuste global, utilizado por los transportistas.

Si modifica después el precio, el peso global o el estado activo, el producto muestra se resincroniza. Si el producto muestra se eliminó manualmente del catálogo, se recrea al guardar de nuevo.

Ajustes

Los ajustes se encuentran al final de la página Catálogo > Muestras (DF), bajo la lista de productos.

Ajustes generales

• Posición del botón — bajo el botón de añadir al carrito (displayProductActions) o en el bloque de información adicional (displayProductAdditionalInfo). Cambie este ajuste si su tema no renderiza el primer hook.
• Precio de muestra predeterminado con impuestos — valor precargado al crear una muestra nueva.
• Peso de muestra — en kilogramos, aplicado a todos los productos muestra generados. Se utiliza para el cálculo de los gastos de envío.
• Cuenta de cliente obligatoria — recomendado y activado por defecto. Los límites por cliente solo pueden aplicarse de forma fiable a clientes identificados.
• Conversión contabilizada en — únicamente la compra del producto muestreado, o cualquier compra posterior.

Límites

• Máximo de muestras por carrito — 0 para ilimitado.
• Máximo de muestras por cliente y por ventana — todos los productos muestra juntos. 0 para ilimitado.
• Ventana deslizante — en días, 30 por defecto. Los contadores por cliente se aplican a este periodo deslizante.

Una misma muestra nunca puede añadirse dos veces al mismo carrito, sea cual sea la configuración.

Seguimiento automático

• Activar los emails de seguimiento.
• Plazo tras el pedido de muestra — en días, 14 por defecto.
• Incluir un vale de descuento — se genera un vale nominativo, de un solo uso, para cada seguimiento.
• Importe del vale — en porcentaje, 10 por defecto.
• Validez del vale — en días, 30 por defecto.

La URL de la tarea cron, protegida por un token, se muestra en esta sección y también en el panel de estadísticas.

Configurar la tarea cron

Los seguimientos los envía una tarea cron. Programe la URL mostrada en los ajustes cada hora. Ejemplo de crontab:

0 * * * * wget -q -O /dev/null "https://su-tienda.com/module/dfsamples/cron?token=SU_TOKEN"

Cada ejecución procesa hasta cincuenta seguimientos pendientes y devuelve un resumen JSON: número de registros procesados, enviados, ignorados y en espera.

Reglas aplicadas por la tarea cron

• Solo se consideran las muestras que aún no han convertido y para las que aún no se ha enviado un seguimiento.
• El pedido de muestra debe haber alcanzado un estado pagado, enviado o entregado.
• Los pedidos cancelados o con error de pago se ignoran definitivamente.
• Los pedidos pendientes de pago se aplazan a la siguiente ejecución.

Seguimiento de conversión

Al validar cada pedido, el módulo registra las líneas de muestra: cliente, email, producto de origen, idioma y tienda.

Cuando ese mismo cliente realiza un pedido posterior, el módulo marca como convertidas las muestras correspondientes:

• En modo producto (por defecto): únicamente si el pedido contiene el producto cuya muestra se recibió.
• En modo cualquier compra: en cuanto el pedido contiene un producto real, sea cual sea.

El pedido actual queda excluido del cálculo: pedir una muestra y su producto en el mismo carrito no cuenta como conversión.

Panel de control

El panel mostrado encima de la lista de productos presenta:

• Muestras pedidas — número total de líneas de muestra registradas.
• Conversiones — número de muestras seguidas de una compra, y la tasa de conversión asociada.
• Facturación de las conversiones — suma del importe con impuestos de los pedidos de conversión.
• Seguimientos pendientes — número de muestras que cumplen los requisitos para un seguimiento aún no enviado.

La lista de productos muestra también, por producto, el número de muestras pedidas y el número de conversiones.

Emails de seguimiento

Las plantillas se encuentran en la carpeta mails del módulo, en cinco idiomas: fr, en, es, de, it. Cada idioma dispone de una versión HTML y una versión de texto de la plantilla dfsamples_followup.

Variables disponibles: firstname, lastname, product_name, product_link, voucher_block y shop_name. El bloque voucher_block contiene el vale de descuento con formato, o una cadena vacía si el vale está desactivado.

Puede personalizar libremente estas plantillas. Conserve las variables entre llaves para que la sustitución funcione.

Vales de descuento

Cuando la opción está activada, cada seguimiento genera una regla de carrito de PrestaShop:

• Código en formato SMPL seguido de ocho caracteres aleatorios.
• Restringido al cliente destinatario.
• Utilizable una sola vez.
• Descuento en porcentaje, sobre el importe con impuestos.
• Periodo de validez configurable.

Los vales generados son visibles en Descuentos > Reglas de carrito.

Desinstalación

Al desinstalar, el módulo elimina sus dos tablas, sus ajustes y su pestaña de administración. Los productos muestra generados se desactivan, no se eliminan, para que el historial de sus pedidos anteriores siga siendo coherente. Puede eliminarlos manualmente desde el catálogo si lo desea.

Resolución de problemas

El botón no aparece en la ficha de producto

Compruebe que el producto está inscrito en el programa y activo en Catálogo > Muestras (DF). Si el producto está efectivamente activo, cambie el ajuste «Posición del botón»: algunos temas no renderizan el hook displayProductActions.

Los seguimientos no se envían

Compruebe que la tarea cron está programada y que la URL contiene el token correcto. Llame a la URL manualmente en un navegador: el módulo devuelve un resumen JSON. Compruebe también que la opción de seguimiento está activada y que el plazo configurado ha transcurrido realmente desde los pedidos de muestra.

El precio de la muestra no es el esperado

El precio se introduce con impuestos y se convierte sin impuestos según el IVA del producto de origen. Si el producto de origen no tiene regla de impuestos, el precio sin impuestos es igual al precio introducido.

Un cliente supera sus límites

Los límites por cliente solo se aplican a clientes identificados. Active el ajuste «Cuenta de cliente obligatoria» para hacerlos efectivos.