W3cubDocs

/WordPress

WP_REST_Posts_Controller::handle_template( string $template, integer $post_id, bool $validate = false )

Sets the template for a post.

Description

Parameters

$template

(string) (Required) Page template filename.

$post_id

(integer) (Required) Post ID.

$validate

(bool) (Optional) Whether to validate that the template selected is valid.

Default value: false

Source

File: wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

public function handle_template( $template, $post_id, $validate = false ) {

		if ( $validate && ! array_key_exists( $template, wp_get_theme()->get_page_templates( get_post( $post_id ) ) ) ) {
			$template = '';
		}

		update_post_meta( $post_id, '_wp_page_template', $template );
	}

Changelog

Version Description
4.9.0 Added the $validate parameter.
4.7.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_posts_controller/handle_template