Used to set messages in the view screen. Messages can be associated to the page or to a specific user. The actual message is defined in the body of the macro and can include Value References. It can be used only within a {trigger} macro.
| Parameters | Mandatory | Default | Description |
|---|---|---|---|
| unnamed first parameter or user |
no | if not set, then the message will be associated to the page and will be visible to all users | User name |
| style | no | tip | The style of the message that defines the background. Values can be tip, warning, info or note |
| duration | no | for page messages, they would be shown indefinitely, for user message, default is to be shown only once | Defines for how long the message is to be shown and should be stated on weeks (i.e. 2w), days (i.e. 3d), hours (i.e. h) or minutes (i.e. 1m or 1) |
Examples
{set-message}Draft{set-message}
{set-message:@user@}thanks for creating the new page!{set-message}
{set-message:user=emendator}This page is ready for review!{set-message}
Comments (4)
Feb 09, 2008
Matt Bovett says:
How do you remove leftover messages? I've been experimenting with this plugin a ...How do you remove leftover messages? I've been experimenting with this plugin a lot and my workflows have changed a lot and some of the messages from the old ways I was doing things are still on some pages. Any idea how to remove?
Mar 17, 2008
Roberto Dominguez says:
The only way to remove messages is by setting empty messages: {trigger:...} ...The only way to remove messages is by setting empty messages:
{trigger:...} {set-message}{set-message} {triger}Not the most efficient way of doing it. Have created a new issue APRV-79 to come up with a better solution.
Mar 17, 2008
Matt Bovett says:
Cool. OK, semi-related: I haven't tested this yet, but can you pretty much add ...Cool. OK, semi-related:
I haven't tested this yet, but can you pretty much add whatever text/macros to the page using the set-message macro with the trigger macro?
Like, say we wanted to add one of Adaptavist's lozenges... could we do that using set-message?
May 13, 2008
Richard Michalsky says:
Hi, I've encountered a problem with set-message while updating page metadata. Ch...Hi, I've encountered a problem with set-message while updating page metadata. Changing content of the metadata does not update the message (regardless of whether metadata are shown in the page or not). The trigger pageupdated gets called but I need to change something in the text of the page for the message to be updated.
Is it a known problem? Is there a workaround?