хук-фильтр
since 4.5.3
pre_oembed_result
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'pre_oembed_result', null|string $result, string $url, string|array $args )Описание
Это позволяет прервать стандартную логику, например заменив её процедурой, более оптимальной для вашей конфигурации.
Возврат из фильтра значения, отличного от null, фактически прерывает получение и возвращает переданное значение вместо результата.
Оригинал (английский)
This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.
Returning a non-null value from the filter will effectively short-circuit retrieval and return the passed value instead.
Фильтруемое значение
НЕОЧИЩЕННЫЙ (и потенциально небезопасный) HTML, который следует использовать для встраивания.
Значение по умолчанию null — продолжить получение результата.
Параметры
$result
null|string
обязательный
НЕОЧИЩЕННЫЙ (и потенциально небезопасный) HTML, который следует использовать для встраивания.
Значение по умолчанию null — продолжить получение результата.
$url
string
обязательный
URL контента, который следует попытаться встроить.
$args
string|array
обязательный
Дополнительные аргументы для получения HTML для встраивания.
Допустимые аргументы описаны в wp_oembed_get(). Значение по умолчанию — пустое.
Исходный код
wp-includes/class-wp-oembed.php:402
$pre = apply_filters( 'pre_oembed_result', null, $url, $args );История изменений
| Версия | Описание |
|---|---|
| 4.5.3 | Introduced. |
