Skip to main content
Each action hook is documented below with its description and usage example.
The action hooks listed here are not complete! Feel free to inquire about any specific action hook you may need help with.

​
Installation Hooks

​
cocart_init

Fires once CoCart has finished loading.
Made available since v3.0.0
Usage 
do_action('cocart_init', function() {
    // Your code here
});
Defined in: includes/class-cocart.php

​
cocart_updated

Runs after CoCart has been updated.
Made available since v1.2.0
Usage 
do_action('cocart_updated', function() {
    // Your code here
});
Defined in: includes/classes/class-cocart-install.php

​
cocart_installed

Runs after CoCart has been installed.
Made available since v1.2.0
Usage 
do_action('cocart_installed', function() {
    // Your code here
});
Defined in: includes/classes/class-cocart-install.php

​
Cart Updates

​
cocart_update_cart_before_totals

Fires before the cart has updated via a callback, but before cart totals are re-calculated. Parameters
​
request
WP_REST_Request
The request object.
​
controller
object
The cart controller.
Made available since v4.1.0
Usage 
add_action('cocart_update_cart_before_totals', function($request, $controller) {
    // Your code here
}, 10, 2);
Defined in: includes/abstracts/abstract-cocart-extension-callback.php

​
cocart_update_cart_after_totals

Fires after the cart has updated via a callback and cart totals are re-calculated. Parameters
​
request
WP_REST_Request
The request object.
​
controller
object
The cart controller.
Made available since v4.1.0
Usage 
add_action('cocart_update_cart_after_totals', function($request, $controller) {
    // Your code here
}, 10, 2);

​
Session Hooks

​
cocart_after_session_saved_data

Fires after session data is saved. Parameters
​
customer_id
int
Customer ID.
​
data
array
Cart data.
​
cart_expiration
int
Cart expiration.
​
cart_source
string
Cart source.
Made available since v4.2.0
Usage 
add_action('cocart_after_session_saved_data', function($customer_id, $data, $cart_expiration, $cart_source) {
    // Your code here
}, 10, 4);

​
cocart_cart_loaded

Fires once a cart has loaded. Can be used to trigger a webhook. Parameters
​
cart_key
string
The cart key.
Made available since v3.8.0
Usage 
add_action('cocart_cart_loaded', function($cart_key) {
    // Your code here
}, 10, 1);

​
Cart Items Management

​
cocart_item_added_updated_in_cart

Fires if item was added again to the cart but updated the quantity. Parameters
​
cart_item_key
string
Item key of the item added again.
​
item_added
array
Item added to cart again.
​
new_quantity
int
New quantity of the item.
Made available since v2.1.0
Usage 
add_action('cocart_item_added_updated_in_cart', function($cart_item_key, $item_added, $new_quantity) {
    // Your code here
}, 10, 3);

​
cocart_item_added_to_cart

Fires once an item has been added to cart. Parameters
​
item_key
string
Item key of the item added.
​
item_added
array
Item added to cart.
Made available since v2.1.0
Usage 
add_action('cocart_item_added_to_cart', function($item_key, $item_added) {
    // Your code here
}, 10, 2);

​
cocart_item_removed

Fires when an item is removed from the cart. Parameters
​
current_data
array
The cart item data.
Made available since v2.0.0
Usage 
add_action('cocart_item_removed', function($current_data) {
    // Your code here
}, 10, 1);

​
cocart_item_restored

Fires when an item is restored to the cart. Parameters
​
current_data
array
The cart item data.
Made available since v2.0.0
Usage 
add_action('cocart_item_restored', function($current_data) {
    // Your code here
}, 10, 1);

​
cocart_item_quantity_changed

Fires when the quantity of an item in the cart is changed. Parameters
​
item_key
string
Item key.
​
new_data
array
Item data.
Made available since v2.0.0
Usage 
add_action('cocart_item_quantity_changed', function($item_key, $new_data) {
    // Your code here
}, 10, 2);

​
Product Reviews

​
cocart_insert_product_review

Fires after a comment is created via the REST API. Parameters
​
review
WP_Comment
Inserted comment object.
​
request
WP_REST_Request
The request object.
​
creating
bool
True when creating a comment, false when updating.
Made available since v2.1.0
Usage 
add_action('cocart_insert_product_review', function($review, $request, $creating) {
    // Your code here
}, 10, 3);

​
Deprecated Hooks

​
cocart_cart

Deprecated: 3.0.0 Use cocart_cart hook instead.
Usage 
do_action('cocart_cart', function() {
    // Your code here
});

​
cocart_update_cart_before_totals

Deprecated: 4.1.0 Replaced with cocart_update_cart_before_totals hook.
Usage 
do_action('cocart_update_cart_before_totals', function() {
    // Your code here
});