[ Index ]

WordPress Cross Reference

title

Body

[close]

/wp-includes/ -> class-wp-xmlrpc-server.php (summary)

XML-RPC protocol support for WordPress

File Size: 5524 lines (164 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

wp_xmlrpc_server:: (100 methods):
  __construct()
  serve_request()
  sayHello()
  addTwoNumbers()
  login()
  login_pass_ok()
  escape()
  get_custom_fields()
  set_custom_fields()
  initialise_blog_option_info()
  wp_getUsersBlogs()
  minimum_args()
  _prepare_taxonomy()
  _prepare_term()
  _convert_date()
  _convert_date_gmt()
  _prepare_post()
  _prepare_post_type()
  _prepare_media_item()
  _prepare_page()
  _prepare_comment()
  _prepare_user()
  wp_newPost()
  _is_greater_than_one()
  _insert_post()
  wp_editPost()
  wp_deletePost()
  wp_getPost()
  wp_getPosts()
  wp_newTerm()
  wp_editTerm()
  wp_deleteTerm()
  wp_getTerm()
  wp_getTerms()
  wp_getTaxonomy()
  wp_getTaxonomies()
  wp_getUser()
  wp_getUsers()
  wp_getProfile()
  wp_editProfile()
  wp_getPage()
  wp_getPages()
  wp_newPage()
  wp_deletePage()
  wp_editPage()
  wp_getPageList()
  wp_getAuthors()
  wp_getTags()
  wp_newCategory()
  wp_deleteCategory()
  wp_suggestCategories()
  wp_getComment()
  wp_getComments()
  wp_deleteComment()
  wp_editComment()
  wp_newComment()
  wp_getCommentStatusList()
  wp_getCommentCount()
  wp_getPostStatusList()
  wp_getPageStatusList()
  wp_getPageTemplates()
  wp_getOptions()
  _getOptions()
  wp_setOptions()
  wp_getMediaItem()
  wp_getMediaLibrary()
  wp_getPostFormats()
  wp_getPostType()
  wp_getPostTypes()
  wp_getRevisions()
  wp_restoreRevision()
  blogger_getUsersBlogs()
  _multisite_getUsersBlogs()
  blogger_getUserInfo()
  blogger_getPost()
  blogger_getRecentPosts()
  blogger_getTemplate()
  blogger_setTemplate()
  blogger_newPost()
  blogger_editPost()
  blogger_deletePost()
  mw_newPost()
  add_enclosure_if_new()
  attach_uploads()
  mw_editPost()
  mw_getPost()
  mw_getRecentPosts()
  mw_getCategories()
  mw_newMediaObject()
  mt_getRecentPostTitles()
  mt_getCategoryList()
  mt_getPostCategories()
  mt_setPostCategories()
  mt_supportedMethods()
  mt_supportedTextFilters()
  mt_getTrackbackPings()
  mt_publishPost()
  pingback_ping()
  pingback_extensions_getPingbacks()
  pingback_error()


Class: wp_xmlrpc_server  - X-Ref

WordPress XMLRPC server implementation.

Implements compatibility for Blogger API, MetaWeblog API, MovableType, and
pingback. Additional WordPress API for managing comments, pages, posts,
options, etc.

As of WordPress 3.5.0, XML-RPC is enabled by default. It can be disabled
via the xmlrpc_enabled filter found in wp_xmlrpc_server::login().

__construct()   X-Ref
Register all of the XMLRPC methods that XMLRPC server understands.

Sets up server and method property. Passes XMLRPC
methods through the 'xmlrpc_methods' filter to allow plugins to extend
or replace XMLRPC methods.

return: wp_xmlrpc_server

serve_request()   X-Ref
No description

sayHello($args)   X-Ref
Test XMLRPC API by saying, "Hello!" to client.

param: array $args Method Parameters.
return: string

addTwoNumbers($args)   X-Ref
Test XMLRPC API by adding two numbers for client.

param: array $args Method Parameters.
return: int

login( $username, $password )   X-Ref
Log user in.

param: string $username User's username.
param: string $password User's password.
return: mixed WP_User object if authentication passed, false otherwise

login_pass_ok( $username, $password )   X-Ref
Check user's credentials. Deprecated.

param: string $username User's username.
param: string $password User's password.
return: bool Whether authentication passed.

escape( &$data )   X-Ref
Escape string or array of strings for database.

param: string|array $data Escape single string or array of strings.
return: string|array Type matches $data and sanitized for the database.

get_custom_fields($post_id)   X-Ref
Retrieve custom fields for post.

param: int $post_id Post ID.
return: array Custom fields, if exist.

set_custom_fields($post_id, $fields)   X-Ref
Set custom fields for post.

param: int $post_id Post ID.
param: array $fields Custom fields.

initialise_blog_option_info()   X-Ref
Set up blog options property.

Passes property through 'xmlrpc_blog_options' filter.


wp_getUsersBlogs( $args )   X-Ref
Retrieve the blogs of the user.

param: array $args Method parameters. Contains:
return: array. Contains:

minimum_args( $args, $count )   X-Ref
Checks if the method received at least the minimum number of arguments.

param: string|array $args Sanitize single string or array of strings.
param: int $count Minimum number of arguments.
return: boolean if $args contains at least $count arguments.

_prepare_taxonomy( $taxonomy, $fields )   X-Ref
Prepares taxonomy data for return in an XML-RPC object.

param: object $taxonomy The unprepared taxonomy data
param: array $fields The subset of taxonomy fields to return
return: array The prepared taxonomy data

_prepare_term( $term )   X-Ref
Prepares term data for return in an XML-RPC object.

param: array|object $term The unprepared term data
return: array The prepared term data

_convert_date( $date )   X-Ref
Convert a WordPress date string to an IXR_Date object.

param: string $date
return: IXR_Date

_convert_date_gmt( $date_gmt, $date )   X-Ref
Convert a WordPress GMT date string to an IXR_Date object.

param: string $date_gmt
param: string $date
return: IXR_Date

_prepare_post( $post, $fields )   X-Ref
Prepares post data for return in an XML-RPC object.

param: array $post The unprepared post data
param: array $fields The subset of post type fields to return
return: array The prepared post data

_prepare_post_type( $post_type, $fields )   X-Ref
Prepares post data for return in an XML-RPC object.

param: object $post_type Post type object
param: array $fields The subset of post fields to return
return: array The prepared post type data

_prepare_media_item( $media_item, $thumbnail_size = 'thumbnail' )   X-Ref
Prepares media item data for return in an XML-RPC object.

param: object $media_item The unprepared media item data
param: string $thumbnail_size The image size to use for the thumbnail URL
return: array The prepared media item data

_prepare_page( $page )   X-Ref
Prepares page data for return in an XML-RPC object.

param: object $page The unprepared page data
return: array The prepared page data

_prepare_comment( $comment )   X-Ref
Prepares comment data for return in an XML-RPC object.

param: object $comment The unprepared comment data
return: array The prepared comment data

_prepare_user( $user, $fields )   X-Ref
Prepares user data for return in an XML-RPC object.

param: WP_User $user The unprepared user object
param: array $fields The subset of user fields to return
return: array The prepared user data

wp_newPost( $args )   X-Ref
Create a new post for any registered post type.

param: array $args Method parameters. Contains:
return: string post_id

_is_greater_than_one( $count )   X-Ref
Helper method for filtering out elements from an array.

param: int $count Number to compare to one.

_insert_post( $user, $content_struct )   X-Ref
Helper method for wp_newPost and wp_editPost, containing shared logic.

param: WP_User $user The post author if post_author isn't set in $content_struct.
param: array $content_struct Post data to insert.

wp_editPost( $args )   X-Ref
Edit a post for any registered post type.

The $content_struct parameter only needs to contain fields that
should be changed. All other fields will retain their existing values.

param: array $args Method parameters. Contains:
return: true on success

wp_deletePost( $args )   X-Ref
Delete a post for any registered post type.

param: array $args Method parameters. Contains:
return: true on success

wp_getPost( $args )   X-Ref
Retrieve a post.

param: array $args Method parameters. Contains:
return: array contains (based on $fields parameter):

wp_getPosts( $args )   X-Ref
Retrieve posts.

param: array $args Method parameters. Contains:
return: array contains a collection of posts.

wp_newTerm( $args )   X-Ref
Create a new term.

param: array $args Method parameters. Contains:
return: string term_id

wp_editTerm( $args )   X-Ref
Edit a term.

param: array $args Method parameters. Contains:
return: bool True, on success.

wp_deleteTerm( $args )   X-Ref
Delete a term.

param: array $args Method parameters. Contains:
return: boolean|IXR_Error If it suceeded true else a reason why not

wp_getTerm( $args )   X-Ref
Retrieve a term.

param: array $args Method parameters. Contains:
return: array contains:

wp_getTerms( $args )   X-Ref
Retrieve all terms for a taxonomy.

param: array $args Method parameters. Contains:
return: array terms

wp_getTaxonomy( $args )   X-Ref
Retrieve a taxonomy.

param: array $args Method parameters. Contains:
return: array (@see get_taxonomy())

wp_getTaxonomies( $args )   X-Ref
Retrieve all taxonomies.

param: array $args Method parameters. Contains:
return: array taxonomies

wp_getUser( $args )   X-Ref
Retrieve a user.

The optional $fields parameter specifies what fields will be included
in the response array. This should be a list of field names. 'user_id' will
always be included in the response regardless of the value of $fields.

Instead of, or in addition to, individual field names, conceptual group
names can be used to specify multiple fields. The available conceptual
groups are 'basic' and 'all'.

param: array $args Method parameters. Contains:
return: array contains (based on $fields parameter):

wp_getUsers( $args )   X-Ref
Retrieve users.

The optional $filter parameter modifies the query used to retrieve users.
Accepted keys are 'number' (default: 50), 'offset' (default: 0), 'role',
'who', 'orderby', and 'order'.

The optional $fields parameter specifies what fields will be included
in the response array.

param: array $args Method parameters. Contains:
return: array users data

wp_getProfile( $args )   X-Ref
Retrieve information about the requesting user.

param: array $args Method parameters. Contains:
return: array (@see wp_getUser)

wp_editProfile( $args )   X-Ref
Edit user's profile.

param: array $args Method parameters. Contains:
return: bool True, on success.

wp_getPage($args)   X-Ref
Retrieve page.

param: array $args Method parameters. Contains:
return: array

wp_getPages($args)   X-Ref
Retrieve Pages.

param: array $args Method parameters. Contains:
return: array

wp_newPage($args)   X-Ref
Create new page.

param: array $args Method parameters. See {@link wp_xmlrpc_server::mw_newPost()}
return: unknown

wp_deletePage($args)   X-Ref
Delete page.

param: array $args Method parameters.
return: bool True, if success.

wp_editPage($args)   X-Ref
Edit page.

param: array $args Method parameters.
return: unknown

wp_getPageList($args)   X-Ref
Retrieve page list.

param: array $args Method parameters.
return: unknown

wp_getAuthors($args)   X-Ref
Retrieve authors list.

param: array $args Method parameters.
return: array

wp_getTags( $args )   X-Ref
Get list of all tags

param: array $args Method parameters.
return: array

wp_newCategory($args)   X-Ref
Create new category.

param: array $args Method parameters.
return: int Category ID.

wp_deleteCategory($args)   X-Ref
Remove category.

param: array $args Method parameters.
return: mixed See {@link wp_delete_term()} for return info.

wp_suggestCategories($args)   X-Ref
Retrieve category list.

param: array $args Method parameters.
return: array

wp_getComment($args)   X-Ref
Retrieve comment.

param: array $args Method parameters.
return: array

wp_getComments($args)   X-Ref
Retrieve comments.

Besides the common blog_id, username, and password arguments, it takes a filter
array as last argument.

Accepted 'filter' keys are 'status', 'post_id', 'offset', and 'number'.

The defaults are as follows:
- 'status' - Default is ''. Filter by status (e.g., 'approve', 'hold')
- 'post_id' - Default is ''. The post where the comment is posted. Empty string shows all comments.
- 'number' - Default is 10. Total number of media items to retrieve.
- 'offset' - Default is 0. See {@link WP_Query::query()} for more.

param: array $args Method parameters.
return: array. Contains a collection of comments. See {@link wp_xmlrpc_server::wp_getComment()} for a description of each item contents

wp_deleteComment($args)   X-Ref
Delete a comment.

By default, the comment will be moved to the trash instead of deleted.
See {@link wp_delete_comment()} for more information on
this behavior.

param: array $args Method parameters. Contains:
return: mixed {@link wp_delete_comment()}

wp_editComment($args)   X-Ref
Edit comment.

Besides the common blog_id, username, and password arguments, it takes a
comment_id integer and a content_struct array as last argument.

The allowed keys in the content_struct array are:
- 'author'
- 'author_url'
- 'author_email'
- 'content'
- 'date_created_gmt'
- 'status'. Common statuses are 'approve', 'hold', 'spam'. See {@link get_comment_statuses()} for more details

param: array $args. Contains:
return: bool True, on success.

wp_newComment($args)   X-Ref
Create new comment.

param: array $args Method parameters.
return: mixed {@link wp_new_comment()}

wp_getCommentStatusList($args)   X-Ref
Retrieve all of the comment status.

param: array $args Method parameters.
return: array

wp_getCommentCount( $args )   X-Ref
Retrieve comment count.

param: array $args Method parameters.
return: array

wp_getPostStatusList( $args )   X-Ref
Retrieve post statuses.

param: array $args Method parameters.
return: array

wp_getPageStatusList( $args )   X-Ref
Retrieve page statuses.

param: array $args Method parameters.
return: array

wp_getPageTemplates( $args )   X-Ref
Retrieve page templates.

param: array $args Method parameters.
return: array

wp_getOptions( $args )   X-Ref
Retrieve blog options.

param: array $args Method parameters.
return: array

_getOptions($options)   X-Ref
Retrieve blog options value from list.

param: array $options Options to retrieve.
return: array

wp_setOptions( $args )   X-Ref
Update blog options.

param: array $args Method parameters.
return: unknown

wp_getMediaItem($args)   X-Ref
Retrieve a media item by ID

param: array $args Method parameters. Contains:
return: array. Associative array containing:

wp_getMediaLibrary($args)   X-Ref
Retrieves a collection of media library items (or attachments)

Besides the common blog_id, username, and password arguments, it takes a filter
array as last argument.

Accepted 'filter' keys are 'parent_id', 'mime_type', 'offset', and 'number'.

The defaults are as follows:
- 'number' - Default is 5. Total number of media items to retrieve.
- 'offset' - Default is 0. See {@link WP_Query::query()} for more.
- 'parent_id' - Default is ''. The post where the media item is attached. Empty string shows all media items. 0 shows unattached media items.
- 'mime_type' - Default is ''. Filter by mime type (e.g., 'image/jpeg', 'application/pdf')

param: array $args Method parameters. Contains:
return: array. Contains a collection of media items. See {@link wp_xmlrpc_server::wp_getMediaItem()} for a description of each item contents

wp_getPostFormats( $args )   X-Ref
Retrieves a list of post formats used by the site

param: array $args Method parameters. Contains:
return: array

wp_getPostType( $args )   X-Ref
Retrieves a post type

param: array $args Method parameters. Contains:
return: array contains:

wp_getPostTypes( $args )   X-Ref
Retrieves a post types

param: array $args Method parameters. Contains:
return: array

wp_getRevisions( $args )   X-Ref
Retrieve revisions for a specific post.

param: array $args Method parameters. Contains:
return: array contains a collection of posts.

wp_restoreRevision( $args )   X-Ref
Restore a post revision

param: array $args Method parameters. Contains:
return: bool false if there was an error restoring, true if success.

blogger_getUsersBlogs($args)   X-Ref
Retrieve blogs that user owns.

Will make more sense once we support multiple blogs.

param: array $args Method parameters.
return: array

_multisite_getUsersBlogs($args)   X-Ref
Private function for retrieving a users blogs for multisite setups


blogger_getUserInfo($args)   X-Ref
Retrieve user's data.

Gives your client some info about you, so you don't have to.

param: array $args Method parameters.
return: array

blogger_getPost($args)   X-Ref
Retrieve post.

param: array $args Method parameters.
return: array

blogger_getRecentPosts($args)   X-Ref
Retrieve list of recent posts.

param: array $args Method parameters.
return: array

blogger_getTemplate($args)   X-Ref
Deprecated.


blogger_setTemplate($args)   X-Ref
Deprecated.


blogger_newPost($args)   X-Ref
Create new post.

param: array $args Method parameters.
return: int

blogger_editPost($args)   X-Ref
Edit a post.

param: array $args Method parameters.
return: bool true when done.

blogger_deletePost($args)   X-Ref
Remove a post.

param: array $args Method parameters.
return: bool True when post is deleted.

mw_newPost($args)   X-Ref
Create a new post.

The 'content_struct' argument must contain:
- title
- description
- mt_excerpt
- mt_text_more
- mt_keywords
- mt_tb_ping_urls
- categories

Also, it can optionally contain:
- wp_slug
- wp_password
- wp_page_parent_id
- wp_page_order
- wp_author_id
- post_status | page_status - can be 'draft', 'private', 'publish', or 'pending'
- mt_allow_comments - can be 'open' or 'closed'
- mt_allow_pings - can be 'open' or 'closed'
- date_created_gmt
- dateCreated
- wp_post_thumbnail

param: array $args Method parameters. Contains:
return: int

add_enclosure_if_new( $post_ID, $enclosure )   X-Ref
No description

attach_uploads( $post_ID, $post_content )   X-Ref
Attach upload to a post.

param: int $post_ID Post ID.
param: string $post_content Post Content for attachment.

mw_editPost($args)   X-Ref
Edit a post.

param: array $args Method parameters.
return: bool True on success.

mw_getPost($args)   X-Ref
Retrieve post.

param: array $args Method parameters.
return: array

mw_getRecentPosts($args)   X-Ref
Retrieve list of recent posts.

param: array $args Method parameters.
return: array

mw_getCategories($args)   X-Ref
Retrieve the list of categories on a given blog.

param: array $args Method parameters.
return: array

mw_newMediaObject($args)   X-Ref
Uploads a file, following your settings.

Adapted from a patch by Johann Richard.

param: array $args Method parameters.
return: array

mt_getRecentPostTitles($args)   X-Ref
Retrieve the post titles of recent posts.

param: array $args Method parameters.
return: array

mt_getCategoryList($args)   X-Ref
Retrieve list of all categories on blog.

param: array $args Method parameters.
return: array

mt_getPostCategories($args)   X-Ref
Retrieve post categories.

param: array $args Method parameters.
return: array

mt_setPostCategories($args)   X-Ref
Sets categories for a post.

param: array $args Method parameters.
return: bool True on success.

mt_supportedMethods($args)   X-Ref
Retrieve an array of methods supported by this server.

param: array $args Method parameters.
return: array

mt_supportedTextFilters($args)   X-Ref
Retrieve an empty array because we don't support per-post text filters.

param: array $args Method parameters.

mt_getTrackbackPings($args)   X-Ref
Retrieve trackbacks sent to a given post.

param: array $args Method parameters.
return: mixed

mt_publishPost($args)   X-Ref
Sets a post's publish status to 'publish'.

param: array $args Method parameters.
return: int

pingback_ping($args)   X-Ref
Retrieves a pingback and registers it.

param: array $args Method parameters.
return: array

pingback_extensions_getPingbacks($args)   X-Ref
Retrieve array of URLs that pingbacked the given URL.

Specs on http://www.aquarionics.com/misc/archives/blogite/0198.html

param: array $args Method parameters.
return: array

pingback_error( $code, $message )   X-Ref
No description



Generated: Tue Mar 25 01:41:18 2014 WordPress honlapkészítés: online1.hu