Variables personalizadas
Las variables personalizadas te permiten definir marcadores de posición reutilizables — como el número de cuenta bancaria, IBAN o teléfono de soporte — una sola vez, e insertarlos en cualquier correo de recordatorio escribiendo {nombre_variable}.
Disponible desde v1.2.0
Descripción general
Cada recordatorio de pago debe indicar a tus clientes dónde enviar el pago. Escribir manualmente los datos bancarios en cada mensaje de correo es tedioso y propenso a errores. Si cambia el número de cuenta, tendrías que actualizar cada mensaje individualmente.
Las variables personalizadas resuelven este problema. Defines un marcador con nombre una sola vez — por ejemplo numero_cuenta — y luego escribes {numero_cuenta} en cualquier lugar del asunto o cuerpo de un correo. Cuando el módulo envía un recordatorio, reemplaza el marcador con el valor real de forma automática.
Existen dos tipos de variable. Valor estático almacena un texto fijo que introduces directamente. Clave de configuración lee su valor en tiempo real desde una clave de configuración de PrestaShop, lo cual es útil cuando el valor ya está almacenado en PrestaShop y quieres que tus correos se mantengan sincronizados automáticamente sin mantener dos copias de la misma información.
Las variables están definidas por tienda. En una configuración multitiendo, cada tienda mantiene su propia lista de variables, de modo que puedes tener diferentes cuentas bancarias o datos de contacto por tienda.
Configuración
Añadir una variable
- Ve a Módulos > Gestor de módulos, busca Order Payment Reminders Pro y haz clic en Configurar.
- Desplázate hasta la sección Variables personalizadas en la página principal del panel (debajo de la lista de comprobación de configuración).
- Rellena el formulario Añadir nueva variable en la parte inferior del panel:
| Campo | Requerido | Descripción |
|---|---|---|
| Nombre de la variable | Sí | Un identificador corto que utilice solo letras, números y guiones bajos. Debe comenzar con una letra o guión bajo. Ejemplos: numero_cuenta, direccion_banco, telefono_soporte. Máximo 64 caracteres. |
| Tipo | Sí | Valor estático — guarda el texto directamente. Clave de configuración — lee el valor desde una clave de configuración de PrestaShop cada vez que se envía un correo. |
| Valor | Sí | Para Valor estático: el texto a insertar (máx. 255 caracteres, sin HTML). Para Clave de configuración: el nombre de la clave de configuración en mayúsculas, p. ej. PS_SHOP_EMAIL. |
- Haz clic en Añadir.
La tabla se actualiza inmediatamente y aparece la nueva variable. La columna Vista previa muestra el valor resuelto para que puedas confirmar que es correcto.
Los nombres de las variables distinguen entre mayúsculas y minúsculas en las plantillas. Una variable llamada
numero_cuentadebe escribirse como{numero_cuenta}— no como{Numero_Cuenta}ni{NUMERO_CUENTA}.
Editar una variable
- En la tabla Variables personalizadas, haz clic en el icono de lápiz (editar) en la fila que deseas modificar.
- Actualiza el nombre, tipo o valor según sea necesario.
- Haz clic en Guardar.
Si cambias el nombre de una variable después de haberla utilizado en mensajes, el marcador antiguo ya no se reemplazará. Actualiza primero los cuerpos de los mensajes y luego cambia el nombre de la variable.
Eliminar una variable
- En la tabla Variables personalizadas, haz clic en el icono de papelera roja en la fila que deseas eliminar.
- Confirma la eliminación.
La eliminación es inmediata y permanente. Cualquier marcador {nombre_variable} ya incluido en tus plantillas de mensajes quedará como texto literal en los correos. Elimínalos de tus mensajes antes de borrar una variable.
Usar una variable en un correo
- Abre el mensaje de recordatorio que quieres editar (en la sección Mensajes de la configuración del módulo).
- En el Asunto o Cuerpo del mensaje, escribe
{nombre_variable}en el punto exacto donde quieres que aparezca el valor. - Guarda el mensaje.
Cuando se ejecuta el cron, cada marcador {nombre_variable} se reemplaza por su valor resuelto antes de entregar el correo al cliente. Puedes combinar variables personalizadas con las variables integradas ({totalamount}, {completename}, {daysleft}, etc.) libremente tanto en el asunto como en el cuerpo.
Cómo funciona
Cuando se ejecuta el cron y hay un recordatorio pendiente, el módulo obtiene todas las variables personalizadas definidas para esa tienda. Para cada variable de tipo Valor estático, utiliza el texto que guardaste. Para cada variable de tipo Clave de configuración, lee el valor actual de la tabla de configuración de PrestaShop en ese momento — por lo que si el ajuste subyacente cambió desde que guardaste la variable, el correo utiliza el valor actualizado de forma automática.
Tras recopilar todos los valores resueltos, el módulo realiza un único recorrido por el asunto y el cuerpo del correo, reemplazando cada patrón {nombre_variable} que encuentre. Los marcadores que no tienen una variable coincidente se dejan tal cual, apareciendo como texto literal en el correo entregado.
Variables de valor estático
Al elegir Valor estático, el texto que introduces se almacena directamente y se utiliza tal cual en cada correo. Las etiquetas HTML se eliminan automáticamente al guardar, por lo que el valor es siempre texto plano. Esta es la opción adecuada para datos de pago, números IBAN, códigos BIC, nombres de bancos y cualquier otro texto que controlas y actualizas manualmente.
Variables de clave de configuración
Al elegir Clave de configuración, introduces el nombre de una clave de configuración de PrestaShop en mayúsculas (por ejemplo PS_SHOP_NAME o PS_SHOP_EMAIL). Al salir del campo, el módulo valida inmediatamente la clave y muestra una vista previa de su valor actual. Si la clave no se encuentra, verás un aviso en rojo indicando "No encontrada".
En el momento del envío del correo, el valor se lee en tiempo real desde la tabla de configuración, por lo que tus recordatorios reflejan automáticamente cualquier cambio en el ajuste subyacente de PrestaShop. Esta es la opción adecuada para cualquier valor que ya esté almacenado y gestionado en otro lugar de tu tienda — el nombre de la tienda, el número de teléfono, o un valor establecido por otro módulo instalado.
Solo se admiten valores de configuración de tipo cadena o numérico simples. Las claves de configuración que contienen datos complejos (arrays u objetos JSON) son rechazadas.
Ejemplos de uso
Ejemplo: Instrucciones de transferencia bancaria
Una tienda que usa transferencia bancaria quiere que cada recordatorio incluya sus datos de pago. Crea tres variables:
| Nombre de la variable | Tipo | Valor |
|---|---|---|
iban | Valor estático | DE89 3704 0044 0532 0130 00 |
bic | Valor estático | COBADEFFXXX |
nombre_banco | Valor estático | Commerzbank AG |
En el cuerpo del mensaje, escribe:
Por favor, transfiere el importe pendiente de {totalamount} a:
Banco: {nombre_banco}
IBAN: {iban}
BIC/SWIFT: {bic}
Referencia: Pedido #{reference}
El pago debe recibirse en un plazo de {daysleft} días.
Si tus datos bancarios cambian en algún momento, actualiza las tres variables una sola vez y todos los recordatorios futuros reflejarán el cambio de inmediato.
Ejemplo: Teléfono de atención al cliente mediante clave de configuración de PrestaShop
Tu número de teléfono ya está definido en Parámetros de la tienda > Contacto. En lugar de duplicarlo, crea una variable:
| Nombre de la variable | Tipo | Valor |
|---|---|---|
telefono_soporte | Clave de configuración | PS_SHOP_PHONE |
Luego inserta {telefono_soporte} en el pie de tu mensaje: "¿Preguntas? Llámanos al {telefono_soporte}." Si en algún momento actualizas el número de teléfono en los parámetros de la tienda de PrestaShop, todos los recordatorios futuros usarán el nuevo número automáticamente — sin necesidad de ninguna acción adicional.
Ejemplo: Enlace al portal de pago
Tu tienda dispone de una página de pago alojada donde los clientes pueden completar el pago en línea. Guarda la URL una sola vez:
| Nombre de la variable | Tipo | Valor |
|---|---|---|
url_portal_pago | Valor estático | https://pay.yourstore.com/complete |
En el asunto de tu recordatorio: "Completa tu pago en {url_portal_pago}". Todos los mensajes de recordatorio de todos tus métodos de pago incluirán la misma URL actualizada.
Notas importantes
- No se permite HTML en los valores de las variables. Cualquier etiqueta HTML en un Valor estático se elimina automáticamente al guardar. Si necesitas un enlace clicable en un correo, escribe la etiqueta
<a>directamente en el cuerpo del mensaje y usa una variable solo para la parte de la URL. - Los nombres de las variables son únicos por tienda. No puedes tener dos variables con el mismo nombre en la misma tienda. Intentar guardar un nombre duplicado devuelve un error.
- Las variables de tipo Clave de configuración se validan al introducirlas. Si la clave no existe o contiene un valor complejo (array u objeto), el módulo la rechaza con un mensaje de error claro.
- Multitiendo: Cada tienda tiene su propia lista de variables independiente. Al cambiar de tienda en el Back Office se muestran solo las variables de esa tienda. Las variables no se comparten entre tiendas.
- Las variables sin valor resuelto se omiten silenciosamente. Si una Clave de configuración se elimina posteriormente de PrestaShop, el marcador aparecerá como texto literal en los correos en lugar de insertar un valor vacío. Elimina los marcadores obsoletos de tus plantillas de mensajes si borras la clave de configuración subyacente.
- Los nombres de las variables distinguen entre mayúsculas y minúsculas.
{iban}y{IBAN}se tratan como marcadores diferentes.
Resolución de problemas
| Problema | Solución |
|---|---|
{nombre_variable} aparece como texto literal en el correo enviado | El nombre en la plantilla de correo no coincide exactamente con el nombre de la variable en la tabla. Comprueba si hay errores tipográficos, letras mayúsculas o espacios. Los nombres de las variables distinguen entre mayúsculas y minúsculas. |
| Error "El nombre de la variable solo puede contener letras, números y guiones bajos" | El nombre introducido contiene un espacio, guión u otro carácter especial. Usa guiones bajos en su lugar (p. ej. direccion_banco en lugar de direccion banco). |
| La Clave de configuración muestra "No encontrada" en la vista previa | La clave introducida no existe en la tabla de configuración de PrestaShop. Comprueba la ortografía y asegúrate de que el módulo que crea esta clave está instalado y se ha configurado al menos una vez. |
| La Clave de configuración muestra "El valor de configuración no es de tipo simple" | La clave contiene un array u objeto JSON (p. ej. un módulo de pago que almacena configuración compleja). Solo se admiten valores de tipo cadena o número simples. Usa una variable de Valor estático en su lugar y actualízala manualmente. |
| Se eliminó una variable y ahora los correos muestran el marcador sin procesar | Eliminaste una variable que aún está referenciada en una plantilla de mensaje. Edita los mensajes afectados y elimina o reemplaza el marcador {nombre_variable}. |
| El valor de la variable cambió pero los correos siguen mostrando el valor antiguo | Para variables estáticas, abre la variable y guárdala de nuevo con el nuevo valor. Para variables de Clave de configuración, comprueba que la configuración subyacente de PrestaShop se haya actualizado y guardado correctamente. |
| Error de nombre duplicado al guardar | Cada nombre de variable debe ser único dentro de la misma tienda. Elige un nombre diferente o edita la variable existente en su lugar. |
Preguntas frecuentes
¿Cuántas variables personalizadas puedo crear?
No hay un límite fijo. Puedes crear tantas variables como necesite tu tienda.
¿Puedo usar una variable personalizada en el asunto del correo además del cuerpo?
Sí. Las variables personalizadas se reemplazan tanto en el asunto como en el cuerpo de cada correo de recordatorio antes de ser entregado.
¿Qué ocurre si uso {numero_cuenta} en un mensaje pero aún no he creado esa variable?
El marcador se deja como texto literal en el correo enviado — el cliente verá {numero_cuenta} en el mensaje. Verifica siempre que tus variables existen y que la vista previa es correcta antes de activar un mensaje.
¿Puedo almacenar texto de varias líneas, como una dirección postal completa, en una variable?
No. Los valores de las variables son texto plano almacenado en un campo de una sola línea (máximo 255 caracteres). Para contenido de varias líneas, como una dirección postal completa, escríbelo directamente en el cuerpo del mensaje utilizando el editor de texto enriquecido.
¿Una variable de Clave de configuración se actualiza automáticamente cuando cambia el ajuste de PrestaShop?
Sí. El valor se lee de la tabla de configuración cada vez que se ejecuta el cron y se envía un correo, por lo que cualquier cambio en el ajuste subyacente de PrestaShop tiene efecto en la siguiente ejecución del recordatorio sin que tengas que hacer nada.
¿Puedo usar la misma variable en varios mensajes de recordatorio?
Sí. Una variable definida una sola vez está disponible en todos los mensajes de recordatorio de esa tienda. Inserta {nombre_variable} en tantos mensajes como necesites.
¿Cuál es la diferencia entre las Variables personalizadas y las variables integradas como {totalamount}?
Las variables integradas se rellenan automáticamente con datos del pedido en tiempo real — nombre del cliente, total del pedido, días restantes, etc. Las variables personalizadas son fragmentos de texto que defines tú mismo, normalmente información específica de la tienda como datos de pago o información de contacto que no proviene de un pedido individual.
¿Las variables personalizadas se sustituyen en los correos del Modo de prueba?
Sí. Cuando envías un correo de prueba desde la sección Modo de prueba, las variables personalizadas se resuelven y sustituyen exactamente igual que en un recordatorio real.
¿Qué ocurre si se desinstala o elimina una Clave de configuración que estaba usando?
La variable seguirá existiendo en tu lista, pero el marcador aparecerá como texto literal en los correos enviados porque la clave ya no existe. Elimina o reemplaza el marcador en tus plantillas de mensajes y luego borra la variable de la lista para mantener todo ordenado.