# _wp_ajax_menu_quick_search()

URL: https://chugunov.pro/api-wordpress/functions/_wp_ajax_menu_quick_search/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
_wp_ajax_menu_quick_search( array $request = array() )
```

## Описание

Выводит соответствующий ответ на быстрый поиск по меню.

## Параметры

- `$request` `array` — необязательный, по умолчанию `array()`. Неочищенные значения запроса.

## Исходный код

Файл: `wp-admin/includes/nav-menu.php:23`

```php
function _wp_ajax_menu_quick_search( $request = array() ) {
	$args            = array();
	$type            = $request['type'] ?? '';
	$object_type     = $request['object_type'] ?? '';
	$query           = $request['q'] ?? '';
	$response_format = $request['response-format'] ?? '';

	if ( ! $response_format || ! in_array( $response_format, array( 'json', 'markup' ), true ) ) {
		$response_format = 'json';
	}

	if ( 'markup' === $response_format ) {
		$args['walker'] = new Walker_Nav_Menu_Checklist();
	}

	if ( 'get-post-item' === $type ) {
		if ( post_type_exists( $object_type ) ) {
			if ( isset( $request['ID'] ) ) {
				$object_id = (int) $request['ID'];

				if ( 'markup' === $response_format ) {
					echo walk_nav_menu_tree(
						array_map( 'wp_setup_nav_menu_item', array( get_post( $object_id ) ) ),
						0,
						(object) $args
					);
				} elseif ( 'json' === $response_format ) {
					echo wp_json_encode(
						array(
							'ID'         => $object_id,
							'post_title' => get_the_title( $object_id ),
							'post_type'  => get_post_type( $object_id ),
						)
					);
					echo "\n";
				}
			}
		} elseif ( taxonomy_exists( $object_type ) ) {
			if ( isset( $request['ID'] ) ) {
				$object_id = (int) $request['ID'];

				if ( 'markup' === $response_format ) {
					echo walk_nav_menu_tree(
						array_map( 'wp_setup_nav_menu_item', array( get_term( $object_id, $object_type ) ) ),
						0,
						(object) $args
					);
				} elseif ( 'json' === $response_format ) {
					$post_obj = get_term( $object_id, $object_type );
					echo wp_json_encode(
						array(
							'ID'         => $object_id,
							'post_title' => $post_obj->name,
							'post_type'  => $object_type,
						)
					);
					echo "\n";
				}
			}
		}
	} elseif ( preg_match( '/quick-search-(posttype|taxonomy)-([a-zA-Z0-9_-]*\b)/', $type, $matches ) ) {
		if ( 'posttype' === $matches[1] && get_post_type_object( $matches[2] ) ) {
			$post_type_obj = _wp_nav_menu_meta_box_object( get_post_type_object( $matches[2] ) );
			$query_args    = array(
				'no_found_rows'          => true,
				'update_post_meta_cache' => false,
				'update_post_term_cache' => false,
				'posts_per_page'         => 10,
				'post_type'              => $matches[2],
				's'                      => $query,
				'search_columns'         => array( 'post_title' ),
			);
			/**
			 * Filter the menu quick search arguments.
			 *
			 * @since 6.9.0
			 *
			 * @param array $args {
			 *     Menu quick search arguments.
			 *
			 *     @type boolean      $no_found_rows          Whether to return found rows data. Default true.
			 *     @type boolean      $update_post_meta_cache Whether to update post meta cache. Default false.
			 *     @type boolean      $update_post_term_cache Whether to update post term cache. Default false.
			 *     @type int          $posts_per_page         Number of posts to return. Default 10.
			 *     @type string       $post_type              Type of post to return.
			 *     @type string       $s                      Search query.
			 *     @type array        $search_columns         Which post table columns to query.
			 * }
			*/
			$query_args = apply_filters( 'wp_ajax_menu_quick_search_args', $query_args );
			$args       = array_merge( $args, $query_args );

			if ( isset( $post_type_obj->_default_query ) ) {
				$args = array_merge( $args, (array) $post_type_obj->_default_query );
			}

			$search_results_query = new WP_Query( $args );
			if ( ! $search_results_query->have_posts() ) {
				return;
			}

			while ( $search_results_query->have_posts() ) {
				$post = $search_results_query->next_post();

				if ( 'markup' === $response_format ) {
					$var_by_ref = $post->ID;
					echo walk_nav_menu_tree(
						array_map( 'wp_setup_nav_menu_item', array( get_post( $var_by_ref ) ) ),
						0,
						(object) $args
					);
				} elseif ( 'json' === $response_format ) {
					echo wp_json_encode(
						array(
							'ID'         => $post->ID,
							'post_title' => get_the_title( $post->ID ),
							'post_type'  => $matches[2],
						)
					);
					echo "\n";
				}
			}
		} elseif ( 'taxonomy' === $matches[1] ) {
			$terms = get_terms(
				array(
					'taxonomy'   => $matches[2],
					'name__like' => $query,
					'number'     => 10,
					'hide_empty' => false,
				)
			);

			if ( empty( $terms ) || is_wp_error( $terms ) ) {
				return;
			}

			foreach ( (array) $terms as $term ) {
				if ( 'markup' === $response_format ) {
					echo walk_nav_menu_tree(
						array_map( 'wp_setup_nav_menu_item', array( $term ) ),
						0,
						(object) $args
					);
				} elseif ( 'json' === $response_format ) {
					echo wp_json_encode(
						array(
							'ID'         => $term->term_id,
							'post_title' => $term->name,
							'post_type'  => $matches[2],
						)
					);
					echo "\n";
				}
			}
		}
	}
}
```

## История изменений

- 3.0.0 — Introduced.

## Связанные

Использует: `Walker_Nav_Menu_Checklist::__construct`, [`_wp_nav_menu_meta_box_object`](https://chugunov.pro/api-wordpress/functions/_wp_nav_menu_meta_box_object/), `WP_Query::__construct`, [`get_terms`](https://chugunov.pro/api-wordpress/functions/get_terms/), [`taxonomy_exists`](https://chugunov.pro/api-wordpress/functions/taxonomy_exists/), [`walk_nav_menu_tree`](https://chugunov.pro/api-wordpress/functions/walk_nav_menu_tree/), [`get_the_title`](https://chugunov.pro/api-wordpress/functions/get_the_title/), [`post_type_exists`](https://chugunov.pro/api-wordpress/functions/post_type_exists/), [`get_post_type`](https://chugunov.pro/api-wordpress/functions/get_post_type/), [`wp_json_encode`](https://chugunov.pro/api-wordpress/functions/wp_json_encode/), [`get_term`](https://chugunov.pro/api-wordpress/functions/get_term/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/), [`get_post_type_object`](https://chugunov.pro/api-wordpress/functions/get_post_type_object/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: [`wp_ajax_menu_quick_search`](https://chugunov.pro/api-wordpress/functions/wp_ajax_menu_quick_search/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_wp_ajax_menu_quick_search/