Модуль перевода в Medusa: стабильность и новые возможности
Модуль перевода стал стабильной частью платформы Medusa. С недавним обновлением мы убрали экспериментальный статус и флаг функции, что означает, что модуль теперь включен по умолчанию в каждом приложении Medusa. Это значительное улучшение, которое открывает новые горизонты для разработчиков и владельцев интернет-магазинов.
Продукты, варианты, категории, коллекции, типы, теги, опции и значения опций
Способы доставки и типы способов доставки
Регионы и налоговые ставки
Группы клиентов
Причины возврата и причины возврата средств
При запросе на витрине магазина язык указывается с помощью параметра `locale` или заголовка `x-medusa-locale`. Если перевод отсутствует, Medusa возвращает оригинальное значение. Также корзины теперь содержат информацию о языке, которая передается в заказ при его завершении. Элементы заказа остаются на языке, на котором клиент делал покупки.
Расширение функционала перевода
Переводы были введены как экспериментальная функция еще в прошлом году, охватывающая только модуль продуктов. С тех пор мы значительно расширили функционал, добавив поддержку перевода для других модулей электронной коммерции, а также для пользовательских моделей данных. В Medusa Admin теперь доступно больше инструментов для работы с переводами.Переводы для основных модулей
Теперь вы можете переводить следующие ресурсы без дополнительных настроек:Перевод пользовательских моделей данных
Переводы больше не ограничиваются только основными ресурсами. Вы можете пометить свойство вашей модели данных как переводимое с помощью одного метода. После этого модель появится в 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