钩子文档

deleted_{$meta_type}_meta

💡 云策文档标注

概述

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

关键要点

  • 钩子名称是动态的,基于 $meta_type 参数,如 deleted_post_meta 或 deleted_user_meta。
  • 参数包括 $meta_ids(元数据ID数组)、$object_id(对象ID)、$meta_key(元数据键)和 $_meta_value(元数据值)。
  • 常用于在元数据删除后清理相关数据或记录日志。

代码示例

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

注意事项

  • 确保 $meta_type 是有效的元对象类型(如 post、user、term 等)。
  • 钩子从 WordPress 2.9.0 版本开始引入。

📄 原文内容

Fires immediately after 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:

  • deleted_blog_meta
  • deleted_post_meta
  • deleted_comment_meta
  • deleted_term_meta
  • deleted_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( "deleted_{$meta_type}_meta", $meta_ids, $object_id, $meta_key, $_meta_value );

Changelog

Version Description
2.9.0 Introduced.