notifications targets

Greg Holmes edited this page Sep 28, 2014 · 1 revision

Notification targets

active

_Syntax: active

The event will be displayed in the most recently used window which belongs to the same server.

all

Syntax: all

The event will be displayed in all windows which belong to the same server.

channel

Syntax: channel:channelName [fallback]

The event will be displayed in the channel named channelName. If there is no such channel on the relevant server, the fallback parameter will be checked and if present, will be used as the target instead. If the fallback parameter doesn't exist in this case, the event is displayed in the parent window and a DMDirc user error is raised.

comchans

Syntax: comchans:userName [fallback]

The event will be displayed in any channel which userName is also present in. If there are no such common channels on the relevant server, the fallback parameter will be checked and if present, will be used as the target instead. If the fallback parameter doesn't exist in this case, the event is displayed in the parent window and a DMDirc user error is raised.

fork

Syntax: fork:notificationTarget1|notificationTarget2|notificationTarget3…

Allows multiple notification targets to be executed for the same event. Any number of notification targets may be specified, separated by the pipe character (|), but these targets may not contain pipes themselves. If you require pipes in a forked target, you can use the group: target as a work around.

format

Syntax: format:formatName:notificationTarget

Changes the format which will be used for the event in question to the one specified by formatName. The actual notification target is then determined by notificationTarget.

group

Syntax: group:groupName

Uses the notification target defined in the setting named “notification.groupName”. The target within this group setting may be any notification target except for group or format.

lastcommand

Syntax: lastcommand:command

Each window associated with the server is checked to find the last one which executed the command command. If no window executed a matching command, the target is treated as though it were “self”. The following rules apply to command:

It does not include the command or silence characters (e.g., 'foo' will match the user entering /foo and /.foo) It is treated as a regular expression It may reference arguments to the event in the same style as formatters - e.g. %1$s, %2$s, etc.

none

Syntax: none

The event is not displayed.

self

Syntax: self

The event will be displayed in the window that owns it, i.e. the channel window for channel events, server window for server events, etc.

server

Syntax: server

The event will be displayed in the server window which owns the window that the event belongs to.

window

Syntax: window:windowName

The event will be displayed in a window called windowName, belonging to the server. If the window does not exist, it will be opened when the first event is received.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.