Plugin:TabSRMM/en/Event notifications

From Miranda NG
< Plugin:TabSRMM‎ | en
Revision as of 21:24, 13 March 2019 by GBot (talk | contribs) (What else is required to make this feature work?: {{Popup}}->{{PopupPlus}})
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Event notifications are a way to notify the user about incoming events. An event, in this context, is anything that happens without intervention of the user. Typical events are:

  • status changes
  • incoming messages
  • incoming file transfers

Miranda allows many different types of events and only a few are related to messaging and thus must be handled by the message window plugin. TabSRMM will handle the following event types:

  • incoming messages
  • incoming file transfers (they are not exactly message events, but the message window plugin will still catch them and write the event to the history).
  • for chatrooms, typical events like JOIN, PART, ACTION are supported event types and it is possible to show notifications for all or only a subset of these event types.

How TabSRMM can notify you of incoming events

Basically, there are two methods:

  • Visual notifications in form of popup windows (see below).
  • Aural notifications by playing a sound effect assigned to the event type.

What else is required to make this feature work?

To show visual event notifications, TabSRMM needs a plugin that can display popups (PopupPlus or StdPopup). If no compatible popup plugin is installed, visual event notifications are disabled.

Features supported and implemented

The following list describes which features are supported and what can be done by using them.

  • notifications for incoming messages and file events
  • merging events into a single popup (multiple incoming events for the same contact can be merged into a single display element to avoid cluttering the desktop with too many popups).
  • ability to disable popups for certain status modes (e.g. if you don't want notifications when you set your status to Not available).
  • ability to configure notifications depending on the status of the message window (e.g. do not show them when the message window is in the foreground, but show them when it is minimized to the task bar). This setting can be configured on a "per container" basis (see containers for more info).
  • customizable "click actions" for left and right mouse clicks on the notification popup.
  • customizable layout for the notification contents (e.g. show a preview of the message, timestamp etc.).
  • automatically remove popups when the message window is restored on the desktop or when you start typing the reply.
  • customize the background colors
  • customize timeout periods (notification popups will automatically disappear after the specified time).