enmi-conf.org: comparison wp/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

equal deleted inserted replaced

-:48c4eec2b7e6
+:8c2e4d02f4ef
 		// Grant access if the post is publicly viewable.
 		if ( is_post_publicly_viewable( $post ) ) {
 			return true;
 		}
-		// Otherwise grant access if the post is readable by the logged in user.
+		// Otherwise grant access if the post is readable by the logged-in user.
 		if ( current_user_can( 'read_post', $post->ID ) ) {
 			return true;
 		}
 		// Otherwise, deny access.
 	/**
 	 * Retrieves terms associated with a taxonomy.
 	 *
 	 * @since 4.7.0
+	 * @since 6.8.0 Respect default query arguments set for the taxonomy upon registration.
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
 	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
 	 */
 	public function get_items( $request ) {
 					$prepared_args['parent'] = $request['parent'];
 				}
 			}
 		}
+		/*
+		 * When a taxonomy is registered with an 'args' array,
+		 * those params override the `$args` passed to this function.
+		 *
+		 * We only need to do this if no `post` argument is provided.
+		 * Otherwise, terms will be fetched using `wp_get_object_terms()`,
+		 * which respects the default query arguments set for the taxonomy.
+		 */
+		if (
+			empty( $prepared_args['post'] ) &&
+			isset( $taxonomy_obj->args ) &&
+			is_array( $taxonomy_obj->args )
+		) {
+			$prepared_args = array_merge( $prepared_args, $taxonomy_obj->args );
+		}
+		$is_head_request = $request->is_method( 'HEAD' );
+		if ( $is_head_request ) {
+			// Force the 'fields' argument. For HEAD requests, only term IDs are required.
+			$prepared_args['fields'] = 'ids';
+			// Disable priming term meta for HEAD requests to improve performance.
+			$prepared_args['update_term_meta_cache'] = false;
+		}
 		/**
 		 * Filters get_terms() arguments when querying terms via the REST API.
 		 *
 		 * The dynamic portion of the hook name, `$this->taxonomy`, refers to the taxonomy slug.
 		 *
 		// wp_count_terms() can return a falsey value when the term has no children.
 		if ( ! $total_terms ) {
 			$total_terms = 0;
 		}
-		$response = array();
+		if ( ! $is_head_request ) {
+			$response = array();
-		foreach ( $query_result as $term ) {
+			foreach ( $query_result as $term ) {
-			$data       = $this->prepare_item_for_response( $term, $request );
+				$data       = $this->prepare_item_for_response( $term, $request );
-			$response[] = $this->prepare_response_for_collection( $data );
+				$response[] = $this->prepare_response_for_collection( $data );
-		}
+			}
+		}
-		$response = rest_ensure_response( $response );
+		$response = $is_head_request ? new WP_REST_Response( array() ) : rest_ensure_response( $response );
 		// Store pagination values for headers.
 		$per_page = (int) $prepared_args['number'];
 		$page     = (int) ceil( ( ( (int) $prepared_args['offset'] ) / $per_page ) + 1 );
 	 * Checks if a request has access to create a term.
 	 *
 	 * @since 4.7.0
 	 *
 	 * @param WP_REST_Request $request Full details about the request.
-	 * @return true|WP_Error True if the request has access to create items, false or WP_Error object otherwise.
+	 * @return bool|WP_Error True if the request has access to create items, otherwise false or WP_Error object.
 	 */
 	public function create_item_permissions_check( $request ) {
 		if ( ! $this->check_is_taxonomy_allowed( $this->taxonomy ) ) {
 			return false;
 	 * @param WP_Term         $item    Term object.
 	 * @param WP_REST_Request $request Request object.
 	 * @return WP_REST_Response Response object.
 	 */
 	public function prepare_item_for_response( $item, $request ) {
+		// Don't prepare the response body for HEAD requests.
+		if ( $request->is_method( 'HEAD' ) ) {
+			/** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php */
+			return apply_filters( "rest_prepare_{$this->taxonomy}", new WP_REST_Response( array() ), $item, $request );
+		}
 		$fields = $this->get_fields_for_response( $request );
 		$data   = array();
 		if ( in_array( 'id', $fields, true ) ) {

changeset 22	8c2e4d02f4ef
parent 21	48c4eec2b7e6