Currencies

The list of available currencies of this store, as well as their exchange rate, is configured in the Settings tab.

Available currencies

The list of available currencies is presented according to the ISO 4217 standard.

To view the entire list of available currencies in your controller, simply call the sCommerce::getCurrencies() method. This will return the entire list available for ISO 4217.

use Seiger\sCommerce\Facades\sCommerce;
...

$currencies = sCommerce::getCurrencies();
dd($currencies);
...

Illuminate\Support\Collection {#1351 ▼
  #items: array:158 [▼
    0 => array:6 [▼
      "name" => "UAE Dirham"
      "alpha" => "AED"
      "numeric" => "784"
      "symbol" => "د.إ"
      "exp" => 2
      "country" => "AE"
    ]
    1 => array:6 [▶]
    ...
    157 => array:6 [▶]
  ]
  #escapeWhenCastingToString: false
}

Currency data includes:

• currency name
• alphanumeric currency code
• digital currency code
• an international symbol
• the number of decimal places
• countries of distribution

Product price and currency

You have the opportunity to set the price of the product depending on the selected currency. The currency for all product prices is selected for the Price field. If you use more than one currency in your store, you must make sure that one of the currencies available for the site is added to the user session, the list of which is configured in the Admin Panel -> Modules -> Commerce -> Settings tab.

You can use your site’s base controller to set the currency for the user by default.

if (!isset($_SESSION['currency'])) {
    $_SESSION['currency'] = 'USD';
}

If this is not done, then the default currency of the user will be the currency selected as Main currency in the store configuration.

If there is a need to show the product price regardless of the user’s currency selection, then use the following function:

echo $product->priceTo('EUR');

The priceTo('XXX') method will display the product price converted to the selected currency in the form of a string formatted according to the sCommerce configuration.

If you want to get only an unformatted number with the price in the selected currency, then use the priceToNumber('XXX') method.

Exchange rate

The list for the exchange rate is generated automatically if more than one available currency is selected. The list of rates is formed as a given currency (XXX) –> its equivalent in another currency (XXX).

If under any circumstances the exchange rate is 0, or is not found, the exchange rate will be displayed as 1:1.