函数文档

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.