get_{$meta_type}_metadata_by_mid
云策文档标注
概述
get_{$meta_type}_metadata_by_mid 是一个 WordPress 过滤器钩子，用于在通过元 ID 获取元字段时短路返回值。钩子名称中的动态部分 $meta_type 指代元对象类型，如博客、文章、评论、术语、用户等。
关键要点
- 钩子名称是动态的，基于 $meta_type 参数，例如 get_blog_metadata_by_mid、get_post_metadata_by_mid 等。
- 返回非空值将短路 get_metadata_by_mid() 函数，直接返回该值。
- 参数包括 $value（要返回的值，默认为 null）和 $meta_id（元 ID）。
- 首次引入于 WordPress 5.0.0 版本。
代码示例
$check = apply_filters( "get_{$meta_type}_metadata_by_mid", null, $meta_id );
原文内容
Short-circuits the return value when fetching a meta field 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:
get_blog_metadata_by_midget_post_metadata_by_midget_comment_metadata_by_midget_term_metadata_by_midget_user_metadata_by_mid
Parameters
$valuestdClass|null-
The value to return.
$meta_idint-
Meta ID.
Source
$check = apply_filters( "get_{$meta_type}_metadata_by_mid", null, $meta_id );
Changelog
| Version | Description |
|---|---|
| 5.0.0 | Introduced. |