WP_REST_Term_Search_Handler::search_items() WordPress Method
The WP_REST_Term_Search_Handler::search_items() method is used to search for terms in a given taxonomy. The search is performed using the WP_Term_Query class, and the results are limited to 20 terms per search.
WP_REST_Term_Search_Handler::search_items( WP_REST_Request $request ) #
Searches the object type content for a given search request.
Parameters
- $request
(WP_REST_Request)(Required)Full REST request.
Return
(array) Associative array containing an WP_REST_Search_Handler::RESULT_IDS
containing an array of found IDs and WP_REST_Search_Handler::RESULT_TOTAL
containing the total count for the matching search results.
Source
File: wp-includes/rest-api/search/class-wp-rest-term-search-handler.php
public function search_items( WP_REST_Request $request ) { $taxonomies = $request[ WP_REST_Search_Controller::PROP_SUBTYPE ]; if ( in_array( WP_REST_Search_Controller::TYPE_ANY, $taxonomies, true ) ) { $taxonomies = $this->subtypes; } $page = (int) $request['page']; $per_page = (int) $request['per_page']; $query_args = array( 'taxonomy' => $taxonomies, 'hide_empty' => false, 'offset' => ( $page - 1 ) * $per_page, 'number' => $per_page, ); if ( ! empty( $request['search'] ) ) { $query_args['search'] = $request['search']; } /** * Filters the query arguments for a REST API search request. * * Enables adding extra arguments or setting defaults for a term search request. * * @since 5.6.0 * * @param array $query_args Key value array of query var to query value. * @param WP_REST_Request $request The request used. */ $query_args = apply_filters( 'rest_term_search_query', $query_args, $request ); $query = new WP_Term_Query(); $found_terms = $query->query( $query_args ); $found_ids = wp_list_pluck( $found_terms, 'term_id' ); unset( $query_args['offset'], $query_args['number'] ); $total = wp_count_terms( $query_args ); // wp_count_terms() can return a falsey value when the term has no children. if ( ! $total ) { $total = 0; } return array( self::RESULT_IDS => $found_ids, self::RESULT_TOTAL => $total, ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
5.6.0 | Introduced. |