DOCS

Customize currency display

/

Görüntüleme para birimini özelleştirin

Hello'nın yabancı para birimi tutarlarını nasıl görüntülediğini geçersiz kılın.

JavaScript entegrasyonunuzda para birimi görüntüleme formatını özelleştirerek yabancı para birimlerinin sunumunu ihtiyaçlarınıza ve tercihlerinize göre ayarlayabilirsiniz.

Para birimi görüntüleme formatları 

Hello aşağıdaki para birimi görüntüleme formatlarını destekler:

  • symbol (varsayılan) - Yerelleştirilmiş bir para birimi sembolü görüntüleyin (örneğin, €123).
  • code - ISO para birimi kodunu kullanın (örneğin, 123 USD).
  • name - Yerelleştirilmiş para birimi adını görüntüleyin (örneğin, 123 dolar).

Para birimi görüntüleme formatını, Zonos.init yönteminde overrideCurrencyFormat özelliğini kullanarak geçersiz kılabilirsiniz. Bu özellik, yukarıda listelenen para birimi görüntüleme formatlarından birini kabul eder. Para birimi görüntüleme formatını geçersiz kılmak, hem Hello hem de Zonos Checkout için geçerlidir.

JavaScript

1
2
3
Zonos.init({
  overrideCurrencyFormat: 'code',
});

Özel bir döviz çevirici kullanma 

Sadece döviz görüntüleme formatını geçersiz kılmak, sitenizin ihtiyaçları için yeterli olmadığında, yabancı para birimi tutarlarının dönüşümünü ve biçimlendirilmesini yönetmek için özel bir döviz çevirici kullanabilirsiniz. Bu yaklaşım, döviz tutarlarının sitenizde nasıl görüntüleneceği üzerinde tam kontrol sahibi olmanızı sağlar.

Özel bir döviz çevirici kullanmak için, Zonos.init yönteminde currencyConverter fonksiyonunu uygulamanız gerekir. Bu fonksiyon aşağıdaki parametreleri kabul etmelidir:

  • convertAndFormat - Döviz tutarını dönüştüren ve biçimlendiren bir fonksiyon.
  • originalAmount - Orijinal döviz tutarı.
  • selector - Döviz tutarını içeren öğenin seçici.

Mevcut olduğunda, currencyConverter fonksiyonu sitenizdeki tüm eşleşen fiyat seçicileri üzerinde döngü yapacak ve her birine özel döviz dönüşüm mantığını uygulayacaktır.

Özel bir döviz çevirici fonksiyonu kullanmanın yaygın bir kullanım durumu, fiyatların bir açılır menüde veya diğer karmaşık HTML öğelerinde görüntülendiği durumdur. Örneğin, her seçeneğin yanında fiyatların görüntülendiği bir açılır menüye sahipseniz, şöyle olabilir:

HTML

1
2
3
4
5
6
7
8
9
10
11
<select title="Option">
  <option className="money" data-select-option="Blue" value="option1">
    Blue - $1.99
  </option>
  <option className="money" data-select-option="Red" value="option2">
    Red - $2.00
  </option>
  <option className="money" data-select-option="Yellow" value="option3">
    Yellow - $3.59
  </option>
</select>

Bu tür durumlarda, fiyatı doğrudan seçemezsiniz çünkü yanında ek metin bulunmaktadır. Özel bir döviz çevirici kullanarak, öğeden fiyatı çıkarabilir ve buna döviz dönüşüm mantığını uygulayabilirsiniz.

JavaScript

1
2
3
4
5
6
7
8
9
window.Zonos.init({
  currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {
    const optionValue = selector.getAttribute('data-select-option');
    if (optionValue) {
      return `${optionValue} -  ${convertAndFormat(originalAmount)}`;
    }
    return convertAndFormat(originalAmount);
  },
});

Bu sayfa yardımcı oldu mu?