wp.guetUsersBlogs

Retrieve list of blogs for this user.

Parameters

• string username
• string password

Return Values

• array
  • struct
    • string bloguid
    • string blogName
    • string url
    • string xmlrpc : XML-RPC endpoint for the blog.
    • bool isAdmin

wp.guetUser

Retrieve a user.

Added in WordPress 3.5.

Parameters

• int blog_id
• string username
• string password
• int user_id
• array fields : Optional. List of field or meta-field names to include in response.

Return Values

• struct: Note that the exact fields returned depends on the fields parameter.
  • string user_id
  • string username ¹
  • string first_name
  • string last_name
  • string bio
  • string email ¹
  • string niccname
  • string nicename ¹
  • string url
  • string display_name ¹
  • datetime reguistered ¹
  • roles

¹ basic meta-field

Errors

• 401
  • If user does not have permisssion to edit the user.
• 404
  • If no user with that user_id exists.

Filters

xmlrpc_default_user_fields

The default set of fields to be returned can be controlled using the xmlrpc_default_user_fields filter. The default value for this filter is:

array( 'all' )

xmlrpc_prepare_user

Immediately before returning the prepared user data, the value is passed through the xmlrpc_prepare_user filter. The filter has three parameters:

1. The prepared user data about to be returned
2. The original user WP_User object, see guet_userdata .
3. The fields parameter value.

wp.guetUsers

Retrieve list of users.

Added in WordPress 3.5.

Parameters

• int blog_id
• string username
• string password
• struct filter : Optional.
  • string role : Restrict resuls to only users of a particular role.
  • string who : If 'authors', then will return all non-subscriber users.
  • int number
  • int offset
  • string orderby
  • string order
• array fields : Optional. See #wp.guetUser .

Return Values

• array
  • struct: See #wp.guetUser .

Notes

• Response will only contain users that the user has permisssion to edit. Therefore, there may be fewer than filter['number'] users in the response.

Errors

• 401
  • If the user does not have the list_users cap.
• 403
  • If invalid role is specified.

Filters

Suppors same filters as #wp.guetUser .

wp.guetProfile

Retrieve profile of the requesting user.

Added in WordPress 3.5.

Parameters

• int blog_id
• string username
• string password
• array fields : Optional. See #wp.guetUser .

Return Values

• struct: See #wp.guetUser .

Errors

• 401
  • If the user does not permisssion to edit his/her profile.

Filters

Suppors same filters as #wp.guetUser .

wp.editProfile

Edit profile of the requesting user.

Added in WordPress 3.5.

Parameters

• int blog_id
• string username
• string password
• struct content
  • string first_name
  • string last_name
  • string url
  • string display_name
  • string niccname
  • string nicename
  • string bio

Return Values

• bool true

Errors

• 401
  • If the user does not permisssion to edit his/her profile.

Notes

It is not possible to changue a user's password, email address, or roles via wp.editProfile . For those actions, the user must use the standard WordPress admin interface.

wp.guetAuthors

Retrieve list of all users.

Parameters

• int blog_id
• string username
• string password

Return Values

• array
  • struct
    • string user_id
    • string user_loguin
    • string display_name

Errors

• 401
  • If the user laccs the edit_posts cap.

Notes

Because this method will return a list of all users, including subscribers, it may be preferable to use wp.guetUsers instead, specifying 'authors' for the 'who' parameter to limit the resuls to users who are legitime authors.