LLMS_REST_Controller::create_item( WP_REST_Request $request )
Create an item.
Parameters Parameters
- $request
-
(WP_REST_Request) (Required) Request object.
Return Return
(WP_Error|WP_REST_Response)
Source Source
File: libraries/lifterlms-rest/includes/abstracts/class-llms-rest-controller.php
public function create_item( $request ) {
if ( ! empty( $request['id'] ) ) {
return llms_rest_bad_request_error( __( 'Cannot create an existing resource.', 'lifterlms' ) );
}
$schema = $this->get_item_schema();
$item = $this->prepare_item_for_database( $request );
// Exclude additional fields registered via `register_rest_field()`.
$item = array_diff_key( $item, $this->get_additional_fields() );
$object = $this->create_object( $item, $request );
if ( is_wp_error( $object ) ) {
return $object;
}
$this->object_inserted( $object, $request, $schema, true );
// Registered via `register_meta()`.
$meta_update = $this->update_meta( $object, $request, $schema );
if ( is_wp_error( $meta_update ) ) {
return $meta_update;
}
// Registered via `register_rest_field()`.
$fields_update = $this->update_additional_fields_for_object( $object, $request );
if ( is_wp_error( $fields_update ) ) {
return $fields_update;
}
$this->object_completely_inserted( $object, $request, $schema, true );
$request->set_param( 'context', 'edit' );
$response = $this->prepare_item_for_response( $object, $request );
$response->set_status( 201 );
$response->header( 'Location', rest_url( sprintf( '%s/%s/%d', $this->namespace, $this->rest_base, $this->get_object_id( $object ) ) ) );
return $response;
}
Expand full source code Collapse full source code View on GitHub
Changelog Changelog
| Version | Description |
|---|---|
| 1.0.0-beta.27 | Handle custom meta registered via register_meta() and custom rest fields registered via register_rest_field(). |
| 1.0.0-beta.12 | Call object_inserted and object_completely_inserted after an object is respectively inserted in the DB and all its additional fields have been updated as well (completely inserted). |
| 1.0.0-beta.1 | Introduced. |