The add-on allows you to configure the main and secondary currencies for each storefront language and automatically switch price display when the language changes.
Purpose
The add-on solves the multi-currency and multi-language task: for each language you can set a main currency (e.g. RUB for Russian, USD for English) and optionally a secondary currency for display in parentheses.
How it works
The add-on adds two columns to the languages table: ms_default_currency_code (main currency) and ms_secondary_currency_code (secondary). When displaying prices on the storefront, the overridden common/price.tpl template is used. Depending on the "Switch currency automatically" setting and the selected language, prices are displayed in the corresponding currency.
With automatic currency switching enabled, when loading a page without an explicitly selected currency in the URL, the currency corresponding to the current language is used. A JavaScript hook updates the selected currency display in the panel.
Location in admin panel
Add-on settings: Administration → Add-ons → Add-on management → ms_price_change.
Currency settings per language: Administration → Languages → Languages — for each language set "MS: primary currency" and "MS: secondary currency" fields.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Buyers
- English
- Русский
- 4.18.X
- 4.17.X
Installation
Install the add-on via Administration → Add-ons → Add-on management. During installation, migrations are automatically executed to add columns to the languages table.
Currency settings per language
Go to Administration → Languages → Languages. For each language, edit the record and specify:
- MS: primary currency — the currency in which prices will be displayed when this language is selected (if automatic switching is enabled).
- MS: secondary currency — optionally a second currency to display in parentheses next to the main one.
Add-on settings
Open the ms_price_change add-on card in add-on management. Enable the "Switch currency automatically" option if you want the corresponding currency to be automatically applied on the storefront when the language is changed.
Verification
On the storefront, switch to another language. With automatic currency switching enabled, prices should be displayed in the currency set for the selected language. If a secondary currency is set, it is displayed next to the main one.
Maintenance
Update the add-on via standard CS-Cart mechanisms or the add-on repository. Migrations are executed automatically during updates.
v1.1.0
20.02.2026
- [\*] Module template updated
v1.0.2
16.10.2023
- [\*] Adjusted styles for unit theme for carousel and cart popup
- [+] Module standardization
v1.0.1
14.09.2023
- [\*] Short tags <? changed to regular <?php
- [!] Fixed template file structure error
- [!] Fixed template display error
- [+] Added ability to select default and secondary currency per language for storefront display
v1.0.0
04.07.2023
- [+] First release
Legend:
[+] Added | [-] Removed | [\*] Changed | [!] Bug fix
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.