# wp_filter_pre_oembed_result()

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

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

## Сигнатура

```php
wp_filter_pre_oembed_result( null|string $result, string $url, array $args ): null|string
```

## Описание

Если URL принадлежит текущему сайту, результат получается напрямую, минуя процесс обнаружения oEmbed.

## Параметры

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

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

`null|string`

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

Файл: `wp-includes/embed.php:1267`

```php
function wp_filter_pre_oembed_result( $result, $url, $args ) {
	$data = get_oembed_response_data_for_url( $url, $args );

	if ( $data ) {
		return _wp_oembed_get_object()->data2html( $data, $url );
	}

	return $result;
}
```

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

- 4.5.3 — Introduced.

## Связанные

Использует: [`get_oembed_response_data_for_url`](https://chugunov.pro/api-wordpress/functions/get_oembed_response_data_for_url/), [`_wp_oembed_get_object`](https://chugunov.pro/api-wordpress/functions/_wp_oembed_get_object/), `WP_oEmbed`.

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