Форматирование цен: разделители и символ валюты

Формат цены — это не косметика, а часть модуля currency. От того, как заданы разделитель разрядов, число знаков после запятой и положение символа валюты, зависит, как цена выглядит на витрине, в корзине, в письмах и в печатных формах заказа. Настраивается это в одном месте, а действует по всему магазину.

Где живёт формат цены

Формат вывода задаётся не в шаблоне и не в свойствах товара, а в самой валюте. Идём в Магазин → Настройки → Валюты (модуль currency), открываем нужную валюту и переходим на языковую вкладку — например, Русский. Именно на этой вкладке лежат все параметры отображения, потому что формат зависит от языка интерфейса: одна и та же валюта может выводиться по-разному для русской и английской версий сайта.

Ключевые поля вкладки:

• Формат — шаблон вывода с плейсхолдером #, куда подставляется число (например, # руб. или $#);
• Десятичных знаков — сколько цифр показывать после запятой (обычно 2 или 0);
• Десятичный разделитель — символ дробной части (запятая или точка);
• Разделитель групп разрядов — символ между тысячами (пробел, точка или пусто);
• Скрывать нули в дробной части — убирать ,00 у целых сумм.

Символ валюты и его положение

Положение символа определяет плейсхолдер # в поле «Формат». Слева от него — символ идёт перед числом, справа — после. Битрикс не имеет отдельной галочки «символ слева/справа»: вы просто пишете шаблон так, как нужно видеть цену.

Символ рубля ₽ — это обычный Unicode-символ, его можно вставить прямо в поле «Формат». Если он отображается «квадратиком», проблема в шрифте темы, а не в настройке валюты. Между # и символом ставьте неразрывный пробел, чтобы цена не переносилась на две строки в узкой карточке товара.

Разделители разрядов и дробной части

Российский стандарт: разряды разделяются пробелом, дробная часть — запятой. То есть 1 250,50, а не 1,250.50 по-английски. Это задаётся двумя полями:

1. Разделитель групп разрядов — ставим пробел. Технически рекомендуется неразрывный пробел, чтобы число не рвалось при переносе;
2. Десятичный разделитель — ставим запятую.

Число знаков после запятой (Десятичных знаков) для рублёвого магазина обычно 2. Если товары продаются только целыми суммами, поставьте 0 — тогда копейки не будут показываться вовсе. Промежуточный вариант — оставить 2 знака, но включить «Скрывать нули в дробной части»: цена 1 250,00 покажется как 1 250, а 1 250,50 — как есть.

Как выводить цену в коде правильно

Чтобы формат применялся автоматически, цену нужно прогонять через API модуля валют, а не собирать строку руками. Основной метод — CurrencyFormat($price, $currency, $useTemplate = true):

• CurrencyFormat(1250.5, 'RUB') вернёт готовую строку с символом и разделителями — 1 250,50 руб.;
• в D7 то же делает \Bitrix\Currency\CurrencyManager и CCurrencyLang::CurrencyFormat();
• компоненты каталога и корзины (catalog.section, sale.basket.basket) уже возвращают отформатированную цену в поле PRINT_VALUE / PRICE_FORMATED.

Практическое правило: в шаблоне берите готовое PRINT_VALUE, а «сырое» число VALUE используйте только для расчётов и микроразметки schema.org/Offer, где нужна цена без символов и пробелов (иначе цена не пройдёт валидацию для Google и Яндекса).

Разные языки и несколько валют

Поскольку формат привязан к языку, на мультиязычном сайте у каждой валюты будет отдельная настройка под каждый язык. Для рубля на русском разумно писать # руб. или # ₽, а на английской версии — # RUB, чтобы иностранный покупатель понимал валюту. Заводить эти строки нужно вручную: при добавлении новой валюты Битрикс не заполняет форматы за вас.

Если в каталоге несколько валют и включён пересчёт по курсу, формат берётся у той валюты, в которой цена показывается покупателю после конвертации, а не у валюты хранения. Это важно помнить при отладке: цена конвертируется в валюту показа, и уже её формат применяется к результату.

Типичные ошибки и как их избежать

Что чаще всего ломает вид цены на боевых проектах:

• Хардкод символа в шаблоне. В коде написано $price . ' руб.' — при смене валюты или добавлении языка везде остаётся рубль. Лечится переходом на CurrencyFormat() и PRINT_VALUE;
• Обычный пробел вместо неразрывного в разделителе разрядов — цена рвётся на две строки в узкой карточке;
• Разные форматы у одной валюты для разных языков, из-за чего в письме и на витрине цена выглядит по-разному;
• Кэш. После правки формата старая цена держится в кэше каталога — нужно сбросить кэш компонентов (Настройки → Кэширование или очистка /bitrix/cache/);
• Путаница формата и округления — на витрине 0 знаков, а в корзине копейки, потому что округление по типу цены не настроено.

Итог

Формат цены в 1С-Битрикс централизован: символ валюты, его положение, разделители разрядов и дробной части, число знаков после запятой — всё задаётся в валюте на языковой вкладке модуля currency и хранится в b_catalog_currency_lang. В коде цену выводят через CurrencyFormat() и готовое PRINT_VALUE, а не собирают строку руками. Держите отдельно две вещи: формат отвечает за вид, округление — за реальную сумму.

Если нужно навести порядок в ценах, курсах и форматировании по всему каталогу и корзине — мы настраиваем это в рамках разработки на 1С-Битрикс и интеграции с 1С, чтобы цена одинаково корректно выглядела на витрине, в письмах и в выгрузке заказов.