Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter

Required

Default

Notes

Ver

unnamed first parameter



Status
subtletrue
titleDeprecated
Use the user parameter instead

Deprecated
5.2
macro body

The message to display:


Replaces existing message to same audience; if empty, the message panel will be removed for that audience.

duration


(info)

How long should the message be displayed from the point at which it is set?

Content by Label
showLabelsfalse
max6
showSpacefalse
sorttitle
cqllabel = "parameter-duration" and label = "macro-set-message" and label = "example" and space = currentSpace()


(info) Default behaviour depends on message audience:
  • Unfiltered messages are shown indefinitely
  • If a group and/or user is specified, the message for an individual user will expire once viewed by that user

In both cases, specifying a duration will override the default behaviour.

group

unfiltered

Only show to users in specific user group(s)?

Content by Label
showLabelsfalse
max6
showSpacefalse
sorttitle
cqllabel = "parameter-group" and label = "macro-set-message" and label = "example" and space = currentSpace()

5.2

style


info



Message style: info, error, warning, success

Image RemovedImage RemovedImage RemovedImage RemovedImage AddedImage AddedImage AddedImage Added

if no style is added the default message display is info.

Content by Label
showLabelsfalse
max6
showSpacefalse
sorttitle
cqllabel = "parameter-style" and label = "macro-set-message" and label = "example" and space = currentSpace()

4.1

Status
subtletrue
colourRed
titleObsolete
The tip and hint styles are no longer supported (since v4.1) – use success and info, respectively, instead.

user

unfiltered

Only show to specific user(s)?

Content by Label
showLabelsfalse
max6
showSpacefalse
sorttitle
cqllabel = "parameter-user" and label = "macro-set-message" and label = "example" and space = currentSpace()


view
both

Which types of content URL should the message be shown on?

  • draft – the normal URL
  • published – the /public URL
  • both – both normal and public URLs

Content by Label
showLabelsfalse
max6
showSpacefalse
sorttitle
cqllabel = "parameter-view" and label = "macro-set-message" and label = "example" and space = currentSpace()

5.2

This parameter determine which URL the message will be shown on when using Same-space publishing:

If you're not using same-space publishing, all users see the normal URL by default.

(info)(info) Notes

  • The user and group parameters can be used together:
    • Groups are treated as if you listed their users via the user parameter
    • There can be only one message for a given user per view type
  • Unfiltered messages, those which do not specify user or group, are treated separately:
    • They will be shown in addition to user or group messages
  • Use the macro body empty to remove the previously set message. Note that you need to use the same parameters that in the message you want to remove e.g., if the message contained view=draft, then, your empty set-message macro must have the very same view=draft param.

...