Hooks & Integration

The following hooks cover plugin versions 4.0 and later. They are a focused integration reference rather than an exhaustive list.

Bid hooks

Hook	Arguments / purpose
auctions_for_woocommerce_before_place_bid	$product_id, $bid, $product_data; runs before later eligibility checks.
auctions_for_woocommerce_before_place_bid_filter	Receives $product_data; returning strict false stops the attempt.
auctions_for_woocommerce_place_bid_value	$value, $product_id; filters the normalized submitted amount.
auctions_for_woocommerce_place_bid	One array containing product_id; ordinary bids also provide is_proxy_bid.
auctions_for_woocommerce_place_sealedbid	One array containing product_id, bid, current_user, and log_id.
auctions_for_woocommerce_log_bid	$log_bid_id, $product_id, $bid, $current_user.

The before-bid action indicates an attempt, not acceptance. Do not send a successful-bid confirmation from that action. Sealed hooks contain confidential values; keep them out of public responses and public logs.

Example: react to an accepted bid

/**
 * Notify a local integration of an accepted auction bid.
 *
 * @param array $data Accepted bid context.
 */
function wpinstitut_handle_auction_bid( $data ) {
    $product_id = isset( $data['product_id'] ) ? absint( $data['product_id'] ) : 0;

    if ( ! $product_id ) {
        return;
    }

    do_action( 'wpinstitut_auction_bid_accepted', $product_id );
}
add_action( 'auctions_for_woocommerce_place_bid', 'wpinstitut_handle_auction_bid' );

Settings and account forms

• woocommerce_auctions_for_woocommerce_get_sections filters settings sections.
• woocommerce_auctions_settings_form_start, woocommerce_auctions_settings_form, and woocommerce_auctions_settings_form_end extend the customer preferences form.
• Shortcode tags in the registered shortcode map can be filtered through {$shortcode}_shortcode_tag.

Integrations must still validate their own input, check permissions, and escape output. Do not reproduce the bidding engine by writing bid metadata directly.