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



rest_is_field_included › WordPress Function

Since5.3.0
已弃用n/a
rest_is_field_included ( $field, $fields )
参数: (2)
  • (string) $field A field to test for inclusion in the response body.
    Required: Yes
  • (array) $fields An array of string fields supported by the endpoint.
    Required: Yes
返回:
  • (bool) Whether to include the field or not.
定义在:
文档:

Given an array of fields to include in a response, some of which may be `nested.fields`, determine whether the provided field should be included in the response body.

If a parent field is passed in, the presence of any nested field within that parent will cause the method to return true. For example "title" will return true if any of title, title.raw or title.rendered is provided.


源码

function rest_is_field_included( $field, $fields ) {
	if ( in_array( $field, $fields, true ) ) {
		return true;
	}

	foreach ( $fields as $accepted_field ) {
		/*
		 * Check to see if $field is the parent of any item in $fields.
		 * A field "parent" should be accepted if "parent.child" is accepted.
		 */
		if ( str_starts_with( $accepted_field, "$field." ) ) {
			return true;
		}
		/*
		 * Conversely, if "parent" is accepted, all "parent.child" fields
		 * should also be accepted.
		 */
		if ( str_starts_with( $field, "$accepted_field." ) ) {
			return true;
		}
	}

	return false;
}