wpseek.com
WordPress开发者和主题制作者的搜索引擎



register_rest_field › WordPress Function

Since4.7.0
已弃用n/a
register_rest_field ( $object_type, $attribute, $args = array() )
参数: (3)
  • (string|array) $object_type Object(s) the field is being registered to, "post"|"term"|"comment" etc.
    Required: Yes
  • (string) $attribute The attribute name.
    Required: Yes
  • (array) $args { Optional. An array of arguments used to handle the registered field. @type callable|null $get_callback Optional. The callback function used to retrieve the field value. Default is 'null', the field will not be returned in the response. The function will be passed the prepared object data. @type callable|null $update_callback Optional. The callback function used to set and update the field value. Default is 'null', the value cannot be set or updated. The function will be passed the model object, like WP_Post. @type array|null $schema Optional. The schema for this field. Default is 'null', no schema entry will be returned. }
    Required: No
    默认: array()
定义在:
文档:

Registers a new field on an existing WordPress object type.



源码

function register_rest_field( $object_type, $attribute, $args = array() ) {
	global $wp_rest_additional_fields;

	$defaults = array(
		'get_callback'    => null,
		'update_callback' => null,
		'schema'          => null,
	);

	$args = wp_parse_args( $args, $defaults );

	$object_types = (array) $object_type;

	foreach ( $object_types as $object_type ) {
		$wp_rest_additional_fields[ $object_type ][ $attribute ] = $args;
	}
}