This is a page for documenting the notifications from Chat Core in Thunderbird. This is likely out of date. Notifications are grouped by interface you need to attach the observer to.
{% hint style="warning" %} Draft: This page is not complete. {% endhint %}
| Topic | Subject | Data | Added | Comment |
|---|---|---|---|---|
| account-added | imIAccount | null | <1.0 | a new account has been created |
| account-connected | imIAccount | null | <1.0 | the account has connected |
| account-connecting | imIAccount | null | <1.0 | the account has started a connection attempt |
| account-connect-error | imIAccount | null | <1.0 | the account has disconnecting with an error |
| account-connect-progress | imIAccount | null | <1.0 | the account is attempting to connect |
| account-disconnected | imIAccount | null | <1.0 | the account has disconnected |
| account-disconnecting | imIAccount | null | <1.0 | the account is disconnecting without an error reason |
| account-list-updated | imIAccountsService | null | <1.0 | the list of accounts has been updated |
| account-removed | imIAccount | null | <1.0 | an account is about to be removed |
| account-updated | imIAccount | null | <1.0 | |
| app-handler-pane-loaded | nsIDOMWindow | null | <1.0 | Applications pane in preferences window is loaded |
| autologin-processed | imICoreService | null | <1.0 | imICoreService::processAutoLogin() is complete |
| browser-request | prplIRequestBrowser | null | <1.0 | Used by protocol plugins to bring up a browser window (e.g. for an OAuth request) |
| closing-conversation | prplIConversation | null | <1.0 | |
| contact-moved | imIContactsService |
null | <1.0 | when a contact has been moved (removed from one tag, added to another, or both) |
| contact-tag-added | imIContact | tag.id | <1.0 | when a tag is added to a contact |
| contact-tag-removed | imIContact | tag.id | <1.0 | when a tag is removed from a contact |
| conversation-closed | prplIConversation | null | <1.0 | conversation going away |
| conversation-left-chat | prplIConversation | null | <1.0 | the user has left the conversation (but it might remain visible) |
| conversation-loaded | nsISupports | null or details | <1.0 | subject is a <browser type="content-conversation">, if fired because an existing conversation is moved from one window to another, the data parameter ("details") will contain the string "imported". |
| im-sent | prplIConversation | message text | <1.0 | on sending an IM (whether or not it succeeded) |
| new-conversation | prplIConversation | null | <1.0 | conversation created |
| new-ui-conversation | imIConversation | null | <1.0 | |
| prpl-quit | imICoreService | null | 1.2 | Core shutdown, was previously purple-quit |
| status-changed | imICoreService | status text | <1.0 | user (not buddy) status change |
| tag-hidden | imITag | null | <1.0 | fired when a tag is hidden |
| tag-shown | imITag | null | <1.0 | fired when a tag is set to be shown (unhiding it) |
| ui-conversation-closed | null | <1.0 | ||
| unread-im-count-changed | count of unread messages | <1.0 | fired when the number of unread messages changes | |
| new-text | imIMessage | null | 1.5 | New message is about to be displayed. |
| new-directed-incoming-message | imIMessage | null | 1.5 | New incoming message that is either a direct message or highlights the user. |
| ui-conversation-replaced | imIConversation | null | 91 | The subject UI conversation is about to be replaced by a new instance (with different interfaces but the same ID). |
| conversation-update-type | imIConversation | null | 91 | The type of the underlying prplIConversation has changed. Is always preceded by a ui-conversation-replaced notification that disposes of the old UIConversation instance, while this will have the new one as subject. |
| account-sessions-changed | imIAccount | null | 91 | The account session list has changed |
| account-encryption-status-changed | imIAccount | null | 91 | The account encryption status info has changed |
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| account-buddy-availability-changed | prplIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-display-name-changed | imIContactsService |
old serverAlias | <1.0 | Fired when setting imIAccountBuddy::serverAlias |
| account-buddy-icon-changed | imIAccountBuddy | null | <1.0 | Fired when setting imIAccountBuddy::buddyIconFilename |
| account-buddy-signed-off | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-signed-on | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| account-buddy-status-changed | imIAccountBuddy | null | <1.0 | Possibly fired on account buddy status change |
| buddy-added | imIBuddy | null | <1.0 | In response to account-buddy-added if the buddy previously had no account buddies |
| buddy-availability-changed | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-display-name-changed | imIBuddy | old serverAlias | <1.0 | possibly in response to account-buddy-display-name-changed on the preferred account |
| buddy-preferred-account-changed | null | <1.0 | when setting imIBuddy::preferredAccountBuddy (internally) | |
| buddy-removed | imIBuddy | null | <1.0 | In response to account-buddy-removed if the buddy no longer has any account buddies |
| buddy-signed-off | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-signed-on | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates |
| buddy-status-changed | imIBuddy | null | <1.0 | possibly fired on imIBuddy status updates |
Note: all imIContact notifications also go to any imITag it belongs to, as well as nsIObserverService.
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| contact-added | imIContact | null | <1.0 | When a new buddy is created with no other contact |
| contact-availability-changed | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-display-name-changed | imIContact | null | <1.0 | Fired on setting imIContact::Alias or imIContact::preferredBuddy, or the preferred buddy's display name changed |
| contact-no-longer-dummy | imIContact | null | <1.0 | Fired when a contact is being loaded? |
| contact-preferred-buddy-changed | imIContact | null | <1.0 | Fired on setting imIContact::preferredBuddy |
| contact-removed | imIContact | null | <1.0 | When the last buddy for the contact is removed |
| contact-signed-off | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-signed-on | imIContact | null | <1.0 | Possibly fired on contact status updates |
| contact-status-changed | imIContact | null | <1.0 | Possibly fired on contact status updates |
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| contact-moved-in | imIContact | null | <1.0 | When a contact has been moved into the tag |
| contact-moved-out | imIContact | null | <1.0 | When a contact has been moved out of the tag |
| tag-hidden | imIContact | null | <1.0 | fired when a tag is hidden |
| tag-shown | imIContact | null | <1.0 | fired when a tag is set to be shown (unhiding it) |
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| chat-buddy-add | nsISimpleEnumerator | null | <1.0 | When users join a chat. The enumerator elements are prplIConvChatBuddy. |
| chat-buddy-removed | nsISimpleEnumerator | null | <1.0 | When chat buddies leave a chat. The enumerator elements are nsISupportsString of the user name. |
| chat-buddy-update | prplIConvChatBuddy | old name, if the chat buddy is being renamed | <1.0 | data is null if this is not a rename |
| chat-buddy-topic | null | <1.0 | The chat topic was updated | |
| new-text | prplIMessage | null | <1.0 | A new message will be written to a conversation. This can be an incoming, outgoing or system message. Subject was purpleIMessage until 1.2. |
| update-text | prplIMessage | null | 91 | An existing message is updated based on the remoteId of the message. |
| update-buddy-status | null | <1.0 | away-ness or online/offline | |
| update-conv-chatleft | null | <1.0 | the user has left the chat (it might remain visible) | |
| update-conv-title | null | <1.0 | ||
| update-typing | null | <1.0 | ||
| preparing-message | imIOutgoingMessage | null | 1.5 | Outgoing message before it's been prepared for sending by the protocol |
| sending-message | imIOutgoingMessage | null | 1.5 | Outgoing message was prepared (and potentially split into multiple messages) and will be sent by the protocol after this observer. |
| chat-update-type | null | null | 91 | Conversation changed between being a chat and a direct message conv (isChat toggled). |
| update-conv-icon | prplIConversation | null | 91 | The convIconFilename of the conversation changed. |
| update-conv-encryption | prplIConversation | null | 91 | The encryptionState of the conversation changed. |
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| received-message | imIMessage | null | 1.5 | New message is about to be prepared for display. |
| new-text | imIMessage | null | 1.5 | New message is about to be displayed. (Before 1.5 probably just passed along the prplIMessage) |
| new-directed-incoming-message | imIMessage | null | 1.5 | New incoming message that is either a direct message or highlights the user. |
| Topic | Subject | Data | Added | Notes |
|---|---|---|---|---|
| status-changed | imIUserStatusInfo | Status Text (string) | ? | |
| user-icon-changed | imIUserStatusInfo | New icon file name (string) | ? | |
| user-display-name-changed | imIUserStatusInfo | New display name (string) | ? | |
| idle-time-changed | imIUserStatusInfo | New idle time (number) | ? |