WP_REST_Posts_Controller::handle_template() WordPress Method
The WP_REST_Posts_Controller::handle_template() method is used to render a WordPress post in the REST API. This method includes the post content, title, excerpt, and author information in the response.
WP_REST_Posts_Controller::handle_template( string $template, int $post_id, bool $validate = false ) #
Sets the template for a post.
Parameters
- $template
(string)(Required)Page template filename.
- $post_id
(int)(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 );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.9.0 | Added the $validate parameter. |
| 4.7.0 | Introduced. |