# pre_oembed_result

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

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

## Сигнатура

```php
apply_filters( 'pre_oembed_result', null|string $result, string $url, string|array $args )
```

## Описание

Это позволяет прервать стандартную логику, например заменив её процедурой, более оптимальной для вашей конфигурации.
Возврат из фильтра значения, отличного от null, фактически прерывает получение и возвращает переданное значение вместо результата.

## Параметры

- `$result` `null|string` — обязательный. НЕОЧИЩЕННЫЙ (и потенциально небезопасный) HTML, который следует использовать для встраивания.
  
  Значение по умолчанию null — продолжить получение результата.
- `$url` `string` — обязательный. URL контента, который следует попытаться встроить.
- `$args` `string|array` — обязательный. Дополнительные аргументы для получения HTML для встраивания.
  
  Допустимые аргументы описаны в wp_oembed_get(). Значение по умолчанию — пустое.

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

НЕОЧИЩЕННЫЙ (и потенциально небезопасный) HTML, который следует использовать для встраивания.

Значение по умолчанию null — продолжить получение результата.

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

Файл: `wp-includes/class-wp-oembed.php:402`

```php
$pre = apply_filters( 'pre_oembed_result', null, $url, $args );
```

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

- 4.5.3 — Introduced.

## Связанные

Используется в: `WP_oEmbed::get_html`.

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