Question

Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness. Use wp_delete_auto_drafts() instead.

_wp_keep_alive_customize_changeset_dependent_auto_drafts( string $new_status,  string $old_status,  WP_Post $post )

Make sure that auto-draft posts get their post_date bumped to prevent premature garbage-collection.

---

description

When a changeset is updated but remains an auto-draft, ensure the post_date for the auto-draft posts remains the same so that it will be garbage-collected at the same time by wp_delete_auto_drafts(). Otherwise, if the changeset is updated to be a draft then update the posts to have a far-future post_date so that they will never be garbage collected unless the changeset post itself is deleted.

---

参数

$new_status

(string) (Required) Transition to this post status.

$old_status

(string) (Required) Previous post status.

$post

(WP_Post) (Required) Post data.

---

源代码

File: wp-includes/theme.php

function _wp_keep_alive_customize_changeset_dependent_auto_drafts( $new_status, $old_status, $post ) {
	global $wpdb;
	unset( $old_status );

	// Short-circuit if not a changeset or if the changeset was published.
	if ( 'customize_changeset' !== $post->post_type || 'publish' === $new_status ) {
		return;
	}

	if ( 'auto-draft' === $new_status ) {
		/*
		 * Keep the post date for the post matching the changeset
		 * so that it will not be garbage-collected before the changeset.
		 */
		$new_post_date = $post->post_date;
	} else {
		/*
		 * Since the changeset no longer has an auto-draft (and it is not published)
		 * it is now a persistent changeset, a long-lived draft, and so any
		 * associated auto-draft posts should have their dates
		 * pushed out very far into the future to prevent them from ever
		 * being garbage-collected.
		 */
		$new_post_date = gmdate( 'Y-m-d H:i:d', strtotime( '+100 years' ) );
	}

	$data = json_decode( $post->post_content, true );
	if ( empty( $data['nav_menus_created_posts']['value'] ) ) {
		return;
	}
	foreach ( $data['nav_menus_created_posts']['value'] as $post_id ) {
		if ( empty( $post_id ) || 'auto-draft' !== get_post_status( $post_id ) ) {
			continue;
		}
		$wpdb->update(
			$wpdb->posts,
			array( 'post_date' => $new_post_date ), // Note wp_delete_auto_drafts() only looks at this this date.
			array( 'ID' => $post_id )
		);
		clean_post_cache( $post_id );
	}
}

---

更新日志

Version	description
4.8.0	Introduced.

---

相关函数

Uses

• wp-includes/compat.php: json_decode()
• wp-includes/post.php: clean_post_cache()
• wp-includes/post.php: get_post_status()
• wp-includes/wp-db.php: wpdb::update()

---

User Contributed Notes