Question

wp_dashboard_recent_drafts( array $drafts = false )

Show recent drafts of the user on the dashboard.

---

description

---

参数

$drafts

(array) (Optional)

Default value: false

---

源代码

File: wp-admin/includes/dashboard.php

function wp_dashboard_recent_drafts( $drafts = false ) {
	if ( ! $drafts ) {
		$query_args = array(
			'post_type'      => 'post',
			'post_status'    => 'draft',
			'author'         => get_current_user_id(),
			'posts_per_page' => 4,
			'orderby'        => 'modified',
			'order'          => 'DESC'
		);

		/**
		 * Filters the post query arguments for the 'Recent Drafts' dashboard widget.
		 *
		 * @since 4.4.0
		 *
		 * @param array $query_args The query arguments for the 'Recent Drafts' dashboard widget.
		 */
		$query_args = apply_filters( 'dashboard_recent_drafts_query_args', $query_args );

		$drafts = get_posts( $query_args );
		if ( ! $drafts ) {
			return;
 		}
 	}

	echo '<div class="drafts">';
	if ( count( $drafts ) > 3 ) {
		echo '<p class="view-all"><a href="' . esc_url( admin_url( 'edit.php?post_status=draft' ) ) . '" aria-label="' . __( 'View all drafts' ) . '">' . _x( 'View all', 'drafts' ) . "</a></p>\n";
 	}
	echo '<h2 class="hide-if-no-js">' . __( 'Drafts' ) . "</h2>\n<ul>";

	$drafts = array_slice( $drafts, 0, 3 );
	foreach ( $drafts as $draft ) {
		$url = get_edit_post_link( $draft->ID );
		$title = _draft_or_post_title( $draft->ID );
		echo "<li>\n";
		/* translators: %s: post title */
		echo '<div class="draft-title"><a href="' . esc_url( $url ) . '" aria-label="' . esc_attr( sprintf( __( 'Edit “%s”' ), $title ) ) . '">' . esc_html( $title ) . '</a>';
		echo '<time datetime="' . get_the_time( 'c', $draft ) . '">' . get_the_time( __( 'F j, Y' ), $draft ) . '</time></div>';
		if ( $the_content = wp_trim_words( $draft->post_content, 10 ) ) {
			echo '<p>' . $the_content . '</p>';
 		}
		echo "</li>\n";
 	}
	echo "</ul>\n</div>";
}

---

更新日志

Version	description
2.7.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/dashboard.php: dashboard_recent_drafts_query_args
• wp-admin/includes/template.php: _draft_or_post_title()
• wp-includes/l10n.php: __()
• wp-includes/l10n.php: _x()
• wp-includes/formatting.php: esc_url()
• wp-includes/formatting.php: esc_attr()
• wp-includes/formatting.php: esc_html()
• wp-includes/formatting.php: wp_trim_words()
• wp-includes/general-template.php: get_the_time()
• wp-includes/link-template.php: admin_url()
• wp-includes/link-template.php: get_edit_post_link()
• wp-includes/plugin.php: apply_filters()
• wp-includes/user.php: get_current_user_id()
• wp-includes/post.php: get_posts()
Show 9 more uses Hide more uses

---

Used By

• wp-admin/includes/dashboard.php: wp_dashboard_quick_press()

---

User Contributed Notes