Docs: Improve docblock for WP_REST_Template_Revisions_Controller::get_parent().

swissspidy · swissspidy · commit c8497783ffcb · 2024-05-15T11:16:24.000Z
Props rockfire. See #60699, #61113. git-svn-id: https://develop.svn.wordpress.org/trunk@58156 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-template-revisions-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-template-revisions-controller.php
@@ -156,15 +156,15 @@ public function register_routes() {
 	}
 
 	/**
-	 * Gets the parent post, if the ID is valid.
+	 * Gets the parent post, if the template ID is valid.
 	 *
 	 * @since 6.4.0
 	 *
-	 * @param int $parent_post_id Supplied ID.
+	 * @param string $parent_template_id Supplied ID.
 	 * @return WP_Post|WP_Error Post object if ID is valid, WP_Error otherwise.
 	 */
-	protected function get_parent( $parent_post_id ) {
-		$template = get_block_template( $parent_post_id, $this->parent_post_type );
+	protected function get_parent( $parent_template_id ) {
+		$template = get_block_template( $parent_template_id, $this->parent_post_type );
 
 		if ( ! $template ) {
 			return new WP_Error(

Original file line number	Diff line number	Diff line change
`@@ -156,15 +156,15 @@ public function register_routes() {`
`156`	`156`	`}`
`157`	`157`
`158`	`158`	`/**`
`159`		`- * Gets the parent post, if the ID is valid.`
	`159`	`+ * Gets the parent post, if the template ID is valid.`
`160`	`160`	`*`
`161`	`161`	`* @since 6.4.0`
`162`	`162`	`*`
`163`		`- * @param int $parent_post_id Supplied ID.`
	`163`	`+ * @param string $parent_template_id Supplied ID.`
`164`	`164`	`* @return WP_Post\|WP_Error Post object if ID is valid, WP_Error otherwise.`
`165`	`165`	`*/`
`166`		`- protected function get_parent( $parent_post_id ) {`
`167`		`- $template = get_block_template( $parent_post_id, $this->parent_post_type );`
	`166`	`+ protected function get_parent( $parent_template_id ) {`
	`167`	`+ $template = get_block_template( $parent_template_id, $this->parent_post_type );`
`168`	`168`
`169`	`169`	`if ( ! $template ) {`
`170`	`170`	`return new WP_Error(`