<h2>Редактирование файла: class-wp-rest-autosaves-controller.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?php
/**
 * REST API: WP_REST_Autosaves_Controller class.
 *
 * @package WordPress
 * @subpackage REST_API
 * @since 5.0.0
 */

/**
 * Core class used to access autosaves via the REST API.
 *
 * @since 5.0.0
 *
 * @see WP_REST_Revisions_Controller
 * @see WP_REST_Controller
 */
class WP_REST_Autosaves_Controller extends WP_REST_Revisions_Controller {

	/**
	 * Parent post type.
	 *
	 * @since 5.0.0
	 * @var string
	 */
	private $parent_post_type;

	/**
	 * Parent post controller.
	 *
	 * @since 5.0.0
	 * @var WP_REST_Controller
	 */
	private $parent_controller;

	/**
	 * Revision controller.
	 *
	 * @since 5.0.0
	 * @var WP_REST_Revisions_Controller
	 */
	private $revisions_controller;

	/**
	 * The base of the parent controller&#039;s route.
	 *
	 * @since 5.0.0
	 * @var string
	 */
	private $parent_base;

	/**
	 * Constructor.
	 *
	 * @since 5.0.0
	 *
	 * @param string $parent_post_type Post type of the parent.
	 */
	public function __construct( $parent_post_type ) {
		$this-&gt;parent_post_type = $parent_post_type;
		$post_type_object       = get_post_type_object( $parent_post_type );
		$parent_controller      = $post_type_object-&gt;get_rest_controller();

		if ( ! $parent_controller ) {
			$parent_controller = new WP_REST_Posts_Controller( $parent_post_type );
		}

		$this-&gt;parent_controller = $parent_controller;

		$revisions_controller = $post_type_object-&gt;get_revisions_rest_controller();
		if ( ! $revisions_controller ) {
			$revisions_controller = new WP_REST_Revisions_Controller( $parent_post_type );
		}
		$this-&gt;revisions_controller = $revisions_controller;
		$this-&gt;rest_base            = &#039;autosaves&#039;;
		$this-&gt;parent_base          = ! empty( $post_type_object-&gt;rest_base ) ? $post_type_object-&gt;rest_base : $post_type_object-&gt;name;
		$this-&gt;namespace            = ! empty( $post_type_object-&gt;rest_namespace ) ? $post_type_object-&gt;rest_namespace : &#039;wp/v2&#039;;
	}

	/**
	 * Registers the routes for autosaves.
	 *
	 * @since 5.0.0
	 *
	 * @see register_rest_route()
	 */
	public function register_routes() {
		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;parent_base . &#039;/(?P&lt;id&gt;[\d]+)/&#039; . $this-&gt;rest_base,
			array(
				&#039;args&#039;   =&gt; array(
					&#039;parent&#039; =&gt; array(
						&#039;description&#039; =&gt; __( &#039;The ID for the parent of the autosave.&#039; ),
						&#039;type&#039;        =&gt; &#039;integer&#039;,
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_items&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;get_items_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;get_collection_params(),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::CREATABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;create_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this, &#039;create_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; $this-&gt;parent_controller-&gt;get_endpoint_args_for_item_schema( WP_REST_Server::EDITABLE ),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);

		register_rest_route(
			$this-&gt;namespace,
			&#039;/&#039; . $this-&gt;parent_base . &#039;/(?P&lt;parent&gt;[\d]+)/&#039; . $this-&gt;rest_base . &#039;/(?P&lt;id&gt;[\d]+)&#039;,
			array(
				&#039;args&#039;   =&gt; array(
					&#039;parent&#039; =&gt; array(
						&#039;description&#039; =&gt; __( &#039;The ID for the parent of the autosave.&#039; ),
						&#039;type&#039;        =&gt; &#039;integer&#039;,
					),
					&#039;id&#039;     =&gt; array(
						&#039;description&#039; =&gt; __( &#039;The ID for the autosave.&#039; ),
						&#039;type&#039;        =&gt; &#039;integer&#039;,
					),
				),
				array(
					&#039;methods&#039;             =&gt; WP_REST_Server::READABLE,
					&#039;callback&#039;            =&gt; array( $this, &#039;get_item&#039; ),
					&#039;permission_callback&#039; =&gt; array( $this-&gt;revisions_controller, &#039;get_item_permissions_check&#039; ),
					&#039;args&#039;                =&gt; array(
						&#039;context&#039; =&gt; $this-&gt;get_context_param( array( &#039;default&#039; =&gt; &#039;view&#039; ) ),
					),
				),
				&#039;schema&#039; =&gt; array( $this, &#039;get_public_item_schema&#039; ),
			)
		);
	}

	/**
	 * Get the parent post.
	 *
	 * @since 5.0.0
	 *
	 * @param int $parent_id Supplied ID.
	 * @return WP_Post|WP_Error Post object if ID is valid, WP_Error otherwise.
	 */
	protected function get_parent( $parent_id ) {
		return $this-&gt;revisions_controller-&gt;get_parent( $parent_id );
	}

	/**
	 * Checks if a given request has access to get autosaves.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has read access, WP_Error object otherwise.
	 */
	public function get_items_permissions_check( $request ) {
		$parent = $this-&gt;get_parent( $request[&#039;id&#039;] );
		if ( is_wp_error( $parent ) ) {
			return $parent;
		}

		if ( ! current_user_can( &#039;edit_post&#039;, $parent-&gt;ID ) ) {
			return new WP_Error(
				&#039;rest_cannot_read&#039;,
				__( &#039;Sorry, you are not allowed to view autosaves of this post.&#039; ),
				array( &#039;status&#039; =&gt; rest_authorization_required_code() )
			);
		}

		return true;
	}

	/**
	 * Checks if a given request has access to create an autosave revision.
	 *
	 * Autosave revisions inherit permissions from the parent post,
	 * check if the current user has permission to edit the post.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return true|WP_Error True if the request has access to create the item, WP_Error object otherwise.
	 */
	public function create_item_permissions_check( $request ) {
		$id = $request-&gt;get_param( &#039;id&#039; );

		if ( empty( $id ) ) {
			return new WP_Error(
				&#039;rest_post_invalid_id&#039;,
				__( &#039;Invalid item ID.&#039; ),
				array( &#039;status&#039; =&gt; 404 )
			);
		}

		return $this-&gt;parent_controller-&gt;update_item_permissions_check( $request );
	}

	/**
	 * Creates, updates or deletes an autosave revision.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function create_item( $request ) {

		if ( ! defined( &#039;WP_RUN_CORE_TESTS&#039; ) &amp;&amp; ! defined( &#039;DOING_AUTOSAVE&#039; ) ) {
			define( &#039;DOING_AUTOSAVE&#039;, true );
		}

		$post = $this-&gt;get_parent( $request[&#039;id&#039;] );

		if ( is_wp_error( $post ) ) {
			return $post;
		}

		$prepared_post     = $this-&gt;parent_controller-&gt;prepare_item_for_database( $request );
		$prepared_post-&gt;ID = $post-&gt;ID;
		$user_id           = get_current_user_id();

		// We need to check post lock to ensure the original author didn&#039;t leave their browser tab open.
		if ( ! function_exists( &#039;wp_check_post_lock&#039; ) ) {
			require_once ABSPATH . &#039;wp-admin/includes/post.php&#039;;
		}

		$post_lock = wp_check_post_lock( $post-&gt;ID );
		$is_draft  = &#039;draft&#039; === $post-&gt;post_status || &#039;auto-draft&#039; === $post-&gt;post_status;

		if ( $is_draft &amp;&amp; (int) $post-&gt;post_author === $user_id &amp;&amp; ! $post_lock ) {
			/*
			 * Draft posts for the same author: autosaving updates the post and does not create a revision.
			 * Convert the post object to an array and add slashes, wp_update_post() expects escaped array.
			 */
			$autosave_id = wp_update_post( wp_slash( (array) $prepared_post ), true );
		} else {
			// Non-draft posts: create or update the post autosave. Pass the meta data.
			$autosave_id = $this-&gt;create_post_autosave( (array) $prepared_post, (array) $request-&gt;get_param( &#039;meta&#039; ) );
		}

		if ( is_wp_error( $autosave_id ) ) {
			return $autosave_id;
		}

		$autosave = get_post( $autosave_id );
		$request-&gt;set_param( &#039;context&#039;, &#039;edit&#039; );

		$response = $this-&gt;prepare_item_for_response( $autosave, $request );
		$response = rest_ensure_response( $response );

		return $response;
	}

	/**
	 * Get the autosave, if the ID is valid.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_Post|WP_Error Revision post object if ID is valid, WP_Error otherwise.
	 */
	public function get_item( $request ) {
		$parent_id = (int) $request-&gt;get_param( &#039;parent&#039; );

		if ( $parent_id &lt;= 0 ) {
			return new WP_Error(
				&#039;rest_post_invalid_id&#039;,
				__( &#039;Invalid post parent ID.&#039; ),
				array( &#039;status&#039; =&gt; 404 )
			);
		}

		$autosave = wp_get_post_autosave( $parent_id );

		if ( ! $autosave ) {
			return new WP_Error(
				&#039;rest_post_no_autosave&#039;,
				__( &#039;There is no autosave revision for this post.&#039; ),
				array( &#039;status&#039; =&gt; 404 )
			);
		}

		$response = $this-&gt;prepare_item_for_response( $autosave, $request );
		return $response;
	}

	/**
	 * Gets a collection of autosaves using wp_get_post_autosave.
	 *
	 * Contains the user&#039;s autosave, for empty if it doesn&#039;t exist.
	 *
	 * @since 5.0.0
	 *
	 * @param WP_REST_Request $request Full details about the request.
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_items( $request ) {
		$parent = $this-&gt;get_parent( $request[&#039;id&#039;] );
		if ( is_wp_error( $parent ) ) {
			return $parent;
		}

		if ( $request-&gt;is_method( &#039;HEAD&#039; ) ) {
			// Return early as this handler doesn&#039;t add any response headers.
			return new WP_REST_Response( array() );
		}
		$response  = array();
		$parent_id = $parent-&gt;ID;
		$revisions = wp_get_post_revisions( $parent_id, array( &#039;check_enabled&#039; =&gt; false ) );

		foreach ( $revisions as $revision ) {
			if ( str_contains( $revision-&gt;post_name, &quot;{$parent_id}-autosave&quot; ) ) {
				$data       = $this-&gt;prepare_item_for_response( $revision, $request );
				$response[] = $this-&gt;prepare_response_for_collection( $data );
			}
		}

		return rest_ensure_response( $response );
	}


	/**
	 * Retrieves the autosave&#039;s schema, conforming to JSON Schema.
	 *
	 * @since 5.0.0
	 *
	 * @return array Item schema data.
	 */
	public function get_item_schema() {
		if ( $this-&gt;schema ) {
			return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
		}

		$schema = $this-&gt;revisions_controller-&gt;get_item_schema();

		$schema[&#039;properties&#039;][&#039;preview_link&#039;] = array(
			&#039;description&#039; =&gt; __( &#039;Preview link for the post.&#039; ),
			&#039;type&#039;        =&gt; &#039;string&#039;,
			&#039;format&#039;      =&gt; &#039;uri&#039;,
			&#039;context&#039;     =&gt; array( &#039;edit&#039; ),
			&#039;readonly&#039;    =&gt; true,
		);

		$this-&gt;schema = $schema;

		return $this-&gt;add_additional_fields_schema( $this-&gt;schema );
	}

	/**
	 * Creates autosave for the specified post.
	 *
	 * From wp-admin/post.php.
	 *
	 * @since 5.0.0
	 * @since 6.4.0 The `$meta` parameter was added.
	 *
	 * @param array $post_data Associative array containing the post data.
	 * @param array $meta      Associative array containing the post meta data.
	 * @return mixed The autosave revision ID or WP_Error.
	 */
	public function create_post_autosave( $post_data, array $meta = array() ) {

		$post_id = (int) $post_data[&#039;ID&#039;];
		$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-&gt;$field ) ) {
				$autosave_is_different = true;
				break;
			}
		}

		// Check if meta values have changed.
		if ( ! empty( $meta ) ) {
			$revisioned_meta_keys = wp_post_revision_meta_keys( $post-&gt;post_type );
			foreach ( $revisioned_meta_keys as $meta_key ) {
				// get_metadata_raw is used to avoid retrieving the default value.
				$old_meta = get_metadata_raw( &#039;post&#039;, $post_id, $meta_key, true );
				$new_meta = isset( $meta[ $meta_key ] ) ? $meta[ $meta_key ] : &#039;&#039;;

				if ( $new_meta !== $old_meta ) {
					$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 &amp;&amp; $old_autosave ) {
			// Nothing to save, return the existing autosave.
			return $old_autosave-&gt;ID;
		}

		if ( $old_autosave ) {
			$new_autosave[&#039;ID&#039;]          = $old_autosave-&gt;ID;
			$new_autosave[&#039;post_author&#039;] = $user_id;

			/** This filter is documented in wp-admin/post.php */
			do_action( &#039;wp_creating_autosave&#039;, $new_autosave );

			// wp_update_post() expects escaped array.
			$revision_id = wp_update_post( wp_slash( $new_autosave ) );
		} else {
			// Create the new autosave as a special post revision.
			$revision_id = _wp_put_post_revision( $post_data, true );
		}

		if ( is_wp_error( $revision_id ) || 0 === $revision_id ) {
			return $revision_id;
		}

		// Attached any passed meta values that have revisions enabled.
		if ( ! empty( $meta ) ) {
			foreach ( $revisioned_meta_keys as $meta_key ) {
				if ( isset( $meta[ $meta_key ] ) ) {
					update_metadata( &#039;post&#039;, $revision_id, $meta_key, wp_slash( $meta[ $meta_key ] ) );
				}
			}
		}

		return $revision_id;
	}

	/**
	 * Prepares the revision for the REST response.
	 *
	 * @since 5.0.0
	 * @since 5.9.0 Renamed `$post` to `$item` to match parent class for PHP 8 named parameter support.
	 *
	 * @param WP_Post         $item    Post revision object.
	 * @param WP_REST_Request $request Request object.
	 * @return WP_REST_Response Response object.
	 */
	public function prepare_item_for_response( $item, $request ) {
		// Restores the more descriptive, specific name for use within this method.
		$post = $item;

		// Don&#039;t prepare the response body for HEAD requests.
		if ( $request-&gt;is_method( &#039;HEAD&#039; ) ) {
			/** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php */
			return apply_filters( &#039;rest_prepare_autosave&#039;, new WP_REST_Response( array() ), $post, $request );
		}
		$response = $this-&gt;revisions_controller-&gt;prepare_item_for_response( $post, $request );
		$fields   = $this-&gt;get_fields_for_response( $request );

		if ( in_array( &#039;preview_link&#039;, $fields, true ) ) {
			$parent_id          = wp_is_post_autosave( $post );
			$preview_post_id    = false === $parent_id ? $post-&gt;ID : $parent_id;
			$preview_query_args = array();

			if ( false !== $parent_id ) {
				$preview_query_args[&#039;preview_id&#039;]    = $parent_id;
				$preview_query_args[&#039;preview_nonce&#039;] = wp_create_nonce( &#039;post_preview_&#039; . $parent_id );
			}

			$response-&gt;data[&#039;preview_link&#039;] = get_preview_post_link( $preview_post_id, $preview_query_args );
		}

		$context        = ! empty( $request[&#039;context&#039;] ) ? $request[&#039;context&#039;] : &#039;view&#039;;
		$response-&gt;data = $this-&gt;add_additional_fields_to_object( $response-&gt;data, $request );
		$response-&gt;data = $this-&gt;filter_response_by_context( $response-&gt;data, $context );

		/**
		 * Filters a revision returned from the REST API.
		 *
		 * Allows modification of the revision right before it is returned.
		 *
		 * @since 5.0.0
		 *
		 * @param WP_REST_Response $response The response object.
		 * @param WP_Post          $post     The original revision object.
		 * @param WP_REST_Request  $request  Request used to generate the response.
		 */
		return apply_filters( &#039;rest_prepare_autosave&#039;, $response, $post, $request );
	}

	/**
	 * Retrieves the query params for the autosaves collection.
	 *
	 * @since 5.0.0
	 *
	 * @return array Collection parameters.
	 */
	public function get_collection_params() {
		return array(
			&#039;context&#039; =&gt; $this-&gt;get_context_param( array( &#039;default&#039; =&gt; &#039;view&#039; ) ),
		);
	}
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fwp-includes%2Frest-api%2Fendpoints">← Назад к списку файлов</a></p>