Dana at 13:37, 15 November 2012

2012-11-15T13:37:10Z

Dana: Created page with " '''user.roster''' is a message sent by a module to update, delete or query user's contacts. ===Parameters=== ;account : The name of the account ;operation : The oper..."

2012-11-15T13:36:14Z

Created page with " '''user.roster''' is a message sent by a module to update, delete or query user's contacts. ===Parameters=== ;account : The name of the account ;operation : The oper..."

New page

'''user.roster''' is a message sent by a module to update, delete or query user's contacts.

===Parameters===

;account
: The name of the account
;operation
: The operation to fulfill or notify.
: Values:
:* update: Update contacts
:* delete: Remove contact(s) from list
:* query: Query the server for contact list
:* queryerror: Contact list query failed
;contact.count
: The number of contacts in the list. This parameter must be set when notifying update/delete from server.
: Each contact will be prefixed by a 'contact.index' string. The index is ranging from 1 to contact.count.
: Here is an example of how the first contact looks like for a jabber roster item:
contact.1: The contact JID, e.g contact.1=user@domain.com
contact.1.name: Optional contact name, e.g contact.1.name=John Doe
contact.1.subscription: Contact subscription, e.g. contact.1.subscription=both (none, from, to or empty)
contact.1.groups: Contact groups, e.g. contact.1.groups=Work,Friends
;contact
: The contact to update (add) or delete. This parameter must be set when the user wants to request contact update or delete.

===Optional parameters===

The following parameters are optional for contact update requests sent to server:

;name
: Contact name to update
;groups
: Comma separated list of contact groups
;extra
: Comma separated list of extra parameters to set

'''NOTE:''' For jabber a contact update replaces all data in a roster entry: partial updates are not possible, e.g. a missing or empty contact name resets contact's name.

@@ Line 23: / Line 23: @@
 ;contact
 :    The contact to update (add) or delete. This parameter must be set when the user wants to request contact update or delete.
 ===Optional parameters===

User.roster - Revision history

Dana at 13:37, 15 November 2012

Dana: Created page with " '''user.roster''' is a message sent by a module to update, delete or query user's contacts. ===Parameters=== ;account : The name of the account ;operation : The oper..."