Когда любой сайт является поставщиком oEmbed, он добавляет метку об этом в <head> часть HTML документа. Пример таких метатегов:
<link rel="alternate" type="application/json+oembed" href="/api/oembed/1.0/embed?url=https%3A%2F%2Fwp-kama.ru%2Fhandbook%2Fcodex%2Foembed" /> <link rel="alternate" type="text/xml+oembed" href="/api/oembed/1.0/embed?url=https%3A%2F%2Fwp-kama.ru%2Fhandbook%2Fcodex%2Foembed&format=xml" />
Т.е. каждый поставщик oEmbed должен иметь такие метатеги, чтобы уведомить всех, что текущая страница может быть встроена на другом сайте.
Когда мы добавляем любой URL в контент нашего сайта, WordPress проверяет является ли этот URL одним из зарегистрированных поставщиков oEmbed (например YouTube), если является, то код встраивания создается по известной логике для этого URL, но вот если не является, то наш WP может пройти по URL и посмотреть есть ли в HTML метки что URL можно встроить.
Так вот, этот Хук позволяет включить или отключить такую проверку HTML мета-тега. Т.е. если в хуке вернуть false
, то такая проверка делаться не будет для неизвестных URL. Таким образом, если мы вставим в контент URL, который неизвестен WP, то он никак не будет проверятся и просто будет выведен в контенте как есть.