wp_embed_unregister_handler()
云策文档标注
概述
wp_embed_unregister_handler() 函数用于取消注册之前注册的嵌入处理器。它通过调用 WP_Embed 类的 unregister_handler 方法实现,是 WordPress 嵌入系统的一部分。
关键要点
- 函数用于移除指定的嵌入处理器,以控制嵌入内容的处理。
- 接受两个参数:必需的 $id(处理器 ID)和可选的 $priority(优先级,默认 10)。
- 内部调用全局 $wp_embed 对象的 unregister_handler 方法。
- 自 WordPress 2.9.0 版本引入。
代码示例
function wp_embed_unregister_handler( $id, $priority = 10 ) {
global $wp_embed;
$wp_embed->unregister_handler( $id, $priority );
}注意事项
- 确保 $id 参数与之前注册时使用的 ID 一致,否则可能无法正确取消注册。
- 优先级参数可用于指定要移除的特定优先级处理器,默认移除优先级为 10 的处理器。
原文内容
Unregisters a previously-registered embed handler.
Parameters
$idstringrequired-
The handler ID that should be removed.
$priorityintoptional-
The priority of the handler to be removed.
Default:
10
Source
function wp_embed_unregister_handler( $id, $priority = 10 ) {
global $wp_embed;
$wp_embed->unregister_handler( $id, $priority );
}
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |