# wp_embed_register_handler()

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

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

## Сигнатура

```php
wp_embed_register_handler( string $id, string $regex, callable $callback, int $priority = 10 )
```

## Описание

Вероятно, должно использоваться только для сайтов, которые не поддерживают oEmbed.

## Параметры

- `$id` `string` — обязательный. Внутренний идентификатор или имя обработчика. Должен быть уникальным.
- `$regex` `string` — обязательный. Регулярное выражение, по которому определяется, следует ли использовать этот обработчик для URL.
- `$callback` `callable` — обязательный. Функция обратного вызова, которая будет вызвана при совпадении регулярного выражения.
- `$priority` `int` — необязательный, по умолчанию `10`. Задаёт порядок, в котором проверяются зарегистрированные обработчики.

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

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

```php
function wp_embed_register_handler( $id, $regex, $callback, $priority = 10 ) {
	global $wp_embed;
	$wp_embed->register_handler( $id, $regex, $callback, $priority );
}
```

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

- 2.9.0 — Introduced.

## Связанные

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

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