Многоязычность и мультивалютность OpenCart: чек-лист

В OpenCart 4.x многоязычный каталог и несколько валют можно подготовить за один рабочий день, если товары, цены, налоги, SEO-URL и оформление заказа проверять как единую цепочку. Простое добавление языка и валюты в админке не гарантирует результат: часть расширений может брать подписи из собственного файла перевода, а платёжный модуль — игнорировать валюту витрины.

Сначала зафиксируйте матрицу магазина

До настройки выпишите, какие сочетания языка, страны и валюты реально поддерживает магазин. Не добавляйте язык только потому, что он доступен в каталоге OpenCart: для него понадобятся переводы товаров, категорий, атрибутов, писем, ошибок checkout и контента в расширениях.

• Языки: например, русский и английский. Укажите язык по умолчанию и язык для новых посетителей.
• Валюты: базовая валюта магазина, валюта отображения и валюты, которые принимает платёжный провайдер.
• Рынки: страны доставки, налоговые правила, доступные способы оплаты и формат адреса.
• Контент: названия, описания, SEO-поля, атрибуты, варианты товара, письма и системные сообщения.

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

Переключатель языка меняет текст, а мультивалютность меняет деньги. Перед продакшеном нужно проверить не кнопку в шапке, а весь путь от карточки товара до письма об оплате.

Локаль — набор региональных правил для языка и страны: формат даты, разделитель дробной части, разделитель тысяч, порядок элементов адреса и иногда правила округления. Язык интерфейса и локаль — не одно и то же.

Проверьте языки на уровне данных

1. Настройки языка и локали

В разделе локализации проверьте код языка, каталог перевода, статус и сортировку. Для OpenCart 4.x сверяйте настройку с документацией именно вашей сборки; в OpenCart 3.x структура языковых файлов и совместимость расширений могут отличаться.

• Откройте главную страницу, категорию, карточку товара, поиск, корзину и checkout на каждом языке.
• Проверьте дату, десятичный разделитель, формат телефона и адреса.
• Смените язык на странице товара и убедитесь, что вы остались на том же товаре, а не попали на главную.
• Отправьте тестовый заказ и проверьте язык письма клиенту и уведомления администратору.

Проверка считается успешной, если в интерфейсе не осталось ключей вроде text_cart, пустых заголовков и английских системных сообщений в русской версии.

2. Переводы товаров, категорий и SEO-полей

Проверьте не только название и описание. В OpenCart отдельные локализованные значения могут использоваться для мета-заголовка, мета-описания, тегов, названий категорий и параметров товара.

• В каждой языковой версии заполнены название, описание и метаданные товара.
• Переведены названия категорий, фильтров, атрибутов и опций.
• Варианты товара не потеряли цену, остаток и изображение после переключения языка.
• В хлебных крошках, меню и результатах поиска нет языка по умолчанию вместо выбранного.

Не копируйте машинный перевод без проверки единиц измерения и терминов. Ошибка в названии опции вроде «размер» или «объём» может привести не только к плохому SEO, но и к неверному заказу.

Проверьте URL и индексацию

Для каждого языка выберите одну схему URL и не смешивайте её с другой на продакшене. Это может быть отдельный префикс языка, домен или иной способ, который поддерживает ваша версия OpenCart и SEO-расширение. Важно не само название схемы, а стабильность адресов и корректные канонические ссылки.

• Откройте по одной странице товара и категории на каждом языке в чистом браузере.
• Проверьте, что адреса не содержат дубликатов с разным регистром, двойных слешей и пустых сегментов.
• Убедитесь, что переключатель языка ведёт на локализованный URL текущей страницы.
• Проверьте canonical, hreflang, sitemap и robots.txt с учётом выбранной схемы.
• Старые адреса после миграции должны вести на соответствующие новые страницы, а не на главную.

Не включайте автоматическую генерацию SEO-URL без проверки коллизий. Одинаковые слаги у товаров на разных языках могут привести к тому, что одна страница будет недоступна или начнёт открывать другой товар.

Настройте валюты без скрытой арифметики

В OpenCart у валюты есть код, символ, курс, статус и порядок показа. Сначала определите базовую валюту магазина, затем задайте способ формирования остальных курсов. Цена в каталоге, сумма заказа, доставка, налог и платёжный модуль должны использовать одну и ту же логику пересчёта.

Три способа задавать курс

Автоматический курс не всегда равен коммерческой цене. Комиссия платёжного провайдера, банковское округление и психологические цены могут требовать отдельного прайс-листа. Если используется расширение, убедитесь, что оно совместимо именно с OpenCart 4.x или 3.x, а не только с названием платформы.

Проверка расчёта заказа

1. Откройте товар с дробной ценой и запишите сумму в базовой валюте.
2. Переключите валюту и сравните цену товара, стоимость опции, скидку, доставку и налог.
3. Добавьте товар в корзину, измените количество, примените купон и перейдите к оформлению.
4. Завершите тестовый заказ каждым доступным способом оплаты.
5. Сравните сумму на странице подтверждения, в письме, в заказе администратора и в платёжной системе.

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

Что ломается перед запуском

• Переведена витрина, но не checkout. Проверьте языковые файлы темы, доставки, оплаты и расширений. У стороннего модуля может быть собственный каталог переводов.
• Валютный переключатель меняет символ, но не сумму. Проверьте курс, статус валюты и кеш. После изменения курса очистите кеш OpenCart, темы и CDN, если они используются.
• Цена в заказе отличается от цены в каталоге. Ищите повторный пересчёт в скидке, налоге, доставке, опции или платёжном модуле. Сравнивайте значения в заказе и в запросе к платёжному провайдеру.
• После переключения языка открывается 404. Проверьте SEO-URL, правила веб-сервера, наличие перевода слага и работу расширения маршрутизации.
• Письмо приходит на одном языке. Создайте тестовый заказ с каждым языком и проверьте шаблон письма, язык заказа и настройки уведомлений.

Финальный прогон перед продакшеном

Тестируйте не только авторизованного администратора. Очистите cookies, откройте магазин в приватном окне и пройдите сценарий как новый покупатель. Отдельно проверьте мобильную версию: длинные переводы часто ломают меню, кнопки и блок выбора валюты.

• Проверены все языки и валюты из матрицы магазина.
• Создан тестовый заказ для каждой комбинации языка, валюты, доставки и оплаты.
• Суммы совпадают в каталоге, корзине, checkout, письме, админке и платёжной системе.
• Нет пустых переводов, технических ключей, битых ссылок и дублей SEO-URL.
• Кеш очищен после финальных изменений, а резервная копия базы и файлов создана.
• Зафиксированы курс, версия OpenCart, версии темы и расширений на момент запуска.

После публикации не меняйте сразу все параметры. Сначала отслеживайте ошибки checkout, отменённые платежи, заказы с неожиданной валютой и обращения о неверной цене. Следующий полезный шаг — настроить отдельный мониторинг тестового заказа и повторять его после обновления OpenCart, темы, валютного или платёжного расширения.