Jabber Message Rules

Unique to Jabber is the ability to setup message rules. Message rules allow incoming messages to be handled differently based upon criteria such as current presence status; message type; incoming message type, subject, sender or receiver. The current interface in Gabber for message rule editing is designed for quick editing and is not the final interface for rule editing. To access the Jabber Message Rules List dialog, select Jabber Message Rules... from the Services menu.

The Jabber Message Rules List dialog is largely self-explanatory. A rule is listed by an arbitrary title in the main list and can be set to a higher or lower priority with the Up and Down buttons. A rule can be edited or removed with the Edit... and Remove buttons. Since the edit rule dialog is the same as the add rule dialog, it will not be explained. After all edits to the rules are completed (including adding, removing and changing the priority), click the Save Changes button and then close the dialog.

Jabber Message Rules are stored on the server and are processed entirely by the server. Because of this, a Jabber client does not need to support Jabber Message Rules to be affected by them. Also, some rules will be processed even while the user is not connected to the Jabber server.

Adding a Jabber Message Rule

To add a new rule, click the Add... button on the Jabber Message Rules List to bring up the Add a Jabber Message Rule dialog. First, enter a unique identifying name for the rule in the rule name text box. Then add at least one condition for the rule to be enacted upon by clicking the Add button in the Condition area. A blank condition will appear to allow editing or removal. Simply set the drop down box to the desired condition and if necessary, type a string in the text box next to the selection box. For instance, if the rule is "If the message is from..." then the user's JID (e.g., user@host) would be typed in the text box.

The following is a current list of options for "my status is..." and "the message type is..." These are actual pieces of the Jabber protocol and must be entered exactly as shown.

Status Types

away

Away

chat

Chatty

xa

Not Available

dnd

Do Not Disturb

Message Types

normal

A "normal" message, see the section called Normal Messages.

chat

An One-on-One chat message, see the section called One-on-One Chats.

groupchat

A groupchat message, see the section called Group Chats.

headline

A headline message. There is not currently an interface in Gabber to handle headline messages properly.



After selecting at least one condition for the rule to be acted upon (more than one condition can be specified), actions can be added. Adding an action works the same way as adding a condition. Message types are the same as above and when forwarding a message, a valid JID must be entered. Again, multiple actions may be entered.

To remove any condition or action, simply click the Remove button to the right of the condition or action.