2010-09-23 17:22:21 -04:00
< ? php
/**
* XML - RPC protocol support for WordPress
*
* @ package WordPress
2014-02-25 12:14:14 -05:00
* @ subpackage Publishing
2010-09-23 17:22:21 -04:00
*/
/**
* 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 .
*
2013-07-17 16:19:06 -04:00
* As of WordPress 3.5 . 0 , XML - RPC is enabled by default . It can be disabled
2021-05-23 22:18:58 -04:00
* via the { @ see 'xmlrpc_enabled' } filter found in wp_xmlrpc_server :: set_is_enabled () .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
2017-07-01 12:58:42 -04:00
*
* @ see IXR_Server
2010-09-23 17:22:21 -04:00
*/
Code Modernization: Add `AllowDynamicProperties` attribute to all (parent) classes.
Dynamic (non-explicitly declared) properties are deprecated as of PHP 8.2 and are expected to become a fatal error in PHP 9.0.
There are a number of ways to mitigate this:
* If it is an accidental typo for a declared property: fix the typo.
* For known properties: declare them on the class.
* For unknown properties: add the magic `__get()`, `__set()`, et al. methods to the class or let the class extend `stdClass` which has highly optimized versions of these magic methods built in.
* For unknown ''use'' of dynamic properties, the `#[AllowDynamicProperties]` attribute can be added to the class. The attribute will automatically be inherited by child classes.
Trac ticket #56034 is open to investigate and handle the third and fourth type of situations, however it has become clear this will need more time and will not be ready in time for WP 6.1.
To reduce “noise” in the meantime, both in the error logs of WP users moving onto PHP 8.2, in the test run logs of WP itself, in test runs of plugins and themes, as well as to prevent duplicate tickets from being opened for the same issue, this commit adds the `#[AllowDynamicProperties]` attribute to all “parent” classes in WP.
The logic used for this commit is as follows:
* If a class already has the attribute: no action needed.
* If a class does not `extend`: add the attribute.
* If a class does `extend`:
- If it extends `stdClass`: no action needed (as `stdClass` supports dynamic properties).
- If it extends a PHP native class: add the attribute.
- If it extends a class from one of WP's external dependencies: add the attribute.
* In all other cases: no action — the attribute should not be needed as child classes inherit from the parent.
Whether or not a class contains magic methods has not been taken into account, as a review of the currently existing magic methods has shown that those are generally not sturdy enough and often even set dynamic properties (which they should not). See the [https://www.youtube.com/watch?v=vDZWepDQQVE live stream from August 16, 2022] for more details.
This commit only affects classes in the `src` directory of WordPress core.
* Tests should not get this attribute, but should be fixed to not use dynamic properties instead. Patches for this are already being committed under ticket #56033.
* While a number bundled themes (2014, 2019, 2020, 2021) contain classes, they are not a part of this commit and may be updated separately.
Reference: [https://wiki.php.net/rfc/deprecate_dynamic_properties PHP RFC: Deprecate dynamic properties].
Follow-up to [53922].
Props jrf, hellofromTonya, markjaquith, peterwilsoncc, costdev, knutsp, aristath.
See #56513, #56034.
Built from https://develop.svn.wordpress.org/trunk@54133
git-svn-id: http://core.svn.wordpress.org/trunk@53692 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-12 11:47:14 -04:00
#[AllowDynamicProperties]
2010-09-23 17:22:21 -04:00
class wp_xmlrpc_server extends IXR_Server {
2014-11-02 22:04:22 -05:00
/**
2015-05-23 15:23:25 -04:00
* Methods .
*
2014-11-02 22:04:22 -05:00
* @ var array
*/
public $methods ;
2015-05-23 15:23:25 -04:00
2014-11-02 22:04:22 -05:00
/**
2015-05-23 15:23:25 -04:00
* Blog options .
*
2014-11-02 22:04:22 -05:00
* @ var array
*/
public $blog_options ;
2015-05-23 15:23:25 -04:00
2014-11-02 22:04:22 -05:00
/**
2015-05-23 15:23:25 -04:00
* IXR_Error instance .
*
2014-11-02 22:04:22 -05:00
* @ var IXR_Error
*/
public $error ;
2015-05-23 15:23:25 -04:00
2015-10-23 00:46:24 -04:00
/**
* Flags that the user authentication has failed in this instance of wp_xmlrpc_server .
*
* @ var bool
*/
protected $auth_failed = false ;
2021-05-23 22:18:58 -04:00
/**
* Flags that XML - RPC is enabled
*
* @ var bool
*/
private $is_enabled ;
2010-09-23 17:22:21 -04:00
/**
2016-05-23 14:54:27 -04:00
* Registers all of the XMLRPC methods that XMLRPC server understands .
2010-09-23 17:22:21 -04:00
*
2011-04-29 16:05:12 -04:00
* Sets up server and method property . Passes XMLRPC
2016-05-23 14:54:27 -04:00
* methods through the { @ see 'xmlrpc_methods' } filter to allow plugins to extend
* or replace XML - RPC methods .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
*/
2014-05-19 02:09:13 -04:00
public function __construct () {
2010-09-23 17:22:21 -04:00
$this -> methods = array (
2020-01-28 19:45:18 -05:00
// WordPress API.
2017-11-30 18:11:00 -05:00
'wp.getUsersBlogs' => 'this:wp_getUsersBlogs' ,
'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' ,
'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' ,
'wp.getUser' => 'this:wp_getUser' ,
'wp.getUsers' => 'this:wp_getUsers' ,
'wp.getProfile' => 'this:wp_getProfile' ,
'wp.editProfile' => 'this:wp_editProfile' ,
'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' ,
2020-01-28 19:45:18 -05:00
'wp.getCategories' => 'this:mw_getCategories' , // Alias.
2017-11-30 18:11:00 -05:00
'wp.getTags' => 'this:wp_getTags' ,
'wp.newCategory' => 'this:wp_newCategory' ,
'wp.deleteCategory' => 'this:wp_deleteCategory' ,
'wp.suggestCategories' => 'this:wp_suggestCategories' ,
2020-01-28 19:45:18 -05:00
'wp.uploadFile' => 'this:mw_newMediaObject' , // Alias.
'wp.deleteFile' => 'this:wp_deletePost' , // Alias.
2017-11-30 18:11:00 -05:00
'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' ,
'wp.getMediaItem' => 'this:wp_getMediaItem' ,
'wp.getMediaLibrary' => 'this:wp_getMediaLibrary' ,
'wp.getPostFormats' => 'this:wp_getPostFormats' ,
'wp.getPostType' => 'this:wp_getPostType' ,
'wp.getPostTypes' => 'this:wp_getPostTypes' ,
'wp.getRevisions' => 'this:wp_getRevisions' ,
'wp.restoreRevision' => 'this:wp_restoreRevision' ,
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Blogger API.
2017-11-30 18:11:00 -05:00
'blogger.getUsersBlogs' => 'this:blogger_getUsersBlogs' ,
'blogger.getUserInfo' => 'this:blogger_getUserInfo' ,
'blogger.getPost' => 'this:blogger_getPost' ,
'blogger.getRecentPosts' => 'this:blogger_getRecentPosts' ,
'blogger.newPost' => 'this:blogger_newPost' ,
'blogger.editPost' => 'this:blogger_editPost' ,
'blogger.deletePost' => 'this:blogger_deletePost' ,
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// MetaWeblog API (with MT extensions to structs).
2017-11-30 18:11:00 -05:00
'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' ,
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// MetaWeblog API aliases for Blogger API.
// See http://www.xmlrpc.com/stories/storyReader$2460
2017-11-30 18:11:00 -05:00
'metaWeblog.deletePost' => 'this:blogger_deletePost' ,
'metaWeblog.getUsersBlogs' => 'this:blogger_getUsersBlogs' ,
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// MovableType API.
2017-11-30 18:11:00 -05:00
'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' ,
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Pingback.
2017-11-30 18:11:00 -05:00
'pingback.ping' => 'this:pingback_ping' ,
2010-09-23 17:22:21 -04:00
'pingback.extensions.getPingbacks' => 'this:pingback_extensions_getPingbacks' ,
2017-11-30 18:11:00 -05:00
'demo.sayHello' => 'this:sayHello' ,
'demo.addTwoNumbers' => 'this:addTwoNumbers' ,
2010-09-23 17:22:21 -04:00
);
2012-03-02 13:06:30 -05:00
$this -> initialise_blog_option_info ();
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the methods exposed by the XML - RPC server .
2014-03-26 01:44:16 -04:00
*
* This filter can be used to add new methods , and remove built - in methods .
*
* @ since 1.5 . 0
*
2019-10-26 17:09:04 -04:00
* @ param string [] $methods An array of XML - RPC methods , keyed by their methodName .
2014-03-26 01:44:16 -04:00
*/
$this -> methods = apply_filters ( 'xmlrpc_methods' , $this -> methods );
2021-05-23 22:18:58 -04:00
$this -> set_is_enabled ();
}
/**
* Set wp_xmlrpc_server :: $is_enabled property .
*
* Determine whether the xmlrpc server is enabled on this WordPress install
* and set the is_enabled property accordingly .
*
* @ since 5.7 . 3
*/
private function set_is_enabled () {
/*
* Respect old get_option () filters left for back - compat when the 'enable_xmlrpc'
2021-08-10 08:54:56 -04:00
* option was deprecated in 3.5 . 0. Use the { @ see 'xmlrpc_enabled' } hook instead .
2021-05-23 22:18:58 -04:00
*/
$is_enabled = apply_filters ( 'pre_option_enable_xmlrpc' , false );
if ( false === $is_enabled ) {
$is_enabled = apply_filters ( 'option_enable_xmlrpc' , true );
}
/**
* Filters whether XML - RPC methods requiring authentication are enabled .
*
* Contrary to the way it ' s named , this filter does not control whether XML - RPC is * fully *
* enabled , rather , it only controls whether XML - RPC methods requiring authentication - such
* as for publishing purposes - are enabled .
*
* Further , the filter does not control whether pingbacks or other custom endpoints that don ' t
* require authentication are enabled . This behavior is expected , and due to how parity was matched
* with the `enable_xmlrpc` UI option the filter replaced when it was introduced in 3.5 .
*
* To disable XML - RPC methods that require authentication , use :
*
* add_filter ( 'xmlrpc_enabled' , '__return_false' );
*
* For more granular control over all XML - RPC methods and requests , see the { @ see 'xmlrpc_methods' }
* and { @ see 'xmlrpc_element_limit' } hooks .
*
* @ since 3.5 . 0
*
* @ param bool $is_enabled Whether XML - RPC is enabled . Default true .
*/
$this -> is_enabled = apply_filters ( 'xmlrpc_enabled' , $is_enabled );
2010-09-23 17:22:21 -04:00
}
2014-05-19 02:09:13 -04:00
/**
2016-05-13 14:41:31 -04:00
* Make private / protected methods readable for backward compatibility .
2014-05-19 02:09:13 -04:00
*
* @ since 4.0 . 0
2014-07-13 20:46:15 -04:00
*
2020-07-23 17:11:05 -04:00
* @ param string $name Method to call .
* @ param array $arguments Arguments to pass when calling .
2015-05-22 15:37:24 -04:00
* @ return array | IXR_Error | false Return value of the callback , false otherwise .
2014-05-19 02:09:13 -04:00
*/
public function __call ( $name , $arguments ) {
2015-01-11 17:31:22 -05:00
if ( '_multisite_getUsersBlogs' === $name ) {
2019-09-15 07:53:56 -04:00
return $this -> _multisite_getUsersBlogs ( ... $arguments );
2015-01-11 17:31:22 -05:00
}
return false ;
2014-05-19 02:09:13 -04:00
}
2015-05-29 17:37:24 -04:00
/**
2015-12-16 00:43:26 -05:00
* Serves the XML - RPC request .
*
* @ since 2.9 . 0
2015-05-29 17:37:24 -04:00
*/
2014-05-19 02:09:13 -04:00
public function serve_request () {
2017-11-30 18:11:00 -05:00
$this -> IXR_Server ( $this -> methods );
2010-09-23 17:22:21 -04:00
}
/**
* Test XMLRPC API by saying , " Hello! " to client .
*
* @ since 1.5 . 0
*
2015-05-23 15:26:26 -04:00
* @ return string Hello string response .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function sayHello () {
2010-09-23 17:22:21 -04:00
return 'Hello!' ;
}
/**
* Test XMLRPC API by adding two numbers for client .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 A number to add .
* @ type int $ 1 A second number to add .
2015-05-22 15:37:24 -04:00
* }
2015-05-23 15:26:26 -04:00
* @ return int Sum of the two given numbers .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function addTwoNumbers ( $args ) {
2010-09-23 17:22:21 -04:00
$number1 = $args [ 0 ];
$number2 = $args [ 1 ];
return $number1 + $number2 ;
}
/**
* Log user in .
*
2012-09-18 21:27:21 -04:00
* @ since 2.8 . 0
2010-09-23 17:22:21 -04:00
*
* @ param string $username User ' s username .
* @ param string $password User ' s password .
2021-01-03 17:04:04 -05:00
* @ return WP_User | false WP_User object if authentication passed , false otherwise
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function login ( $username , $password ) {
2021-05-23 22:18:58 -04:00
if ( ! $this -> is_enabled ) {
2012-09-10 20:37:31 -04:00
$this -> error = new IXR_Error ( 405 , sprintf ( __ ( 'XML-RPC services are disabled on this site.' ) ) );
2010-09-23 17:22:21 -04:00
return false ;
}
2015-10-23 00:46:24 -04:00
if ( $this -> auth_failed ) {
$user = new WP_Error ( 'login_prevented' );
} else {
$user = wp_authenticate ( $username , $password );
}
2010-09-23 17:22:21 -04:00
2015-10-23 00:46:24 -04:00
if ( is_wp_error ( $user ) ) {
2012-09-18 21:36:47 -04:00
$this -> error = new IXR_Error ( 403 , __ ( 'Incorrect username or password.' ) );
2014-03-26 01:44:16 -04:00
2020-01-28 19:45:18 -05:00
// Flag that authentication has failed once on this wp_xmlrpc_server instance.
2015-10-23 00:46:24 -04:00
$this -> auth_failed = true ;
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the XML - RPC user login error message .
2014-03-26 01:44:16 -04:00
*
* @ since 3.5 . 0
*
2020-12-21 15:23:02 -05:00
* @ param IXR_Error $error The XML - RPC error message .
* @ param WP_Error $user WP_Error object .
2014-03-26 01:44:16 -04:00
*/
2012-09-18 21:36:47 -04:00
$this -> error = apply_filters ( 'xmlrpc_login_error' , $this -> error , $user );
2010-09-23 17:22:21 -04:00
return false ;
}
wp_set_current_user ( $user -> ID );
return $user ;
}
2012-09-18 21:27:21 -04:00
/**
* Check user ' s credentials . Deprecated .
*
* @ since 1.5 . 0
2015-08-20 18:38:25 -04:00
* @ deprecated 2.8 . 0 Use wp_xmlrpc_server :: login ()
* @ see wp_xmlrpc_server :: login ()
2012-09-18 21:27:21 -04:00
*
* @ param string $username User ' s username .
* @ param string $password User ' s password .
* @ return bool Whether authentication passed .
*/
2014-05-19 02:09:13 -04:00
public function login_pass_ok ( $username , $password ) {
2012-09-18 21:27:21 -04:00
return ( bool ) $this -> login ( $username , $password );
}
2010-09-23 17:22:21 -04:00
/**
2013-07-16 10:38:54 -04:00
* Escape string or array of strings for database .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 2
*
2013-07-16 10:38:54 -04:00
* @ param string | array $data Escape single string or array of strings .
2015-05-24 01:40:25 -04:00
* @ return string | void Returns with string is passed , alters by - reference
2015-05-22 15:37:24 -04:00
* when array is passed .
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function escape ( & $data ) {
2017-11-30 18:11:00 -05:00
if ( ! is_array ( $data ) ) {
2013-07-16 10:38:54 -04:00
return wp_slash ( $data );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2013-07-16 10:38:54 -04:00
foreach ( $data as & $v ) {
2017-11-30 18:11:00 -05:00
if ( is_array ( $v ) ) {
2013-07-18 10:31:25 -04:00
$this -> escape ( $v );
2017-11-30 18:11:00 -05:00
} elseif ( ! is_object ( $v ) ) {
2013-07-16 10:38:54 -04:00
$v = wp_slash ( $v );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
}
}
2021-05-23 22:18:58 -04:00
/**
* Send error response to client .
*
* Send an XML error response to the client . If the endpoint is enabled
* an HTTP 200 response is always sent per the XML - RPC specification .
*
* @ since 5.7 . 3
*
* @ param IXR_Error | string $error Error code or an error object .
* @ param false $message Error message . Optional .
*/
public function error ( $error , $message = false ) {
// Accepts either an error object or an error code and message
if ( $message && ! is_object ( $error ) ) {
$error = new IXR_Error ( $error , $message );
}
if ( ! $this -> is_enabled ) {
status_header ( $error -> code );
}
$this -> output ( $error -> getXml () );
}
2010-09-23 17:22:21 -04:00
/**
* Retrieve custom fields for post .
*
* @ since 2.5 . 0
*
* @ param int $post_id Post ID .
* @ return array Custom fields , if exist .
*/
2017-11-30 18:11:00 -05:00
public function get_custom_fields ( $post_id ) {
2010-09-23 17:22:21 -04:00
$post_id = ( int ) $post_id ;
$custom_fields = array ();
2017-11-30 18:11:00 -05:00
foreach ( ( array ) has_meta ( $post_id ) as $meta ) {
2010-09-23 17:22:21 -04:00
// Don't expose protected fields.
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post_meta' , $post_id , $meta [ 'meta_key' ] ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$custom_fields [] = array (
2017-11-30 18:11:00 -05:00
'id' => $meta [ 'meta_id' ],
'key' => $meta [ 'meta_key' ],
'value' => $meta [ 'meta_value' ],
2010-09-23 17:22:21 -04:00
);
}
return $custom_fields ;
}
/**
* Set custom fields for post .
*
* @ since 2.5 . 0
*
2020-07-23 17:11:05 -04:00
* @ param int $post_id Post ID .
* @ param array $fields Custom fields .
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function set_custom_fields ( $post_id , $fields ) {
2010-09-23 17:22:21 -04:00
$post_id = ( int ) $post_id ;
foreach ( ( array ) $fields as $meta ) {
2017-11-30 18:11:00 -05:00
if ( isset ( $meta [ 'id' ] ) ) {
2010-09-23 17:22:21 -04:00
$meta [ 'id' ] = ( int ) $meta [ 'id' ];
2017-11-30 18:11:00 -05:00
$pmeta = get_metadata_by_mid ( 'post' , $meta [ 'id' ] );
2017-05-16 04:46:42 -04:00
if ( ! $pmeta || $pmeta -> post_id != $post_id ) {
continue ;
}
2017-11-30 18:11:00 -05:00
if ( isset ( $meta [ 'key' ] ) ) {
2013-03-03 11:30:38 -05:00
$meta [ 'key' ] = wp_unslash ( $meta [ 'key' ] );
2017-11-30 18:11:00 -05:00
if ( $meta [ 'key' ] !== $pmeta -> meta_key ) {
2011-07-20 18:04:35 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2013-03-03 11:30:38 -05:00
$meta [ 'value' ] = wp_unslash ( $meta [ 'value' ] );
2017-11-30 18:11:00 -05: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' ] );
2017-11-30 18:11:00 -05:00
}
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
}
2013-03-03 11:30:38 -05:00
} elseif ( current_user_can ( 'add_post_meta' , $post_id , wp_unslash ( $meta [ 'key' ] ) ) ) {
2013-03-01 11:28:40 -05:00
add_post_meta ( $post_id , $meta [ 'key' ], $meta [ 'value' ] );
2010-09-23 17:22:21 -04:00
}
}
}
2017-06-18 06:40:46 -04:00
/**
* Retrieve custom fields for a term .
*
* @ since 4.9 . 0
*
2017-07-21 09:40:43 -04:00
* @ param int $term_id Term ID .
2017-06-18 06:40:46 -04:00
* @ return array Array of custom fields , if they exist .
*/
public function get_term_custom_fields ( $term_id ) {
$term_id = ( int ) $term_id ;
$custom_fields = array ();
foreach ( ( array ) has_term_meta ( $term_id ) as $meta ) {
if ( ! current_user_can ( 'edit_term_meta' , $term_id ) ) {
continue ;
}
$custom_fields [] = array (
'id' => $meta [ 'meta_id' ],
'key' => $meta [ 'meta_key' ],
'value' => $meta [ 'meta_value' ],
);
}
return $custom_fields ;
}
/**
* Set custom fields for a term .
*
* @ since 4.9 . 0
*
2020-07-23 17:11:05 -04:00
* @ param int $term_id Term ID .
* @ param array $fields Custom fields .
2017-06-18 06:40:46 -04:00
*/
public function set_term_custom_fields ( $term_id , $fields ) {
$term_id = ( int ) $term_id ;
foreach ( ( array ) $fields as $meta ) {
if ( isset ( $meta [ 'id' ] ) ) {
$meta [ 'id' ] = ( int ) $meta [ 'id' ];
2017-11-30 18:11:00 -05:00
$pmeta = get_metadata_by_mid ( 'term' , $meta [ 'id' ] );
2017-06-18 06:40:46 -04:00
if ( isset ( $meta [ 'key' ] ) ) {
$meta [ 'key' ] = wp_unslash ( $meta [ 'key' ] );
if ( $meta [ 'key' ] !== $pmeta -> meta_key ) {
continue ;
}
$meta [ 'value' ] = wp_unslash ( $meta [ 'value' ] );
if ( current_user_can ( 'edit_term_meta' , $term_id ) ) {
update_metadata_by_mid ( 'term' , $meta [ 'id' ], $meta [ 'value' ] );
}
} elseif ( current_user_can ( 'delete_term_meta' , $term_id ) ) {
delete_metadata_by_mid ( 'term' , $meta [ 'id' ] );
}
} elseif ( current_user_can ( 'add_term_meta' , $term_id ) ) {
add_term_meta ( $term_id , $meta [ 'key' ], $meta [ 'value' ] );
}
}
}
2010-09-23 17:22:21 -04:00
/**
* Set up blog options property .
*
2015-05-23 15:30:26 -04:00
* Passes property through { @ see 'xmlrpc_blog_options' } filter .
2010-09-23 17:22:21 -04:00
*
* @ since 2.6 . 0
*/
2014-05-19 02:09:13 -04:00
public function initialise_blog_option_info () {
2010-09-23 17:22:21 -04:00
$this -> blog_options = array (
2020-01-28 19:45:18 -05:00
// Read-only options.
2017-11-30 18:11:00 -05:00
'software_name' => array (
'desc' => __ ( 'Software Name' ),
'readonly' => true ,
'value' => 'WordPress' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'software_version' => array (
'desc' => __ ( 'Software Version' ),
'readonly' => true ,
'value' => get_bloginfo ( 'version' ),
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'blog_url' => array (
'desc' => __ ( 'WordPress Address (URL)' ),
'readonly' => true ,
'option' => 'siteurl' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'home_url' => array (
'desc' => __ ( 'Site Address (URL)' ),
'readonly' => true ,
'option' => 'home' ,
2012-09-10 21:26:38 -04:00
),
2017-11-30 18:11:00 -05:00
'login_url' => array (
'desc' => __ ( 'Login Address (URL)' ),
'readonly' => true ,
'value' => wp_login_url (),
2013-05-29 07:01:32 -04:00
),
2017-11-30 18:11:00 -05:00
'admin_url' => array (
'desc' => __ ( 'The URL to the admin area' ),
'readonly' => true ,
'value' => get_admin_url (),
2013-05-29 07:01:32 -04:00
),
2012-03-02 13:06:30 -05:00
'image_default_link_type' => array (
2017-11-30 18:11:00 -05:00
'desc' => __ ( 'Image default link type' ),
'readonly' => true ,
'option' => 'image_default_link_type' ,
2012-02-08 18:28:23 -05:00
),
2017-11-30 18:11:00 -05:00
'image_default_size' => array (
'desc' => __ ( 'Image default size' ),
'readonly' => true ,
'option' => 'image_default_size' ,
2012-02-08 18:28:23 -05:00
),
2017-11-30 18:11:00 -05:00
'image_default_align' => array (
'desc' => __ ( 'Image default align' ),
'readonly' => true ,
'option' => 'image_default_align' ,
2012-02-08 18:28:23 -05:00
),
2017-11-30 18:11:00 -05:00
'template' => array (
'desc' => __ ( 'Template' ),
'readonly' => true ,
'option' => 'template' ,
2012-03-02 12:59:47 -05:00
),
2017-11-30 18:11:00 -05:00
'stylesheet' => array (
'desc' => __ ( 'Stylesheet' ),
'readonly' => true ,
'option' => 'stylesheet' ,
2012-03-02 12:59:47 -05:00
),
2017-11-30 18:11:00 -05:00
'post_thumbnail' => array (
'desc' => __ ( 'Post Thumbnail' ),
'readonly' => true ,
'value' => current_theme_supports ( 'post-thumbnails' ),
2012-03-08 07:19:45 -05:00
),
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Updatable options.
2017-11-30 18:11:00 -05:00
'time_zone' => array (
'desc' => __ ( 'Time Zone' ),
'readonly' => false ,
'option' => 'gmt_offset' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'blog_title' => array (
'desc' => __ ( 'Site Title' ),
'readonly' => false ,
'option' => 'blogname' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'blog_tagline' => array (
'desc' => __ ( 'Site Tagline' ),
'readonly' => false ,
'option' => 'blogdescription' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'date_format' => array (
'desc' => __ ( 'Date Format' ),
'readonly' => false ,
'option' => 'date_format' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -05:00
'time_format' => array (
'desc' => __ ( 'Time Format' ),
'readonly' => false ,
'option' => 'time_format' ,
2010-09-23 17:22:21 -04:00
),
2017-11-30 18:11:00 -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
),
2017-11-30 18:11:00 -05:00
'thumbnail_size_w' => array (
'desc' => __ ( 'Thumbnail Width' ),
'readonly' => false ,
'option' => 'thumbnail_size_w' ,
2010-10-26 13:46:29 -04:00
),
2017-11-30 18:11:00 -05:00
'thumbnail_size_h' => array (
'desc' => __ ( 'Thumbnail Height' ),
'readonly' => false ,
'option' => 'thumbnail_size_h' ,
2010-10-26 13:46:29 -04:00
),
2017-11-30 18:11:00 -05:00
'thumbnail_crop' => array (
'desc' => __ ( 'Crop thumbnail to exact dimensions' ),
'readonly' => false ,
'option' => 'thumbnail_crop' ,
2010-10-26 13:46:29 -04:00
),
2017-11-30 18:11:00 -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
),
2017-11-30 18:11:00 -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
),
2017-11-30 18:11:00 -05:00
'medium_large_size_w' => array (
'desc' => __ ( 'Medium-Large size image width' ),
'readonly' => false ,
'option' => 'medium_large_size_w' ,
2015-10-31 16:50:25 -04:00
),
2017-11-30 18:11:00 -05:00
'medium_large_size_h' => array (
'desc' => __ ( 'Medium-Large size image height' ),
'readonly' => false ,
'option' => 'medium_large_size_h' ,
2015-10-31 16:50:25 -04:00
),
2017-11-30 18:11:00 -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
),
2017-11-30 18:11:00 -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
),
2017-11-30 18:11:00 -05:00
'default_comment_status' => array (
2019-06-20 08:53:52 -04:00
'desc' => __ ( 'Allow people to submit comments on new posts.' ),
2017-11-30 18:11:00 -05:00
'readonly' => false ,
'option' => 'default_comment_status' ,
),
'default_ping_status' => array (
2019-06-20 08:53:52 -04:00
'desc' => __ ( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new posts.' ),
2017-11-30 18:11:00 -05:00
'readonly' => false ,
'option' => 'default_ping_status' ,
2012-01-07 14:08:48 -05:00
),
2010-09-23 17:22:21 -04:00
);
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the XML - RPC blog options property .
2014-03-26 01:44:16 -04:00
*
* @ since 2.6 . 0
*
* @ param array $blog_options An array of XML - RPC blog options .
*/
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
*
2015-05-23 15:33:27 -04:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type string $ 0 Username .
* @ type string $ 1 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error Array contains :
2011-04-18 03:23:47 -04:00
* - 'isAdmin'
2015-09-26 00:35:25 -04:00
* - 'isPrimary' - whether the blog is the user ' s primary blog
2011-04-18 03:23:47 -04:00
* - 'url'
* - 'blogid'
* - 'blogName'
* - 'xmlrpc' - url of xmlrpc endpoint
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getUsersBlogs ( $args ) {
2016-09-13 19:17:28 -04:00
if ( ! $this -> minimum_args ( $args , 2 ) ) {
return $this -> error ;
}
2020-01-28 19:45:18 -05:00
// If this isn't on WPMU then just use blogger_getUsersBlogs().
2017-11-30 18:11:00 -05:00
if ( ! is_multisite () ) {
2010-09-23 17:22:21 -04:00
array_unshift ( $args , 1 );
return $this -> blogger_getUsersBlogs ( $args );
}
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2010-09-23 17:22:21 -04:00
$username = $args [ 0 ];
$password = $args [ 1 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after the XML - RPC user has been authenticated but before the rest of
* the method logic begins .
*
* All built - in XML - RPC methods use the action xmlrpc_call , with a parameter
* equal to the method ' s name , e . g . , wp . getUsersBlogs , wp . newPost , etc .
*
* @ since 2.5 . 0
2021-02-16 12:03:05 -05:00
* @ since 5.7 . 0 Added the `$args` and `$server` parameters .
2014-03-26 01:44:16 -04:00
*
2021-02-16 12:03:05 -05:00
* @ param string $name The method name .
* @ param array | string $args The escaped arguments passed to the method .
* @ param wp_xmlrpc_server $server The XML - RPC server instance .
2014-03-26 01:44:16 -04:00
*/
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getUsersBlogs' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$blogs = ( array ) get_blogs_of_user ( $user -> ID );
$struct = array ();
2015-09-26 00:35:25 -04:00
$primary_blog_id = 0 ;
2017-11-30 18:11:00 -05:00
$active_blog = get_active_blog_for_user ( $user -> ID );
2015-09-26 00:35:25 -04:00
if ( $active_blog ) {
$primary_blog_id = ( int ) $active_blog -> blog_id ;
}
2010-09-23 17:22:21 -04:00
foreach ( $blogs as $blog ) {
2015-05-23 15:37:26 -04:00
// Don't include blogs that aren't hosted at this site.
2020-02-09 11:55:09 -05:00
if ( get_current_network_id () != $blog -> site_id ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$blog_id = $blog -> userblog_id ;
2012-08-03 13:51:42 -04:00
switch_to_blog ( $blog_id );
2012-08-09 12:28:15 -04:00
2017-11-30 18:11:00 -05:00
$is_admin = current_user_can ( 'manage_options' );
2015-09-26 00:35:25 -04:00
$is_primary = ( ( int ) $blog_id === $primary_blog_id );
2012-08-09 12:28:15 -04:00
2010-09-23 17:22:21 -04:00
$struct [] = array (
2015-09-26 00:35:25 -04:00
'isAdmin' => $is_admin ,
'isPrimary' => $is_primary ,
'url' => home_url ( '/' ),
'blogid' => ( string ) $blog_id ,
'blogName' => get_option ( 'blogname' ),
'xmlrpc' => site_url ( 'xmlrpc.php' , 'rpc' ),
2010-09-23 17:22:21 -04:00
);
2012-08-09 12:28:15 -04:00
2012-08-03 13:51:42 -04: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 .
*
2012-05-14 06:10:01 -04:00
* @ since 3.4 . 0
2012-05-02 17:13:08 -04:00
*
2019-09-16 05:58:56 -04:00
* @ param array $args An array of arguments to check .
* @ param int $count Minimum number of arguments .
2019-09-16 12:32:55 -04:00
* @ return bool True if `$args` contains at least `$count` arguments , false otherwise .
2012-05-02 17:13:08 -04:00
*/
protected function minimum_args ( $args , $count ) {
2019-09-16 05:58:56 -04:00
if ( ! is_array ( $args ) || count ( $args ) < $count ) {
2012-05-02 17:13:08 -04:00
$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 .
*
2020-10-17 12:05:09 -04:00
* @ param WP_Taxonomy $taxonomy The unprepared taxonomy data .
* @ param array $fields The subset of taxonomy fields to return .
2015-05-23 15:38:25 -04:00
* @ return array The prepared taxonomy 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
*/
2012-04-28 14:48:10 -04:00
protected function _prepare_taxonomy ( $taxonomy , $fields ) {
$_taxonomy = array (
2017-11-30 18:11:00 -05:00
'name' => $taxonomy -> name ,
'label' => $taxonomy -> label ,
2012-04-28 14:48:10 -04:00
'hierarchical' => ( bool ) $taxonomy -> hierarchical ,
2017-11-30 18:11:00 -05:00
'public' => ( bool ) $taxonomy -> public ,
'show_ui' => ( bool ) $taxonomy -> show_ui ,
'_builtin' => ( bool ) $taxonomy -> _builtin ,
2012-04-28 14:48:10 -04:00
);
2020-04-04 23:02:11 -04:00
if ( in_array ( 'labels' , $fields , true ) ) {
2012-04-28 14:48:10 -04:00
$_taxonomy [ 'labels' ] = ( array ) $taxonomy -> labels ;
2017-11-30 18:11:00 -05: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
2020-04-04 23:02:11 -04:00
if ( in_array ( 'cap' , $fields , true ) ) {
2012-05-01 16:33:06 -04:00
$_taxonomy [ 'cap' ] = ( array ) $taxonomy -> cap ;
2017-11-30 18:11:00 -05: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
2020-04-04 23:02:11 -04:00
if ( in_array ( 'menu' , $fields , true ) ) {
2020-12-21 12:11:05 -05:00
$_taxonomy [ 'show_in_menu' ] = ( bool ) $taxonomy -> show_in_menu ;
2017-11-30 18:11:00 -05:00
}
2013-08-26 18:35:10 -04:00
2020-04-04 23:02:11 -04:00
if ( in_array ( 'object_type' , $fields , true ) ) {
2012-05-01 17:03:50 -04:00
$_taxonomy [ 'object_type' ] = array_unique ( ( array ) $taxonomy -> object_type );
2017-11-30 18:11:00 -05:00
}
2012-04-28 14:48:10 -04:00
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given taxonomy .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
2016-10-07 13:12:29 -04:00
* @ param array $_taxonomy An array of taxonomy data .
* @ param WP_Taxonomy $taxonomy Taxonomy object .
* @ param array $fields The subset of taxonomy fields to return .
2014-03-26 01:44:16 -04:00
*/
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 .
*
2015-05-23 15:40:24 -04:00
* @ param array | object $term The unprepared term data .
* @ return array The prepared term 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_term ( $term ) {
$_term = $term ;
2017-11-30 18:11:00 -05:00
if ( ! is_array ( $_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
$_term = get_object_vars ( $_term );
2017-11-30 18:11:00 -05: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
2013-05-14 14:22:54 -04:00
// For integers which may be larger than XML-RPC supports ensure we return strings.
2020-10-08 17:15:13 -04:00
$_term [ 'term_id' ] = ( string ) $_term [ 'term_id' ];
$_term [ 'term_group' ] = ( string ) $_term [ 'term_group' ];
$_term [ 'term_taxonomy_id' ] = ( string ) $_term [ 'term_taxonomy_id' ];
$_term [ 'parent' ] = ( string ) $_term [ 'parent' ];
2012-03-08 08:31:32 -05:00
2013-05-14 14:22:54 -04:00
// Count we are happy to return as an integer because people really shouldn't use terms that much.
2020-10-08 17:15:13 -04:00
$_term [ 'count' ] = ( int ) $_term [ 'count' ];
2012-03-08 08:31:32 -05:00
2017-06-18 06:40:46 -04:00
// Get term meta.
$_term [ 'custom_fields' ] = $this -> get_term_custom_fields ( $_term [ 'term_id' ] );
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given term .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $_term An array of term data .
* @ param array | object $term Term object or array .
*/
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 .
*
2015-05-23 15:40:24 -04:00
* @ param string $date Date string to convert .
* @ return IXR_Date IXR_Date object .
2012-03-08 06:19:53 -05:00
*/
protected function _convert_date ( $date ) {
2020-02-09 11:55:09 -05:00
if ( '0000-00-00 00:00:00' === $date ) {
2012-03-08 06:19:53 -05: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
/**
2012-05-14 06:10:01 -04:00
* Convert a WordPress GMT date string to an IXR_Date object .
2012-04-04 17:32:28 -04:00
*
2015-05-23 15:41:24 -04:00
* @ param string $date_gmt WordPress GMT date string .
* @ param string $date Date string .
* @ return IXR_Date IXR_Date object .
2012-04-04 17:32:28 -04:00
*/
protected function _convert_date_gmt ( $date_gmt , $date ) {
2020-02-09 11:55:09 -05:00
if ( '0000-00-00 00:00:00' !== $date && '0000-00-00 00:00:00' === $date_gmt ) {
2012-04-04 17:32:28 -04: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 .
*
2015-05-23 15:47:25 -04:00
* @ param array $post The unprepared post data .
* @ param array $fields The subset of post type fields to return .
* @ return array The prepared post data .
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
*/
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 ) {
2015-05-23 15:47:25 -04:00
// Holds the data for this post. built up based on $fields.
2020-10-08 17:15:13 -04:00
$_post = array ( 'post_id' => ( string ) $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
2015-05-23 15:47:25 -04:00
// Prepare common 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
$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' ],
2013-02-28 14:40:26 -05:00
'post_author' => $post [ 'post_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
'post_password' => $post [ 'post_password' ],
'post_excerpt' => $post [ 'post_excerpt' ],
'post_content' => $post [ 'post_content' ],
2020-10-08 17:15:13 -04:00
'post_parent' => ( string ) $post [ 'post_parent' ],
2012-08-15 12:06:05 -04:00
'post_mime_type' => $post [ 'post_mime_type' ],
2015-08-20 02:24:26 -04:00
'link' => get_permalink ( $post [ 'ID' ] ),
2012-08-15 12:06:05 -04:00
'guid' => $post [ 'guid' ],
2020-10-08 17:15:13 -04:00
'menu_order' => ( int ) $post [ 'menu_order' ],
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
'comment_status' => $post [ 'comment_status' ],
'ping_status' => $post [ 'ping_status' ],
2020-02-09 11:55:09 -05:00
'sticky' => ( 'post' === $post [ 'post_type' ] && is_sticky ( $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
);
2015-05-23 15:47:25 -04:00
// Thumbnail.
2012-04-26 16:56:52 -04:00
$post_fields [ 'post_thumbnail' ] = array ();
2017-11-30 18:11:00 -05:00
$thumbnail_id = get_post_thumbnail_id ( $post [ 'ID' ] );
2012-04-26 16:56:52 -04:00
if ( $thumbnail_id ) {
2017-11-30 18:11:00 -05:00
$thumbnail_size = current_theme_supports ( 'post-thumbnail' ) ? 'post-thumbnail' : 'thumbnail' ;
2012-04-26 16:56:52 -04:00
$post_fields [ 'post_thumbnail' ] = $this -> _prepare_media_item ( get_post ( $thumbnail_id ), $thumbnail_size );
}
2012-03-23 11:35:44 -04:00
2015-05-23 15:47:25 -04:00
// Consider future posts as published.
2020-02-09 11:55:09 -05:00
if ( 'future' === $post_fields [ 'post_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
$post_fields [ 'post_status' ] = 'publish' ;
2017-11-30 18:11:00 -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
2015-05-23 15:47:25 -04:00
// Fill in blank 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
$post_fields [ 'post_format' ] = get_post_format ( $post [ 'ID' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $post_fields [ '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
$post_fields [ 'post_format' ] = 'standard' ;
2017-11-30 18:11:00 -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
2015-05-23 15:47:25 -04:00
// Merge requested $post_fields fields into $_post.
2020-04-04 23:02:11 -04:00
if ( in_array ( 'post' , $fields , true ) ) {
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 = array_merge ( $_post , $post_fields );
} else {
$requested_fields = array_intersect_key ( $post_fields , array_flip ( $fields ) );
2017-11-30 18:11:00 -05:00
$_post = array_merge ( $_post , $requested_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
}
2020-04-04 23:02:11 -04:00
$all_taxonomy_fields = in_array ( 'taxonomies' , $fields , true );
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
2020-04-04 23:02:11 -04:00
if ( $all_taxonomy_fields || in_array ( 'terms' , $fields , true ) ) {
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 [ 'post_type' ], 'names' );
2017-11-30 18:11:00 -05:00
$terms = wp_get_object_terms ( $post [ 'ID' ], $post_type_taxonomies );
$_post [ 'terms' ] = 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
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
}
}
2020-04-04 23:02:11 -04:00
if ( in_array ( 'custom_fields' , $fields , true ) ) {
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 [ 'custom_fields' ] = $this -> get_custom_fields ( $post [ 'ID' ] );
2017-11-30 18:11:00 -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
2020-04-04 23:02:11 -04:00
if ( in_array ( 'enclosure' , $fields , true ) ) {
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 [ 'enclosure' ] = array ();
2017-11-30 18:11:00 -05:00
$enclosures = ( array ) get_post_meta ( $post [ 'ID' ], 'enclosure' );
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 ( ! empty ( $enclosures ) ) {
2017-11-30 18:11:00 -05:00
$encdata = explode ( " \n " , $enclosures [ 0 ] );
$_post [ 'enclosure' ][ 'url' ] = trim ( htmlspecialchars ( $encdata [ 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
$_post [ 'enclosure' ][ 'length' ] = ( int ) trim ( $encdata [ 1 ] );
2017-11-30 18:11:00 -05:00
$_post [ 'enclosure' ][ 'type' ] = trim ( $encdata [ 2 ] );
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
}
}
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared date for the given post .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $_post An array of modified post data .
* @ param array $post An array of post data .
* @ param array $fields An array of post fields .
*/
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 .
*
2016-07-13 11:24:28 -04:00
* @ since 3.4 . 0
* @ since 4.6 . 0 Converted the `$post_type` parameter to accept a WP_Post_Type object .
2012-03-23 13:53:14 -04:00
*
2016-06-28 12:41:35 -04:00
* @ param WP_Post_Type $post_type Post type object .
* @ param array $fields The subset of post fields to return .
2015-05-23 15:47:25 -04:00
* @ return array The prepared post type data .
2012-03-23 13:53:14 -04:00
*/
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 (
2017-11-30 18:11:00 -05:00
'name' => $post_type -> name ,
'label' => $post_type -> label ,
2012-04-28 14:48:10 -04:00
'hierarchical' => ( bool ) $post_type -> hierarchical ,
2017-11-30 18:11:00 -05:00
'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
);
2020-04-04 23:02:11 -04:00
if ( in_array ( 'labels' , $fields , true ) ) {
2012-04-28 14:48:10 -04:00
$_post_type [ 'labels' ] = ( array ) $post_type -> labels ;
2012-03-23 13:53:14 -04:00
}
2020-04-04 23:02:11 -04:00
if ( in_array ( 'cap' , $fields , true ) ) {
2017-11-30 18:11:00 -05:00
$_post_type [ 'cap' ] = ( array ) $post_type -> cap ;
2012-04-28 14:48:10 -04:00
$_post_type [ 'map_meta_cap' ] = ( bool ) $post_type -> map_meta_cap ;
2012-03-23 13:53:14 -04:00
}
2020-04-04 23:02:11 -04:00
if ( in_array ( 'menu' , $fields , true ) ) {
2012-04-28 14:48:10 -04:00
$_post_type [ 'menu_position' ] = ( int ) $post_type -> menu_position ;
2017-11-30 18:11:00 -05:00
$_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
}
2020-04-04 23:02:11 -04:00
if ( in_array ( 'taxonomies' , $fields , true ) ) {
2012-04-28 17:22:07 -04:00
$_post_type [ 'taxonomies' ] = get_object_taxonomies ( $post_type -> name , 'names' );
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared date for the given post type .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
2016-07-13 11:24:28 -04:00
* @ since 4.6 . 0 Converted the `$post_type` parameter to accept a WP_Post_Type object .
2014-03-26 01:44:16 -04:00
*
2016-06-28 12:41:35 -04:00
* @ param array $_post_type An array of post type data .
* @ param WP_Post_Type $post_type Post type object .
2014-03-26 01:44:16 -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 .
*
2020-10-17 12:05:09 -04:00
* @ param WP_Post $media_item The unprepared media item data .
* @ param string $thumbnail_size The image size to use for the thumbnail URL .
2015-05-23 15:47:25 -04:00
* @ return array The prepared media item data .
2012-04-26 16:56:52 -04:00
*/
2012-05-14 06:10:01 -04:00
protected function _prepare_media_item ( $media_item , $thumbnail_size = 'thumbnail' ) {
2012-04-26 16:56:52 -04:00
$_media_item = array (
2020-10-08 17:15:13 -04:00
'attachment_id' => ( string ) $media_item -> ID ,
2012-04-26 16:56:52 -04:00
'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 ),
2017-11-30 18:11:00 -05:00
'type' => $media_item -> post_mime_type ,
2012-04-26 16:56:52 -04:00
);
$thumbnail_src = image_downsize ( $media_item -> ID , $thumbnail_size );
2017-11-30 18:11:00 -05:00
if ( $thumbnail_src ) {
2012-04-26 16:56:52 -04:00
$_media_item [ 'thumbnail' ] = $thumbnail_src [ 0 ];
2017-11-30 18:11:00 -05:00
} else {
2012-04-26 16:56:52 -04:00
$_media_item [ 'thumbnail' ] = $_media_item [ 'link' ];
2017-11-30 18:11:00 -05:00
}
2012-04-26 16:56:52 -04:00
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given media item .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
2020-10-17 12:05:09 -04:00
* @ param array $_media_item An array of media item data .
* @ param WP_Post $media_item Media item object .
* @ param string $thumbnail_size Image size .
2014-03-26 01:44:16 -04:00
*/
2012-05-11 17:04:47 -04:00
return apply_filters ( 'xmlrpc_prepare_media_item' , $_media_item , $media_item , $thumbnail_size );
2012-04-26 16:56:52 -04:00
}
2012-05-16 14:06:34 -04:00
/**
* Prepares page data for return in an XML - RPC object .
*
2020-10-17 12:05:09 -04:00
* @ param WP_Post $page The unprepared page data .
2015-05-23 15:47:25 -04:00
* @ return array The prepared page data .
2012-05-16 14:06:34 -04:00
*/
protected function _prepare_page ( $page ) {
// Get all of the page content and link.
$full_page = get_extended ( $page -> post_content );
2017-11-30 18:11:00 -05:00
$link = get_permalink ( $page -> ID );
2012-05-16 14:06:34 -04:00
// Get info the page parent if there is one.
2017-11-30 18:11:00 -05:00
$parent_title = '' ;
2012-05-16 14:06:34 -04:00
if ( ! empty ( $page -> post_parent ) ) {
2017-11-30 18:11:00 -05:00
$parent = get_post ( $page -> post_parent );
2012-05-16 14:06:34 -04:00
$parent_title = $parent -> post_title ;
}
// Determine comment and ping settings.
$allow_comments = comments_open ( $page -> ID ) ? 1 : 0 ;
2017-11-30 18:11:00 -05:00
$allow_pings = pings_open ( $page -> ID ) ? 1 : 0 ;
2012-05-16 14:06:34 -04:00
// Format page date.
2017-11-30 18:11:00 -05:00
$page_date = $this -> _convert_date ( $page -> post_date );
2012-05-16 14:06:34 -04:00
$page_date_gmt = $this -> _convert_date_gmt ( $page -> post_date_gmt , $page -> post_date );
// Pull the categories info together.
$categories = array ();
2014-09-11 09:56:15 -04:00
if ( is_object_in_taxonomy ( 'page' , 'category' ) ) {
foreach ( wp_get_post_categories ( $page -> ID ) as $cat_id ) {
$categories [] = get_cat_name ( $cat_id );
}
2012-05-16 14:06:34 -04:00
}
// Get the author info.
$author = get_userdata ( $page -> post_author );
$page_template = get_page_template_slug ( $page -> ID );
2017-11-30 18:11:00 -05:00
if ( empty ( $page_template ) ) {
2012-05-16 14:06:34 -04:00
$page_template = 'default' ;
2017-11-30 18:11:00 -05:00
}
2012-05-16 14:06:34 -04:00
$_page = array (
'dateCreated' => $page_date ,
2013-02-28 14:40:26 -05:00
'userid' => $page -> post_author ,
2012-05-16 14:06:34 -04:00
'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 ,
'wp_author_id' => ( string ) $author -> ID ,
'wp_author_display_name' => $author -> display_name ,
'date_created_gmt' => $page_date_gmt ,
'custom_fields' => $this -> get_custom_fields ( $page -> ID ),
2017-11-30 18:11:00 -05:00
'wp_page_template' => $page_template ,
2012-05-16 14:06:34 -04:00
);
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given page .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $_page An array of page data .
* @ param WP_Post $page Page object .
*/
2012-05-16 14:06:34 -04:00
return apply_filters ( 'xmlrpc_prepare_page' , $_page , $page );
}
2012-05-23 16:40:40 -04:00
/**
* Prepares comment data for return in an XML - RPC object .
*
2020-10-17 12:05:09 -04:00
* @ param WP_Comment $comment The unprepared comment data .
2015-05-23 15:47:25 -04:00
* @ return array The prepared comment data .
2012-05-23 16:40:40 -04:00
*/
protected function _prepare_comment ( $comment ) {
// Format page date.
$comment_date_gmt = $this -> _convert_date_gmt ( $comment -> comment_date_gmt , $comment -> comment_date );
2014-10-31 21:29:24 -04:00
if ( '0' == $comment -> comment_approved ) {
2012-05-23 16:40:40 -04:00
$comment_status = 'hold' ;
2020-05-16 14:42:12 -04:00
} elseif ( 'spam' === $comment -> comment_approved ) {
2012-05-23 16:40:40 -04:00
$comment_status = 'spam' ;
2014-10-31 21:29:24 -04:00
} elseif ( '1' == $comment -> comment_approved ) {
2012-05-23 16:40:40 -04:00
$comment_status = 'approve' ;
2014-10-31 21:29:24 -04:00
} else {
2012-05-23 16:40:40 -04:00
$comment_status = $comment -> comment_approved ;
2014-10-31 21:29:24 -04:00
}
2012-05-23 16:40:40 -04:00
$_comment = array (
'date_created_gmt' => $comment_date_gmt ,
'user_id' => $comment -> user_id ,
'comment_id' => $comment -> comment_ID ,
'parent' => $comment -> comment_parent ,
'status' => $comment_status ,
'content' => $comment -> comment_content ,
2017-11-30 18:11:00 -05:00
'link' => get_comment_link ( $comment ),
2012-05-23 16:40:40 -04:00
'post_id' => $comment -> comment_post_ID ,
2017-11-30 18:11:00 -05:00
'post_title' => get_the_title ( $comment -> comment_post_ID ),
2012-05-23 16:40:40 -04:00
'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 ,
);
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given comment .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
2015-09-03 14:17:24 -04:00
* @ param array $_comment An array of prepared comment data .
* @ param WP_Comment $comment Comment object .
2014-03-26 01:44:16 -04:00
*/
2012-05-23 16:40:40 -04:00
return apply_filters ( 'xmlrpc_prepare_comment' , $_comment , $comment );
}
2012-09-11 20:04:21 -04:00
/**
* Prepares user data for return in an XML - RPC object .
*
2015-05-23 15:47:25 -04:00
* @ param WP_User $user The unprepared user object .
* @ param array $fields The subset of user fields to return .
* @ return array The prepared user data .
2012-09-11 20:04:21 -04:00
*/
protected function _prepare_user ( $user , $fields ) {
2020-10-08 17:15:13 -04:00
$_user = array ( 'user_id' => ( string ) $user -> ID );
2012-09-11 20:04:21 -04:00
$user_fields = array (
2017-11-30 18:11:00 -05:00
'username' => $user -> user_login ,
'first_name' => $user -> user_firstname ,
'last_name' => $user -> user_lastname ,
'registered' => $this -> _convert_date ( $user -> user_registered ),
'bio' => $user -> user_description ,
'email' => $user -> user_email ,
'nickname' => $user -> nickname ,
'nicename' => $user -> user_nicename ,
'url' => $user -> user_url ,
'display_name' => $user -> display_name ,
'roles' => $user -> roles ,
2012-09-11 20:04:21 -04:00
);
2020-04-04 23:02:11 -04:00
if ( in_array ( 'all' , $fields , true ) ) {
2012-09-11 20:04:21 -04:00
$_user = array_merge ( $_user , $user_fields );
2012-10-07 19:33:35 -04:00
} else {
2020-04-04 23:02:11 -04:00
if ( in_array ( 'basic' , $fields , true ) ) {
2012-09-11 20:04:21 -04:00
$basic_fields = array ( 'username' , 'email' , 'registered' , 'display_name' , 'nicename' );
2017-11-30 18:11:00 -05:00
$fields = array_merge ( $fields , $basic_fields );
2012-09-11 20:04:21 -04:00
}
$requested_fields = array_intersect_key ( $user_fields , array_flip ( $fields ) );
2017-11-30 18:11:00 -05:00
$_user = array_merge ( $_user , $requested_fields );
2012-09-11 20:04:21 -04:00
}
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters XML - RPC - prepared data for the given user .
2014-03-26 01:44:16 -04:00
*
* @ since 3.5 . 0
*
* @ param array $_user An array of user data .
* @ param WP_User $user User object .
* @ param array $fields An array of user fields .
*/
2012-09-11 20:04:21 -04:00
return apply_filters ( 'xmlrpc_prepare_user' , $_user , $user , $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
/**
* Create a new post for any registered post type .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2016-06-10 00:50:33 -04:00
* @ link https :// en . wikipedia . org / wiki / RSS_enclosure for information on RSS enclosures .
2015-05-25 02:25:25 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : top - level arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 {
2015-05-25 02:25:25 -04:00
* Content struct for adding a new post . See wp_insert_post () for information on
* additional post fields
*
* @ type string $post_type Post type . Default 'post' .
* @ type string $post_status Post status . Default 'draft'
* @ type string $post_title Post title .
* @ type int $post_author Post author ID .
* @ type string $post_excerpt Post excerpt .
* @ type string $post_content Post content .
* @ type string $post_date_gmt Post date in GMT .
* @ type string $post_date Post date .
* @ type string $post_password Post password ( 20 - character limit ) .
* @ type string $comment_status Post comment enabled status . Accepts 'open' or 'closed' .
* @ type string $ping_status Post ping status . Accepts 'open' or 'closed' .
* @ type bool $sticky Whether the post should be sticky . Automatically false if
* `$post_status` is 'private' .
* @ type int $post_thumbnail ID of an image to use as the post thumbnail / featured image .
* @ type array $custom_fields Array of meta key / value pairs to add to the post .
* @ type array $terms Associative array with taxonomy names as keys and arrays
* of term IDs as values .
* @ type array $terms_names Associative array with taxonomy names as keys and arrays
* of term names as values .
* @ type array $enclosure {
* Array of feed enclosure data to add to post meta .
*
* @ type string $url URL for the feed enclosure .
* @ type int $length Size in bytes of the enclosure .
* @ type string $type Mime - type for the enclosure .
* }
* }
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return int | IXR_Error Post ID on success , IXR_Error instance otherwise .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_newPost ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
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 ];
$content_struct = $args [ 3 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -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
2020-01-28 19:45:18 -05:00
// Convert the date field back to IXR form.
2015-01-15 20:06:24 -05:00
if ( isset ( $content_struct [ 'post_date' ] ) && ! ( $content_struct [ 'post_date' ] instanceof IXR_Date ) ) {
2014-06-26 13:43:14 -04:00
$content_struct [ 'post_date' ] = $this -> _convert_date ( $content_struct [ 'post_date' ] );
}
2020-01-28 19:45:18 -05:00
/*
* Ignore the existing GMT date if it is empty or a non - GMT date was supplied in $content_struct ,
* since _insert_post () will ignore the non - GMT date if the GMT date is set .
*/
2015-01-15 20:06:24 -05:00
if ( isset ( $content_struct [ 'post_date_gmt' ] ) && ! ( $content_struct [ 'post_date_gmt' ] instanceof IXR_Date ) ) {
2020-02-09 11:55:09 -05:00
if ( '0000-00-00 00:00:00' === $content_struct [ 'post_date_gmt' ] || isset ( $content_struct [ 'post_date' ] ) ) {
2014-06-26 13:43:14 -04:00
unset ( $content_struct [ 'post_date_gmt' ] );
} else {
$content_struct [ 'post_date_gmt' ] = $this -> _convert_date ( $content_struct [ 'post_date_gmt' ] );
}
}
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.newPost' , $args , $this );
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
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
}
2012-05-14 06:10:01 -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
* Helper method for filtering out elements from an array .
2012-04-28 14:48:10 -04:00
*
* @ since 3.4 . 0
2012-05-14 06:10:01 -04:00
*
* @ param int $count Number to compare to one .
2020-10-07 07:02:03 -04:00
* @ return bool True if the number is greater than one , false otherwise .
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-05-14 06:10:01 -04:00
private 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 ;
}
2015-07-19 14:09:25 -04:00
/**
2015-07-21 11:18:25 -04:00
* Encapsulate the logic for sticking a post
* and determining if the user has permission to do so
*
2015-07-19 14:09:25 -04:00
* @ since 4.3 . 0
*
* @ param array $post_data
* @ param bool $update
* @ return void | IXR_Error
*/
private function _toggle_sticky ( $post_data , $update = false ) {
$post_type = get_post_type_object ( $post_data [ 'post_type' ] );
// Private and password-protected posts cannot be stickied.
if ( 'private' === $post_data [ 'post_status' ] || ! empty ( $post_data [ 'post_password' ] ) ) {
// 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_data [ 'ID' ] );
}
2017-11-30 18:11:00 -05:00
} elseif ( isset ( $post_data [ 'sticky' ] ) ) {
2015-07-19 14:09:25 -04:00
if ( ! current_user_can ( $post_type -> cap -> edit_others_posts ) ) {
2016-11-17 10:53:33 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to make posts sticky.' ) );
2015-07-19 14:09:25 -04:00
}
$sticky = wp_validate_boolean ( $post_data [ 'sticky' ] );
if ( $sticky ) {
stick_post ( $post_data [ 'ID' ] );
} else {
unstick_post ( $post_data [ 'ID' ] );
}
}
}
2012-05-14 06:10:01 -04:00
/**
2015-05-23 15:47:25 -04:00
* Helper method for wp_newPost () and wp_editPost (), containing shared logic .
2012-04-28 14:48:10 -04:00
*
* @ since 3.4 . 0
2015-05-23 15:47:25 -04:00
*
* @ see wp_insert_post ()
2012-05-14 06:10:01 -04:00
*
2015-05-23 15:47:25 -04:00
* @ param WP_User $user The post author if post_author isn ' t set in $content_struct .
2014-11-02 22:04:22 -05:00
* @ param array | IXR_Error $content_struct Post data to insert .
2015-05-22 15:37:24 -04:00
* @ return IXR_Error | string
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 ) {
2017-05-16 04:09:42 -04:00
$defaults = array (
'post_status' => 'draft' ,
'post_type' => 'post' ,
'post_author' => null ,
'post_password' => null ,
'post_excerpt' => null ,
'post_content' => null ,
'post_title' => null ,
'post_date' => null ,
'post_date_gmt' => null ,
'post_format' => null ,
'post_name' => null ,
'post_thumbnail' => null ,
'post_parent' => null ,
'ping_status' => null ,
'comment_status' => null ,
'custom_fields' => null ,
'terms_names' => null ,
'terms' => null ,
'sticky' => null ,
'enclosure' => null ,
'ID' => null ,
);
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
2017-05-16 04:09:42 -04:00
$post_data = wp_parse_args ( array_intersect_key ( $content_struct , $defaults ), $defaults );
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 = get_post_type_object ( $post_data [ 'post_type' ] );
2017-11-30 18:11:00 -05:00
if ( ! $post_type ) {
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid post type.' ) );
2017-11-30 18:11:00 -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
2012-04-28 14:48:10 -04:00
$update = ! empty ( $post_data [ 'ID' ] );
2012-02-08 10:40:26 -05:00
if ( $update ) {
2017-11-30 18:11:00 -05:00
if ( ! get_post ( $post_data [ 'ID' ] ) ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
if ( ! current_user_can ( '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.' ) );
2017-11-30 18:11:00 -05:00
}
2020-02-09 11:55:09 -05:00
if ( get_post_type ( $post_data [ 'ID' ] ) !== $post_data [ 'post_type' ] ) {
2012-04-28 14:48:10 -04:00
return new IXR_Error ( 401 , __ ( 'The post type may not be changed.' ) );
2017-11-30 18:11:00 -05:00
}
2012-02-08 10:40:26 -05:00
} else {
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> create_posts ) || ! current_user_can ( $post_type -> cap -> edit_posts ) ) {
2012-02-08 10:40:26 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to post on this site.' ) );
2017-11-30 18:11:00 -05:00
}
2012-02-08 10:40:26 -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
switch ( $post_data [ 'post_status' ] ) {
case 'draft' :
case 'pending' :
break ;
case 'private' :
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> publish_posts ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create private posts in this post type.' ) );
2017-11-30 18:11:00 -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
break ;
case 'publish' :
case 'future' :
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> publish_posts ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish posts in this post type.' ) );
2017-11-30 18:11:00 -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
break ;
default :
2017-11-30 18:11:00 -05:00
if ( ! get_post_status_object ( $post_data [ 'post_status' ] ) ) {
2012-11-05 09:44:25 -05:00
$post_data [ 'post_status' ] = 'draft' ;
2017-11-30 18:11:00 -05:00
}
break ;
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
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $post_data [ 'post_password' ] ) && ! current_user_can ( $post_type -> cap -> publish_posts ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create password protected posts in this post type.' ) );
2017-11-30 18:11:00 -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
$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 ) {
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> edit_others_posts ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create posts as this user.' ) );
2017-11-30 18:11:00 -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
$author = get_userdata ( $post_data [ 'post_author' ] );
2017-11-30 18:11:00 -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.' ) );
2017-11-30 18:11:00 -05:00
}
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 ;
}
2020-02-09 11:55:09 -05:00
if ( isset ( $post_data [ 'comment_status' ] ) && 'open' !== $post_data [ 'comment_status' ] && 'closed' !== $post_data [ 'comment_status' ] ) {
2012-04-28 14:48:10 -04:00
unset ( $post_data [ 'comment_status' ] );
2017-11-30 18:11:00 -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
2020-02-09 11:55:09 -05:00
if ( isset ( $post_data [ 'ping_status' ] ) && 'open' !== $post_data [ 'ping_status' ] && 'closed' !== $post_data [ 'ping_status' ] ) {
2012-04-28 14:48:10 -04:00
unset ( $post_data [ 'ping_status' ] );
2017-11-30 18:11:00 -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
2015-05-23 15:47:25 -04:00
// Do some timestamp voodoo.
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 ( ! empty ( $post_data [ 'post_date_gmt' ] ) ) {
2015-05-23 15:47:25 -04:00
// 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 ();
}
2016-03-22 11:10:28 -04:00
// Default to not flagging the post date to be edited unless it's intentional.
$post_data [ 'edit_date' ] = false ;
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 ( ! empty ( $dateCreated ) ) {
2019-12-09 14:56:05 -05:00
$post_data [ 'post_date' ] = iso8601_to_datetime ( $dateCreated );
$post_data [ 'post_date_gmt' ] = iso8601_to_datetime ( $dateCreated , 'gmt' );
2016-03-22 11:10:28 -04:00
// Flag the post date to be edited.
$post_data [ 'edit_date' ] = true ;
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
}
2017-11-30 18:11:00 -05: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 ;
2017-11-30 18:11:00 -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
$post_ID = $post_data [ 'ID' ];
2020-02-09 11:55:09 -05:00
if ( 'post' === $post_data [ 'post_type' ] ) {
2015-07-19 14:09:25 -04:00
$error = $this -> _toggle_sticky ( $post_data , $update );
if ( $error ) {
return $error ;
2012-04-28 14:48:10 -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
}
2012-04-28 14:48:10 -04:00
if ( isset ( $post_data [ 'post_thumbnail' ] ) ) {
2020-01-28 19:45:18 -05:00
// Empty value deletes, non-empty value adds/updates.
2017-11-30 18:11:00 -05:00
if ( ! $post_data [ 'post_thumbnail' ] ) {
2012-03-23 11:35:44 -04:00
delete_post_thumbnail ( $post_ID );
2017-11-30 18:11:00 -05:00
} elseif ( ! get_post ( absint ( $post_data [ 'post_thumbnail' ] ) ) ) {
2012-10-23 10:08:20 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-10-23 10:08:20 -04:00
set_post_thumbnail ( $post_ID , $post_data [ 'post_thumbnail' ] );
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2017-11-30 18:11:00 -05: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' ] );
2017-11-30 18:11:00 -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
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' );
2015-05-23 15:47:25 -04:00
// Accumulate term IDs from terms and 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
$terms = array ();
2015-05-23 15:47:25 -04:00
// 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' ] );
2020-06-20 08:02:12 -04:00
// Validating term IDs.
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
foreach ( $taxonomies as $taxonomy ) {
2017-11-30 18:11:00 -05:00
if ( ! array_key_exists ( $taxonomy , $post_type_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
return new IXR_Error ( 401 , __ ( 'Sorry, one of the given taxonomies is not supported by the post type.' ) );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -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.' ) );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
$term_ids = $post_data [ 'terms' ][ $taxonomy ];
2014-03-15 01:09:14 -04:00
$terms [ $taxonomy ] = 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
foreach ( $term_ids as $term_id ) {
$term = get_term_by ( 'id' , $term_id , $taxonomy );
2017-11-30 18:11:00 -05:00
if ( ! $term ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid term ID.' ) );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
$terms [ $taxonomy ][] = ( int ) $term_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
}
}
}
2015-05-23 15:47:25 -04:00
// Now validate terms specified by name.
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 ( isset ( $post_data [ 'terms_names' ] ) && is_array ( $post_data [ 'terms_names' ] ) ) {
$taxonomies = array_keys ( $post_data [ 'terms_names' ] );
foreach ( $taxonomies as $taxonomy ) {
2017-11-30 18:11:00 -05:00
if ( ! array_key_exists ( $taxonomy , $post_type_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
return new IXR_Error ( 401 , __ ( 'Sorry, one of the given taxonomies is not supported by the post type.' ) );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -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.' ) );
2017-11-30 18:11:00 -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
2015-05-23 15:47:25 -04:00
/*
* For hierarchical taxonomies , we can ' t assign a term when multiple terms
* in the hierarchy share the same name .
*/
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
$ambiguous_terms = array ();
2012-02-08 09:54:15 -05:00
if ( is_taxonomy_hierarchical ( $taxonomy ) ) {
2017-11-30 18:11:00 -05:00
$tax_term_names = get_terms (
2018-08-16 21:51:36 -04:00
array (
2019-08-02 23:35:56 -04:00
'taxonomy' => $taxonomy ,
2017-11-30 18:11:00 -05:00
'fields' => 'names' ,
'hide_empty' => false ,
)
);
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
2015-05-23 15:47:25 -04:00
// Count the number of terms with the same name.
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_count = array_count_values ( $tax_term_names );
2015-05-23 15:47:25 -04:00
// Filter out non-ambiguous term names.
2017-11-30 18:11:00 -05:00
$ambiguous_tax_term_counts = array_filter ( $tax_term_names_count , array ( $this , '_is_greater_than_one' ) );
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
$ambiguous_terms = array_keys ( $ambiguous_tax_term_counts );
}
2017-11-30 18:11:00 -05:00
$term_names = $post_data [ 'terms_names' ][ $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
foreach ( $term_names as $term_name ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $term_name , $ambiguous_terms , true ) ) {
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 , __ ( 'Ambiguous term name used in a hierarchical taxonomy. Please use term ID instead.' ) );
2017-11-30 18:11:00 -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
$term = get_term_by ( 'name' , $term_name , $taxonomy );
if ( ! $term ) {
2015-05-23 15:47:25 -04:00
// Term doesn't exist, so check that the user is allowed to create new terms.
2017-11-30 18:11:00 -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.' ) );
2017-11-30 18:11:00 -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
2015-05-23 15:47:25 -04:00
// Create the new 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
$term_info = wp_insert_term ( $term_name , $taxonomy );
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $term_info ) ) {
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 ( 500 , $term_info -> get_error_message () );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
$terms [ $taxonomy ][] = ( int ) $term_info [ 'term_id' ];
2012-02-08 11:04:58 -05:00
} else {
2017-11-30 18:11:00 -05:00
$terms [ $taxonomy ][] = ( int ) $term -> term_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 [ 'tax_input' ] = $terms ;
2012-04-28 14:48:10 -04:00
unset ( $post_data [ 'terms' ], $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
}
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' ] );
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $format -> get_error_message () );
2017-11-30 18:11:00 -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
unset ( $post_data [ 'post_format' ] );
}
2015-05-23 15:47:25 -04:00
// Handle enclosures.
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
$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' ] );
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters post data array to be inserted via XML - RPC .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $post_data Parsed array of post data .
* @ param array $content_struct Post data 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
$post_data = apply_filters ( 'xmlrpc_wp_insert_post_data' , $post_data , $content_struct );
2012-11-14 17:58:24 -05:00
$post_ID = $update ? wp_update_post ( $post_data , true ) : wp_insert_post ( $post_data , true );
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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 ( 500 , $post_ID -> get_error_message () );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
if ( ! $post_ID ) {
2019-12-05 08:48:03 -05:00
if ( $update ) {
return new IXR_Error ( 401 , __ ( 'Sorry, the post could not be updated.' ) );
} else {
return new IXR_Error ( 401 , __ ( 'Sorry, the post could not be created.' ) );
}
2017-11-30 18:11:00 -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
2020-10-08 17:15:13 -04:00
return ( string ) $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-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 .
*
* The $content_struct parameter only needs to contain fields that
* should be changed . All other fields will retain their existing values .
*
2012-05-14 06:10:01 -04:00
* @ since 3.4 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Post ID .
* @ type array $ 4 Extra content arguments .
2015-05-22 15:37:24 -04:00
* }
2015-05-23 15:47:25 -04:00
* @ return true | IXR_Error True on success , IXR_Error on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_editPost ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 5 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
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 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.editPost' , $args , $this );
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 = get_post ( $post_id , ARRAY_A );
2017-11-30 18:11:00 -05: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.' ) );
2017-11-30 18:11:00 -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
2012-09-26 23:39:40 -04:00
if ( isset ( $content_struct [ 'if_not_modified_since' ] ) ) {
// If the post has been modified since the date provided, return an error.
if ( mysql2date ( 'U' , $post [ 'post_modified_gmt' ] ) > $content_struct [ 'if_not_modified_since' ] -> getTimestamp () ) {
return new IXR_Error ( 409 , __ ( 'There is a revision of this post that is more recent.' ) );
}
}
2015-05-25 02:25:25 -04:00
// 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
2015-05-25 02:25:25 -04:00
/*
* Ignore the existing GMT date if it is empty or a non - GMT date was supplied in $content_struct ,
* since _insert_post () will ignore the non - GMT date if the GMT date is set .
*/
2020-02-09 11:55:09 -05:00
if ( '0000-00-00 00:00:00' === $post [ 'post_date_gmt' ] || isset ( $content_struct [ '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
unset ( $post [ 'post_date_gmt' ] );
2017-11-30 18:11:00 -05:00
} else {
2012-03-08 06:19:53 -05:00
$post [ 'post_date_gmt' ] = $this -> _convert_date ( $post [ 'post_date_gmt' ] );
2017-11-30 18:11:00 -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
2019-08-28 22:10:56 -04:00
/*
2020-01-28 19:45:18 -05:00
* If the API client did not provide 'post_date' , then we must not perpetuate the value that
* was stored in the database , or it will appear to be an intentional edit . Conveying it here
* as if it was coming from the API client will cause an otherwise zeroed out 'post_date_gmt'
* to get set with the value that was originally stored in the database when the draft was created .
2019-08-28 22:10:56 -04:00
*/
if ( ! isset ( $content_struct [ 'post_date' ] ) ) {
unset ( $post [ 'post_date' ] );
}
2013-03-01 11:28:40 -05:00
$this -> escape ( $post );
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
$merged_content_struct = array_merge ( $post , $content_struct );
2012-02-08 12:00:19 -05:00
$retval = $this -> _insert_post ( $user , $merged_content_struct );
2017-11-30 18:11:00 -05:00
if ( $retval instanceof IXR_Error ) {
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 $retval ;
2017-11-30 18:11:00 -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
return true ;
}
/**
* Delete a post for any registered post type .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ see wp_delete_post ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Post ID .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return true | IXR_Error True on success , IXR_Error instance on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_deletePost ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.deletePost' , $args , $this );
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-08-28 15:08:28 -04:00
$post = get_post ( $post_id , ARRAY_A );
2015-10-03 10:09:43 -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.' ) );
2015-10-03 10:09:43 -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
2015-10-03 10:09:43 -04:00
if ( ! current_user_can ( 'delete_post' , $post_id ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this post.' ) );
2015-10-03 10:09:43 -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
$result = wp_delete_post ( $post_id );
2015-10-03 10:09:43 -04:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be deleted.' ) );
2015-10-03 10:09:43 -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
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' .
*
2015-05-25 02:25:25 -04:00
* @ see get_post ()
*
* @ param array $args {
* Method arguments . Note : arguments must be ordered as documented .
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Post ID .
* @ type array $ 4 Optional . The subset of post type fields to return .
2015-05-25 02:25:25 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error Array contains ( based on $fields parameter ) :
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_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'
*/
2014-05-19 02:09:13 -04:00
public function wp_getPost ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
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
2014-04-10 17:04:14 -04:00
if ( isset ( $args [ 4 ] ) ) {
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
$fields = $args [ 4 ];
2014-04-10 17:04:14 -04:00
} else {
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the list of post query fields used by the given XML - RPC method .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ param array $fields Array of post fields . Default array contains 'post' , 'terms' , and 'custom_fields' .
2014-03-26 01:44:16 -04:00
* @ param string $method Method name .
*/
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
$fields = apply_filters ( 'xmlrpc_default_post_fields' , array ( 'post' , 'terms' , 'custom_fields' ), 'wp.getPost' );
2014-04-10 17:04:14 -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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPost' , $args , $this );
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-08-28 15:08:28 -04:00
$post = get_post ( $post_id , ARRAY_A );
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
2017-11-30 18:11:00 -05: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.' ) );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_id ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -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
return $this -> _prepare_post ( $post , $fields );
}
/**
* Retrieve posts .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ see wp_get_recent_posts ()
* @ see wp_getPost () for more on `$fields`
* @ see get_posts () for more on `$filter` values
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
*
2015-05-25 02:25:25 -04:00
* @ param array $args {
* Method arguments . Note : arguments must be ordered as documented .
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
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . Modifies the query used to retrieve posts . Accepts 'post_type' ,
* 'post_status' , 'number' , 'offset' , 'orderby' , 's' , and 'order' .
* Default empty array .
* @ type array $ 4 Optional . The subset of post type fields to return in the response array .
2015-05-25 02:25:25 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error 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
*/
2014-05-19 02:09:13 -04:00
public function wp_getPosts ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : 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
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
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
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
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
$fields = apply_filters ( 'xmlrpc_default_post_fields' , array ( 'post' , 'terms' , 'custom_fields' ), 'wp.getPosts' );
2014-03-26 01:44:16 -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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPosts' , $args , $this );
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
$query = array ();
if ( isset ( $filter [ 'post_type' ] ) ) {
$post_type = get_post_type_object ( $filter [ 'post_type' ] );
2017-11-30 18:11:00 -05:00
if ( ! ( ( bool ) $post_type ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid post type.' ) );
2017-11-30 18:11:00 -05:00
}
2012-06-26 15:04:10 -04:00
} else {
$post_type = get_post_type_object ( 'post' );
}
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
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) ) {
2016-11-17 10:53:33 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts in this post type.' ) );
2017-11-30 18:11:00 -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
2012-06-26 15:04:10 -04:00
$query [ 'post_type' ] = $post_type -> name ;
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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'post_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
$query [ 'post_status' ] = $filter [ 'post_status' ];
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'number' ] ) ) {
2012-05-22 18:25:17 -04:00
$query [ 'numberposts' ] = absint ( $filter [ 'number' ] );
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'offset' ] ) ) {
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
$query [ 'offset' ] = absint ( $filter [ 'offset' ] );
2017-11-30 18:11:00 -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
if ( isset ( $filter [ 'orderby' ] ) ) {
$query [ 'orderby' ] = $filter [ 'orderby' ];
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'order' ] ) ) {
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
$query [ 'order' ] = $filter [ 'order' ];
2017-11-30 18:11:00 -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
}
2012-09-26 23:39:40 -04:00
2012-09-21 06:18:32 -04:00
if ( isset ( $filter [ 's' ] ) ) {
$query [ 's' ] = $filter [ 's' ];
}
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
$posts_list = wp_get_recent_posts ( $query );
2017-11-30 18:11:00 -05:00
if ( ! $posts_list ) {
2012-03-02 13:06:30 -05:00
return array ();
2017-11-30 18:11:00 -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
2015-05-25 02:25:25 -04:00
// Holds all the posts data.
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
$struct = array ();
foreach ( $posts_list as $post ) {
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_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
continue ;
2017-11-30 18:11:00 -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
$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
*
2015-05-25 02:25:25 -04:00
* @ see wp_insert_term ()
*
* @ param array $args {
* Method arguments . Note : arguments must be ordered as documented .
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Content struct for adding a new term . The struct must contain
* the term 'name' and 'taxonomy' . Optional accepted values include
* 'parent' , 'description' , and 'slug' .
2015-05-25 02:25:25 -04:00
* }
* @ return int | IXR_Error The term ID on success , or an IXR_Error object on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_newTerm ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$content_struct = $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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.newTerm' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $content_struct [ 'taxonomy' ] ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
$taxonomy = get_taxonomy ( $content_struct [ 'taxonomy' ] );
Taxonomy: Introduce more fine grained capabilities for managing taxonomy terms.
This introduces the singular `edit_term`, `delete_term`, and `assign_term` meta capabilities for terms, and switches the base capability name for tags from `manage_categories` to `manage_post_tags` and the corresponding `edit_post_tags`, `delete_post_tags`, and `assign_post_tags`.
All of these capabilities ultimately map to `manage_categories` so by default there is no change in the behaviour of the capabilities for categories, tags, or custom taxonomies. The `map_meta_cap` filter and the `capabilities` argument when registering a taxonomy now allow for control over editing, deleting, and assigning individual terms, as well as a separation of capabilities for tags from those of categories.
Fixes #35614
Props johnjamesjacoby for feedback
Built from https://develop.svn.wordpress.org/trunk@38698
git-svn-id: http://core.svn.wordpress.org/trunk@38641 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 18:40:28 -04:00
if ( ! current_user_can ( $taxonomy -> cap -> edit_terms ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create terms in this taxonomy.' ) );
Taxonomy: Introduce more fine grained capabilities for managing taxonomy terms.
This introduces the singular `edit_term`, `delete_term`, and `assign_term` meta capabilities for terms, and switches the base capability name for tags from `manage_categories` to `manage_post_tags` and the corresponding `edit_post_tags`, `delete_post_tags`, and `assign_post_tags`.
All of these capabilities ultimately map to `manage_categories` so by default there is no change in the behaviour of the capabilities for categories, tags, or custom taxonomies. The `map_meta_cap` filter and the `capabilities` argument when registering a taxonomy now allow for control over editing, deleting, and assigning individual terms, as well as a separation of capabilities for tags from those of categories.
Fixes #35614
Props johnjamesjacoby for feedback
Built from https://develop.svn.wordpress.org/trunk@38698
git-svn-id: http://core.svn.wordpress.org/trunk@38641 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 18:40: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
$taxonomy = ( array ) $taxonomy ;
2020-01-28 19:45:18 -05:00
// Hold the data of the 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
$term_data = array ();
$term_data [ 'name' ] = trim ( $content_struct [ 'name' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $term_data [ '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
return new IXR_Error ( 403 , __ ( 'The term name cannot be empty.' ) );
2017-11-30 18:11:00 -05: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 ( isset ( $content_struct [ 'parent' ] ) ) {
2017-11-30 18:11:00 -05:00
if ( ! $taxonomy [ 'hierarchical' ] ) {
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 , __ ( 'This taxonomy is not hierarchical.' ) );
2017-11-30 18:11:00 -05: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
$parent_term_id = ( int ) $content_struct [ 'parent' ];
2017-11-30 18:11:00 -05:00
$parent_term = get_term ( $parent_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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $parent_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
return new IXR_Error ( 500 , $parent_term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $parent_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
return new IXR_Error ( 403 , __ ( 'Parent term does not exist.' ) );
2017-11-30 18:11:00 -05: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
$term_data [ 'parent' ] = $content_struct [ 'parent' ];
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'description' ] ) ) {
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_data [ 'description' ] = $content_struct [ 'description' ];
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'slug' ] ) ) {
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_data [ 'slug' ] = $content_struct [ 'slug' ];
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
$term = wp_insert_term ( $term_data [ 'name' ], $taxonomy [ 'name' ], $term_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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $term ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the term could not be created.' ) );
2017-11-30 18:11:00 -05: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
2017-06-18 06:40:46 -04:00
// Add term meta.
if ( isset ( $content_struct [ 'custom_fields' ] ) ) {
$this -> set_term_custom_fields ( $term [ 'term_id' ], $content_struct [ 'custom_fields' ] );
}
2020-10-08 17:15:13 -04:00
return ( string ) $term [ 'term_id' ];
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
}
/**
* Edit a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ see wp_update_term ()
*
* @ param array $args {
* Method arguments . Note : arguments must be ordered as documented .
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Term ID .
* @ type array $ 4 Content struct for editing a term . The struct must contain the
* term 'taxonomy' . Optional accepted values include 'name' , 'parent' ,
* 'description' , and 'slug' .
2015-05-25 02:25:25 -04:00
* }
* @ return true | IXR_Error True on success , IXR_Error instance on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_editTerm ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 5 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$term_id = ( int ) $args [ 3 ];
$content_struct = $args [ 4 ];
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.editTerm' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $content_struct [ 'taxonomy' ] ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
$taxonomy = get_taxonomy ( $content_struct [ 'taxonomy' ] );
$taxonomy = ( array ) $taxonomy ;
2020-01-28 19:45:18 -05:00
// Hold the data of the 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
$term_data = array ();
2017-11-30 18:11:00 -05:00
$term = get_term ( $term_id , $content_struct [ '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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $term ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
2017-11-30 18:11:00 -05: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
Taxonomy: Introduce more fine grained capabilities for managing taxonomy terms.
This introduces the singular `edit_term`, `delete_term`, and `assign_term` meta capabilities for terms, and switches the base capability name for tags from `manage_categories` to `manage_post_tags` and the corresponding `edit_post_tags`, `delete_post_tags`, and `assign_post_tags`.
All of these capabilities ultimately map to `manage_categories` so by default there is no change in the behaviour of the capabilities for categories, tags, or custom taxonomies. The `map_meta_cap` filter and the `capabilities` argument when registering a taxonomy now allow for control over editing, deleting, and assigning individual terms, as well as a separation of capabilities for tags from those of categories.
Fixes #35614
Props johnjamesjacoby for feedback
Built from https://develop.svn.wordpress.org/trunk@38698
git-svn-id: http://core.svn.wordpress.org/trunk@38641 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 18:40:28 -04:00
if ( ! current_user_can ( 'edit_term' , $term_id ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this 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
if ( isset ( $content_struct [ 'name' ] ) ) {
$term_data [ 'name' ] = trim ( $content_struct [ 'name' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $term_data [ '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
return new IXR_Error ( 403 , __ ( 'The term name cannot be empty.' ) );
2017-11-30 18:11:00 -05: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
}
2015-09-26 01:31:25 -04:00
if ( ! empty ( $content_struct [ 'parent' ] ) ) {
2017-11-30 18:11:00 -05:00
if ( ! $taxonomy [ 'hierarchical' ] ) {
2017-09-22 18:08:46 -04:00
return new IXR_Error ( 403 , __ ( 'Cannot set parent term, taxonomy is not hierarchical.' ) );
2017-11-30 18:11:00 -05: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
$parent_term_id = ( int ) $content_struct [ 'parent' ];
2017-11-30 18:11:00 -05:00
$parent_term = get_term ( $parent_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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $parent_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
return new IXR_Error ( 500 , $parent_term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $parent_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
return new IXR_Error ( 403 , __ ( 'Parent term does not exist.' ) );
2017-11-30 18:11:00 -05: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
$term_data [ 'parent' ] = $content_struct [ 'parent' ];
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'description' ] ) ) {
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_data [ 'description' ] = $content_struct [ 'description' ];
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'slug' ] ) ) {
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_data [ 'slug' ] = $content_struct [ 'slug' ];
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
$term = wp_update_term ( $term_id , $taxonomy [ 'name' ], $term_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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $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
return new IXR_Error ( 500 , __ ( 'Sorry, editing the term failed.' ) );
2017-11-30 18:11:00 -05: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
2017-06-18 06:40:46 -04:00
// Update term meta.
if ( isset ( $content_struct [ 'custom_fields' ] ) ) {
$this -> set_term_custom_fields ( $term_id , $content_struct [ 'custom_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 true ;
}
/**
* Delete a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ see wp_delete_term ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string $ 3 Taxonomy name .
* @ type int $ 4 Term ID .
2015-05-22 15:37:24 -04:00
* }
2021-01-03 17:04:04 -05:00
* @ return true | IXR_Error True on success , IXR_Error instance on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_deleteTerm ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 5 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$taxonomy = $args [ 3 ];
$term_id = ( int ) $args [ 4 ];
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.deleteTerm' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $taxonomy ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
2012-04-15 12:47:31 -04:00
$taxonomy = get_taxonomy ( $taxonomy );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $term ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
2017-11-30 18:11:00 -05: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
Taxonomy: Introduce more fine grained capabilities for managing taxonomy terms.
This introduces the singular `edit_term`, `delete_term`, and `assign_term` meta capabilities for terms, and switches the base capability name for tags from `manage_categories` to `manage_post_tags` and the corresponding `edit_post_tags`, `delete_post_tags`, and `assign_post_tags`.
All of these capabilities ultimately map to `manage_categories` so by default there is no change in the behaviour of the capabilities for categories, tags, or custom taxonomies. The `map_meta_cap` filter and the `capabilities` argument when registering a taxonomy now allow for control over editing, deleting, and assigning individual terms, as well as a separation of capabilities for tags from those of categories.
Fixes #35614
Props johnjamesjacoby for feedback
Built from https://develop.svn.wordpress.org/trunk@38698
git-svn-id: http://core.svn.wordpress.org/trunk@38641 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 18:40:28 -04:00
if ( ! current_user_can ( 'delete_term' , $term_id ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this term.' ) );
}
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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $result ) ) {
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 ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $result ) {
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 ( 500 , __ ( 'Sorry, deleting the term failed.' ) );
2017-11-30 18:11:00 -05: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
return $result ;
}
/**
* Retrieve a term .
*
2012-04-28 14:48:10 -04:00
* @ since 3.4 . 0
*
2015-05-25 02:25:25 -04:00
* @ see get_term ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string $ 3 Taxonomy name .
* @ type int $ 4 Term ID .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return array | IXR_Error IXR_Error on failure , array on success , containing :
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'
* - 'name'
* - 'slug'
* - 'term_group'
* - 'term_taxonomy_id'
* - 'taxonomy'
* - 'description'
* - 'parent'
* - 'count'
*/
2014-05-19 02:09:13 -04:00
public function wp_getTerm ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 5 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$taxonomy = $args [ 3 ];
$term_id = ( int ) $args [ 4 ];
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getTerm' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $taxonomy ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
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
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $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
return new IXR_Error ( 500 , $term -> get_error_message () );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( ! $term ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid term ID.' ) );
2017-11-30 18:11:00 -05: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
Taxonomy: Introduce more fine grained capabilities for managing taxonomy terms.
This introduces the singular `edit_term`, `delete_term`, and `assign_term` meta capabilities for terms, and switches the base capability name for tags from `manage_categories` to `manage_post_tags` and the corresponding `edit_post_tags`, `delete_post_tags`, and `assign_post_tags`.
All of these capabilities ultimately map to `manage_categories` so by default there is no change in the behaviour of the capabilities for categories, tags, or custom taxonomies. The `map_meta_cap` filter and the `capabilities` argument when registering a taxonomy now allow for control over editing, deleting, and assigning individual terms, as well as a separation of capabilities for tags from those of categories.
Fixes #35614
Props johnjamesjacoby for feedback
Built from https://develop.svn.wordpress.org/trunk@38698
git-svn-id: http://core.svn.wordpress.org/trunk@38641 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-09-30 18:40:28 -04:00
if ( ! current_user_can ( 'assign_term' , $term_id ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to assign this 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
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' .
*
2015-05-25 02:25:25 -04:00
* @ see get_terms ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string $ 3 Taxonomy name .
* @ type array $ 4 Optional . Modifies the query used to retrieve posts . Accepts 'number' ,
* 'offset' , 'orderby' , 'order' , 'hide_empty' , and 'search' . Default empty array .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return array | IXR_Error An associative array of terms data on success , IXR_Error instance otherwise .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_getTerms ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$taxonomy = $args [ 3 ];
$filter = isset ( $args [ 4 ] ) ? $args [ 4 ] : array ();
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getTerms' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $taxonomy ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
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
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to assign terms in this taxonomy.' ) );
2017-11-30 18:11:00 -05: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
2019-08-02 23:35:56 -04:00
$query = array ( 'taxonomy' => $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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'number' ] ) ) {
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
$query [ 'number' ] = absint ( $filter [ 'number' ] );
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'offset' ] ) ) {
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
$query [ 'offset' ] = absint ( $filter [ 'offset' ] );
2017-11-30 18:11:00 -05: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 ( isset ( $filter [ 'orderby' ] ) ) {
$query [ 'orderby' ] = $filter [ 'orderby' ];
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'order' ] ) ) {
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
$query [ 'order' ] = $filter [ 'order' ];
2017-11-30 18:11:00 -05: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
}
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'hide_empty' ] ) ) {
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
$query [ 'hide_empty' ] = $filter [ 'hide_empty' ];
2017-11-30 18:11:00 -05:00
} else {
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
$query [ 'get' ] = 'all' ;
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'search' ] ) ) {
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
$query [ 'search' ] = $filter [ 'search' ];
2017-11-30 18:11:00 -05: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
2019-08-02 23:35:56 -04:00
$terms = get_terms ( $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
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $terms ) ) {
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 ( 500 , $terms -> get_error_message () );
2017-11-30 18:11:00 -05: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
$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
*
2015-05-25 02:25:25 -04:00
* @ see get_taxonomy ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string $ 3 Taxonomy name .
* @ type array $ 4 Optional . Array of taxonomy fields to limit to in the return .
* Accepts 'labels' , 'cap' , 'menu' , and 'object_type' .
* Default empty array .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return array | IXR_Error An array of taxonomy data on success , IXR_Error instance otherwise .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_getTaxonomy ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$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
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-04-28 14:48:10 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/**
2016-05-22 14:15:28 -04:00
* Filters the taxonomy query fields used by the given XML - RPC method .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $fields An array of taxonomy fields to retrieve .
* @ param string $method The method name .
*/
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_taxonomy_fields' , array ( 'labels' , 'cap' , 'object_type' ), 'wp.getTaxonomy' );
2014-03-26 01:44:16 -04:00
}
2012-04-28 14:48:10 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getTaxonomy' , $args , $this );
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
2017-11-30 18:11:00 -05:00
if ( ! taxonomy_exists ( $taxonomy ) ) {
2016-07-17 12:15:34 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid taxonomy.' ) );
2017-11-30 18:11:00 -05: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
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
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to assign terms in this taxonomy.' ) );
2017-11-30 18:11:00 -05: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
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
*
2015-05-25 02:25:25 -04:00
* @ see get_taxonomies ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . An array of arguments for retrieving taxonomies .
* @ type array $ 4 Optional . The subset of taxonomy fields to return .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return array | IXR_Error An associative array of taxonomy data with returned fields determined
* by `$fields` , or an IXR_Error instance on failure .
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
*/
2014-05-19 02:09:13 -04:00
public function wp_getTaxonomies ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ( 'public' => true );
2012-04-28 14:48:10 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-04-28 14:48:10 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_taxonomy_fields' , array ( 'labels' , 'cap' , 'object_type' ), 'wp.getTaxonomies' );
2014-03-26 01:44:16 -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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
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 $this -> error ;
2017-11-30 18:11:00 -05: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
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getTaxonomies' , $args , $this );
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
$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
2020-01-28 19:45:18 -05:00
// Holds all the taxonomy 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
$struct = array ();
foreach ( $taxonomies as $taxonomy ) {
2020-01-28 19:45:18 -05:00
// Capability check for post types.
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $taxonomy -> cap -> assign_terms ) ) {
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
continue ;
2017-11-30 18:11:00 -05: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
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 ;
}
2012-09-11 20:04:21 -04:00
/**
* Retrieve a user .
*
* The optional $fields parameter specifies what fields will be included
* in the response array . This should be a list of field names . 'user_id' will
* always be included in the response regardless of the value of $fields .
*
* Instead of , or in addition to , individual field names , conceptual group
* names can be used to specify multiple fields . The available conceptual
* groups are 'basic' and 'all' .
*
* @ uses get_userdata ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 User ID .
* @ type array $ 4 Optional . Array of fields to return .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error Array contains ( based on $fields parameter ) :
2012-09-11 20:04:21 -04:00
* - 'user_id'
* - 'username'
* - 'first_name'
* - 'last_name'
* - 'registered'
* - 'bio'
* - 'email'
* - 'nickname'
* - 'nicename'
* - 'url'
* - 'display_name'
* - 'roles'
*/
2014-05-19 02:09:13 -04:00
public function wp_getUser ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$user_id = ( int ) $args [ 3 ];
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-09-11 20:04:21 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/**
2016-05-22 14:15:28 -04:00
* Filters the default user query fields used by the given XML - RPC method .
2014-03-26 01:44:16 -04:00
*
* @ since 3.5 . 0
*
* @ param array $fields User query fields for given method . Default 'all' .
* @ param string $method The method name .
*/
2012-09-11 20:04:21 -04:00
$fields = apply_filters ( 'xmlrpc_default_user_fields' , array ( 'all' ), 'wp.getUser' );
2014-03-26 01:44:16 -04:00
}
2012-09-11 20:04:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getUser' , $args , $this );
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_user' , $user_id ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this user.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
$user_data = get_userdata ( $user_id );
2017-11-30 18:11:00 -05:00
if ( ! $user_data ) {
2015-05-09 17:09:25 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid user ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
return $this -> _prepare_user ( $user_data , $fields );
}
/**
* Retrieve users .
*
* The optional $filter parameter modifies the query used to retrieve users .
* Accepted keys are 'number' ( default : 50 ), 'offset' ( default : 0 ), 'role' ,
* 'who' , 'orderby' , and 'order' .
*
* The optional $fields parameter specifies what fields will be included
* in the response array .
*
* @ uses get_users ()
* @ see wp_getUser () for more on $fields and return values
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . Arguments for the user query .
* @ type array $ 4 Optional . Fields to return .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error users data
2012-09-11 20:04:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getUsers ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ();
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-09-11 20:04:21 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2012-09-11 20:04:21 -04:00
$fields = apply_filters ( 'xmlrpc_default_user_fields' , array ( 'all' ), 'wp.getUsers' );
2014-03-26 01:44:16 -04:00
}
2012-09-11 20:04:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getUsers' , $args , $this );
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'list_users' ) ) {
2016-11-18 21:16:30 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to list users.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2012-10-07 19:33:35 -04:00
$query = array ( 'fields' => 'all_with_meta' );
2012-09-11 20:04:21 -04:00
$query [ 'number' ] = ( isset ( $filter [ 'number' ] ) ) ? absint ( $filter [ 'number' ] ) : 50 ;
$query [ 'offset' ] = ( isset ( $filter [ 'offset' ] ) ) ? absint ( $filter [ 'offset' ] ) : 0 ;
if ( isset ( $filter [ 'orderby' ] ) ) {
$query [ 'orderby' ] = $filter [ 'orderby' ];
2017-11-30 18:11:00 -05:00
if ( isset ( $filter [ 'order' ] ) ) {
2012-09-11 20:04:21 -04:00
$query [ 'order' ] = $filter [ 'order' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
}
if ( isset ( $filter [ 'role' ] ) ) {
2017-11-30 18:11:00 -05:00
if ( get_role ( $filter [ 'role' ] ) === null ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid role.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
$query [ 'role' ] = $filter [ 'role' ];
}
if ( isset ( $filter [ 'who' ] ) ) {
$query [ 'who' ] = $filter [ 'who' ];
}
$users = get_users ( $query );
$_users = array ();
foreach ( $users as $user_data ) {
2017-11-30 18:11:00 -05:00
if ( current_user_can ( 'edit_user' , $user_data -> ID ) ) {
2012-09-11 20:04:21 -04:00
$_users [] = $this -> _prepare_user ( $user_data , $fields );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
}
return $_users ;
}
/**
* Retrieve information about the requesting user .
*
* @ uses get_userdata ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username
* @ type string $ 2 Password
* @ type array $ 3 Optional . Fields to return .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error ( @ see wp_getUser )
2012-09-11 20:04:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getProfile ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 3 ] ) ) {
2012-09-11 20:04:21 -04:00
$fields = $args [ 3 ];
2014-03-26 01:44:16 -04:00
} else {
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2012-09-11 20:04:21 -04:00
$fields = apply_filters ( 'xmlrpc_default_user_fields' , array ( 'all' ), 'wp.getProfile' );
2014-03-26 01:44:16 -04:00
}
2012-09-11 20:04:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getProfile' , $args , $this );
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_user' , $user -> ID ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit your profile.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
$user_data = get_userdata ( $user -> ID );
return $this -> _prepare_user ( $user_data , $fields );
}
/**
* Edit user ' s profile .
*
* @ uses wp_update_user ()
2015-05-22 15:37:24 -04:00
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Content struct . It can optionally contain :
2012-09-11 20:04:21 -04:00
* - 'first_name'
* - 'last_name'
* - 'website'
* - 'display_name'
* - 'nickname'
* - 'nicename'
* - 'bio'
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error True , on success .
2012-09-11 20:04:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_editProfile ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2012-09-11 20:04:21 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$content_struct = $args [ 3 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-11 20:04:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.editProfile' , $args , $this );
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_user' , $user -> ID ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit your profile.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2020-01-28 19:45:18 -05:00
// Holds data of the user.
2017-11-30 18:11:00 -05:00
$user_data = array ();
2012-09-11 20:04:21 -04:00
$user_data [ 'ID' ] = $user -> ID ;
2020-01-28 19:45:18 -05:00
// Only set the user details if they were given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'first_name' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'first_name' ] = $content_struct [ 'first_name' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'last_name' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'last_name' ] = $content_struct [ 'last_name' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'url' ] ) ) {
2012-09-23 15:36:17 -04:00
$user_data [ 'user_url' ] = $content_struct [ 'url' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'display_name' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'display_name' ] = $content_struct [ 'display_name' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'nickname' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'nickname' ] = $content_struct [ 'nickname' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'nicename' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'user_nicename' ] = $content_struct [ 'nicename' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'bio' ] ) ) {
2012-09-11 20:04:21 -04:00
$user_data [ 'description' ] = $content_struct [ 'bio' ];
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
$result = wp_update_user ( $user_data );
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $result ) ) {
2012-09-11 20:04:21 -04:00
return new IXR_Error ( 500 , $result -> get_error_message () );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the user could not be updated.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-11 20:04:21 -04:00
return true ;
}
2010-09-23 17:22:21 -04:00
/**
* Retrieve page .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type int $ 1 Page ID .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_getPage ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$page_id = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
}
2017-11-30 18:11:00 -05:00
$page = get_post ( $page_id );
if ( ! $page ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-29 20:19:32 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_page' , $page_id ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this page.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPage' , $args , $this );
2010-09-23 17:22:21 -04:00
// If we found the page then format the data.
2020-02-09 11:55:09 -05:00
if ( $page -> ID && ( 'page' === $page -> post_type ) ) {
2012-05-16 14:06:34 -04:00
return $this -> _prepare_page ( $page );
2019-01-11 01:40:50 -05:00
} else {
2020-01-28 19:45:18 -05:00
// If the page doesn't exist, indicate that.
2014-05-30 15:22:13 -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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Optional . Number of pages . Default 10.
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_getPages ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2017-11-30 18:11:00 -05:00
$num_pages = isset ( $args [ 3 ] ) ? ( int ) $args [ 3 ] : 10 ;
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_pages' ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit pages.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPages' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$pages = get_posts (
array (
'post_type' => 'page' ,
'post_status' => 'any' ,
'numberposts' => $num_pages ,
)
);
$num_pages = count ( $pages );
2010-09-23 17:22:21 -04:00
// If we have pages, put together their info.
if ( $num_pages >= 1 ) {
$pages_struct = array ();
2017-11-30 18:11:00 -05:00
foreach ( $pages as $page ) {
if ( current_user_can ( 'edit_page' , $page -> ID ) ) {
2012-05-16 14:06:34 -04:00
$pages_struct [] = $this -> _prepare_page ( $page );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
}
2014-11-02 22:04:22 -05:00
return $pages_struct ;
2010-09-23 17:22:21 -04:00
}
2014-11-02 22:04:22 -05:00
return array ();
2010-09-23 17:22:21 -04:00
}
/**
* Create new page .
*
* @ since 2.2 . 0
*
2015-05-25 02:25:25 -04:00
* @ see wp_xmlrpc_server :: mw_newPost ()
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Content struct .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return int | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_newPage ( $args ) {
2020-01-28 19:45:18 -05:00
// Items not escaped here will be escaped in wp_newPost().
2015-05-22 15:37:24 -04:00
$username = $this -> escape ( $args [ 1 ] );
$password = $this -> escape ( $args [ 2 ] );
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.newPage' , $args , $this );
2010-09-23 17:22:21 -04:00
// Mark this as content for a page.
2017-11-30 18:11:00 -05:00
$args [ 3 ][ 'post_type' ] = 'page' ;
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Let mw_newPost() do all of the heavy lifting.
2014-11-02 22:04:22 -05:00
return $this -> mw_newPost ( $args );
2010-09-23 17:22:21 -04:00
}
/**
* Delete page .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Page ID .
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error True , if success .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_deletePage ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$page_id = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.deletePage' , $args , $this );
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Get the current page based on the 'page_id' and
2010-09-23 17:22:21 -04:00
// make sure it is a page and not a post.
2017-11-30 18:11:00 -05:00
$actual_page = get_post ( $page_id , ARRAY_A );
2020-02-09 11:55:09 -05:00
if ( ! $actual_page || ( 'page' !== $actual_page [ 'post_type' ] ) ) {
2014-11-02 22:04:22 -05:00
return new IXR_Error ( 404 , __ ( 'Sorry, no such page.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Make sure the user can delete pages.
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'delete_page' , $page_id ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this page.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Attempt to delete the page.
2017-11-30 18:11:00 -05:00
$result = wp_delete_post ( $page_id );
if ( ! $result ) {
2014-11-02 22:04:22 -05:00
return new IXR_Error ( 500 , __ ( 'Failed to delete the page.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a page has been successfully deleted via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $page_id ID of the deleted page .
* @ param array $args An array of arguments to delete the page .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_deletePage' , $page_id , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2014-11-02 22:04:22 -05:00
return true ;
2010-09-23 17:22:21 -04:00
}
/**
* Edit page .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type int $ 1 Page ID .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
* @ type string $ 4 Content .
* @ type int $ 5 Publish flag . 0 for draft , 1 for publish .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_editPage ( $args ) {
2020-01-28 19:45:18 -05:00
// Items will be escaped in mw_editPost().
2015-06-28 22:07:23 -04:00
$page_id = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
2015-05-22 15:37:24 -04:00
$content = $args [ 4 ];
$publish = $args [ 5 ];
2010-09-23 17:22:21 -04:00
2015-06-28 22:07:23 -04:00
$escaped_username = $this -> escape ( $username );
$escaped_password = $this -> escape ( $password );
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $escaped_username , $escaped_password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-06-28 22:07:23 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.editPage' , $args , $this );
2010-09-23 17:22:21 -04:00
// Get the page data and make sure it is a page.
2017-11-30 18:11:00 -05:00
$actual_page = get_post ( $page_id , ARRAY_A );
2020-02-09 11:55:09 -05:00
if ( ! $actual_page || ( 'page' !== $actual_page [ 'post_type' ] ) ) {
2014-11-02 22:04:22 -05:00
return new IXR_Error ( 404 , __ ( 'Sorry, no such page.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Make sure the user is allowed to edit pages.
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_page' , $page_id ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this page.' ) );
2017-11-30 18:11:00 -05:00
}
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
2020-01-28 19:45:18 -05:00
// Arrange args in the way mw_editPost() understands.
2010-09-23 17:22:21 -04:00
$args = array (
$page_id ,
$username ,
$password ,
$content ,
2017-11-30 18:11:00 -05:00
$publish ,
2010-09-23 17:22:21 -04:00
);
2020-01-28 19:45:18 -05:00
// Let mw_editPost() do all of the heavy lifting.
2014-11-02 22:04:22 -05:00
return $this -> mw_editPost ( $args );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve page list .
*
* @ since 2.2 . 0
*
2016-10-10 02:38:31 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_getPageList ( $args ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2015-05-22 15:37:24 -04:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_pages' ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit pages.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPageList' , $args , $this );
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Get list of page IDs and titles.
2017-11-30 18:11:00 -05:00
$page_list = $wpdb -> get_results (
"
2010-09-23 17:22:21 -04:00
SELECT ID page_id ,
post_title page_title ,
post_parent page_parent_id ,
post_date_gmt ,
post_date ,
post_status
2016-10-10 02:38:31 -04:00
FROM { $wpdb -> posts }
2010-09-23 17:22:21 -04:00
WHERE post_type = 'page'
ORDER BY ID
2017-11-30 18:11:00 -05:00
"
);
2010-09-23 17:22:21 -04:00
2011-09-03 12:02:41 -04:00
// The date needs to be formatted properly.
2017-11-30 18:11:00 -05:00
$num_pages = count ( $page_list );
2010-09-23 17:22:21 -04:00
for ( $i = 0 ; $i < $num_pages ; $i ++ ) {
2017-11-30 18:11:00 -05: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
2017-11-30 18:11:00 -05:00
unset ( $page_list [ $i ] -> post_date_gmt );
unset ( $page_list [ $i ] -> post_date );
unset ( $page_list [ $i ] -> post_status );
2010-09-23 17:22:21 -04:00
}
2014-11-02 22:04:22 -05:00
return $page_list ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve authors list .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_getAuthors ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getAuthors' , $args , $this );
2010-09-23 17:22:21 -04:00
$authors = array ();
2017-11-30 18:11:00 -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 (
2017-11-30 18:11:00 -05: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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getTags ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view tags.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getKeywords' , $args , $this );
2010-09-23 17:22:21 -04:00
2012-03-02 13:06:30 -05:00
$tags = array ();
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$all_tags = get_tags ();
if ( $all_tags ) {
2015-08-25 16:28:22 -04:00
foreach ( ( array ) $all_tags as $tag ) {
2017-11-30 18:11:00 -05:00
$struct = array ();
$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 ) );
2010-09-23 17:22:21 -04:00
$tags [] = $struct ;
}
}
return $tags ;
}
/**
* Create new category .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Category .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return int | IXR_Error Category ID .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_newCategory ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$category = $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.newCategory' , $args , $this );
2010-09-23 17:22:21 -04:00
// Make sure the user is allowed to add a category.
2017-10-18 17:12:51 -04:00
if ( ! current_user_can ( 'manage_categories' ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to add a category.' ) );
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// If no slug was provided, make it empty
// so that WordPress will generate one.
2017-11-30 18:11:00 -05:00
if ( empty ( $category [ 'slug' ] ) ) {
2011-05-06 15:51:47 -04:00
$category [ 'slug' ] = '' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// If no parent_id was provided, make it empty
// so that it will be a top-level page (no parent).
2017-11-30 18:11:00 -05:00
if ( ! isset ( $category [ 'parent_id' ] ) ) {
2011-05-06 15:51:47 -04:00
$category [ 'parent_id' ] = '' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// If no description was provided, make it empty.
2017-11-30 18:11:00 -05:00
if ( empty ( $category [ 'description' ] ) ) {
$category [ 'description' ] = '' ;
}
2010-09-23 17:22:21 -04:00
$new_category = array (
2017-11-30 18:11:00 -05: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
);
2017-11-30 18:11:00 -05:00
$cat_id = wp_insert_category ( $new_category , true );
2010-09-23 17:22:21 -04:00
if ( is_wp_error ( $cat_id ) ) {
2020-05-16 14:42:12 -04:00
if ( 'term_exists' === $cat_id -> get_error_code () ) {
2010-09-23 17:22:21 -04:00
return ( int ) $cat_id -> get_error_data ();
2017-11-30 18:11:00 -05:00
} else {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the category could not be created.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
} elseif ( ! $cat_id ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the category could not be created.' ) );
2010-09-23 17:22:21 -04:00
}
2014-03-26 01:44:16 -04:00
/**
* Fires after a new category has been successfully created via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $cat_id ID of the new category .
* @ param array $args An array of new category arguments .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_newCategory' , $cat_id , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:12:06 -05:00
return $cat_id ;
2010-09-23 17:22:21 -04:00
}
/**
* Remove category .
*
* @ since 2.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Category ID .
2015-05-22 15:37:24 -04:00
* }
2016-05-22 13:39:28 -04:00
* @ return bool | IXR_Error See wp_delete_term () for return info .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_deleteCategory ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$category_id = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.deleteCategory' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-10-18 17:12:51 -04:00
if ( ! current_user_can ( 'delete_term' , $category_id ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this category.' ) );
}
2010-09-23 17:22:21 -04:00
2012-03-08 08:12:06 -05:00
$status = wp_delete_term ( $category_id , 'category' );
2014-03-26 01:44:16 -04:00
if ( true == $status ) {
/**
* Fires after a category has been successfully deleted via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $category_id ID of the deleted category .
* @ param array $args An array of arguments to delete the category .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_deleteCategory' , $category_id , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2014-03-26 01:44:16 -04:00
}
2012-03-08 08:12:06 -05:00
return $status ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve category list .
*
* @ since 2.2 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Category
* @ type int $ 4 Max number of results .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_suggestCategories ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$category = $args [ 3 ];
$max_results = ( int ) $args [ 4 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2015-04-20 11:27:25 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view categories.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.suggestCategories' , $args , $this );
2010-09-23 17:22:21 -04:00
$category_suggestions = array ();
2017-11-30 18:11:00 -05:00
$args = array (
'get' => 'all' ,
'number' => $max_results ,
'name__like' => $category ,
);
foreach ( ( array ) get_categories ( $args ) as $cat ) {
2010-09-23 17:22:21 -04:00
$category_suggestions [] = array (
2017-11-30 18:11:00 -05:00
'category_id' => $cat -> term_id ,
'category_name' => $cat -> name ,
2010-09-23 17:22:21 -04:00
);
}
2014-11-02 22:04:22 -05:00
return $category_suggestions ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve comment .
*
* @ since 2.7 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Comment ID .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function wp_getComment ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_id = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getComment' , $args , $this );
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$comment = get_comment ( $comment_id );
if ( ! $comment ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
2015-09-25 22:49:27 -04:00
}
if ( ! current_user_can ( 'edit_comment' , $comment_id ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to moderate or edit this comment.' ) );
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2012-05-23 16:40:40 -04:00
return $this -> _prepare_comment ( $comment );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve comments .
*
2014-10-31 21:44:23 -04:00
* Besides the common blog_id ( unused ), username , and password arguments , it takes a filter
2011-04-18 03:26:42 -04:00
* 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 .
2016-05-22 13:39:28 -04:00
* - 'offset' - Default is 0. See 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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . Query arguments .
2015-05-22 15:37:24 -04:00
* }
2016-05-22 13:39:28 -04:00
* @ return array | IXR_Error Contains a collection of comments . See wp_xmlrpc_server :: wp_getComment () for a description of each item contents
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_getComments ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2017-11-30 18:11:00 -05:00
$struct = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ();
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-26 00:45:25 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getComments' , $args , $this );
2010-09-23 17:22:21 -04:00
2015-09-26 00:45:25 -04:00
if ( isset ( $struct [ 'status' ] ) ) {
2010-09-23 17:22:21 -04:00
$status = $struct [ 'status' ];
2015-09-26 00:45:25 -04:00
} else {
2010-09-23 17:22:21 -04:00
$status = '' ;
2015-09-26 00:45:25 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 22:49:27 -04:00
if ( ! current_user_can ( 'moderate_comments' ) && 'approve' !== $status ) {
return new IXR_Error ( 401 , __ ( 'Invalid comment status.' ) );
}
2010-09-23 17:22:21 -04:00
$post_id = '' ;
2015-09-26 00:45:25 -04:00
if ( isset ( $struct [ 'post_id' ] ) ) {
$post_id = absint ( $struct [ 'post_id' ] );
}
$post_type = '' ;
if ( isset ( $struct [ 'post_type' ] ) ) {
$post_type_object = get_post_type_object ( $struct [ 'post_type' ] );
if ( ! $post_type_object || ! post_type_supports ( $post_type_object -> name , 'comments' ) ) {
return new IXR_Error ( 404 , __ ( 'Invalid post type.' ) );
}
$post_type = $struct [ 'post_type' ];
}
2010-09-23 17:22:21 -04:00
$offset = 0 ;
2015-09-26 00:45:25 -04:00
if ( isset ( $struct [ 'offset' ] ) ) {
$offset = absint ( $struct [ 'offset' ] );
}
2010-09-23 17:22:21 -04:00
$number = 10 ;
2015-09-26 00:45:25 -04:00
if ( isset ( $struct [ 'number' ] ) ) {
$number = absint ( $struct [ 'number' ] );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$comments = get_comments (
array (
'status' => $status ,
'post_id' => $post_id ,
'offset' => $offset ,
'number' => $number ,
'post_type' => $post_type ,
)
);
2010-09-23 17:22:21 -04:00
$comments_struct = array ();
2015-05-25 13:59:25 -04:00
if ( is_array ( $comments ) ) {
foreach ( $comments as $comment ) {
$comments_struct [] = $this -> _prepare_comment ( $comment );
}
2010-09-23 17:22:21 -04:00
}
return $comments_struct ;
}
/**
2011-04-18 03:26:42 -04:00
* Delete a comment .
*
2020-02-09 23:12:07 -05:00
* By default , the comment will be moved to the Trash instead of deleted .
2016-05-22 13:39:28 -04:00
* See wp_delete_comment () for more information on this behavior .
2010-09-23 17:22:21 -04:00
*
* @ since 2.7 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Comment ID .
2015-05-22 15:37:24 -04:00
* }
2016-05-22 13:39:28 -04:00
* @ return bool | IXR_Error See wp_delete_comment () .
2010-09-23 17:22:21 -04:00
*/
2015-09-25 22:49:27 -04:00
public function wp_deleteComment ( $args ) {
2017-11-30 18:11:00 -05:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_ID = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 22:49:27 -04:00
if ( ! get_comment ( $comment_ID ) ) {
2011-08-23 06:22:34 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
2015-09-25 22:49:27 -04:00
}
2011-08-23 06:22:34 -04:00
2017-10-18 17:12:51 -04:00
if ( ! current_user_can ( 'edit_comment' , $comment_ID ) ) {
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to delete this comment.' ) );
2015-09-25 22:49:27 -04:00
}
2010-12-13 16:21:50 -05:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.deleteComment' , $args , $this );
2010-09-23 17:22:21 -04:00
2012-03-08 08:12:06 -05:00
$status = wp_delete_comment ( $comment_ID );
2015-06-12 13:48:26 -04:00
if ( $status ) {
2014-03-26 01:44:16 -04:00
/**
* Fires after a comment has been successfully deleted via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $comment_ID ID of the deleted comment .
* @ param array $args An array of arguments to delete the comment .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_deleteComment' , $comment_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2014-03-26 01:44:16 -04:00
}
2012-03-08 08:12:06 -05:00
return $status ;
2010-09-23 17:22:21 -04:00
}
/**
* Edit comment .
*
2014-10-31 21:44:23 -04:00
* Besides the common blog_id ( unused ), 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'
2015-05-25 02:25:25 -04:00
* - 'status' . Common statuses are 'approve' , 'hold' , 'spam' . See get_comment_statuses () for more details
2011-04-18 03:26:42 -04:00
*
2010-09-23 17:22:21 -04:00
* @ since 2.7 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Comment ID .
* @ type array $ 4 Content structure .
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error True , on success .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function wp_editComment ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$comment_ID = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
$content_struct = $args [ 4 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 22:49:27 -04:00
if ( ! get_comment ( $comment_ID ) ) {
2011-08-23 06:22:34 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid comment ID.' ) );
2015-09-25 22:49:27 -04:00
}
2011-08-23 06:22:34 -04:00
2015-09-25 22:49:27 -04:00
if ( ! current_user_can ( 'edit_comment' , $comment_ID ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to moderate or edit this comment.' ) );
2015-09-25 22:49:27 -04:00
}
2010-12-13 16:21:50 -05:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.editComment' , $args , $this );
2018-12-14 00:13:52 -05:00
$comment = array (
'comment_ID' => $comment_ID ,
);
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'status' ] ) ) {
2010-09-23 17:22:21 -04:00
$statuses = get_comment_statuses ();
2017-11-30 18:11:00 -05:00
$statuses = array_keys ( $statuses );
2010-09-23 17:22:21 -04:00
2020-04-04 23:02:11 -04:00
if ( ! in_array ( $content_struct [ 'status' ], $statuses , true ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid comment status.' ) );
2017-11-30 18:11:00 -05:00
}
2018-12-14 00:13:52 -05:00
$comment [ 'comment_approved' ] = $content_struct [ 'status' ];
2010-09-23 17:22:21 -04:00
}
2020-01-28 19:45:18 -05:00
// Do some timestamp voodoo.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) ) {
2020-01-28 19:45:18 -05:00
// We know this is supposed to be GMT, so we're going to slap that Z on there by force.
2018-12-14 00:13:52 -05:00
$dateCreated = rtrim ( $content_struct [ 'date_created_gmt' ] -> getIso (), 'Z' ) . 'Z' ;
2019-12-09 14:56:05 -05:00
$comment [ 'comment_date' ] = get_date_from_gmt ( $dateCreated );
$comment [ 'comment_date_gmt' ] = iso8601_to_datetime ( $dateCreated , 'gmt' );
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'content' ] ) ) {
2018-12-14 00:13:52 -05:00
$comment [ 'comment_content' ] = $content_struct [ 'content' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author' ] ) ) {
2018-12-14 00:13:52 -05:00
$comment [ 'comment_author' ] = $content_struct [ 'author' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author_url' ] ) ) {
2018-12-14 00:13:52 -05:00
$comment [ 'comment_author_url' ] = $content_struct [ 'author_url' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author_email' ] ) ) {
2018-12-14 00:13:52 -05:00
$comment [ 'comment_author_email' ] = $content_struct [ 'author_email' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-06-23 20:05:12 -04:00
$result = wp_update_comment ( $comment , true );
2020-06-29 19:42:03 -04:00
if ( is_wp_error ( $result ) ) {
2017-11-30 18:11:00 -05:00
return new IXR_Error ( 500 , $result -> get_error_message () );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the comment could not be updated.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a comment has been successfully updated via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $comment_ID ID of the updated comment .
* @ param array $args An array of arguments to update the comment .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_editComment' , $comment_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:12:06 -05:00
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Create new comment .
*
* @ since 2.7 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string | int $ 3 Post ID or URL .
* @ type array $ 4 Content structure .
2015-05-22 15:37:24 -04:00
* }
2016-05-22 13:39:28 -04:00
* @ return int | IXR_Error See wp_new_comment () .
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function wp_newComment ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post = $args [ 3 ];
2010-09-23 17:22:21 -04:00
$content_struct = $args [ 4 ];
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters whether to allow anonymous comments over XML - RPC .
2014-03-26 01:44:16 -04:00
*
* @ since 2.7 . 0
*
* @ param bool $allow Whether to allow anonymous commenting via XML - RPC .
* Default false .
*/
$allow_anon = apply_filters ( 'xmlrpc_allow_anonymous_comments' , false );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$user = $this -> login ( $username , $password );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
$logged_in = false ;
2017-11-30 18:11:00 -05:00
if ( $allow_anon && get_option ( 'comment_registration' ) ) {
2020-01-21 09:52:06 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you must be logged in to comment.' ) );
2015-01-08 02:05:25 -05:00
} elseif ( ! $allow_anon ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-01-08 02:05:25 -05:00
}
2010-09-23 17:22:21 -04:00
} else {
$logged_in = true ;
}
2017-11-30 18:11:00 -05:00
if ( is_numeric ( $post ) ) {
$post_id = absint ( $post );
} else {
$post_id = url_to_postid ( $post );
}
2010-09-23 17:22:21 -04:00
2015-09-25 16:20:23 -04:00
if ( ! $post_id ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2015-09-25 16:20:23 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 16:20:23 -04:00
if ( ! get_post ( $post_id ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2015-09-25 16:20:23 -04:00
}
if ( ! comments_open ( $post_id ) ) {
return new IXR_Error ( 403 , __ ( 'Sorry, comments are closed for this item.' ) );
}
2010-09-23 17:22:21 -04:00
2020-10-29 13:44:07 -04:00
if (
'publish' === get_post_status ( $post_id ) &&
! current_user_can ( 'edit_post' , $post_id ) &&
post_password_required ( $post_id )
) {
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to comment on this post.' ) );
}
if (
'private' === get_post_status ( $post_id ) &&
! current_user_can ( 'read_post' , $post_id )
) {
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to comment on this post.' ) );
}
2016-10-30 21:27:31 -04:00
$comment = array (
'comment_post_ID' => $post_id ,
2020-10-24 18:46:09 -04:00
'comment_content' => trim ( $content_struct [ 'content' ] ),
2016-10-30 21:27:31 -04:00
);
2010-09-23 17:22:21 -04:00
if ( $logged_in ) {
2015-09-25 16:20:23 -04:00
$display_name = $user -> display_name ;
2017-11-30 18:11:00 -05:00
$user_email = $user -> user_email ;
$user_url = $user -> user_url ;
2015-09-25 16:20:23 -04:00
2017-11-30 18:11:00 -05:00
$comment [ 'comment_author' ] = $this -> escape ( $display_name );
2015-09-25 16:20:23 -04:00
$comment [ 'comment_author_email' ] = $this -> escape ( $user_email );
2017-11-30 18:11:00 -05:00
$comment [ 'comment_author_url' ] = $this -> escape ( $user_url );
Coding Standards: Standardize on `user_id` when passing data to comment functions.
The `wp_new_comment()`, `wp_update_comment()`, and `wp_filter_comment()` functions already normalize the `user_ID` parameter internally to `user_id`, which matches the database field name.
This commit aims to bring some consistency when passing the parameter in core.
The corresponding `$user_ID` variable is also renamed to `$user_id` to match the other variables when not referring to the `$user_ID` global, which has an exception in the WordPress coding standards.
Follow-up to [8543], [8720], [12267], [12300], [26491], [28915], [28922], [34799], [49303].
See #55647, #56244.
Built from https://develop.svn.wordpress.org/trunk@53729
git-svn-id: http://core.svn.wordpress.org/trunk@53288 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-07-20 10:14:09 -04:00
$comment [ 'user_id' ] = $user -> ID ;
2010-09-23 17:22:21 -04:00
} else {
$comment [ 'comment_author' ] = '' ;
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author' ] ) ) {
2010-09-23 17:22:21 -04:00
$comment [ 'comment_author' ] = $content_struct [ 'author' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$comment [ 'comment_author_email' ] = '' ;
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author_email' ] ) ) {
2010-09-23 17:22:21 -04:00
$comment [ 'comment_author_email' ] = $content_struct [ 'author_email' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$comment [ 'comment_author_url' ] = '' ;
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'author_url' ] ) ) {
2010-09-23 17:22:21 -04:00
$comment [ 'comment_author_url' ] = $content_struct [ 'author_url' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
Coding Standards: Standardize on `user_id` when passing data to comment functions.
The `wp_new_comment()`, `wp_update_comment()`, and `wp_filter_comment()` functions already normalize the `user_ID` parameter internally to `user_id`, which matches the database field name.
This commit aims to bring some consistency when passing the parameter in core.
The corresponding `$user_ID` variable is also renamed to `$user_id` to match the other variables when not referring to the `$user_ID` global, which has an exception in the WordPress coding standards.
Follow-up to [8543], [8720], [12267], [12300], [26491], [28915], [28922], [34799], [49303].
See #55647, #56244.
Built from https://develop.svn.wordpress.org/trunk@53729
git-svn-id: http://core.svn.wordpress.org/trunk@53288 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-07-20 10:14:09 -04:00
$comment [ 'user_id' ] = 0 ;
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( get_option ( 'require_name_email' ) ) {
2020-10-21 22:42:06 -04:00
if ( strlen ( $comment [ 'comment_author_email' ] ) < 6 || '' === $comment [ 'comment_author' ] ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 403 , __ ( 'Comment author name and email are required.' ) );
2017-11-30 18:11:00 -05:00
} elseif ( ! is_email ( $comment [ 'comment_author_email' ] ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 403 , __ ( 'A valid email address is required.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
}
}
2017-11-30 18:11:00 -05:00
$comment [ 'comment_parent' ] = isset ( $content_struct [ 'comment_parent' ] ) ? absint ( $content_struct [ 'comment_parent' ] ) : 0 ;
2010-09-23 17:22:21 -04:00
2020-10-24 18:46:09 -04:00
/** This filter is documented in wp-includes/comment.php */
$allow_empty = apply_filters ( 'allow_empty_comment' , false , $comment );
if ( ! $allow_empty && '' === $comment [ 'comment_content' ] ) {
return new IXR_Error ( 403 , __ ( 'Comment is required.' ) );
}
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.newComment' , $args , $this );
2010-09-23 17:22:21 -04:00
2016-10-30 21:27:31 -04:00
$comment_ID = wp_new_comment ( $comment , true );
if ( is_wp_error ( $comment_ID ) ) {
return new IXR_Error ( 403 , $comment_ID -> get_error_message () );
}
if ( ! $comment_ID ) {
2018-02-18 21:13:32 -05:00
return new IXR_Error ( 403 , __ ( 'Something went wrong.' ) );
2016-10-30 21:27:31 -04:00
}
2012-03-08 08:12:06 -05:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a new comment has been successfully created via XML - RPC .
*
* @ since 3.4 . 0
*
* @ param int $comment_ID ID of the new comment .
* @ param array $args An array of new comment arguments .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_wp_newComment' , $comment_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:12:06 -05:00
return $comment_ID ;
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve all of the comment status .
*
* @ since 2.7 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-09-25 22:49:27 -04:00
public function wp_getCommentStatusList ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 22:49:27 -04:00
if ( ! current_user_can ( 'publish_posts' ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details about this site.' ) );
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getCommentStatusList' , $args , $this );
2010-09-23 17:22:21 -04:00
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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Post ID .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getCommentCount ( $args ) {
2015-05-22 15:37:24 -04:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2015-09-25 22:49:27 -04:00
$post = get_post ( $post_id , ARRAY_A );
if ( empty ( $post [ 'ID' ] ) ) {
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
}
if ( ! current_user_can ( 'edit_post' , $post_id ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details of this post.' ) );
2015-09-25 22:49:27 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getCommentCount' , $args , $this );
2010-09-23 17:22:21 -04:00
$count = wp_count_comments ( $post_id );
2015-09-25 22:49:27 -04:00
2010-09-23 17:22:21 -04:00
return array (
2017-11-30 18:11:00 -05:00
'approved' => $count -> approved ,
2011-05-06 15:51:47 -04:00
'awaiting_moderation' => $count -> moderated ,
2017-11-30 18:11:00 -05:00
'spam' => $count -> spam ,
'total_comments' => $count -> total_comments ,
2010-09-23 17:22:21 -04:00
);
}
/**
* Retrieve post statuses .
*
* @ since 2.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getPostStatusList ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details about this site.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPostStatusList' , $args , $this );
2010-09-23 17:22:21 -04:00
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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getPageStatusList ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_pages' ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details about this site.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPageStatusList' , $args , $this );
2010-09-23 17:22:21 -04:00
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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getPageTemplates ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_pages' ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details about this site.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . Options .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getOptions ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$options = isset ( $args [ 3 ] ) ? ( array ) $args [ 3 ] : array ();
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// If no specific options where asked for, return all of them.
2017-11-30 18:11:00 -05:00
if ( count ( $options ) == 0 ) {
$options = array_keys ( $this -> blog_options );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
return $this -> _getOptions ( $options );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve blog options value from list .
*
* @ since 2.6 . 0
*
* @ param array $options Options to retrieve .
* @ return array
*/
2017-11-30 18:11:00 -05:00
public function _getOptions ( $options ) {
$data = array ();
2013-07-08 22:22:57 -04:00
$can_manage = current_user_can ( 'manage_options' );
2010-09-23 17:22:21 -04:00
foreach ( $options as $option ) {
if ( array_key_exists ( $option , $this -> blog_options ) ) {
2017-11-30 18:11:00 -05:00
$data [ $option ] = $this -> blog_options [ $option ];
2020-01-28 19:45:18 -05:00
// Is the value static or dynamic?
2017-11-30 18:11:00 -05:00
if ( isset ( $data [ $option ][ 'option' ] ) ) {
$data [ $option ][ 'value' ] = get_option ( $data [ $option ][ 'option' ] );
unset ( $data [ $option ][ 'option' ] );
2010-09-23 17:22:21 -04:00
}
2013-07-08 22:22:57 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $can_manage ) {
$data [ $option ][ 'readonly' ] = true ;
}
2010-09-23 17:22:21 -04:00
}
}
return $data ;
}
/**
* Update blog options .
*
* @ since 2.6 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Options .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_setOptions ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$options = ( array ) $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'manage_options' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to update options.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-11-01 15:45:25 -04:00
$option_names = array ();
2010-09-23 17:22:21 -04:00
foreach ( $options as $o_name => $o_value ) {
$option_names [] = $o_name ;
2017-11-30 18:11:00 -05:00
if ( ! array_key_exists ( $o_name , $this -> blog_options ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-02-09 11:55:09 -05:00
if ( true == $this -> blog_options [ $o_name ][ 'readonly' ] ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
update_option ( $this -> blog_options [ $o_name ][ 'option' ], wp_unslash ( $o_value ) );
2010-09-23 17:22:21 -04:00
}
2020-01-28 19:45:18 -05:00
// Now return the updated values.
2017-11-30 18:11:00 -05:00
return $this -> _getOptions ( $option_names );
2010-09-23 17:22:21 -04:00
}
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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Attachment ID .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error Associative array contains :
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
*/
2015-05-22 15:37:24 -04:00
public function wp_getMediaItem ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$attachment_id = ( int ) $args [ 3 ];
2010-10-27 13:20:46 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-10-27 13:20:46 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'upload_files' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to upload files.' ) );
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getMediaItem' , $args , $this );
2010-10-27 13:20:46 -04:00
2019-07-02 19:42:58 -04:00
$attachment = get_post ( $attachment_id );
2020-10-29 14:05:06 -04:00
if ( ! $attachment || 'attachment' !== $attachment -> post_type ) {
2010-10-27 13:20:46 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid attachment ID.' ) );
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
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
*
2014-10-31 21:44:23 -04:00
* Besides the common blog_id ( unused ), 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 .
2015-05-25 02:25:25 -04:00
* - 'offset' - Default is 0. See WP_Query :: query () for more .
2010-10-28 08:12:59 -04:00
* - '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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Query arguments .
2015-05-22 15:37:24 -04:00
* }
2015-05-25 02:25:25 -04:00
* @ return array | IXR_Error Contains a collection of media items . See wp_xmlrpc_server :: wp_getMediaItem () for a description of each item contents
2010-10-27 13:20:46 -04:00
*/
2017-11-30 18:11:00 -05:00
public function wp_getMediaLibrary ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$struct = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ();
2010-10-27 13:20:46 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-10-27 13:20:46 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'upload_files' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to upload files.' ) );
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getMediaLibrary' , $args , $this );
2010-10-27 13:20:46 -04:00
2017-11-30 18:11:00 -05:00
$parent_id = ( isset ( $struct [ 'parent_id' ] ) ) ? absint ( $struct [ 'parent_id' ] ) : '' ;
$mime_type = ( isset ( $struct [ 'mime_type' ] ) ) ? $struct [ 'mime_type' ] : '' ;
$offset = ( isset ( $struct [ 'offset' ] ) ) ? absint ( $struct [ 'offset' ] ) : 0 ;
$number = ( isset ( $struct [ 'number' ] ) ) ? absint ( $struct [ 'number' ] ) : - 1 ;
$attachments = get_posts (
array (
'post_type' => 'attachment' ,
'post_parent' => $parent_id ,
'offset' => $offset ,
'numberposts' => $number ,
'post_mime_type' => $mime_type ,
)
);
2010-10-27 13:20:46 -04:00
$attachments_struct = array ();
2017-11-30 18:11:00 -05:00
foreach ( $attachments as $attachment ) {
2012-04-26 16:56:52 -04:00
$attachments_struct [] = $this -> _prepare_media_item ( $attachment );
2017-11-30 18:11:00 -05:00
}
2010-10-27 13:20:46 -04:00
return $attachments_struct ;
}
2010-12-13 16:21:50 -05:00
/**
2015-07-23 09:19:27 -04:00
* Retrieves a list of post formats used by the site .
*
* @ since 3.1 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2015-07-23 09:19:27 -04:00
* @ return array | IXR_Error List of post formats , otherwise IXR_Error object .
*/
2014-05-19 02:09:13 -04:00
public function wp_getPostFormats ( $args ) {
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2010-11-19 08:57:05 -05:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-11-19 08:57:05 -05:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-12-13 16:21:50 -05:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2018-02-27 22:19:31 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, you are not allowed to access details about this site.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-23 17:41:50 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPostFormats' , $args , $this );
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
2020-01-28 19:45:18 -05:00
// Find out if they want a list of currently supports formats.
2011-06-10 19:01:45 -04:00
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
2017-11-30 18:11:00 -05:00
$data = array ();
$data [ 'all' ] = $formats ;
2011-06-10 19:01:45 -04:00
$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
*
2015-05-25 02:25:25 -04:00
* @ see get_post_type_object ()
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type string $ 3 Post type name .
* @ type array $ 4 Optional . Fields to fetch .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error Array contains :
2012-03-23 13:53:14 -04:00
* - 'labels'
* - 'description'
* - 'capability_type'
* - 'cap'
* - 'map_meta_cap'
* - 'hierarchical'
* - 'menu_position'
* - 'taxonomies'
* - 'supports'
*/
2014-05-19 02:09:13 -04:00
public function wp_getPostType ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2012-03-23 13:53:14 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_type_name = $args [ 3 ];
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-04-28 14:48:10 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/**
2016-05-22 14:15:28 -04:00
* Filters the default query fields used by the given XML - RPC method .
2014-03-26 01:44:16 -04:00
*
* @ since 3.4 . 0
*
* @ param array $fields An array of post type query fields for the given method .
* @ param string $method The method name .
*/
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_posttype_fields' , array ( 'labels' , 'cap' , 'taxonomies' ), 'wp.getPostType' );
2014-03-26 01:44:16 -04:00
}
2012-03-23 13:53:14 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-03-23 13:53:14 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPostType' , $args , $this );
2012-03-23 13:53:14 -04:00
2017-11-30 18:11:00 -05:00
if ( ! post_type_exists ( $post_type_name ) ) {
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 403 , __ ( 'Invalid post type.' ) );
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
$post_type = get_post_type_object ( $post_type_name );
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) ) {
2016-11-17 10:53:33 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts in this post type.' ) );
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
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
*
2015-05-25 02:25:25 -04:00
* @ see get_post_types ()
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Optional . Query arguments .
* @ type array $ 4 Optional . Fields to fetch .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2012-03-23 13:53:14 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getPostTypes ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-05-02 17:13:08 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-04-28 17:25:25 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$filter = isset ( $args [ 3 ] ) ? $args [ 3 ] : array ( 'public' => true );
2012-03-23 13:53:14 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-04-28 14:48:10 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2012-05-02 16:29:34 -04:00
$fields = apply_filters ( 'xmlrpc_default_posttype_fields' , array ( 'labels' , 'cap' , 'taxonomies' ), 'wp.getPostTypes' );
2014-03-26 01:44:16 -04:00
}
2012-03-23 13:53:14 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-03-23 13:53:14 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getPostTypes' , $args , $this );
2012-03-23 13:53:14 -04:00
$post_types = get_post_types ( $filter , 'objects' );
$struct = array ();
2015-08-25 16:28:22 -04:00
foreach ( $post_types as $post_type ) {
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( $post_type -> cap -> edit_posts ) ) {
2012-03-23 13:53:14 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2012-03-23 13:53:14 -04:00
2017-11-30 18:11:00 -05:00
$struct [ $post_type -> name ] = $this -> _prepare_post_type ( $post_type , $fields );
2012-03-23 13:53:14 -04:00
}
return $struct ;
}
2012-09-27 00:17:15 -04:00
/**
* Retrieve revisions for a specific post .
*
* @ since 3.5 . 0
*
* The optional $fields parameter specifies what fields will be included
* in the response array .
*
* @ uses wp_get_post_revisions ()
* @ see wp_getPost () for more on $fields
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Post ID .
* @ type array $ 4 Optional . Fields to fetch .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error contains a collection of posts .
2012-09-27 00:17:15 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_getRevisions ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 4 ) ) {
2012-09-27 00:17:15 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$post_id = ( int ) $args [ 3 ];
2012-09-27 00:17:15 -04:00
2014-03-26 01:44:16 -04:00
if ( isset ( $args [ 4 ] ) ) {
2012-09-27 00:17:15 -04:00
$fields = $args [ 4 ];
2014-03-26 01:44:16 -04:00
} else {
/**
2016-05-22 14:15:28 -04:00
* Filters the default revision query fields used by the given XML - RPC method .
2014-03-26 01:44:16 -04:00
*
* @ since 3.5 . 0
*
* @ param array $field An array of revision query fields .
* @ param string $method The method name .
*/
2012-09-27 00:17:15 -04:00
$fields = apply_filters ( 'xmlrpc_default_revision_fields' , array ( 'post_date' , 'post_date_gmt' ), 'wp.getRevisions' );
2014-03-26 01:44:16 -04:00
}
2012-09-27 00:17:15 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-27 00:17:15 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.getRevisions' , $args , $this );
2012-09-27 00:17:15 -04:00
2019-07-02 19:42:58 -04:00
$post = get_post ( $post_id );
if ( ! $post ) {
2015-05-09 17:09:25 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_id ) ) {
2012-09-27 00:17:15 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
// Check if revisions are enabled.
2017-11-30 18:11:00 -05:00
if ( ! wp_revisions_enabled ( $post ) ) {
2012-09-27 00:17:15 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, revisions are disabled.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
$revisions = wp_get_post_revisions ( $post_id );
2017-11-30 18:11:00 -05:00
if ( ! $revisions ) {
2012-09-27 00:17:15 -04:00
return array ();
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
$struct = array ();
foreach ( $revisions as $revision ) {
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'read_post' , $revision -> ID ) ) {
2012-09-27 00:17:15 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2020-01-28 19:45:18 -05:00
// Skip autosaves.
2017-11-30 18:11:00 -05:00
if ( wp_is_post_autosave ( $revision ) ) {
2012-09-27 00:17:15 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
$struct [] = $this -> _prepare_post ( get_object_vars ( $revision ), $fields );
}
return $struct ;
}
/**
* Restore a post revision
*
* @ since 3.5 . 0
*
* @ uses wp_restore_post_revision ()
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Revision ID .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return bool | IXR_Error false if there was an error restoring , true if success .
2012-09-27 00:17:15 -04:00
*/
2014-05-19 02:09:13 -04:00
public function wp_restoreRevision ( $args ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
2012-09-27 00:17:15 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2013-03-01 11:28:40 -05:00
$this -> escape ( $args );
2012-09-27 00:17:15 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
$revision_id = ( int ) $args [ 3 ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2012-09-27 00:17:15 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'wp.restoreRevision' , $args , $this );
2012-09-27 00:17:15 -04:00
2019-07-02 19:42:58 -04:00
$revision = wp_get_post_revision ( $revision_id );
if ( ! $revision ) {
2015-05-09 17:09:25 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2017-11-30 18:11:00 -05:00
if ( wp_is_post_autosave ( $revision ) ) {
2015-05-09 17:09:25 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2019-07-02 19:42:58 -04:00
$post = get_post ( $revision -> post_parent );
if ( ! $post ) {
2015-05-09 17:09:25 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $revision -> post_parent ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
// Check if revisions are disabled.
2017-11-30 18:11:00 -05:00
if ( ! wp_revisions_enabled ( $post ) ) {
2012-09-27 00:17:15 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, revisions are disabled.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-27 00:17:15 -04:00
$post = wp_restore_post_revision ( $revision_id );
return ( bool ) $post ;
}
2020-01-28 19:45:18 -05:00
/*
* Blogger API functions .
* Specs on http :// plant . blogger . com / api and https :// groups . yahoo . com / group / bloggerDev /
2010-09-23 17:22:21 -04:00
*/
/**
* Retrieve blogs that user owns .
*
* Will make more sense once we support multiple blogs .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function blogger_getUsersBlogs ( $args ) {
2016-09-13 19:17:28 -04:00
if ( ! $this -> minimum_args ( $args , 3 ) ) {
return $this -> error ;
}
if ( is_multisite () ) {
2017-11-30 18:11:00 -05:00
return $this -> _multisite_getUsersBlogs ( $args );
2016-09-13 19:17:28 -04:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2010-09-23 17:22:21 -04:00
$username = $args [ 1 ];
2015-05-22 15:37:24 -04:00
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.getUsersBlogs' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$is_admin = current_user_can ( 'manage_options' );
2010-09-23 17:22:21 -04:00
$struct = array (
'isAdmin' => $is_admin ,
2017-11-30 18:11:00 -05:00
'url' => get_option ( 'home' ) . '/' ,
2010-09-23 17:22:21 -04:00
'blogid' => '1' ,
2017-11-30 18:11:00 -05:00
'blogName' => get_option ( 'blogname' ),
2012-10-10 17:55:36 -04:00
'xmlrpc' => site_url ( 'xmlrpc.php' , 'rpc' ),
2010-09-23 17:22:21 -04:00
);
2017-11-30 18:11:00 -05:00
return array ( $struct );
2010-09-23 17:22:21 -04:00
}
/**
* Private function for retrieving a users blogs for multisite setups
*
2015-12-16 00:49:26 -05:00
* @ since 3.0 . 0
2014-11-02 22:04:22 -05:00
*
2015-12-16 00:49:26 -05:00
* @ param array $args {
* Method arguments . Note : arguments must be ordered as documented .
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-12-16 00:49:26 -05:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-12-16 00:49:26 -05:00
protected function _multisite_getUsersBlogs ( $args ) {
2016-10-25 18:54:35 -04:00
$current_blog = get_site ();
2012-10-04 08:40:09 -04:00
2010-09-23 17:22:21 -04:00
$domain = $current_blog -> domain ;
2017-11-30 18:11:00 -05:00
$path = $current_blog -> path . 'xmlrpc.php' ;
2010-09-23 17:22:21 -04:00
2012-08-30 09:33:00 -04:00
$rpc = new IXR_Client ( set_url_scheme ( " http:// { $domain } { $path } " ) );
2017-11-30 18:11:00 -05:00
$rpc -> query ( 'wp.getUsersBlogs' , $args [ 1 ], $args [ 2 ] );
2010-09-23 17:22:21 -04:00
$blogs = $rpc -> getResponse ();
2017-11-30 18:11:00 -05:00
if ( isset ( $blogs [ 'faultCode' ] ) ) {
return new IXR_Error ( $blogs [ 'faultCode' ], $blogs [ 'faultString' ] );
}
2010-09-23 17:22:21 -04:00
if ( $_SERVER [ 'HTTP_HOST' ] == $domain && $_SERVER [ 'REQUEST_URI' ] == $path ) {
return $blogs ;
} else {
foreach ( ( array ) $blogs as $blog ) {
2017-11-30 18:11:00 -05:00
if ( strpos ( $blog [ 'url' ], $_SERVER [ 'HTTP_HOST' ] ) ) {
return array ( $blog );
}
2010-09-23 17:22:21 -04:00
}
return array ();
}
}
/**
* Retrieve user ' s data .
*
* Gives your client some info about you , so you don ' t have to .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function blogger_getUserInfo ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2010-09-23 17:22:21 -04:00
$username = $args [ 1 ];
2015-05-22 15:37:24 -04:00
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2016-07-12 07:45:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to access user data on this site.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.getUserInfo' , $args , $this );
2010-09-23 17:22:21 -04:00
$struct = array (
'nickname' => $user -> nickname ,
'userid' => $user -> ID ,
'url' => $user -> user_url ,
'lastname' => $user -> last_name ,
2017-11-30 18:11:00 -05:00
'firstname' => $user -> first_name ,
2010-09-23 17:22:21 -04:00
);
return $struct ;
}
/**
* Retrieve post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type int $ 1 Post ID .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function blogger_getPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 1 ];
2010-09-23 17:22:21 -04:00
$username = $args [ 2 ];
2015-05-22 15:37:24 -04:00
$password = $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_data = get_post ( $post_ID , ARRAY_A );
if ( ! $post_data ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-05-03 12:41:59 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.getPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$categories = implode ( ',' , wp_get_post_categories ( $post_ID ) );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$content = '<title>' . wp_unslash ( $post_data [ 'post_title' ] ) . '</title>' ;
$content .= '<category>' . $categories . '</category>' ;
$content .= wp_unslash ( $post_data [ 'post_content' ] );
2010-09-23 17:22:21 -04:00
$struct = array (
2017-11-30 18:11:00 -05:00
'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 ,
2017-11-30 18:11:00 -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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type string $ 0 App key ( unused ) .
* @ type int $ 1 Blog ID ( unused ) .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
* @ type int $ 4 Optional . Number of posts .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function blogger_getRecentPosts ( $args ) {
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2020-01-28 19:45:18 -05:00
// $args[0] = appkey - ignored.
2010-09-23 17:22:21 -04:00
$username = $args [ 2 ];
2015-05-22 15:37:24 -04:00
$password = $args [ 3 ];
2017-11-30 18:11:00 -05:00
if ( isset ( $args [ 4 ] ) ) {
2010-11-09 05:16:23 -05:00
$query = array ( 'numberposts' => absint ( $args [ 4 ] ) );
2017-11-30 18:11:00 -05:00
} else {
2010-11-09 05:16:23 -05:00
$query = array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts.' ) );
2017-11-30 18:11:00 -05:00
}
2013-03-07 01:52:37 -05:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.getRecentPosts' , $args , $this );
2010-09-23 17:22:21 -04:00
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $posts_list ) {
$this -> error = new IXR_Error ( 500 , __ ( 'Either there are no posts, or something went wrong.' ) );
2010-09-23 17:22:21 -04:00
return $this -> error ;
}
2014-11-01 15:45:25 -04:00
$recent_posts = array ();
2017-11-30 18:11:00 -05:00
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2012-04-04 17:32:28 -04:00
$post_date = $this -> _convert_date ( $entry [ 'post_date' ] );
2017-11-30 18:11:00 -05:00
$categories = implode ( ',' , wp_get_post_categories ( $entry [ 'ID' ] ) );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$content = '<title>' . wp_unslash ( $entry [ 'post_title' ] ) . '</title>' ;
$content .= '<category>' . $categories . '</category>' ;
$content .= wp_unslash ( $entry [ 'post_content' ] );
2010-09-23 17:22:21 -04:00
2014-11-01 15:45:25 -04:00
$recent_posts [] = array (
2017-11-30 18:11:00 -05:00
'userid' => $entry [ 'post_author' ],
2012-04-04 17:32:28 -04:00
'dateCreated' => $post_date ,
2017-11-30 18:11:00 -05:00
'content' => $content ,
'postid' => ( string ) $entry [ 'ID' ],
2010-09-23 17:22:21 -04:00
);
}
return $recent_posts ;
}
/**
2012-11-28 21:35:39 -05:00
* Deprecated .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
2012-11-28 21:35:39 -05:00
* @ deprecated 3.5 . 0
2015-12-16 12:26:28 -05:00
*
* @ param array $args Unused .
2015-12-16 12:38:27 -05:00
* @ return IXR_Error Error object .
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function blogger_getTemplate ( $args ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, this method is not supported.' ) );
2010-09-23 17:22:21 -04:00
}
/**
2012-11-28 21:35:39 -05:00
* Deprecated .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
2012-11-28 21:35:39 -05:00
* @ deprecated 3.5 . 0
2015-12-16 12:26:28 -05:00
*
* @ param array $args Unused .
2015-12-16 12:38:27 -05:00
* @ return IXR_Error Error object .
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function blogger_setTemplate ( $args ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 403 , __ ( 'Sorry, this method is not supported.' ) );
2010-09-23 17:22:21 -04:00
}
/**
2015-12-16 12:26:28 -05:00
* Creates new post .
2010-09-23 17:22:21 -04:00
*
* @ since 1.5 . 0
*
2015-12-16 12:26:28 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type string $ 0 App key ( unused ) .
* @ type int $ 1 Blog ID ( unused ) .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
* @ type string $ 4 Content .
* @ type int $ 5 Publish flag . 0 for draft , 1 for publish .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return int | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function blogger_newPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2010-09-23 17:22:21 -04:00
$username = $args [ 2 ];
2015-05-22 15:37:24 -04:00
$password = $args [ 3 ];
$content = $args [ 4 ];
$publish = $args [ 5 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.newPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$cap = ( $publish ) ? 'publish_posts' : 'edit_posts' ;
if ( ! current_user_can ( get_post_type_object ( 'post' ) -> cap -> create_posts ) || ! current_user_can ( $cap ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to post on this site.' ) );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_status = ( $publish ) ? 'publish' : 'draft' ;
2010-09-23 17:22:21 -04:00
$post_author = $user -> ID ;
2017-11-30 18:11:00 -05:00
$post_title = xmlrpc_getposttitle ( $content );
$post_category = xmlrpc_getpostcategory ( $content );
$post_content = xmlrpc_removepostdata ( $content );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_date = current_time ( 'mysql' );
$post_date_gmt = current_time ( 'mysql' , 1 );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_data = compact ( 'post_author' , 'post_date' , 'post_date_gmt' , 'post_content' , 'post_title' , 'post_category' , 'post_status' );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_ID = wp_insert_post ( $post_data );
if ( is_wp_error ( $post_ID ) ) {
return new IXR_Error ( 500 , $post_ID -> get_error_message () );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $post_ID ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be created.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$this -> attach_uploads ( $post_ID , $post_content );
2014-03-26 01:44:16 -04:00
/**
* Fires after a new post has been successfully created via the XML - RPC Blogger API .
*
* @ since 3.4 . 0
*
* @ param int $post_ID ID of the new post .
* @ param array $args An array of new post arguments .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_blogger_newPost' , $post_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2010-09-23 17:22:21 -04:00
return $post_ID ;
}
/**
* Edit a post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type int $ 1 Post ID .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
* @ type string $ 4 Content
* @ type int $ 5 Publish flag . 0 for draft , 1 for publish .
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error true when done .
2010-09-23 17:22:21 -04:00
*/
2014-05-19 02:09:13 -04:00
public function blogger_editPost ( $args ) {
2013-03-01 11:28:40 -05:00
2017-11-30 18:11:00 -05:00
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
$content = $args [ 4 ];
2015-09-26 00:01:26 -04:00
$publish = $args [ 5 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2014-05-14 23:25:15 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.editPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2014-05-14 23:25:15 -04:00
$actual_post = get_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2020-02-09 11:55:09 -05:00
if ( ! $actual_post || 'post' !== $actual_post [ 'post_type' ] ) {
2014-05-14 23:25:15 -04:00
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ) );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$this -> escape ( $actual_post );
2013-03-01 11:28:40 -05:00
2014-05-14 23:25:15 -04:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
2017-11-30 18:11:00 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2014-05-14 23:25:15 -04:00
}
2020-02-09 11:55:09 -05:00
if ( 'publish' === $actual_post [ 'post_status' ] && ! current_user_can ( 'publish_posts' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish this post.' ) );
2014-05-14 23:25:15 -04:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$postdata = array ();
$postdata [ 'ID' ] = $actual_post [ 'ID' ];
$postdata [ 'post_content' ] = xmlrpc_removepostdata ( $content );
$postdata [ 'post_title' ] = xmlrpc_getposttitle ( $content );
2014-05-14 23:25:15 -04:00
$postdata [ 'post_category' ] = xmlrpc_getpostcategory ( $content );
2017-11-30 18:11:00 -05:00
$postdata [ 'post_status' ] = $actual_post [ 'post_status' ];
$postdata [ 'post_excerpt' ] = $actual_post [ 'post_excerpt' ];
$postdata [ 'post_status' ] = $publish ? 'publish' : 'draft' ;
2010-09-23 17:22:21 -04:00
2014-05-14 23:25:15 -04:00
$result = wp_update_post ( $postdata );
2010-09-23 17:22:21 -04:00
2014-05-14 23:25:15 -04:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be updated.' ) );
2014-05-14 23:25:15 -04:00
}
$this -> attach_uploads ( $actual_post [ 'ID' ], $postdata [ 'post_content' ] );
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a post has been successfully updated via the XML - RPC Blogger API .
*
* @ since 3.4 . 0
*
* @ param int $post_ID ID of the updated post .
* @ param array $args An array of arguments for the post to edit .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_blogger_editPost' , $post_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Remove a post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type int $ 1 Post ID .
* @ type string $ 2 Username .
* @ type string $ 3 Password .
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error True when post is deleted .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function blogger_deletePost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 1 ];
$username = $args [ 2 ];
$password = $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'blogger.deletePost' , $args , $this );
2010-09-23 17:22:21 -04:00
2015-10-03 10:09:43 -04:00
$actual_post = get_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2020-02-09 11:55:09 -05:00
if ( ! $actual_post || 'post' !== $actual_post [ 'post_type' ] ) {
2015-10-03 10:09:43 -04:00
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ) );
}
2010-09-23 17:22:21 -04:00
2015-10-03 10:09:43 -04:00
if ( ! current_user_can ( 'delete_post' , $post_ID ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to delete this post.' ) );
2015-10-03 10:09:43 -04:00
}
2010-09-23 17:22:21 -04:00
2015-10-03 10:09:43 -04:00
$result = wp_delete_post ( $post_ID );
2010-09-23 17:22:21 -04:00
2015-10-03 10:09:43 -04:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be deleted.' ) );
2015-10-03 10:09:43 -04:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a post has been successfully deleted via the XML - RPC Blogger API .
*
* @ since 3.4 . 0
*
* @ param int $post_ID ID of the deleted post .
* @ param array $args An array of arguments to delete the post .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_blogger_deletePost' , $post_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2010-09-23 17:22:21 -04:00
return true ;
}
2020-01-28 19:45:18 -05:00
/*
* MetaWeblog API functions .
* Specs on wherever Dave Winer wants them to be .
2010-09-23 17:22:21 -04:00
*/
/**
* 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
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Content structure .
* @ type int $ 4 Optional . Publish flag . 0 for draft , 1 for publish . Default 0.
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return int | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2017-11-30 18:11:00 -05:00
public function mw_newPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
$content_struct = $args [ 3 ];
2015-05-22 15:37:24 -04:00
$publish = isset ( $args [ 4 ] ) ? $args [ 4 ] : 0 ;
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.newPost' , $args , $this );
2010-12-13 16:21:50 -05:00
2010-09-23 17:22:21 -04:00
$page_template = '' ;
2017-11-30 18:11:00 -05:00
if ( ! empty ( $content_struct [ 'post_type' ] ) ) {
2020-02-09 11:55:09 -05:00
if ( 'page' === $content_struct [ 'post_type' ] ) {
2017-11-30 18:11:00 -05:00
if ( $publish ) {
$cap = 'publish_pages' ;
2020-02-09 11:55:09 -05:00
} elseif ( isset ( $content_struct [ 'page_status' ] ) && 'publish' === $content_struct [ 'page_status' ] ) {
2017-11-30 18:11:00 -05:00
$cap = 'publish_pages' ;
} else {
2010-12-08 10:31:17 -05:00
$cap = 'edit_pages' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$error_message = __ ( 'Sorry, you are not allowed to publish pages on this site.' );
2017-11-30 18:11:00 -05:00
$post_type = 'page' ;
if ( ! empty ( $content_struct [ 'wp_page_template' ] ) ) {
2010-09-23 17:22:21 -04:00
$page_template = $content_struct [ 'wp_page_template' ];
2017-11-30 18:11:00 -05:00
}
2020-02-09 11:55:09 -05:00
} elseif ( 'post' === $content_struct [ 'post_type' ] ) {
2017-11-30 18:11:00 -05:00
if ( $publish ) {
$cap = 'publish_posts' ;
2020-02-09 11:55:09 -05:00
} elseif ( isset ( $content_struct [ 'post_status' ] ) && 'publish' === $content_struct [ 'post_status' ] ) {
2017-11-30 18:11:00 -05:00
$cap = 'publish_posts' ;
} else {
2010-12-08 10:31:17 -05:00
$cap = 'edit_posts' ;
2017-11-30 18:11:00 -05:00
}
2010-12-08 10:31:17 -05:00
$error_message = __ ( 'Sorry, you are not allowed to publish posts on this site.' );
2017-11-30 18:11:00 -05:00
$post_type = 'post' ;
2010-09-23 17:22:21 -04:00
} else {
2020-01-28 19:45:18 -05:00
// No other 'post_type' values are allowed here.
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
2010-09-23 17:22:21 -04:00
}
2010-12-08 10:31:17 -05:00
} else {
2017-11-30 18:11:00 -05:00
if ( $publish ) {
$cap = 'publish_posts' ;
2020-02-09 11:55:09 -05:00
} elseif ( isset ( $content_struct [ 'post_status' ] ) && 'publish' === $content_struct [ 'post_status' ] ) {
2017-11-30 18:11:00 -05:00
$cap = 'publish_posts' ;
} else {
2010-12-08 10:31:17 -05:00
$cap = 'edit_posts' ;
2017-11-30 18:11:00 -05:00
}
2010-12-08 10:31:17 -05:00
$error_message = __ ( 'Sorry, you are not allowed to publish posts on this site.' );
2017-11-30 18:11:00 -05:00
$post_type = 'post' ;
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( get_post_type_object ( $post_type ) -> cap -> create_posts ) ) {
2012-11-28 17:28:20 -05:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish posts on this site.' ) );
2017-11-30 18:11:00 -05:00
}
if ( ! current_user_can ( $cap ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , $error_message );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -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' ] );
2017-11-30 18:11:00 -05:00
if ( ! array_key_exists ( $content_struct [ 'wp_post_format' ], get_post_format_strings () ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post format.' ) );
2010-11-19 08:57:05 -05:00
}
}
2020-01-28 19:45:18 -05:00
// Let WordPress generate the 'post_name' (slug) unless
2010-09-23 17:22:21 -04:00
// one has been provided.
2017-11-30 18:11:00 -05:00
$post_name = '' ;
if ( isset ( $content_struct [ 'wp_slug' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_name = $content_struct [ 'wp_slug' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Only use a password if one was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_password' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_password = $content_struct [ 'wp_password' ];
2018-12-14 00:13:52 -05:00
} else {
$post_password = '' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Only set a post parent if one was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_page_parent_id' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_parent = $content_struct [ 'wp_page_parent_id' ];
2018-12-14 00:13:52 -05:00
} else {
$post_parent = 0 ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Only set the 'menu_order' if it was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_page_order' ] ) ) {
2011-05-06 15:51:47 -04:00
$menu_order = $content_struct [ 'wp_page_order' ];
2018-12-14 00:13:52 -05:00
} else {
$menu_order = 0 ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$post_author = $user -> ID ;
// If an author id was provided then use it instead.
2012-09-15 15:57:05 -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 ) {
2017-11-30 18:11:00 -05:00
case 'post' :
if ( ! current_user_can ( 'edit_others_posts' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create posts as this user.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
break ;
2017-11-30 18:11:00 -05:00
case 'page' :
if ( ! current_user_can ( 'edit_others_pages' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to create pages as this user.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
break ;
default :
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
2010-09-23 17:22:21 -04:00
}
2012-04-04 16:11:21 -04:00
$author = get_userdata ( $content_struct [ 'wp_author_id' ] );
2017-11-30 18:11:00 -05:00
if ( ! $author ) {
2012-04-04 16:11:21 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid author ID.' ) );
2017-11-30 18:11:00 -05:00
}
2011-05-06 15:51:47 -04:00
$post_author = $content_struct [ 'wp_author_id' ];
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
$post_title = isset ( $content_struct [ 'title' ] ) ? $content_struct [ 'title' ] : null ;
2010-12-08 17:00:40 -05:00
$post_content = isset ( $content_struct [ 'description' ] ) ? $content_struct [ 'description' ] : null ;
2010-09-23 17:22:21 -04:00
$post_status = $publish ? 'publish' : 'draft' ;
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ " { $post_type } _status " ] ) ) {
switch ( $content_struct [ " { $post_type } _status " ] ) {
2010-09-23 17:22:21 -04:00
case 'draft' :
2011-04-18 13:30:58 -04:00
case 'pending' :
2010-09-23 17:22:21 -04:00
case 'private' :
case 'publish' :
2017-11-30 18:11:00 -05:00
$post_status = $content_struct [ " { $post_type } _status " ];
2010-09-23 17:22:21 -04:00
break ;
default :
$post_status = $publish ? 'publish' : 'draft' ;
break ;
}
}
2017-11-30 18:11:00 -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
2017-11-30 18:11:00 -05:00
$tags_input = isset ( $content_struct [ 'mt_keywords' ] ) ? $content_struct [ 'mt_keywords' ] : null ;
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'mt_allow_comments' ] ) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_comments' ] ) ) {
2011-05-06 15:51:47 -04:00
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 :
2015-07-02 18:32:25 -04:00
$comment_status = get_default_comment_status ( $post_type );
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 :
2015-07-02 18:32:25 -04:00
$comment_status = get_default_comment_status ( $post_type );
2010-09-23 17:22:21 -04:00
break ;
}
}
} else {
2015-07-02 18:32:25 -04:00
$comment_status = get_default_comment_status ( $post_type );
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05: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 :
2015-07-02 18:32:25 -04:00
$ping_status = get_default_comment_status ( $post_type , 'pingback' );
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 :
2015-07-02 18:32:25 -04:00
$ping_status = get_default_comment_status ( $post_type , 'pingback' );
2010-09-23 17:22:21 -04:00
break ;
}
}
} else {
2015-07-02 18:32:25 -04:00
$ping_status = get_default_comment_status ( $post_type , 'pingback' );
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( $post_more ) {
2011-05-06 15:51:47 -04:00
$post_content = $post_content . '<!--more-->' . $post_more ;
2017-11-30 18:11:00 -05:00
}
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' ];
2017-11-30 18:11:00 -05:00
if ( is_array ( $to_ping ) ) {
$to_ping = implode ( ' ' , $to_ping );
}
2010-12-08 17:00:40 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Do some timestamp voodoo.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) ) {
2020-01-28 19:45:18 -05: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' ;
2017-11-30 18:11:00 -05:00
} elseif ( ! empty ( $content_struct [ 'dateCreated' ] ) ) {
2010-09-23 17:22:21 -04:00
$dateCreated = $content_struct [ 'dateCreated' ] -> getIso ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! empty ( $dateCreated ) ) {
2019-12-09 14:56:05 -05:00
$post_date = iso8601_to_datetime ( $dateCreated );
$post_date_gmt = iso8601_to_datetime ( $dateCreated , 'gmt' );
2010-09-23 17:22:21 -04:00
} else {
2017-11-30 18:11:00 -05:00
$post_date = '' ;
2015-09-25 23:38:25 -04:00
$post_date_gmt = '' ;
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' ];
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( is_array ( $catnames ) ) {
foreach ( $catnames as $cat ) {
$post_category [] = get_cat_ID ( $cat );
2010-12-08 17:00:40 -05:00
}
2010-09-23 17:22:21 -04:00
}
}
2017-11-30 18:11:00 -05: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' );
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$post_ID = get_default_post_to_edit ( $post_type , true ) -> ID ;
$postdata [ 'ID' ] = $post_ID ;
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Only posts can be sticky.
2020-02-09 11:55:09 -05:00
if ( 'post' === $post_type && isset ( $content_struct [ 'sticky' ] ) ) {
2017-11-30 18:11:00 -05:00
$data = $postdata ;
2015-07-19 14:09:25 -04:00
$data [ 'sticky' ] = $content_struct [ 'sticky' ];
2017-11-30 18:11:00 -05:00
$error = $this -> _toggle_sticky ( $data );
2015-07-19 14:09:25 -04:00
if ( $error ) {
return $error ;
}
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'custom_fields' ] ) ) {
$this -> set_custom_fields ( $post_ID , $content_struct [ 'custom_fields' ] );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05: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.' ) );
2017-11-30 18:11:00 -05:00
}
2012-03-23 11:35:44 -04:00
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'wp_post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2020-01-28 19:45:18 -05:00
// Handle enclosures.
2017-11-30 18:11:00 -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
2020-01-28 19:45:18 -05:00
// in this function.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_post_format' ] ) ) {
2012-06-26 17:07:12 -04:00
set_post_format ( $post_ID , $content_struct [ 'wp_post_format' ] );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2011-10-10 17:27:05 -04:00
$post_ID = wp_insert_post ( $postdata , true );
2017-11-30 18:11:00 -05:00
if ( is_wp_error ( $post_ID ) ) {
return new IXR_Error ( 500 , $post_ID -> get_error_message () );
}
2011-10-10 17:27:05 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $post_ID ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be created.' ) );
2017-11-30 18:11:00 -05:00
}
2011-10-10 17:27:05 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a new post has been successfully created via the XML - RPC MovableType API .
*
* @ since 3.4 . 0
*
* @ param int $post_ID ID of the new post .
* @ param array $args An array of arguments to create the new post .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_mw_newPost' , $post_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2020-10-08 17:15:13 -04:00
return ( string ) $post_ID ;
2010-09-23 17:22:21 -04:00
}
2014-11-30 20:34:24 -05:00
/**
2015-12-16 12:32:28 -05:00
* Adds an enclosure to a post if it ' s new .
*
* @ since 2.8 . 0
*
2020-10-10 16:02:05 -04:00
* @ param int $post_ID Post ID .
* @ param array $enclosure Enclosure data .
2014-11-30 20:34:24 -05:00
*/
2014-05-19 02:09:13 -04:00
public function add_enclosure_if_new ( $post_ID , $enclosure ) {
2010-09-23 17:22:21 -04:00
if ( is_array ( $enclosure ) && isset ( $enclosure [ 'url' ] ) && isset ( $enclosure [ 'length' ] ) && isset ( $enclosure [ 'type' ] ) ) {
2019-07-02 19:42:58 -04:00
$encstring = $enclosure [ 'url' ] . " \n " . $enclosure [ 'length' ] . " \n " . $enclosure [ 'type' ] . " \n " ;
$found = false ;
$enclosures = get_post_meta ( $post_ID , 'enclosure' );
if ( $enclosures ) {
2013-07-09 23:34:35 -04:00
foreach ( $enclosures as $enc ) {
// This method used to omit the trailing new line. #23219
if ( rtrim ( $enc , " \n " ) == rtrim ( $encstring , " \n " ) ) {
$found = true ;
break ;
2010-09-23 17:22:21 -04:00
}
}
}
2017-11-30 18:11:00 -05:00
if ( ! $found ) {
2013-03-01 11:28:40 -05:00
add_post_meta ( $post_ID , 'enclosure' , $encstring );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
}
}
/**
* Attach upload to a post .
*
* @ since 2.1 . 0
*
2016-10-10 02:38:31 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2020-07-23 17:11:05 -04:00
* @ param int $post_ID Post ID .
2010-09-23 17:22:21 -04:00
* @ param string $post_content Post Content for attachment .
*/
2014-05-19 02:09:13 -04:00
public function attach_uploads ( $post_ID , $post_content ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2020-01-28 19:45:18 -05:00
// Find any unattached files.
2016-10-10 02:38:31 -04:00
$attachments = $wpdb -> get_results ( " SELECT ID, guid FROM { $wpdb -> posts } WHERE post_parent = '0' AND post_type = 'attachment' " );
2010-09-23 17:22:21 -04:00
if ( is_array ( $attachments ) ) {
foreach ( $attachments as $file ) {
2017-11-30 18:11:00 -05:00
if ( ! empty ( $file -> guid ) && strpos ( $post_content , $file -> guid ) !== false ) {
$wpdb -> update ( $wpdb -> posts , array ( 'post_parent' => $post_ID ), array ( 'ID' => $file -> ID ) );
}
2010-09-23 17:22:21 -04:00
}
}
}
/**
* Edit a post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Post ID .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Content structure .
* @ type int $ 4 Optional . Publish flag . 0 for draft , 1 for publish . Default 0.
2015-05-22 15:37:24 -04:00
* }
2021-01-03 17:04:04 -05:00
* @ return true | IXR_Error True on success .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mw_editPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
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
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.editPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2012-08-28 15:08:28 -04:00
$postdata = get_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2015-05-25 02:25:25 -04:00
/*
2020-06-20 08:02:12 -04:00
* If there is no post data for the give post ID , stop now and return an error .
2015-05-25 02:25:25 -04:00
* Otherwise a new post will be created ( which was the old behavior ) .
*/
2017-11-30 18:11:00 -05:00
if ( ! $postdata || empty ( $postdata [ 'ID' ] ) ) {
2012-02-08 10:40:26 -05:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-02-08 10:40:26 -05:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
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.
2020-04-04 23:02:11 -04:00
if ( ! in_array ( $postdata [ 'post_type' ], array ( 'post' , 'page' ), true ) ) {
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
2017-11-30 18:11:00 -05:00
}
2012-02-13 16:01:55 -05:00
// Thwart attempt to change the post type.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $content_struct [ 'post_type' ] ) && ( $content_struct [ 'post_type' ] != $postdata [ 'post_type' ] ) ) {
2012-02-13 16:01:55 -05:00
return new IXR_Error ( 401 , __ ( 'The post type may not be changed.' ) );
2017-11-30 18:11:00 -05:00
}
2012-02-13 16:01:55 -05:00
2020-01-28 19:45:18 -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' ] );
2017-11-30 18:11:00 -05:00
if ( ! array_key_exists ( $content_struct [ 'wp_post_format' ], get_post_format_strings () ) ) {
2016-09-01 23:57:28 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post format.' ) );
2010-11-19 08:57:05 -05:00
}
}
2017-11-30 18:11:00 -05:00
$this -> escape ( $postdata );
2014-05-16 11:19:14 -04:00
2018-12-14 00:13:52 -05:00
$ID = $postdata [ 'ID' ];
$post_content = $postdata [ 'post_content' ];
$post_title = $postdata [ 'post_title' ];
$post_excerpt = $postdata [ 'post_excerpt' ];
$post_password = $postdata [ 'post_password' ];
$post_parent = $postdata [ 'post_parent' ];
$post_type = $postdata [ 'post_type' ];
$menu_order = $postdata [ 'menu_order' ];
$ping_status = $postdata [ 'ping_status' ];
$comment_status = $postdata [ 'comment_status' ];
2010-09-23 17:22:21 -04:00
// Let WordPress manage slug if none was provided.
2011-04-18 12:32:26 -04:00
$post_name = $postdata [ 'post_name' ];
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_slug' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_name = $content_struct [ 'wp_slug' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Only use a password if one was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_password' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_password = $content_struct [ 'wp_password' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
// Only set a post parent if one was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_page_parent_id' ] ) ) {
2011-05-06 15:51:47 -04:00
$post_parent = $content_struct [ 'wp_page_parent_id' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Only set the 'menu_order' if it was given.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_page_order' ] ) ) {
2011-05-06 15:51:47 -04:00
$menu_order = $content_struct [ 'wp_page_order' ];
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-05-16 11:19:14 -04:00
$page_template = null ;
2020-05-16 14:42:12 -04: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' ];
2017-11-30 18:11:00 -05:00
}
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
2020-01-28 19:45:18 -05:00
// If an author id was provided then use it instead.
2015-04-02 11:49:30 -04:00
if ( isset ( $content_struct [ 'wp_author_id' ] ) ) {
// Check permissions if attempting to switch author to or from another user.
if ( $user -> ID != $content_struct [ 'wp_author_id' ] || $user -> ID != $post_author ) {
switch ( $post_type ) {
case 'post' :
if ( ! current_user_can ( 'edit_others_posts' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to change the post author as this user.' ) );
2015-04-02 11:49:30 -04:00
}
break ;
case 'page' :
if ( ! current_user_can ( 'edit_others_pages' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to change the page author as this user.' ) );
2015-04-02 11:49:30 -04:00
}
break ;
default :
2016-07-17 12:05:31 -04:00
return new IXR_Error ( 401 , __ ( 'Invalid post type.' ) );
2015-04-02 11:49:30 -04:00
}
$post_author = $content_struct [ 'wp_author_id' ];
2010-09-23 17:22:21 -04:00
}
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'mt_allow_comments' ] ) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_comments' ] ) ) {
2011-05-06 15:51:47 -04:00
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 :
2015-07-02 18:32:25 -04:00
$comment_status = get_default_comment_status ( $post_type );
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 :
2015-07-02 18:32:25 -04:00
$comment_status = get_default_comment_status ( $post_type );
2010-09-23 17:22:21 -04:00
break ;
}
}
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'mt_allow_pings' ] ) ) {
if ( ! is_numeric ( $content_struct [ 'mt_allow_pings' ] ) ) {
2011-05-06 15:51:47 -04:00
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 :
2015-07-02 18:32:25 -04:00
$ping_status = get_default_comment_status ( $post_type , 'pingback' );
2010-09-23 17:22:21 -04:00
break ;
}
} else {
2017-11-30 18:11:00 -05: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 :
2015-07-02 18:32:25 -04:00
$ping_status = get_default_comment_status ( $post_type , 'pingback' );
2010-09-23 17:22:21 -04:00
break ;
}
}
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'title' ] ) ) {
$post_title = $content_struct [ 'title' ];
}
2012-03-29 07:59:51 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'description' ] ) ) {
2012-03-29 07:59:51 -04:00
$post_content = $content_struct [ 'description' ];
2017-11-30 18:11:00 -05:00
}
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' ];
2017-11-30 18:11:00 -05:00
if ( is_array ( $catnames ) ) {
foreach ( $catnames as $cat ) {
$post_category [] = get_cat_ID ( $cat );
2010-12-08 17:00:40 -05:00
}
2010-09-23 17:22:21 -04:00
}
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'mt_excerpt' ] ) ) {
$post_excerpt = $content_struct [ 'mt_excerpt' ];
}
2012-03-29 07:59:51 -04:00
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' ;
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ " { $post_type } _status " ] ) ) {
switch ( $content_struct [ " { $post_type } _status " ] ) {
2010-09-23 17:22:21 -04:00
case 'draft' :
2011-04-18 13:30:58 -04:00
case 'pending' :
2010-09-23 17:22:21 -04:00
case 'private' :
case 'publish' :
2017-11-30 18:11:00 -05:00
$post_status = $content_struct [ " { $post_type } _status " ];
2010-09-23 17:22:21 -04:00
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
2020-02-09 11:55:09 -05:00
if ( 'publish' === $post_status || 'private' === $post_status ) {
2020-05-16 14:42:12 -04:00
if ( 'page' === $post_type && ! current_user_can ( 'publish_pages' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish this page.' ) );
2015-01-08 02:05:25 -05:00
} elseif ( ! current_user_can ( 'publish_posts' ) ) {
2016-06-29 11:16:29 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish this post.' ) );
2015-01-08 02:05:25 -05:00
}
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( $post_more ) {
$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' ];
2017-11-30 18:11:00 -05:00
if ( is_array ( $to_ping ) ) {
$to_ping = implode ( ' ' , $to_ping );
}
2010-12-08 17:00:40 -05:00
}
2010-09-23 17:22:21 -04:00
2015-05-25 02:25:25 -04:00
// Do some timestamp voodoo.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $content_struct [ 'date_created_gmt' ] ) ) {
2015-05-25 02:25:25 -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' ;
2017-11-30 18:11:00 -05:00
} elseif ( ! empty ( $content_struct [ 'dateCreated' ] ) ) {
2010-09-23 17:22:21 -04:00
$dateCreated = $content_struct [ 'dateCreated' ] -> getIso ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2016-03-22 11:10:28 -04:00
// Default to not flagging the post date to be edited unless it's intentional.
$edit_date = false ;
2017-11-30 18:11:00 -05:00
if ( ! empty ( $dateCreated ) ) {
2019-12-09 14:56:05 -05:00
$post_date = iso8601_to_datetime ( $dateCreated );
$post_date_gmt = iso8601_to_datetime ( $dateCreated , 'gmt' );
2016-03-22 11:10:28 -04:00
// Flag the post date to be edited.
$edit_date = true ;
2010-09-23 17:22:21 -04:00
} else {
$post_date = $postdata [ 'post_date' ];
$post_date_gmt = $postdata [ 'post_date_gmt' ];
}
2015-05-25 02:25:25 -04:00
// We've got all the data -- post it.
2017-11-30 18:11:00 -05:00
$newpost = compact ( 'ID' , 'post_content' , 'post_title' , 'post_category' , 'post_status' , 'post_excerpt' , 'comment_status' , 'ping_status' , 'edit_date' , 'post_date' , 'post_date_gmt' , 'to_ping' , 'post_name' , 'post_password' , 'post_parent' , 'menu_order' , 'post_author' , 'tags_input' , 'page_template' );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$result = wp_update_post ( $newpost , true );
if ( is_wp_error ( $result ) ) {
return new IXR_Error ( 500 , $result -> get_error_message () );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $result ) {
2019-12-05 08:48:03 -05:00
return new IXR_Error ( 500 , __ ( 'Sorry, the post could not be updated.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Only posts can be sticky.
2020-02-09 11:55:09 -05:00
if ( 'post' === $post_type && isset ( $content_struct [ 'sticky' ] ) ) {
2017-11-30 18:11:00 -05:00
$data = $newpost ;
$data [ 'sticky' ] = $content_struct [ 'sticky' ];
2015-08-13 11:28:27 -04:00
$data [ 'post_type' ] = 'post' ;
2017-11-30 18:11:00 -05:00
$error = $this -> _toggle_sticky ( $data , true );
2015-07-19 14:09:25 -04:00
if ( $error ) {
return $error ;
}
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'custom_fields' ] ) ) {
$this -> set_custom_fields ( $post_ID , $content_struct [ 'custom_fields' ] );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_post_thumbnail' ] ) ) {
2015-05-25 02:25:25 -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 {
2017-11-30 18:11:00 -05: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.' ) );
2017-11-30 18:11:00 -05:00
}
2012-03-23 11:35:44 -04:00
}
2012-04-13 16:23:31 -04:00
unset ( $content_struct [ 'wp_post_thumbnail' ] );
2012-03-23 11:35:44 -04:00
}
2015-05-25 02:25:25 -04:00
// Handle enclosures.
2017-11-30 18:11:00 -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
2015-05-25 02:25:25 -04:00
// Handle post formats if assigned, validation is handled earlier in this function.
2017-11-30 18:11:00 -05:00
if ( isset ( $content_struct [ 'wp_post_format' ] ) ) {
2012-06-26 17:07:12 -04:00
set_post_format ( $post_ID , $content_struct [ 'wp_post_format' ] );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
* Fires after a post has been successfully updated via the XML - RPC MovableType API .
*
* @ since 3.4 . 0
*
* @ param int $post_ID ID of the updated post .
* @ param array $args An array of arguments to update the post .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_mw_editPost' , $post_ID , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:16:26 -05:00
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Retrieve post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Post ID .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mw_getPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$postdata = get_post ( $post_ID , ARRAY_A );
if ( ! $postdata ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-29 20:19:32 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.getPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2020-05-16 14:42:12 -04:00
if ( '' !== $postdata [ 'post_date' ] ) {
2017-11-30 18:11:00 -05: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' ] );
2012-04-04 17:32:28 -04:00
$post_modified_gmt = $this -> _convert_date_gmt ( $postdata [ 'post_modified_gmt' ], $postdata [ 'post_modified' ] );
2010-09-23 17:22:21 -04:00
$categories = array ();
2017-11-30 18:11:00 -05:00
$catids = wp_get_post_categories ( $post_ID );
foreach ( $catids as $catid ) {
$categories [] = get_cat_name ( $catid );
}
2010-09-23 17:22:21 -04:00
$tagnames = array ();
2017-11-30 18:11:00 -05:00
$tags = wp_get_post_tags ( $post_ID );
if ( ! empty ( $tags ) ) {
foreach ( $tags as $tag ) {
2010-09-23 17:22:21 -04:00
$tagnames [] = $tag -> name ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$tagnames = implode ( ', ' , $tagnames );
} else {
$tagnames = '' ;
}
2017-11-30 18:11:00 -05:00
$post = get_extended ( $postdata [ 'post_content' ] );
$link = get_permalink ( $postdata [ 'ID' ] );
2010-09-23 17:22:21 -04:00
// Get the author info.
2017-11-30 18:11:00 -05:00
$author = get_userdata ( $postdata [ 'post_author' ] );
2010-09-23 17:22:21 -04:00
2020-05-16 14:42:12 -04:00
$allow_comments = ( 'open' === $postdata [ 'comment_status' ] ) ? 1 : 0 ;
$allow_pings = ( 'open' === $postdata [ 'ping_status' ] ) ? 1 : 0 ;
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Consider future posts as published.
2020-02-09 11:55:09 -05:00
if ( 'future' === $postdata [ 'post_status' ] ) {
2010-09-23 17:22:21 -04:00
$postdata [ 'post_status' ] = 'publish' ;
2017-11-30 18:11:00 -05:00
}
2010-12-13 16:21:50 -05:00
2020-01-28 19:45:18 -05:00
// Get post format.
2010-11-19 08:57:05 -05:00
$post_format = get_post_format ( $post_ID );
2017-11-30 18:11:00 -05:00
if ( empty ( $post_format ) ) {
2010-12-01 23:38:42 -05:00
$post_format = 'standard' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$sticky = false ;
2017-11-30 18:11:00 -05:00
if ( is_sticky ( $post_ID ) ) {
2010-09-23 17:22:21 -04:00
$sticky = true ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$enclosure = array ();
2017-11-30 18:11:00 -05:00
foreach ( ( array ) get_post_custom ( $post_ID ) as $key => $val ) {
2020-02-09 11:55:09 -05:00
if ( 'enclosure' === $key ) {
2010-09-23 17:22:21 -04:00
foreach ( ( array ) $val as $enc ) {
2017-11-30 18:11:00 -05:00
$encdata = explode ( " \n " , $enc );
$enclosure [ 'url' ] = trim ( htmlspecialchars ( $encdata [ 0 ] ) );
$enclosure [ 'length' ] = ( int ) trim ( $encdata [ 1 ] );
$enclosure [ 'type' ] = trim ( $encdata [ 2 ] );
2010-09-23 17:22:21 -04:00
break 2 ;
}
}
}
$resp = array (
2017-11-30 18:11:00 -05:00
'dateCreated' => $post_date ,
'userid' => $postdata [ 'post_author' ],
'postid' => $postdata [ 'ID' ],
'description' => $post [ 'main' ],
'title' => $postdata [ 'post_title' ],
'link' => $link ,
'permaLink' => $link ,
2020-01-28 19:45:18 -05:00
// Commented out because no other tool seems to use this.
// 'content' => $entry['post_content'],
2017-11-30 18:11:00 -05:00
'categories' => $categories ,
'mt_excerpt' => $postdata [ 'post_excerpt' ],
'mt_text_more' => $post [ 'extended' ],
'wp_more_text' => $post [ 'more_text' ],
'mt_allow_comments' => $allow_comments ,
'mt_allow_pings' => $allow_pings ,
'mt_keywords' => $tagnames ,
'wp_slug' => $postdata [ 'post_name' ],
'wp_password' => $postdata [ 'post_password' ],
'wp_author_id' => ( string ) $author -> ID ,
2012-04-04 17:32:28 -04:00
'wp_author_display_name' => $author -> display_name ,
2017-11-30 18:11:00 -05:00
'date_created_gmt' => $post_date_gmt ,
'post_status' => $postdata [ 'post_status' ],
'custom_fields' => $this -> get_custom_fields ( $post_ID ),
'wp_post_format' => $post_format ,
'sticky' => $sticky ,
'date_modified' => $post_modified ,
'date_modified_gmt' => $post_modified_gmt ,
2010-09-23 17:22:21 -04:00
);
2017-11-30 18:11:00 -05:00
if ( ! empty ( $enclosure ) ) {
$resp [ 'enclosure' ] = $enclosure ;
}
2010-09-23 17:22:21 -04:00
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 {
2017-11-30 18:11:00 -05:00
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ) );
2010-09-23 17:22:21 -04:00
}
}
/**
* Retrieve list of recent posts .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Optional . Number of posts .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mw_getRecentPosts ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2017-11-30 18:11:00 -05:00
if ( isset ( $args [ 3 ] ) ) {
2010-11-09 05:16:23 -05:00
$query = array ( 'numberposts' => absint ( $args [ 3 ] ) );
2017-11-30 18:11:00 -05:00
} else {
2010-11-09 05:16:23 -05:00
$query = array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit posts.' ) );
2017-11-30 18:11:00 -05:00
}
2013-03-07 01:52:37 -05:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.getRecentPosts' , $args , $this );
2010-09-23 17:22:21 -04:00
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $posts_list ) {
2012-03-02 13:06:30 -05:00
return array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-11-01 15:45:25 -04:00
$recent_posts = array ();
2017-11-30 18:11:00 -05:00
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05: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' ] );
2012-04-04 17:32:28 -04:00
$post_modified_gmt = $this -> _convert_date_gmt ( $entry [ 'post_modified_gmt' ], $entry [ 'post_modified' ] );
2010-09-23 17:22:21 -04:00
$categories = array ();
2017-11-30 18:11:00 -05:00
$catids = wp_get_post_categories ( $entry [ 'ID' ] );
foreach ( $catids as $catid ) {
$categories [] = get_cat_name ( $catid );
}
2010-09-23 17:22:21 -04:00
$tagnames = array ();
2017-11-30 18:11:00 -05:00
$tags = wp_get_post_tags ( $entry [ 'ID' ] );
if ( ! empty ( $tags ) ) {
2010-09-23 17:22:21 -04:00
foreach ( $tags as $tag ) {
$tagnames [] = $tag -> name ;
}
$tagnames = implode ( ', ' , $tagnames );
} else {
$tagnames = '' ;
}
2017-11-30 18:11:00 -05:00
$post = get_extended ( $entry [ 'post_content' ] );
$link = get_permalink ( $entry [ 'ID' ] );
2010-09-23 17:22:21 -04:00
// Get the post author info.
2017-11-30 18:11:00 -05:00
$author = get_userdata ( $entry [ 'post_author' ] );
2010-09-23 17:22:21 -04:00
2020-05-16 14:42:12 -04:00
$allow_comments = ( 'open' === $entry [ 'comment_status' ] ) ? 1 : 0 ;
$allow_pings = ( 'open' === $entry [ 'ping_status' ] ) ? 1 : 0 ;
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Consider future posts as published.
2020-02-09 11:55:09 -05:00
if ( 'future' === $entry [ 'post_status' ] ) {
2010-09-23 17:22:21 -04:00
$entry [ 'post_status' ] = 'publish' ;
2017-11-30 18:11:00 -05:00
}
2010-12-13 16:21:50 -05:00
2020-01-28 19:45:18 -05:00
// Get post format.
2010-11-19 08:57:05 -05:00
$post_format = get_post_format ( $entry [ 'ID' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $post_format ) ) {
2010-12-01 23:38:42 -05:00
$post_format = 'standard' ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-11-01 15:45:25 -04:00
$recent_posts [] = array (
2017-11-30 18:11:00 -05:00
'dateCreated' => $post_date ,
'userid' => $entry [ 'post_author' ],
'postid' => ( string ) $entry [ 'ID' ],
'description' => $post [ 'main' ],
'title' => $entry [ 'post_title' ],
'link' => $link ,
'permaLink' => $link ,
2020-01-28 19:45:18 -05:00
// Commented out because no other tool seems to use this.
2010-09-23 17:22:21 -04:00
// 'content' => $entry['post_content'],
2017-11-30 18:11:00 -05:00
'categories' => $categories ,
'mt_excerpt' => $entry [ 'post_excerpt' ],
'mt_text_more' => $post [ 'extended' ],
'wp_more_text' => $post [ 'more_text' ],
'mt_allow_comments' => $allow_comments ,
'mt_allow_pings' => $allow_pings ,
'mt_keywords' => $tagnames ,
'wp_slug' => $entry [ 'post_name' ],
'wp_password' => $entry [ 'post_password' ],
'wp_author_id' => ( string ) $author -> ID ,
2010-09-23 17:22:21 -04:00
'wp_author_display_name' => $author -> display_name ,
2017-11-30 18:11:00 -05:00
'date_created_gmt' => $post_date_gmt ,
'post_status' => $entry [ 'post_status' ],
'custom_fields' => $this -> get_custom_fields ( $entry [ 'ID' ] ),
'wp_post_format' => $post_format ,
'date_modified' => $post_modified ,
'date_modified_gmt' => $post_modified_gmt ,
2020-02-09 11:55:09 -05:00
'sticky' => ( 'post' === $entry [ 'post_type' ] && is_sticky ( $entry [ 'ID' ] ) ),
2017-11-30 18:11:00 -05:00
'wp_post_thumbnail' => get_post_thumbnail_id ( $entry [ 'ID' ] ),
2010-09-23 17:22:21 -04:00
);
}
return $recent_posts ;
}
/**
* Retrieve the list of categories on a given blog .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mw_getCategories ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view categories.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.getCategories' , $args , $this );
2010-09-23 17:22:21 -04:00
$categories_struct = array ();
2019-07-02 19:42:58 -04:00
$cats = get_categories ( array ( 'get' => 'all' ) );
if ( $cats ) {
2010-09-23 17:22:21 -04:00
foreach ( $cats as $cat ) {
2017-11-30 18:11:00 -05:00
$struct = array ();
$struct [ 'categoryId' ] = $cat -> term_id ;
$struct [ 'parentId' ] = $cat -> parent ;
$struct [ 'description' ] = $cat -> name ;
2010-09-23 17:22:21 -04:00
$struct [ 'categoryDescription' ] = $cat -> description ;
2017-11-30 18:11:00 -05:00
$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' ) );
2010-09-23 17:22:21 -04:00
$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
*
2016-10-10 02:38:31 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Data .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mw_newMediaObject ( $args ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2015-05-22 15:37:24 -04:00
$username = $this -> escape ( $args [ 1 ] );
$password = $this -> escape ( $args [ 2 ] );
$data = $args [ 3 ];
2010-09-23 17:22:21 -04:00
$name = sanitize_file_name ( $data [ 'name' ] );
$type = $data [ 'type' ];
$bits = $data [ 'bits' ];
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'metaWeblog.newMediaObject' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'upload_files' ) ) {
2016-06-29 11:16:29 -04:00
$this -> error = new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to upload files.' ) );
2010-09-23 17:22:21 -04:00
return $this -> error ;
}
2015-09-26 15:49:25 -04:00
if ( is_multisite () && upload_is_user_over_quota ( false ) ) {
2019-04-01 08:24:51 -04:00
$this -> error = new IXR_Error (
401 ,
sprintf (
2019-09-02 20:41:05 -04:00
/* translators: %s: Allowed space allocation. */
2019-04-01 08:24:51 -04:00
__ ( 'Sorry, you have used your space allocation of %s. Please delete some files to upload more files.' ),
size_format ( get_space_allowed () * MB_IN_BYTES )
)
);
2015-09-26 15:49:25 -04:00
return $this -> error ;
}
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters whether to preempt the XML - RPC media upload .
2014-03-26 01:44:16 -04:00
*
2021-12-29 12:28:00 -05:00
* Returning a truthy value will effectively short - circuit the media upload ,
2014-03-26 01:44:16 -04:00
* returning that value as a 500 error instead .
*
* @ since 2.1 . 0
*
* @ param bool $error Whether to pre - empt the media upload . Default false .
*/
2019-07-02 19:42:58 -04:00
$upload_err = apply_filters ( 'pre_upload_error' , false );
if ( $upload_err ) {
2014-03-26 01:44:16 -04:00
return new IXR_Error ( 500 , $upload_err );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$upload = wp_upload_bits ( $name , null , $bits );
if ( ! empty ( $upload [ 'error' ] ) ) {
2019-09-02 20:41:05 -04:00
/* translators: 1: File name, 2: Error message. */
2016-09-02 00:13:28 -04:00
$errorString = sprintf ( __ ( 'Could not write file %1$s (%2$s).' ), $name , $upload [ 'error' ] );
return new IXR_Error ( 500 , $errorString );
2010-09-23 17:22:21 -04:00
}
2020-01-28 19:45:18 -05:00
// Construct the attachment array.
2010-09-23 17:22:21 -04:00
$post_id = 0 ;
2012-09-18 15:06:27 -04:00
if ( ! empty ( $data [ 'post_id' ] ) ) {
$post_id = ( int ) $data [ 'post_id' ];
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_id ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
2012-09-18 15:06:27 -04:00
}
2010-09-23 17:22:21 -04:00
$attachment = array (
2017-11-30 18:11:00 -05:00
'post_title' => $name ,
'post_content' => '' ,
'post_type' => 'attachment' ,
'post_parent' => $post_id ,
2010-09-23 17:22:21 -04:00
'post_mime_type' => $type ,
2017-11-30 18:11:00 -05:00
'guid' => $upload [ 'url' ],
2010-09-23 17:22:21 -04:00
);
2020-01-28 19:45:18 -05:00
// Save the data.
2017-11-30 18:11:00 -05:00
$id = wp_insert_attachment ( $attachment , $upload [ 'file' ], $post_id );
2010-09-23 17:22:21 -04:00
wp_update_attachment_metadata ( $id , wp_generate_attachment_metadata ( $id , $upload [ 'file' ] ) );
2014-03-26 01:44:16 -04:00
/**
* Fires after a new attachment has been added via the XML - RPC MovableType API .
*
* @ since 3.4 . 0
*
* @ param int $id ID of the new attachment .
* @ param array $args An array of arguments to add the attachment .
*/
2019-07-04 21:45:56 -04:00
do_action ( 'xmlrpc_call_success_mw_newMediaObject' , $id , $args ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.NotLowercase
2012-03-08 08:12:06 -05:00
2015-09-26 01:15:25 -04:00
$struct = $this -> _prepare_media_item ( get_post ( $id ) );
2020-01-28 19:45:18 -05:00
// Deprecated values.
2015-09-26 01:15:25 -04:00
$struct [ 'id' ] = $struct [ 'attachment_id' ];
$struct [ 'file' ] = $struct [ 'title' ];
$struct [ 'url' ] = $struct [ 'link' ];
2014-03-23 22:45:15 -04:00
2015-09-17 00:46:25 -04:00
return $struct ;
2010-09-23 17:22:21 -04:00
}
2020-01-28 19:45:18 -05:00
/*
* MovableType API functions .
* Specs on http :// www . movabletype . org / docs / mtmanual_programmatic . html
2010-09-23 17:22:21 -04:00
*/
/**
* Retrieve the post titles of recent posts .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type int $ 3 Optional . Number of posts .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_getRecentPostTitles ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2017-11-30 18:11:00 -05:00
if ( isset ( $args [ 3 ] ) ) {
2010-11-09 05:16:23 -05:00
$query = array ( 'numberposts' => absint ( $args [ 3 ] ) );
2017-11-30 18:11:00 -05:00
} else {
2010-11-09 05:16:23 -05:00
$query = array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.getRecentPostTitles' , $args , $this );
2010-09-23 17:22:21 -04:00
2010-11-09 05:16:23 -05:00
$posts_list = wp_get_recent_posts ( $query );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $posts_list ) {
$this -> error = new IXR_Error ( 500 , __ ( 'Either there are no posts, or something went wrong.' ) );
2010-09-23 17:22:21 -04:00
return $this -> error ;
}
2014-11-02 22:04:22 -05:00
$recent_posts = array ();
2012-04-08 05:40:04 -04:00
2017-11-30 18:11:00 -05:00
foreach ( $posts_list as $entry ) {
if ( ! current_user_can ( 'edit_post' , $entry [ 'ID' ] ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_date = $this -> _convert_date ( $entry [ 'post_date' ] );
2012-04-04 17:32:28 -04:00
$post_date_gmt = $this -> _convert_date_gmt ( $entry [ 'post_date_gmt' ], $entry [ 'post_date' ] );
2010-09-23 17:22:21 -04:00
2014-11-02 22:04:22 -05:00
$recent_posts [] = array (
2017-11-30 18:11:00 -05:00
'dateCreated' => $post_date ,
'userid' => $entry [ 'post_author' ],
'postid' => ( string ) $entry [ 'ID' ],
'title' => $entry [ 'post_title' ],
'post_status' => $entry [ 'post_status' ],
'date_created_gmt' => $post_date_gmt ,
2010-09-23 17:22:21 -04:00
);
}
return $recent_posts ;
}
/**
* Retrieve list of all categories on blog .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Blog ID ( unused ) .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_getCategoryList ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_posts' ) ) {
2010-09-23 17:22:21 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you must be able to edit posts on this site in order to view categories.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.getCategoryList' , $args , $this );
2010-09-23 17:22:21 -04:00
$categories_struct = array ();
2019-07-02 19:42:58 -04:00
$cats = get_categories (
2017-11-30 18:11:00 -05:00
array (
'hide_empty' => 0 ,
'hierarchical' => 0 ,
)
2019-07-02 19:42:58 -04:00
);
if ( $cats ) {
2010-09-23 17:22:21 -04:00
foreach ( $cats as $cat ) {
2017-11-30 18:11:00 -05:00
$struct = array ();
$struct [ 'categoryId' ] = $cat -> term_id ;
2010-09-23 17:22:21 -04:00
$struct [ 'categoryName' ] = $cat -> name ;
$categories_struct [] = $struct ;
}
}
return $categories_struct ;
}
/**
* Retrieve post categories .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Post ID .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_getPostCategories ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! get_post ( $post_ID ) ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-29 20:19:32 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
2016-07-07 07:33:33 -04:00
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.getPostCategories' , $args , $this );
2010-09-23 17:22:21 -04:00
$categories = array ();
2020-10-08 17:15:13 -04:00
$catids = wp_get_post_categories ( ( int ) $post_ID );
2020-01-28 19:45:18 -05:00
// First listed category will be the primary category.
2010-09-23 17:22:21 -04:00
$isPrimary = true ;
foreach ( $catids as $catid ) {
$categories [] = array (
2017-11-30 18:11:00 -05:00
'categoryName' => get_cat_name ( $catid ),
'categoryId' => ( string ) $catid ,
'isPrimary' => $isPrimary ,
2010-09-23 17:22:21 -04:00
);
2017-11-30 18:11:00 -05:00
$isPrimary = false ;
2010-09-23 17:22:21 -04:00
}
return $categories ;
}
/**
* Sets categories for a post .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Post ID .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
* @ type array $ 3 Categories .
2015-05-22 15:37:24 -04:00
* }
* @ return true | IXR_Error True on success .
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_setPostCategories ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
2010-09-23 17:22:21 -04:00
$password = $args [ 2 ];
2015-05-22 15:37:24 -04:00
$categories = $args [ 3 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.setPostCategories' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! get_post ( $post_ID ) ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-29 20:19:32 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'edit_post' , $post_ID ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to edit this post.' ) );
}
2010-09-23 17:22:21 -04:00
2012-11-16 17:14:57 -05:00
$catids = array ();
2010-09-23 17:22:21 -04:00
foreach ( $categories as $cat ) {
$catids [] = $cat [ 'categoryId' ];
}
2017-11-30 18:11:00 -05:00
wp_set_post_categories ( $post_ID , $catids );
2010-09-23 17:22:21 -04:00
return true ;
}
/**
* Retrieve an array of methods supported by this server .
*
* @ since 1.5 . 0
*
* @ return array
*/
2015-05-22 15:37:24 -04:00
public function mt_supportedMethods () {
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-03-05 06:03:06 -05:00
do_action ( 'xmlrpc_call' , 'mt.supportedMethods' , array (), $this );
2010-09-23 17:22:21 -04:00
2015-05-22 15:37:24 -04:00
return array_keys ( $this -> methods );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve an empty array because we don ' t support per - post text filters .
*
* @ since 1.5 . 0
*/
2015-05-22 15:37:24 -04:00
public function mt_supportedTextFilters () {
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-03-05 06:03:06 -05:00
do_action ( 'xmlrpc_call' , 'mt.supportedTextFilters' , array (), $this );
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the MoveableType text filters list for XML - RPC .
2014-03-26 01:44:16 -04:00
*
* @ since 2.2 . 0
*
* @ param array $filters An array of text filters .
*/
return apply_filters ( 'xmlrpc_text_filters' , array () );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve trackbacks sent to a given post .
*
* @ since 1.5 . 0
*
2016-10-10 02:38:31 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2015-05-22 15:37:24 -04:00
* @ param int $post_ID
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_getTrackbackPings ( $post_ID ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.getTrackbackPings' , $post_ID , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$actual_post = get_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $actual_post ) {
return new IXR_Error ( 404 , __ ( 'Sorry, no such post.' ) );
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$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 ) );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $comments ) {
2010-09-23 17:22:21 -04:00
return array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$trackback_pings = array ();
foreach ( $comments as $comment ) {
2020-05-16 14:42:12 -04:00
if ( 'trackback' === $comment -> comment_type ) {
2017-11-30 18:11:00 -05:00
$content = $comment -> comment_content ;
$title = substr ( $content , 8 , ( strpos ( $content , '</strong>' ) - 8 ) );
2010-09-23 17:22:21 -04:00
$trackback_pings [] = array (
'pingTitle' => $title ,
'pingURL' => $comment -> comment_author_url ,
2017-11-30 18:11:00 -05:00
'pingIP' => $comment -> comment_author_IP ,
2010-09-23 17:22:21 -04:00
);
}
}
return $trackback_pings ;
}
/**
* Sets a post 's publish status to ' publish ' .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type int $ 0 Post ID .
* @ type string $ 1 Username .
* @ type string $ 2 Password .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return int | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function mt_publishPost ( $args ) {
$this -> escape ( $args );
2013-03-01 11:28:40 -05:00
2015-05-22 15:37:24 -04:00
$post_ID = ( int ) $args [ 0 ];
$username = $args [ 1 ];
$password = $args [ 2 ];
2010-09-23 17:22:21 -04:00
2019-07-02 19:42:58 -04:00
$user = $this -> login ( $username , $password );
if ( ! $user ) {
2010-09-23 17:22:21 -04:00
return $this -> error ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'mt.publishPost' , $args , $this );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$postdata = get_post ( $post_ID , ARRAY_A );
if ( ! $postdata ) {
2012-04-29 20:19:32 -04:00
return new IXR_Error ( 404 , __ ( 'Invalid post ID.' ) );
2017-11-30 18:11:00 -05:00
}
2012-04-29 20:19:32 -04:00
2017-11-30 18:11:00 -05:00
if ( ! current_user_can ( 'publish_posts' ) || ! current_user_can ( 'edit_post' , $post_ID ) ) {
return new IXR_Error ( 401 , __ ( 'Sorry, you are not allowed to publish this post.' ) );
}
2010-09-23 17:22:21 -04:00
$postdata [ 'post_status' ] = 'publish' ;
2020-01-28 19:45:18 -05:00
// Retain old categories.
$postdata [ 'post_category' ] = wp_get_post_categories ( $post_ID );
2017-11-30 18:11:00 -05:00
$this -> escape ( $postdata );
2010-09-23 17:22:21 -04:00
2015-05-22 15:37:24 -04:00
return wp_update_post ( $postdata );
2010-09-23 17:22:21 -04:00
}
2020-01-28 19:45:18 -05:00
/*
* Pingback functions .
* Specs on www . hixie . ch / specs / pingback / pingback
2010-09-23 17:22:21 -04:00
*/
/**
* Retrieves a pingback and registers it .
*
* @ since 1.5 . 0
*
2020-01-28 19:45:18 -05:00
* @ param array $args {
2015-05-25 02:25:25 -04:00
* Method arguments . Note : arguments must be ordered as documented .
2015-05-22 15:37:24 -04:00
*
2022-08-11 11:00:08 -04:00
* @ type string $ 0 URL of page linked from .
* @ type string $ 1 URL of page linked to .
2015-05-22 15:37:24 -04:00
* }
2014-11-02 22:04:22 -05:00
* @ return string | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function pingback_ping ( $args ) {
2016-10-10 21:43:31 -04:00
global $wpdb ;
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'pingback.ping' , $args , $this );
2010-09-23 17:22:21 -04:00
2015-05-22 15:37:24 -04:00
$this -> escape ( $args );
2010-09-23 17:22:21 -04:00
2015-05-22 15:37:24 -04:00
$pagelinkedfrom = str_replace ( '&' , '&' , $args [ 0 ] );
2017-11-30 18:11:00 -05:00
$pagelinkedto = str_replace ( '&' , '&' , $args [ 1 ] );
$pagelinkedto = str_replace ( '&' , '&' , $pagelinkedto );
2010-09-23 17:22:21 -04:00
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the pingback source URI .
2014-03-26 01:44:16 -04:00
*
* @ since 3.6 . 0
*
* @ param string $pagelinkedfrom URI of the page linked from .
* @ param string $pagelinkedto URI of the page linked to .
*/
2013-01-22 17:30:08 -05:00
$pagelinkedfrom = apply_filters ( 'pingback_ping_source_uri' , $pagelinkedfrom , $pagelinkedto );
2014-03-26 01:44:16 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $pagelinkedfrom ) {
2013-01-22 17:30:08 -05:00
return $this -> pingback_error ( 0 , __ ( 'A valid URL was not provided.' ) );
2017-11-30 18:11:00 -05:00
}
2013-01-22 17:30:08 -05:00
2020-01-28 19:45:18 -05:00
// Check if the page linked to is on our site.
2017-11-30 18:11:00 -05:00
$pos1 = strpos ( $pagelinkedto , str_replace ( array ( 'http://www.' , 'http://' , 'https://www.' , 'https://' ), '' , get_option ( 'home' ) ) );
if ( ! $pos1 ) {
2013-01-22 17:30:08 -05:00
return $this -> pingback_error ( 0 , __ ( 'Is there no link to us?' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
/*
* 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 .
*/
2017-11-30 18:11:00 -05:00
$urltest = parse_url ( $pagelinkedto );
2019-07-02 19:42:58 -04:00
$post_ID = url_to_postid ( $pagelinkedto );
if ( $post_ID ) {
2014-10-31 21:50:21 -04:00
// $way
2017-11-30 18:11:00 -05:00
} elseif ( isset ( $urltest [ 'path' ] ) && preg_match ( '#p/[0-9]{1,}#' , $urltest [ 'path' ], $match ) ) {
2020-01-28 19:45:18 -05:00
// The path defines the post_ID (archives/p/XXXX).
2017-11-30 18:11:00 -05:00
$blah = explode ( '/' , $match [ 0 ] );
2010-09-23 17:22:21 -04:00
$post_ID = ( int ) $blah [ 1 ];
2017-11-30 18:11:00 -05:00
} elseif ( isset ( $urltest [ 'query' ] ) && preg_match ( '#p=[0-9]{1,}#' , $urltest [ 'query' ], $match ) ) {
2020-01-28 19:45:18 -05:00
// The query string defines the post_ID (?p=XXXX).
2017-11-30 18:11:00 -05:00
$blah = explode ( '=' , $match [ 0 ] );
2010-09-23 17:22:21 -04:00
$post_ID = ( int ) $blah [ 1 ];
2017-11-30 18:11:00 -05:00
} elseif ( isset ( $urltest [ 'fragment' ] ) ) {
2020-01-28 19:45:18 -05:00
// An #anchor is there, it's either...
2020-10-08 17:15:13 -04:00
if ( ( int ) $urltest [ 'fragment' ] ) {
2020-01-28 19:45:18 -05:00
// ...an integer #XXXX (simplest case),
2010-09-23 17:22:21 -04:00
$post_ID = ( int ) $urltest [ 'fragment' ];
2017-11-30 18:11:00 -05:00
} elseif ( preg_match ( '/post-[0-9]+/' , $urltest [ 'fragment' ] ) ) {
2020-01-28 19:45:18 -05:00
// ...a post ID in the form 'post-###',
2017-11-30 18:11:00 -05:00
$post_ID = preg_replace ( '/[^0-9]+/' , '' , $urltest [ 'fragment' ] );
} elseif ( is_string ( $urltest [ 'fragment' ] ) ) {
2020-01-28 19:45:18 -05:00
// ...or a string #title, a little more complicated.
2019-07-02 19:42:58 -04:00
$title = preg_replace ( '/[^a-z0-9]/i' , '.' , $urltest [ 'fragment' ] );
$sql = $wpdb -> prepare ( " SELECT ID FROM $wpdb->posts WHERE post_title RLIKE %s " , $title );
$post_ID = $wpdb -> get_var ( $sql );
if ( ! $post_ID ) {
2020-01-28 19:45:18 -05:00
// Returning unknown error '0' is better than die()'ing.
2017-11-30 18:11:00 -05:00
return $this -> pingback_error ( 0 , '' );
2010-09-23 17:22:21 -04:00
}
}
} else {
2020-01-28 19:45:18 -05:00
// TODO: Attempt to extract a post ID from the given URL.
Administration: Replace contracted verb forms for better consistency.
This changeset replaces contracted verb forms like `doesn't`, `can't`, or `isn't` with non-contracted forms like `does not`, `cannot`, or `is not`, for better consistency across the WordPress administration. It also updates some corresponding unit tests strings.
Props Presskopp, socalchristina, aandrewdixon, francina, SergeyBiryukov, JeffPaul, audrasjb, hellofromTonya.
Fixes #38913.
See #39176.
Built from https://develop.svn.wordpress.org/trunk@52978
git-svn-id: http://core.svn.wordpress.org/trunk@52567 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-22 12:25:03 -04:00
return $this -> pingback_error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either does not exist, or it is not a pingback-enabled resource.' ) );
2010-09-23 17:22:21 -04:00
}
$post_ID = ( int ) $post_ID ;
2017-11-30 18:11:00 -05:00
$post = get_post ( $post_ID );
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
if ( ! $post ) { // Post not found.
Administration: Replace contracted verb forms for better consistency.
This changeset replaces contracted verb forms like `doesn't`, `can't`, or `isn't` with non-contracted forms like `does not`, `cannot`, or `is not`, for better consistency across the WordPress administration. It also updates some corresponding unit tests strings.
Props Presskopp, socalchristina, aandrewdixon, francina, SergeyBiryukov, JeffPaul, audrasjb, hellofromTonya.
Fixes #38913.
See #39176.
Built from https://develop.svn.wordpress.org/trunk@52978
git-svn-id: http://core.svn.wordpress.org/trunk@52567 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-22 12:25:03 -04:00
return $this -> pingback_error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either does not exist, or it is not a pingback-enabled resource.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-02-09 11:55:09 -05:00
if ( url_to_postid ( $pagelinkedfrom ) == $post_ID ) {
2013-01-22 17:30:08 -05:00
return $this -> pingback_error ( 0 , __ ( 'The source URL and the target URL cannot both point to the same resource.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Check if pings are on.
2017-11-30 18:11:00 -05:00
if ( ! pings_open ( $post ) ) {
Administration: Replace contracted verb forms for better consistency.
This changeset replaces contracted verb forms like `doesn't`, `can't`, or `isn't` with non-contracted forms like `does not`, `cannot`, or `is not`, for better consistency across the WordPress administration. It also updates some corresponding unit tests strings.
Props Presskopp, socalchristina, aandrewdixon, francina, SergeyBiryukov, JeffPaul, audrasjb, hellofromTonya.
Fixes #38913.
See #39176.
Built from https://develop.svn.wordpress.org/trunk@52978
git-svn-id: http://core.svn.wordpress.org/trunk@52567 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-22 12:25:03 -04:00
return $this -> pingback_error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either does not exist, or it is not a pingback-enabled resource.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Let's check that the remote site didn't already pingback this entry.
2017-11-30 18:11:00 -05:00
if ( $wpdb -> get_results ( $wpdb -> prepare ( " SELECT * FROM $wpdb->comments WHERE comment_post_ID = %d AND comment_author_url = %s " , $post_ID , $pagelinkedfrom ) ) ) {
2013-01-22 17:30:08 -05:00
return $this -> pingback_error ( 48 , __ ( 'The pingback has already been registered.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// Very stupid, but gives time to the 'from' server to publish!
2017-11-30 18:11:00 -05:00
sleep ( 1 );
2010-09-23 17:22:21 -04:00
2014-03-31 16:43:18 -04:00
$remote_ip = preg_replace ( '/[^0-9a-fA-F:., ]/' , '' , $_SERVER [ 'REMOTE_ADDR' ] );
2014-04-11 20:01:15 -04:00
2021-11-06 21:36:57 -04:00
/** This filter is documented in wp-includes/class-wp-http.php */
2019-11-19 06:07:03 -05:00
$user_agent = apply_filters ( 'http_headers_useragent' , 'WordPress/' . get_bloginfo ( 'version' ) . '; ' . get_bloginfo ( 'url' ), $pagelinkedfrom );
2014-03-31 16:43:18 -04:00
2020-01-28 19:45:18 -05:00
// Let's check the remote site.
2013-07-29 14:00:06 -04:00
$http_api_args = array (
2017-11-30 18:11:00 -05:00
'timeout' => 10 ,
'redirection' => 0 ,
2013-07-29 14:00:06 -04:00
'limit_response_size' => 153600 , // 150 KB
2017-11-30 18:11:00 -05:00
'user-agent' => " $user_agent ; verifying pingback from $remote_ip " ,
'headers' => array (
2014-03-31 16:43:18 -04:00
'X-Pingback-Forwarded-For' => $remote_ip ,
),
2013-07-29 14:00:06 -04:00
);
2016-02-23 19:55:26 -05:00
2019-07-02 19:42:58 -04:00
$request = wp_safe_remote_get ( $pagelinkedfrom , $http_api_args );
$remote_source = wp_remote_retrieve_body ( $request );
$remote_source_original = $remote_source ;
2013-06-21 02:07:47 -04:00
2016-02-23 19:55:26 -05:00
if ( ! $remote_source ) {
2014-03-26 01:44:16 -04:00
return $this -> pingback_error ( 16 , __ ( 'The source URL does not exist.' ) );
2016-02-23 19:55:26 -05:00
}
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the pingback remote source .
2014-03-26 01:44:16 -04:00
*
* @ since 2.5 . 0
*
2016-02-23 19:55:26 -05:00
* @ param string $remote_source Response source for the page linked from .
* @ param string $pagelinkedto URL of the page linked to .
2014-03-26 01:44:16 -04:00
*/
2016-02-23 19:55:26 -05:00
$remote_source = apply_filters ( 'pre_remote_source' , $remote_source , $pagelinkedto );
2010-09-23 17:22:21 -04:00
// Work around bug in strip_tags():
2016-02-23 19:55:26 -05:00
$remote_source = str_replace ( '<!DOC' , '<DOC' , $remote_source );
$remote_source = preg_replace ( '/[\r\n\t ]+/' , ' ' , $remote_source ); // normalize spaces
2017-11-30 18:11:00 -05:00
$remote_source = preg_replace ( '/<\/*(h1|h2|h3|h4|h5|h6|p|th|td|li|dt|dd|pre|caption|input|textarea|button|body)[^>]*>/' , " \n \n " , $remote_source );
2010-09-23 17:22:21 -04:00
2016-02-23 19:55:26 -05:00
preg_match ( '|<title>([^<]*?)</title>|is' , $remote_source , $matchtitle );
2016-09-18 10:26:29 -04:00
$title = isset ( $matchtitle [ 1 ] ) ? $matchtitle [ 1 ] : '' ;
if ( empty ( $title ) ) {
2022-04-11 07:50:01 -04:00
return $this -> pingback_error ( 32 , __ ( 'A title on that page cannot be found.' ) );
2016-09-18 10:26:29 -04:00
}
2010-09-23 17:22:21 -04:00
2019-08-17 09:59:55 -04:00
// Remove all script and style tags including their content.
$remote_source = preg_replace ( '@<(script|style)[^>]*?>.*?</\\1>@si' , '' , $remote_source );
// Just keep the tag we need.
$remote_source = strip_tags ( $remote_source , '<a>' );
2010-09-23 17:22:21 -04:00
2016-02-23 19:55:26 -05:00
$p = explode ( " \n \n " , $remote_source );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$preg_target = preg_quote ( $pagelinkedto , '|' );
2010-09-23 17:22:21 -04:00
foreach ( $p as $para ) {
2020-01-28 19:45:18 -05:00
if ( strpos ( $para , $pagelinkedto ) !== false ) { // It exists, but is it a link?
2017-11-30 18:11:00 -05:00
preg_match ( '|<a[^>]+?' . $preg_target . '[^>]*>([^>]+?)</a>|' , $para , $context );
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// If the URL isn't in a link context, keep looking.
2017-11-30 18:11:00 -05:00
if ( empty ( $context ) ) {
2010-09-23 17:22:21 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2020-01-28 19:45:18 -05:00
// 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.
2017-11-30 18:11:00 -05:00
$excerpt = preg_replace ( '|\</?wpcontext\>|' , '' , $para );
2010-09-23 17:22:21 -04:00
// prevent really long link text
2017-11-30 18:11:00 -05:00
if ( strlen ( $context [ 1 ] ) > 100 ) {
$context [ 1 ] = substr ( $context [ 1 ], 0 , 100 ) . '…' ;
}
2020-01-28 19:45:18 -05:00
$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.
2017-11-30 18:11:00 -05:00
$excerpt = trim ( $excerpt );
$preg_marker = preg_quote ( $marker , '|' );
$excerpt = preg_replace ( " |.*? \ s(. { 0,100} $preg_marker . { 0,100}) \ s.*|s " , '$1' , $excerpt );
2020-01-28 19:45:18 -05:00
$excerpt = strip_tags ( $excerpt ); // YES, again, to remove the marker wrapper.
2010-09-23 17:22:21 -04:00
break ;
}
}
2020-01-28 19:45:18 -05:00
if ( empty ( $context ) ) { // Link to target not found.
2013-01-22 17:30:08 -05:00
return $this -> pingback_error ( 17 , __ ( 'The source URL does not contain a link to the target URL, and so cannot be used as a source.' ) );
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$pagelinkedfrom = str_replace ( '&' , '&' , $pagelinkedfrom );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$context = '[…] ' . esc_html ( $excerpt ) . ' […]' ;
2013-07-16 10:38:54 -04:00
$pagelinkedfrom = $this -> escape ( $pagelinkedfrom );
2010-09-23 17:22:21 -04:00
Coding Standards: Rename `$comment_post_ID` and `$comment_author_IP` variables in various files.
This fixes two WPCS warnings:
* `Variable "$comment_post_ID" is not in valid snake_case format`
* `Variable "$comment_author_IP" is not in valid snake_case format`
While matching the database fields of the same name, these variables did not follow the WordPress coding standards, and are now renamed to address that.
Note: The name change only affects internal variables and parameters for a few actions receiving a comment post ID:
* `edit_comment`
* `comment_id_not_found`
* `comment_closed`
* `comment_on_trash`
* `comment_on_draft`
* `comment_on_password_protected`
* `pre_comment_on_post`
The change does not affect parameters for functions receiving an array of comment data:
* `wp_insert_comment()`
* `wp_new_comment()`
* `wp_update_comment()`
* `wp_handle_comment_submission()`
The associated array keys still match the database fields: `comment_post_ID` and `comment_author_IP`.
Follow-up to [1706], [2894], [8720], [28427], [28437], [28457], [34799], [53720],
See #55647, #56244.
Built from https://develop.svn.wordpress.org/trunk@53723
git-svn-id: http://core.svn.wordpress.org/trunk@53282 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-07-19 12:19:11 -04:00
$comment_post_id = ( int ) $post_ID ;
2017-11-30 18:11:00 -05:00
$comment_author = $title ;
2010-12-11 02:17:50 -05:00
$comment_author_email = '' ;
2017-11-30 18:11:00 -05:00
$this -> escape ( $comment_author );
2010-09-23 17:22:21 -04:00
$comment_author_url = $pagelinkedfrom ;
2017-11-30 18:11:00 -05:00
$comment_content = $context ;
$this -> escape ( $comment_content );
2010-09-23 17:22:21 -04:00
$comment_type = 'pingback' ;
Coding Standards: Rename `$comment_post_ID` and `$comment_author_IP` variables in various files.
This fixes two WPCS warnings:
* `Variable "$comment_post_ID" is not in valid snake_case format`
* `Variable "$comment_author_IP" is not in valid snake_case format`
While matching the database fields of the same name, these variables did not follow the WordPress coding standards, and are now renamed to address that.
Note: The name change only affects internal variables and parameters for a few actions receiving a comment post ID:
* `edit_comment`
* `comment_id_not_found`
* `comment_closed`
* `comment_on_trash`
* `comment_on_draft`
* `comment_on_password_protected`
* `pre_comment_on_post`
The change does not affect parameters for functions receiving an array of comment data:
* `wp_insert_comment()`
* `wp_new_comment()`
* `wp_update_comment()`
* `wp_handle_comment_submission()`
The associated array keys still match the database fields: `comment_post_ID` and `comment_author_IP`.
Follow-up to [1706], [2894], [8720], [28427], [28437], [28457], [34799], [53720],
See #55647, #56244.
Built from https://develop.svn.wordpress.org/trunk@53723
git-svn-id: http://core.svn.wordpress.org/trunk@53282 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-07-19 12:19:11 -04:00
$commentdata = array (
'comment_post_ID' => $comment_post_id ,
);
$commentdata += compact (
2018-08-16 21:51:36 -04:00
'comment_author' ,
'comment_author_url' ,
'comment_author_email' ,
'comment_content' ,
'comment_type' ,
'remote_source' ,
'remote_source_original'
2016-02-23 19:55:26 -05:00
);
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$comment_ID = wp_new_comment ( $commentdata );
2014-03-26 01:44:16 -04:00
2017-10-23 18:12:51 -04:00
if ( is_wp_error ( $comment_ID ) ) {
return $this -> pingback_error ( 0 , $comment_ID -> get_error_message () );
}
2014-03-26 01:44:16 -04:00
/**
* Fires after a post pingback has been sent .
*
* @ since 0.71
*
* @ param int $comment_ID Comment ID .
*/
do_action ( 'pingback_post' , $comment_ID );
2010-09-23 17:22:21 -04:00
2019-09-02 20:41:05 -04:00
/* translators: 1: URL of the page linked from, 2: URL of the page linked to. */
2016-09-02 00:13:28 -04:00
return sprintf ( __ ( 'Pingback from %1$s to %2$s registered. Keep the web talking! :-)' ), $pagelinkedfrom , $pagelinkedto );
2010-09-23 17:22:21 -04:00
}
/**
* Retrieve array of URLs that pingbacked the given URL .
*
* Specs on http :// www . aquarionics . com / misc / archives / blogite / 0198. html
*
* @ since 1.5 . 0
*
2016-10-10 02:38:31 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2015-05-22 15:37:24 -04:00
* @ param string $url
2014-11-02 22:04:22 -05:00
* @ return array | IXR_Error
2010-09-23 17:22:21 -04:00
*/
2015-05-22 15:37:24 -04:00
public function pingback_extensions_getPingbacks ( $url ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2014-03-26 01:44:16 -04:00
/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
2021-02-16 12:03:05 -05:00
do_action ( 'xmlrpc_call' , 'pingback.extensions.getPingbacks' , $url , $this );
2010-09-23 17:22:21 -04:00
2015-05-22 15:37:24 -04:00
$url = $this -> escape ( $url );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
$post_ID = url_to_postid ( $url );
if ( ! $post_ID ) {
2020-01-28 19:45:18 -05:00
// We aren't sure that the resource is available and/or pingback enabled.
Administration: Replace contracted verb forms for better consistency.
This changeset replaces contracted verb forms like `doesn't`, `can't`, or `isn't` with non-contracted forms like `does not`, `cannot`, or `is not`, for better consistency across the WordPress administration. It also updates some corresponding unit tests strings.
Props Presskopp, socalchristina, aandrewdixon, francina, SergeyBiryukov, JeffPaul, audrasjb, hellofromTonya.
Fixes #38913.
See #39176.
Built from https://develop.svn.wordpress.org/trunk@52978
git-svn-id: http://core.svn.wordpress.org/trunk@52567 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-03-22 12:25:03 -04:00
return $this -> pingback_error ( 33 , __ ( 'The specified target URL cannot be used as a target. It either does not exist, or it is not a pingback-enabled resource.' ) );
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
$actual_post = get_post ( $post_ID , ARRAY_A );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $actual_post ) {
2020-01-28 19:45:18 -05:00
// No such post = resource not found.
2017-11-30 18:11:00 -05:00
return $this -> pingback_error ( 32 , __ ( 'The specified target URL does not exist.' ) );
2010-09-23 17:22:21 -04:00
}
2017-11-30 18:11:00 -05:00
$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 ) );
2010-09-23 17:22:21 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $comments ) {
2010-09-23 17:22:21 -04:00
return array ();
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
$pingbacks = array ();
foreach ( $comments as $comment ) {
2020-05-16 14:42:12 -04:00
if ( 'pingback' === $comment -> comment_type ) {
2010-09-23 17:22:21 -04:00
$pingbacks [] = $comment -> comment_author_url ;
2017-11-30 18:11:00 -05:00
}
2010-09-23 17:22:21 -04:00
}
return $pingbacks ;
}
2013-01-22 17:30:08 -05:00
2014-11-30 20:34:24 -05:00
/**
2015-12-16 12:38:27 -05:00
* Sends a pingback error based on the given error code and message .
*
* @ since 3.6 . 0
*
* @ param int $code Error code .
* @ param string $message Error message .
* @ return IXR_Error Error object .
2014-11-30 20:34:24 -05:00
*/
2013-01-22 17:30:08 -05:00
protected function pingback_error ( $code , $message ) {
2014-03-26 01:44:16 -04:00
/**
2016-05-22 14:15:28 -04:00
* Filters the XML - RPC pingback error return .
2014-03-26 01:44:16 -04:00
*
* @ since 3.5 . 1
*
* @ param IXR_Error $error An IXR_Error object containing the error code and message .
*/
2013-01-22 17:30:08 -05:00
return apply_filters ( 'xmlrpc_pingback_error' , new IXR_Error ( $code , $message ) );
}
2010-09-23 17:22:21 -04:00
}