Title: Conversation Signals
Slug: conversation-signals
* [
writing-im-msg](
#writing-im-msg)
* [
wrote-im-msg](
#wrote-im-msg)
* [
sending-im-msg](
#sending-im-msg)
* [
sent-im-msg](
#sent-im-msg)
* [
receiving-im-msg](
#receiving-im-msg)
* [
received-im-msg](
#received-im-msg)
* [
blocked-im-msg](
#blocked-im-msg)
* [
writing-chat-msg](
#writing-chat-msg)
* [
wrote-chat-msg](
#wrote-chat-msg)
* [
sending-chat-msg](
#sending-chat-msg)
* [
sent-chat-msg](
#sent-chat-msg)
* [
receiving-chat-msg](
#receiving-chat-msg)
* [
received-chat-msg](
#received-chat-msg)
* [
conversation-created](
#conversation-created)
* [
conversation-updated](
#conversation-updated)
* [
deleting-conversation](
#deleting-conversation)
* [
buddy-typing](
#buddy-typing)
* [
buddy-typing-stopped](
#buddy-typing-stopped)
* [
chat-user-joining](
#chat-user-joining)
* [
chat-user-joined](
#chat-user-joined)
* [
chat-user-flags](
#chat-user-flags)
* [
chat-user-leaving](
#chat-user-leaving)
* [
chat-user-left](
#chat-user-left)
* [
chat-inviting-user](
#chat-inviting-user)
* [
chat-invited-user](
#chat-invited-user)
* [
chat-invited](
#chat-invited)
* [
chat-invite-blocked](
#chat-invite-blocked)
* [
chat-joined](
#chat-joined)
* [
chat-join-failed](
#chat-join-failed)
* [
chat-left](
#chat-left)
* [
chat-topic-changed](
#chat-topic-changed)
* [
cleared-message-history](
#cleared-message-history)
* [
conversation-extended-menu](
#conversation-extended-menu)
* [
sent-attention](
#sent-attention)
* [
got-attention](
#got-attention)
gboolean user_function(PurpleAccount *account, PurpleIMConversation *im, PurpleMessageFlags flags, Emitted before a message is written in an IM conversation. If the message is changed, then the changed message is displayed and logged instead of the original message.
> Make sure to free `*message` before you replace it. : A pointer to the message.
: Flags for this message.
: user data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
void user_function(PurpleAccount *account, PurpleIMConversation *im, PurpleMessageFlags flags, Emitted after a message is written and possibly displayed in a conversation.
: Flags for this message.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, Emitted before sending an IM to a user.
`message` is a pointer to the message
string, so the plugin can replace the message before being sent.
> Make sure to free `*message` before you replace it! : The account the message is being sent on.
: The username of the receiver.
: A pointer to the outgoing message. This can be modified.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, Emitted after sending an IM to a user.
: The account the message was sent on.
: The username of the receiver.
: The message that was sent.
: user data set when the signal handler was connected.
gboolean user_function(PurpleAccount *account, PurpleIMConversation *im, PurpleMessageFlags *flags, Emitted when an IM is received. The callback can replace the name of the sender, the message, or the flags by modifying the pointer to the strings and integer. This can also be used to cancel a message by returning
`TRUE`.
> Make sure to free `*sender` and `*message` before you replace them! : The account the message was received on.
: A pointer to the username of the sender.
: A pointer to the message that was sent.
: A pointer to the IM message flags.
: user data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
void user_function(PurpleAccount *account, PurpleIMConversation *im, PurpleMessageFlags flags, Emitted after an IM is received.
: The account the message was received on.
: The username of the sender.
: The message that was sent.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, PurpleMessageFlags flags, Emitted after an IM is blocked due to privacy settings.
: The account the message was received on.
: The username of the sender.
: The message that was blocked.
: The time the message was sent.
: user data set when the signal handler was connected.
gboolean user_function(PurpleAccount *account, PurpleChatConversation *chat, PurpleMessageFlags flags, Emitted before a message is written in a chat conversation. If the message is changed, then the changed message is displayed and logged instead of the original message.
> Make sure to free `*message` before you replace it! : A pointer to the message.
: Flags for this message.
: user data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
void user_function(PurpleAccount *account, PurpleChatConversation *chat, PurpleMessageFlags flags, Emitted after a message is written and possibly displayed in a chat.
: Flags for this message.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, Emitted before sending a message to a chat.
`message` is a pointer to the
message string, so the plugin can replace the message before being sent.
> Make sure to free `*message` before you replace it! : The account the message is being sent on.
: A pointer to the message that will be sent.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, Emitted after sending a message to a chat.
: The account the message was sent on.
: The message that was sent.
: user data set when the signal handler was connected.
gboolean user_function(PurpleAccount *account, PurpleChatConversation *chat, Emitted when a chat message is received. The callback can replace the name of the sender, the message, or the flags by modifying the pointer to the strings. This can also be used to cancel displaying a message by returning
`TRUE`.
> Make sure to free `*sender` and `*message` before you replace them! : The account the message was received on.
: A pointer to the username of the sender.
: A pointer to the message that was sent.
: A pointer to the chat message flags.
: user data set when the signal handler was connected.
`TRUE` if the message should be canceled, or
`FALSE` otherwise.
void user_function(PurpleAccount *account, PurpleChatConversation *chat, PurpleMessageFlags flags, Emitted after a chat message is received.
: The account the message was received on.
: The username of the sender.
: The message that was sent.
: The chat message flags.
: user data set when the signal handler was connected.
#### conversation-created void user_function(PurpleConversation *conv, gpointer user_data); Emitted when a new conversation is created.
: user data set when the signal handler was connected.
#### conversation-updated void user_function(PurpleConversation *conv, PurpleConvUpdateType type, Emitted when a conversation is updated.
: The conversation that was updated.
: The type of update that was made.
: user data set when the signal handler was connected.
#### deleting-conversation void user_function(PurpleConversation *conv, gpointer user_data); Emitted just before a conversation is to be destroyed.
: The conversation that's about to be destroyed.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, Emitted when a buddy starts typing in a conversation window.
: The account of the user which is typing.
: The name of the user which is typing.
: user data set when the signal handler was connected.
#### buddy-typing-stopped void user_function(PurpleAccount *account, Emitted when a buddy stops typing in a conversation window.
: The account of the user which stopped typing.
: The name of the user which stopped typing.
: user data set when the signal handler was connected.
gboolean user_function(PurpleChatConversation *chat, PurpleChatUserFlags flags, Emitted when a buddy is joining a chat, before the list of users in the chat updates to include the new user.
: The name of the user that is joining the conversation.
: The flags of the user that is joining the conversation.
: user data set when the signal handler was connected.
`TRUE` if the join should be hidden, or
`FALSE` otherwise.
void user_function(PurpleChatConversation *chat, PurpleChatUserFlags flags, Emitted when a buddy joined a chat, after the users list is updated.
: The name of the user that has joined the conversation.
: The flags of the user that has joined the conversation.
: If the buddy is a new arrival.
: user data set when the signal handler was connected.
void user_function(PurpleConnection *gc, Emitted when an account fails to join a chat room.
: The PurpleConnection of the account which failed to join the chat.
: The components passed to purple_serv_join_chat() originally. The hash function should be g
_str_hash() and the equal function should be g
_str_equal().
: user data set when the signal handler was connected.
void user_function(PurpleChatUser *chatuser, PurpleChatUserFlags oldflags, PurpleChatUserFlags newflags, Emitted when a user in a chat changes flags.
: The chat user whose flags changed.
: user data set when the signal handler was connected.
gboolean user_function(PurpleChatConversation *chat, Emitted when a user is leaving a chat, before the user list is updated. This
may include an optional reason why the user is leaving.
: The name of the user that is leaving the chat.
: The optional reason why the user is leaving.
: user data set when the signal handler was connected.
`TRUE` if the leave should be hidden, or
`FALSE` otherwise.
void user_function(PurpleChatConversation *chat, Emitted when a user leaves a chat, after the user list is updated. This may include an optional reason why the user is leaving.
: The name of the user that left the chat.
: The optional reason why the user left the chat.
: user data set when the signal handler was connected.
void user_function(PurpleChatConversation *chat, Emitted when a user is being invited to the chat. The callback can replace the invite message to the invitee by modifying the pointer to the invite message.
> Make sure to free `*invite_message` before you replace it! : The name of the user being invited.
: A pointer to the reason why a user is being invited.
: user data set when the signal handler was connected.
void user_function(PurpleChatConversation *conv, const gchar *invite_message, Emitted when a user invited another user to a chat.
: The name of the user that was invited.
: The message to be sent to the user when invited.
: user data set when the signal handler was connected.
gint user_function(PurpleAccount *account, const gchar *invite_message, Emitted when an account was invited to a chat.
: The account being invited.
: The username of the person inviting the account.
: The name of the chat you're being invited to.
: The optional invite message.
: The components necessary if you want to call purple_serv_join_chat().
: user data set when the signal handler was connected.
Less than zero if the invitation should be rejected, greater than zero if the
invitation should be accepted. If zero is returned, the default behavior will
be maintained: the user will be prompted.
void user_function(PurpleAccount *account, Emitted when an invitation to join a chat is blocked.
: The account the invitation was sent to.
: The name of the person sending the invitation.
: The name of the chat invited to.
: The invitation message sent.
: Hashtable containing data about the invited chat.
void user_function(PurpleChatConversation *chat, gpointer user_data); Emitted when an account joins a chat room.
: The conversation that joined the chat room.
: user data set when the signal handler was connected.
void user_function(PurpleChatConversation *chat, gpointer user_data); Emitted when an account leaves a chat room.
: The conversation that left the chat room.
: user data set when the signal handler was connected.
void user_function(PurpleChatConversation *chat, Emitted when the topic is changed in a chat.
: The chat conversation whose topic changed.
: The name of the person that changed the topic.
: user data set when the signal handler was connected.
#### conversation-extended-menu void user_function(PurpleConversation *conv, Emitted when the UI requests a list of plugin actions for a conversation.
: A pointer to the list of actions.
: user data set when the signal handler was connected.
#### cleared-message-history void user_function(PurpleConversation *conv, gpointer user_data); Emitted when the conversation history is cleared.
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, PurpleConversation *conv, Emitted when receiving an attention message (buzz, nudge, etc.).
: The name of the person receiving the attention.
: The attention type (an index starting at 0).
: user data set when the signal handler was connected.
void user_function(PurpleAccount *account, PurpleConversation *conv, Emitted when receiving an attention message (buzz, nudge, etc.).
: The name of the person sending the attention.
: The attention type (an index starting at 0).
: user data set when the signal handler was connected.