Skip to main content
Each action hook is documented below with its description and usage example.

​
Installation Hooks

​
cocart_init

Fires once the CoCart plugin has finished loading.
Made available since v3.0.0
Usage 
add_action( 'cocart_init', function() {
    // Your code here
});
Search cocart_init in repository

​
cocart_updated

Runs after CoCart has been updated.
Made available since v1.2.0
Usage 
add_action( 'cocart_updated', function() {
    // Your code here
});
Search cocart_updated in repository

​
cocart_installed

Runs after CoCart has been installed.
Made available since v1.2.0
Usage 
add_action( 'cocart_installed', function() {
    // Your code here
});
Search cocart_installed in repository

​
Session Management

​
cocart_after_session_saved_data

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

​
cocart_load_cart_override

Manipulate the overriding cart before it is set in session.
Made available since v2.1.0
Usage 
add_action( 'cocart_load_cart_override', function() {
    // Your code here
});
Search cocart_load_cart_override in repository

​
cocart_load_cart

Manipulate the merged cart before it is set in session.
Made available since v2.1.0
Usage 
add_action( 'cocart_load_cart', function() {
    // Your code here
});
Search cocart_load_cart in repository

​
cocart_cart_loaded

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

​
Cart Updates

​
cocart_update_cart_before_totals

Fires before the cart has updated via a callback, but before cart totals are re-calculated.
Made available since v4.1.0
Parameters
​
request
WP_REST_Request
The request object.
​
controller
object
The cart controller.
Usage 
add_action( 'cocart_update_cart_before_totals', function() {
    // Your code here
}, 10 );
Search cocart_update_cart_before_totals in repository

​
cocart_update_cart_after_totals

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

​
Cart Items Management

​
cocart_item_added_updated_in_cart

Fires if item was added again to the cart but updated the quantity.
Made available since v2.1.0
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.
Usage 
add_action( 'cocart_item_added_updated_in_cart', function() {
    // Your code here
}, 10 );
Search cocart_item_added_updated_in_cart in repository

​
cocart_item_added_to_cart

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

​
cocart_item_removed

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

​
cocart_item_restored

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

​
cocart_item_quantity_changed

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

​
Cart Operations

​
cocart_before_cart_emptied

Triggers before the cart is emptied.
Made available since v1.0.0
Usage 
add_action( 'cocart_before_cart_emptied', function() {
    // Your code here
});
Search cocart_before_cart_emptied in repository

​
cocart_cart_emptied

Triggers once the cart is emptied.
Made available since v1.0.0
Usage 
add_action( 'cocart_cart_emptied', function() {
    // Your code here
});
Search cocart_cart_emptied in repository

​
cocart_cart_cleared

Triggers once the cart is cleared.
Made available since v1.0.0
Usage 
add_action( 'cocart_cart_cleared', function() {
    // Your code here
});
Search cocart_cart_cleared in repository

​
cocart_get_cart

Fires when the cart is retrieved.
Made available since v2.0.0
Parameters
​
cart_contents
array
Cart contents.
Usage 
add_action( 'cocart_get_cart', function() {
    // Your code here
}, 10 );
Search cocart_get_cart in repository

​
Extensions

​
cocart_register_extension_callback

Fires when an extension callback is registered.
Made available since v3.1.0
Parameters
​
cart_extension
CoCart_Cart_Extension
Instance of the CoCart_Cart_Extension class which exposes the CoCart_Cart_Extension::register() method.
Usage 
add_action( 'cocart_register_extension_callback', function() {
    // Your code here
}, 10 );
Search cocart_register_extension_callback in repository

​
Product Reviews

​
cocart_insert_product_review

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

​
Deprecated

​
cocart_update_cart_before_totals

Deprecated: 4.1.0 Replaced with cocart_update_cart_before_totals hook.
Fires after the cart has updated via a callback.
Made available since v3.1.0
Usage 
add_action( 'cocart_update_cart_before_totals', function() {
    // Your code here
});
Search cocart_update_cart_before_totals in repository