# pre_get_block_file_template

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

Тип: хук-фильтр.
Появился в версии: 5.9.0.

## Сигнатура

```php
apply_filters( 'pre_get_block_file_template', WP_Block_Template|null $block_template, string $id, string $template_type )
```

## Описание

Верните значение, отличное от null, чтобы обойти поиск файла в теме WordPress.

## Параметры

- `$block_template` `WP_Block_Template|null` — обязательный. Верните объект блочного шаблона, чтобы прервать стандартный запрос, либо null, чтобы позволить WP выполнить обычные запросы.
- `$id` `string` — обязательный. Уникальный идентификатор шаблона (пример: 'theme_slug//template_slug').
- `$template_type` `string` — обязательный. Тип шаблона. Либо 'wp_template', либо 'wp_template_part'.

## Фильтруемое значение

Верните объект блочного шаблона, чтобы прервать стандартный запрос, либо null, чтобы позволить WP выполнить обычные запросы.

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

Файл: `wp-includes/block-template-utils.php:1376`

```php
$block_template = apply_filters( 'pre_get_block_file_template', null, $id, $template_type );
```

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

- 5.9.0 — Introduced.

## Связанные

Используется в: [`get_block_file_template`](https://chugunov.pro/api-wordpress/functions/get_block_file_template/).

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