Embeds for YouTube：简洁快速嵌入 YouTube 视频，自动响应式，也支持播放列表等。
插件概况
“Embeds for YouTube” 其目标是在简单易用的基础上提供比较丰富的控制选项（短码、播放列表、视频信息、SEO 元数据等）。
当前版本（截至最新）是 5.4，兼容广泛的 WordPress 和 PHP 版本（一般要求 WP ≥ 4.6，PHP ≥ 7.4 等）。
核心功能
下面是这个插件比较值得注意的功能：
| 功能 | 描述 |
|---|---|
| 短码嵌入视频 | 使用 [youtube]video[/youtube] 短码，就可以插入视频。这里 video 可以是 YouTube 视频的 ID 或完整 URL。 |
| 播放列表支持 | 可以插入 YouTube 自己的播放列表，也可以自己定义一个“列表”（list）保存多个视频 ID／URL，然后通过短码调用，以不同顺序（随机、顺序、只选一个随机等方式）播放。 |
| 多种参数控制 | 在短码里或配置文件（Profile）里可以设置很多选项，比如是否自动播放（autoplay），是否显示控制栏（controls），字幕（cc），开始／结束时间（start/stop），是否响应式（responsive），视频比例（ratio）等等。 |
| 响应式／动态尺寸 | 对于响应式网站来说，可以设置视频自动适应宽度，比例自动算高度。 |
| Profiles（配置档） | 可以创建多个“Profile”来预设一组视频显示／播放参数。这样不同部分（文章内部、侧边栏、小工具 widget 等）可以使用不同风格。 |
| 视频缩略图 (Thumbnail) | 支持用短码 [youtube_thumb]id[/youtube_thumb] 插入视频缩略图，点击可跳转到 YouTube。也可指定缩略图版本（如 “medium”, “high”, “maxres” 等），以及宽度、高度等。 |
| 视频信息输出 | 有一个 vinfo 短码，可以输出视频的标题、描述、缩略图 URL 等信息（通过模板替换 %title% 等标签）。 |
| SEO 友好 | 插件支持通过 YouTube API 获取信息并把它加入输出 metadata，以利于搜索引擎识别和索引。 |
| 兼容性 | 支持懒加载（lazy load）、支持与其他插件（如 Video SEO、a3 lazy load、Turn Off the Lights 等）共用，不会冲突。 |
优点
- 灵活性高：短码 + profiles + 多参数可以控制嵌入视频的很多细节，适合对视频展示有特别要求的场景。
- 响应式支持好：适合现代设计，不会因为固定尺寸视频导致在移动设备上显示问题。
- SEO 与性能考虑：API 拉取视频信息、生成元数据；有缓存机制；支持懒加载等，有利于提升速度与页面加载体验。
- 可管理性好：Profiles 和 Lists 可以让你为不同场景设置模板或风格，不用每次都重复写参数。
局限以及注意事项
- 依赖 YouTube API key：某些功能（如准确的视频信息 metadata）如果没有 API Key 会受限。
- 某些参数在不同环境中有限制，例如 iOS 上自动播放通常被系统或浏览器限制。
- URL 长度限制问题：如果播放列表很长、或者参数很多，生成的 embed URL 可能超过浏览器／YouTube 接受的长度最大值，会导致错误。
- 短码冲突：如果你的网站或其他插件也使用了
[youtube]...[/youtube]这个短码，可能会冲突。这个插件提供使用备用短码的选项以解决这一问题。 - 视频分辨率／质量控制限制：虽然参数允许你设定许多选项，但最终 YouTube 播放器会根据用户设备、网络状况、YouTube 的策略来选择播放版本，你不能完全控制播放的清晰度。
适合场景
这个插件适合以下场景：
- 你的网站里要插入很多 YouTube 视频，并且希望它们风格统一（尺寸、控件、字幕、播放控制等）。
- 你有多个展示位置（文章正文、侧边栏、小工具区等），想为每个位置设置不同样式。
- 希望在不写太多代码的情况下用短码来灵活控制视频行为（比如 autoplay、loop、字幕等）。
- 希望视频嵌入对 SEO 有一点帮助，比如自动加入 metadata 或视频摘要。
- 想通过缩略图显示视频，并且在缩略图上点击才加载视频，以减轻页面加载负担。
如何使用／配置基本步骤
- 在 WordPress 后台安装并启用插件。
- （可选）在插件设置里填写 YouTube API key，以启用视频数据拉取等功能。
- 在 Settings → Embeds for YouTube 中设置默认选项，比如默认视频尺寸、默认是否响应式、是否开启特定参数等。
- 如果需要不同风格，可以在 Profiles 中创建额外的配置档。比如一个 profile 用于文章正文，一个用于 sidebar widget。
- 在页面／文章中使用短码插入视频，例如：
[youtube]VIDEO_ID_OR_URL[/youtube]
或者带参数的形式：
[youtube width=500 height=300 autoplay=yes controls=1]VIDEO_ID[/youtube]使用列表（Lists）功能管理多个视频，一个列表可被短码调用，用于播放多个视频或做播放顺序／随机播放等。
如果展示缩略图而不是直接嵌入视频，可以使用 [youtube_thumb]…[/youtube_thumb] 短码。
