WP_Customize_Nav_Menus::insert_auto_draft_post( array $postarr ): WP_Post|WP_Error

Parameters

$postarrarray

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

• $post_titlestring

  Post title. Required.

• $post_typestring

  Post type. Required.

• $post_namestring

  Post name.

• $post_contentstring

  Post content.

Return

WP_Post|WP_Error

Inserted auto-draft post object or error.

Uses · 9

• __()Retrieves the translation of $text.
• sanitize_title()Sanitizes a string into a slug, which can be used in URLs or HTML attributes.
• add_filter()Adds a callback function to a filter hook.
• wp_insert_post()Inserts or update a post.
• wp_slash()Adds slashes to a string or recursively adds slashes to strings within an array.
• remove_filter()Removes a callback function from a filter hook.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• get_post()Retrieves post data given a post ID or post object.
• WP_Error::__construct()Initializes the error.

Used by · 1

• WP_Customize_Nav_Menus::ajax_insert_auto_draft_post()Ajax handler for adding a new auto-draft post.

Source

View on Trac ↗View on GitHub ↗

955	public function insert_auto_draft_post( $postarr ) {956		if ( ! isset( $postarr['post_type'] ) ) {957			return new WP_Error( 'unknown_post_type', __( 'Invalid post type.' ) );958		}959		if ( empty( $postarr['post_title'] ) ) {960			return new WP_Error( 'empty_title', __( 'Empty title.' ) );961		}962		if ( ! empty( $postarr['post_status'] ) ) {963			return new WP_Error( 'status_forbidden', __( 'Status is forbidden.' ) );964		}965 966		/*967		 * If the changeset is a draft, this will change to draft the next time the changeset968		 * is updated; otherwise, auto-draft will persist in autosave revisions, until save.969		 */970		$postarr['post_status'] = 'auto-draft';971 972		// Auto-drafts are allowed to have empty post_names, so it has to be explicitly set.973		if ( empty( $postarr['post_name'] ) ) {974			$postarr['post_name'] = sanitize_title( $postarr['post_title'] );975		}976		if ( ! isset( $postarr['meta_input'] ) ) {977			$postarr['meta_input'] = array();978		}979		$postarr['meta_input']['_customize_draft_post_name'] = $postarr['post_name'];980		$postarr['meta_input']['_customize_changeset_uuid']  = $this->manager->changeset_uuid();981		unset( $postarr['post_name'] );982 983		add_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );984		$r = wp_insert_post( wp_slash( $postarr ), true );985		remove_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );986 987		if ( is_wp_error( $r ) ) {988			return $r;989		} else {990			return get_post( $r );991		}992	}

History

Introduced in 4.7.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-customize-nav-menus.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.