Un "mensaje de estado" es un mensaje importante que quieres mostrar a los usuarios.
Por ejemplo: un usuario envía un formulario o realiza una acción específica y quieres informar del estado de esa acción, como "tu perfil ha sido actualizado" o "Tu actualización se ha realizado correctamente.".
Este módulo permite mostrar fácilmente este tipo de mensajes a tus usuarios.
Los mensajes se muestran utilizando alertas de Twitter bootstrap.
Puedes añadir varios mensajes: se mostrarán uno tras otro.
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 16.0Permite a los desarrolladores y creadores de sitios web mostrar mensajes de estado breves (info, success, warning, error) a los visitantes, por ejemplo después de enviar un formulario. Los mensajes aparecen como alertas descartables en las páginas del portal y pueden desaparecer automáticamente.
Este módulo añade una forma sencilla de mostrar mensajes temporales a los usuarios del sitio web y del portal, como «tu perfil se ha actualizado» o «tu actualización se ha realizado correctamente». Los mensajes se almacenan en la sesión del usuario y se muestran como cuadros de alerta de colores (usando los estilos estándar de Bootstrap) en la siguiente página que vea.
- Los mensajes pueden tener un título y un tipo: info, success, warning o danger. Si no se proporciona un título, se usa un título predeterminado según el tipo (Info, Success, Warning, Error).
- Las alertas pueden ser descartables (con un botón de cierre) o no. Cuando son descartables, también pueden desaparecer automáticamente tras un retardo.
- La desaparición automática se controla mediante dos ajustes del sistema: uno para activarla o desactivarla y otro para establecer el tiempo de espera en milisegundos. Por defecto está activada con un tiempo de espera de 8 segundos.
- Los mensajes se añaden a la sesión y luego se leen y se eliminan cuando se muestran, por lo que solo aparecen una vez.
- En las páginas del portal, los mensajes se insertan en la parte superior del diseño de la página.
- Una página de prueba en /cms/status-message/display-test te permite probar la funcionalidad introduciendo un mensaje y enviando un formulario; muestra el mensaje en los cuatro tipos.
El módulo extiende el modelo ir.http con métodos para añadir, obtener y borrar mensajes de estado, y añade plantillas para renderizarlos. Depende de los módulos web y portal.
Depende de
Lo necesitan otros módulos
Modelos y campos (1)
- ir.http · amplía un modelo existente
Texto generado por IA (DeepSeek) al leer el código de la versión 16.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-03Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/website-cms.
terminal Instalación y uso
Documentación de OCA · Odoo 16.0Código Python
Set a message:
.. code:: python
msg = _('My important message.')
env["ir.http"].add_status_message(msg)
By default the message type is ``info``. The title (the label at the
beginning of the message) matches the message type:
- 'info': 'Info'
- 'success': 'Success'
- 'danger': 'Error'
- 'warning': 'Warning'
You can change message parameters:
.. code:: python
msg = _('Watch out!')
env["ir.http"].add_status_message(msg, kind='warning', title='Oh no')
Messages will be displayed like this:
.. image:: ./images/preview.png
AutodismissPor defecto, los mensajes se descartarán automáticamente después de 8 segundos. Puedes desactivar esto configurando un ir.config_param como:
cms_status_message.autodismiss = 0Puedes personalizar el tiempo de espera configurando la clave:
cms_status_message.autodismiss_timeout = 3000 # millisecondsTambién puedes personalizar esto a demanda cuando creas el mensaje:
msg = _('I will disappear more slowly')
options = {'autodismissTimeout': 10000}
env["ir.http"].add_status_message(msg, dismiss_options=options)Código Javascript
Dependencies:
FIXME v16
.. code:: javascript
var msg_tool = require('cms_status_message.tool');
var core = require('web.core');
var _t = core._t;
Inject a custom message on the fly:
.. code:: javascript
msg = {
'msg': _t('Item unpublished.'),
'title': _t('Warning'),
'type': 'warning'
}
msg_tool.render_messages(msg).then(function(html) {
// wipe existing
$('.status_message').remove();
// inject new
$(html).hide().prependTo('#wrap').fadeIn('slow');
});
Add a status message to the session, useful if you want to show the
message only after a redirect:
.. code:: javascript
var msg = _t('Contratulations! You made it!.');
var options = {'title': _('My title'), 'dismissible': false};
msg_tool.add_message(msg, options);
Customize appereancePor defecto, el cuadro de alerta se añade encima del contenido de <main />. Si quieres personalizar este comportamiento, simplemente sobrescribe o desactiva la plantilla cms_status_message.add_status_message.
Prueba el aspecto y la sensación de tu tema
Go to `/cms/status-message/display-test` to see how messages will look like
when your theme is applied.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, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
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.