Actions & Hooks Reference

Action Hooks

probo_save_order_item_meta_{$uploader_type}

Fires when saving order item meta for a specific uploader type during checkout.

File: includes/frontend/class-probo-hooks.php

Parameters:

Example:

add_action( 'probo_save_order_item_meta_custom_uploader', function ( $item, $uploader_values, $order ) {
    $item->add_meta_data( '_custom_uploader_file', $uploader_values['file_id'] );
}, 10, 3 );

probo_order_status_change

Fires when any Probo order status changes via API callback.

File: includes/probo/class-probo-actions.php

Parameters:

Example:

add_action( 'probo_order_status_change', function ( $order_id, $status ) {
    error_log( "Order {$order_id} changed to status: {$status}" );
}, 10, 2 );

probo_order_status_change_{$status}

Fires when a Probo order reaches a specific status.

File: includes/probo/class-probo-actions.php

Parameters:

Example:

add_action( 'probo_order_status_change_delivered', function ( $order_id ) {
    wp_mail( get_option( 'admin_email' ), 'Order Delivered', "Order #{$order_id} delivered." );
} );

Filter Hooks

Order Payload Filters

probo_order_payload_filter_payload

File: includes/probo/helpers/class-probo-order.php

Parameters:

Example:

add_filter( 'probo_order_payload_filter_payload', function ( $payload, $order ) {
    $payload['metadata']['source'] = 'custom_integration';
    return $payload;
}, 10, 2 );

probo_order_payload_filter_order_id

Parameters:

Example:

add_filter( 'probo_order_payload_filter_order_id', function ( $order_id ) {
    return 'SHOP-' . $order_id;
} );

probo_order_payload_filter_order_reference

Parameters:

Example:

add_filter( 'probo_order_payload_filter_order_reference', function ( $ref, $prefix, $number ) {
    return sprintf( '%s-%s-%s', $prefix, date( 'Ymd' ), $number );
}, 10, 3 );

probo_order_payload_filter_delivery_address

Parameters:

Example:

add_filter( 'probo_order_payload_filter_delivery_address', function ( $address, $order ) {
    $address['department'] = $order->get_meta( '_delivery_department' );
    return $address;
}, 10, 2 );

Uploader Type Filters

probo_order_uploader_type_{$uploader_type}

Parameters:

Example:

add_filter( 'probo_order_uploader_type_my_uploader', function ( $data, $product_id, $item_id ) {
    $item = new WC_Order_Item_Product( $item_id );
    return [
        'file_url'  => $item->get_meta( '_file_url' ),
        'file_name' => $item->get_meta( '_file_name' ),
    ];
}, 10, 3 );

probo_uploader_generate_{$uploader_type}

Parameters:

Example:

add_filter( 'probo_uploader_generate_my_uploader', function ( $cart_item_data ) {
    $cart_item_data['my_uploader'] = [
        'file_id' => sanitize_text_field( $_POST['file_id'] ),
    ];
    return $cart_item_data;
} );

API Response Filters

probo_client_response_filter_{$method}

Parameters:

Example:

add_filter( 'probo_client_response_filter_price', function ( $response ) {
    foreach ( $response['meta_data']['prices'] as &$price ) {
        $price['amount'] = 1.1;
    }
    return $response;
} );

Shipping Filters

probo_shipping_delivery_date

Parameters:*

Example:

add_filter( 'probo_shipping_delivery_date', function ( $date, $price ) {
    $date['label'] .= ' (estimated)';
    return $date;
}, 10, 2 );

Cart & Frontend Filters

probo_store_cart_render

Parameters:

Example:

add_filter( 'probo_store_cart_render', function ( $data ) {
    $data['custom_label'] = 'Made to order';
    return $data;
} );

Configurator Block Filters

probo_configurator_block_render_{$section}

Parameters:

Hook Naming Conventions