pidgin 2.14.14dev
|
Server API. More...
Go to the source code of this file.
Functions | |
unsigned int | serv_send_typing (PurpleConnection *gc, const char *name, PurpleTypingState state) |
Send a typing message to a given user over a given connection. | |
void | serv_move_buddy (PurpleBuddy *, PurpleGroup *, PurpleGroup *) |
int | serv_send_im (PurpleConnection *, const char *, const char *, PurpleMessageFlags flags) |
PurpleAttentionType * | purple_get_attention_type_from_code (PurpleAccount *account, guint type_code) |
Get information about an account's attention commands, from the prpl. | |
void | serv_send_attention (PurpleConnection *gc, const char *who, guint type_code) |
Send an attention request message. | |
void | serv_got_attention (PurpleConnection *gc, const char *who, guint type_code) |
Process an incoming attention message. | |
void | serv_get_info (PurpleConnection *, const char *) |
void | serv_set_info (PurpleConnection *, const char *) |
void | serv_add_permit (PurpleConnection *, const char *) |
void | serv_add_deny (PurpleConnection *, const char *) |
void | serv_rem_permit (PurpleConnection *, const char *) |
void | serv_rem_deny (PurpleConnection *, const char *) |
void | serv_set_permit_deny (PurpleConnection *) |
void | serv_chat_invite (PurpleConnection *, int, const char *, const char *) |
void | serv_chat_leave (PurpleConnection *, int) |
void | serv_chat_whisper (PurpleConnection *, int, const char *, const char *) |
int | serv_chat_send (PurpleConnection *, int, const char *, PurpleMessageFlags flags) |
void | serv_alias_buddy (PurpleBuddy *) |
void | serv_got_alias (PurpleConnection *gc, const char *who, const char *alias) |
void | purple_serv_got_private_alias (PurpleConnection *gc, const char *who, const char *alias) |
A protocol plugin should call this when it retrieves a private alias from the server. | |
void | serv_got_typing (PurpleConnection *gc, const char *name, int timeout, PurpleTypingState state) |
Receive a typing message from a remote user. | |
void | serv_got_typing_stopped (PurpleConnection *gc, const char *name) |
TODO: Could probably move this into the conversation API. | |
void | serv_got_im (PurpleConnection *gc, const char *who, const char *msg, PurpleMessageFlags flags, time_t mtime) |
void | serv_join_chat (PurpleConnection *, GHashTable *data) |
void | serv_reject_chat (PurpleConnection *, GHashTable *data) |
void | serv_got_chat_invite (PurpleConnection *gc, const char *name, const char *who, const char *message, GHashTable *data) |
Called by a prpl when an account is invited into a chat. | |
PurpleConversation * | serv_got_joined_chat (PurpleConnection *gc, int id, const char *name) |
Called by a prpl when an account has joined a chat. | |
void | purple_serv_got_join_chat_failed (PurpleConnection *gc, GHashTable *data) |
Called by a prpl when an attempt to join a chat via serv_join_chat() fails. | |
void | serv_got_chat_left (PurpleConnection *g, int id) |
Called by a prpl when an account has left a chat. | |
void | serv_got_chat_in (PurpleConnection *g, int id, const char *who, PurpleMessageFlags flags, const char *message, time_t mtime) |
Called by a prpl when a message has been received in a chat. | |
void | serv_send_file (PurpleConnection *gc, const char *who, const char *file) |
void | serv_chat_send_file (PurpleConnection *gc, int id, const char *file) |
Server API.
Definition in file server.h.
PurpleAttentionType * purple_get_attention_type_from_code | ( | PurpleAccount * | account, |
guint | type_code | ||
) |
Get information about an account's attention commands, from the prpl.
void purple_serv_got_join_chat_failed | ( | PurpleConnection * | gc, |
GHashTable * | data | ||
) |
Called by a prpl when an attempt to join a chat via serv_join_chat() fails.
gc | The connection on which chat joining failed |
data | The components passed to serv_join_chat() originally. The hash function should be g_str_hash() and the equal function should be g_str_equal(). |
void purple_serv_got_private_alias | ( | PurpleConnection * | gc, |
const char * | who, | ||
const char * | alias | ||
) |
A protocol plugin should call this when it retrieves a private alias from the server.
Private aliases are the aliases the user sets, while public aliases are the aliases or display names that buddies set for themselves.
gc | The connection on which the alias was received. |
who | The name of the buddy whose alias was received. |
alias | The alias that was received. |
void serv_got_attention | ( | PurpleConnection * | gc, |
const char * | who, | ||
guint | type_code | ||
) |
Process an incoming attention message.
gc | The connection that received the attention message. |
who | Who requested your attention. |
type_code | An index into the prpl's attention_types list determining the type of the attention request command to send. |
void serv_got_chat_in | ( | PurpleConnection * | g, |
int | id, | ||
const char * | who, | ||
PurpleMessageFlags | flags, | ||
const char * | message, | ||
time_t | mtime | ||
) |
Called by a prpl when a message has been received in a chat.
g | The connection on which the message was received. |
id | The id of the chat, as assigned by the prpl. |
who | The name of the user who sent the message. |
flags | The flags of the message. |
message | The message received in the chat. |
mtime | The time when the message was received. |
void serv_got_chat_invite | ( | PurpleConnection * | gc, |
const char * | name, | ||
const char * | who, | ||
const char * | message, | ||
GHashTable * | data | ||
) |
Called by a prpl when an account is invited into a chat.
gc | The connection on which the invite arrived. |
name | The name of the chat you're being invited to. |
who | The username of the person inviting the account. |
message | The optional invite message. |
data | The components necessary if you want to call serv_join_chat(). The hash function should be g_str_hash() and the equal function should be g_str_equal(). |
void serv_got_chat_left | ( | PurpleConnection * | g, |
int | id | ||
) |
Called by a prpl when an account has left a chat.
g | The connection on which the chat was left. |
id | The id of the chat, as assigned by the prpl. |
PurpleConversation * serv_got_joined_chat | ( | PurpleConnection * | gc, |
int | id, | ||
const char * | name | ||
) |
Called by a prpl when an account has joined a chat.
gc | The connection on which the chat was joined. |
id | The id of the chat, assigned by the prpl. |
name | The name of the chat. |
void serv_got_typing | ( | PurpleConnection * | gc, |
const char * | name, | ||
int | timeout, | ||
PurpleTypingState | state | ||
) |
Receive a typing message from a remote user.
Either PURPLE_TYPING or PURPLE_TYPED. If the user has stopped typing then use serv_got_typing_stopped instead.
TODO: Could probably move this into the conversation API.
gc | The connection on which the typing message was received. |
name | The name of the remote user. |
timeout | If this is a number greater than 0, then Purple will wait this number of seconds and then set this buddy to the PURPLE_NOT_TYPING state. This is used by protocols that send repeated typing messages while the user is composing the message. |
state | The typing state received |
void serv_join_chat | ( | PurpleConnection * | , |
GHashTable * | data | ||
) |
data | The hash function should be g_str_hash() and the equal function should be g_str_equal(). |
void serv_reject_chat | ( | PurpleConnection * | , |
GHashTable * | data | ||
) |
data | The hash function should be g_str_hash() and the equal function should be g_str_equal(). |
void serv_send_attention | ( | PurpleConnection * | gc, |
const char * | who, | ||
guint | type_code | ||
) |
Send an attention request message.
gc | The connection to send the message on. |
who | Whose attention to request. |
type_code | An index into the prpl's attention_types list determining the type of the attention request command to send. 0 if prpl only defines one, but protocols are allowed to define more. |
Note that you can't send arbitrary PurpleAttentionType's, because there is only a fixed set of attention commands.
unsigned int serv_send_typing | ( | PurpleConnection * | gc, |
const char * | name, | ||
PurpleTypingState | state | ||
) |
Send a typing message to a given user over a given connection.
TODO: Could probably move this into the conversation API.
gc | The connection over which to send the typing notification. |
name | The user to send the typing notification to. |
state | One of PURPLE_TYPING, PURPLE_TYPED, or PURPLE_NOT_TYPING. |