Модуль переводов стал стабильной частью Medusa. Мы убрали флаг функции и пометку «экспериментальная», и теперь модуль включен по умолчанию в каждом приложении Medusa.
Мы представили переводы как экспериментальную функцию еще в прошлом году, охватив только модуль товаров. С тех пор мы расширили покрытие на другие коммерческие модули, добавили поддержку пользовательских моделей данных и расширили инструментарий в Medusa Admin.
Переводы в основных коммерческих модулях
Теперь вы можете переводить следующие ресурсы «из коробки»:
- Товары, варианты, категории, коллекции, типы, теги, опции и значения опций
- Варианты доставки и типы вариантов доставки
- Регионы и налоговые ставки
- Группы клиентов
- Причины возврата и причины возмещения
Витрины запрашивают язык с помощью параметра запроса locale или заголовка x-medusa-locale. Если перевод отсутствует, Medusa возвращает исходное значение.
Корзины также содержат локаль, которая копируется в заказ при его оформлении. Позиции заказа остаются на том языке, на котором совершал покупки клиент.
Перевод пользовательских моделей данных
Переводы больше не ограничены основными ресурсами. Отметьте свойство вашей собственной модели данных как переводимое с помощью одного метода:
После этого модель появится в Medusa Admin рядом с основными ресурсами. Чтобы получить переведенные записи, передайте локаль запроса в Query:
Маршруты в /store автоматически получают req.locale. Для других маршрутов используйте промежуточное ПО applyLocale. Полная настройка описана в руководстве по пользовательским моделям данных.
Управление переводами с помощью агентов
Если ваш магазин работает на Medusa Cloud, вы можете подключить к нему Claude, ChatGPT, Codex или другой ИИ-инструмент с помощью Medusa MCP. Инструмент может считывать ваши локали, переводимые ресурсы и сам переведенный контент.
Это позволяет вам на обычном языке спрашивать, какая часть вашего магазина переведена на каждую локаль, какие записи не имеют перевода или что видят клиенты на определенном языке. Инструмент также может подготовить черновики недостающих переводов, которые вы сможете добавить в Medusa Admin.
Чтобы записывать переводы, предоставьте агенту по написанию кода, такому как Claude Code или Codex, ключ API администратора и укажите маршрут API Manage Translations. Один запрос создает, обновляет или удаляет переводы массово, поэтому агент может заполнить все пробелы, обнаруженные при аудите, за один проход.
Возможность записи переводов напрямую через Medusa MCP появится в ближайшее время.
Управление переводами в Medusa Admin
Ваши агенты уже сегодня могут работать с модулем переводов.
Если ваш магазин работает на Medusa Cloud, подключите к нему Claude, ChatGPT, Codex или другой ИИ-инструмент с помощью Medusa MCP. Агент может считывать ваши локали, переводимые ресурсы и сам переведенный контент. Спрашивайте на обычном языке, какая часть вашего магазина переведена на каждую локаль, какие записи не имеют перевода или что видят клиенты на определенном языке.
- Редактируйте переводы массово в редакторе в стиле электронных таблиц, переключаясь между локалями магазина
- Выбирайте, какие ресурсы и какие их поля подлежат переводу
- Отслеживайте прогресс с помощью счетчиков переведенных полей для каждого ресурса и каждой локали
- Переводите отдельную запись со страницы ее деталей, например, со страницы товара
Разработчики могут автоматизировать те же операции с помощью рабочих процессов перевода в @medusajs/core-flows, например, для синхронизации контента из службы переводов.
Обновление и начало работы
Обновитесь до версии Medusa >= 2.22.7 и выполните npx medusa db:migrate. Если вы ранее включали экспериментальную версию, вы можете удалить флаг функции translation и запись модуля из medusa-config.ts.
Обратитесь к документации модуля переводов, чтобы узнать больше.












