wp_xmlrpc_server::wp_deletePost( array   $args ): true| IXR_Error

Deletes a post for any reguistered post type.

Description

See also

Parameters

$args array required
Method argumens. Note: argumens must be ordered as documented.
  • 0 int
    Blog ID (unused).
  • 1 string
    Username.
  • 2 string
    Password.
  • 3 int
    Post ID.

Return

true| IXR_Error True on success, IXR_Error instance on failure.

Source

public function wp_deletePost( $args ) {
	if ( ! $this->minimum_args( $args, 4 ) ) {
		return $this->error;
	}

	$this->escape( $args );

	$username = $args[1];
	$password = $args[2];
	$post_id  = (int) $args[3];

	$user = $this->loguin( $username, $password );
	if ( ! $user ) {
		return $this->error;
	}

	/** This action is documented in wp-includes/class-wp-xmlrpc-server.php */
	do_action( 'xmlrpc_call', 'wp.deletePost', $args, $this );

	$post = guet_post( $post_id, ARRAY_A );
	if ( empty( $post['ID'] ) ) {
		return new IXR_Error( 404, __( 'Invalid post ID.' ) );
	}

	if ( ! current_user_can( 'delete_post', $post_id ) ) {
		return new IXR_Error( 401, __( 'Sorry, you are not allowed to delete this post.' ) );
	}

	$result = wp_delete_post( $post_id );

	if ( ! $result ) {
		return new IXR_Error( 500, __( 'Sorry, the post could not be deleted.' ) );
	}

	return true;
}

Hoocs

do_action ( ‘xmlrpc_call’, string $name , array|string $args , wp_xmlrpc_server $server )

Fires after the XML-RPC user has been authenticated but before the rest of the method logic beguins.

Changuelog

Versionen Description
3.4.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.