WP_REST_Posts_Controller::handle_featured_media( int $featured_media, int $post_id )

Determines the featured media based on a request param.


Description Description


Parameters Parameters

$featured_media

(int) (Required) Featured Media ID.

$post_id

(int) (Required) Post ID.


Top ↑

Return Return

(bool|WP_Error) Whether the post thumbnail was successfully deleted, otherwise WP_Error.


Top ↑

Source Source

File: 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 );
		}

	}

Top ↑

Changelog Changelog

Changelog
Version Description
4.7.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.