WP_Customize_Nav_Menus::insert_auto_draft_post │ public │ WP 4.7.0

Adds a new auto-draft post.

Method of the class: WP_Customize_Nav_Menus{}

No Hooks.

Returns

WP_Post|WP_Error. Inserted auto-draft post object or error.

Usage

$WP_Customize_Nav_Menus = new WP_Customize_Nav_Menus();
$WP_Customize_Nav_Menus->insert_auto_draft_post( $postarr );

$postarr(array) (required)

Post array. Note that post_status is overridden to be auto-draft.

• post_title(string)
  Post title. Required.

• post_type(string)
  Post type. Required.

• post_name(string)
  Post name.

• post_content(string)
  Post content.

Changelog

WP_Customize_Nav_Menus::insert_auto_draft_post() WP Customize Nav Menus::insert auto draft post code ^{WP 6.8.1}

public function insert_auto_draft_post( $postarr ) {
	if ( ! isset( $postarr['post_type'] ) ) {
		return new WP_Error( 'unknown_post_type', __( 'Invalid post type.' ) );
	}
	if ( empty( $postarr['post_title'] ) ) {
		return new WP_Error( 'empty_title', __( 'Empty title.' ) );
	}
	if ( ! empty( $postarr['post_status'] ) ) {
		return new WP_Error( 'status_forbidden', __( 'Status is forbidden.' ) );
	}

	/*
	 * If the changeset is a draft, this will change to draft the next time the changeset
	 * is updated; otherwise, auto-draft will persist in autosave revisions, until save.
	 */
	$postarr['post_status'] = 'auto-draft';

	// Auto-drafts are allowed to have empty post_names, so it has to be explicitly set.
	if ( empty( $postarr['post_name'] ) ) {
		$postarr['post_name'] = sanitize_title( $postarr['post_title'] );
	}
	if ( ! isset( $postarr['meta_input'] ) ) {
		$postarr['meta_input'] = array();
	}
	$postarr['meta_input']['_customize_draft_post_name'] = $postarr['post_name'];
	$postarr['meta_input']['_customize_changeset_uuid']  = $this->manager->changeset_uuid();
	unset( $postarr['post_name'] );

	add_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );
	$r = wp_insert_post( wp_slash( $postarr ), true );
	remove_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );

	if ( is_wp_error( $r ) ) {
		return $r;
	} else {
		return get_post( $r );
	}
}