Title: Встраивание
Author: Dion Hulse
Published: 02.11.2018
Last modified: 05.08.2021

---

### Рубрики

 * [Все Статьи](https://ru.wordpress.org/support/articles/)
 * [Правила форумов](https://ru.wordpress.org/support/forum-rules/)

# Встраивание

Встраивать видео, изображения, твиты, аудио и другое содержимое на свой сайт WordPress
очень просто.

## Использование

Чтобы встроить видео или другой объект в запись или страницу, поместите его URL-
адрес в область содержимого. Убедитесь, что URL-адрес находится в отдельной строке
и не содержит гиперссылок (доступен для клика при просмотре сообщения).

Например:

    ```wp-block-preformatted
    Посмотрите это классное видео:http://www.youtube.com/watch?v=dQw4w9WgXcQЭто было классное видео.
    ```

WordPress автоматически превратит URL-адрес во встроенный YouTube и предоставит 
предварительный просмотр в визуальном редакторе.

Другой вариант — заключить URL-адрес в “`embed`” [шорткод](https://codex.wordpress.org/Shortcode).

    ```wp-block-preformatted
    // ПРИМЕЧАНИЕ. Удалите пробел между '[' и 'embed'.[ embed width="123" height="456"]http://www.youtube.com/watch?v=dQw4w9WgXcQ[/embed]
    ```

Если WordPress не сможет встроить URL-адрес, запись будет содержать гиперссылку 
на URL-адрес.

## oEmbed

Функция простого встраивания основана на oEmbed протоколе для сайта A (например,
вашего блога), который запрашивает у сайта B (например, YouTube) HTML-код, необходимый
для встраивания содержимого с сайта B.

oEmbed был разработан, чтобы избежать необходимости копировать и вставлять HTML 
с сайта, на котором размещен медиафайл, который вы хотите встроить. Он поддерживает
видео, изображения, текст и многое другое.

## Работает ли это с любым URL?

Нет, не по умолчанию. WordPress будет встраивать только URL-адреса, соответствующие
внутреннему белому списку. Это сделано в целях безопасности.

## Хорошо, с каких сайтов я могу встраивать?

Это работает с этими сервисами:

| **Сервис** | **Тип встраивания** | **Начиная с** | 
| [Amazon Kindle instant previews](http://amazon.com/) | Видео | [WordPress 4.9](https://codex.wordpress.org/Version_4.9) | 
| [Animoto](http://animoto.com/) | Видео | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | 
| [Blip](http://blip.tv/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [Cloudup](http://cloudup.com/) | Видео, Галереи, Изображения | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [CollegeHumor](http://collegehumor.com/) | Видео | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | 
| [Crowdsignal](https://crowdsignal.com/) | Голосования & Опросы | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | 
| [DailyMotion](http://www.dailymotion.com/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [Facebook](https://www.facebook.com/) | публикация, активность, фото, видео, медиа, вопросы, заметки | [WordPress 4.7](https://codex.wordpress.org/Version_4.7) | 
| [Flickr](http://www.flickr.com/) | Видео & Изображения | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [FunnyOrDie.com](http://www.funnyordie.com/) | Видео | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | 
| [Giphy](http://giphy.com/) | Анимированные гифки | [WordPress 4.7](https://codex.wordpress.org/Version_4.7) | 
| [Hulu](http://www.hulu.com/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [Imgur](http://imgur.com/) | Изображения | [WordPress 3.9](https://codex.wordpress.org/Version_3.9) | 
| [Instagram](http://instagram.com/) | Изображения | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | 
| [Issuu](http://issuu.com/) | Документы | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | 
| [Kickstarter](http://www.kickstarter.com/) | Проекты | [WordPress 4.2](https://codex.wordpress.org/Version_4.2) | 
| [Meetup.com](http://meetup.com/) | Разное | [WordPress 3.9](https://codex.wordpress.org/Version_3.9) | 
| [Mixcloud](http://mixcloud.com/) | Музыка | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | 
| [Photobucket](http://photobucket.com/) | Изображения | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [Reddit](http://reddit.com/) | Посты & Комментарии | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [ReverbNation](http://reverbnation.com/) | Музыка | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [Scribd](http://www.scribd.com/) | Документы | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [SlideShare](http://www.slideshare.net/) | Слайдшоу | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | 
| [SmugMug](http://www.smugmug.com/) | Разное | [WordPress 3.0](https://codex.wordpress.org/Version_3.0) | 
| [SoundCloud](http://soundcloud.com/) | Музыка | [WordPress 3.5](https://codex.wordpress.org/Version_3.5) | 
| [Speaker Deck](http://speakerdeck.com/) | Слайдшоу | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [Spotify](http://www.spotify.com/) | Музыка | [WordPress 3.6](https://codex.wordpress.org/Version_3.6) | 
| [TED](http://www.ted.com/) | Видео | [WordPress 4.0](https://codex.wordpress.org/Version_4.0) | 
| [Tumblr](http://www.tumblr.com/) | Разное | [WordPress 4.2](https://codex.wordpress.org/Version_4.2) | 
| [Twitter](http://twitter.com/) | Твит, профиль, список, коллекция, лайки, моменты | [WordPress 3.4](https://codex.wordpress.org/Version_3.4) | 
| [VideoPress](http://videopress.com/) | Видео | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [Vimeo](http://vimeo.com/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [Vine](https://vine.co/) | Видео | [WordPress 4.1](https://codex.wordpress.org/Version_4.1) | 
| [Каталог плагинов WordPress](https://ru.wordpress.org/plugins-wp/) | Плагины | [WordPress 4.4](https://codex.wordpress.org/Version_4.4) | 
| [WordPress.tv](http://wordpress.tv/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) | 
| [YouTube](http://www.youtube.com/) | Видео | [WordPress 2.9](https://codex.wordpress.org/Version_2.9) |

**Примечание**

 * Twitter — в старых версиях WordPress есть проблемы с встраиванием https, просто
   удалите s из https, чтобы исправить.
 * YouTube — только общедоступные и «не включенные в список» видео и плейлисты —«
   частные» видео не встраиваются.
 * Tumblr — распознаются только сообщения (name.tumblr.com/post/etc), а не отдельные
   изображения (name.tumblr.com/image)

## Как я могу добавить или изменить поддержку веб-сайтов?

Добавление поддержки для дополнительного веб-сайта зависит от того, поддерживает
ли сайт oEmbed.

### Добавление поддержки для сайта с поддержкой oEmbed

Если сайт поддерживает oEmbed, вам нужно вызвать [wp_oembed_add_provider()](https://codex.wordpress.org/Function_Reference/wp_oembed_add_provider),
чтобы добавить сайт и формат URL во внутренний белый список.

### Добавление поддержки для сайта без встроенного oEmbed

Вам нужно будет зарегистрировать обработчик с помощью [wp_embed_register_handler()](https://codex.wordpress.org/Function_Reference/wp_embed_register_handler)
и предоставить функцию обратного вызова, которая генерирует HTML.

### Удаление поддержки для сайта с поддержкой oEmbed

Если вы хотите удалить поставщика с поддержкой oEmbed, вам нужно вызвать [wp_oembed_remove_provider](https://codex.wordpress.org/Function_Reference/wp_oembed_remove_provider).

## А как насчет oEmbed Discovery?

Начиная с версии 4.4, WordPress поддерживает обнаружение oEmbed, но имеет серьезные
ограничения на то, какой тип содержимого может быть встроен через сайты, не внесенные
в белый список.

В частности, содержимое HTML и видео фильтруется, чтобы разрешать только ссылки,
цитаты и фреймы, и они дополнительно фильтруются для предотвращения вставки вредоносного
содержимого. Затем HTML-код модифицируется, чтобы он был изолирован, а также на 
него накладываются дополнительные ограничения безопасности.

Однако, если вы чувствуете, что достаточно уверены, чтобы не требовать этого уровня
безопасности, вы можете предоставить пользователям `unfiltered_html` (администраторам
и редакторам) возможность встраивать данные с веб-сайтов, у которых в `<head>` есть
теги обнаружения oEmbed.

Содержимое обнаруженное oEmbed для типов «ссылка» и «фото» не так сильно фильтруется,
однако оно должным образом экранируется в целях безопасности и предотвращения отображения
любого вредоносного содержимого на сайте.

## Внешние ресурсы

 * [oEmbed.com](http://oembed.com/) – Официальный сайт oEmbed с техническими подробностями
   спецификации
 * [WordPress oEmbed Providers Registration Generator](http://generatewp.com/oembed/)–
   от GenerateWP.com
 * [Easy Embeds For WordPress 2.9](http://www.viper007bond.com/2009/10/13/easy-embeds-for-wordpress-2-point-9/)–
   от Alex Mills (Viper007Bond)
 * [How to Set oEmbed Max Width in WordPress 3.5 with $content_width?](http://www.wpbeginner.com/wp-themes/how-to-set-oembed-max-width-in-wordpress-3-5-with-content_width/)–
   от wpbeginner.com