Описание функции wp_oembed_get()
Функция wp_oembed_get() используется для получения oEmbed-контента из заданного URL. Она позволяет интегрировать сторонние ресурсы, такие как видео, изображения и другие медиа, в записи и страницы WordPress. Функция автоматически обрабатывает и возвращает HTML-код для встраивания,
что упрощает процесс добавления медиа-контента в посты и страницы.
Параметры
$url
Тип: string
Обязательный: Да
Описание: URL, для которого требуется получить oEmbed-контент
Возможные значения:
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки запроса oEmbed
Возможные значения:
width: Ширина для встраиваемого контента
height: Высота для встраиваемого контента
Возвращаемое значение
Тип: string|false
Описание: HTML-код для встраивания oEmbed-контента или false в случае ошибки
Возможные значения:
• HTML-код контента при успешном выполнении
• false при ошибке получения oEmbed
Примеры использования
Базовый пример получения oEmbed-контента для видео на YouTube
$embed_code = wp_oembed_get('https://www.youtube.com/watch?v=dQw4w9WgXcQ');
if ($embed_code) {
echo $embed_code;
}
Выводит HTML-код для видео
Получение oEmbed-контента с установленной шириной и высотой
$args = array(
'width' => 600,
'height' => 400
);
$embed_code = wp_oembed_get('https://vimeo.com/123456789', $args);
Настраивает размеры встраиваемого видео
Безопасность
Валидация входных данных: Проверка URL на корректность
Санитизация: Входные данные очищаются перед использованием
Рекомендации: Проверяйте безопасность URL перед вызовом функции, особенно если они поступают от пользователей
— Связанные функции
Получает HTML-код oEmbed-контента
Общая функция для получения oEmbed-контента
— Хуки
Фильтрует данные, полученные от oEmbed-сервиса
Фильтрует ответ, полученный от oEmbed-сервиса
— Примечания
– Ограничения
Не все URL поддерживают oEmbed; проверьте совместимость
– Частые проблемы
- Ошибка при неправильном URL
- Проблемы с доступностью контента на стороне сервиса
