PersonalizarEmail: personaliza y previsualiza los emails de FacturaScripts

Descripción

PersonalizarEmail permite adaptar la plantilla de los emails que envía FacturaScripts (facturas, presupuestos, albaranes, pedidos y el resto de notificaciones) desde la propia interfaz, sin tocar código. Añade además una vista previa de cualquier notificación con datos de ejemplo y un botón para enviarte un email de prueba, de forma que puedes ver exactamente lo que recibirán tus clientes antes de guardar nada.

Sin configuración, los emails son idénticos a los del core: todos los valores por defecto reproducen la plantilla original.

Qué puedes personalizar

Todo se configura desde Panel de control → Email → pestaña Personalización:

Cabecera: el título del email (por defecto, el nombre de la empresa), su tipo de letra, tamaño y color. También puedes ocultar el título por completo.
Logo: posición vertical (antes del título, después del título, entre el cuerpo y el pie, abajo del todo, o no mostrarlo) y alineación horizontal (izquierda, centro, derecha).

El logo se establece en la misma pestaña en la que se establece el correo electrónico.

Cuerpo: tipo de letra, tamaño y color del texto, además del color de fondo, del contenedor y de los botones.
Pie: un texto adicional (por ejemplo, un aviso legal) con su tipo de letra, color y tamaño.

Los tipos de letra se limitan a familias seguras para clientes de correo (Arial, Verdana, Tahoma, Trebuchet MS, Georgia, Times New Roman y Courier New), para que el email se vea igual en Gmail, Outlook y el resto de clientes.

Vista previa y email de prueba

Nueva pestaña Vista previa en la configuración de email, con un selector para renderizar cualquier notificación con datos de ejemplo (número de factura, cliente, fechas, importes...).
La misma pestaña aparece al editar una notificación concreta.
La vista previa incluye los cambios sin guardar: modifica el asunto, el cuerpo o cualquier ajuste de estilo, pulsa Actualizar y verás el resultado al momento.
El botón Enviar prueba manda esa misma vista previa como email real a la dirección que indiques (prellenada con la del usuario conectado), con el asunto prefijado [TEST].

Logo incrustado para instancias no públicas

FacturaScripts enlaza el logo del email a la URL de la instancia, por lo que si tu servidor no es accesible desde internet, los destinatarios ven la imagen rota. La opción Incrustar el logo resuelve esto adjuntando el logo dentro del propio mensaje (imagen CID), de modo que se ve siempre, esté donde esté tu instalación.

Cómo funciona

Los ajustes se guardan en el grupo de configuración emailstyle.
La plantilla del core se sobrescribe mediante View/Email/NewTemplate.html.twig, el mecanismo estándar de plugins; no se modifica ningún archivo de Core/ ni Dinamic/.
El logo incrustado se implementa extendiendo Lib/Email/NewMail.php por herencia de clases de Dinamic, así que afecta a todos los envíos del programa automáticamente.
El plugin no declara dependencias y es compatible con otros plugins de email.

Requisitos

FacturaScripts 2026 o superior.

Instalación

Descarga el plugin y súbelo desde Administrador → Plugins, o copia la carpeta PersonalizarEmail en el directorio Plugins/ de tu instalación.
Actívalo desde la lista de plugins.
Entra en Panel de control → Correo Electrónico y abre las pestañas Personalización y Vista previa.

Licencia

GNU Lesser General Public License v3 (LGPL-3.0), la misma que FacturaScripts.