OdooWiki OCA HUB

CMS status message

cms_status_message folder_open OCA/website-cms open_in_new
Sin categoría Licencia: LGPL-3

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.0

Permite 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

webportal

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-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado 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.0

Có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

Autodismiss

Por 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 = 0

Puedes personalizar el tiempo de espera configurando la clave:

cms_status_message.autodismiss_timeout = 3000  # milliseconds

Tambié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 appereance

Por 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.

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.