WP_REST_Autosaves_Controller::create_post_autosave( array $post_data ): mixed
Creates autosave for the specified post.
Contents
Description
From wp-admin/post.php.
Parameters
-
$post_data
array Required -
Associative array containing the post data.
Return
mixed The autosave revision ID or WP_Error.
Source
File: wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php
.
View all references
public function create_post_autosave( $post_data ) {
$post_id = (int) $post_data['ID'];
$post = get_post( $post_id );
if ( is_wp_error( $post ) ) {
return $post;
}
// Only create an autosave when it is different from the saved post.
$autosave_is_different = false;
$new_autosave = _wp_post_revision_data( $post_data, true );
foreach ( array_intersect( array_keys( $new_autosave ), array_keys( _wp_post_revision_fields( $post ) ) ) as $field ) {
if ( normalize_whitespace( $new_autosave[ $field ] ) !== normalize_whitespace( $post->$field ) ) {
$autosave_is_different = true;
break;
}
}
$user_id = get_current_user_id();
// Store one autosave per author. If there is already an autosave, overwrite it.
$old_autosave = wp_get_post_autosave( $post_id, $user_id );
if ( ! $autosave_is_different && $old_autosave ) {
// Nothing to save, return the existing autosave.
return $old_autosave->ID;
}
if ( $old_autosave ) {
$new_autosave['ID'] = $old_autosave->ID;
$new_autosave['post_author'] = $user_id;
/** This filter is documented in wp-admin/post.php */
do_action( 'wp_creating_autosave', $new_autosave );
// wp_update_post() expects escaped array.
return wp_update_post( wp_slash( $new_autosave ) );
}
// Create the new autosave as a special post revision.
return _wp_put_post_revision( $post_data, true );
}
Hooks
-
do_action( 'wp_creating_autosave',
array $new_autosave ) -
Fires before an autosave is stored.
Changelog
Version | Description |
---|---|
5.0.0 | Introduced. |