将视频、图像、推文、音频和其他内容嵌入您的GeChiUI网站非常容易。
区块编辑器
自GeChiUI5.0 以来,区块编辑器创建了一种更简单的方式来在我们的GeChiUI网站上嵌入内容。使用嵌入区块,只需复制 URL 并粘贴到区块中。
对于每个特定区块,都有许多自定义选项。您可以在下表中或通过所有核心区块的列表找到每个区块的说明。
好的,那么我可以从哪些网站嵌入?
您可以使用所有这些:
笔记
由于 Facebook 决定关闭 嵌入 Facebook 和 Instagram 链接的 oEmbed 端点,该区块将在 2020 年 10 月 24 日之后不再起作用。想要将 Facebook 和 Instagram 链接嵌入其网站的发布者将需要一个开发者帐户和一个 appid,并在他们对端点的调用中提供一个身份验证令牌。Facebook 文档: 创建应用程序
用法
要将视频或其他对象嵌入文章或页面,请将其 URL 放入内容区域。确保 URL 在单独的行中并且没有超链接(查看文章时可单击)。
例如:
看看这个很酷的视频:
http ://www.youtube.com/watch?v=dQw4w9WgXcQ
这是一个很酷的视频。
GeChiUI会自动将 URL 转换为 YouTube 嵌入,并在可视化编辑器中提供实时预览。
另一种选择是将 URL 包装在“ embed
”短代码中。
// 注意:尝试删除 '[' 和 'embed' 之间的空格。
[嵌入宽度=“123”高度=“456”]http://www.youtube.com/watch?v=dQw4w9WgXcQ[/embed]
如果GeChiUI未能嵌入 URL,则文章将包含指向该 URL 的超链接。
o嵌入
简单嵌入功能主要由 oEmbed 提供支持,oEmbed 是站点 A(例如您的文章)向站点 B(例如 YouTube)请求嵌入站点 B 内容所需的 HTML 的协议。
oEmbed 旨在避免从托管您希望嵌入的媒体的站点复制和粘贴 HTML。它支持视频、图像、文本等。
这适用于任何 URL 吗?
不,默认情况下不是。GeChiUI只会嵌入与内部白名单匹配的 URL。这是出于安全目的。
如何添加或更改对网站的支持?
添加对其他网站的支持取决于该网站是否支持 oEmbed。
添加对支持 oEmbed 的站点的支持
如果站点支持 oEmbed,您需要调用gc_oembed_add_provider()将站点和 URL 格式添加到内部白名单。
添加对非 oEmbed 站点的支持
您需要使用gc_embed_register_handler()注册处理程序并提供生成 HTML 的回调函数。
删除对支持 oEmbed 的站点的支持
如果您希望删除启用 oEmbed 的提供程序,您需要调用gc_oembed_remove_provider。
oEmbed Discovery 怎么样?
从 4.4 版开始,GeChiUI支持 oEmbed 发现,但对可以通过非白名单站点嵌入的内容类型有严格的限制。
具体来说,过滤 HTML 和视频内容以仅允许链接、区块引用和 iframe,并且对这些内容进行额外过滤以防止插入恶意内容。然后将 HTML 修改为沙盒,并对它们进行额外的安全限制。
但是,如果您认为自己知识渊博,不需要这种级别的安全,您可以让unfiltered_html
用户(管理员和编辑)能够从在其<head>
.
“链接”和“照片”类型的 oEmbed 发现内容并没有以这种方式进行严格过滤,但是为了安全和防止任何恶意内容显示在站点上,它被适当地转义。