本文档主要限于以下方面的任何开发相关内容嵌入隐私除了一些例外。请使用支持论坛对于一般问题。
Regex图案
regex模式可以为任何嵌入提供程序设置,它定义了一个正则表达式来匹配内容,该表达式应替换为嵌入隐私的覆盖。对于默认的嵌入提供程序,只匹配URL的一部分就足够了。
如果要添加自定义嵌入提供程序,最好的方法是同时匹配完整元素的HTML标记:
不要使用这样的正则表达式
/sub\.example\.com/
代码语言: 明文 (明文)
请使用这样的正则表达式
/<iframe src=“(.*)sub\.example\.com([^“]*)”>/
代码语言: 明文 (明文)
但是,自1.6.0版以来,任何不包含<
和>
将使用各种HTML标记进行扩展以进行检查。所以正则表达式/sub\.example\.com/
将成为:
/<(blockquote|div|embed|iframe|object)([^“]*)”([^<]*)sub\.example\.com([^”]*)“([^>]*)(>(.*)<\/(blockqueote|div | embed| iframe| object/
代码语言: 明文 (明文)
可以使用筛选器筛选扩展正则表达式的标记嵌入隐私标记元素
.
开始-结束-结束/
在regex模式中是可选的,如果不可用,会自动添加到代码中。
使用嵌入隐私在插件中
如果您想使用嵌入隐私在自定义代码的插件中,最好的方法是使用嵌入隐私::get_single_overlay()
直接。
您可以传递内容以搜索替换内容以及嵌入提供程序和其他参数,以使用嵌入覆盖匹配完整内容或部分内容。
示例
如果(类存在('附属物\Embed_Privacy\Embed_Privacy') ) {$args=[ '正则表达式'=>'/\custom\.example\.com/',];$内容='<p>示例文本</p><iframe src=“https://custom.example.com“></iframe>';$content=附属物\Embed_Privacy\Embed_Privacy::get_instance()->get_single_overlay($content,“我的示例”,“我的示例”,$args);}
代码语言: 菲律宾比索 (php(电话))
参见方法嵌入隐私::get_single_overlay()
获取可能参数的完整列表。
自定义缩略图提供程序
Embed Privacy实现了一种简单易用的方法,从1.9.0版开始创建自定义缩略图提供程序。要实现自定义缩略图提供程序,请扩展抽象类附属物\Embed_Privacy\缩略图\provider\thumbnail_provider
并实现接口附属物\Embed_Privacy\缩略图\provider\thumbnail_provider_Interface
(另请参见此博客帖子有关抽象类和接口的更多信息。)
在其中,您只需要定义如何获取缩略图和相应的嵌入ID。您可以找到Vimeo的基本实现在GitHub上。
然后,使用过滤器嵌入隐私摘要提供程序
注册自定义缩略图提供程序。
过滤器
嵌入隐私内容
通过过滤器嵌入隐私内容
可以更改嵌入覆盖内容。
参数:
string$content内容
string$embed_provider此嵌入的嵌入提供程序
应为字符串。
通过过滤器嵌入隐私覆盖基础
可以更改嵌入覆盖容器的页脚。
参数:
string$footer_content页脚内容
应为字符串。
嵌入隐私标记
通过过滤器嵌入隐私标记
可以更改整个嵌入覆盖容器。
参数:
string$markup标记
string$embed_provider此嵌入的嵌入提供程序
应为字符串。
嵌入隐私已嵌入
自1.3.0起
通过过滤器嵌入隐私已嵌入
的返回值嵌入隐私::has_Embed()
可以覆盖。
参数:
null$has_embed默认值
期望其他内容无效的
.
嵌入式特权资产$嵌入式提供者
自1.4.5起
通过过滤器嵌入式特权资产$嵌入式提供者
可以打印获得嵌入工作所需的其他资产。
每个资产必须是至少包含类型
参数,设置为脚本
对于脚本元素或内联
用于内联脚本。
如果类型
设置为脚本
,参数手柄
和型钢混凝土
是必需的,类似于中的相同参数wp_排队_脚本
。此外,参数版本
可以添加。
如果类型设置为内联
,参数数据
和对象名称
是必需的,类似于中的相同参数wp_add_inline脚本
.
参数:
数组$assets嵌入资产列表
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为带数组的数组。
嵌入隐私覆盖参数
自1.9.0起
通过过滤器嵌入隐私覆盖参数
创建覆盖之前的参数可以更改。
参数:
数组$args模板参数
string$embed_provider嵌入提供程序
string$embed_provider_lowercase不带空格且小写的嵌入提供程序
string$output替换前的输出
应为数组。
嵌入隐私背景路径$embedd_provider_lowercase
自1.1.0起
通过过滤器嵌入隐私背景路径$embedd_provider_lowercase
覆盖图背景图像的路径可以更改。
参数:
string$background_path默认背景路径
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向背景图像有效路径的字符串。
嵌入隐私背景url$embedd_provider_lowercase
自1.1.0起
通过过滤器嵌入隐私背景url$embedd_provider_lowercase
覆盖图背景图像的URL可以更改。
参数:
string$background_url默认背景url
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向背景图像的有效URL的字符串。
嵌入隐私日志路径$嵌入提供者小案例
通过过滤器嵌入隐私日志路径$嵌入提供者小案例
覆盖的徽标的路径可以更改。
参数:
字符串$徽标
_path默认徽标路径
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向徽标有效路径的字符串。
嵌入隐私_徽标
_url_$embed_provider_lowercase
通过过滤器嵌入隐私_徽标
_url_$embed_provider_lowercase
覆盖图徽标的URL可以更改。
参数:
字符串$徽标
_url默认徽标url
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向徽标的有效URL的字符串。
嵌入隐私摘要检查孤立
自1.7.0起
行动嵌入隐私摘要检查孤立
如果适用,在检查并删除提供程序的孤立数据后激发。
参数:
字符串$provider提供程序名称
string$id嵌入内容的id
string$url嵌入url
bool$missin_id是否缺少id
bool$missing_url是否缺少url
string$meta_value缩略图文件名
string$meta_key缩略图元键
WP_Post$Post Post对象
int$post_id帖子id
嵌入隐私摘要数据文件名
自1.7.0起
通过过滤器嵌入隐私摘要数据文件名
获取缩略图数据时可以更改缩略图文件名。
参数:
string$thumbia缩略图文件名
WP_Post$Post Post对象
string$url嵌入url
应为带有缩略图文件名的字符串。
嵌入隐私摘要数据id
自1.7.0起
通过过滤器嵌入隐私摘要数据id
可以更改获取缩略图数据时的缩略图ID。
参数:
string$id缩略图id
WP_Post$Post Post对象
string$url嵌入url
应为带有缩略图ID的字符串。
嵌入驱动器摘要数据路径
自1.7.0起
通过过滤器嵌入驱动器摘要数据路径
可以更改获取缩略图数据时的缩略图路径。
参数:
string$缩略图缩略图路径
WP_Post$Post Post对象
string$url嵌入url
应为带有缩略图路径的字符串。
嵌入隐私摘要数据url
自1.7.0起
通过过滤器嵌入隐私摘要数据url
可以更改获取缩略图数据时的缩略图URL。
参数:
string$url缩略图url
WP_Post$Post Post对象
string$url嵌入url
应为带有缩略图URL的字符串。
嵌入隐私摘要获取源提供程序
自1.7.0起
行动嵌入隐私摘要获取源提供程序
处理缩略图数据后激发。
参数:
string$return返回的oEmbed HTML
object$data来自oEmbed提供程序的数据对象结果
string$url要嵌入的内容的url
嵌入隐私摘要路径$embedd_provider_lowercase
自1.1.0起
通过过滤器嵌入隐私摘要路径$embedd_provider_lowercase
覆盖图缩略图的路径可以更改。
参数:
string$thumbnail_path默认缩略图路径
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向缩略图有效路径的字符串。
嵌入式驱动器缩略图支持的提供商名称
自1.7.0起
通过过滤器嵌入式驱动器缩略图支持的提供商名称
支持的缩略图提供程序的内部名称可以更改。
参数:
阵列supported_providers当前支持的提供程序名称
需要具有缩略图提供程序名称的数组。
嵌入隐私摘要提供程序
自1.9.0起
通过过滤器嵌入隐私摘要提供程序
可以更改注册的缩略图提供程序。
参数:
Thumbnail_Provider[]$supported_providers当前支持的提供程序
需要具有缩略图提供程序类的数组。
嵌入隐私前摘要删除或更改删除
自1.8.0起
通过行动嵌入隐私前摘要删除或更改删除
可以禁用删除孤立缩略图。
参数:
string$id缩略图id
string$url缩略图url
int$post_id帖子id
string$provider提供者名称
嵌入隐私摘要url$embed_provider_lowercase
自1.1.0起
通过过滤器嵌入隐私摘要url$embed_provider_lowercase
覆盖图缩略图的URL可以更改。
参数:
string$thumbnail_url默认缩略图url
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为指向缩略图的有效URL的字符串。
嵌入隐私忽略未知提供者
自1.5.0起
通过过滤器嵌入隐私忽略未知提供者
可以禁用对未知嵌入提供程序的嵌入的处理。
参数:
bool$ignore_unknown是否应忽略未知提供程序
string$content原始内容
应为布尔值。
嵌入隐私忽略嵌入
自1.9.0起
通过过滤器嵌入隐私忽略嵌入
可以禁用对特定嵌入的处理。
参数:
bool$ignore_embed是否忽略此嵌入
string$content原始内容
string$embed_provider嵌入提供程序
string$embed_provider_lowercase不带空格且小写的嵌入提供程序
数组$args其他参数
应为布尔值。
嵌入隐私忽略短代码
自1.6.0起
通过过滤器嵌入隐私忽略短代码
短代码可以忽略,不会被覆盖替换。
参数:
string[]$ignored_shortcodes当前被忽略的短代码列表
应为数组。
嵌入隐私动态样式属性
自1.9.0起
通过过滤器嵌入隐私动态样式属性
页面的动态嵌入样式的属性可以更改。
参数:
数组$style_properties样式属性数组
应为数组。
嵌入隐私动态样式
自1.9.0起
通过过滤器嵌入隐私动态样式
页面的动态嵌入样式可以更改。
参数:
string$style生成的样式
数组$style_properties样式属性数组
应为字符串。
嵌入隐私标记元素
自1.6.0起
通过过滤器嵌入隐私标记元素
可以更改HTML元素,这些元素将扩展自定义嵌入提供程序的正则表达式。
参数:
array$allowed_tags允许的标记
string$embed_provider_lowercase当前的嵌入提供程序(小写)
应为数组。
通过过滤器嵌入隐私小工具输出
小部件的输出可以更改。
参数:
string$widget_output小部件的输出
string$widget_id小部件的完整id
string$sidebar_id当前侧边栏id
应为字符串。
嵌入隐私输出标题
自1.2.0起
通过过滤器嵌入隐私输出标题
opt-out短代码的标题可以更改。
参数:
string$headline当前标题HTML
数组$attributes短代码属性
应为字符串。
嵌入_隐私_选择_输出_公用事业
自1.2.0起
通过过滤器嵌入_隐私_选择_输出_公用事业
opt-out短代码的崇高可以改变。
参数:
string$headline当前子行HTML
数组$attributes短代码属性
应为字符串。
嵌入隐私编辑器字段
通过过滤器嵌入隐私编辑器字段
可以在嵌入提供程序编辑器屏幕中呈现其他字段。
参数:
int$post_id当前帖子id
应为字符串。
嵌入隐私寄存器字段
自1.2.0起
通过过滤器嵌入隐私寄存器字段
可以注册其他字段。
参数:
int$post_id当前帖子id
应为数组。
嵌入隐私字段
通过过滤器嵌入隐私字段
所有注册的字段都可以更改。
参数:
数组$fields已注册的字段
应为数组。
嵌入隐私有效文件
通过过滤器嵌入隐私有效文件
可以更改编辑器POST请求中有效文件的名称。
参数:
数组默认名称列表
应为数组。
喷气式飞机包装
自1.4.5起
通过过滤器喷气式飞机包装
Jetpack共享的Facebook应用程序ID可以更改。
参数:
string$app_id当前应用程序id
应为字符串。