プラグインWooCommerceのwc_get_price_decimalsフィルタの使用方法・解説

概要

wc_get_price_decimalsフィルタは、WooCommerceにおいて商品の価格の小数点以下の桁数を制御するために使用されます。このフィルタを利用することで、特定の条件に基づいて価格の表示形式を変更することができます。主に以下のような機能を実装する際に使われることが一般的です。

国や地域による価格設定の違いに対応する
特定の製品に対するカスタム価格表示を実装する
プロモーションやセール品に対して価格フォーマットを変更する
通貨の形式や小数点以下の扱いを変更する
特殊なビジネスニーズに応じた価格表示ルールの適用
商品の価格が整数の場合にのみ小数を表示する

構文

add_filter( 'wc_get_price_decimals', 'your_function_name' );

パラメータ

$decimals (int): 小数点以下の桁数のデフォルト値。

戻り値

int: 価格の小数点以下の桁数を返す。

対応バージョン

WooCommerce バージョン: 2.1 以降
WordPress バージョン: 4.0 以降

この関数のアクションでの使用可能性

アクション	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

サンプルコード

サンプルコード1

add_filter( 'wc_get_price_decimals', 'custom_price_decimals' );

function custom_price_decimals( $decimals ) {
    return 0; // 小数点以下を表示しない
}

このコードは、商品の価格を整数だけで表示し、小数点以下の桁数をゼロに設定します。これにより、すべての価格が整数として表示されます。

サンプルコード2

add_filter( 'wc_get_price_decimals', 'set_decimals_for_euros' );

function set_decimals_for_euros( $decimals ) {
    if ( get_woocommerce_currency() === 'EUR' ) {
        return 2; // ユーロの場合は小数点以下2桁
    }
    return $decimals;
}

このコードは、通貨がユーロ（EUR）の場合に価格の小数点以下を2桁に設定し、他の通貨ではデフォルトの桁数を維持します。

サンプルコード3

add_filter( 'wc_get_price_decimals', 'adjust_decimals_for_special_products' );

function adjust_decimals_for_special_products( $decimals ) {
    if ( is_product() && get_the_ID() === 123 ) {
        return 3; // 特定の商品IDの場合、小数点以下3桁
    }
    return $decimals;
}

このコードは、特定の製品（IDが123）に対して価格の小数点以下を3桁に設定します。他の商品はデフォルトの設定が適用されます。

サンプルコード4

add_filter( 'wc_get_price_decimals', 'set_decimals_based_on_user_role' );

function set_decimals_based_on_user_role( $decimals ) {
    if ( current_user_can('wholesale_customer') ) {
        return 1; // 卸売顧客には小数点以下1桁
    }
    return $decimals;
}

このコードは、現在のユーザーが「卸売顧客」の役割を持っている場合、価格の小数点以下を1桁に設定します。

サンプルコード5

add_filter( 'wc_get_price_decimals', 'apply_decimals_for_discounted_products' );

function apply_decimals_for_discounted_products( $decimals ) {
    global $post;
    if ( isset( $post ) && 'product' === get_post_type( $post ) && has_term( 'sale', 'product_cat' ) ) {
        return 2; // セール商品には小数点以下2桁
    }
    return $decimals;
}

このコードは、セールカテゴリーに属する商品に対して、価格の小数点以下を2桁に設定します。その他の商品はデフォルトの設定が適用されます。

概要

構文