The documentation for WooCommerce Blocks has moved to the WooCommerce monorepo.
Please refer to the documentation in the new location as the files in this repository will no longer be updated and the repository will be archived.
Some endpoints of the Store API are extensible via a class called ExtendSchema. This allows you to customise the data (including the schema) that is returned by the Store API so that it can be consumed by your application or plugin.
For more information about extending the Store API, you may also be interested in:
Below is a list of available endpoints that you can extend using ExtendSchema, as well as some example use-cases.
The main wc/store/products endpoint is extensible via ExtendSchema. The data is available via the extensions key for each product in the response array.
This endpoint can be extended using the ProductSchema::IDENTIFIER key. For this endpoint, your data_callback callback function is passed $product as a parameter. Your schema_callback function is passed no additional parameters; all products should share the same schema.
This endpoint is useful for adding additional data about individual products. This could be some meta data, additional pricing, or anything else to support custom blocks or components on the products page.
woocommerce_store_api_register_endpoint_data(
array(
'endpoint' => ProductSchema::IDENTIFIER,
'namespace' => 'my_plugin_namespace',
'data_callback' => function( $product ) {
return array(
'my_meta_data' => get_post_meta( $product->get_id(), 'my_meta_data', true ),
);
},
'schema_callback' => function() {
return array(
'properties' => array(
'my_meta_data' => array(
'type' => 'string',
),
),
);
},
'schema_type' => ARRAY_A,
)
);The main wc/store/cart endpoint is extensible via ExtendSchema. The data is available via the extensions key in the response.
This endpoint can be extended using the CartSchema::IDENTIFIER key. For this endpoint, your data_callback and schema_callback functions are passed no additional parameters.
This endpoint is useful for adding additional data to the cart page, for example, extra data about the cart items, or anything else needed to support custom blocks displayed on the cart page.
woocommerce_store_api_register_endpoint_data(
array(
'endpoint' => CartSchema::IDENTIFIER,
'namespace' => 'my_plugin_namespace',
'data_callback' => function() {
return array(
'foo' => 'bar',
);
},
'schema_callback' => function() {
return array(
'properties' => array(
'foo' => array(
'type' => 'string',
),
),
);
},
'schema_type' => ARRAY_A,
)
);The wc/store/cart/items endpoint, which is also available on wc/store/cart inside the items key. The data would be available inside each item of the items array.
This endpoint can be extended using the CartItemSchema::IDENTIFIER key. For this endpoint, your data_callback callback function is passed $cart_item as a parameter. Your schema_callback function is passed no additional parameters; all cart items should share the same schema.
This endpoint is useful for adding additional data about individual cart items. This could be some meta data, additional pricing, or anything else to support custom blocks or components on the cart page.
woocommerce_store_api_register_endpoint_data(
array(
'endpoint' => CartItemSchema::IDENTIFIER,
'namespace' => 'my_plugin_namespace',
'data_callback' => function( $cart_item ) {
$product = $cart_item['data'];
return array(
'my_meta_data' => get_post_meta( $product->get_id(), 'my_meta_data', true ),
);
},
'schema_callback' => function() {
return array(
'properties' => array(
'my_meta_data' => array(
'type' => 'string',
),
),
);
},
'schema_type' => ARRAY_A,
)
);The wc/store/checkout endpoint is extensible via ExtendSchema. Additional data is available via the extensions key in the response.
This endpoint can be extended using the CheckoutSchema::IDENTIFIER key. For this endpoint, your data_callback and schema_callback functions are passed no additional parameters.
This endpoint is useful for adding additional data to the checkout page, such as a custom payment method which requires additional data to be collected from the user or server.
⚠ Important: Do not reveal any sensitive data in this endpoint, as it is publicly accessible. This includes private keys for payment services.
woocommerce_store_api_register_endpoint_data(
array(
'endpoint' => CheckoutSchema::IDENTIFIER,
'namespace' => 'my_plugin_namespace',
'data_callback' => function() {
return array(
'foo' => 'bar',
);
},
'schema_callback' => function() {
return array(
'properties' => array(
'foo' => array(
'type' => 'string',
),
),
);
},
'schema_type' => ARRAY_A,
)
);We're hiring! Come work with us!
🐞 Found a mistake, or have a suggestion? Leave feedback about this document here.