Asistente de Configuración y Panel de Control
Al instalar Order Payment Reminders Pro por primera vez, una lista de verificación de cuatro pasos te guía a través de todo lo que el módulo necesita antes de comenzar a enviar correos electrónicos.
Disponible desde v1.2.0
Descripción General
El panel Module Setup es la primera pantalla que ves al abrir la configuración del módulo. Muestra una barra de progreso y una insignia que indica cuántos de los cuatro pasos requeridos has completado — por ejemplo, "2/4 Steps Complete". Hasta que los cuatro pasos estén finalizados, el módulo permanece inactivo y no envía ningún recordatorio a tus clientes.
Una vez completados todos los pasos, la insignia se vuelve verde y un banner de estado confirma "Module is active and ready to send payment reminders!". A partir de ese momento, el panel permanece accesible como referencia rápida. Puedes volver a abrir cualquier paso en cualquier momento para ajustar la configuración.
El asistente de configuración original (v1.1.0) fue reemplazado por este panel de lista de verificación en la v1.2.0. Si estás actualizando desde una versión anterior a la 1.2.0, el panel aparece automáticamente la próxima vez que abras la configuración del módulo.
Cuándo Usar Esta Pantalla
- Primera instalación: Completa los cuatro pasos antes de programar el cron job. El módulo no enviará correos electrónicos hasta que el Paso 4 (Prueba y Verificación) esté finalizado.
- Después de cambiar el servidor de correo o la configuración SMTP: Repite el Paso 4 para confirmar que los correos electrónicos siguen llegando a tu bandeja de entrada.
- Después de añadir un nuevo método de pago a tu tienda: Vuelve a abrir el Paso 2, marca el nuevo módulo de pago y guarda.
- Después de cambiar el estilo de la plantilla de correo electrónico: Vuelve a abrir el Paso 1, selecciona un preset diferente y guarda.
Configuración
La lista de verificación de configuración no tiene un interruptor de configuración global — ella misma es la configuración. Trabaja en cada paso a continuación.
Paso 1 — Plantilla de Correo Electrónico
Este paso establece el contenedor HTML que rodea cada correo electrónico de recordatorio de pago. Piensa en él como el diseño del sobre — el asunto y el cuerpo de cada mensaje se insertan dentro de él.
Insignia de estado: "Required" (naranja) hasta que se guarda un archivo de plantilla válido; "Configured" (verde) después de guardar.
- Haz clic en el encabezado Step 1: Email Template para desplegarlo.
- Elige una de las cuatro opciones del desplegable Select a pre-designed template or customize your own:
| Opción | Descripción |
|---|---|
| Minimal — Clean and simple | Diseño de tabla simple, sin decoración. Compatible con todos los clientes de correo electrónico. |
| Professional — Business style | Diseño con bordes, barra de encabezado gris y pie de página. Ideal para tiendas formales. |
| Friendly — Warm and personal | Fondo crema, fuente serif, pie de página cálido y personal. |
| Custom — Start from scratch | Abre un editor en blanco para que puedas escribir tu propio HTML. |
- Después de seleccionar un preset, el editor carga el HTML para ese estilo. Revisa y edita colores, fuentes o el diseño según desees.
- La plantilla debe contener
{wr_title}y{wr_message}exactamente como están escritos. Al guardar, aparece una alerta de error si falta alguno de los marcadores. - Haz clic en Save Template. La página se recarga y el Paso 1 muestra la insignia verde "Configured".
{wr_title}se reemplaza en el momento del envío con el asunto de ese recordatorio específico.{wr_message}se reemplaza con el cuerpo que escribes al crear un mensaje en el Paso 3.
Si eliges Custom, el editor se abre vacío. Pega tu propio HTML e incluye ambos marcadores requeridos antes de guardar.
Paso 2 — Módulos de Pago
Este paso indica al módulo qué métodos de pago deben activar los recordatorios. Solo los pedidos realizados con uno de los módulos de pago seleccionados recibirán correos electrónicos.
Insignia de estado: "Required" (naranja) hasta que se guarda al menos un módulo; "Configured" (verde) después de guardar.
- Haz clic en el encabezado Step 2: Payment Modules para desplegarlo.
- Verás una casilla de verificación para cada módulo de pago instalado actualmente en tu tienda.
- Marca cada método de pago cuyos pedidos impagados deban recibir recordatorios. Para la mayoría de las tiendas, esto es el módulo de transferencia bancaria. Si también usas un módulo de pago por factura personalizado, márcalo también.
- Haz clic en Save Payment Modules. La página se recarga y el Paso 2 muestra la insignia verde "Configured".
Puedes seleccionar más de un módulo de pago. Cada mensaje de recordatorio individual que crees posteriormente puede filtrarse para aplicarse a un módulo de pago específico o a todos los seleccionados.
Si un módulo de pago está instalado pero no está marcado aquí, los pedidos de ese módulo se ignorarán por completo — sin recordatorios ni cancelación automática.
Paso 3 — Crear Mensajes
Este paso crea al menos un mensaje de recordatorio. Un mensaje define el momento de envío (cuántos días u horas después del pedido), el asunto, el cuerpo y si el pedido debe cancelarse una vez enviado este mensaje.
Insignia de estado: "Required" (naranja) hasta que exista al menos un mensaje; muestra el recuento de mensajes en verde una vez que se guarda al menos uno.
Tienes dos opciones:
Opción A — Usar una plantilla predefinida
El paso muestra tres categorías de plantillas de mensajes predefinidos:
| Categoría | Propósito |
|---|---|
| Gentle Nudge | Primeros recordatorios amigables, sin presión. |
| Persistent Follow-up | Segundo o tercer recordatorio para pedidos que no han respondido. |
| Urgent / Final | Mensajes de último aviso enviados poco antes de la cancelación automática. |
Selecciona una plantilla del desplegable en cualquier categoría para cargarla automáticamente en el formulario de creación de mensajes.
Opción B — Crear desde cero
Haz clic en Create New Message. Esto te lleva al formulario de mensajes donde estableces el momento de envío, el asunto, el cuerpo y la opción de cancelación para ese recordatorio específico.
Una vez que exista al menos un mensaje, la página se recarga y el Paso 3 muestra la insignia con el recuento de mensajes (por ejemplo, "3 messages").
Puedes añadir más mensajes en cualquier momento después de la configuración. Una secuencia típica son tres mensajes: uno a los 2 días, otro a los 5 días y un aviso final a los 8 días con la cancelación automática activada.
Paso 4 — Probar y Verificar
Este paso envía un correo electrónico real a través del sistema de correo de tu tienda para confirmar que la entrega funciona correctamente. Haces clic en un enlace de verificación dentro de ese correo electrónico y el módulo se marca como verificado y activo.
Insignia de estado: "Locked" (gris) mientras los Pasos 1–3 estén incompletos; "Required" (naranja) una vez completados los Pasos 1–3; "Verified" (verde) después de hacer clic en el enlace del correo electrónico de prueba.
- Completa primero los Pasos 1, 2 y 3 — el Paso 4 está bloqueado hasta que los tres estén finalizados.
- Haz clic en el encabezado Step 4: Test and Verify para desplegarlo.
- En el campo Email address, introduce una dirección de correo electrónico que puedas revisar inmediatamente. El correo electrónico de administrador de tu tienda aparece precargado.
- Haz clic en Send Test Email. El botón se desactiva mientras realiza el envío.
- Revisa tu bandeja de entrada en busca del asunto "Test Email - Order Payment Reminders". Abre el correo electrónico.
- Haz clic en el botón Verify Email Delivery dentro del correo electrónico. Esto te lleva a una página de confirmación en el front-end de tu tienda.
- Vuelve al Back Office y recarga la página de configuración del módulo. El Paso 4 muestra ahora la insignia verde "Verified" y la alerta de estado general indica "Module is active and ready to send payment reminders!".
El enlace de verificación caduca a las 24 horas. Si no haces clic a tiempo, vuelve al Paso 4 y envía un nuevo correo electrónico de prueba para generar un enlace nuevo.
Si el correo electrónico de prueba nunca llega, comprueba la configuración de correo de tu tienda en Advanced Parameters > Email. El módulo utiliza la misma configuración de correo que todos los demás correos electrónicos transaccionales de PrestaShop.
Cómo Funciona
Lógica de Finalización de la Configuración
El módulo verifica las cuatro condiciones en tiempo real. Cada vez que abres la página de configuración, comprueba si el archivo de plantilla existe y contiene ambos marcadores requeridos, si al menos un módulo de pago está guardado, si al menos un mensaje de recordatorio existe en la base de datos y si el indicador de verificación está activado. Los cuatro deben cumplirse antes de que el panel muestre el estado "Module is active".
El panel aparece automáticamente cada vez que alguna de estas condiciones no se cumple — independientemente de si has visitado la configuración anteriormente. Si eliminas todos tus mensajes de recordatorio, por ejemplo, el panel reaparecerá la próxima vez que abras el módulo.
Después de Completar la Configuración
Una vez verificados los cuatro pasos, dos cosas cambian:
- La insignia de progreso en la parte superior muestra "4/4 Steps Complete" con fondo verde.
- La alerta de estado cambia a "Module is active and ready to send payment reminders!".
El panel de Recovery Statistics aparece debajo de la lista de verificación una vez que el módulo ha procesado pedidos. Antes de que haya datos disponibles, el panel muestra un mensaje de marcador de posición. Cuando los datos estadísticos estén disponibles, verás:
| Estadística | Descripción |
|---|---|
| Orders Reminded | Pedidos únicos que recibieron al menos un recordatorio en los últimos 6 meses. |
| Orders Recovered | Pedidos que fueron pagados posteriormente tras recibir un recordatorio. |
| Revenue Recovered | Valor total de esos pedidos recuperados, en la divisa de tu tienda. |
| Recovery Rate | Pedidos Recuperados ÷ Pedidos Recordados × 100. Se muestra en verde por encima del 20%, en naranja por debajo. |
Una tabla con desglose mensual muestra las mismas cifras por mes natural.
Compatibilidad con el Asistente Anterior
Si el indicador wr_first sigue establecido en 1 (tiendas configuradas antes de la v1.2.0 que nunca completaron el asistente antiguo), el módulo continúa mostrando el asistente anterior por compatibilidad con versiones previas. Al hacer clic en Skip Wizard se establece wr_first en 0 y se recarga la página, que luego muestra el panel moderno.
Ejemplos de Uso
Ejemplo: Tienda nueva con pagos por transferencia bancaria
Instala el módulo y abre su configuración. El panel muestra 0/4 Steps Complete. Selecciona la plantilla "Professional" en el Paso 1 y haz clic en Save Template. En el Paso 2, marca Bank Wire (ps_wirepayment) y haz clic en Save Payment Modules. En el Paso 3, selecciona la plantilla "Gentle Nudge" del desplegable para crear tu primer recordatorio a los 3 días. Haz clic en Create New Message y guárdalo. En el Paso 4, introduce tu dirección de correo electrónico y envía el correo de prueba. Haz clic en el enlace de verificación. El panel muestra 4/4 Steps Complete y estás listo para programar el cron job.
Ejemplo: Añadir un segundo método de pago más adelante
Después de añadir un nuevo plugin de pago por factura a tu tienda, observas que no activa los recordatorios. Vuelve a la configuración del módulo — el panel sigue mostrando 4/4 porque tu módulo de pago existente sigue seleccionado. Haz clic en el encabezado del Paso 2, marca el nuevo módulo de pago por factura además de los existentes y haz clic en Save Payment Modules. No es necesario cambiar ningún otro paso.
Ejemplo: Recuperación tras una migración de servidor de correo
Después de migrar a un nuevo servidor de correo, quieres confirmar que los recordatorios siguen entregándose correctamente. Abre la configuración del módulo. Aunque el panel muestre 4/4, haz clic en el encabezado del Paso 4, introduce tu correo electrónico y haz clic en Send Test Email. Haz clic en el nuevo enlace de verificación. El estado verificado se actualiza y puedes tener la certeza de que los correos electrónicos están llegando a los clientes.
Notas Importantes
- Los pasos deben completarse aproximadamente en orden — el Paso 4 está bloqueado y no se puede acceder a él hasta que los Pasos 1–3 muestren verde.
- El panel es por tienda en una configuración multisitio. La configuración de cada tienda debe completarse de forma independiente cuando se utiliza el modo multisitio.
- Eliminar todos los mensajes de recordatorio hace que el panel reaparezca en la siguiente carga de página, ya que el Paso 3 deja de estar satisfecho.
- El indicador
wr_first(el antiguo indicador del asistente) y la clavewr_setup_completecoexisten. En instalaciones nuevas posteriores a la v1.2.0, el panel es el único flujo que verás. En actualizaciones, ambos indicadores pueden estar presentes, pero la lógica del panel tiene prioridad.
Resolución de Problemas
| Problema | Solución |
|---|---|
| El Paso 4 muestra "Locked" aunque terminé los Pasos 1–3 | Recarga la página. Los tres pasos anteriores deben mostrar la insignia verde. Si el Paso 2 sigue mostrando "Required", haz clic en Save Payment Modules de nuevo con al menos un módulo marcado. |
| El correo electrónico de prueba nunca llega | Ve a Advanced Parameters > Email en tu Back Office y envía una prueba desde allí. Si eso también falla, tu configuración SMTP o de hosting está bloqueando el correo saliente. Corrige la configuración de correo antes de volver al Paso 4. |
| Hice clic en el enlace de verificación pero el Paso 4 sigue mostrando "Required" | El enlace puede haber caducado (válido durante 24 horas). Vuelve al Paso 4, envía un nuevo correo electrónico de prueba y haz clic en el enlace nuevo. |
Alerta "Template must contain {wr_title} and {wr_message} placeholders" al guardar | El área de texto de la plantilla no incluye uno o ambos marcadores requeridos. Busca {wr_title} y {wr_message} en el editor y añádelos si no están presentes. |
| Guardé la plantilla pero la insignia sigue mostrando "Required" tras recargar | El archivo de plantilla no se pudo escribir en el disco. Verifica que modules/wiretransferreminder/mails/template/ tenga permisos de escritura para el usuario del servidor web. |
| El enlace de verificación da un error de "página no encontrada" | El enlace utiliza el sistema de URLs amigables de tu tienda. Asegúrate de que .htaccess esté en su lugar y que las URLs amigables del front-office estén activadas en Preferences > SEO and URLs. Si tu tienda está en modo de mantenimiento, desactívalo temporalmente mientras haces clic en el enlace. |
| Las estadísticas de recuperación muestran cero aunque se enviaron recordatorios | Las estadísticas solo cuentan los pedidos en los que el estado de pago cambió a pagado después de que se envió un recordatorio. Los pedidos pagados antes de que se entregara el recordatorio no se contabilizan como recuperaciones. |
Preguntas Frecuentes
¿Puedo cambiar la plantilla de correo electrónico después de completar la configuración?
Sí. Abre la configuración del módulo, haz clic en el encabezado Step 1: Email Template, selecciona un nuevo preset o edita el HTML existente y haz clic en Save Template. El cambio se aplica a todos los correos electrónicos de recordatorio futuros de inmediato y no afecta a los mensajes que ya has creado.
¿Qué ocurre si omito el Paso 4 y activo el cron job de todos modos?
El endpoint del cron no bloquea por el indicador de verificación — intentará enviar recordatorios independientemente. Si todavía no existen mensajes, no se enviará nada. Completa los cuatro pasos antes de programar el cron para evitar enviar correos electrónicos mal configurados.
¿Cambiar la plantilla de correo electrónico afecta a los mensajes que ya he creado?
No. La plantilla es solo el contenedor visual exterior. Los mensajes existentes conservan su propio asunto y cuerpo. Solo cambia el contenedor de diseño que los rodea.
¿Puedo usar un diseño HTML completamente personalizado para la plantilla?
Sí. Elige Custom — Start from scratch del desplegable de plantillas, pega tu propio HTML en el editor y guarda. El único requisito es que tu HTML incluya {wr_title} y {wr_message} en algún lugar del cuerpo.
Seleccioné la plantilla Professional pero quiero cambiar el color del encabezado. ¿Es posible?
Sí. Después de seleccionar Professional del desplegable, el HTML se carga en el editor. Busca el color de fondo en los atributos de estilo y sustitúyelo por cualquier valor de color CSS válido. Guarda de la manera habitual.
¿Cómo puedo restablecer el estado de verificación si algo salió mal durante la configuración inicial?
Abre la configuración del módulo y repite el Paso 4 — haz clic en el encabezado del Paso 4, envía un nuevo correo electrónico de prueba y haz clic en el enlace de verificación nuevo. Cada guardado en cualquier paso sobrescribe el valor anterior, por lo que no es necesario desinstalar y reinstalar el módulo.
El panel sigue reapareciendo aunque completé los cuatro pasos anteriormente.
El módulo verifica las cuatro condiciones en tiempo real cada vez que se carga la página de configuración. La causa más frecuente es que todos los mensajes de recordatorio fueron eliminados (el Paso 3 falla) o que el archivo de plantilla fue eliminado o dañado (el Paso 1 falla). Comprueba la insignia de cada paso para identificar qué condición ya no se cumple.