Hooks Archive - WooCommerce Currency Switcher

Content of the page

woocs_currency_manipulation_before_show

Allows to manipulate with currencies before showing their drop-downs on the front, example:

add_filter('woocs_currency_manipulation_before_show', function($currencies) {
    $any_conditions = true;

    if ($any_conditions) {
        unset($currencies['RUB']);
        unset($currencies['GBP']);
    }

    return $currencies;
});

add_filter('woocs_currency_manipulation_before_show', function($currencies) {

$any_conditions = true;

if ($any_conditions) {

unset($currencies['RUB']);

unset($currencies['GBP']);

}

return $currencies;

});

Structure of the data in variable $currencies in the example above is:

Array
(
    [USD] => Array
        (
            [name] => USD
            [rate] => 1
            [symbol] => &#36;
            [position] => left
            [is_etalon] => 1
            [hide_cents] => 0
            [decimals] => 2
            [description] => United States dollar
            [flag] => ''
        )
    [GBP] => Array
        (
            [name] => GBP
            [rate] => 0.80
            [symbol] => &pound;
            [position] => left
            [is_etalon] => 0
            [hide_cents] => 0
            [decimals] => 2
            [description] => British pound
            [flag] => ''
        )

    [UAH] => Array
        (
            [name] => UAH
            [rate] => 26.069684
            [symbol] => грн.
            [position] => left
            [is_etalon] => 0
            [hide_cents] => 0
            [decimals] => 2
            [description] => Украинская гривна
            [flag] => ''
        )

    [RUB] => Array
        (
            [name] => RUB
            [rate] => 62.218399
            [symbol] => руб.
            [position] => left
            [is_etalon] => 0
            [hide_cents] => 0
            [decimals] => 2
            [description] => Российский рубль
            [flag] => ''
        )

)

Array

(

[USD] => Array

(

[name] => USD

[rate] => 1

[symbol] => $

[position] => left

[is_etalon] => 1

[hide_cents] => 0

[decimals] => 2

[description] => United States dollar

[flag] => ''

)

[GBP] => Array

(

[name] => GBP

[rate] => 0.80

[symbol] => £

[position] => left

[is_etalon] => 0

[hide_cents] => 0

[decimals] => 2

[description] => British pound

[flag] => ''

)

[UAH] => Array

(

[name] => UAH

[rate] => 26.069684

[symbol] => грн.

[position] => left

[is_etalon] => 0

[hide_cents] => 0

[decimals] => 2

[description] => Украинская гривна

[flag] => ''

)

[RUB] => Array

(

[name] => RUB

[rate] => 62.218399

[symbol] => руб.

[position] => left

[is_etalon] => 0

[hide_cents] => 0

[decimals] => 2

[description] => Российский рубль

[flag] => ''

)

from ver.2.2.4/1.2.4

woocs_fixed_raw_woocommerce_price

Hook for fixed prices. Need for compatibility with other plugins, for example: https://currency-switcher.com/woocommerce-extra-product-options-themecomplete/

woocs_cut_cart_price_format

Allows to cut from cart and checkout page ‘format of price’ provided by ‘Custom price format’ plugin option. By default return TRUE, but its possible return FALSE

add_action( 'woocs_cut_cart_price_format', function(){
    return FALSE;
});

add_action( 'woocs_cut_cart_price_format', function(){

return FALSE;

});

woocs_form_method

Allows to change WOOCS form method from POST to GET

add_action( 'woocs_form_method', function(){
    return 'get';
});

add_action( 'woocs_form_method', function(){

return 'get';

});

From 2.2.0/1.20

woocs_woocommerce_variation_prices

Works in index.php -> public function woocommerce_variation_prices -> can be used for any manipulations with variable prices, for example rounding of them. Example:

add_filter('woocs_woocommerce_variation_prices', function($price) {
    return round($price * 2, 0) / 2;
});

add_filter('woocs_woocommerce_variation_prices', function($price) {

return round($price * 2, 0) / 2;

});

woocs_currname_in_option

The hook is applied in file wp-content\plugins\woocommerce-currency-switcher\views\shortcodes\woocs.php for the text manipulation in the switchers drop-down. Example:

add_filter('woocs_currname_in_option', function($currency_name){
    //return "Hello " . $currency_name . '!!';
    return "";
});

add_filter('woocs_currname_in_option', function($currency_name){

//return "Hello " . $currency_name . '!!';

return "";

});

Use it by your own logic. Customer request: How can i make sure that there is only a currency symbol in the dropdown without editing the plugin files, so updates are possible. DDSlick dropdown preferred

woocs_force_pay_bygeoip_rules

This hook allows to manipulate by currency on the checkout page if in tab Advanced enabled “Checkout by GeoIP rules” option. If “Checkout by GeoIP rules” is enabled and country not described in GEO-IP rules checkout will be done with currency selected by user. Using this hook its possible to change this situation:

add_action('woocs_force_pay_bygeoip_rules', function($country, $user_currency, $current_currency) {
    global $WOOCS;
    if (!empty($user_currency))
    {
        $WOOCS->set_currency($user_currency);
    }
}, 9999, 3);

add_action('woocs_force_pay_bygeoip_rules', function($country, $user_currency, $current_currency) {

global $WOOCS;

if (!empty($user_currency))

{

$WOOCS->set_currency($user_currency);

}

}, 9999, 3);

Or… read more

woocs_raw_woocommerce_price

Use this hook to manipulate by price values, for example rounding price by your own logic. Examples: https://currency-switcher.com/how-to-round-price-to-50-cents/ – rounding price to the nearest 50 cents

add_filter('woocs_raw_woocommerce_price', function($price) {
    return round($price * 2, 0) / 2;
});

add_filter('woocs_raw_woocommerce_price', function($price) {

return round($price * 2, 0) / 2;

});

https://currency-switcher.com/round-prices-500/ – How to round prices to 500

add_filter('woocs_raw_woocommerce_price', function($price) {
    if (($price <= 1000))
    {
        $price = round($price / 1000, 0) * 1000;
        return $price;
    } else
    {
        $price = ceil($price / 500) * 500;
        return $price;
    }
});

add_filter('woocs_raw_woocommerce_price', function($price) {

if (($price <= 1000))

{

$price = round($price / 1000, 0) * 1000;

return $price;

} else

{

$price = ceil($price / 500) * 500;

return $price;

}

});

Also read: https://currency-switcher.com/hook/woocs_woocommerce_variation_prices/

woocs_get_approximate_amount_text

Use this hook when you activated ‘Show approx. amount’ option in the plugin settings and you want to change default text on the cart/checkout page generated by this feature ‘(Approx. %s)’ to smth another. Example:

add_filter('woocs_get_approximate_amount_text', 'my_woocs_get_approximate_amount_text', 999, 2);
function my_woocs_get_approximate_amount_text($text, $wc_price)
{
    return sprintf(__('(My Approx. %s)'), $wc_price);
}

add_filter('woocs_get_approximate_amount_text', 'my_woocs_get_approximate_amount_text', 999, 2);

function my_woocs_get_approximate_amount_text($text, $wc_price)

{

return sprintf(__('(My Approx. %s)'), $wc_price);

}

$text (string) $wc_price (string) ‘Show approx. amount’ – Show approximate amount on the checkout and the cart page with currency of… read more

woocs_price_html_tail

Use this hook if you want to add any additional information text after a product price on the shop/category page. Example:

add_filter('woocs_price_html_tail', function($price_html)
{
    return $price_html . "<strong>Hello World!</strong>";
});

add_filter('woocs_price_html_tail', function($price_html)

{

return $price_html . "<strong>Hello World!</strong>";

});

Combine it with CSS (in style.css) code if necessary:

.woocs_price_html_tail{
    display: none;    
}

body.single-product .woocs_price_html_tail{
    display: block;
}

body.single-product .related .woocs_price_html_tail{
    display: none;
}

.woocs_price_html_tail{

display: none;

}

body.single-product .woocs_price_html_tail{

display: block;

}

body.single-product .related .woocs_price_html_tail{

display: none;

}