delete_{$meta_type}_metadata_by_mid
云策文档标注
概述
delete_{$meta_type}_metadata_by_mid 是一个 WordPress 过滤器钩子，用于通过元 ID 短路删除特定类型的元数据。它允许开发者在删除元数据前进行自定义处理或阻止操作。
关键要点
- 钩子名称是动态的，基于 $meta_type 参数，对应元对象类型（如 blog、post、comment、term、user 等）。
- 返回非空值将短路 delete_metadata_by_mid() 函数，阻止默认删除操作。
- 参数包括 $delete（是否允许删除，类型为 null|bool）和 $meta_id（元 ID，类型为 int）。
- 相关函数为 delete_metadata_by_mid()，用于通过元 ID 删除元数据。
- 该钩子自 WordPress 5.0.0 版本引入。
代码示例
$check = apply_filters( "delete_{$meta_type}_metadata_by_mid", null, $meta_id );
原文内容
Short-circuits deleting metadata of a specific type by meta ID.
Description
The dynamic portion of the hook name, $meta_type, refers to the meta object type (blog, post, comment, term, user, or any other type with an associated meta table).
Returning a non-null value will effectively short-circuit the function.
Possible hook names include:
delete_blog_metadata_by_middelete_post_metadata_by_middelete_comment_metadata_by_middelete_term_metadata_by_middelete_user_metadata_by_mid
Parameters
$deletenull|bool-
Whether to allow metadata deletion of the given type.
$meta_idint-
Meta ID.
Source
$check = apply_filters( "delete_{$meta_type}_metadata_by_mid", null, $meta_id );
Changelog
| Version | Description |
|---|---|
| 5.0.0 | Introduced. |