钩子文档

delete_{$meta_type}_meta

💡 云策文档标注

概述

delete_{$meta_type}_meta 是一个 WordPress 动作钩子,在删除特定类型的元数据之前立即触发。它允许开发者在删除元数据时执行自定义操作。

关键要点

  • 钩子名称是动态的,$meta_type 指代元对象类型,如 blog、post、comment、term、user 等。
  • 可能的钩子名称包括 delete_blog_meta、delete_post_meta、delete_comment_meta、delete_term_meta、delete_user_meta。
  • 参数包括 $meta_ids(元数据条目 ID 数组)、$object_id(对象 ID)、$meta_key(元数据键)、$_meta_value(元数据值)。
  • 源调用为 do_action("delete_{$meta_type}_meta", $meta_ids, $object_id, $meta_key, $_meta_value)。
  • 相关函数有 delete_metadata() 和 delete_metadata_by_mid(),用于删除元数据。
  • 自 WordPress 3.1.0 版本引入。

📄 原文内容

Fires immediately before deleting metadata of a specific type.

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).

Possible hook names include:

  • delete_blog_meta
  • delete_post_meta
  • delete_comment_meta
  • delete_term_meta
  • delete_user_meta

Parameters

$meta_idsstring[]
An array of metadata entry IDs to delete.
$object_idint
ID of the object metadata is for.
$meta_keystring
Metadata key.
$_meta_valuemixed
Metadata value.

Source

do_action( "delete_{$meta_type}_meta", $meta_ids, $object_id, $meta_key, $_meta_value );

Changelog

Version Description
3.1.0 Introduced.