Системные настройки

Все ключи в пространстве имён mscurrency. Области: main, rates, frontend.

Основные

Ключ	По умолчанию	Описание
mscurrency_selected_currency_default	0	ID валюты из справочника, если посетитель ещё не выбирал. 0 — базовая валюта
mscurrency_order_price_mode	base	При base суммы в корзине и заказе в базовой валюте. При user — в валюте покупателя
mscurrency_payment_currency_option	пусто	Имя системной опции MODX (например ms2_payment_unitpay_currency). Пустое значение — плагин не пишет код, см. Интеграция
mscurrency_geoip_enabled	0	Автовыбор валюты по стране при первом визите. Требует плагин mscurrency_detect
mscurrency_geoip_respect_manual	1	Не перезаписывать валюту после ручного переключения на витрине (msc_currency_manual в сессии)

mscurrency_selected_currency_default

Можно задать отдельно для контекста: Система → Контексты → контекст → Настройки контекста → ключ mscurrency_selected_currency_default со значением ID валюты. Глобальное значение — в системных настройках.

mscurrency_order_price_mode

Значение	Поведение
base	Переключатель меняет только отображение на витрине. Корзина и заказ остаются в базовой валюте
user	Плагин на msOnGetProductPrice пересчитывает цены в корзине. Символ валюты задаёт msc_sync_ms3_price_symbol()

В менеджере настройка отображается выпадающим списком (xtype modx-combo-mscurrency-order-price-mode). Плагин mscurrency_mgr_settings подключает combo и подписи из лексикона. Если видите textfield или пустой список — проверьте плагин и очистите кэш менеджера.

Снимок валюты в order.properties.msc / properties.msmc сохраняется в обоих режимах.

Курсы

Ключ	По умолчанию	Описание
mscurrency_default_provider	cbr_ru	Код провайдера для cron и выборочной синхронизации: cbr_ru, ecb_euro, nbu_ua, nbrb_by, nbk_kz
mscurrency_stale_rate_days	7	Порог «курс устарел» на вкладке Дашборд курсов (дней без sync)

Это внутренний ключ класса, не API-токен. Провайдер ECB (ecb_euro) отдаёт котировки в EUR — sync пропустит его, если базовая валюта магазина не EUR. Для платных API ключ хранится в своём провайдере — см. Управление валютами.

Витрина

Ключ	По умолчанию	Описание
mscurrency_frontend_css	[[++assets_url]]components/mscurrency/css/web/default.min.css	CSS переключателя валют
mscurrency_frontend_js	[[++assets_url]]components/mscurrency/js/web/default.min.js	JS переключателя (POST web/currency/set)
mscurrency_ajax_switch	0	При 1 — обновление [data-msc-price] и mfilter.reload() без полной перезагрузки. При 0 — reload страницы

Плагин mscurrency_frontend подключает CSS/JS на витрине и обновляет плейсхолдеры msc.*. Других параметров сниппета для подключения assets нет — правьте пути только здесь.

Связанные настройки MiniShop3

Формат выведенной цены берётся из MS3:

Ключ MS3	Описание
ms3_price_format	JSON: знаков после запятой, разделитель дробной части, разделитель тысяч
ms3_price_format_no_zeros	Убрать хвостовые нули (15.00 → 15)

Рекомендуемые профили

Только отображение в другой валюте, оплата в базовой валюте

• mscurrency_order_price_mode = base
• Cron курсов 1–2 раза в сутки

Полная мультивалютность на витрине и в заказе

• mscurrency_order_price_mode = user
• msCurrencyCart / msCurrencyGetOrder в чанках корзины и «спасибо за заказ»
• Плагин mscurrency_payment_currency + mscurrency_payment_currency_option для платёжного шлюза

AJAX без перезагрузки страницы

• mscurrency_ajax_switch = 1
• На карточке и в каталоге — msCurrencyPrice с pid > 0 (обёртка [data-msc-price])
• Для mFilter — mfilter-currency.js после default.min.js

Автовалюта по региону

• Плагин mscurrency_detect включён
• mscurrency_geoip_enabled = 1, mscurrency_geoip_respect_manual = 1
• CDN или веб-сервер проставляет заголовок страны (HTTP_CF_IPCOUNTRY, GEOIP_COUNTRY_CODE)

Несколько языковых/региональных контекстов

• В каждом контексте свой mscurrency_selected_currency_default (например UAH для ua, KZT для kz)

Проверка в шаблоне

fenom

{'!msCurrency' | snippet : ['tpl' => 'tpl.msCurrency']}
<span class="price">
  {'!msCurrencyPrice' | snippet : ['price' => $price, 'pid' => $_modx->resource.id]}
</span>

modx

[[!msCurrency? &tpl=`tpl.msCurrency`]]
<span class="price">
  [[!msCurrencyPrice?
    &price=`[[!+price]]`
    &pid=`[[*id]]`
  ]]
</span>

См. также

• Быстрый старт
• Интеграция
• Управление валютами