钩子文档

update_postmeta

💡 云策文档标注

概述

update_postmeta 是一个 WordPress 动作钩子,在更新文章元数据之前立即触发。它允许开发者在元数据更新时执行自定义操作。

关键要点

  • 钩子名称:update_postmeta
  • 触发时机:在更新文章元数据之前立即执行
  • 参数:$meta_id(元数据条目ID)、$object_id(文章ID)、$meta_key(元数据键)、$meta_value(元数据值,可能是PHP序列化字符串)
  • 源调用:do_action( 'update_postmeta', $meta_id, $object_id, $meta_key, $meta_value )
  • 相关函数:update_metadata_by_mid() 和 update_metadata()
  • 引入版本:WordPress 2.9.0

📄 原文内容

Fires immediately before updating a post’s metadata.

Parameters

$meta_idint
ID of metadata entry to update.
$object_idint
Post ID.
$meta_keystring
Metadata key.
$meta_valuemixed
Metadata value. This will be a PHP-serialized string representation of the value if the value is an array, an object, or itself a PHP-serialized string.

Source

do_action( 'update_postmeta', $meta_id, $object_id, $meta_key, $meta_value );

Changelog

Version Description
2.9.0 Introduced.