update_{$meta_type}_metadata

过滤钩子


apply_filters( "update_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $prev_value )
参数
  • (null|bool)
    $check
    Whether to allow updating metadata for the given type.
    Required:
  • (int)
    $object_id
    ID of the object metadata is for.
    Required:
  • (string)
    $meta_key
    Metadata key.
    Required:
  • (mixed)
    $meta_value
    Metadata value. Must be serializable if non-scalar.
    Required:
  • (mixed)
    $prev_value
    Optional. Previous value to check before updating.
    If specified, only update existing metadata entries with
    this value. Otherwise, update all entries.
    Required:
定义位置
  • wp-includes/meta.php
    , line 233
引入
3.1.0
弃用

Short-circuits updating metadata of a specific type.

The dynamic portion of the hook name, $meta_type, refers to the meta object type
(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:

  • update_post_metadata
  • update_comment_metadata
  • update_term_metadata
  • update_user_metadata
$check = apply_filters( "update_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $prev_value );