Hooks & Filters

add_action( 'boxbuilder_pro_loaded', function() {
    // Plugin is fully loaded — safe to use BoxBuilder functions
});

add_action( 'boxbuilder/order_processing', function( $order ) {
    // Send custom notification, update external system, etc.
    $order_id = $order->get_id();
}, 10, 1 );

add_action( 'boxbuilder/before_checkout_with_boxes', function( $checkout ) {
    // Add custom messaging or validation before checkout
}, 10, 1 );

add_action( 'boxbuilder/order_item_created', function( $item, $order ) {
    // Add custom meta to the order item
    $item->add_meta_data( '_my_custom_field', 'value' );
    $item->save();
}, 10, 2 );

add_action( 'boxbuilder/order_created', function( $order ) {
    // Post-order processing for box orders
}, 10, 1 );

add_action( 'boxbuilder/mini_cart_boxes', function( $box_count ) {
    // Customize mini cart display for boxes
}, 10, 1 );

add_action( 'boxbuilder/stock_reserved', function( $product_id, $quantity, $session_id ) {
    // Track reserved stock, send alerts, etc.
}, 10, 3 );

add_action( 'boxbuilder/share_created', function( $share_key, $share_data ) {
    // Track sharing analytics
}, 10, 2 );

add_action( 'boxbuilder/share_loaded', function( $share_key, $share_data ) {
    // Log shared box views
}, 10, 2 );

add_action( 'boxbuilder/customization_locked', function( $subscription_id ) {
    // Notify admin or trigger fallback logic
}, 10, 1 );

add_action( 'boxbuilder/reminder_sent', function( $subscription_id, $product_id, $customer_email ) {
    // Track reminder delivery
}, 10, 3 );

add_filter( 'boxbuilder/pricing_models', function( $models ) {
    // Add a custom pricing model
    $models['wholesale'] = [
        'label' => 'Wholesale Pricing',
        'description' => 'Special pricing for wholesale customers',
    ];
    return $models;
}, 10, 1 );

add_filter( 'boxbuilder/price_html', function( $price_html, $product, $pricing_model ) {
    // Add "per box" suffix to fixed prices
    if ( $pricing_model === 'fixed' ) {
        $price_html .= ' <small>per box</small>';
    }
    return $price_html;
}, 10, 3 );

add_filter( 'boxbuilder/default_sizes', function( $sizes ) {
    // Add a custom default size
    $sizes[] = [
        'id'       => 'jumbo',
        'label'    => 'Jumbo',
        'capacity' => 48,
        'price'    => 99.99,
    ];
    return $sizes;
}, 10, 1 );

// BoxBuilder adds box data to cart items (priority 10)
add_filter( 'woocommerce_add_cart_item_data', 'boxbuilder_pro_add_box_data', 10, 3 );

// BoxBuilder displays box contents in cart (priority 10)
add_filter( 'woocommerce_get_item_data', 'boxbuilder_pro_display_box_data', 10, 2 );

// BoxBuilder hides child items from cart display (priority 10)
add_filter( 'woocommerce_cart_item_visible', 'boxbuilder_pro_hide_child_items', 10, 3 );

// BoxBuilder adjusts child item prices based on pricing model (priority 10)
add_action( 'woocommerce_before_calculate_totals', 'boxbuilder_pro_adjust_prices', 10, 1 );

// BoxBuilder saves box data to order items (priority 10)
add_action( 'woocommerce_checkout_create_order_line_item', 'boxbuilder_pro_save_order_data', 10, 4 );

// BoxBuilder hides child items in order display (priority 10)
add_filter( 'woocommerce_order_item_visible', 'boxbuilder_pro_hide_order_children', 10, 2 );

// BoxBuilder customizes meta display in admin (priority 10)
add_filter( 'woocommerce_order_item_display_meta_key', 'boxbuilder_pro_meta_key', 10, 3 );
add_filter( 'woocommerce_order_item_display_meta_value', 'boxbuilder_pro_meta_value', 10, 3 );

// BoxBuilder adds box content display to order emails
add_filter( 'woocommerce_email_order_items_args', 'boxbuilder_pro_email_args', 10, 1 );

// Remove BoxBuilder's callback and replace with your own
remove_filter( 'woocommerce_cart_item_visible', 'boxbuilder_pro_hide_child_items', 10 );
add_filter( 'woocommerce_cart_item_visible', 'my_custom_visibility', 10, 3 );