WooCommerce Compatibility Filters

Alpha Insights uses several standard WooCommerce filters to ensure compatibility and consistent behavior with WooCommerce core.

Overview

These are native WooCommerce filters that Alpha Insights respects and utilizes. They are documented here for reference when customizing price display and currency handling in Alpha Insights.

Filter: raw_woocommerce_price

Description

Filter the raw numeric price value before any formatting is applied. This is the first filter in the price formatting pipeline.

Location in Alpha Insights

File: includes/wpd-functions.php

Function: wpd_store_price()

Line: ~1158

Parameters

Example Usage

add_filter( 'raw_woocommerce_price', 'modify_raw_price', 10, 2 );
function modify_raw_price( $price, $original_price )
{
    // Round to nearest dollar
    if ( abs( $price ) > 100 )
    {
        return round( $price, 0 );
    }
    return $price;
}

Filter: formatted_woocommerce_price

Description

Filter the price after it has been formatted with thousands separators and decimal places, but before HTML markup is added.

Location in Alpha Insights

File: includes/wpd-functions.php

Function: wpd_store_price()

Line: ~1170

Parameters

Example Usage

add_filter( 'formatted_woocommerce_price', 'customize_formatted_price', 10, 6 );
function customize_formatted_price( $formatted, $price, $decimals, $dec_sep, $thou_sep, $original )
{
    // Add custom thousand separator styling
    $formatted = str_replace( $thou_sep, '' . $thou_sep . '', $formatted );
    return $formatted;
}

Filter: woocommerce_price_trim_zeros

Description

Control whether trailing zeros after the decimal point should be removed from prices.

Location in Alpha Insights

File: includes/wpd-functions.php

Function: wpd_store_price()

Line: ~1172

Parameters

Example Usage

Enable Zero Trimming

add_filter( 'woocommerce_price_trim_zeros', '__return_true' );

Result:

• $10.00 becomes $10
• $15.50 stays $15.50
• $20.10 becomes $20.1

Conditional Zero Trimming

add_filter( 'woocommerce_price_trim_zeros', 'conditional_trim_zeros' );
function conditional_trim_zeros( $trim )
{
    // Only trim zeros for whole dollar amounts
    global $current_price;
    if ( isset( $current_price ) && floor( $current_price ) == $current_price )
    {
        return true;
    }
    return false;
}

Filter: woocommerce_currency_symbols

Description

Modify the complete array of currency symbols used by WooCommerce and Alpha Insights.

Location in Alpha Insights

File: includes/functions/wpd-currency-functions.php

Function: wpd_get_woocommerce_currency_symbol()

Line: ~279

Parameters

Example Usage

Add Custom Currency

add_filter( 'woocommerce_currency_symbols', 'add_custom_currencies' );
function add_custom_currencies( $symbols )
{
    // Add cryptocurrencies
    $symbols['BTC'] = '฿';
    $symbols['ETH'] = 'Ξ';
    // Add custom internal currency
    $symbols['CREDITS'] = 'CR';
    // Modify existing symbol
    $symbols['USD'] = 'US$';
    return $symbols;
}

Replace All Symbols with Codes

add_filter( 'woocommerce_currency_symbols', 'use_currency_codes' );
function use_currency_codes( $symbols )
{
    // Replace all symbols with their currency codes
    foreach ( $symbols as $code => $symbol )
    {
        $symbols[$code] = $code;
    }
    return $symbols;
}

Important Compatibility Notes

Filter Priority

These filters are applied in this order during price formatting:

1. raw_woocommerce_price – Modify raw number
2. formatted_woocommerce_price – Modify formatted string
3. woocommerce_price_trim_zeros – Trim zeros if enabled
4. wpd_price – Final HTML output (Alpha Insights specific)

WooCommerce Compatibility

• These filters maintain compatibility with WooCommerce core
• Changes affect both WooCommerce and Alpha Insights
• Test in both WooCommerce frontend and Alpha Insights admin
• Some third-party WooCommerce plugins may also use these filters

Best Practices

• Use Alpha Insights specific filters (wpd_*) when possible
• Only use WooCommerce filters when you need global changes
• Test thoroughly with different price values and currencies
• Consider multi-currency plugin compatibility
• Document any modifications for future reference

Performance Considerations

• These filters run on EVERY price display
• Keep logic lightweight and fast
• Avoid database queries or API calls
• Cache results when possible
• Use early returns to minimize processing

Debugging All Price Filters

// Log all price filter stages
add_filter( 'raw_woocommerce_price', 'debug_raw_price', 999, 2 );
function debug_raw_price( $price, $original )
{
    error_log( '1. Raw Price: ' . $price );
    return $price;
}
add_filter( 'formatted_woocommerce_price', 'debug_formatted_price', 999, 6 );
function debug_formatted_price( $formatted, $price, $decimals, $dec_sep, $thou_sep, $original )
{
    error_log( '2. Formatted Price: ' . $formatted );
    return $formatted;
}
add_filter( 'wpd_price', 'debug_final_price', 999, 5 );
function debug_final_price( $return, $price, $args, $unformatted, $original )
{
    error_log( '3. Final HTML: ' . $return );
    return $return;
}

Related Alpha Insights Filters

• wpd_price – Alpha Insights specific price HTML filter
• wpd_woocommerce_currency_symbol – Alpha Insights specific symbol filter

WooCommerce Documentation

For more information about these filters, see:

• WooCommerce Filters Documentation
• WooCommerce Price Filters Reference