OdooWiki OCA HUB

Mail Layout Force

mail_layout_force folder_open OCA/mail open_in_new
Marketing Licencia: AGPL-3

Odoo añadirá un diseño de correo predeterminado en la mayoría de las comunicaciones comerciales.

El diseño de correo es una vista QWeb que termina envolviendo el cuerpo del mensaje al enviar un correo electrónico. Por lo general, muestra la referencia del documento relacionado, el logotipo de la empresa y un pequeño pie de página que dice "Powered by Odoo".

Existen notablemente tres diseños principales utilizados en Odoo, y el usuario no puede controlar cuándo se utilizan, ya que están codificados de forma fija en las diferentes aplicaciones.

  • mail.mail_notification_layout
  • mail.mail_notification_layout_with_responsible_signature
  • mail.mail_notification_light

Este módulo permite forzar un diseño específico para un email.template determinado, sobrescribiendo efectivamente el codificado de forma fija por Odoo. Además, permite forzar un diseño personalizado para correos electrónicos que no utilizan un registro email.template existente (por ejemplo, al enviar un correo electrónico desde el chatter).

Esto le permite personalizar completamente la forma en que se renderizan y se envían los correos electrónicos de Odoo a sus clientes.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Fuerza un diseño de correo electrónico específico en las plantillas de correo seleccionadas o en todos los correos enviados para los modelos elegidos, reemplazando el diseño que Odoo elige normalmente de forma automática.

Odoo envuelve la mayoría de los correos de notificación en un diseño estándar (logotipo de la empresa, referencia del documento, pie de página). Este módulo te permite decidir qué diseño se utiliza en lugar de dejar esa elección a Odoo.

  • En una plantilla de correo (mail.template) obtienes un nuevo campo "Force Layout" donde eliges el diseño a utilizar. Establecerlo actualiza la referencia de diseño de la plantilla; borrarlo elimina el diseño forzado.
  • En un formulario de vista QWeb obtienes una nueva pestaña "Layout Mapping" (solo visible para vistas QWeb). Ahí enumeras reglas de reemplazo: para cada regla eliges un diseño de destino y, opcionalmente, los modelos a los que se aplica. Si no se selecciona ningún modelo, la regla se aplica a todos los modelos.
  • Cuando Odoo prepara un correo de notificación, busca el diseño que se usaría normalmente y luego comprueba estas reglas. Si existe una regla coincidente (para el modelo específico, o una regla sin restricción de modelo), se utiliza el diseño de reemplazo en su lugar.
  • Se proporciona una plantilla "No-Layout" ya preparada, que simplemente muestra el cuerpo del mensaje sin ningún envoltorio, para que puedas enviar correos sin ningún diseño.
  • Al redactar un mensaje a partir de una plantilla, el redactor toma automáticamente el diseño forzado de la plantilla.

El acceso es de solo lectura para los usuarios normales y total para los administradores del sistema. El módulo toca mail.template, mail.compose.message, mail.thread, ir.ui.view y añade el nuevo modelo email.layout.mapping.

Depende de

mail
Modelos y campos (4)
  • ir.ui.view · amplía un modelo existentelayout_mapping_line_ids
  • mail.template · amplía un modelo existenteforce_email_layout_id (Force Layout)
  • email.layout.mapping · modelo nuevolayout_id, model_ids (Models), substitute_layout_id
  • mail.compose.message · amplía un modelo existente

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Configuración

Fuente · Odoo 18.0

Para configurar un diseño forzado para las plantillas de correo electrónico:

  • Vaya a Ajustes > Técnico > Correo electrónico > Plantillas de correo electrónico
  • Abra el registro email.template deseado
  • En la pestaña Ajustes, busque el campo Force Layout

Puede dejarlo vacío para usar el diseño de correo electrónico predeterminado (elegido por Odoo). Puede forzar un diseño de correo electrónico personalizado propio. Puede usar la plantilla de notificación Mail: No-Layout para evitar que Odoo añada un diseño.

Para configurar un diseño personalizado propio, se necesitan algunos conocimientos técnicos. Puede ver cómo se definen los diseños existentes para obtener detalles o inspiración:

  • mail.mail_notification_layout
  • mail.mail_notification_layout_with_responsible_signature
  • mail.mail_notification_light

Para forzar un diseño personalizado para correos electrónicos que no usan un registro email.template existente (por ejemplo, correos electrónicos enviados desde el chatter) o para casos en los que los correos electrónicos se envían directamente a través de message_post sin abrir el compositor de correo (por ejemplo, acciones de envío de facturas como action_invoice_sent), puede usar la función Layout Mapping:

  • Vaya a Ajustes > Técnico > Interfaz de usuario > Vistas
  • Copie el diseño actual (por ejemplo, mail.mail_notification_layout_with_responsible_signature) para crear un nuevo diseño personalizado y personalícelo según sea necesario
  • Abra la vista del diseño original que desea reemplazar. En la pestaña Layout Mapping:
  • Haga clic en Añadir una línea
  • Establezca Substitute Layout en el nuevo diseño personalizado que creó
  • Establezca Models si desea aplicar el reemplazo solo a modelos específicos. Si se deja vacío, el diseño del correo electrónico se reemplazará para todos los modelos

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Uso.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.