
从 WordPress 5.5 开始,register_meta() 函数(包括 register_post_meta())支持注册元数据默认值。在此之前} q / } & H,只能像这样注册REST API模式的默认值:& D { . 5 ( O g s
register_meta(
‘post’,
‘greeting’,
array(
‘single’ => trueY ) 1 C 6 , z D,
‘type’ => ‘string’| k | | b ! / B,
‘show_in_rest’ => array(
‘schema’ => array(
‘type’ => ‘string’,
‘default’ =&g\ C ( ~ = w l Jt; ‘hello’,
),
),
)
);
但是,这仅适用于从REST API内进行的调用 – 使用get_post_meta()将无法获取默认值。
WordPress 5.5 开始,可以传递一个默认值,该值将应v I 7 u s 0用于任何元函数的所有调用,如下所示:
register_meta(
‘post’,
‘greeting’,
array(
‘single’ => true,
‘type’ =>@ + # =; ‘string’,
‘default’ => ‘hello’,
‘show_in_rest’ => array(
‘schema’ => array(
‘1 U e 2 w 5 * qtype’ => ‘string’,
),
),
)
);
此次对registeG | u 8 p Z / { zr_meta()的改进,很像另一个函数register_setting(),自WordPress 4.7起,可以w _ Z 7 [ \ + p =在register_setting()中[ C . s B h & y c注册选项的默认值。
默认值还可以与对象子类型(在WordPress 4.9.8中引入)配对,以限制默认值的范围。例如,如果插件注册的自定义文章类型为prodM 1 + : ( / ^uct。开发人员可以注册仅适用于product这个文章类型的默认值。如下所示:
register_post_meta(
‘product’,
‘price’,
array(
‘single’ => true,
‘type’ => ‘string’,
‘default’ => ‘0.00’,
)
);
值得注意的是,将默认值注册到这样的自定义文章类型可能会带来一些性能开销U : g。要确定当前文章ID是哪种文章类型,它必须加载该对象。有关更多详细信息,请参见get_object_subtype。在大多数情况下,meta和主对象是同时加载的(例如使用WP_Query时),但是如果您的代码除了加载meta数据以外还执行其他操作,那么它现在也可以加载主对象类型。
非单5 P Q一元数据
也可以注册非单一(Non-Single)的默认值,如下所示:
register_post_meta(
‘product’,
‘price’,
array(
‘single’ => false,\ R z = s E n 9
‘type’ =; c @ 4 H * L> ‘string’,
‘default’ => ‘0.00’,
)
);
请求多个值时,如下所示:
$result = get_post_meta( 123, ‘pri* o $ ,ce’, false );
上面的代码将返回一个以0.00作为第一个值的数字数组。
验证方式
注册默认元值时,数据必须与提供的类型匹配。以下示例将触发_doing_it_wrong通知提, h W F 9 [ w s ~示hello不是整数(integer)。L a }
registX j [ B p u M /er_meta(
‘post’,
‘greeting’,
array: j 2 ` |(
‘single’ => true,
‘type’ => ‘integer’,
‘default’ => ‘hello’,
)
);
新过滤器
如果您希望使用默认的元值进行一些真正的自定义,现在有一个过滤器:
$value = apply_filtersW 1 d W ;( “default_{$meta_type}_m9 X { @etadata”, $value, $object_id, $meta_key, $single, $meta_5 _ 9 e ` 3 ~ 5 ?type );
这是一个动态过滤器,要求您添加元类型。这是一个用法示例:
function addH W \_my_meta_value( $value, $object_id, $meta_key, $single ){
if( ‘price’ === $metaH s L u ) – m o_key ) {
if ( ! $single ) {
$value = array( ‘0.99’ );
} else {
$value = ‘0.99’;
}
}
}
add_filter( ‘defau% k _ – s +lt_post_metadata’, ‘add_my_meta_value’, 10, 4 );
新函数
为了使此功& L V能成为可能,WordPress 核心添加了两个新函数:
get_metadata_raw()
get_meta[ * k t t R V ldata_default()
现在,get_metadata()函数调用get_metadata_raw(),如果$ L D F Z q该值为null,则调用get_meta+ , D } Z i H +d; R ~ 6 R = R ia8 C y m h = V u mta_default()。因此,调用get_metadata()不再获取原始值,这就是现在使用get_metadata_raw()的目的。

