指南/WooCommerce 貨幣換算

WooCommerce 貨幣換算

WooCommerce 貨幣換算. 包含程式碼、快取及數據新鮮度的實用指南。

ERexchangerate.dev·Sep 20, 2026·閱讀約 7 分鐘

在伺服器實作,不公開憑證,並保留數據來源及觀測時間。

重點
只在伺服器保存 API 金鑰。
驗證貨幣代碼及金額。
快取成功回應。
顯示來源及觀測時間。

步驟 1

程式碼範例copy
function exr_convert_for_display($amount, $from, $to) {
    $from = strtoupper(sanitize_text_field($from));
    $to = strtoupper(sanitize_text_field($to));
    $cache_key = 'exr_' . md5($from . '_' . $to);
    $rate = get_transient($cache_key);

    if ($rate === false) {
        $url = sprintf('https://api.exchangerate.dev/v1/convert/%s/%s/1', $from, $to);
        $response = wp_remote_get($url, array(
            'timeout' => 5,
            'headers' => array('Authorization' => 'Bearer ' . EXCHANGERATE_API_KEY),
        ));
        if (is_wp_error($response) || wp_remote_retrieve_response_code($response) !== 200) {
            return null;
        }
        $body = json_decode(wp_remote_retrieve_body($response), true);
        $rate = isset($body['rate']) ? (string) $body['rate'] : null;
        if ($rate === null) return null;
        set_transient($cache_key, $rate, MINUTE_IN_SECONDS);
    }

    return (float) $amount * (float) $rate;
}

步驟 2

請在伺服器執行、驗證輸入,並保留回應元數據。

程式碼範例copy
add_filter('woocommerce_get_price_html', function ($html, $product) {
    $estimate = exr_convert_for_display((float) $product->get_price(), 'USD', 'EUR');
    if ($estimate === null) return $html;
    return $html . '<small class="fx-estimate">Estimated ' .
        wp_kses_post(wc_price($estimate, array('currency' => 'EUR'))) . '</small>';
}, 10, 2);

步驟 3

  • 只在伺服器保存 API 金鑰。
  • 驗證貨幣代碼及金額。
  • 快取成功回應。
  • 顯示來源及觀測時間。
指南
這些匯率只供參考,並非結算價格。
ER
exchangerate.dev
為開發者而設的實用貨幣數據指南。

延伸閱讀

指南開發者貨幣換算 API閱讀 指南Shopify 貨幣換算閱讀 指南Exchange rates for SaaS billing閱讀