Modo de Prueba
El modo de prueba te permite ejecutar toda la secuencia de recordatorios contra pedidos pendientes reales sin afectar a tus clientes ni a los datos en producción.
Disponible desde la v1.0.3
Todos los emails se envían a una única dirección que tú controlas, los pedidos nunca se cancelan, y el contador de estado de envío se congela intencionalmente para que puedas repetir la misma prueba tantas veces como necesites.
Descripción General
Cuando instalas Order Payment Reminders Pro por primera vez, el modo de prueba está activado por defecto. Esto es intencionado: el módulo está listo para procesar pedidos, pero nada llega a tus clientes hasta que revises cada paso y cambies explícitamente al modo de producción.
Mientras el modo de prueba está activo, el cron procesa los pedidos exactamente igual que en producción — evalúa los horarios, construye el contenido del email y aplica todas tus variables personalizadas — pero con tres diferencias clave:
- Todos los emails de recordatorio salientes se redirigen a tu dirección de prueba configurada en lugar de a la dirección del cliente.
- Los pedidos que de otro modo serían cancelados (por las reglas de cancelación automática) no se cancelan. La ejecución del cron registra lo que habría hecho, pero no toma ninguna acción.
- El registro de "último mensaje enviado" para cada pedido no se actualiza. Esto significa que el mismo mensaje de recordatorio se enviará en cada ejecución del cron durante las pruebas, para que puedas inspeccionar cada mensaje varias veces sin necesitar nuevos pedidos sin pagar.
El email de resumen de administración (el resumen diario de pedidos próximos a la cancelación) es un informe interno dirigido a ti, no a los clientes. Siempre se envía a la dirección de destinatario del resumen que hayas configurado, independientemente de si el modo de prueba está activado o no.
Configuración
Activar el modo de prueba y configurar tu dirección de prueba
- Ve a Módulos > Gestor de módulos, busca Order Payment Reminders Pro y haz clic en Configurar.
- Desplázate hasta la sección Modo de Prueba (o haz clic en la tarjeta Modo de Prueba desde la vista general).
- Confirma que Activar Modo de Prueba está en Sí. Este es el valor predeterminado tras la instalación.
- Introduce tu propia dirección de email en Dirección de Email de Prueba. Todos los emails de recordatorio se entregarán aquí en lugar de a los clientes. El campo tiene por defecto el email de administración de tu tienda.
- Elige un modo de Salida de Prueba:
- Email (predeterminado) — la ejecución del cron envía emails reales a la dirección de prueba. Úsalo para verificar la entrega y el formato.
- Pantalla — la ejecución del cron imprime un registro detallado del procesamiento en el navegador en lugar de enviar emails. Úsalo para rastrear qué pedidos se recogen, qué mensajes se enviarían y qué pedidos se cancelarían.
- Haz clic en Guardar.
Aparece un banner de información azul en la parte superior de la página de configuración del módulo siempre que el modo de prueba está activo, confirmando que no se está contactando a los clientes en producción.
Enviar un email de verificación puntual
El panel de configuración inicial incluye un botón Enviar Email de Prueba dedicado (Paso 4 — Probar y Verificar) que es independiente del flujo de prueba basado en cron descrito anteriormente. Úsalo para confirmar que PrestaShop puede enviar email antes de ejecutar la prueba completa del cron.
- En el Back Office, ve a Módulos > Gestor de módulos > Order Payment Reminders Pro > Configurar.
- El panel se abre por defecto. Expande el Paso 4 — Probar y Verificar (se abre automáticamente una vez completados los pasos 1 a 3).
- Introduce la dirección de email donde quieres recibir la entrega de prueba.
- Haz clic en Enviar Email de Prueba.
- Revisa tu bandeja de entrada. El email contiene un enlace Verificar Entrega de Email. Haz clic en él para marcar tu configuración como verificada.
Este botón envía un único email de verificación a través del sistema de correo de PrestaShop. No interactúa con la lógica de recordatorio del cron y no requiere que haya ningún pedido sin pagar en tu tienda.
Pasar al modo de producción
Cuando estés satisfecho con tu configuración:
- Regresa a Módulos > Gestor de módulos > Order Payment Reminders Pro > Configurar.
- Desplázate hasta la sección Modo de Prueba.
- Establece Activar Modo de Prueba en No.
- Haz clic en Guardar.
A partir de la siguiente ejecución del cron, los emails de recordatorio se envían a las direcciones reales de los clientes, los pedidos se cancelan según tus reglas de cancelación automática, y el estado de envío de cada pedido se actualiza para que cada mensaje se envíe solo una vez.
Tras desactivar el modo de prueba, los pedidos que fueron procesados durante las pruebas serán tratados como si no se hubieran enviado recordatorios — porque el estado de envío nunca se actualizó durante las pruebas. La primera ejecución en producción evaluará cada pedido desde cero y enviará el recordatorio apropiado según tu programación.
Referencia de ajustes
| Ajuste | Valores | Predeterminado | Descripción |
|---|---|---|---|
| Activar Modo de Prueba | Sí / No | Sí (al instalar) | Cuando está en Sí, activa todas las protecciones del modo de prueba: redirección de emails, supresión de cancelaciones y congelación del estado de envío. |
| Dirección de Email de Prueba | Cualquier email válido | Email de administración de la tienda | Todos los emails de recordatorio se entregan a esta dirección mientras el modo de prueba está activo. No afecta al email de resumen de administración. |
| Salida de Prueba | Email / Pantalla | Controla dónde aparecen los resultados de la prueba. Email envía a la dirección de prueba. Pantalla imprime el registro de procesamiento en el navegador cuando se abre directamente la URL del cron. |
Cómo Funciona
Cuando el cron se ejecuta con el modo de prueba activo, lee el ajuste wr_test_mode al inicio de cada ciclo de procesamiento. A partir de ese momento, cada pedido se gestiona con los siguientes cambios:
Redirección de emails — En lugar de consultar la dirección de email del cliente, el módulo utiliza la dirección almacenada en wr_test_email. El email se renderiza completamente con todas las variables sustituidas exactamente igual que en producción, por lo que lo que recibes en tu bandeja de prueba es una vista previa fiel de lo que vería el cliente.
Supresión de cancelaciones — Cuando un pedido supera el plazo de cancelación automática, el módulo omite la cancelación real. Si tienes Salida de Prueba configurada en Pantalla, imprime una línea Direct Cancel Order por cada pedido que habría sido cancelado, para que puedas verificar que la lógica es correcta.
Congelación del estado de envío — Después de enviar un email de prueba, se omite la llamada a updateLastMessageSent(). El registro de recordatorio del pedido en la base de datos no se actualiza. Esto significa que el mismo pedido volverá a cumplir los requisitos en la siguiente ejecución del cron, que es exactamente lo que necesitas durante las pruebas.
Modo de salida por pantalla — Cuando la Salida de Prueba está en Pantalla y abres la URL del cron en tu navegador, el controlador imprime un registro línea a línea: cuántos pedidos se encontraron, el resultado del procesamiento para cada pedido (mensaje enviado, pedido que habría sido cancelado, pedido ya en el último mensaje), y un separador entre pedidos. En este modo no se envían emails.
Cómo interactúa con cada tipo de email
| Tipo de email | Modo de prueba ACTIVADO | Modo de prueba DESACTIVADO |
|---|---|---|
| Emails de recordatorio (para el cliente) | Redirigidos a la dirección de prueba | Enviados al cliente |
| Notificación de cancelación automática (cancelación por mensaje) | Suprimida — el cron registra la cancelación en modo Pantalla | Pedido cancelado, cliente notificado |
| Cancelación automática global (ajuste de días de cancelación) | Suprimida — el cron registra la cancelación en modo Pantalla | Pedido cancelado |
| Email de resumen de administración | Siempre enviado al destinatario del resumen — no afectado por el modo de prueba | Siempre enviado al destinatario del resumen |
Ejecutar el cron en modo de prueba
Una vez configurado el modo de prueba, activa la URL del cron manualmente desde tu navegador o mediante una terminal para verlo en acción:
- Copia la URL del cron desde la sección Configuración del Cron de la configuración del módulo.
- Abre la URL en tu navegador (o ejecútala con
curl). - Si la Salida de Prueba está en Pantalla, verás un registro línea a línea: cuántos pedidos se encontraron, qué mensaje recibiría cada pedido y qué pedidos serían cancelados.
- Si la Salida de Prueba está en Email, revisa la bandeja de prueba que configuraste. Cada pedido que cumple los requisitos genera un email de recordatorio entregado a esa dirección.
Consulta Configuración del Cron para instrucciones sobre cómo encontrar y programar la URL del cron.
Ejemplos de Uso
Ejemplo: Verificación de la configuración inicial
Acabas de instalar el módulo y has creado dos mensajes de recordatorio: uno enviado a los 2 días y un seguimiento enviado a los 5 días. El modo de prueba está activado. Abres la URL del cron en tu navegador con la Salida de Prueba en Email. Se encuentran tres pedidos sin pagar. Recibes seis emails de prueba en tu bandeja — dos por pedido, ya que ambos mensajes se evalúan cada vez. Los asuntos y la sustitución de variables son correctos. Haces clic en el enlace de verificación en el panel del Paso 4, que marca tu configuración como verificada. A continuación, estableces Activar Modo de Prueba en No y el módulo entra en producción.
Ejemplo: Depuración de un problema de formato
Una variable personalizada {shop_phone} muestra la clave de configuración sin procesar en lugar de su valor en uno de tus mensajes de recordatorio. Cambias la Salida de Prueba a Pantalla y abres la URL del cron. El registro de procesamiento muestra el contenido exacto del mensaje que se enviaría para cada pedido, lo que hace que la sustitución faltante sea inmediatamente visible. Corriges la definición de la variable, vuelves a la salida por Email y confirmas que el resultado es correcto antes de guardar.
Ejemplo: Vista previa de una nueva plantilla sin afectar a los clientes
Quieres cambiar tu plantilla de email actual por una de las 14 plantillas prediseñadas. Activas el modo de prueba (si estaba desactivado), aplicas la nueva plantilla y lanzas una ejecución del cron. El email de prueba llega a tu bandeja con la salida renderizada completa, incluidas las variables específicas del pedido. Una vez que apruebas el diseño, desactivas el modo de prueba.
Notas Importantes
- El modo de prueba es global — se aplica a todas las tiendas en una configuración multishop. No existe un modo de prueba por tienda.
- La congelación del estado de envío es intencionada. Dado que el estado no se actualiza durante las pruebas, los mismos pedidos producirán los mismos emails en cada ejecución de prueba. Esto te permite repetir las pruebas sin necesitar nuevos pedidos sin pagar cada vez.
- Si tienes pedidos con un registro de "último mensaje enviado" de una ejecución en producción anterior, esos pedidos no recibirán de nuevo ese mismo mensaje durante las pruebas. El modo de prueba solo congela las nuevas actualizaciones; no restablece los registros existentes.
- El resumen de administración ignora el modo de prueba. Si quieres suprimir el resumen durante las pruebas, desactívalo por separado en la sección Resumen de Administración.
- El botón Enviar Email de Prueba del Paso 4 es independiente del modo de prueba. Siempre entrega a la dirección que escribas en el campo de entrada del Paso 4 — no se redirige a través del ajuste de dirección de email de prueba y no interactúa con la lógica del cron.
Solución de Problemas
| Problema | Solución |
|---|---|
| Los emails de prueba no llegan | Verifica la configuración de email de PrestaShop en Parámetros avanzados > Email. Usa el botón Enviar Email de Prueba del Paso 4 para confirmar la entrega básica antes de ejecutar el cron. |
| La salida por pantalla está en blanco al abrir la URL del cron | Confirma que la URL del cron incluye el parámetro key= o token= correcto. Un token inválido o ausente hace que el controlador salga silenciosamente. Si la URL es válida pero no existen pedidos en el estado de pago pendiente, el cron muestra "No unpaid bankwire orders" y se detiene. |
| Los emails llegan a clientes reales aunque el modo de prueba parece activo | Confirma que guardaste después de activar el modo de prueba — haz clic en Guardar y busca el banner de información azul en la parte superior de la página, que confirma que el modo de prueba está activo. |
| Los mismos pedidos siguen apareciendo en cada ejecución del cron | Esto es lo esperado durante las pruebas. El estado de envío se congela intencionalmente. Tras cambiar al modo de producción, el estado se actualiza con normalidad y cada mensaje se envía solo una vez. |
| El resumen de administración sigue enviándose durante las pruebas | Este es el comportamiento correcto. El resumen es un informe interno de administración y no lo suprime el modo de prueba. Para detenerlo durante las pruebas, desactívalo en la sección Resumen de Administración. |
| El modo de prueba estuvo activo durante varias ejecuciones del cron — ¿recibirán los pedidos mensajes duplicados al pasar a producción? | No. Dado que el estado de envío estaba congelado, el módulo evalúa cada pedido como si no se hubieran enviado mensajes. La primera ejecución en producción envía el mensaje correcto en función de la antigüedad del pedido y tu programación. |
Preguntas Frecuentes
¿Activar el modo de prueba afecta a los pedidos que ya habían recibido un recordatorio antes de activarlo?
No. El modo de prueba solo cambia lo que ocurre durante una ejecución del cron — los emails se redirigen y las actualizaciones de estado se suprimen. Los registros escritos antes de activar el modo de prueba permanecen sin cambios.
¿Puedo configurar un email de prueba diferente por tienda en una configuración multishop?
No. La dirección de email de prueba y el interruptor del modo de prueba son ajustes globales que se aplican a todas las tiendas. No existe ninguna opción por tienda.
¿Por qué el email de resumen de administración siempre llega al destinatario real aunque el modo de prueba esté activo?
El resumen es un informe para el administrador, no una comunicación para el cliente. Se excluye intencionalmente de la redirección del modo de prueba para que puedas verificar que funciona correctamente durante la configuración.
¿Qué ocurre con las reglas de cancelación automática cuando el modo de prueba está activo?
Los pedidos que han superado el plazo de cancelación no se cancelan. En el modo de salida por Pantalla, el cron imprime una línea "Direct Cancel Order" por cada pedido que habría cancelado, para que puedas verificar que la lógica es correcta sin modificar ningún pedido.
La salida por "Pantalla" no muestra nada — ¿es normal?
Si no existen pedidos sin pagar en tu tienda para los módulos de pago configurados, el cron muestra un mensaje breve y se detiene. Necesitas al menos un pedido en estado de pago pendiente para que el módulo procese algo.
Desactivé el modo de prueba pero el banner azul sigue apareciendo.
El banner lee el valor de configuración guardado. Asegúrate de haber hecho clic en Guardar después de cambiar el interruptor. Recarga la página después de guardar y el banner debería desaparecer.
¿El botón "Enviar Email de Prueba" del Paso 4 utiliza la dirección de email de prueba que configuré?
No. El botón Enviar Email de Prueba entrega a la dirección que escribas directamente en el campo de entrada del Paso 4. Es independiente del ajuste de dirección de email del modo de prueba y del interruptor del modo de prueba.
Si me olvido de desactivar el modo de prueba y el cron se ejecuta durante la noche, ¿qué tengo que hacer?
Simplemente desactiva el modo de prueba y guarda. Dado que el estado de envío nunca se actualizó durante las ejecuciones de prueba, el módulo evaluará cada pedido desde cero en la siguiente ejecución en producción y enviará el recordatorio correcto según la antigüedad y la programación de cada pedido.