Interpreter.ru 🛡 В админку
Электронная коммерция • 21.11.2026 • рейтинг 6

Модуль перевода в Medusa: стабильность и новые возможности

Модуль перевода в Medusa: стабильность и новые возможности
Модуль перевода стал стабильной частью платформы Medusa. С недавним обновлением мы убрали экспериментальный статус и флаг функции, что означает, что модуль теперь включен по умолчанию в каждом приложении Medusa. Это значительное улучшение, которое открывает новые горизонты для разработчиков и владельцев интернет-магазинов.

Расширение функционала перевода

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

Переводы для основных модулей

Теперь вы можете переводить следующие ресурсы без дополнительных настроек:
  • Продукты, варианты, категории, коллекции, типы, теги, опции и значения опций
  • Способы доставки и типы способов доставки
  • Регионы и налоговые ставки
  • Группы клиентов
  • Причины возврата и причины возврата средств
  • При запросе на витрине магазина язык указывается с помощью параметра `locale` или заголовка `x-medusa-locale`. Если перевод отсутствует, Medusa возвращает оригинальное значение. Также корзины теперь содержат информацию о языке, которая передается в заказ при его завершении. Элементы заказа остаются на языке, на котором клиент делал покупки.

    Перевод пользовательских моделей данных

    Переводы больше не ограничиваются только основными ресурсами. Вы можете пометить свойство вашей модели данных как переводимое с помощью одного метода. После этого модель появится в Medusa Admin рядом с основными ресурсами. Чтобы предоставить переведенные записи, передайте локаль запроса в маршруты. Для маршрутов, отличных от `/store`, примените промежуточное ПО `applyLocale`. Полная настройка пользовательских моделей данных описана в соответствующем руководстве.

    Управление переводами с помощью агентов

    Если ваш магазин работает на Medusa Cloud, вы можете подключить такие инструменты, как Claude, ChatGPT, Codex или другие AI-инструменты через Medusa MCP. Эти инструменты могут читать ваши локали, переводимые ресурсы и сами переведенные тексты. Это позволяет вам в простой форме узнать, насколько ваш магазин переведен на каждую локаль, какие записи нуждаются в переводе или что видят клиенты на определенном языке. Инструмент также может помочь в создании недостающих переводов, которые вы сможете добавить в Medusa Admin. Чтобы писать переводы, предоставьте агенту, такому как Claude Code или Codex, ключ API администратора и укажите маршрут Manage Translations API. Один запрос позволяет создавать, обновлять или удалять переводы оптом, что позволяет агенту заполнить все пробелы, найденные в аудите, за один раз. В ближайшее время будет доступна возможность написания переводов напрямую через Medusa MCP.

    Управление переводами в Medusa Admin

    Ваши агенты уже могут работать с модулем перевода. Если ваш магазин работает на Medusa Cloud, вы можете подключить Claude, ChatGPT, Codex или другой AI-инструмент через Medusa MCP. Агент сможет читать ваши локали, переводимые ресурсы и переведенный контент. Вы можете в простой форме узнать, насколько ваш магазин переведен на каждую локаль, какие записи нуждаются в переводе или что видят клиенты на определенном языке. В Medusa Admin доступен редактор в стиле таблицы для редактирования переводов оптом, с возможностью переключения между локалями магазина. Вы можете выбрать, какие ресурсы и какие из их полей переводимы, а также отслеживать прогресс с помощью подсчета переведенных полей по ресурсам и локалям. Также доступна возможность перевода одной записи с ее страницы, например, с детальной страницы продукта. Разработчики могут автоматизировать те же операции с помощью рабочих процессов перевода в `@medusajs/core-flows`, например, для синхронизации контента с сервисом перевода.

    Как начать работу

    Чтобы обновить систему, перейдите на Medusa версии `>= 2.22.7` и выполните команду `npx medusa db:migrate`. Если вы ранее включали экспериментальную версию, вы можете удалить флаг функции перевода и запись модуля из `medusa-config.ts`. Для получения дополнительной информации обратитесь к документации модуля перевода.
    Источник:   Medusa Blog