wp_xmlrpc_server::_insert_post( WP_User $user, array|IXR_Error $content_struct ): IXR_Error|string

Parameters

$userWP_User

The post author if post_author isn't set in $content_struct.

$content_structarray|IXR_Error

Post data to insert.

Return

IXR_Error|string

Hooks fired · 1

One hook fires while wp_xmlrpc_server::_insert_post() runs, in this order:

1. 1
   apply_filters( xmlrpc_wp_insert_post_data )filterline 1696 (+271 into the body)

   Filters post data array to be inserted via XML-RPC.

Uses · 28

• wp_parse_args()Merges user defined arguments into defaults array.
• get_post_type_object()Retrieves a post type object by name.
• __()Retrieves the translation of $text.
• get_post()Retrieves post data given a post ID or post object.
• current_user_can()Returns whether the current user has the specified capability.
• get_post_type()Retrieves the post type of the current post or of a given post.
• get_post_status_object()Retrieves a post status object by name.
• absint()Converts a value to non-negative integer.
• get_userdata()Retrieves user info by user ID.
• iso8601_to_datetime()Given an ISO 8601 (Ymd\TH:i:sO) date, returns a MySQL DateTime (Y-m-d H:i:s) format used by post_date[_gmt].
• get_default_post_to_edit()Returns default post information to use when populating the "Write Post" form.
• delete_post_thumbnail()Removes the thumbnail (featured image) from the given post.

Used by · 2

• wp_xmlrpc_server::wp_editPost()Edits a post for any registered post type.
• wp_xmlrpc_server::wp_newPost()Creates a new post for any registered post type.

Source

View on Trac ↗View on GitHub ↗

1425	protected function _insert_post( $user, $content_struct ) {1426		$defaults = array(1427			'post_status'    => 'draft',1428			'post_type'      => 'post',1429			'post_author'    => 0,1430			'post_password'  => '',1431			'post_excerpt'   => '',1432			'post_content'   => '',1433			'post_title'     => '',1434			'post_date'      => '',1435			'post_date_gmt'  => '',1436			'post_format'    => null,1437			'post_name'      => null,1438			'post_thumbnail' => null,1439			'post_parent'    => 0,1440			'ping_status'    => '',1441			'comment_status' => '',1442			'custom_fields'  => null,1443			'terms_names'    => null,1444			'terms'          => null,1445			'sticky'         => null,1446			'enclosure'      => null,1447			'ID'             => null,1448		);1449 1450		$post_data = wp_parse_args( array_intersect_key( $content_struct, $defaults ), $defaults );1451 1452		$post_type = get_post_type_object( $post_data['post_type'] );1453		if ( ! $post_type ) {1454			return new IXR_Error( 403, __( 'Invalid post type.' ) );1455		}1456 1457		$update = ! empty( $post_data['ID'] );1458 1459		if ( $update ) {1460			if ( ! get_post( $post_data['ID'] ) ) {1461				return new IXR_Error( 401, __( 'Invalid post ID.' ) );1462			}1463			if ( ! current_user_can( 'edit_post', $post_data['ID'] ) ) {1464				return new IXR_Error( 401, __( 'Sorry, you are not allowed to edit this post.' ) );1465			}1466			if ( get_post_type( $post_data['ID'] ) !== $post_data['post_type'] ) {1467				return new IXR_Error( 401, __( 'The post type may not be changed.' ) );1468			}1469		} else {1470			if ( ! current_user_can( $post_type->cap->create_posts ) || ! current_user_can( $post_type->cap->edit_posts ) ) {1471				return new IXR_Error( 401, __( 'Sorry, you are not allowed to post on this site.' ) );1472			}1473		}1474 1475		switch ( $post_data['post_status'] ) {1476			case 'draft':1477			case 'pending':1478				break;1479			case 'private':1480				if ( ! current_user_can( $post_type->cap->publish_posts ) ) {1481					return new IXR_Error( 401, __( 'Sorry, you are not allowed to create private posts in this post type.' ) );1482				}1483				break;1484			case 'publish':1485			case 'future':1486				if ( ! current_user_can( $post_type->cap->publish_posts ) ) {1487					return new IXR_Error( 401, __( 'Sorry, you are not allowed to publish posts in this post type.' ) );1488				}1489				break;1490			default:1491				if ( ! get_post_status_object( $post_data['post_status'] ) ) {1492					$post_data['post_status'] = 'draft';1493				}1494				break;1495		}1496 1497		if ( ! empty( $post_data['post_password'] ) && ! current_user_can( $post_type->cap->publish_posts ) ) {1498			return new IXR_Error( 401, __( 'Sorry, you are not allowed to create password protected posts in this post type.' ) );1499		}1500 1501		$post_data['post_author'] = absint( $post_data['post_author'] );1502		if ( ! empty( $post_data['post_author'] ) && $post_data['post_author'] !== $user->ID ) {1503			if ( ! current_user_can( $post_type->cap->edit_others_posts ) ) {1504				return new IXR_Error( 401, __( 'Sorry, you are not allowed to create posts as this user.' ) );

History

Introduced in 3.4.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/class-wp-xmlrpc-server.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.