WP_REST_Posts_Controller::handle_featured_media() │ protected │ WP 4.7.0

Determines the featured media based on a request param.

Метод класса: WP_REST_Posts_Controller{}

Хуков нет.

Возвращает

true|false|WP_Error. Whether the post thumbnail was successfully deleted, otherwise WP_Error.

Использование

// protected - в коде основоного (родительского) или дочернего класса
$result = $this->handle_featured_media( $featured_media, $post_id );
$featured_media(int) (обязательный)
Featured Media ID.
$post_id(int) (обязательный)
Post ID.

Список изменений

С версии 4.7.0 Введена.

Код WP_REST_Posts_Controller::handle_featured_media() WP 6.5.2

wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php 
protected function handle_featured_media( $featured_media, $post_id ) {

	$featured_media = (int) $featured_media;
	if ( $featured_media ) {
		$result = set_post_thumbnail( $post_id, $featured_media );
		if ( $result ) {
			return true;
		} else {
			return new WP_Error(
				'rest_invalid_featured_media',
				__( 'Invalid featured media ID.' ),
				array( 'status' => 400 )
			);
		}
	} else {
		return delete_post_thumbnail( $post_id );
	}
}