# get_query_template()

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

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

## Сигнатура

```php
get_query_template( string $type, string[] $templates = array() ): string
```

## Описание

Используется для быстрого получения пути к шаблону без указания расширения файла. Также проверяет родительскую тему, если файл существует, с помощью locate_template() . Позволяет более обобщённо определять расположение шаблона без использования других функций get_*_template() .

## Параметры

- `$type` `string` — обязательный. Имя файла без расширения.
- `$templates` `string[]` — необязательный, по умолчанию `array()`. Необязательный список возможных шаблонов.

## Возвращаемое значение

`string`

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

Файл: `wp-includes/template.php:23`

```php
function get_query_template( $type, $templates = array() ) {
	$type = preg_replace( '|[^a-z0-9-]+|', '', $type );

	if ( empty( $templates ) ) {
		$templates = array( "{$type}.php" );
	}

	/**
	 * Filters the list of template filenames that are searched for when retrieving a template to use.
	 *
	 * The dynamic portion of the hook name, `$type`, refers to the filename -- minus the file
	 * extension and any non-alphanumeric characters delimiting words -- of the file to load.
	 * The last element in the array should always be the fallback template for this query type.
	 *
	 * Possible hook names include:
	 *
	 *  - `404_template_hierarchy`
	 *  - `archive_template_hierarchy`
	 *  - `attachment_template_hierarchy`
	 *  - `author_template_hierarchy`
	 *  - `category_template_hierarchy`
	 *  - `date_template_hierarchy`
	 *  - `embed_template_hierarchy`
	 *  - `frontpage_template_hierarchy`
	 *  - `home_template_hierarchy`
	 *  - `index_template_hierarchy`
	 *  - `page_template_hierarchy`
	 *  - `paged_template_hierarchy`
	 *  - `privacypolicy_template_hierarchy`
	 *  - `search_template_hierarchy`
	 *  - `single_template_hierarchy`
	 *  - `singular_template_hierarchy`
	 *  - `tag_template_hierarchy`
	 *  - `taxonomy_template_hierarchy`
	 *
	 * @since 4.7.0
	 *
	 * @param string[] $templates A list of template candidates, in descending order of priority.
	 */
	$templates = apply_filters( "{$type}_template_hierarchy", $templates );

	$template = locate_template( $templates );

	$template = locate_block_template( $template, $type, $templates );

	/**
	 * Filters the path of the queried template by type.
	 *
	 * The dynamic portion of the hook name, `$type`, refers to the filename -- minus the file
	 * extension and any non-alphanumeric characters delimiting words -- of the file to load.
	 * This hook also applies to various types of files loaded as part of the Template Hierarchy.
	 *
	 * Possible hook names include:
	 *
	 *  - `404_template`
	 *  - `archive_template`
	 *  - `attachment_template`
	 *  - `author_template`
	 *  - `category_template`
	 *  - `date_template`
	 *  - `embed_template`
	 *  - `frontpage_template`
	 *  - `home_template`
	 *  - `index_template`
	 *  - `page_template`
	 *  - `paged_template`
	 *  - `privacypolicy_template`
	 *  - `search_template`
	 *  - `single_template`
	 *  - `singular_template`
	 *  - `tag_template`
	 *  - `taxonomy_template`
	 *
	 * @since 1.5.0
	 * @since 4.8.0 The `$type` and `$templates` parameters were added.
	 *
	 * @param string   $template  Path to the template. See locate_template().
	 * @param string   $type      Sanitized filename without extension.
	 * @param string[] $templates A list of template candidates, in descending order of priority.
	 */
	return apply_filters( "{$type}_template", $template, $type, $templates );
}
```

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

- 1.5.0 — Introduced.

## Связанные

Использует: [`locate_block_template`](https://chugunov.pro/api-wordpress/functions/locate_block_template/), [`locate_template`](https://chugunov.pro/api-wordpress/functions/locate_template/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`get_privacy_policy_template`](https://chugunov.pro/api-wordpress/functions/get_privacy_policy_template/), [`get_embed_template`](https://chugunov.pro/api-wordpress/functions/get_embed_template/), [`get_singular_template`](https://chugunov.pro/api-wordpress/functions/get_singular_template/), [`get_search_template`](https://chugunov.pro/api-wordpress/functions/get_search_template/), [`get_single_template`](https://chugunov.pro/api-wordpress/functions/get_single_template/), [`get_attachment_template`](https://chugunov.pro/api-wordpress/functions/get_attachment_template/), [`get_paged_template`](https://chugunov.pro/api-wordpress/functions/get_paged_template/), [`get_index_template`](https://chugunov.pro/api-wordpress/functions/get_index_template/), [`get_404_template`](https://chugunov.pro/api-wordpress/functions/get_404_template/), [`get_archive_template`](https://chugunov.pro/api-wordpress/functions/get_archive_template/), [`get_author_template`](https://chugunov.pro/api-wordpress/functions/get_author_template/), [`get_category_template`](https://chugunov.pro/api-wordpress/functions/get_category_template/), [`get_tag_template`](https://chugunov.pro/api-wordpress/functions/get_tag_template/), [`get_taxonomy_template`](https://chugunov.pro/api-wordpress/functions/get_taxonomy_template/), [`get_date_template`](https://chugunov.pro/api-wordpress/functions/get_date_template/), [`get_home_template`](https://chugunov.pro/api-wordpress/functions/get_home_template/), [`get_front_page_template`](https://chugunov.pro/api-wordpress/functions/get_front_page_template/), [`get_page_template`](https://chugunov.pro/api-wordpress/functions/get_page_template/).

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