[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-includes/rest-api/fields/ -> class-wp-rest-meta-fields.php (summary)

REST API: WP_REST_Meta_Fields class

File Size: 624 lines (18 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 15 functions

  get_meta_subtype()
  register_field()
  get_value()
  prepare_value_for_response()
  update_value()
  delete_meta_value()
  update_multi_meta_value()
  update_meta_value()
  is_meta_value_same_as_stored_value()
  get_registered_fields()
  get_field_schema()
  prepare_value()
  check_meta_is_array()
  default_additional_properties_to_false()
  get_empty_value_for_type()

Functions
Functions that are not part of a class:

get_meta_subtype()   X-Ref
Retrieves the object meta subtype.

return: string Subtype for the meta type, or empty string if no specific subtype.
since: 4.9.8

register_field()   X-Ref
Registers the meta field.

since: 4.7.0

get_value( $object_id, $request )   X-Ref
Retrieves the meta field value.

return: array Array containing the meta values keyed by name.
param: int             $object_id Object ID to fetch meta for.
param: WP_REST_Request $request   Full details about the request.
since: 4.7.0

prepare_value_for_response( $value, $request, $args )   X-Ref
Prepares a meta value for a response.

This is required because some native types cannot be stored correctly
in the database, such as booleans. We need to cast back to the relevant
type before passing back to JSON.

return: mixed Prepared value.
param: mixed           $value   Meta value to prepare.
param: WP_REST_Request $request Current request object.
param: array           $args    Options for the field.
since: 4.7.0

update_value( $meta, $object_id )   X-Ref
Updates meta values.

return: null|WP_Error Null on success, WP_Error object on failure.
param: array $meta      Array of meta parsed from the request.
param: int   $object_id Object ID to fetch meta for.
since: 4.7.0

delete_meta_value( $object_id, $meta_key, $name )   X-Ref
Deletes a meta value for an object.

return: true|WP_Error True if meta field is deleted, WP_Error otherwise.
param: int    $object_id Object ID the field belongs to.
param: string $meta_key  Key for the field.
param: string $name      Name for the field that is exposed in the REST API.
since: 4.7.0

update_multi_meta_value( $object_id, $meta_key, $name, $values )   X-Ref
Updates multiple meta values for an object.

Alters the list of values in the database to match the list of provided values.

return: true|WP_Error True if meta fields are updated, WP_Error otherwise.
param: int    $object_id Object ID to update.
param: string $meta_key  Key for the custom field.
param: string $name      Name for the field that is exposed in the REST API.
param: array  $values    List of values to update to.
since: 4.7.0

update_meta_value( $object_id, $meta_key, $name, $value )   X-Ref
No description

is_meta_value_same_as_stored_value( $meta_key, $subtype, $stored_value, $user_value )   X-Ref
Checks if the user provided value is equivalent to a stored value for the given meta key.

return: bool
param: string $meta_key     The meta key being checked.
param: string $subtype      The object subtype.
param: mixed  $stored_value The currently stored value retrieved from get_metadata().
param: mixed  $user_value   The value provided by the user.
since: 5.5.0

get_registered_fields()   X-Ref
Retrieves all the registered meta fields.

return: array Registered fields.
since: 4.7.0

get_field_schema()   X-Ref
Retrieves the object's meta schema, conforming to JSON Schema.

return: array Field schema data.
since: 4.7.0

prepare_value( $value, $request, $args )   X-Ref
Prepares a meta value for output.

Default preparation for meta fields. Override by passing the
`prepare_callback` in your `show_in_rest` options.

return: mixed Value prepared for output. If a non-JsonSerializable object, null.
param: mixed           $value   Meta value from the database.
param: WP_REST_Request $request Request object.
param: array           $args    REST-specific options for the meta key.
since: 4.7.0

check_meta_is_array( $value, $request, $param )   X-Ref
Check the 'meta' value of a request is an associative array.

return: array|false The meta array, if valid, false otherwise.
param: mixed           $value   The meta value submitted in the request.
param: WP_REST_Request $request Full details about the request.
param: string          $param   The parameter name.
since: 4.7.0

default_additional_properties_to_false( $schema )   X-Ref
Recursively add additionalProperties = false to all objects in a schema if no additionalProperties setting
is specified.

This is needed to restrict properties of objects in meta values to only
registered items, as the REST API will allow additional properties by
default.

return: array
param: array $schema The schema array.
since: 5.3.0

get_empty_value_for_type( $type )   X-Ref
Gets the empty value for a schema type.

return: mixed
param: string $type The schema type.
since: 5.3.0



Generated: Thu Mar 28 01:00:02 2024 Cross-referenced by PHPXref 0.7.1