WP_REST_Term_Search_Handler

17class WP_REST_Term_Search_Handler extends WP_REST_Search_Handler {18 19	/**20	 * Constructor.21	 *22	 * @since 5.6.023	 */24	public function __construct() {25		$this->type = 'term';26 27		$this->subtypes = array_values(28			get_taxonomies(29				array(30					'public'       => true,31					'show_in_rest' => true,32				),33				'names'34			)35		);36	}37 38	/**39	 * Searches terms for a given search request.40	 *41	 * @since 5.6.042	 *43	 * @param WP_REST_Request $request Full REST request.44	 * @return array {45	 *     Associative array containing found IDs and total count for the matching search results.46	 *47	 *     @type int[]               $ids   Found term IDs.48	 *     @type string|int|WP_Error $total Numeric string containing the number of terms in that49	 *                                      taxonomy, 0 if there are no results, or WP_Error if50	 *                                      the requested taxonomy does not exist.51	 * }52	 */53	public function search_items( WP_REST_Request $request ) {54		$taxonomies = $request[ WP_REST_Search_Controller::PROP_SUBTYPE ];55		if ( in_array( WP_REST_Search_Controller::TYPE_ANY, $taxonomies, true ) ) {56			$taxonomies = $this->subtypes;57		}58 59		$page     = (int) $request['page'];60		$per_page = (int) $request['per_page'];61 62		$query_args = array(63			'taxonomy'   => $taxonomies,64			'hide_empty' => false,65			'offset'     => ( $page - 1 ) * $per_page,66			'number'     => $per_page,67		);68 69		if ( ! empty( $request['search'] ) ) {70			$query_args['search'] = $request['search'];71		}72 73		if ( ! empty( $request['exclude'] ) ) {74			$query_args['exclude'] = $request['exclude'];75		}76 77		if ( ! empty( $request['include'] ) ) {78			$query_args['include'] = $request['include'];79		}80 81		/**82		 * Filters the query arguments for a REST API term search request.83		 *84		 * Enables adding extra arguments or setting defaults for a term search request.85		 *86		 * @since 5.6.087		 *88		 * @param array           $query_args Key value array of query var to query value.89		 * @param WP_REST_Request $request    The request used.90		 */91		$query_args = apply_filters( 'rest_term_search_query', $query_args, $request );92 93		$query       = new WP_Term_Query();94		$found_terms = $query->query( $query_args );95		$found_ids   = wp_list_pluck( $found_terms, 'term_id' );96