Hooks & Filters

add_action( 'boxcart_order_created', 'my_notify_on_new_order' );
function my_notify_on_new_order( $order_id ) {
    // Example: send a Slack notification when a new order is placed
    $order = BoxCart_Order::get( $order_id );
    if ( ! $order ) {
        return;
    }
    wp_remote_post( 'https://hooks.slack.com/services/YOUR/WEBHOOK/URL', [
        'body' => wp_json_encode( [
            'text' => sprintf( 'New order #%s received!', $order->get_order_number() ),
        ] ),
        'headers' => [ 'Content-Type' => 'application/json' ],
    ] );
}

add_action( 'boxcart_order_status_changed', 'my_on_order_ready', 10, 3 );
function my_on_order_ready( $order_id, $old_status, $new_status ) {
    if ( $new_status === 'ready' ) {
        // Send an SMS notification when the order is ready for collection
        my_send_sms( $order_id, 'Your order is ready for collection!' );
    }
}

add_action( 'boxcart_payment_status_changed', 'my_log_payment_change', 10, 3 );
function my_log_payment_change( $order_id, $old_status, $new_status ) {
    if ( $new_status === 'paid' ) {
        // Record the payment in an external accounting system
        my_accounting_api_record_payment( $order_id );
    }
}

add_action( 'boxcart_after_add_to_basket', 'my_track_add_to_basket', 10, 4 );
function my_track_add_to_basket( $product_id, $quantity, $basket_id, $quantity_type_id ) {
    // Track add-to-basket events for analytics
    if ( function_exists( 'my_analytics_track' ) ) {
        my_analytics_track( 'add_to_cart', [
            'product_id' => $product_id,
            'quantity'   => $quantity,
        ] );
    }
}

add_action( 'boxcart_before_add_to_basket', 'my_log_basket_addition', 10, 3 );
function my_log_basket_addition( $product_id, $quantity, $quantity_type_id ) {
    error_log( sprintf(
        'BoxCart: Adding product %d (qty: %s, type: %d) to basket',
        $product_id, $quantity, $quantity_type_id
    ) );
}

add_action( 'boxcart_basket_updated', 'my_on_basket_update' );
function my_on_basket_update( $basket_id ) {
    // Invalidate any cached basket data
    wp_cache_delete( 'boxcart_basket_' . $basket_id, 'boxcart' );
}

add_action( 'boxcart_basket_cleared', 'my_on_basket_cleared' );
function my_on_basket_cleared( $basket_id ) {
    // Log basket clear events for analytics
    error_log( 'BoxCart: Basket ' . $basket_id . ' was cleared.' );
}

add_action( 'boxcart_before_checkout', 'my_pre_checkout_log' );
function my_pre_checkout_log() {
    error_log( 'BoxCart: Checkout process starting at ' . current_time( 'mysql' ) );
}

add_action( 'boxcart_after_checkout', 'my_post_checkout_tasks' );
function my_post_checkout_tasks( $order_id ) {
    // Trigger a webhook to an external fulfilment service
    wp_remote_post( 'https://api.example.com/orders', [
        'body'    => wp_json_encode( [ 'order_id' => $order_id ] ),
        'headers' => [ 'Content-Type' => 'application/json' ],
    ] );
}

add_action( 'boxcart_checkout_validation', 'my_validate_checkout_data' );
function my_validate_checkout_data( $posted_data ) {
    // Example: log checkout attempts for monitoring
    error_log( 'BoxCart: Checkout validation for ' . $posted_data['email'] );
}

add_action( 'boxcart_customer_details_updated', 'my_sync_customer_profile', 10, 2 );
function my_sync_customer_profile( $customer_id, $data ) {
    // Sync updated details to a CRM
    my_crm_update_contact( $customer_id, $data );
}

add_action( 'boxcart_order_modified', 'my_on_order_modified', 10, 3 );
function my_on_order_modified( $order_id, $changes, $user_id ) {
    // Log order modifications for audit purposes
    error_log( sprintf(
        'BoxCart: Order #%d modified by user %d. Changes: %s',
        $order_id, $user_id, wp_json_encode( $changes )
    ) );
}

add_action( 'boxcart_slot_selected', 'my_on_slot_selected', 10, 5 );
function my_on_slot_selected( $basket_id, $location_id, $slot_date, $time_start, $time_end ) {
    // Track slot selection for demand analytics
    my_analytics_track( 'slot_selected', [
        'location_id' => $location_id,
        'date'        => $slot_date,
        'time'        => $time_start . ' - ' . $time_end,
    ] );
}

add_action( 'boxcart_favourite_added', 'my_track_favourite', 10, 2 );
function my_track_favourite( $product_id, $user_id ) {
    // Track which products are most favourited
    $count = (int) get_post_meta( $product_id, '_favourite_count', true );
    update_post_meta( $product_id, '_favourite_count', $count + 1 );
}

add_action( 'boxcart_favourite_removed', 'my_untrack_favourite', 10, 2 );
function my_untrack_favourite( $product_id, $user_id ) {
    $count = max( 0, (int) get_post_meta( $product_id, '_favourite_count', true ) - 1 );
    update_post_meta( $product_id, '_favourite_count', $count );
}

add_action( 'boxcart_favourites_cleared', 'my_on_favourites_cleared' );
function my_on_favourites_cleared( $user_id ) {
    // Reset any cached favourites data for this customer
    delete_user_meta( $user_id, 'my_favourites_cache' );
}

add_action( 'boxcart_admin_settings_saved', 'my_on_settings_saved' );
function my_on_settings_saved( $settings ) {
    // Clear any caches when settings change
    wp_cache_flush();
    // Log which admin changed settings
    error_log( 'BoxCart settings updated by user ' . get_current_user_id() );
}

add_action( 'boxcart_admin_dashboard', 'my_custom_dashboard_widget' );
function my_custom_dashboard_widget() {
    echo '<div class="boxcart-dashboard-widget">';
    echo '<h3>Custom Analytics</h3>';
    echo '<p>Your custom dashboard content here.</p>';
    echo '</div>';
}

add_filter( 'boxcart_basket_total', 'my_apply_bulk_discount', 10, 2 );
function my_apply_bulk_discount( $total, $basket ) {
    // Apply a 10% discount on orders over 50
    if ( $total > 50 ) {
        $total *= 0.9;
    }
    return $total;
}

add_filter( 'boxcart_email_recipient', 'my_redirect_test_emails', 10, 2 );
function my_redirect_test_emails( $to, $order ) {
    // During development, redirect all emails to a test address
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        return 'dev-testing@example.com';
    }
    return $to;
}

add_filter( 'boxcart_email_subject', 'my_custom_email_subject', 10, 3 );
function my_custom_email_subject( $subject, $template_type, $order ) {
    // Add a store name prefix to all email subjects
    $store_name = BoxCart_Helpers::get_settings()['business_name'] ?? 'Our Store';
    return '[' . $store_name . '] ' . $subject;
}

add_filter( 'boxcart_email_content', 'my_add_email_footer', 10, 3 );
function my_add_email_footer( $content, $template_type, $order ) {
    // Add a promotional footer to order confirmation emails
    if ( $template_type === 'order_confirmation' ) {
        $content .= '<div style="margin-top:20px;padding:15px;background:#f8f8f8;">';
        $content .= '<p>Thank you for your order! Use code COLLECT10 for 10% off your next order.</p>';
        $content .= '</div>';
    }
    return $content;
}

add_filter( 'boxcart_email_headers', 'my_add_bcc_to_emails', 10, 3 );
function my_add_bcc_to_emails( $headers, $to, $subject ) {
    // BCC the store manager on all outgoing emails
    if ( is_array( $headers ) ) {
        $headers[] = 'Bcc: manager@example.com';
    } else {
        $headers .= "\r\nBcc: manager@example.com";
    }
    return $headers;
}