get_default_post_to_edit( string $post_type = 'post', bool $create_in_db = false ): WP_Post

Parameters

$post_typestringoptional

A post type string. Default 'post'.Default: 'post'

$create_in_dbbooloptional

Whether to insert the post into database. Default false.Default: false

Return

WP_Post

Post object containing all the default post data as attributes

Hooks fired · 3

3 hooks fire while get_default_post_to_edit() runs, in this order:

1. 1
   apply_filters( default_content )filterline 814 (+66 into the body)

   Filters the default post content initially used in the "Write Post" form.

2. 2
   apply_filters( default_title )filterline 824 (+76 into the body)

   Filters the default post title initially used in the "Write Post" form.

3. 3
   apply_filters( default_excerpt )filterline 834 (+86 into the body)

   Filters the default post excerpt initially used in the "Write Post" form.

Uses · 16

• esc_html()Escaping for HTML blocks.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• wp_insert_post()Inserts or update a post.
• __()Retrieves the translation of $text.
• get_post()Retrieves post data given a post ID or post object.
• current_theme_supports()Checks a theme's support for a given feature.
• post_type_supports()Checks a post type's support for a given feature.
• get_option()Retrieves an option value based on an option name.
• set_post_format()Assign a format to a post
• wp_after_insert_post()Fires actions after a post, its terms and meta data has been saved.
• wp_next_scheduled()Retrieves the timestamp of the next scheduled event for the given hook.
• wp_schedule_event()Schedules a recurring event.

Used by · 5

• WP_Posts_List_Table::inline_edit()Outputs the hidden row displayed when inline editing
• get_default_page_to_edit()Gets the default page information to use.
• wp_dashboard_quick_press()Displays the Quick Draft widget.
• wp_xmlrpc_server::_insert_post()Helper method for wp_newPost() and wp_editPost(), containing shared logic.
• wp_xmlrpc_server::mw_newPost()Creates a new post.

Source

View on Trac ↗View on GitHub ↗

748function get_default_post_to_edit( $post_type = 'post', $create_in_db = false ) {749	$post_title = '';750	if ( ! empty( $_REQUEST['post_title'] ) ) {751		$post_title = esc_html( wp_unslash( $_REQUEST['post_title'] ) );752	}753 754	$post_content = '';755	if ( ! empty( $_REQUEST['content'] ) ) {756		$post_content = esc_html( wp_unslash( $_REQUEST['content'] ) );757	}758 759	$post_excerpt = '';760	if ( ! empty( $_REQUEST['excerpt'] ) ) {761		$post_excerpt = esc_html( wp_unslash( $_REQUEST['excerpt'] ) );762	}763 764	if ( $create_in_db ) {765		$post_id = wp_insert_post(766			array(767				'post_title'  => __( 'Auto Draft' ),768				'post_type'   => $post_type,769				'post_status' => 'auto-draft',770			),771			false,772			false773		);774		$post    = get_post( $post_id );775		if ( current_theme_supports( 'post-formats' ) && post_type_supports( $post->post_type, 'post-formats' ) && get_option( 'default_post_format' ) ) {776			set_post_format( $post, get_option( 'default_post_format' ) );777		}778		wp_after_insert_post( $post, false, null );779 780		// Schedule auto-draft cleanup.781		if ( ! wp_next_scheduled( 'wp_scheduled_auto_draft_delete' ) ) {782			wp_schedule_event( time(), 'daily', 'wp_scheduled_auto_draft_delete' );783		}784	} else {785		$post                 = new stdClass();786		$post->ID             = 0;787		$post->post_author    = '';788		$post->post_date      = '';789		$post->post_date_gmt  = '';790		$post->post_password  = '';791		$post->post_name      = '';792		$post->post_type      = $post_type;793		$post->post_status    = 'draft';794		$post->to_ping        = '';795		$post->pinged         = '';796		$post->comment_status = get_default_comment_status( $post_type );797		$post->ping_status    = get_default_comment_status( $post_type, 'pingback' );798		$post->post_pingback  = get_option( 'default_pingback_flag' );799		$post->post_category  = get_option( 'default_category' );800		$post->page_template  = 'default';801		$post->post_parent    = 0;802		$post->menu_order     = 0;803		$post                 = new WP_Post( $post );804	}805 806	/**807	 * Filters the default post content initially used in the "Write Post" form.808	 *809	 * @since 1.5.0810	 *811	 * @param string  $post_content Default post content.812	 * @param WP_Post $post         Post object.813	 */814	$post->post_content = (string) apply_filters( 'default_content', $post_content, $post );815 816	/**817	 * Filters the default post title initially used in the "Write Post" form.818	 *819	 * @since 1.5.0820	 *821	 * @param string  $post_title Default post title.822	 * @param WP_Post $post       Post object.823	 */824	$post->post_title = (string) apply_filters( 'default_title', $post_title, $post );825 826	/**827	 * Filters the default post excerpt initially used in the "Write Post" form.

History

Introduced in 2.0.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.8.8 tag, from src/wp-admin/includes/post.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.