2010-09-23 17:22:21 -04:00
< ? php
/**
* XML - RPC protocol support for WordPress
*
* @ package WordPress
*/
/**
* WordPress XMLRPC server implementation .
*
2011-09-03 12:02:41 -04:00
* Implements compatibility for Blogger API , MetaWeblog API , MovableType , and
2010-09-23 17:22:21 -04:00
* pingback . Additional WordPress API for managing comments , pages , posts ,
* options , etc .
*
* Since WordPress 2.6 . 0 , WordPress XMLRPC server can be disabled in the
* administration panels .
*
* @ package WordPress
* @ subpackage Publishing
* @ since 1.5 . 0
*/
class wp_xmlrpc_server extends IXR_Server {
/**
* Register all of the XMLRPC methods that XMLRPC server understands .
*
2011-04-29 16:05:12 -04:00
* Sets up server and method property . Passes XMLRPC
2010-09-23 17:22:21 -04:00
* methods through the 'xmlrpc_methods' filter to allow plugins to extend
* or replace XMLRPC methods .
*
* @ since 1.5 . 0
*
* @ return wp_xmlrpc_server
*/
2011-04-29 16:05:12 -04:00
function __construct () {
2010-09-23 17:22:21 -04:00
$this -> methods = array (
// WordPress API
'wp.getUsersBlogs' => 'this:wp_getUsersBlogs' ,
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
'wp.newPost' => 'this:wp_newPost' ,
'wp.editPost' => 'this:wp_editPost' ,
'wp.deletePost' => 'this:wp_deletePost' ,
'wp.getPost' => 'this:wp_getPost' ,
'wp.getPosts' => 'this:wp_getPosts' ,
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
'wp.newTerm' => 'this:wp_newTerm' ,
'wp.editTerm' => 'this:wp_editTerm' ,
'wp.deleteTerm' => 'this:wp_deleteTerm' ,
'wp.getTerm' => 'this:wp_getTerm' ,
'wp.getTerms' => 'this:wp_getTerms' ,
'wp.getTaxonomy' => 'this:wp_getTaxonomy' ,
'wp.getTaxonomies' => 'this:wp_getTaxonomies' ,
2010-09-23 17:22:21 -04:00
'wp.getPage' => 'this:wp_getPage' ,
'wp.getPages' => 'this:wp_getPages' ,
'wp.newPage' => 'this:wp_newPage' ,
'wp.deletePage' => 'this:wp_deletePage' ,
'wp.editPage' => 'this:wp_editPage' ,
'wp.getPageList' => 'this:wp_getPageList' ,
'wp.getAuthors' => 'this:wp_getAuthors' ,
'wp.getCategories' => 'this:mw_getCategories' , // Alias
'wp.getTags' => 'this:wp_getTags' ,
'wp.newCategory' => 'this:wp_newCategory' ,
'wp.deleteCategory' => 'this:wp_deleteCategory' ,
'wp.suggestCategories' => 'this:wp_suggestCategories' ,
'wp.uploadFile' => 'this:mw_newMediaObject' , // Alias
'wp.getCommentCount' => 'this:wp_getCommentCount' ,
'wp.getPostStatusList' => 'this:wp_getPostStatusList' ,
'wp.getPageStatusList' => 'this:wp_getPageStatusList' ,
'wp.getPageTemplates' => 'this:wp_getPageTemplates' ,
'wp.getOptions' => 'this:wp_getOptions' ,
'wp.setOptions' => 'this:wp_setOptions' ,
'wp.getComment' => 'this:wp_getComment' ,
'wp.getComments' => 'this:wp_getComments' ,
'wp.deleteComment' => 'this:wp_deleteComment' ,
'wp.editComment' => 'this:wp_editComment' ,
'wp.newComment' => 'this:wp_newComment' ,
'wp.getCommentStatusList' => 'this:wp_getCommentStatusList' ,
2010-10-27 13:20:46 -04:00
'wp.getMediaItem' => 'this:wp_getMediaItem' ,
'wp.getMediaLibrary' => 'this:wp_getMediaLibrary' ,
2010-11-19 08:57:05 -05:00
'wp.getPostFormats' => 'this:wp_getPostFormats' ,
2012-03-23 13:53:14 -04:00
'wp.getPostType' => 'this:wp_getPostType' ,
'wp.getPostTypes' => 'this:wp_getPostTypes' ,
2010-09-23 17:22:21 -04:00
// Blogger API
'blogger.getUsersBlogs' => 'this:blogger_getUsersBlogs' ,
'blogger.getUserInfo' => 'this:blogger_getUserInfo' ,
'blogger.getPost' => 'this:blogger_getPost' ,
'blogger.getRecentPosts' => 'this:blogger_getRecentPosts' ,
'blogger.getTemplate' => 'this:blogger_getTemplate' ,
'blogger.setTemplate' => 'this:blogger_setTemplate' ,
'blogger.newPost' => 'this:blogger_newPost' ,
'blogger.editPost' => 'this:blogger_editPost' ,
'blogger.deletePost' => 'this:blogger_deletePost' ,
// MetaWeblog API (with MT extensions to structs)
'metaWeblog.newPost' => 'this:mw_newPost' ,
'metaWeblog.editPost' => 'this:mw_editPost' ,
'metaWeblog.getPost' => 'this:mw_getPost' ,
'metaWeblog.getRecentPosts' => 'this:mw_getRecentPosts' ,
'metaWeblog.getCategories' => 'this:mw_getCategories' ,
'metaWeblog.newMediaObject' => 'this:mw_newMediaObject' ,
// MetaWeblog API aliases for Blogger API
// see http://www.xmlrpc.com/stories/storyReader$2460
'metaWeblog.deletePost' => 'this:blogger_deletePost' ,
'metaWeblog.getTemplate' => 'this:blogger_getTemplate' ,
'metaWeblog.setTemplate' => 'this:blogger_setTemplate' ,
'metaWeblog.getUsersBlogs' => 'this:blogger_getUsersBlogs' ,
// MovableType API
'mt.getCategoryList' => 'this:mt_getCategoryList' ,
'mt.getRecentPostTitles' => 'this:mt_getRecentPostTitles' ,
'mt.getPostCategories' => 'this:mt_getPostCategories' ,
'mt.setPostCategories' => 'this:mt_setPostCategories' ,
'mt.supportedMethods' => 'this:mt_supportedMethods' ,
'mt.supportedTextFilters' => 'this:mt_supportedTextFilters' ,
'mt.getTrackbackPings' => 'this:mt_getTrackbackPings' ,
'mt.publishPost' => 'this:mt_publishPost' ,
// PingBack
'pingback.ping' => 'this:pingback_ping' ,
'pingback.extensions.getPingbacks' => 'this:pingback_extensions_getPingbacks' ,
'demo.sayHello' => 'this:sayHello' ,
'demo.addTwoNumbers' => 'this:addTwoNumbers'
);
2012-03-02 13:06:30 -05:00
$this -> initialise_blog_option_info ();
2010-09-23 17:22:21 -04:00
$this -> methods = apply_filters ( 'xmlrpc_methods' , $this -> methods );
}
function serve_request () {
$this -> IXR_Server ( $this -> methods );
}
/**
* Test XMLRPC API by saying , " Hello! " to client .
*
* @ since 1.5 . 0
*
* @ param array $args Method Parameters .
* @ return string
*/
function sayHello ( $args ) {
return 'Hello!' ;
}
/**
* Test XMLRPC API by adding two numbers for client .
*
* @ since 1.5 . 0
*
* @ param array $args Method Parameters .
* @ return int
*/
function addTwoNumbers ( $args ) {
$number1 = $args [ 0 ];
$number2 = $args [ 1 ];
return $number1 + $number2 ;
}
/**
* Check user ' s credentials .
*
* @ since 1.5 . 0
*
* @ param string $user_login User ' s username .
* @ param string $user_pass User ' s password .
* @ return bool Whether authentication passed .
* @ deprecated use wp_xmlrpc_server :: login
* @ see wp_xmlrpc_server :: login
*/
function login_pass_ok ( $user_login , $user_pass ) {
if ( ! get_option ( 'enable_xmlrpc' ) ) {
2011-12-13 18:45:31 -05:00
$this -> error = new IXR_Error ( 405 , sprintf ( __ ( 'XML-RPC services are disabled on this site. An admin user can enable them at %s' ), admin_url ( 'options-writing.php' ) ) );
2010-09-23 17:22:21 -04:00
return false ;
}
if ( ! user_pass_ok ( $user_login , $user_pass )) {
$this -> error = new IXR_Error ( 403 , __ ( 'Bad login/pass combination.' ));
return false ;
}
return true ;
}
/**
* Log user in .
*
* @ since 2.8
*
* @ param string $username User ' s username .
* @ param string $password User ' s password .
* @ return mixed WP_User object if authentication passed , false otherwise
*/
function login ( $username , $password ) {
if ( ! get_option ( 'enable_xmlrpc' ) ) {
2011-12-13 18:45:31 -05:00
$this -> error = new IXR_Error ( 405 , sprintf ( __ ( 'XML-RPC services are disabled on this site. An admin user can enable them at %s' ), admin_url ( 'options-writing.php' ) ) );
2010-09-23 17:22:21 -04:00
return false ;
}
$user = wp_authenticate ( $username , $password );
if ( is_wp_error ( $user )) {
$this -> error = new IXR_Error ( 403 , __ ( 'Bad login/pass combination.' ));
return false ;
}
wp_set_current_user ( $user -> ID );
return $user ;
}
/**
* Sanitize string or array of strings for database .
*
* @ since 1.5 . 2
*
* @ param string | array $array Sanitize single string or array of strings .
* @ return string | array Type matches $array and sanitized for the database .
*/
function escape ( & $array ) {
global $wpdb ;
if ( ! is_array ( $array )) {
return ( $wpdb -> escape ( $array ));
} else {
foreach ( ( array ) $array as $k => $v ) {
if ( is_array ( $v ) ) {
$this -> escape ( $array [ $k ]);
} else if ( is_object ( $v ) ) {
//skip
} else {
$array [ $k ] = $wpdb -> escape ( $v );
}
}
}
}
/**
* Retrieve custom fields for post .
*
* @ since 2.5 . 0
*
* @ param int $post_id Post ID .
* @ return array Custom fields , if exist .
*/
function get_custom_fields ( $post_id ) {
$post_id = ( int ) $post_id ;
$custom_fields = array ();
foreach ( ( array ) has_meta ( $post_id ) as $meta ) {
// Don't expose protected fields.
2011-07-20 18:04:35 -04:00
if ( ! current_user_can ( 'edit_post_meta' , $post_id , $meta [ 'meta_key' ] ) )
2010-09-23 17:22:21 -04:00
continue ;
$custom_fields [] = array (
" id " => $meta [ 'meta_id' ],
" key " => $meta [ 'meta_key' ],
" value " => $meta [ 'meta_value' ]
);
}
return $custom_fields ;
}
/**
* Set custom fields for post .
*
* @ since 2.5 . 0
*
* @ param int $post_id Post ID .
* @ param array $fields Custom fields .
*/
function set_custom_fields ( $post_id , $fields ) {
$post_id = ( int ) $post_id ;
foreach ( ( array ) $fields as $meta ) {
if ( isset ( $meta [ 'id' ]) ) {
$meta [ 'id' ] = ( int ) $meta [ 'id' ];
2011-07-20 18:04:35 -04:00
$pmeta = get_metadata_by_mid ( 'post' , $meta [ 'id' ] );
2010-09-23 17:22:21 -04:00
if ( isset ( $meta [ 'key' ]) ) {
2011-08-03 14:20:15 -04:00
$meta [ 'key' ] = stripslashes ( $meta [ 'key' ] );
2011-07-20 18:04:35 -04:00
if ( $meta [ 'key' ] != $pmeta -> meta_key )
continue ;
2012-04-25 10:26:31 -04:00
$meta [ 'value' ] = stripslashes_deep ( $meta [ 'value' ] );
2011-07-20 18:04:35 -04:00
if ( current_user_can ( 'edit_post_meta' , $post_id , $meta [ 'key' ] ) )
2011-08-03 14:20:15 -04:00
update_metadata_by_mid ( 'post' , $meta [ 'id' ], $meta [ 'value' ] );
2011-07-20 18:04:35 -04:00
} elseif ( current_user_can ( 'delete_post_meta' , $post_id , $pmeta -> meta_key ) ) {
2011-08-03 14:20:15 -04:00
delete_metadata_by_mid ( 'post' , $meta [ 'id' ] );
2010-09-23 17:22:21 -04:00
}
2011-08-03 14:20:15 -04:00
} elseif ( current_user_can ( 'add_post_meta' , $post_id , stripslashes ( $meta [ 'key' ] ) ) ) {
add_post_meta ( $post_id , $meta [ 'key' ], $meta [ 'value' ] );
2010-09-23 17:22:21 -04:00
}
}
}
/**
* Set up blog options property .
*
* Passes property through 'xmlrpc_blog_options' filter .
*
* @ since 2.6 . 0
*/
2012-03-02 13:06:30 -05:00
function initialise_blog_option_info () {
2011-06-02 16:03:27 -04:00
global $wp_version ;
2010-09-23 17:22:21 -04:00
$this -> blog_options = array (
// Read only options
2012-03-02 13:06:30 -05:00
'software_name' => array (
'desc' => __ ( 'Software Name' ),
'readonly' => true ,
'value' => 'WordPress'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'software_version' => array (
'desc' => __ ( 'Software Version' ),
'readonly' => true ,
'value' => $wp_version
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'blog_url' => array (
'desc' => __ ( 'Site URL' ),
'readonly' => true ,
'option' => 'siteurl'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'image_default_link_type' => array (
'desc' => __ ( 'Image default link type' ),
'readonly' => true ,
'option' => 'image_default_link_type'
2012-02-08 18:28:23 -05:00
),
2012-03-02 13:06:30 -05:00
'image_default_size' => array (
'desc' => __ ( 'Image default size' ),
'readonly' => true ,
'option' => 'image_default_size'
2012-02-08 18:28:23 -05:00
),
2012-03-02 13:06:30 -05:00
'image_default_align' => array (
'desc' => __ ( 'Image default align' ),
'readonly' => true ,
'option' => 'image_default_align'
2012-02-08 18:28:23 -05:00
),
2012-03-02 12:59:47 -05:00
'template' => array (
'desc' => __ ( 'Template' ),
'readonly' => true ,
'option' => 'template'
),
'stylesheet' => array (
'desc' => __ ( 'Stylesheet' ),
'readonly' => true ,
'option' => 'stylesheet'
),
2012-04-13 16:23:31 -04:00
'post_thumbnail' => array (
'desc' => __ ( 'Post Thumbnail' ),
2012-03-08 07:19:45 -05:00
'readonly' => true ,
'value' => current_theme_supports ( 'post-thumbnails' )
),
2010-09-23 17:22:21 -04:00
// Updatable options
2012-03-02 13:06:30 -05:00
'time_zone' => array (
'desc' => __ ( 'Time Zone' ),
'readonly' => false ,
'option' => 'gmt_offset'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'blog_title' => array (
'desc' => __ ( 'Site Title' ),
'readonly' => false ,
'option' => 'blogname'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'blog_tagline' => array (
'desc' => __ ( 'Site Tagline' ),
'readonly' => false ,
'option' => 'blogdescription'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'date_format' => array (
'desc' => __ ( 'Date Format' ),
'readonly' => false ,
'option' => 'date_format'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'time_format' => array (
'desc' => __ ( 'Time Format' ),
'readonly' => false ,
'option' => 'time_format'
2010-09-23 17:22:21 -04:00
),
2012-03-02 13:06:30 -05:00
'users_can_register' => array (
'desc' => __ ( 'Allow new users to sign up' ),
'readonly' => false ,
'option' => 'users_can_register'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'thumbnail_size_w' => array (
'desc' => __ ( 'Thumbnail Width' ),
'readonly' => false ,
'option' => 'thumbnail_size_w'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'thumbnail_size_h' => array (
'desc' => __ ( 'Thumbnail Height' ),
'readonly' => false ,
'option' => 'thumbnail_size_h'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'thumbnail_crop' => array (
'desc' => __ ( 'Crop thumbnail to exact dimensions' ),
'readonly' => false ,
'option' => 'thumbnail_crop'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'medium_size_w' => array (
'desc' => __ ( 'Medium size image width' ),
'readonly' => false ,
'option' => 'medium_size_w'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'medium_size_h' => array (
'desc' => __ ( 'Medium size image height' ),
'readonly' => false ,
'option' => 'medium_size_h'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'large_size_w' => array (
'desc' => __ ( 'Large size image width' ),
'readonly' => false ,
'option' => 'large_size_w'
2010-10-26 13:46:29 -04:00
),
2012-03-02 13:06:30 -05:00
'large_size_h' => array (
'desc' => __ ( 'Large size image height' ),
'readonly' => false ,
'option' => 'large_size_h'
2012-01-07 14:08:48 -05:00
),
2012-03-02 13:06:30 -05:00
'default_comment_status' => array (
'desc' => __ ( 'Allow people to post comments on new articles' ),
'readonly' => false ,
'option' => 'default_comment_status'
2012-01-07 14:08:48 -05:00
),
2012-03-02 13:06:30 -05:00
'default_ping_status' => array (
'desc' => __ ( 'Allow link notifications from other blogs (pingbacks and trackbacks)' ),
'readonly' => false ,
'option' => 'default_ping_status'
2010-09-23 17:22:21 -04:00
)
);
$this -> blog_options = apply_filters ( 'xmlrpc_blog_options' , $this -> blog_options );
}
/**
* Retrieve the blogs of the user .
*
* @ since 2.6 . 0
*
2011-04-18 03:23:47 -04:00
* @ param array $args Method parameters . Contains :
* - username
* - password
* @ return array . Contains :
* - 'isAdmin'
* - 'url'
* - 'blogid'
* - 'blogName'
* - 'xmlrpc' - url of xmlrpc endpoint
2010-09-23 17:22:21 -04:00
*/
function wp_getUsersBlogs ( $args ) {
global $current_site ;
// If this isn't on WPMU then just use blogger_getUsersBlogs
if ( ! is_multisite () ) {
array_unshift ( $args , 1 );
return $this -> blogger_getUsersBlogs ( $args );
}
$this -> escape ( $args );
$username = $args [ 0 ];
$password = $args [ 1 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getUsersBlogs' );
$blogs = ( array ) get_blogs_of_user ( $user -> ID );
2012-03-02 13:06:30 -05:00
$struct = array ();
2010-09-23 17:22:21 -04:00
foreach ( $blogs as $blog ) {
// Don't include blogs that aren't hosted at this site
if ( $blog -> site_id != $current_site -> id )
continue ;
$blog_id = $blog -> userblog_id ;
switch_to_blog ( $blog_id );
$is_admin = current_user_can ( 'manage_options' );
$struct [] = array (
'isAdmin' => $is_admin ,
'url' => get_option ( 'home' ) . '/' ,
2010-11-24 12:51:39 -05:00
'blogid' => ( string ) $blog_id ,
2010-09-23 17:22:21 -04:00
'blogName' => get_option ( 'blogname' ),
'xmlrpc' => site_url ( 'xmlrpc.php' )
);
2012-03-02 13:06:30 -05:00
restore_current_blog ();
2010-09-23 17:22:21 -04:00
}
return $struct ;
}
2012-05-02 17:13:08 -04:00
/**
* Checks if the method received at least the minimum number of arguments .
*
* @ since 3.4
*
* @ 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 .
*/
protected function minimum_args ( $args , $count ) {
if ( count ( $args ) < $count ) {
$this -> error = new IXR_Error ( 400 , __ ( 'Insufficient arguments passed to this XML-RPC method.' ) );
return false ;
}
return true ;
}
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
/**
* Prepares taxonomy data for return in an XML - RPC object .
*
* @ access protected
2012-04-04 17:32:28 -04:00
*
2012-04-28 14:48:10 -04:00
* @ param object $taxonomy The unprepared taxonomy data
2012-04-29 20:25:14 -04:00
* @ param array $fields The subset of taxonomy fields to return
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ return array The prepared taxonomy data
*/
2012-04-28 14:48:10 -04:00
protected function _prepare_taxonomy ( $taxonomy , $fields ) {
$_taxonomy = array (
2012-05-01 16:33:06 -04:00
'name' => $taxonomy -> name ,
2012-04-28 14:48:10 -04:00
'label' => $taxonomy -> label ,
'hierarchical' => ( bool ) $taxonomy -> hierarchical ,
'public' => ( bool ) $taxonomy -> public ,
'show_ui' => ( bool ) $taxonomy -> show_ui ,
2012-05-01 17:03:50 -04:00
'_builtin' => ( bool ) $taxonomy -> _builtin ,
2012-04-28 14:48:10 -04:00
);
if ( in_array ( 'labels' , $fields ) )
$_taxonomy [ 'labels' ] = ( array ) $taxonomy -> labels ;
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
2012-05-02 16:29:34 -04:00
if ( in_array ( 'cap' , $fields ) )
2012-05-01 16:33:06 -04:00
$_taxonomy [ 'cap' ] = ( array ) $taxonomy -> cap ;
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
2012-05-02 16:29:34 -04:00
if ( in_array ( 'object_type' , $fields ) )
2012-05-01 17:03:50 -04:00
$_taxonomy [ 'object_type' ] = array_unique ( ( array ) $taxonomy -> object_type );
2012-04-28 14:48:10 -04:00
return apply_filters ( 'xmlrpc_prepare_taxonomy' , $_taxonomy , $taxonomy , $fields );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
}
/**
* Prepares term data for return in an XML - RPC object .
*
* @ access protected
2012-04-04 17:32:28 -04:00
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ param array | object $term The unprepared term data
* @ return array The prepared term data
*/
protected function _prepare_term ( $term ) {
$_term = $term ;
if ( ! is_array ( $_term ) )
$_term = get_object_vars ( $_term );
2012-03-08 08:31:32 -05:00
// For Intergers which may be largeer than XMLRPC supports ensure we return strings.
$_term [ 'term_id' ] = strval ( $_term [ 'term_id' ] );
$_term [ 'term_group' ] = strval ( $_term [ 'term_group' ] );
$_term [ 'term_taxonomy_id' ] = strval ( $_term [ 'term_taxonomy_id' ] );
$_term [ 'parent' ] = strval ( $_term [ 'parent' ] );
// Count we are happy to return as an Integer because people really shouldn't use Terms that much.
$_term [ 'count' ] = intval ( $_term [ 'count' ] );
2012-04-25 18:28:43 -04:00
return apply_filters ( 'xmlrpc_prepare_term' , $_term , $term );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
}
2012-03-08 06:19:53 -05:00
/**
* Convert a WordPress date string to an IXR_Date object .
*
* @ access protected
*
* @ param $date
* @ return IXR_Date
*/
protected function _convert_date ( $date ) {
if ( $date === '0000-00-00 00:00:00' ) {
return new IXR_Date ( '00000000T00:00:00Z' );
}
return new IXR_Date ( mysql2date ( 'Ymd\TH:i:s' , $date , false ) );
}
2012-04-04 17:32:28 -04:00
/**
* Convert a WordPress gmt date string to an IXR_Date object .
*
* @ access protected
*
* @ param $date
* @ return IXR_Date
*/
protected function _convert_date_gmt ( $date_gmt , $date ) {
if ( $date !== '0000-00-00 00:00:00' && $date_gmt === '0000-00-00 00:00:00' ) {
return new IXR_Date ( get_gmt_from_date ( mysql2date ( 'Y-m-d H:i:s' , $date , false ), 'Ymd\TH:i:s' ) );
}
return $this -> _convert_date ( $date_gmt );
}
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
/**
* Prepares post data for return in an XML - RPC object .
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ access protected
2012-02-08 11:03:31 -05:00
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* @ param array $post The unprepared post data
2012-04-29 20:25:14 -04:00
* @ param array $fields The subset of post type fields to return
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* @ return array The prepared post data
*/
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
protected function _prepare_post ( $post , $fields ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// holds the data for this post. built up based on $fields
2012-03-08 06:19:53 -05:00
$_post = array ( 'post_id' => strval ( $post [ 'ID' ] ) );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// prepare common post fields
$post_fields = array (
'post_title' => $post [ 'post_title' ],
2012-03-08 06:19:53 -05:00
'post_date' => $this -> _convert_date ( $post [ 'post_date' ] ),
2012-04-04 17:32:28 -04:00
'post_date_gmt' => $this -> _convert_date_gmt ( $post [ 'post_date_gmt' ], $post [ 'post_date' ] ),
2012-03-08 06:19:53 -05:00
'post_modified' => $this -> _convert_date ( $post [ 'post_modified' ] ),
2012-04-04 17:32:28 -04:00
'post_modified_gmt' => $this -> _convert_date_gmt ( $post [ 'post_modified_gmt' ], $post [ 'post_modified' ] ),
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
'post_status' => $post [ 'post_status' ],
'post_type' => $post [ 'post_type' ],
'post_name' => $post [ 'post_name' ],
'post_author' => $post [ 'post_author' ],
'post_password' => $post [ 'post_password' ],
'post_excerpt' => $post [ 'post_excerpt' ],
'post_content' => $post [ 'post_content' ],
'link' => post_permalink ( $post [ 'ID' ] ),
'comment_status' => $post [ 'comment_status' ],
'ping_status' => $post [ 'ping_status' ],
'sticky' => ( $post [ 'post_type' ] === 'post' && is_sticky ( $post [ 'ID' ] ) ),
);
2012-04-26 16:56:52 -04:00
// Thumbnail
$post_fields [ 'post_thumbnail' ] = array ();
$thumbnail_id = get_post_thumbnail_id ( $post [ 'ID' ] );
if ( $thumbnail_id ) {
$thumbnail_size = current_theme_supports ( 'post-thumbnail' ) ? 'post-thumbnail' : 'thumbnail' ;
$post_fields [ 'post_thumbnail' ] = $this -> _prepare_media_item ( get_post ( $thumbnail_id ), $thumbnail_size );
}
2012-03-23 11:35:44 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// Consider future posts as published
if ( $post_fields [ 'post_status' ] === 'future' )
$post_fields [ 'post_status' ] = 'publish' ;
// Fill in blank post format
$post_fields [ 'post_format' ] = get_post_format ( $post [ 'ID' ] );
if ( empty ( $post_fields [ 'post_format' ] ) )
$post_fields [ 'post_format' ] = 'standard' ;
// Merge requested $post_fields fields into $_post
if ( in_array ( 'post' , $fields ) ) {
$_post = array_merge ( $_post , $post_fields );
} else {
$requested_fields = array_intersect_key ( $post_fields , array_flip ( $fields ) );
$_post = array_merge ( $_post , $requested_fields );
}
$all_taxonomy_fields = in_array ( 'taxonomies' , $fields );
if ( $all_taxonomy_fields || in_array ( 'terms' , $fields ) ) {
$post_type_taxonomies = get_object_taxonomies ( $post [ 'post_type' ], 'names' );
$terms = wp_get_object_terms ( $post [ 'ID' ], $post_type_taxonomies );
$_post [ 'terms' ] = array ();
foreach ( $terms as $term ) {
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$_post [ 'terms' ][] = $this -> _prepare_term ( $term );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
}
}
if ( in_array ( 'custom_fields' , $fields ) )
$_post [ 'custom_fields' ] = $this -> get_custom_fields ( $post [ 'ID' ] );
if ( in_array ( 'enclosure' , $fields ) ) {
$_post [ 'enclosure' ] = array ();
$enclosures = ( array ) get_post_meta ( $post [ 'ID' ], 'enclosure' );
if ( ! empty ( $enclosures ) ) {
$encdata = explode ( " \n " , $enclosures [ 0 ] );
$_post [ 'enclosure' ][ 'url' ] = trim ( htmlspecialchars ( $encdata [ 0 ] ) );
$_post [ 'enclosure' ][ 'length' ] = ( int ) trim ( $encdata [ 1 ] );
$_post [ 'enclosure' ][ 'type' ] = trim ( $encdata [ 2 ] );
}
}
2012-04-25 18:28:43 -04:00
return apply_filters ( 'xmlrpc_prepare_post' , $_post , $post , $fields );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
}
2012-03-23 13:53:14 -04:00
/**
* Prepares post data for return in an XML - RPC object .
*
* @ access protected
*
2012-04-28 14:48:10 -04:00
* @ param object $post_type Post type object
2012-03-23 13:53:14 -04:00
* @ param array $fields The subset of post fields to return
* @ return array The prepared post type data
*/
2012-05-03 11:59:50 -04:00
protected function _prepare_post_type ( $post_type , $fields ) {
2012-03-23 13:53:14 -04:00
$_post_type = array (
2012-04-28 14:48:10 -04:00
'name' => $post_type -> name ,
'label' => $post_type -> label ,
'hierarchical' => ( bool ) $post_type -> hierarchical ,
'public' => ( bool ) $post_type -> public ,
'show_ui' => ( bool ) $post_type -> show_ui ,
'_builtin' => ( bool ) $post_type -> _builtin ,
'has_archive' => ( bool ) $post_type -> has_archive ,
'supports' => get_all_post_type_supports ( $post_type -> name ),
2012-03-23 13:53:14 -04:00
);
if ( in_array ( 'labels' , $fields ) ) {
2012-04-28 14:48:10 -04:00
$_post_type [ 'labels' ] = ( array ) $post_type -> labels ;
2012-03-23 13:53:14 -04:00
}
2012-05-02 16:29:34 -04:00
if ( in_array ( 'cap' , $fields ) ) {
2012-04-28 14:48:10 -04:00
$_post_type [ 'cap' ] = ( array ) $post_type -> cap ;
$_post_type [ 'map_meta_cap' ] = ( bool ) $post_type -> map_meta_cap ;
2012-03-23 13:53:14 -04:00
}
if ( in_array ( 'menu' , $fields ) ) {
2012-04-28 14:48:10 -04:00
$_post_type [ 'menu_position' ] = ( int ) $post_type -> menu_position ;
$_post_type [ 'menu_icon' ] = $post_type -> menu_icon ;
$_post_type [ 'show_in_menu' ] = ( bool ) $post_type -> show_in_menu ;
2012-03-23 13:53:14 -04:00
}
2012-04-28 14:48:10 -04:00
if ( in_array ( 'taxonomies' , $fields ) )
2012-04-28 17:22:07 -04:00
$_post_type [ 'taxonomies' ] = get_object_taxonomies ( $post_type -> name , 'names' );
2012-03-23 13:53:14 -04:00
2012-04-25 18:28:43 -04:00
return apply_filters ( 'xmlrpc_prepare_post_type' , $_post_type , $post_type );
2012-03-23 13:53:14 -04:00
}
2012-04-26 16:56:52 -04:00
/**
* Prepares media item data for return in an XML - RPC object .
*
* @ access protected
*
* @ param object $media_item The unprepared media item data
* @ param string $size The image size to use for the thumbnail URL
* @ return array The prepared media item data
*/
protected function _prepare_media_item ( $media_item , $thumbnail_size = 'thumbnail' ) {
$_media_item = array (
'attachment_id' => strval ( $media_item -> ID ),
'date_created_gmt' => $this -> _convert_date_gmt ( $media_item -> post_date_gmt , $media_item -> post_date ),
'parent' => $media_item -> post_parent ,
'link' => wp_get_attachment_url ( $media_item -> ID ),
'title' => $media_item -> post_title ,
'caption' => $media_item -> post_excerpt ,
'description' => $media_item -> post_content ,
'metadata' => wp_get_attachment_metadata ( $media_item -> ID ),
);
$thumbnail_src = image_downsize ( $media_item -> ID , $thumbnail_size );
if ( $thumbnail_src )
$_media_item [ 'thumbnail' ] = $thumbnail_src [ 0 ];
else
$_media_item [ 'thumbnail' ] = $_media_item [ 'link' ];
return apply_filters ( 'xmlrpc__prepare_media_item' , $_media_item , $media_item , $thumbnail_size );
}
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
/**
* Create a new post for any registered post type .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* @ uses wp_insert_post ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - array $content_struct
* $content_struct can contain :
* - post_type ( default : 'post' )
* - post_status ( default : 'draft' )
* - post_title
* - post_author
* - post_exerpt
* - post_content
* - post_date_gmt | post_date
* - post_format
* - post_password
* - comment_status - can be 'open' | 'closed'
* - ping_status - can be 'open' | 'closed'
* - sticky
2012-04-13 16:23:31 -04:00
* - post_thumbnail - ID of a media item to use as the post thumbnail / featured image
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* - custom_fields - array , with each element containing 'key' and 'value'
* - terms - array , with taxonomy names as keys and arrays of term IDs as values
* - terms_names - array , with taxonomy names as keys and arrays of term names as values
* - enclosure
* - any other fields supported by wp_insert_post ()
* @ return string post_id
*/
function wp_newPost ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$content_struct = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.newPost' );
unset ( $content_struct [ 'ID' ] );
2012-02-08 12:00:19 -05:00
return $this -> _insert_post ( $user , $content_struct );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
}
/*
* Helper method for filtering out elements from an array .
2012-04-28 14:48:10 -04:00
*
* @ since 3.4 . 0
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
*/
2012-04-28 14:48:10 -04:00
function _is_greater_than_one ( $count ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return $count > 1 ;
}
/*
* Helper method for wp_newPost and wp_editPost , containing shared logic .
2012-04-28 14:48:10 -04:00
*
* @ since 3.4 . 0
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
*/
2012-04-28 14:48:10 -04:00
protected function _insert_post ( $user , $content_struct ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$defaults = array ( 'post_status' => 'draft' , 'post_type' => 'post' , 'post_author' => 0 ,
2012-04-28 14:48:10 -04:00
'post_password' => '' , 'post_excerpt' => '' , 'post_content' => '' , 'post_title' => '' );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$post_data = wp_parse_args ( $content_struct , $defaults );
$post_type = get_post_type_object ( $post_data [ 'post_type' ] );
2012-04-28 14:48:10 -04:00
if ( ! $post_type )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 403 , __ ( 'Invalid post type' ) );
2012-04-28 14:48:10 -04:00
$update = ! empty ( $post_data [ 'ID' ] );
2012-02-08 10:40:26 -05:00
if ( $update ) {
2012-04-29 20:19:32 -04:00
if ( ! get_post ( $post_data [ 'ID' ] ) )
return new IXR_Error ( 401 , __ ( 'Invalid post ID.' ) );
2012-04-28 14:48:10 -04:00
if ( ! current_user_can ( $post_type -> cap -> edit_post , $post_data [ 'ID' ] ) )
2012-02-08 10:40:26 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2012-04-28 14:48:10 -04:00
if ( $post_data [ 'post_type' ] != get_post_type ( $post_data [ 'ID' ] ) )
return new IXR_Error ( 401 , __ ( 'The post type may not be changed.' ) );
2012-02-08 10:40:26 -05:00
} else {
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to post on this site.' ) );
}
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
switch ( $post_data [ 'post_status' ] ) {
case 'draft' :
case 'pending' :
break ;
case 'private' :
2012-04-24 12:22:12 -04:00
if ( ! current_user_can ( $post_type -> cap -> publish_posts ) )
2012-04-28 14:48:10 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create private posts in this post type' ) );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
break ;
case 'publish' :
case 'future' :
2012-04-24 12:22:12 -04:00
if ( ! current_user_can ( $post_type -> cap -> publish_posts ) )
2012-04-28 14:48:10 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish posts in this post type' ) );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
break ;
default :
$post_data [ 'post_status' ] = 'draft' ;
break ;
}
if ( ! empty ( $post_data [ 'post_password' ] ) && ! current_user_can ( $post_type -> cap -> publish_posts ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create password protected posts in this post type' ) );
$post_data [ 'post_author' ] = absint ( $post_data [ 'post_author' ] );
2012-02-08 09:54:15 -05:00
if ( ! empty ( $post_data [ 'post_author' ] ) && $post_data [ 'post_author' ] != $user -> ID ) {
if ( ! current_user_can ( $post_type -> cap -> edit_others_posts ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 401 , __ ( 'You are not allowed to create posts as this user.' ) );
$author = get_userdata ( $post_data [ 'post_author' ] );
2012-02-08 09:54:15 -05:00
if ( ! $author )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 404 , __ ( 'Invalid author ID.' ) );
2012-02-08 10:40:26 -05:00
} else {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$post_data [ 'post_author' ] = $user -> ID ;
}
2012-04-28 14:48:10 -04:00
if ( isset ( $post_data [ 'comment_status' ] ) && $post_data [ 'comment_status' ] != 'open' && $post_data [ 'comment_status' ] != 'closed' )
unset ( $post_data [ 'comment_status' ] );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
2012-04-28 14:48:10 -04:00
if ( isset ( $post_data [ 'ping_status' ] ) && $post_data [ 'ping_status' ] != 'open' && $post_data [ 'ping_status' ] != 'closed' )
unset ( $post_data [ 'ping_status' ] );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// Do some timestamp voodoo
if ( ! empty ( $post_data [ 'post_date_gmt' ] ) ) {
// We know this is supposed to be GMT, so we're going to slap that Z on there by force
2012-04-28 14:48:10 -04:00
$dateCreated = rtrim ( $post_data [ 'post_date_gmt' ] -> getIso (), 'Z' ) . 'Z' ;
2012-02-08 11:04:58 -05:00
} elseif ( ! empty ( $post_data [ 'post_date' ] ) ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$dateCreated = $post_data [ 'post_date' ] -> getIso ();
}
if ( ! empty ( $dateCreated ) ) {
$post_data [ 'post_date' ] = get_date_from_gmt ( iso8601_to_datetime ( $dateCreated ) );
$post_data [ 'post_date_gmt' ] = iso8601_to_datetime ( $dateCreated , 'GMT' );
}
2012-04-28 14:48:10 -04:00
if ( ! isset ( $post_data [ 'ID' ] ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$post_data [ 'ID' ] = get_default_post_to_edit ( $post_data [ 'post_type' ], true ) -> ID ;
$post_ID = $post_data [ 'ID' ];
2012-04-28 14:48:10 -04:00
if ( $post_data [ 'post_type' ] == 'post' ) {
// Private and password-protected posts cannot be stickied.
2012-05-01 17:03:50 -04:00
if ( $post_data [ 'post_status' ] == 'private' || ! empty ( $post_data [ 'post_password' ] ) ) {
2012-04-28 14:48:10 -04:00
// Error if the client tried to stick the post, otherwise, silently unstick.
if ( ! empty ( $post_data [ 'sticky' ] ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot stick a private post.' ) );
if ( $update )
unstick_post ( $post_ID );
} elseif ( isset ( $post_data [ 'sticky' ] ) ) {
if ( ! current_user_can ( $post_type -> cap -> edit_others_posts ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to stick this post.' ) );
if ( $post_data [ 'sticky' ] )
stick_post ( $post_ID );
else
unstick_post ( $post_ID );
}
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
}
2012-04-28 14:48:10 -04:00
if ( isset ( $post_data [ 'post_thumbnail' ] ) ) {
2012-03-23 11:35:44 -04:00
// empty value deletes, non-empty value adds/updates
2012-04-28 14:48:10 -04:00
if ( ! $post_data [ 'post_thumbnail' ] )
2012-03-23 11:35:44 -04:00
delete_post_thumbnail ( $post_ID );
2012-04-28 14:48:10 -04:00
elseif ( ! set_post_thumbnail ( $post_ID , $post_data [ 'post_thumbnail' ] ) )
2012-03-23 11:35:44 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2012-04-28 14:48:10 -04:00
if ( isset ( $post_data [ 'custom_fields' ] ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> set_custom_fields ( $post_ID , $post_data [ 'custom_fields' ] );
2012-02-08 09:54:15 -05:00
if ( isset ( $post_data [ 'terms' ] ) || isset ( $post_data [ 'terms_names' ] ) ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$post_type_taxonomies = get_object_taxonomies ( $post_data [ 'post_type' ], 'objects' );
// accumulate term IDs from terms and terms_names
$terms = array ();
// first validate the terms specified by ID
2012-02-08 09:54:15 -05:00
if ( isset ( $post_data [ 'terms' ] ) && is_array ( $post_data [ 'terms' ] ) ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$taxonomies = array_keys ( $post_data [ 'terms' ] );
// validating term ids
foreach ( $taxonomies as $taxonomy ) {
if ( ! array_key_exists ( $taxonomy , $post_type_taxonomies ) )
return new IXR_Error ( 401 , __ ( 'Sorry, one of the given taxonomies is not supported by the post type.' ) );
2012-02-08 09:54:15 -05:00
if ( ! current_user_can ( $post_type_taxonomies [ $taxonomy ] -> cap -> assign_terms ) )
2012-02-08 13:50:25 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to assign a term to one of the given taxonomies.' ) );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$term_ids = $post_data [ 'terms' ][ $taxonomy ];
foreach ( $term_ids as $term_id ) {
$term = get_term_by ( 'id' , $term_id , $taxonomy );
if ( ! $term )
return new IXR_Error ( 403 , __ ( 'Invalid term ID' ) );
$terms [ $taxonomy ][] = ( int ) $term_id ;
}
}
}
// now validate terms specified by name
if ( isset ( $post_data [ 'terms_names' ] ) && is_array ( $post_data [ 'terms_names' ] ) ) {
$taxonomies = array_keys ( $post_data [ 'terms_names' ] );
foreach ( $taxonomies as $taxonomy ) {
if ( ! array_key_exists ( $taxonomy , $post_type_taxonomies ) )
return new IXR_Error ( 401 , __ ( 'Sorry, one of the given taxonomies is not supported by the post type.' ) );
2012-02-08 09:54:15 -05:00
if ( ! current_user_can ( $post_type_taxonomies [ $taxonomy ] -> cap -> assign_terms ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to assign a term to one of the given taxonomies.' ) );
// for hierarchical taxonomies, we can't assign a term when multiple terms in the hierarchy share the same name
$ambiguous_terms = array ();
2012-02-08 09:54:15 -05:00
if ( is_taxonomy_hierarchical ( $taxonomy ) ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$tax_term_names = get_terms ( $taxonomy , array ( 'fields' => 'names' , 'hide_empty' => false ) );
// count the number of terms with the same name
$tax_term_names_count = array_count_values ( $tax_term_names );
// filter out non-ambiguous term names
$ambiguous_tax_term_counts = array_filter ( $tax_term_names_count , array ( $this , '_is_greater_than_one' ) );
$ambiguous_terms = array_keys ( $ambiguous_tax_term_counts );
}
$term_names = $post_data [ 'terms_names' ][ $taxonomy ];
foreach ( $term_names as $term_name ) {
if ( in_array ( $term_name , $ambiguous_terms ) )
return new IXR_Error ( 401 , __ ( 'Ambiguous term name used in a hierarchical taxonomy. Please use term ID instead.' ) );
$term = get_term_by ( 'name' , $term_name , $taxonomy );
if ( ! $term ) {
// term doesn't exist, so check that the user is allowed to create new terms
2012-02-08 09:54:15 -05:00
if ( ! current_user_can ( $post_type_taxonomies [ $taxonomy ] -> cap -> edit_terms ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to add a term to one of the given taxonomies.' ) );
// create the new term
$term_info = wp_insert_term ( $term_name , $taxonomy );
if ( is_wp_error ( $term_info ) )
return new IXR_Error ( 500 , $term_info -> get_error_message () );
$terms [ $taxonomy ][] = ( int ) $term_info [ 'term_id' ];
2012-02-08 11:04:58 -05:00
} else {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$terms [ $taxonomy ][] = ( int ) $term -> term_id ;
}
}
}
}
$post_data [ 'tax_input' ] = $terms ;
2012-04-28 14:48:10 -04:00
unset ( $post_data [ 'terms' ], $post_data [ 'terms_names' ] );
2012-02-08 11:04:58 -05:00
} else {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// do not allow direct submission of 'tax_input', clients must use 'terms' and/or 'terms_names'
2012-04-28 14:48:10 -04:00
unset ( $post_data [ 'tax_input' ], $post_data [ 'post_category' ], $post_data [ 'tags_input' ] );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
}
2012-02-08 09:54:15 -05:00
if ( isset ( $post_data [ 'post_format' ] ) ) {
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$format = set_post_format ( $post_ID , $post_data [ 'post_format' ] );
if ( is_wp_error ( $format ) )
return new IXR_Error ( 500 , $format -> get_error_message () );
unset ( $post_data [ 'post_format' ] );
}
// Handle enclosures
$enclosure = isset ( $post_data [ 'enclosure' ] ) ? $post_data [ 'enclosure' ] : null ;
$this -> add_enclosure_if_new ( $post_ID , $enclosure );
$this -> attach_uploads ( $post_ID , $post_data [ 'post_content' ] );
$post_data = apply_filters ( 'xmlrpc_wp_insert_post_data' , $post_data , $content_struct );
$post_ID = wp_insert_post ( $post_data , true );
if ( is_wp_error ( $post_ID ) )
return new IXR_Error ( 500 , $post_ID -> get_error_message () );
if ( ! $post_ID )
return new IXR_Error ( 401 , __ ( 'Sorry, your entry could not be posted. Something wrong happened.' ) );
return strval ( $post_ID );
}
2012-02-08 11:03:31 -05:00
/**
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* Edit a post for any registered post type .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* The $content_struct parameter only needs to contain fields that
* should be changed . All other fields will retain their existing values .
*
* @ uses wp_insert_post ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - int $post_id
* - array $content_struct
* @ return true on success
*/
function wp_editPost ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 5 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $args );
2012-04-28 14:48:10 -04:00
$blog_id = ( int ) $args [ 0 ];
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
$content_struct = $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.editPost' );
$post = get_post ( $post_id , ARRAY_A );
2012-04-28 14:48:10 -04:00
if ( empty ( $post [ 'ID' ] ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
// convert the date field back to IXR form
2012-03-08 06:19:53 -05:00
$post [ 'post_date' ] = $this -> _convert_date ( $post [ 'post_date' ] );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// ignore the existing GMT date if it is empty or a non-GMT date was supplied in $content_struct,
2012-02-08 12:00:19 -05:00
// since _insert_post will ignore the non-GMT date if the GMT date is set
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
if ( $post [ 'post_date_gmt' ] == '0000-00-00 00:00:00' || isset ( $content_struct [ 'post_date' ] ) )
unset ( $post [ 'post_date_gmt' ] );
else
2012-03-08 06:19:53 -05:00
$post [ 'post_date_gmt' ] = $this -> _convert_date ( $post [ 'post_date_gmt' ] );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $post );
$merged_content_struct = array_merge ( $post , $content_struct );
2012-02-08 12:00:19 -05:00
$retval = $this -> _insert_post ( $user , $merged_content_struct );
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
if ( $retval instanceof IXR_Error )
return $retval ;
return true ;
}
/**
* Delete a post for any registered post type .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* @ uses wp_delete_post ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - int $post_id
* @ return true on success
*/
function wp_deletePost ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.deletePost' );
$post = wp_get_single_post ( $post_id , ARRAY_A );
if ( empty ( $post [ 'ID' ] ) )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
$post_type = get_post_type_object ( $post [ 'post_type' ] );
2012-02-08 09:54:15 -05:00
if ( ! current_user_can ( $post_type -> cap -> delete_post , $post_id ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this post.' ) );
$result = wp_delete_post ( $post_id );
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'The post cannot be deleted.' ) );
return true ;
}
/**
* Retrieve a post .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* The optional $fields parameter specifies what fields will be included
* in the response array . This should be a list of field names . 'post_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 'post' ( all basic fields ), 'taxonomies' , 'custom_fields' ,
* and 'enclosure' .
*
* @ uses wp_get_single_post ()
* @ param array $args Method parameters . Contains :
* - int $post_id
* - string $username
* - string $password
* - array $fields optional
* @ return array contains ( based on $fields parameter ) :
* - 'post_id'
* - 'post_title'
* - 'post_date'
* - 'post_date_gmt'
* - 'post_modified'
* - 'post_modified_gmt'
* - 'post_status'
* - 'post_type'
* - 'post_name'
* - 'post_author'
* - 'post_password'
* - 'post_excerpt'
* - 'post_content'
* - 'link'
* - 'comment_status'
* - 'ping_status'
* - 'sticky'
* - 'custom_fields'
* - 'terms'
* - 'categories'
* - 'tags'
* - 'enclosure'
*/
function wp_getPost ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
$fields = apply_filters ( 'xmlrpc_default_post_fields' , array ( 'post' , 'terms' , 'custom_fields' ), 'wp.getPost' );
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getPost' );
$post = wp_get_single_post ( $post_id , ARRAY_A );
2012-04-28 14:48:10 -04:00
if ( empty ( $post [ 'ID' ] ) )
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
$post_type = get_post_type_object ( $post [ 'post_type' ] );
if ( ! current_user_can ( $post_type -> cap -> edit_posts , $post_id ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit this post.' ) );
return $this -> _prepare_post ( $post , $fields );
}
/**
* Retrieve posts .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
* The optional $filter parameter modifies the query used to retrieve posts .
* Accepted keys are 'post_type' , 'post_status' , 'number' , 'offset' ,
* 'orderby' , and 'order' .
*
* The optional $fields parameter specifies what fields will be included
* in the response array .
*
* @ uses wp_get_recent_posts ()
* @ see wp_getPost () for more on $fields
* @ see get_posts () for more on $filter values
*
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - array $filter optional
* - array $fields optional
2012-04-28 14:48:10 -04:00
* @ return array contains a collection of posts .
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
*/
function wp_getPosts ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 3 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ();
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
$fields = apply_filters ( 'xmlrpc_default_post_fields' , array ( 'post' , 'terms' , 'custom_fields' ), 'wp.getPosts' );
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getPosts' );
$query = array ();
if ( isset ( $filter [ 'post_type' ] ) ) {
$post_type = get_post_type_object ( $filter [ 'post_type' ] );
if ( ! ( ( bool ) $post_type ) )
return new IXR_Error ( 403 , __ ( 'The post type specified is not valid' ) );
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts in this post type' ));
$query [ 'post_type' ] = $filter [ 'post_type' ];
}
if ( isset ( $filter [ 'post_status' ] ) )
$query [ 'post_status' ] = $filter [ 'post_status' ];
if ( isset ( $filter [ 'number' ] ) )
$query [ 'number' ] = absint ( $filter [ 'number' ] );
if ( isset ( $filter [ 'offset' ] ) )
$query [ 'offset' ] = absint ( $filter [ 'offset' ] );
if ( isset ( $filter [ 'orderby' ] ) ) {
$query [ 'orderby' ] = $filter [ 'orderby' ];
if ( isset ( $filter [ 'order' ] ) )
$query [ 'order' ] = $filter [ 'order' ];
}
$posts_list = wp_get_recent_posts ( $query );
if ( ! $posts_list )
2012-03-02 13:06:30 -05:00
return array ();
XMLRPC: Introduce new create,read,update and delete XMLRPC apis for Posts, Pages and all Custom Post Types.
Introduces: wp.newPost, wp.editPost, wp.deletePost, wp.getPost, and wp.getPosts
See #18429, #18430, #18431, #18432, and #18433 props maxcutler and markoheijnen.
git-svn-id: http://svn.automattic.com/wordpress/trunk@19848 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-02-07 06:33:39 -05:00
// holds all the posts data
$struct = array ();
foreach ( $posts_list as $post ) {
$post_type = get_post_type_object ( $post [ 'post_type' ] );
if ( ! current_user_can ( $post_type -> cap -> edit_posts , $post [ 'ID' ] ) )
continue ;
$struct [] = $this -> _prepare_post ( $post , $fields );
}
return $struct ;
}
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
/**
* Create a new term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses wp_insert_term ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - array $content_struct
* The $content_struct must contain :
* - 'name'
* - 'taxonomy'
* Also , it can optionally contain :
* - 'parent'
* - 'description'
* - 'slug'
* @ return string term_id
*/
function wp_newTerm ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$content_struct = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.newTerm' );
if ( ! taxonomy_exists ( $content_struct [ 'taxonomy' ] ) )
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
$taxonomy = get_taxonomy ( $content_struct [ 'taxonomy' ] );
if ( ! current_user_can ( $taxonomy -> cap -> manage_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to create terms in this taxonomy.' ) );
$taxonomy = ( array ) $taxonomy ;
// hold the data of the term
$term_data = array ();
$term_data [ 'name' ] = trim ( $content_struct [ 'name' ] );
if ( empty ( $term_data [ 'name' ] ) )
return new IXR_Error ( 403 , __ ( 'The term name cannot be empty.' ) );
if ( isset ( $content_struct [ 'parent' ] ) ) {
if ( ! $taxonomy [ 'hierarchical' ] )
return new IXR_Error ( 403 , __ ( 'This taxonomy is not hierarchical.' ) );
$parent_term_id = ( int ) $content_struct [ 'parent' ];
$parent_term = get_term ( $parent_term_id , $taxonomy [ 'name' ] );
if ( is_wp_error ( $parent_term ) )
return new IXR_Error ( 500 , $parent_term -> get_error_message () );
if ( ! $parent_term )
return new IXR_Error ( 403 , __ ( 'Parent term does not exist.' ) );
$term_data [ 'parent' ] = $content_struct [ 'parent' ];
}
if ( isset ( $content_struct [ 'description' ] ) )
$term_data [ 'description' ] = $content_struct [ 'description' ];
if ( isset ( $content_struct [ 'slug' ] ) )
$term_data [ 'slug' ] = $content_struct [ 'slug' ];
$term = wp_insert_term ( $term_data [ 'name' ] , $taxonomy [ 'name' ] , $term_data );
if ( is_wp_error ( $term ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $term )
return new IXR_Error ( 500 , __ ( 'Sorry, your term could not be created. Something wrong happened.' ) );
return strval ( $term [ 'term_id' ] );
}
/**
* Edit a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses wp_update_term ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - string $term_id
* - array $content_struct
* The $content_struct must contain :
* - 'taxonomy'
* Also , it can optionally contain :
* - 'name'
* - 'parent'
* - 'description'
* - 'slug'
* @ return bool True , on success .
*/
function wp_editTerm ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 5 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$term_id = ( int ) $args [ 3 ];
$content_struct = $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.editTerm' );
if ( ! taxonomy_exists ( $content_struct [ 'taxonomy' ] ) )
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
$taxonomy = get_taxonomy ( $content_struct [ 'taxonomy' ] );
if ( ! current_user_can ( $taxonomy -> cap -> edit_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to edit terms in this taxonomy.' ) );
$taxonomy = ( array ) $taxonomy ;
// hold the data of the term
$term_data = array ();
$term = get_term ( $term_id , $content_struct [ 'taxonomy' ] );
if ( is_wp_error ( $term ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $term )
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
if ( isset ( $content_struct [ 'name' ] ) ) {
$term_data [ 'name' ] = trim ( $content_struct [ 'name' ] );
if ( empty ( $term_data [ 'name' ] ) )
return new IXR_Error ( 403 , __ ( 'The term name cannot be empty.' ) );
}
if ( isset ( $content_struct [ 'parent' ] ) ) {
if ( ! $taxonomy [ 'hierarchical' ] )
return new IXR_Error ( 403 , __ ( " This taxonomy is not hierarchical so you can't set a parent. " ) );
$parent_term_id = ( int ) $content_struct [ 'parent' ];
$parent_term = get_term ( $parent_term_id , $taxonomy [ 'name' ] );
if ( is_wp_error ( $parent_term ) )
return new IXR_Error ( 500 , $parent_term -> get_error_message () );
if ( ! $parent_term )
return new IXR_Error ( 403 , __ ( 'Parent term does not exist.' ) );
$term_data [ 'parent' ] = $content_struct [ 'parent' ];
}
if ( isset ( $content_struct [ 'description' ] ) )
$term_data [ 'description' ] = $content_struct [ 'description' ];
if ( isset ( $content_struct [ 'slug' ] ) )
$term_data [ 'slug' ] = $content_struct [ 'slug' ];
$term = wp_update_term ( $term_id , $taxonomy [ 'name' ] , $term_data );
if ( is_wp_error ( $term ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $term )
return new IXR_Error ( 500 , __ ( 'Sorry, editing the term failed.' ) );
return true ;
}
/**
* Delete a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses wp_delete_term ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - string $taxnomy_name
* - string $term_id
* @ return boolean | IXR_Error If it suceeded true else a reason why not
*/
function wp_deleteTerm ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 5 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-15 12:47:31 -04:00
$taxonomy = $args [ 3 ];
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$term_id = ( int ) $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.deleteTerm' );
2012-04-15 12:47:31 -04:00
if ( ! taxonomy_exists ( $taxonomy ) )
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$taxonomy = get_taxonomy ( $taxonomy );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> delete_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to delete terms in this taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$term = get_term ( $term_id , $taxonomy -> name );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( is_wp_error ( $term ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $term )
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
2012-04-15 12:47:31 -04:00
$result = wp_delete_term ( $term_id , $taxonomy -> name );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( is_wp_error ( $result ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'Sorry, deleting the term failed.' ) );
return $result ;
}
/**
* Retrieve a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses get_term ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
2012-04-15 12:47:31 -04:00
* - string $taxonomy
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* - string $term_id
* @ return array contains :
* - 'term_id'
* - 'name'
* - 'slug'
* - 'term_group'
* - 'term_taxonomy_id'
* - 'taxonomy'
* - 'description'
* - 'parent'
* - 'count'
*/
function wp_getTerm ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 5 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-15 12:47:31 -04:00
$taxonomy = $args [ 3 ];
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$term_id = ( int ) $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getTerm' );
2012-04-15 12:47:31 -04:00
if ( ! taxonomy_exists ( $taxonomy ) )
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$taxonomy = get_taxonomy ( $taxonomy );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to assign terms in this taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$term = get_term ( $term_id , $taxonomy -> name , ARRAY_A );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( is_wp_error ( $term ) )
return new IXR_Error ( 500 , $term -> get_error_message () );
if ( ! $term )
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
return $this -> _prepare_term ( $term );
}
/**
* Retrieve all terms for a taxonomy .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* The optional $filter parameter modifies the query used to retrieve terms .
* Accepted keys are 'number' , 'offset' , 'orderby' , 'order' , 'hide_empty' , and 'search' .
*
* @ uses get_terms ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
2012-04-15 12:47:31 -04:00
* - string $taxonomy
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* - array $filter optional
* @ return array terms
*/
function wp_getTerms ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-15 12:47:31 -04:00
$taxonomy = $args [ 3 ];
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$filter = isset ( $args [ 4 ] ) ? $args [ 4 ] : array ();
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getTerms' );
2012-04-15 12:47:31 -04:00
if ( ! taxonomy_exists ( $taxonomy ) )
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$taxonomy = get_taxonomy ( $taxonomy );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to assign terms in this taxonomy.' ) );
$query = array ();
if ( isset ( $filter [ 'number' ] ) )
$query [ 'number' ] = absint ( $filter [ 'number' ] );
if ( isset ( $filter [ 'offset' ] ) )
$query [ 'offset' ] = absint ( $filter [ 'offset' ] );
if ( isset ( $filter [ 'orderby' ] ) ) {
$query [ 'orderby' ] = $filter [ 'orderby' ];
if ( isset ( $filter [ 'order' ] ) )
$query [ 'order' ] = $filter [ 'order' ];
}
if ( isset ( $filter [ 'hide_empty' ] ) )
$query [ 'hide_empty' ] = $filter [ 'hide_empty' ];
else
$query [ 'get' ] = 'all' ;
if ( isset ( $filter [ 'search' ] ) )
$query [ 'search' ] = $filter [ 'search' ];
2012-04-15 12:47:31 -04:00
$terms = get_terms ( $taxonomy -> name , $query );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( is_wp_error ( $terms ) )
return new IXR_Error ( 500 , $terms -> get_error_message () );
$struct = array ();
foreach ( $terms as $term ) {
$struct [] = $this -> _prepare_term ( $term );
}
return $struct ;
}
/**
* Retrieve a taxonomy .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses get_taxonomy ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
2012-04-15 12:47:31 -04:00
* - string $taxonomy
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ return array ( @ see get_taxonomy ())
*/
function wp_getTaxonomy ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-15 12:47:31 -04:00
$taxonomy = $args [ 3 ];
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
2012-04-28 14:48:10 -04:00
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_taxonomy_fields' , array ( 'labels' , 'cap' , 'object_type' ), 'wp.getTaxonomy' );
2012-04-28 14:48:10 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getTaxonomy' );
2012-04-15 12:47:31 -04:00
if ( ! taxonomy_exists ( $taxonomy ) )
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2012-04-15 12:47:31 -04:00
$taxonomy = get_taxonomy ( $taxonomy );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) )
return new IXR_Error ( 401 , __ ( 'You are not allowed to assign terms in this taxonomy.' ) );
2012-04-28 14:48:10 -04:00
return $this -> _prepare_taxonomy ( $taxonomy , $fields );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
}
/**
* Retrieve all taxonomies .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
* @ uses get_taxonomies ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* @ return array taxonomies
*/
function wp_getTaxonomies ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 3 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-28 14:48:10 -04:00
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ( 'public' => true );
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_taxonomy_fields' , array ( 'labels' , 'cap' , 'object_type' ), 'wp.getTaxonomies' );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getTaxonomies' );
2012-04-28 14:48:10 -04:00
$taxonomies = get_taxonomies ( $filter , 'objects' );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
// holds all the taxonomy data
$struct = array ();
foreach ( $taxonomies as $taxonomy ) {
// capability check for post_types
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) )
continue ;
2012-04-28 14:48:10 -04:00
$struct [] = $this -> _prepare_taxonomy ( $taxonomy , $fields );
XML-RPC: Initial implementation of Taxonomy and Term APIs.
Implements: wp.newTerm, wp.editTerm, wp.deleteTerm, wp.getTerm, wp.getTerms, wp.getTaxonomy and wp.getTaxonomies
See: #18438, #18439, #18440, #18441, #18442, #18443, and #18444 props maxcutler, markoheijnen and nprasath002.
git-svn-id: http://svn.automattic.com/wordpress/trunk@20137 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2012-03-07 12:02:22 -05:00
}
return $struct ;
}
2010-09-23 17:22:21 -04:00
/**
* Retrieve page .
*
* @ since 2.2 . 0
*
2011-04-18 03:23:47 -04:00
* @ param array $args Method parameters . Contains :
* - blog_id
* - page_id
* - username
* - password
2010-09-23 17:22:21 -04:00
* @ return array
*/
function wp_getPage ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$page_id = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) ) {
return $this -> error ;
}
2012-04-29 20:19:32 -04:00
$page = get_page ( $page_id );
if ( ! $page )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2010-09-23 17:22:21 -04:00
if ( ! current_user_can ( 'edit_page' , $page_id ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit this page.' ) );
do_action ( 'xmlrpc_call' , 'wp.getPage' );
// If we found the page then format the data.
2011-05-06 15:51:47 -04:00
if ( $page -> ID && ( $page -> post_type == 'page' ) ) {
2010-09-23 17:22:21 -04:00
// Get all of the page content and link.
$full_page = get_extended ( $page -> post_content );
$link = post_permalink ( $page -> ID );
// Get info the page parent if there is one.
$parent_title = " " ;
if ( ! empty ( $page -> post_parent ) ) {
$parent = get_page ( $page -> post_parent );
$parent_title = $parent -> post_title ;
}
// Determine comment and ping settings.
$allow_comments = comments_open ( $page -> ID ) ? 1 : 0 ;
$allow_pings = pings_open ( $page -> ID ) ? 1 : 0 ;
// Format page date.
2012-04-04 17:32:28 -04:00
$page_date = $this -> _convert_date ( $page -> post_date );
$page_date_gmt = $this -> _convert_date_gmt ( $page -> post_date_gmt , $page -> post_date );
2010-09-23 17:22:21 -04:00
// Pull the categories info together.
$categories = array ();
foreach ( wp_get_post_categories ( $page -> ID ) as $cat_id ) {
$categories [] = get_cat_name ( $cat_id );
}
// Get the author info.
$author = get_userdata ( $page -> post_author );
2012-03-02 13:56:54 -05:00
$page_template = get_page_template_slug ( $page -> ID );
2010-09-23 17:22:21 -04:00
if ( empty ( $page_template ) )
$page_template = 'default' ;
$page_struct = array (
2012-04-04 17:32:28 -04:00
'dateCreated' => $page_date ,
2011-05-06 15:51:47 -04:00
'userid' => $page -> post_author ,
'page_id' => $page -> ID ,
'page_status' => $page -> post_status ,
'description' => $full_page [ 'main' ],
'title' => $page -> post_title ,
'link' => $link ,
'permaLink' => $link ,
'categories' => $categories ,
'excerpt' => $page -> post_excerpt ,
'text_more' => $full_page [ 'extended' ],
'mt_allow_comments' => $allow_comments ,
'mt_allow_pings' => $allow_pings ,
'wp_slug' => $page -> post_name ,
'wp_password' => $page -> post_password ,
'wp_author' => $author -> display_name ,
'wp_page_parent_id' => $page -> post_parent ,
'wp_page_parent_title' => $parent_title ,
'wp_page_order' => $page -> menu_order ,
2011-10-27 14:36:49 -04:00
'wp_author_id' => ( string ) $author -> ID ,
2011-05-06 15:51:47 -04:00
'wp_author_display_name' => $author -> display_name ,
2012-04-04 17:32:28 -04:00
'date_created_gmt' => $page_date_gmt ,
2011-05-06 15:51:47 -04:00
'custom_fields' => $this -> get_custom_fields ( $page_id ),
'wp_page_template' => $page_template
2010-09-23 17:22:21 -04:00
);
return ( $page_struct );
}
// If the page doesn't exist indicate that.
else {
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 404 , __ ( 'Sorry, no such page.' )));
2010-09-23 17:22:21 -04:00
}
}
/**
* Retrieve Pages .
*
* @ since 2.2 . 0
*
2011-04-18 03:23:47 -04:00
* @ param array $args Method parameters . Contains :
* - blog_id
* - username
* - password
* - num_pages
2010-09-23 17:22:21 -04:00
* @ return array
*/
function wp_getPages ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$num_pages = isset ( $args [ 3 ]) ? ( int ) $args [ 3 ] : 10 ;
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_pages' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit pages.' ) );
do_action ( 'xmlrpc_call' , 'wp.getPages' );
$pages = get_posts ( array ( 'post_type' => 'page' , 'post_status' => 'any' , 'numberposts' => $num_pages ) );
$num_pages = count ( $pages );
// If we have pages, put together their info.
if ( $num_pages >= 1 ) {
$pages_struct = array ();
for ( $i = 0 ; $i < $num_pages ; $i ++ ) {
$page = wp_xmlrpc_server :: wp_getPage ( array (
$blog_id , $pages [ $i ] -> ID , $username , $password
));
$pages_struct [] = $page ;
}
return ( $pages_struct );
}
// If no pages were found return an error.
else {
return ( array ());
}
}
/**
* Create new page .
*
* @ since 2.2 . 0
*
2011-04-18 03:23:47 -04:00
* @ param array $args Method parameters . See { @ link wp_xmlrpc_server :: mw_newPost ()}
2010-09-23 17:22:21 -04:00
* @ return unknown
*/
function wp_newPage ( $args ) {
// Items not escaped here will be escaped in newPost.
$username = $this -> escape ( $args [ 1 ]);
$password = $this -> escape ( $args [ 2 ]);
$page = $args [ 3 ];
$publish = $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.newPage' );
// Mark this as content for a page.
2011-05-06 15:51:47 -04:00
$args [ 3 ][ " post_type " ] = 'page' ;
2010-09-23 17:22:21 -04:00
// Let mw_newPost do all of the heavy lifting.
return ( $this -> mw_newPost ( $args ));
}
/**
* Delete page .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return bool True , if success .
*/
function wp_deletePage ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$page_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.deletePage' );
// Get the current page based on the page_id and
// make sure it is a page and not a post.
$actual_page = wp_get_single_post ( $page_id , ARRAY_A );
2011-05-06 15:51:47 -04:00
if ( ! $actual_page || ( $actual_page [ 'post_type' ] != 'page' ) )
return ( new IXR_Error ( 404 , __ ( 'Sorry, no such page.' )));
2010-09-23 17:22:21 -04:00
// Make sure the user can delete pages.
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'delete_page' , $page_id ) )
return ( new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to delete this page.' )));
2010-09-23 17:22:21 -04:00
// Attempt to delete the page.
$result = wp_delete_post ( $page_id );
if ( ! $result )
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 500 , __ ( 'Failed to delete the page.' )));
2010-09-23 17:22:21 -04:00
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_wp_deletePage' , $page_id , $args );
2010-09-23 17:22:21 -04:00
return ( true );
}
/**
* Edit page .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return unknown
*/
function wp_editPage ( $args ) {
// Items not escaped here will be escaped in editPost.
$blog_id = ( int ) $args [ 0 ];
$page_id = ( int ) $this -> escape ( $args [ 1 ]);
$username = $this -> escape ( $args [ 2 ]);
$password = $this -> escape ( $args [ 3 ]);
$content = $args [ 4 ];
$publish = $args [ 5 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.editPage' );
// Get the page data and make sure it is a page.
$actual_page = wp_get_single_post ( $page_id , ARRAY_A );
2011-05-06 15:51:47 -04:00
if ( ! $actual_page || ( $actual_page [ 'post_type' ] != 'page' ) )
return ( new IXR_Error ( 404 , __ ( 'Sorry, no such page.' )));
2010-09-23 17:22:21 -04:00
// Make sure the user is allowed to edit pages.
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'edit_page' , $page_id ) )
return ( new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to edit this page.' )));
2010-09-23 17:22:21 -04:00
// Mark this as content for a page.
2011-05-06 15:51:47 -04:00
$content [ 'post_type' ] = 'page' ;
2010-09-23 17:22:21 -04:00
// Arrange args in the way mw_editPost understands.
$args = array (
$page_id ,
$username ,
$password ,
$content ,
$publish
);
// Let mw_editPost do all of the heavy lifting.
return ( $this -> mw_editPost ( $args ));
}
/**
* Retrieve page list .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return unknown
*/
function wp_getPageList ( $args ) {
global $wpdb ;
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_pages' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit pages.' ) );
do_action ( 'xmlrpc_call' , 'wp.getPageList' );
// Get list of pages ids and titles
$page_list = $wpdb -> get_results ( "
SELECT ID page_id ,
post_title page_title ,
post_parent page_parent_id ,
post_date_gmt ,
post_date ,
post_status
FROM { $wpdb -> posts }
WHERE post_type = 'page'
ORDER BY ID
" );
2011-09-03 12:02:41 -04:00
// The date needs to be formatted properly.
2010-09-23 17:22:21 -04:00
$num_pages = count ( $page_list );
for ( $i = 0 ; $i < $num_pages ; $i ++ ) {
2012-04-04 17:32:28 -04:00
$page_list [ $i ] -> dateCreated = $this -> _convert_date ( $page_list [ $i ] -> post_date );
$page_list [ $i ] -> date_created_gmt = $this -> _convert_date_gmt ( $page_list [ $i ] -> post_date_gmt , $page_list [ $i ] -> post_date );
2010-09-23 17:22:21 -04:00
unset ( $page_list [ $i ] -> post_date_gmt );
unset ( $page_list [ $i ] -> post_date );
unset ( $page_list [ $i ] -> post_status );
}
return ( $page_list );
}
/**
* Retrieve authors list .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getAuthors ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'edit_posts' ) )
return ( new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit posts on this site.' )));
2010-09-23 17:22:21 -04:00
do_action ( 'xmlrpc_call' , 'wp.getAuthors' );
$authors = array ();
2010-12-16 18:43:24 -05:00
foreach ( get_users ( array ( 'fields' => array ( 'ID' , 'user_login' , 'display_name' ) ) ) as $user ) {
2010-09-23 17:22:21 -04:00
$authors [] = array (
2011-05-06 15:51:47 -04:00
'user_id' => $user -> ID ,
'user_login' => $user -> user_login ,
'display_name' => $user -> display_name
2010-09-23 17:22:21 -04:00
);
}
return $authors ;
}
/**
* Get list of all tags
*
2012-04-28 14:48:10 -04:00
* @ since 2.7 . 0
2010-09-23 17:22:21 -04:00
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getTags ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view tags.' ) );
do_action ( 'xmlrpc_call' , 'wp.getKeywords' );
2012-03-02 13:06:30 -05:00
$tags = array ();
2010-09-23 17:22:21 -04:00
if ( $all_tags = get_tags () ) {
foreach ( ( array ) $all_tags as $tag ) {
$struct [ 'tag_id' ] = $tag -> term_id ;
$struct [ 'name' ] = $tag -> name ;
$struct [ 'count' ] = $tag -> count ;
$struct [ 'slug' ] = $tag -> slug ;
$struct [ 'html_url' ] = esc_html ( get_tag_link ( $tag -> term_id ) );
$struct [ 'rss_url' ] = esc_html ( get_tag_feed_link ( $tag -> term_id ) );
$tags [] = $struct ;
}
}
return $tags ;
}
/**
* Create new category .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return int Category ID .
*/
function wp_newCategory ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$category = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.newCategory' );
// Make sure the user is allowed to add a category.
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'manage_categories' ) )
return ( new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to add a category.' )));
2010-09-23 17:22:21 -04:00
// If no slug was provided make it empty so that
// WordPress will generate one.
2011-05-06 15:51:47 -04:00
if ( empty ( $category [ 'slug' ]) )
$category [ 'slug' ] = '' ;
2010-09-23 17:22:21 -04:00
// If no parent_id was provided make it empty
// so that it will be a top level page (no parent).
2011-05-06 15:51:47 -04:00
if ( ! isset ( $category [ 'parent_id' ]) )
$category [ 'parent_id' ] = '' ;
2010-09-23 17:22:21 -04:00
// If no description was provided make it empty.
if ( empty ( $category [ " description " ]) )
$category [ " description " ] = " " ;
$new_category = array (
2011-05-06 15:51:47 -04:00
'cat_name' => $category [ 'name' ],
'category_nicename' => $category [ 'slug' ],
'category_parent' => $category [ 'parent_id' ],
'category_description' => $category [ 'description' ]
2010-09-23 17:22:21 -04:00
);
$cat_id = wp_insert_category ( $new_category , true );
if ( is_wp_error ( $cat_id ) ) {
if ( 'term_exists' == $cat_id -> get_error_code () )
return ( int ) $cat_id -> get_error_data ();
else
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 500 , __ ( 'Sorry, the new category failed.' )));
2010-09-23 17:22:21 -04:00
} elseif ( ! $cat_id ) {
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 500 , __ ( 'Sorry, the new category failed.' )));
2010-09-23 17:22:21 -04:00
}
2012-03-08 08:12:06 -05:00
do_action ( 'xmlrpc_call_success_wp_newCategory' , $cat_id , $args );
return $cat_id ;
2010-09-23 17:22:21 -04:00
}
/**
* Remove category .
*
* @ since 2.5 . 0
*
* @ param array $args Method parameters .
2010-10-03 03:29:44 -04:00
* @ return mixed See { @ link wp_delete_term ()} for return info .
2010-09-23 17:22:21 -04:00
*/
function wp_deleteCategory ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$category_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.deleteCategory' );
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'manage_categories' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to delete a category.' ) );
2010-09-23 17:22:21 -04:00
2012-03-08 08:12:06 -05:00
$status = wp_delete_term ( $category_id , 'category' );
if ( true == $status )
do_action ( 'xmlrpc_call_success_wp_deleteCategory' , $category_id , $args );
return $status ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve category list .
*
* @ since 2.2 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_suggestCategories ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$category = $args [ 3 ];
$max_results = ( int ) $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts to this site in order to view categories.' ) );
do_action ( 'xmlrpc_call' , 'wp.suggestCategories' );
$category_suggestions = array ();
$args = array ( 'get' => 'all' , 'number' => $max_results , 'name__like' => $category );
foreach ( ( array ) get_categories ( $args ) as $cat ) {
$category_suggestions [] = array (
2011-05-06 15:51:47 -04:00
'category_id' => $cat -> term_id ,
'category_name' => $cat -> name
2010-09-23 17:22:21 -04:00
);
}
return ( $category_suggestions );
}
/**
* Retrieve comment .
*
* @ since 2.7 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getComment ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'moderate_comments' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to moderate comments on this site.' ) );
do_action ( 'xmlrpc_call' , 'wp.getComment' );
if ( ! $comment = get_comment ( $comment_id ) )
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
// Format page date.
2012-04-04 17:32:28 -04:00
$comment_date = $this -> _convert_date ( $comment -> comment_date );
$comment_date_gmt = $this -> _convert_date_gmt ( $comment -> comment_date_gmt , $comment -> comment_date );
2010-09-23 17:22:21 -04:00
if ( '0' == $comment -> comment_approved )
$comment_status = 'hold' ;
else if ( 'spam' == $comment -> comment_approved )
$comment_status = 'spam' ;
else if ( '1' == $comment -> comment_approved )
$comment_status = 'approve' ;
else
$comment_status = $comment -> comment_approved ;
$link = get_comment_link ( $comment );
$comment_struct = array (
2012-04-04 17:32:28 -04:00
'date_created_gmt' => $comment_date_gmt ,
2011-05-06 15:51:47 -04:00
'user_id' => $comment -> user_id ,
'comment_id' => $comment -> comment_ID ,
'parent' => $comment -> comment_parent ,
'status' => $comment_status ,
'content' => $comment -> comment_content ,
'link' => $link ,
'post_id' => $comment -> comment_post_ID ,
'post_title' => get_the_title ( $comment -> comment_post_ID ),
'author' => $comment -> comment_author ,
'author_url' => $comment -> comment_author_url ,
'author_email' => $comment -> comment_author_email ,
'author_ip' => $comment -> comment_author_IP ,
'type' => $comment -> comment_type ,
2010-09-23 17:22:21 -04:00
);
return $comment_struct ;
}
/**
* Retrieve comments .
*
2011-04-18 03:26:42 -04:00
* 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 .
2011-06-10 19:01:45 -04:00
*
2010-09-23 17:22:21 -04:00
* @ since 2.7 . 0
*
* @ param array $args Method parameters .
2011-04-18 03:26:42 -04:00
* @ return array . Contains a collection of comments . See { @ link wp_xmlrpc_server :: wp_getComment ()} for a description of each item contents
2010-09-23 17:22:21 -04:00
*/
function wp_getComments ( $args ) {
$raw_args = $args ;
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$struct = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'moderate_comments' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit comments.' ) );
do_action ( 'xmlrpc_call' , 'wp.getComments' );
if ( isset ( $struct [ 'status' ]) )
$status = $struct [ 'status' ];
else
$status = '' ;
$post_id = '' ;
if ( isset ( $struct [ 'post_id' ]) )
$post_id = absint ( $struct [ 'post_id' ]);
$offset = 0 ;
if ( isset ( $struct [ 'offset' ]) )
$offset = absint ( $struct [ 'offset' ]);
$number = 10 ;
if ( isset ( $struct [ 'number' ]) )
$number = absint ( $struct [ 'number' ]);
$comments = get_comments ( array ( 'status' => $status , 'post_id' => $post_id , 'offset' => $offset , 'number' => $number ) );
$num_comments = count ( $comments );
if ( ! $num_comments )
return array ();
$comments_struct = array ();
2012-05-02 17:13:08 -04:00
// FIXME: we already have the comments, why query them again?
2010-09-23 17:22:21 -04:00
for ( $i = 0 ; $i < $num_comments ; $i ++ ) {
$comment = wp_xmlrpc_server :: wp_getComment ( array (
$raw_args [ 0 ], $raw_args [ 1 ], $raw_args [ 2 ], $comments [ $i ] -> comment_ID ,
));
$comments_struct [] = $comment ;
}
return $comments_struct ;
}
/**
2011-04-18 03:26:42 -04:00
* 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 .
2010-09-23 17:22:21 -04:00
*
* @ since 2.7 . 0
*
2011-04-18 03:26:42 -04:00
* @ param array $args Method parameters . Contains :
* - blog_id
* - username
* - password
* - comment_id
2010-09-23 17:22:21 -04:00
* @ return mixed { @ link wp_delete_comment ()}
*/
function wp_deleteComment ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_ID = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'moderate_comments' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to moderate comments on this site.' ) );
2011-08-23 06:22:34 -04:00
if ( ! get_comment ( $comment_ID ) )
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
2010-12-08 11:52:08 -05:00
if ( ! current_user_can ( 'edit_comment' , $comment_ID ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to moderate comments on this site.' ) );
2010-12-13 16:21:50 -05:00
2010-09-23 17:22:21 -04:00
do_action ( 'xmlrpc_call' , 'wp.deleteComment' );
2012-03-08 08:12:06 -05:00
$status = wp_delete_comment ( $comment_ID );
if ( true == $status )
do_action ( 'xmlrpc_call_success_wp_deleteComment' , $comment_ID , $args );
return $status ;
2010-09-23 17:22:21 -04:00
}
/**
* Edit comment .
*
2011-06-10 19:01:45 -04:00
* Besides the common blog_id , username , and password arguments , it takes a
2011-04-18 03:26:42 -04:00
* 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
*
2010-09-23 17:22:21 -04:00
* @ since 2.7 . 0
*
2011-04-18 03:26:42 -04:00
* @ param array $args . Contains :
* - blog_id
* - username
* - password
* - comment_id
* - content_struct
2010-09-23 17:22:21 -04:00
* @ return bool True , on success .
*/
function wp_editComment ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_ID = ( int ) $args [ 3 ];
$content_struct = $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'moderate_comments' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to moderate comments on this site.' ) );
2011-08-23 06:22:34 -04:00
if ( ! get_comment ( $comment_ID ) )
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
2010-12-08 11:52:08 -05:00
if ( ! current_user_can ( 'edit_comment' , $comment_ID ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to moderate comments on this site.' ) );
2010-12-13 16:21:50 -05:00
2010-09-23 17:22:21 -04:00
do_action ( 'xmlrpc_call' , 'wp.editComment' );
if ( isset ( $content_struct [ 'status' ]) ) {
$statuses = get_comment_statuses ();
$statuses = array_keys ( $statuses );
if ( ! in_array ( $content_struct [ 'status' ], $statuses ) )
return new IXR_Error ( 401 , __ ( 'Invalid comment status.' ) );
$comment_approved = $content_struct [ 'status' ];
}
// Do some timestamp voodoo
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) ) {
2012-04-28 14:48:10 -04:00
// We know this is supposed to be GMT, so we're going to slap that Z on there by force
2012-04-30 21:11:18 -04:00
$dateCreated = rtrim ( $content_struct [ 'date_created_gmt' ] -> getIso (), 'Z' ) . 'Z' ;
2010-09-23 17:22:21 -04:00
$comment_date = get_date_from_gmt ( iso8601_to_datetime ( $dateCreated ));
2010-12-06 11:32:25 -05:00
$comment_date_gmt = iso8601_to_datetime ( $dateCreated , 'GMT' );
2010-09-23 17:22:21 -04:00
}
if ( isset ( $content_struct [ 'content' ]) )
$comment_content = $content_struct [ 'content' ];
if ( isset ( $content_struct [ 'author' ]) )
$comment_author = $content_struct [ 'author' ];
if ( isset ( $content_struct [ 'author_url' ]) )
$comment_author_url = $content_struct [ 'author_url' ];
if ( isset ( $content_struct [ 'author_email' ]) )
$comment_author_email = $content_struct [ 'author_email' ];
// We've got all the data -- post it:
$comment = compact ( 'comment_ID' , 'comment_content' , 'comment_approved' , 'comment_date' , 'comment_date_gmt' , 'comment_author' , 'comment_author_email' , 'comment_author_url' );
$result = wp_update_comment ( $comment );
if ( is_wp_error ( $result ) )
return new IXR_Error ( 500 , $result -> get_error_message ());
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'Sorry, the comment could not be edited. Something wrong happened.' ));
2012-03-08 08:12:06 -05:00
do_action ( 'xmlrpc_call_success_wp_editComment' , $comment_ID , $args );
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Create new comment .
*
* @ since 2.7 . 0
*
* @ param array $args Method parameters .
* @ return mixed { @ link wp_new_comment ()}
*/
function wp_newComment ( $args ) {
global $wpdb ;
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$post = $args [ 3 ];
$content_struct = $args [ 4 ];
$allow_anon = apply_filters ( 'xmlrpc_allow_anonymous_comments' , false );
$user = $this -> login ( $username , $password );
if ( ! $user ) {
$logged_in = false ;
if ( $allow_anon && get_option ( 'comment_registration' ) )
return new IXR_Error ( 403 , __ ( 'You must be registered to comment' ) );
else if ( ! $allow_anon )
return $this -> error ;
} else {
$logged_in = true ;
}
if ( is_numeric ( $post ) )
$post_id = absint ( $post );
else
$post_id = url_to_postid ( $post );
if ( ! $post_id )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
if ( ! get_post ( $post_id ) )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
$comment [ 'comment_post_ID' ] = $post_id ;
if ( $logged_in ) {
$comment [ 'comment_author' ] = $wpdb -> escape ( $user -> display_name );
$comment [ 'comment_author_email' ] = $wpdb -> escape ( $user -> user_email );
$comment [ 'comment_author_url' ] = $wpdb -> escape ( $user -> user_url );
$comment [ 'user_ID' ] = $user -> ID ;
} else {
$comment [ 'comment_author' ] = '' ;
if ( isset ( $content_struct [ 'author' ]) )
$comment [ 'comment_author' ] = $content_struct [ 'author' ];
$comment [ 'comment_author_email' ] = '' ;
if ( isset ( $content_struct [ 'author_email' ]) )
$comment [ 'comment_author_email' ] = $content_struct [ 'author_email' ];
$comment [ 'comment_author_url' ] = '' ;
if ( isset ( $content_struct [ 'author_url' ]) )
$comment [ 'comment_author_url' ] = $content_struct [ 'author_url' ];
$comment [ 'user_ID' ] = 0 ;
if ( get_option ( 'require_name_email' ) ) {
if ( 6 > strlen ( $comment [ 'comment_author_email' ]) || '' == $comment [ 'comment_author' ] )
return new IXR_Error ( 403 , __ ( 'Comment author name and email are required' ) );
elseif ( ! is_email ( $comment [ 'comment_author_email' ]) )
return new IXR_Error ( 403 , __ ( 'A valid email address is required' ) );
}
}
$comment [ 'comment_parent' ] = isset ( $content_struct [ 'comment_parent' ]) ? absint ( $content_struct [ 'comment_parent' ]) : 0 ;
2010-12-08 17:00:40 -05:00
$comment [ 'comment_content' ] = isset ( $content_struct [ 'content' ]) ? $content_struct [ 'content' ] : null ;
2010-09-23 17:22:21 -04:00
do_action ( 'xmlrpc_call' , 'wp.newComment' );
2012-03-08 08:12:06 -05:00
$comment_ID = wp_new_comment ( $comment );
do_action ( 'xmlrpc_call_success_wp_newComment' , $comment_ID , $args );
return $comment_ID ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve all of the comment status .
*
* @ since 2.7 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getCommentStatusList ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'moderate_comments' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about this site.' ) );
do_action ( 'xmlrpc_call' , 'wp.getCommentStatusList' );
2012-03-02 13:06:30 -05:00
return get_comment_statuses ();
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve comment count .
*
* @ since 2.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getCommentCount ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about comments.' ) );
do_action ( 'xmlrpc_call' , 'wp.getCommentCount' );
$count = wp_count_comments ( $post_id );
return array (
2011-05-06 15:51:47 -04:00
'approved' => $count -> approved ,
'awaiting_moderation' => $count -> moderated ,
'spam' => $count -> spam ,
'total_comments' => $count -> total_comments
2010-09-23 17:22:21 -04:00
);
}
/**
* Retrieve post statuses .
*
* @ since 2.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getPostStatusList ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about this site.' ) );
do_action ( 'xmlrpc_call' , 'wp.getPostStatusList' );
2012-03-02 13:06:30 -05:00
return get_post_statuses ();
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve page statuses .
*
* @ since 2.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getPageStatusList ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2010-12-08 11:18:42 -05:00
if ( ! current_user_can ( 'edit_pages' ) )
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about this site.' ) );
do_action ( 'xmlrpc_call' , 'wp.getPageStatusList' );
2012-03-02 13:06:30 -05:00
return get_page_statuses ();
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve page templates .
*
* @ since 2.6 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getPageTemplates ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_pages' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about this site.' ) );
2012-03-02 13:06:30 -05:00
$templates = get_page_templates ();
2010-09-23 17:22:21 -04:00
$templates [ 'Default' ] = 'default' ;
return $templates ;
}
/**
* Retrieve blog options .
*
* @ since 2.6 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function wp_getOptions ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-10-26 10:43:20 -04:00
$options = isset ( $args [ 3 ] ) ? ( array ) $args [ 3 ] : array ();
2010-09-23 17:22:21 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
// If no specific options where asked for, return all of them
if ( count ( $options ) == 0 )
$options = array_keys ( $this -> blog_options );
return $this -> _getOptions ( $options );
}
/**
* Retrieve blog options value from list .
*
* @ since 2.6 . 0
*
* @ param array $options Options to retrieve .
* @ return array
*/
function _getOptions ( $options ) {
2012-03-02 13:06:30 -05:00
$data = array ();
2010-09-23 17:22:21 -04:00
foreach ( $options as $option ) {
if ( array_key_exists ( $option , $this -> blog_options ) ) {
$data [ $option ] = $this -> blog_options [ $option ];
//Is the value static or dynamic?
if ( isset ( $data [ $option ][ 'option' ] ) ) {
$data [ $option ][ 'value' ] = get_option ( $data [ $option ][ 'option' ] );
unset ( $data [ $option ][ 'option' ]);
}
}
}
return $data ;
}
/**
* Update blog options .
*
* @ since 2.6 . 0
*
* @ param array $args Method parameters .
* @ return unknown
*/
function wp_setOptions ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$options = ( array ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'manage_options' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed to update options.' ) );
foreach ( $options as $o_name => $o_value ) {
$option_names [] = $o_name ;
if ( ! array_key_exists ( $o_name , $this -> blog_options ) )
continue ;
if ( $this -> blog_options [ $o_name ][ 'readonly' ] == true )
continue ;
update_option ( $this -> blog_options [ $o_name ][ 'option' ], $o_value );
}
//Now return the updated values
return $this -> _getOptions ( $option_names );
}
2010-10-27 13:20:46 -04:00
/**
2010-10-28 08:12:59 -04:00
* Retrieve a media item by ID
2010-10-27 13:20:46 -04:00
*
* @ since 3.1 . 0
*
2010-11-17 13:47:34 -05:00
* @ param array $args Method parameters . Contains :
2010-10-28 08:12:59 -04:00
* - blog_id
* - username
* - password
* - attachment_id
2011-09-03 12:02:41 -04:00
* @ return array . Associative array containing :
2010-10-28 08:12:59 -04:00
* - 'date_created_gmt'
* - 'parent'
* - 'link'
* - 'thumbnail'
* - 'title'
* - 'caption'
* - 'description'
* - 'metadata'
2010-10-27 13:20:46 -04:00
*/
function wp_getMediaItem ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$attachment_id = ( int ) $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'upload_files' ) )
2011-03-24 12:12:47 -04:00
return new IXR_Error ( 403 , __ ( 'You are not allowed to upload files to this site.' ) );
2010-10-27 13:20:46 -04:00
do_action ( 'xmlrpc_call' , 'wp.getMediaItem' );
if ( ! $attachment = get_post ( $attachment_id ) )
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
2012-04-26 16:56:52 -04:00
return $this -> _prepare_media_item ( $attachment );
2010-10-27 13:20:46 -04:00
}
/**
2010-10-28 08:12:59 -04:00
* Retrieves a collection of media library items ( or attachments )
2010-11-17 13:47:34 -05:00
*
* Besides the common blog_id , username , and password arguments , it takes a filter
2010-10-28 08:12:59 -04:00
* array as last argument .
2010-11-17 13:47:34 -05:00
*
2010-10-28 08:12:59 -04:00
* Accepted 'filter' keys are 'parent_id' , 'mime_type' , 'offset' , and 'number' .
2010-11-17 13:47:34 -05:00
*
2010-10-28 08:12:59 -04:00
* 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' )
2010-11-17 13:47:34 -05:00
*
2010-10-27 13:20:46 -04:00
* @ since 3.1 . 0
*
2010-10-28 08:12:59 -04:00
* @ param array $args Method parameters . Contains :
* - blog_id
* - username
* - password
* - filter
* @ return array . Contains a collection of media items . See { @ link wp_xmlrpc_server :: wp_getMediaItem ()} for a description of each item contents
2010-10-27 13:20:46 -04:00
*/
function wp_getMediaLibrary ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$struct = isset ( $args [ 3 ] ) ? $args [ 3 ] : array () ;
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'upload_files' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot upload files.' ) );
do_action ( 'xmlrpc_call' , 'wp.getMediaLibrary' );
2010-10-28 08:12:59 -04:00
$parent_id = ( isset ( $struct [ 'parent_id' ]) ) ? absint ( $struct [ 'parent_id' ]) : '' ;
$mime_type = ( isset ( $struct [ 'mime_type' ]) ) ? $struct [ 'mime_type' ] : '' ;
2010-10-27 13:20:46 -04:00
$offset = ( isset ( $struct [ 'offset' ]) ) ? absint ( $struct [ 'offset' ]) : 0 ;
$number = ( isset ( $struct [ 'number' ]) ) ? absint ( $struct [ 'number' ]) : - 1 ;
2010-11-17 13:47:34 -05:00
2010-10-27 13:20:46 -04:00
$attachments = get_posts ( array ( 'post_type' => 'attachment' , 'post_parent' => $parent_id , 'offset' => $offset , 'numberposts' => $number , 'post_mime_type' => $mime_type ) );
$attachments_struct = array ();
foreach ( $attachments as $attachment )
2012-04-26 16:56:52 -04:00
$attachments_struct [] = $this -> _prepare_media_item ( $attachment );
2010-10-27 13:20:46 -04:00
return $attachments_struct ;
}
2010-12-13 16:21:50 -05:00
/**
2011-09-03 12:02:41 -04:00
* Retrieves a list of post formats used by the site
2010-12-13 16:21:50 -05:00
*
2010-11-19 08:57:05 -05:00
* @ since 3.1
2010-12-13 16:21:50 -05:00
*
* @ param array $args Method parameters . Contains :
* - blog_id
* - username
* - password
* @ return array
*/
2010-11-19 08:57:05 -05:00
function wp_getPostFormats ( $args ) {
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2010-12-13 16:21:50 -05:00
2012-04-23 17:41:50 -04:00
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 403 , __ ( 'You are not allowed access to details about this site.' ) );
2010-11-19 08:57:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPostFormats' );
2011-04-18 13:27:29 -04:00
2011-06-10 19:01:45 -04:00
$formats = get_post_format_strings ();
2011-04-18 13:27:29 -04:00
2011-06-10 19:01:45 -04:00
# find out if they want a list of currently supports formats
if ( isset ( $args [ 3 ] ) && is_array ( $args [ 3 ] ) ) {
if ( $args [ 3 ][ 'show-supported' ] ) {
if ( current_theme_supports ( 'post-formats' ) ) {
$supported = get_theme_support ( 'post-formats' );
2011-04-18 13:27:29 -04:00
2011-06-10 19:01:45 -04:00
$data [ 'all' ] = $formats ;
$data [ 'supported' ] = $supported [ 0 ];
2011-04-18 13:27:29 -04:00
2011-06-10 19:01:45 -04:00
$formats = $data ;
}
}
}
2011-04-18 13:27:29 -04:00
return $formats ;
2010-12-13 16:21:50 -05:00
}
2010-10-27 13:20:46 -04:00
2012-03-23 13:53:14 -04:00
/**
* Retrieves a post type
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2012-03-23 13:53:14 -04:00
* @ uses get_post_type_object ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - string $post_type_name
* - array $fields
* @ return array contains :
* - 'labels'
* - 'description'
* - 'capability_type'
* - 'cap'
* - 'map_meta_cap'
* - 'hierarchical'
* - 'menu_position'
* - 'taxonomies'
* - 'supports'
*/
function wp_getPostType ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 4 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
2012-03-23 13:53:14 -04:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_type_name = $args [ 3 ];
2012-04-28 14:48:10 -04:00
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_posttype_fields' , array ( 'labels' , 'cap' , 'taxonomies' ), 'wp.getPostType' );
2012-03-23 13:53:14 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getPostType' );
if ( ! post_type_exists ( $post_type_name ) )
return new IXR_Error ( 403 , __ ( 'Invalid post type.' ) );
$post_type = get_post_type_object ( $post_type_name );
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post type.' ) );
return $this -> _prepare_post_type ( $post_type , $fields );
}
/**
* Retrieves a post types
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
2012-03-23 13:53:14 -04:00
*
* @ uses get_post_types ()
* @ param array $args Method parameters . Contains :
* - int $blog_id
* - string $username
* - string $password
* - array $filter
* - array $fields
* @ return array
*/
function wp_getPostTypes ( $args ) {
2012-05-02 17:13:08 -04:00
if ( ! $this -> minimum_args ( $args , 3 ) )
return $this -> error ;
2012-04-28 17:25:25 -04:00
2012-03-23 13:53:14 -04:00
$this -> escape ( $args );
$blog_id = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-04-28 14:48:10 -04:00
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ( 'public' => true );
2012-03-23 13:53:14 -04:00
2012-04-28 14:48:10 -04:00
if ( isset ( $args [ 4 ] ) )
$fields = $args [ 4 ];
else
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_posttype_fields' , array ( 'labels' , 'cap' , 'taxonomies' ), 'wp.getPostTypes' );
2012-03-23 13:53:14 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'wp.getPostTypes' );
$post_types = get_post_types ( $filter , 'objects' );
$struct = array ();
foreach ( $post_types as $post_type ) {
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) )
continue ;
$struct [ $post_type -> name ] = $this -> _prepare_post_type ( $post_type , $fields );
}
return $struct ;
}
2010-09-23 17:22:21 -04:00
/* Blogger API functions .
* specs on http :// plant . blogger . com / api and http :// groups . yahoo . com / group / bloggerDev /
*/
/**
* Retrieve blogs that user owns .
*
* Will make more sense once we support multiple blogs .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function blogger_getUsersBlogs ( $args ) {
if ( is_multisite () )
return $this -> _multisite_getUsersBlogs ( $args );
$this -> escape ( $args );
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.getUsersBlogs' );
$is_admin = current_user_can ( 'manage_options' );
$struct = array (
'isAdmin' => $is_admin ,
'url' => get_option ( 'home' ) . '/' ,
'blogid' => '1' ,
'blogName' => get_option ( 'blogname' ),
'xmlrpc' => site_url ( 'xmlrpc.php' )
);
return array ( $struct );
}
/**
* Private function for retrieving a users blogs for multisite setups
*
* @ access protected
*/
function _multisite_getUsersBlogs ( $args ) {
global $current_blog ;
$domain = $current_blog -> domain ;
$path = $current_blog -> path . 'xmlrpc.php' ;
$protocol = is_ssl () ? 'https' : 'http' ;
$rpc = new IXR_Client ( " $protocol :// { $domain } { $path } " );
$rpc -> query ( 'wp.getUsersBlogs' , $args [ 1 ], $args [ 2 ]);
$blogs = $rpc -> getResponse ();
if ( isset ( $blogs [ 'faultCode' ]) )
return new IXR_Error ( $blogs [ 'faultCode' ], $blogs [ 'faultString' ]);
if ( $_SERVER [ 'HTTP_HOST' ] == $domain && $_SERVER [ 'REQUEST_URI' ] == $path ) {
return $blogs ;
} else {
foreach ( ( array ) $blogs as $blog ) {
if ( strpos ( $blog [ 'url' ], $_SERVER [ 'HTTP_HOST' ]) )
return array ( $blog );
}
return array ();
}
}
/**
* Retrieve user ' s data .
*
* Gives your client some info about you , so you don ' t have to .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function blogger_getUserInfo ( $args ) {
$this -> escape ( $args );
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have access to user data on this site.' ) );
do_action ( 'xmlrpc_call' , 'blogger.getUserInfo' );
$struct = array (
'nickname' => $user -> nickname ,
'userid' => $user -> ID ,
'url' => $user -> user_url ,
'lastname' => $user -> last_name ,
'firstname' => $user -> first_name
);
return $struct ;
}
/**
* Retrieve post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function blogger_getPost ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2012-04-29 20:19:32 -04:00
$post_data = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $post_data )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2012-05-03 12:41:59 -04:00
2010-09-23 17:22:21 -04:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit this post.' ) );
do_action ( 'xmlrpc_call' , 'blogger.getPost' );
$categories = implode ( ',' , wp_get_post_categories ( $post_ID ));
$content = '<title>' . stripslashes ( $post_data [ 'post_title' ]) . '</title>' ;
$content .= '<category>' . $categories . '</category>' ;
$content .= stripslashes ( $post_data [ 'post_content' ]);
$struct = array (
'userid' => $post_data [ 'post_author' ],
2012-04-04 17:32:28 -04:00
'dateCreated' => $this -> _convert_date ( $post_data [ 'post_date' ] ),
2010-09-23 17:22:21 -04:00
'content' => $content ,
2010-11-20 10:50:56 -05:00
'postid' => ( string ) $post_data [ 'ID' ]
2010-09-23 17:22:21 -04:00
);
return $struct ;
}
/**
* Retrieve list of recent posts .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function blogger_getRecentPosts ( $args ) {
$this -> escape ( $args );
2010-11-09 05:16:23 -05:00
// $args[0] = appkey - ignored
2010-09-23 17:22:21 -04:00
$blog_ID = ( int ) $args [ 1 ]; /* though we don't use it yet */
$username = $args [ 2 ];
$password = $args [ 3 ];
2010-11-09 05:16:23 -05:00
if ( isset ( $args [ 4 ] ) )
$query = array ( 'numberposts' => absint ( $args [ 4 ] ) );
else
$query = array ();
2010-09-23 17:22:21 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.getRecentPosts' );
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
if ( ! $posts_list ) {
$this -> error = new IXR_Error ( 500 , __ ( 'Either there are no posts, or something went wrong.' ));
return $this -> error ;
}
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) )
continue ;
2012-04-04 17:32:28 -04:00
$post_date = $this -> _convert_date ( $entry [ 'post_date' ] );
2010-09-23 17:22:21 -04:00
$categories = implode ( ',' , wp_get_post_categories ( $entry [ 'ID' ]));
$content = '<title>' . stripslashes ( $entry [ 'post_title' ]) . '</title>' ;
$content .= '<category>' . $categories . '</category>' ;
$content .= stripslashes ( $entry [ 'post_content' ]);
$struct [] = array (
'userid' => $entry [ 'post_author' ],
2012-04-04 17:32:28 -04:00
'dateCreated' => $post_date ,
2010-09-23 17:22:21 -04:00
'content' => $content ,
2010-11-20 10:50:56 -05:00
'postid' => ( string ) $entry [ 'ID' ],
2010-09-23 17:22:21 -04:00
);
}
$recent_posts = array ();
for ( $j = 0 ; $j < count ( $struct ); $j ++ ) {
array_push ( $recent_posts , $struct [ $j ]);
}
return $recent_posts ;
}
/**
* Retrieve blog_filename content .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return string
*/
function blogger_getTemplate ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
$template = $args [ 4 ]; /* could be 'main' or 'archiveIndex', but we don't use it */
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.getTemplate' );
if ( ! current_user_can ( 'edit_themes' ) )
2012-03-19 15:04:49 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, this user cannot edit the template.' ));
2010-09-23 17:22:21 -04:00
/* warning: here we make the assumption that the blog's URL is on the same server */
$filename = get_option ( 'home' ) . '/' ;
$filename = preg_replace ( '#https?://.+?/#' , $_SERVER [ 'DOCUMENT_ROOT' ] . '/' , $filename );
$f = fopen ( $filename , 'r' );
$content = fread ( $f , filesize ( $filename ));
fclose ( $f );
/* so it is actually editable with a windows/mac client */
2011-12-13 18:45:31 -05:00
// FIXME: (or delete me) do we really want to cater to bad clients at the expense of good ones by BEEPing up their line breaks? commented. $content = str_replace("\n", "\r\n", $content);
2010-09-23 17:22:21 -04:00
return $content ;
}
/**
* Updates the content of blog_filename .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return bool True when done .
*/
function blogger_setTemplate ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
$content = $args [ 4 ];
$template = $args [ 5 ]; /* could be 'main' or 'archiveIndex', but we don't use it */
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.setTemplate' );
if ( ! current_user_can ( 'edit_themes' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, this user cannot edit the template.' ));
/* warning: here we make the assumption that the blog's URL is on the same server */
$filename = get_option ( 'home' ) . '/' ;
$filename = preg_replace ( '#https?://.+?/#' , $_SERVER [ 'DOCUMENT_ROOT' ] . '/' , $filename );
if ( $f = fopen ( $filename , 'w+' )) {
fwrite ( $f , $content );
fclose ( $f );
} else {
return new IXR_Error ( 500 , __ ( 'Either the file is not writable, or something wrong happened. The file has not been updated.' ));
}
return true ;
}
/**
* Create new post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return int
*/
function blogger_newPost ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 1 ]; /* though we don't use it yet */
$username = $args [ 2 ];
$password = $args [ 3 ];
$content = $args [ 4 ];
$publish = $args [ 5 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.newPost' );
$cap = ( $publish ) ? 'publish_posts' : 'edit_posts' ;
if ( ! current_user_can ( $cap ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to post on this site.' ));
$post_status = ( $publish ) ? 'publish' : 'draft' ;
$post_author = $user -> ID ;
$post_title = xmlrpc_getposttitle ( $content );
$post_category = xmlrpc_getpostcategory ( $content );
$post_content = xmlrpc_removepostdata ( $content );
$post_date = current_time ( 'mysql' );
$post_date_gmt = current_time ( 'mysql' , 1 );
$post_data = compact ( 'blog_ID' , 'post_author' , 'post_date' , 'post_date_gmt' , 'post_content' , 'post_title' , 'post_category' , 'post_status' );
$post_ID = wp_insert_post ( $post_data );
if ( is_wp_error ( $post_ID ) )
return new IXR_Error ( 500 , $post_ID -> get_error_message ());
if ( ! $post_ID )
return new IXR_Error ( 500 , __ ( 'Sorry, your entry could not be posted. Something wrong happened.' ));
$this -> attach_uploads ( $post_ID , $post_content );
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_blogger_newPost' , $post_ID , $args );
2010-09-23 17:22:21 -04:00
return $post_ID ;
}
/**
* Edit a post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return bool true when done .
*/
function blogger_editPost ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
$content = $args [ 4 ];
$publish = $args [ 5 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.editPost' );
$actual_post = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $actual_post || $actual_post [ 'post_type' ] != 'post' )
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ));
$this -> escape ( $actual_post );
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to edit this post.' ));
extract ( $actual_post , EXTR_SKIP );
if ( ( 'publish' == $post_status ) && ! current_user_can ( 'publish_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to publish this post.' ));
$post_title = xmlrpc_getposttitle ( $content );
$post_category = xmlrpc_getpostcategory ( $content );
$post_content = xmlrpc_removepostdata ( $content );
$postdata = compact ( 'ID' , 'post_content' , 'post_title' , 'post_category' , 'post_status' , 'post_excerpt' );
$result = wp_update_post ( $postdata );
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'For some strange yet very annoying reason, this post could not be edited.' ));
$this -> attach_uploads ( $ID , $post_content );
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_blogger_editPost' , $post_ID , $args );
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Remove a post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return bool True when post is deleted .
*/
function blogger_deletePost ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
$publish = $args [ 4 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'blogger.deletePost' );
$actual_post = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $actual_post || $actual_post [ 'post_type' ] != 'post' )
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ));
2010-12-08 11:18:42 -05:00
if ( ! current_user_can ( 'delete_post' , $post_ID ) )
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to delete this post.' ));
$result = wp_delete_post ( $post_ID );
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'For some strange yet very annoying reason, this post could not be deleted.' ));
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_blogger_deletePost' , $post_ID , $args );
2010-09-23 17:22:21 -04:00
return true ;
}
/* MetaWeblog API functions
* specs on wherever Dave Winer wants them to be
*/
/**
* Create a new post .
2011-06-10 19:01:45 -04:00
*
2011-04-18 03:23:47 -04:00
* The 'content_struct' argument must contain :
* - title
* - description
* - mt_excerpt
* - mt_text_more
* - mt_keywords
* - mt_tb_ping_urls
* - categories
2011-06-10 19:01:45 -04:00
*
2011-04-18 03:23:47 -04:00
* 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
2012-04-13 16:23:31 -04:00
* - wp_post_thumbnail
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
*
2011-04-18 03:23:47 -04:00
* @ param array $args Method parameters . Contains :
* - blog_id
* - username
* - password
* - content_struct
* - publish
2010-09-23 17:22:21 -04:00
* @ return int
*/
function mw_newPost ( $args ) {
$this -> escape ( $args );
2012-04-28 14:48:10 -04:00
$blog_ID = ( int ) $args [ 0 ];
2010-09-23 17:22:21 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$content_struct = $args [ 3 ];
2010-12-08 10:31:17 -05:00
$publish = isset ( $args [ 4 ] ) ? $args [ 4 ] : 0 ;
2010-09-23 17:22:21 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'metaWeblog.newPost' );
2010-12-13 16:21:50 -05:00
2010-09-23 17:22:21 -04:00
$page_template = '' ;
if ( ! empty ( $content_struct [ 'post_type' ] ) ) {
if ( $content_struct [ 'post_type' ] == 'page' ) {
2010-12-08 10:31:17 -05:00
if ( $publish )
$cap = 'publish_pages' ;
2012-03-29 09:13:13 -04:00
elseif ( isset ( $content_struct [ 'page_status' ] ) && 'publish' == $content_struct [ 'page_status' ] )
2010-12-08 10:31:17 -05:00
$cap = 'publish_pages' ;
else
$cap = 'edit_pages' ;
2010-09-23 17:22:21 -04:00
$error_message = __ ( 'Sorry, you are not allowed to publish pages on this site.' );
$post_type = 'page' ;
if ( ! empty ( $content_struct [ 'wp_page_template' ] ) )
$page_template = $content_struct [ 'wp_page_template' ];
} elseif ( $content_struct [ 'post_type' ] == 'post' ) {
2010-12-08 10:31:17 -05:00
if ( $publish )
$cap = 'publish_posts' ;
2012-03-29 09:13:13 -04:00
elseif ( isset ( $content_struct [ 'post_status' ] ) && 'publish' == $content_struct [ 'post_status' ] )
2010-12-08 10:31:17 -05:00
$cap = 'publish_posts' ;
else
$cap = 'edit_posts' ;
$error_message = __ ( 'Sorry, you are not allowed to publish posts on this site.' );
$post_type = 'post' ;
2010-09-23 17:22:21 -04:00
} else {
// No other post_type values are allowed here
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
}
2010-12-08 10:31:17 -05:00
} else {
if ( $publish )
$cap = 'publish_posts' ;
2012-03-29 09:13:13 -04:00
elseif ( isset ( $content_struct [ 'post_status' ] ) && 'publish' == $content_struct [ 'post_status' ])
2010-12-08 10:31:17 -05:00
$cap = 'publish_posts' ;
else
$cap = 'edit_posts' ;
$error_message = __ ( 'Sorry, you are not allowed to publish posts on this site.' );
2010-12-13 16:21:50 -05:00
$post_type = 'post' ;
2010-09-23 17:22:21 -04:00
}
if ( ! current_user_can ( $cap ) )
return new IXR_Error ( 401 , $error_message );
2010-11-19 08:57:05 -05:00
// Check for a valid post format if one was given
2010-12-13 16:21:50 -05:00
if ( isset ( $content_struct [ 'wp_post_format' ] ) ) {
$content_struct [ 'wp_post_format' ] = sanitize_key ( $content_struct [ 'wp_post_format' ] );
2010-11-19 08:57:05 -05:00
if ( ! array_key_exists ( $content_struct [ 'wp_post_format' ], get_post_format_strings () ) ) {
return new IXR_Error ( 404 , __ ( 'Invalid post format' ) );
}
}
2010-09-23 17:22:21 -04:00
// Let WordPress generate the post_name (slug) unless
// one has been provided.
$post_name = " " ;
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_slug' ]) )
$post_name = $content_struct [ 'wp_slug' ];
2010-09-23 17:22:21 -04:00
// Only use a password if one was given.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_password' ]) )
$post_password = $content_struct [ 'wp_password' ];
2010-09-23 17:22:21 -04:00
// Only set a post parent if one was provided.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_page_parent_id' ]) )
$post_parent = $content_struct [ 'wp_page_parent_id' ];
2010-09-23 17:22:21 -04:00
// Only set the menu_order if it was provided.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_page_order' ]) )
$menu_order = $content_struct [ 'wp_page_order' ];
2010-09-23 17:22:21 -04:00
$post_author = $user -> ID ;
// If an author id was provided then use it instead.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_author_id' ]) && ( $user -> ID != $content_struct [ 'wp_author_id' ]) ) {
2010-09-23 17:22:21 -04:00
switch ( $post_type ) {
case " post " :
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'edit_others_posts' ) )
return ( new IXR_Error ( 401 , __ ( 'You are not allowed to post as this user' )));
2010-09-23 17:22:21 -04:00
break ;
case " page " :
2011-05-06 15:51:47 -04:00
if ( ! current_user_can ( 'edit_others_pages' ) )
return ( new IXR_Error ( 401 , __ ( 'You are not allowed to create pages as this user' )));
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 401 , __ ( 'Invalid post type.' )));
2010-09-23 17:22:21 -04:00
break ;
}
2012-04-04 16:11:21 -04:00
$author = get_userdata ( $content_struct [ 'wp_author_id' ] );
if ( ! $author )
return new IXR_Error ( 404 , __ ( 'Invalid author ID.' ) );
2011-05-06 15:51:47 -04:00
$post_author = $content_struct [ 'wp_author_id' ];
2010-09-23 17:22:21 -04:00
}
2010-12-08 17:00:40 -05:00
$post_title = isset ( $content_struct [ 'title' ] ) ? $content_struct [ 'title' ] : null ;
$post_content = isset ( $content_struct [ 'description' ] ) ? $content_struct [ 'description' ] : null ;
2010-09-23 17:22:21 -04:00
$post_status = $publish ? 'publish' : 'draft' ;
if ( isset ( $content_struct [ " { $post_type } _status " ] ) ) {
switch ( $content_struct [ " { $post_type } _status " ] ) {
case 'draft' :
2011-04-18 13:30:58 -04:00
case 'pending' :
2010-09-23 17:22:21 -04:00
case 'private' :
case 'publish' :
$post_status = $content_struct [ " { $post_type } _status " ];
break ;
default :
$post_status = $publish ? 'publish' : 'draft' ;
break ;
}
}
2010-12-08 17:00:40 -05:00
$post_excerpt = isset ( $content_struct [ 'mt_excerpt' ]) ? $content_struct [ 'mt_excerpt' ] : null ;
$post_more = isset ( $content_struct [ 'mt_text_more' ]) ? $content_struct [ 'mt_text_more' ] : null ;
2010-09-23 17:22:21 -04:00
2010-12-08 17:00:40 -05:00
$tags_input = isset ( $content_struct [ 'mt_keywords' ]) ? $content_struct [ 'mt_keywords' ] : null ;
2010-09-23 17:22:21 -04:00
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'mt_allow_comments' ]) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_comments' ]) ) {
switch ( $content_struct [ 'mt_allow_comments' ] ) {
case 'closed' :
$comment_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
2011-05-06 15:51:47 -04:00
case 'open' :
$comment_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$comment_status = get_option ( 'default_comment_status' );
2010-09-23 17:22:21 -04:00
break ;
}
} else {
2011-05-06 15:51:47 -04:00
switch ( ( int ) $content_struct [ 'mt_allow_comments' ] ) {
2010-09-23 17:22:21 -04:00
case 0 :
case 2 :
2011-05-06 15:51:47 -04:00
$comment_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
case 1 :
2011-05-06 15:51:47 -04:00
$comment_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$comment_status = get_option ( 'default_comment_status' );
2010-09-23 17:22:21 -04:00
break ;
}
}
} else {
2011-05-06 15:51:47 -04:00
$comment_status = get_option ( 'default_comment_status' );
2010-09-23 17:22:21 -04:00
}
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'mt_allow_pings' ]) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_pings' ]) ) {
2010-09-23 17:22:21 -04:00
switch ( $content_struct [ 'mt_allow_pings' ] ) {
2011-05-06 15:51:47 -04:00
case 'closed' :
$ping_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
2011-05-06 15:51:47 -04:00
case 'open' :
$ping_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$ping_status = get_option ( 'default_ping_status' );
2010-09-23 17:22:21 -04:00
break ;
}
} else {
2011-05-06 15:51:47 -04:00
switch ( ( int ) $content_struct [ 'mt_allow_pings' ] ) {
2010-09-23 17:22:21 -04:00
case 0 :
2011-05-06 15:51:47 -04:00
$ping_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
case 1 :
2011-05-06 15:51:47 -04:00
$ping_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$ping_status = get_option ( 'default_ping_status' );
2010-09-23 17:22:21 -04:00
break ;
}
}
} else {
2011-05-06 15:51:47 -04:00
$ping_status = get_option ( 'default_ping_status' );
2010-09-23 17:22:21 -04:00
}
if ( $post_more )
2011-05-06 15:51:47 -04:00
$post_content = $post_content . '<!--more-->' . $post_more ;
2010-09-23 17:22:21 -04:00
2010-12-08 17:00:40 -05:00
$to_ping = null ;
if ( isset ( $content_struct [ 'mt_tb_ping_urls' ] ) ) {
$to_ping = $content_struct [ 'mt_tb_ping_urls' ];
if ( is_array ( $to_ping ) )
$to_ping = implode ( ' ' , $to_ping );
}
2010-09-23 17:22:21 -04:00
// Do some timestamp voodoo
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) )
2012-04-28 14:48:10 -04:00
// We know this is supposed to be GMT, so we're going to slap that Z on there by force
2012-04-30 21:11:18 -04:00
$dateCreated = rtrim ( $content_struct [ 'date_created_gmt' ] -> getIso (), 'Z' ) . 'Z' ;
2010-09-23 17:22:21 -04:00
elseif ( ! empty ( $content_struct [ 'dateCreated' ]) )
$dateCreated = $content_struct [ 'dateCreated' ] -> getIso ();
if ( ! empty ( $dateCreated ) ) {
$post_date = get_date_from_gmt ( iso8601_to_datetime ( $dateCreated ));
2010-12-06 11:32:25 -05:00
$post_date_gmt = iso8601_to_datetime ( $dateCreated , 'GMT' );
2010-09-23 17:22:21 -04:00
} else {
$post_date = current_time ( 'mysql' );
$post_date_gmt = current_time ( 'mysql' , 1 );
}
$post_category = array ();
2010-12-08 17:00:40 -05:00
if ( isset ( $content_struct [ 'categories' ] ) ) {
$catnames = $content_struct [ 'categories' ];
2010-09-23 17:22:21 -04:00
2010-12-08 17:00:40 -05:00
if ( is_array ( $catnames ) ) {
foreach ( $catnames as $cat ) {
$post_category [] = get_cat_ID ( $cat );
}
2010-09-23 17:22:21 -04:00
}
}
$postdata = compact ( 'post_author' , 'post_date' , 'post_date_gmt' , 'post_content' , 'post_title' , 'post_category' , 'post_status' , 'post_excerpt' , 'comment_status' , 'ping_status' , 'to_ping' , 'post_type' , 'post_name' , 'post_password' , 'post_parent' , 'menu_order' , 'tags_input' , 'page_template' );
2011-10-10 17:27:05 -04:00
$post_ID = $postdata [ 'ID' ] = get_default_post_to_edit ( $post_type , true ) -> ID ;
2010-09-23 17:22:21 -04:00
// Only posts can be sticky
if ( $post_type == 'post' && isset ( $content_struct [ 'sticky' ] ) ) {
if ( $content_struct [ 'sticky' ] == true )
stick_post ( $post_ID );
elseif ( $content_struct [ 'sticky' ] == false )
unstick_post ( $post_ID );
}
if ( isset ( $content_struct [ 'custom_fields' ]) )
$this -> set_custom_fields ( $post_ID , $content_struct [ 'custom_fields' ]);
2012-04-13 16:23:31 -04:00
if ( isset ( $content_struct [ 'wp_post_thumbnail' ] ) ) {
if ( set_post_thumbnail ( $post_ID , $content_struct [ 'wp_post_thumbnail' ] ) === false )
2012-03-23 11:35:44 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'wp_post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2010-09-23 17:22:21 -04:00
// Handle enclosures
2010-12-08 17:00:40 -05:00
$thisEnclosure = isset ( $content_struct [ 'enclosure' ]) ? $content_struct [ 'enclosure' ] : null ;
$this -> add_enclosure_if_new ( $post_ID , $thisEnclosure );
2010-09-23 17:22:21 -04:00
$this -> attach_uploads ( $post_ID , $post_content );
2010-12-13 16:21:50 -05:00
2010-11-19 08:57:05 -05:00
// Handle post formats if assigned, value is validated earlier
// in this function
if ( isset ( $content_struct [ 'wp_post_format' ] ) )
2010-12-13 16:21:50 -05:00
wp_set_post_terms ( $post_ID , array ( 'post-format-' . $content_struct [ 'wp_post_format' ] ), 'post_format' );
2010-09-23 17:22:21 -04:00
2011-10-10 17:27:05 -04:00
$post_ID = wp_insert_post ( $postdata , true );
if ( is_wp_error ( $post_ID ) )
return new IXR_Error ( 500 , $post_ID -> get_error_message ());
if ( ! $post_ID )
return new IXR_Error ( 500 , __ ( 'Sorry, your entry could not be posted. Something wrong happened.' ));
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_mw_newPost' , $post_ID , $args );
2010-09-23 17:22:21 -04:00
return strval ( $post_ID );
}
function add_enclosure_if_new ( $post_ID , $enclosure ) {
if ( is_array ( $enclosure ) && isset ( $enclosure [ 'url' ] ) && isset ( $enclosure [ 'length' ] ) && isset ( $enclosure [ 'type' ] ) ) {
$encstring = $enclosure [ 'url' ] . " \n " . $enclosure [ 'length' ] . " \n " . $enclosure [ 'type' ];
$found = false ;
foreach ( ( array ) get_post_custom ( $post_ID ) as $key => $val ) {
if ( $key == 'enclosure' ) {
foreach ( ( array ) $val as $enc ) {
if ( $enc == $encstring ) {
$found = true ;
break 2 ;
}
}
}
}
if ( ! $found )
add_post_meta ( $post_ID , 'enclosure' , $encstring );
}
}
/**
* Attach upload to a post .
*
* @ since 2.1 . 0
*
* @ param int $post_ID Post ID .
* @ param string $post_content Post Content for attachment .
*/
function attach_uploads ( $post_ID , $post_content ) {
global $wpdb ;
// find any unattached files
$attachments = $wpdb -> get_results ( " SELECT ID, guid FROM { $wpdb -> posts } WHERE post_parent = '0' AND post_type = 'attachment' " );
if ( is_array ( $attachments ) ) {
foreach ( $attachments as $file ) {
if ( strpos ( $post_content , $file -> guid ) !== false )
$wpdb -> update ( $wpdb -> posts , array ( 'post_parent' => $post_ID ), array ( 'ID' => $file -> ID ) );
}
}
}
/**
* Edit a post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return bool True on success .
*/
function mw_editPost ( $args ) {
$this -> escape ( $args );
2012-05-01 17:03:50 -04:00
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
$content_struct = $args [ 3 ];
2012-05-01 17:03:50 -04:00
$publish = isset ( $args [ 4 ] ) ? $args [ 4 ] : 0 ;
2010-09-23 17:22:21 -04:00
2012-02-08 10:40:26 -05:00
if ( ! $user = $this -> login ( $username , $password ) )
2010-09-23 17:22:21 -04:00
return $this -> error ;
do_action ( 'xmlrpc_call' , 'metaWeblog.editPost' );
2012-02-08 10:40:26 -05:00
$postdata = wp_get_single_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2012-02-08 10:40:26 -05:00
// If there is no post data for the give post id, stop
// now and return an error. Other wise a new post will be
// created (which was the old behavior).
if ( ! $postdata || empty ( $postdata [ 'ID' ] ) )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to edit this post.' ) );
2010-09-23 17:22:21 -04:00
2012-02-13 16:01:55 -05:00
// Use wp.editPost to edit post types other than post and page.
if ( ! in_array ( $postdata [ 'post_type' ], array ( 'post' , 'page' ) ) )
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
// Thwart attempt to change the post type.
if ( ! empty ( $content_struct [ 'post_type' ] ) && ( $content_struct [ 'post_type' ] != $postdata [ 'post_type' ] ) )
return new IXR_Error ( 401 , __ ( 'The post type may not be changed.' ) );
2010-11-19 08:57:05 -05:00
// Check for a valid post format if one was given
2010-12-13 16:21:50 -05:00
if ( isset ( $content_struct [ 'wp_post_format' ] ) ) {
$content_struct [ 'wp_post_format' ] = sanitize_key ( $content_struct [ 'wp_post_format' ] );
2010-11-19 08:57:05 -05:00
if ( ! array_key_exists ( $content_struct [ 'wp_post_format' ], get_post_format_strings () ) ) {
return new IXR_Error ( 404 , __ ( 'Invalid post format' ) );
}
}
2010-09-23 17:22:21 -04:00
$this -> escape ( $postdata );
extract ( $postdata , EXTR_SKIP );
// Let WordPress manage slug if none was provided.
$post_name = " " ;
2011-04-18 12:32:26 -04:00
$post_name = $postdata [ 'post_name' ];
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_slug' ]) )
$post_name = $content_struct [ 'wp_slug' ];
2010-09-23 17:22:21 -04:00
// Only use a password if one was given.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_password' ]) )
$post_password = $content_struct [ 'wp_password' ];
2010-09-23 17:22:21 -04:00
// Only set a post parent if one was given.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_page_parent_id' ]) )
$post_parent = $content_struct [ 'wp_page_parent_id' ];
2010-09-23 17:22:21 -04:00
// Only set the menu_order if it was given.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_page_order' ]) )
$menu_order = $content_struct [ 'wp_page_order' ];
2010-09-23 17:22:21 -04:00
2012-02-13 16:01:55 -05:00
if ( ! empty ( $content_struct [ 'wp_page_template' ] ) && 'page' == $post_type )
2012-02-27 14:46:52 -05:00
$page_template = $content_struct [ 'wp_page_template' ];
2012-02-13 16:01:55 -05:00
2011-05-06 15:51:47 -04:00
$post_author = $postdata [ 'post_author' ];
2010-09-23 17:22:21 -04:00
// Only set the post_author if one is set.
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'wp_author_id' ]) && ( $user -> ID != $content_struct [ 'wp_author_id' ]) ) {
2010-09-23 17:22:21 -04:00
switch ( $post_type ) {
2011-05-06 15:51:47 -04:00
case 'post' :
if ( ! current_user_can ( 'edit_others_posts' ) )
return ( new IXR_Error ( 401 , __ ( 'You are not allowed to change the post author as this user.' )));
2010-09-23 17:22:21 -04:00
break ;
2011-05-06 15:51:47 -04:00
case 'page' :
if ( ! current_user_can ( 'edit_others_pages' ) )
return ( new IXR_Error ( 401 , __ ( 'You are not allowed to change the page author as this user.' )));
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
return ( new IXR_Error ( 401 , __ ( 'Invalid post type.' )));
2010-09-23 17:22:21 -04:00
break ;
}
2011-05-06 15:51:47 -04:00
$post_author = $content_struct [ 'wp_author_id' ];
2010-09-23 17:22:21 -04:00
}
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'mt_allow_comments' ]) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_comments' ]) ) {
switch ( $content_struct [ 'mt_allow_comments' ] ) {
case 'closed' :
$comment_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
2011-05-06 15:51:47 -04:00
case 'open' :
$comment_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$comment_status = get_option ( 'default_comment_status' );
2010-09-23 17:22:21 -04:00
break ;
}
} else {
2011-05-06 15:51:47 -04:00
switch ( ( int ) $content_struct [ 'mt_allow_comments' ] ) {
2010-09-23 17:22:21 -04:00
case 0 :
case 2 :
2011-05-06 15:51:47 -04:00
$comment_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
case 1 :
2011-05-06 15:51:47 -04:00
$comment_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$comment_status = get_option ( 'default_comment_status' );
2010-09-23 17:22:21 -04:00
break ;
}
}
}
2011-05-06 15:51:47 -04:00
if ( isset ( $content_struct [ 'mt_allow_pings' ]) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_pings' ]) ) {
switch ( $content_struct [ 'mt_allow_pings' ] ) {
case 'closed' :
$ping_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
2011-05-06 15:51:47 -04:00
case 'open' :
$ping_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$ping_status = get_option ( 'default_ping_status' );
2010-09-23 17:22:21 -04:00
break ;
}
} else {
switch ( ( int ) $content_struct [ " mt_allow_pings " ] ) {
case 0 :
2011-05-06 15:51:47 -04:00
$ping_status = 'closed' ;
2010-09-23 17:22:21 -04:00
break ;
case 1 :
2011-05-06 15:51:47 -04:00
$ping_status = 'open' ;
2010-09-23 17:22:21 -04:00
break ;
default :
2011-05-06 15:51:47 -04:00
$ping_status = get_option ( 'default_ping_status' );
2010-09-23 17:22:21 -04:00
break ;
}
}
}
2012-03-29 07:59:51 -04:00
if ( isset ( $content_struct [ 'title' ] ) )
$post_title = $content_struct [ 'title' ];
if ( isset ( $content_struct [ 'description' ] ) )
$post_content = $content_struct [ 'description' ];
2010-09-23 17:22:21 -04:00
$post_category = array ();
2010-12-08 17:00:40 -05:00
if ( isset ( $content_struct [ 'categories' ] ) ) {
$catnames = $content_struct [ 'categories' ];
if ( is_array ( $catnames ) ) {
foreach ( $catnames as $cat ) {
$post_category [] = get_cat_ID ( $cat );
}
2010-09-23 17:22:21 -04:00
}
}
2012-03-29 07:59:51 -04:00
if ( isset ( $content_struct [ 'mt_excerpt' ] ) )
$post_excerpt = $content_struct [ 'mt_excerpt' ];
2012-05-01 17:03:50 -04:00
$post_more = isset ( $content_struct [ 'mt_text_more' ] ) ? $content_struct [ 'mt_text_more' ] : null ;
2010-09-23 17:22:21 -04:00
$post_status = $publish ? 'publish' : 'draft' ;
if ( isset ( $content_struct [ " { $post_type } _status " ] ) ) {
switch ( $content_struct [ " { $post_type } _status " ] ) {
case 'draft' :
2011-04-18 13:30:58 -04:00
case 'pending' :
2010-09-23 17:22:21 -04:00
case 'private' :
case 'publish' :
$post_status = $content_struct [ " { $post_type } _status " ];
break ;
default :
$post_status = $publish ? 'publish' : 'draft' ;
break ;
}
}
2010-12-08 17:00:40 -05:00
$tags_input = isset ( $content_struct [ 'mt_keywords' ] ) ? $content_struct [ 'mt_keywords' ] : null ;
2010-09-23 17:22:21 -04:00
if ( ( 'publish' == $post_status ) ) {
if ( ( 'page' == $post_type ) && ! current_user_can ( 'publish_pages' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to publish this page.' ));
else if ( ! current_user_can ( 'publish_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you do not have the right to publish this post.' ));
}
if ( $post_more )
$post_content = $post_content . " <!--more--> " . $post_more ;
2010-12-08 17:00:40 -05:00
$to_ping = null ;
if ( isset ( $content_struct [ 'mt_tb_ping_urls' ] ) ) {
$to_ping = $content_struct [ 'mt_tb_ping_urls' ];
if ( is_array ( $to_ping ) )
$to_ping = implode ( ' ' , $to_ping );
}
2010-09-23 17:22:21 -04:00
// Do some timestamp voodoo
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) )
2012-04-28 14:48:10 -04:00
// We know this is supposed to be GMT, so we're going to slap that Z on there by force
2012-04-30 21:11:18 -04:00
$dateCreated = rtrim ( $content_struct [ 'date_created_gmt' ] -> getIso (), 'Z' ) . 'Z' ;
2010-09-23 17:22:21 -04:00
elseif ( ! empty ( $content_struct [ 'dateCreated' ]) )
$dateCreated = $content_struct [ 'dateCreated' ] -> getIso ();
if ( ! empty ( $dateCreated ) ) {
$post_date = get_date_from_gmt ( iso8601_to_datetime ( $dateCreated ));
2010-12-06 11:32:25 -05:00
$post_date_gmt = iso8601_to_datetime ( $dateCreated , 'GMT' );
2010-09-23 17:22:21 -04:00
} else {
$post_date = $postdata [ 'post_date' ];
$post_date_gmt = $postdata [ 'post_date_gmt' ];
}
// We've got all the data -- post it:
$newpost = compact ( 'ID' , 'post_content' , 'post_title' , 'post_category' , 'post_status' , 'post_excerpt' , 'comment_status' , 'ping_status' , 'post_date' , 'post_date_gmt' , 'to_ping' , 'post_name' , 'post_password' , 'post_parent' , 'menu_order' , 'post_author' , 'tags_input' , 'page_template' );
$result = wp_update_post ( $newpost , true );
if ( is_wp_error ( $result ) )
return new IXR_Error ( 500 , $result -> get_error_message ());
if ( ! $result )
return new IXR_Error ( 500 , __ ( 'Sorry, your entry could not be edited. Something wrong happened.' ));
// Only posts can be sticky
if ( $post_type == 'post' && isset ( $content_struct [ 'sticky' ] ) ) {
if ( $content_struct [ 'sticky' ] == true )
stick_post ( $post_ID );
elseif ( $content_struct [ 'sticky' ] == false )
unstick_post ( $post_ID );
}
if ( isset ( $content_struct [ 'custom_fields' ]) )
$this -> set_custom_fields ( $post_ID , $content_struct [ 'custom_fields' ]);
2012-04-13 16:23:31 -04:00
if ( isset ( $content_struct [ 'wp_post_thumbnail' ] ) ) {
2012-03-23 11:35:44 -04:00
// empty value deletes, non-empty value adds/updates
2012-04-13 16:23:31 -04:00
if ( empty ( $content_struct [ 'wp_post_thumbnail' ] ) ) {
2012-03-23 11:35:44 -04:00
delete_post_thumbnail ( $post_ID );
2012-03-29 07:59:51 -04:00
} else {
2012-04-13 16:23:31 -04:00
if ( set_post_thumbnail ( $post_ID , $content_struct [ 'wp_post_thumbnail' ] ) === false )
2012-03-23 11:35:44 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
}
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'wp_post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2010-09-23 17:22:21 -04:00
// Handle enclosures
2010-12-08 17:00:40 -05:00
$thisEnclosure = isset ( $content_struct [ 'enclosure' ]) ? $content_struct [ 'enclosure' ] : null ;
$this -> add_enclosure_if_new ( $post_ID , $thisEnclosure );
2010-09-23 17:22:21 -04:00
$this -> attach_uploads ( $ID , $post_content );
2010-12-13 16:21:50 -05:00
2010-11-19 08:57:05 -05:00
// Handle post formats if assigned, validation is handled
// earlier in this function
if ( isset ( $content_struct [ 'wp_post_format' ] ) )
2010-12-13 16:21:50 -05:00
wp_set_post_terms ( $post_ID , array ( 'post-format-' . $content_struct [ 'wp_post_format' ] ), 'post_format' );
2010-09-23 17:22:21 -04:00
2012-03-08 08:16:26 -05:00
do_action ( 'xmlrpc_call_success_mw_editPost' , $post_ID , $args );
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Retrieve post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mw_getPost ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2012-04-29 20:19:32 -04:00
$postdata = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $postdata )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2010-09-23 17:22:21 -04:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit this post.' ) );
do_action ( 'xmlrpc_call' , 'metaWeblog.getPost' );
if ( $postdata [ 'post_date' ] != '' ) {
2012-04-04 17:32:28 -04:00
$post_date = $this -> _convert_date ( $postdata [ 'post_date' ] );
$post_date_gmt = $this -> _convert_date_gmt ( $postdata [ 'post_date_gmt' ], $postdata [ 'post_date' ] );
$post_modified = $this -> _convert_date ( $postdata [ 'post_modified' ] );
$post_modified_gmt = $this -> _convert_date_gmt ( $postdata [ 'post_modified_gmt' ], $postdata [ 'post_modified' ] );
2010-09-23 17:22:21 -04:00
$categories = array ();
$catids = wp_get_post_categories ( $post_ID );
foreach ( $catids as $catid )
$categories [] = get_cat_name ( $catid );
$tagnames = array ();
$tags = wp_get_post_tags ( $post_ID );
if ( ! empty ( $tags ) ) {
foreach ( $tags as $tag )
$tagnames [] = $tag -> name ;
$tagnames = implode ( ', ' , $tagnames );
} else {
$tagnames = '' ;
}
$post = get_extended ( $postdata [ 'post_content' ]);
$link = post_permalink ( $postdata [ 'ID' ]);
// Get the author info.
$author = get_userdata ( $postdata [ 'post_author' ]);
$allow_comments = ( 'open' == $postdata [ 'comment_status' ]) ? 1 : 0 ;
$allow_pings = ( 'open' == $postdata [ 'ping_status' ]) ? 1 : 0 ;
// Consider future posts as published
if ( $postdata [ 'post_status' ] === 'future' )
$postdata [ 'post_status' ] = 'publish' ;
2010-12-13 16:21:50 -05:00
// Get post format
2010-11-19 08:57:05 -05:00
$post_format = get_post_format ( $post_ID );
if ( empty ( $post_format ) )
2010-12-01 23:38:42 -05:00
$post_format = 'standard' ;
2010-09-23 17:22:21 -04:00
$sticky = false ;
if ( is_sticky ( $post_ID ) )
$sticky = true ;
$enclosure = array ();
foreach ( ( array ) get_post_custom ( $post_ID ) as $key => $val ) {
if ( $key == 'enclosure' ) {
foreach ( ( array ) $val as $enc ) {
2012-01-09 16:20:51 -05:00
$encdata = explode ( " \n " , $enc );
2010-09-23 17:22:21 -04:00
$enclosure [ 'url' ] = trim ( htmlspecialchars ( $encdata [ 0 ]));
$enclosure [ 'length' ] = ( int ) trim ( $encdata [ 1 ]);
$enclosure [ 'type' ] = trim ( $encdata [ 2 ]);
break 2 ;
}
}
}
$resp = array (
2012-04-04 17:32:28 -04:00
'dateCreated' => $post_date ,
2010-09-23 17:22:21 -04:00
'userid' => $postdata [ 'post_author' ],
'postid' => $postdata [ 'ID' ],
'description' => $post [ 'main' ],
'title' => $postdata [ 'post_title' ],
'link' => $link ,
'permaLink' => $link ,
// commented out because no other tool seems to use this
// 'content' => $entry['post_content'],
'categories' => $categories ,
'mt_excerpt' => $postdata [ 'post_excerpt' ],
'mt_text_more' => $post [ 'extended' ],
2012-03-08 07:50:21 -05:00
'wp_more_text' => $post [ 'more_text' ],
2010-09-23 17:22:21 -04:00
'mt_allow_comments' => $allow_comments ,
'mt_allow_pings' => $allow_pings ,
'mt_keywords' => $tagnames ,
'wp_slug' => $postdata [ 'post_name' ],
'wp_password' => $postdata [ 'post_password' ],
2011-10-27 14:36:49 -04:00
'wp_author_id' => ( string ) $author -> ID ,
2012-04-04 17:32:28 -04:00
'wp_author_display_name' => $author -> display_name ,
'date_created_gmt' => $post_date_gmt ,
2010-09-23 17:22:21 -04:00
'post_status' => $postdata [ 'post_status' ],
'custom_fields' => $this -> get_custom_fields ( $post_ID ),
2010-11-19 08:57:05 -05:00
'wp_post_format' => $post_format ,
2012-02-08 18:25:11 -05:00
'sticky' => $sticky ,
2012-04-04 17:32:28 -04:00
'date_modified' => $post_modified ,
'date_modified_gmt' => $post_modified_gmt
2010-09-23 17:22:21 -04:00
);
if ( ! empty ( $enclosure ) ) $resp [ 'enclosure' ] = $enclosure ;
2012-04-26 16:56:52 -04:00
$resp [ 'wp_post_thumbnail' ] = get_post_thumbnail_id ( $postdata [ 'ID' ] );
2012-03-23 11:35:44 -04:00
2010-09-23 17:22:21 -04:00
return $resp ;
} else {
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ));
}
}
/**
* Retrieve list of recent posts .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mw_getRecentPosts ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-11-09 05:16:23 -05:00
if ( isset ( $args [ 3 ] ) )
$query = array ( 'numberposts' => absint ( $args [ 3 ] ) );
else
$query = array ();
2010-09-23 17:22:21 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'metaWeblog.getRecentPosts' );
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
if ( ! $posts_list )
2012-03-02 13:06:30 -05:00
return array ();
2010-09-23 17:22:21 -04:00
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) )
continue ;
2012-04-04 17:32:28 -04:00
$post_date = $this -> _convert_date ( $entry [ 'post_date' ] );
$post_date_gmt = $this -> _convert_date_gmt ( $entry [ 'post_date_gmt' ], $entry [ 'post_date' ] );
$post_modified = $this -> _convert_date ( $entry [ 'post_modified' ] );
$post_modified_gmt = $this -> _convert_date_gmt ( $entry [ 'post_modified_gmt' ], $entry [ 'post_modified' ] );
2010-09-23 17:22:21 -04:00
$categories = array ();
$catids = wp_get_post_categories ( $entry [ 'ID' ]);
foreach ( $catids as $catid )
$categories [] = get_cat_name ( $catid );
$tagnames = array ();
$tags = wp_get_post_tags ( $entry [ 'ID' ] );
if ( ! empty ( $tags ) ) {
foreach ( $tags as $tag ) {
$tagnames [] = $tag -> name ;
}
$tagnames = implode ( ', ' , $tagnames );
} else {
$tagnames = '' ;
}
$post = get_extended ( $entry [ 'post_content' ]);
$link = post_permalink ( $entry [ 'ID' ]);
// Get the post author info.
$author = get_userdata ( $entry [ 'post_author' ]);
$allow_comments = ( 'open' == $entry [ 'comment_status' ]) ? 1 : 0 ;
$allow_pings = ( 'open' == $entry [ 'ping_status' ]) ? 1 : 0 ;
// Consider future posts as published
if ( $entry [ 'post_status' ] === 'future' )
$entry [ 'post_status' ] = 'publish' ;
2010-12-13 16:21:50 -05:00
// Get post format
2010-11-19 08:57:05 -05:00
$post_format = get_post_format ( $entry [ 'ID' ] );
if ( empty ( $post_format ) )
2010-12-01 23:38:42 -05:00
$post_format = 'standard' ;
2010-09-23 17:22:21 -04:00
$struct [] = array (
2012-04-04 17:32:28 -04:00
'dateCreated' => $post_date ,
2010-09-23 17:22:21 -04:00
'userid' => $entry [ 'post_author' ],
2010-11-20 10:50:56 -05:00
'postid' => ( string ) $entry [ 'ID' ],
2010-09-23 17:22:21 -04:00
'description' => $post [ 'main' ],
'title' => $entry [ 'post_title' ],
'link' => $link ,
'permaLink' => $link ,
// commented out because no other tool seems to use this
// 'content' => $entry['post_content'],
'categories' => $categories ,
'mt_excerpt' => $entry [ 'post_excerpt' ],
'mt_text_more' => $post [ 'extended' ],
2012-03-08 07:50:21 -05:00
'wp_more_text' => $post [ 'more_text' ],
2010-09-23 17:22:21 -04:00
'mt_allow_comments' => $allow_comments ,
'mt_allow_pings' => $allow_pings ,
'mt_keywords' => $tagnames ,
'wp_slug' => $entry [ 'post_name' ],
'wp_password' => $entry [ 'post_password' ],
2011-10-27 14:36:49 -04:00
'wp_author_id' => ( string ) $author -> ID ,
2010-09-23 17:22:21 -04:00
'wp_author_display_name' => $author -> display_name ,
2012-04-04 17:32:28 -04:00
'date_created_gmt' => $post_date_gmt ,
2010-09-23 17:22:21 -04:00
'post_status' => $entry [ 'post_status' ],
2010-11-19 08:57:05 -05:00
'custom_fields' => $this -> get_custom_fields ( $entry [ 'ID' ]),
2012-02-08 18:25:11 -05:00
'wp_post_format' => $post_format ,
2012-04-04 17:32:28 -04:00
'date_modified' => $post_modified ,
'date_modified_gmt' => $post_modified_gmt
2010-09-23 17:22:21 -04:00
);
2012-03-23 11:35:44 -04:00
$entry_index = count ( $struct ) - 1 ;
2012-04-26 16:56:52 -04:00
$struct [ $entry_index ][ 'wp_post_thumbnail' ] = get_post_thumbnail_id ( $entry [ 'ID' ] );
2010-09-23 17:22:21 -04:00
}
$recent_posts = array ();
for ( $j = 0 ; $j < count ( $struct ); $j ++ ) {
array_push ( $recent_posts , $struct [ $j ]);
}
return $recent_posts ;
}
/**
* Retrieve the list of categories on a given blog .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mw_getCategories ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view categories.' ) );
do_action ( 'xmlrpc_call' , 'metaWeblog.getCategories' );
$categories_struct = array ();
if ( $cats = get_categories ( array ( 'get' => 'all' )) ) {
foreach ( $cats as $cat ) {
$struct [ 'categoryId' ] = $cat -> term_id ;
$struct [ 'parentId' ] = $cat -> parent ;
$struct [ 'description' ] = $cat -> name ;
$struct [ 'categoryDescription' ] = $cat -> description ;
$struct [ 'categoryName' ] = $cat -> name ;
$struct [ 'htmlUrl' ] = esc_html ( get_category_link ( $cat -> term_id ));
$struct [ 'rssUrl' ] = esc_html ( get_category_feed_link ( $cat -> term_id , 'rss2' ));
$categories_struct [] = $struct ;
}
}
return $categories_struct ;
}
/**
* Uploads a file , following your settings .
*
* Adapted from a patch by Johann Richard .
*
* @ link http :// mycvs . org / archives / 2004 / 06 / 30 / file - upload - to - wordpress - in - ecto /
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mw_newMediaObject ( $args ) {
global $wpdb ;
$blog_ID = ( int ) $args [ 0 ];
$username = $wpdb -> escape ( $args [ 1 ]);
$password = $wpdb -> escape ( $args [ 2 ]);
$data = $args [ 3 ];
$name = sanitize_file_name ( $data [ 'name' ] );
$type = $data [ 'type' ];
$bits = $data [ 'bits' ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'metaWeblog.newMediaObject' );
if ( ! current_user_can ( 'upload_files' ) ) {
$this -> error = new IXR_Error ( 401 , __ ( 'You are not allowed to upload files to this site.' ));
return $this -> error ;
}
2011-05-06 15:51:47 -04:00
if ( $upload_err = apply_filters ( 'pre_upload_error' , false ) )
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 500 , $upload_err );
2011-05-06 15:51:47 -04:00
if ( ! empty ( $data [ 'overwrite' ]) && ( $data [ 'overwrite' ] == true ) ) {
2010-09-23 17:22:21 -04:00
// Get postmeta info on the object.
$old_file = $wpdb -> get_row ( "
SELECT ID
FROM { $wpdb -> posts }
WHERE post_title = '{$name}'
AND post_type = 'attachment'
" );
// Delete previous file.
wp_delete_attachment ( $old_file -> ID );
// Make sure the new name is different by pre-pending the
// previous post id.
2011-05-06 15:51:47 -04:00
$filename = preg_replace ( '/^wpid\d+-/' , '' , $name );
2010-09-23 17:22:21 -04:00
$name = " wpid { $old_file -> ID } - { $filename } " ;
}
2012-01-05 15:50:54 -05:00
$upload = wp_upload_bits ( $name , null , $bits );
2010-09-23 17:22:21 -04:00
if ( ! empty ( $upload [ 'error' ]) ) {
$errorString = sprintf ( __ ( 'Could not write file %1$s (%2$s)' ), $name , $upload [ 'error' ]);
return new IXR_Error ( 500 , $errorString );
}
// Construct the attachment array
// attach to post_id 0
$post_id = 0 ;
$attachment = array (
'post_title' => $name ,
'post_content' => '' ,
'post_type' => 'attachment' ,
'post_parent' => $post_id ,
'post_mime_type' => $type ,
'guid' => $upload [ 'url' ]
);
// Save the data
$id = wp_insert_attachment ( $attachment , $upload [ 'file' ], $post_id );
wp_update_attachment_metadata ( $id , wp_generate_attachment_metadata ( $id , $upload [ 'file' ] ) );
2012-03-08 08:12:06 -05:00
do_action ( 'xmlrpc_call_success_mw_newMediaObject' , $id , $args );
2012-03-28 08:00:50 -04:00
$struct = array (
'id' => strval ( $id ),
'file' => $name ,
'url' => $upload [ 'url' ],
'type' => $type
);
return apply_filters ( 'wp_handle_upload' , $struct , 'upload' );
2010-09-23 17:22:21 -04:00
}
/* MovableType API functions
* specs on http :// www . movabletype . org / docs / mtmanual_programmatic . html
*/
/**
* Retrieve the post titles of recent posts .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mt_getRecentPostTitles ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-11-09 05:16:23 -05:00
if ( isset ( $args [ 3 ] ) )
$query = array ( 'numberposts' => absint ( $args [ 3 ] ) );
else
$query = array ();
2010-09-23 17:22:21 -04:00
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'mt.getRecentPostTitles' );
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
if ( ! $posts_list ) {
$this -> error = new IXR_Error ( 500 , __ ( 'Either there are no posts, or something went wrong.' ));
return $this -> error ;
}
2012-04-08 05:40:04 -04:00
$struct = array ();
2010-09-23 17:22:21 -04:00
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) )
continue ;
2012-04-04 17:32:28 -04:00
$post_date = $this -> _convert_date ( $entry [ 'post_date' ] );
$post_date_gmt = $this -> _convert_date_gmt ( $entry [ 'post_date_gmt' ], $entry [ 'post_date' ] );
2010-09-23 17:22:21 -04:00
$struct [] = array (
2012-04-04 17:32:28 -04:00
'dateCreated' => $post_date ,
2010-09-23 17:22:21 -04:00
'userid' => $entry [ 'post_author' ],
2010-11-20 10:50:56 -05:00
'postid' => ( string ) $entry [ 'ID' ],
2010-09-23 17:22:21 -04:00
'title' => $entry [ 'post_title' ],
2011-04-18 13:16:46 -04:00
'post_status' => $entry [ 'post_status' ],
2012-04-04 17:32:28 -04:00
'date_created_gmt' => $post_date_gmt
2010-09-23 17:22:21 -04:00
);
}
$recent_posts = array ();
for ( $j = 0 ; $j < count ( $struct ); $j ++ ) {
array_push ( $recent_posts , $struct [ $j ]);
}
return $recent_posts ;
}
/**
* Retrieve list of all categories on blog .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mt_getCategoryList ( $args ) {
$this -> escape ( $args );
$blog_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
if ( ! current_user_can ( 'edit_posts' ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view categories.' ) );
do_action ( 'xmlrpc_call' , 'mt.getCategoryList' );
$categories_struct = array ();
if ( $cats = get_categories ( array ( 'hide_empty' => 0 , 'hierarchical' => 0 )) ) {
foreach ( $cats as $cat ) {
$struct [ 'categoryId' ] = $cat -> term_id ;
$struct [ 'categoryName' ] = $cat -> name ;
$categories_struct [] = $struct ;
}
}
return $categories_struct ;
}
/**
* Retrieve post categories .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mt_getPostCategories ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
2012-04-29 20:19:32 -04:00
if ( ! get_post ( $post_ID ) )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2010-09-23 17:22:21 -04:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you can not edit this post.' ) );
do_action ( 'xmlrpc_call' , 'mt.getPostCategories' );
$categories = array ();
$catids = wp_get_post_categories ( intval ( $post_ID ));
// first listed category will be the primary category
$isPrimary = true ;
foreach ( $catids as $catid ) {
$categories [] = array (
'categoryName' => get_cat_name ( $catid ),
'categoryId' => ( string ) $catid ,
'isPrimary' => $isPrimary
);
$isPrimary = false ;
}
return $categories ;
}
/**
* Sets categories for a post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return bool True on success .
*/
function mt_setPostCategories ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
$categories = $args [ 3 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'mt.setPostCategories' );
2012-04-29 20:19:32 -04:00
if ( ! get_post ( $post_ID ) )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2010-09-23 17:22:21 -04:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) )
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot edit this post.' ));
foreach ( $categories as $cat ) {
$catids [] = $cat [ 'categoryId' ];
}
wp_set_post_categories ( $post_ID , $catids );
return true ;
}
/**
* Retrieve an array of methods supported by this server .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function mt_supportedMethods ( $args ) {
do_action ( 'xmlrpc_call' , 'mt.supportedMethods' );
$supported_methods = array ();
foreach ( $this -> methods as $key => $value ) {
$supported_methods [] = $key ;
}
return $supported_methods ;
}
/**
* Retrieve an empty array because we don ' t support per - post text filters .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
*/
function mt_supportedTextFilters ( $args ) {
do_action ( 'xmlrpc_call' , 'mt.supportedTextFilters' );
return apply_filters ( 'xmlrpc_text_filters' , array ());
}
/**
* Retrieve trackbacks sent to a given post .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return mixed
*/
function mt_getTrackbackPings ( $args ) {
global $wpdb ;
$post_ID = intval ( $args );
do_action ( 'xmlrpc_call' , 'mt.getTrackbackPings' );
$actual_post = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $actual_post )
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ));
$comments = $wpdb -> get_results ( $wpdb -> prepare ( " SELECT comment_author_url, comment_content, comment_author_IP, comment_type FROM $wpdb->comments WHERE comment_post_ID = %d " , $post_ID ) );
if ( ! $comments )
return array ();
$trackback_pings = array ();
foreach ( $comments as $comment ) {
if ( 'trackback' == $comment -> comment_type ) {
$content = $comment -> comment_content ;
$title = substr ( $content , 8 , ( strpos ( $content , '</strong>' ) - 8 ));
$trackback_pings [] = array (
'pingTitle' => $title ,
'pingURL' => $comment -> comment_author_url ,
'pingIP' => $comment -> comment_author_IP
);
}
}
return $trackback_pings ;
}
/**
* Sets a post 's publish status to ' publish ' .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return int
*/
function mt_publishPost ( $args ) {
$this -> escape ( $args );
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
if ( ! $user = $this -> login ( $username , $password ) )
return $this -> error ;
do_action ( 'xmlrpc_call' , 'mt.publishPost' );
2012-04-29 20:19:32 -04:00
$postdata = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $postdata )
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2010-12-08 12:07:55 -05:00
if ( ! current_user_can ( 'publish_posts' ) || ! current_user_can ( 'edit_post' , $post_ID ) )
2010-12-08 11:18:42 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you cannot publish this post.' ));
2010-09-23 17:22:21 -04:00
$postdata [ 'post_status' ] = 'publish' ;
// retain old cats
$cats = wp_get_post_categories ( $post_ID );
$postdata [ 'post_category' ] = $cats ;
$this -> escape ( $postdata );
$result = wp_update_post ( $postdata );
return $result ;
}
/* PingBack functions
* specs on www . hixie . ch / specs / pingback / pingback
*/
/**
* Retrieves a pingback and registers it .
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function pingback_ping ( $args ) {
global $wpdb ;
do_action ( 'xmlrpc_call' , 'pingback.ping' );
$this -> escape ( $args );
$pagelinkedfrom = $args [ 0 ];
$pagelinkedto = $args [ 1 ];
$title = '' ;
$pagelinkedfrom = str_replace ( '&' , '&' , $pagelinkedfrom );
$pagelinkedto = str_replace ( '&' , '&' , $pagelinkedto );
$pagelinkedto = str_replace ( '&' , '&' , $pagelinkedto );
// Check if the page linked to is in our site
$pos1 = strpos ( $pagelinkedto , str_replace ( array ( 'http://www.' , 'http://' , 'https://www.' , 'https://' ), '' , get_option ( 'home' )));
if ( ! $pos1 )
return new IXR_Error ( 0 , __ ( 'Is there no link to us?' ));
// let's find which post is linked to
// FIXME: does url_to_postid() cover all these cases already?
// if so, then let's use it and drop the old code.
$urltest = parse_url ( $pagelinkedto );
if ( $post_ID = url_to_postid ( $pagelinkedto ) ) {
$way = 'url_to_postid()' ;
} elseif ( preg_match ( '#p/[0-9]{1,}#' , $urltest [ 'path' ], $match ) ) {
// the path defines the post_ID (archives/p/XXXX)
$blah = explode ( '/' , $match [ 0 ]);
$post_ID = ( int ) $blah [ 1 ];
$way = 'from the path' ;
} elseif ( preg_match ( '#p=[0-9]{1,}#' , $urltest [ 'query' ], $match ) ) {
// the querystring defines the post_ID (?p=XXXX)
$blah = explode ( '=' , $match [ 0 ]);
$post_ID = ( int ) $blah [ 1 ];
$way = 'from the querystring' ;
} elseif ( isset ( $urltest [ 'fragment' ]) ) {
// an #anchor is there, it's either...
if ( intval ( $urltest [ 'fragment' ]) ) {
2011-09-03 12:02:41 -04:00
// ...an integer #XXXX (simplest case)
2010-09-23 17:22:21 -04:00
$post_ID = ( int ) $urltest [ 'fragment' ];
$way = 'from the fragment (numeric)' ;
} elseif ( preg_match ( '/post-[0-9]+/' , $urltest [ 'fragment' ]) ) {
// ...a post id in the form 'post-###'
$post_ID = preg_replace ( '/[^0-9]+/' , '' , $urltest [ 'fragment' ]);
$way = 'from the fragment (post-###)' ;
} elseif ( is_string ( $urltest [ 'fragment' ]) ) {
// ...or a string #title, a little more complicated
$title = preg_replace ( '/[^a-z0-9]/i' , '.' , $urltest [ 'fragment' ]);
2010-12-16 09:22:41 -05:00
$sql = $wpdb -> prepare ( " SELECT ID FROM $wpdb->posts WHERE post_title RLIKE %s " , like_escape ( $title ) );
2010-09-23 17:22:21 -04:00
if ( ! ( $post_ID = $wpdb -> get_var ( $sql )) ) {
// returning unknown error '0' is better than die()ing
return new IXR_Error ( 0 , '' );
}
$way = 'from the fragment (title)' ;
}
} else {
// TODO: Attempt to extract a post ID from the given URL
return new IXR_Error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either doesn’t exist, or it is not a pingback-enabled resource.' ));
}
$post_ID = ( int ) $post_ID ;
$post = get_post ( $post_ID );
if ( ! $post ) // Post_ID not found
return new IXR_Error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either doesn’t exist, or it is not a pingback-enabled resource.' ));
if ( $post_ID == url_to_postid ( $pagelinkedfrom ) )
return new IXR_Error ( 0 , __ ( 'The source URL and the target URL cannot both point to the same resource.' ));
// Check if pings are on
if ( ! pings_open ( $post ) )
return new IXR_Error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either doesn’t exist, or it is not a pingback-enabled resource.' ));
// Let's check that the remote site didn't already pingback this entry
if ( $wpdb -> get_results ( $wpdb -> prepare ( " SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND comment_author_url = %s " , $post_ID , $pagelinkedfrom ) ) )
return new IXR_Error ( 48 , __ ( 'The pingback has already been registered.' ) );
// very stupid, but gives time to the 'from' server to publish !
sleep ( 1 );
// Let's check the remote site
$linea = wp_remote_fopen ( $pagelinkedfrom );
if ( ! $linea )
return new IXR_Error ( 16 , __ ( 'The source URL does not exist.' ));
$linea = apply_filters ( 'pre_remote_source' , $linea , $pagelinkedto );
// Work around bug in strip_tags():
$linea = str_replace ( '<!DOC' , '<DOC' , $linea );
$linea = preg_replace ( '/[\s\r\n\t]+/' , ' ' , $linea ); // normalize spaces
$linea = preg_replace ( " / <(h1|h2|h3|h4|h5|h6|p|th|td|li|dt|dd|pre|caption|input|textarea|button|body)[^>]*>/ " , " \n \n " , $linea );
preg_match ( '|<title>([^<]*?)</title>|is' , $linea , $matchtitle );
$title = $matchtitle [ 1 ];
if ( empty ( $title ) )
return new IXR_Error ( 32 , __ ( 'We cannot find a title on that page.' ));
$linea = strip_tags ( $linea , '<a>' ); // just keep the tag we need
$p = explode ( " \n \n " , $linea );
$preg_target = preg_quote ( $pagelinkedto , '|' );
foreach ( $p as $para ) {
if ( strpos ( $para , $pagelinkedto ) !== false ) { // it exists, but is it a link?
preg_match ( " |<a[^>]+? " . $preg_target . " [^>]*>([^>]+?)</a>| " , $para , $context );
// If the URL isn't in a link context, keep looking
if ( empty ( $context ) )
continue ;
// We're going to use this fake tag to mark the context in a bit
// the marker is needed in case the link text appears more than once in the paragraph
$excerpt = preg_replace ( '|\</?wpcontext\>|' , '' , $para );
// prevent really long link text
if ( strlen ( $context [ 1 ]) > 100 )
$context [ 1 ] = substr ( $context [ 1 ], 0 , 100 ) . '...' ;
$marker = '<wpcontext>' . $context [ 1 ] . '</wpcontext>' ; // set up our marker
$excerpt = str_replace ( $context [ 0 ], $marker , $excerpt ); // swap out the link for our marker
$excerpt = strip_tags ( $excerpt , '<wpcontext>' ); // strip all tags but our context marker
$excerpt = trim ( $excerpt );
$preg_marker = preg_quote ( $marker , '|' );
$excerpt = preg_replace ( " |.*? \ s(. { 0,100} $preg_marker . { 0,100}) \ s.*|s " , '$1' , $excerpt );
$excerpt = strip_tags ( $excerpt ); // YES, again, to remove the marker wrapper
break ;
}
}
if ( empty ( $context ) ) // Link to target not found
return new IXR_Error ( 17 , __ ( 'The source URL does not contain a link to the target URL, and so cannot be used as a source.' ));
$pagelinkedfrom = str_replace ( '&' , '&' , $pagelinkedfrom );
$context = '[...] ' . esc_html ( $excerpt ) . ' [...]' ;
$pagelinkedfrom = $wpdb -> escape ( $pagelinkedfrom );
$comment_post_ID = ( int ) $post_ID ;
$comment_author = $title ;
2010-12-11 02:17:50 -05:00
$comment_author_email = '' ;
2010-09-23 17:22:21 -04:00
$this -> escape ( $comment_author );
$comment_author_url = $pagelinkedfrom ;
$comment_content = $context ;
$this -> escape ( $comment_content );
$comment_type = 'pingback' ;
2010-12-11 02:17:50 -05:00
$commentdata = compact ( 'comment_post_ID' , 'comment_author' , 'comment_author_url' , 'comment_author_email' , 'comment_content' , 'comment_type' );
2010-09-23 17:22:21 -04:00
$comment_ID = wp_new_comment ( $commentdata );
do_action ( 'pingback_post' , $comment_ID );
return sprintf ( __ ( 'Pingback from %1$s to %2$s registered. Keep the web talking! :-)' ), $pagelinkedfrom , $pagelinkedto );
}
/**
* Retrieve array of URLs that pingbacked the given URL .
*
* Specs on http :// www . aquarionics . com / misc / archives / blogite / 0198. html
*
* @ since 1.5 . 0
*
* @ param array $args Method parameters .
* @ return array
*/
function pingback_extensions_getPingbacks ( $args ) {
global $wpdb ;
do_action ( 'xmlrpc_call' , 'pingback.extensions.getPingbacks' );
$this -> escape ( $args );
$url = $args ;
$post_ID = url_to_postid ( $url );
if ( ! $post_ID ) {
// We aren't sure that the resource is available and/or pingback enabled
return new IXR_Error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either doesn’t exist, or it is not a pingback-enabled resource.' ));
}
$actual_post = wp_get_single_post ( $post_ID , ARRAY_A );
if ( ! $actual_post ) {
// No such post = resource not found
return new IXR_Error ( 32 , __ ( 'The specified target URL does not exist.' ));
}
$comments = $wpdb -> get_results ( $wpdb -> prepare ( " SELECT comment_author_url, comment_content, comment_author_IP, comment_type FROM $wpdb->comments WHERE comment_post_ID = %d " , $post_ID ) );
if ( ! $comments )
return array ();
$pingbacks = array ();
foreach ( $comments as $comment ) {
if ( 'pingback' == $comment -> comment_type )
$pingbacks [] = $comment -> comment_author_url ;
}
return $pingbacks ;
}
}