Question

wp_dashboard_quick_press( string $error_msg = false )

The Quick Draft widget display and creation of drafts.

---

description

---

参数

$error_msg

(string) (Optional) Error message.

Default value: false

---

源代码

File: wp-admin/includes/dashboard.php

function wp_dashboard_quick_press( $error_msg = false ) {
	global $post_ID;

	if ( ! current_user_can( 'edit_posts' ) ) {
		return;
	}

	/* Check if a new auto-draft (= no new post_ID) is needed or if the old can be used */
	$last_post_id = (int) get_user_option( 'dashboard_quick_press_last_post_id' ); // Get the last post_ID
	if ( $last_post_id ) {
		$post = get_post( $last_post_id );
		if ( empty( $post ) || $post->post_status != 'auto-draft' ) { // auto-draft doesn't exists anymore
			$post = get_default_post_to_edit( 'post', true );
			update_user_option( get_current_user_id(), 'dashboard_quick_press_last_post_id', (int) $post->ID ); // Save post_ID
		} else {
			$post->post_title = ''; // Remove the auto draft title
		}
	} else {
		$post = get_default_post_to_edit( 'post' , true);
		$user_id = get_current_user_id();
		// Don't create an option if this is a super admin who does not belong to this site.
		if ( in_array( get_current_blog_id(), array_keys( get_blogs_of_user( $user_id ) ) ) )
			update_user_option( $user_id, 'dashboard_quick_press_last_post_id', (int) $post->ID ); // Save post_ID
	}

	$post_ID = (int) $post->ID;
?>

	<form name="post" action="<?php echo esc_url( admin_url( 'post.php' ) ); ?>" method="post" id="quick-press" class="initial-form hide-if-no-js">

		<?php if ( $error_msg ) : ?>
		<div class="error"><?php echo $error_msg; ?></div>
		<?php endif; ?>

		<div class="input-text-wrap" id="title-wrap">
			<label class="screen-reader-text prompt" for="title" id="title-prompt-text">

				<?php
				/** This filter is documented in wp-admin/edit-form-advanced.php */
				echo apply_filters( 'enter_title_here', __( 'Title' ), $post );
				?>
			</label>
			<input type="text" name="post_title" id="title" autocomplete="off" />
		</div>

		<div class="textarea-wrap" id="description-wrap">
			<label class="screen-reader-text prompt" for="content" id="content-prompt-text"><?php _e( 'What’s on your mind?' ); ?></label>
			<textarea name="content" id="content" class="mceEditor" rows="3" cols="15" autocomplete="off"></textarea>
		</div>

		<p class="submit">
			<input type="hidden" name="action" id="quickpost-action" value="post-quickdraft-save" />
			<input type="hidden" name="post_ID" value="<?php echo $post_ID; ?>" />
			<input type="hidden" name="post_type" value="post" />
			<?php wp_nonce_field( 'add-post' ); ?>
			<?php submit_button( __( 'Save Draft' ), 'primary', 'save', false, array( 'id' => 'save-post' ) ); ?>
			<br class="clear" />
		</p>

	</form>
	<?php
	wp_dashboard_recent_drafts();
}

---

更新日志

Version	description
3.8.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/dashboard.php: wp_dashboard_recent_drafts()
• wp-admin/includes/template.php: submit_button()
• wp-admin/includes/post.php: get_default_post_to_edit()
• wp-admin/edit-form-advanced.php: enter_title_here
• wp-includes/capabilities.php: current_user_can()
• wp-includes/l10n.php: __()
• wp-includes/l10n.php: _e()
• wp-includes/formatting.php: esc_url()
• wp-includes/load.php: get_current_blog_id()
• wp-includes/functions.php: wp_nonce_field()
• wp-includes/link-template.php: admin_url()
• wp-includes/plugin.php: apply_filters()
• wp-includes/user.php: update_user_option()
• wp-includes/user.php: get_blogs_of_user()
• wp-includes/user.php: get_user_option()
• wp-includes/user.php: get_current_user_id()
• wp-includes/post.php: get_post()
Show 12 more uses Hide more uses

---

Used By

• wp-admin/includes/deprecated.php: wp_dashboard_quick_press_output()

---

User Contributed Notes