Wtyczka Medusa Tolgee do obsługi wielu języków

O wtyczce

Wtyczka Medusa Tolgee do obsługi wielu języków integruje platformę Medusa eCommerce z Tolgee, platformą lokalizacyjną typu open-source, oferując łatwe rozwiązanie do zarządzania tłumaczeniami.

Zaprojektowana z myślą o prostocie, ta wtyczka upraszcza tłumaczenie danych produktów bez potrzeby używania skomplikowanych systemów CMS lub PIM. Wykorzystując moc Tolgee, użytkownicy mają dostęp do potężnych funkcji lokalizacyjnych bezpośrednio w panelu administracyjnym Medusa.

W tym artykule omówimy, jak używać tej wtyczki, przechodząc przez jej kluczowe funkcje.

Kluczowe funkcje Tolgee

• Tłumaczenie w kontekście: Wykorzystaj narzędzia programistyczne Tolgee do tłumaczenia treści bezpośrednio w interfejsie użytkownika, zapewniając intuicyjne tłumaczenie w czasie rzeczywistym.
• Pomoc w tłumaczeniu: Zwiększ dokładność i szybkość tłumaczeń dzięki automatycznym sugestiom obsługiwanym przez wiodące usługi AI, takich jak DeepL, Google Translate i AWS Translate.
• Współpraca: Usprawnij proces tłumaczenia dzięki funkcjom wspierającym współpracę, umożliwiając zespołom łatwe przeglądanie i zatwierdzanie tłumaczeń, zapewniając spójność i jakość.

Tolgee ma na celu maksymalne uproszczenie procesu tłumaczenia. Więcej szczegółów na temat rozbudowanych możliwości Tolgee znajdziesz na ich oficjalnej stronie: Tolgee.io.

Funkcje wtyczki

Jak używać?

Skonfiguruj swój projekt Tolgee

Przed skonfigurowaniem wtyczki Medusa, upewnij się, że Twój projekt Tolgee jest gotowy. Możesz albo skonfigurować otwartą wersję Tolgee na własnej infrastrukturze, albo wybrać zarządzaną wersję w chmurze oferowaną przez Tolgee. Uzyskaj swój identyfikator projektu z URL panelu zarządzania projektu (np. https://app.tolgee.io/projects/YOUR_PROJECT_ID).

Zainstaluj wtyczkę

npm install medusa-multilingual-tolgee

lub

yarn add medusa-mulitilingual-tolgee

Dodaj konfigurację wtyczki do pliku medusa-config.js

Gdy Twój projekt Tolgee jest skonfigurowany, dodaj konfigurację wtyczki do swojego sklepu Medusa, modyfikując plik medusa-config.js. Oto co musisz uwzględnić:

const plugins = [
  {
    resolve: `medusa-multilingual-tolgee`,
    options: {
      baseURL: process.env.MEDUSA_ADMIN_TOLGEE_API_URL,
      apiKey: process.env.MEDUSA_ADMIN_TOLGEE_API_KEY,
      defaultLanguage: "en",
      availableLanguages: [
        { label: "English", tag: "en" },
        { label: "German", tag: "de" },
        { label: "Polish", tag: "pl" },
      ],
      productsKeys: ["title", "subtitle", "description"],
      projectId: "your_tolgee_project_id",
      enableUI: true,
    },
  },
];

Możliwości konfiguracji:

• defaultLanguage: To domyślny język dla Twoich tłumaczeń. Domyślnie ustawiony na "en" dla angielskiego, ale można go dostosować do preferencji głównej grupy odbiorców.
• availableLanguages: Zawiera obiekty definiujące języki, które chcesz obsługiwać. Każdy obiekt powinien mieć label, który jest wyświetlaną nazwą języka, oraz tag, który jest kodem języka (zgodnie z definicją w Twoim projekcie Tolgee). Upewnij się, że te tagi są zgodne z tagami językowymi w projekcie Tolgee.
• productsKeys: Określ, które właściwości danych produktów Medusa powinny być tłumaczone. Typowe klucze to "title" (tytuł), "subtitle" (podtytuł) i "description" (opis), ale możesz określić inne pola, które chcesz tłumaczyć.
• projectId: Identyfikator projektu Tolgee, który można znaleźć w adresie URL pulpitu nawigacyjnego projektu na platformie Tolgee.
• enableUI: Ustaw tę opcję na true, aby włączyć komponenty interfejsu użytkownika do zarządzania tłumaczeniami w panelu administracyjnym Medusa. Dzięki temu użytkownicy będą mogli zarządzać tłumaczeniami bezpośrednio z panelu administracyjnego Medusa.

Ustaw zmienne środowiskowe w Medusa

MEDUSA_ADMIN_TOLGEE_API_URL=your_tolgee_app_url
MEDUSA_ADMIN_TOLGEE_API_KEY=your_tolgee_api_key

Wyjaśnienie zmiennych

• MEDUSA_ADMIN_TOLGEE_API_URL: To podstawowy adres URL, na którym jest hostowana instancja Tolgee. Jeśli używasz usługi chmurowej Tolgee, będzie to https://app.tolgee.io. Jeśli masz własną instancję hostowaną, zastąp ten URL adresem własnego wdrożenia.
• MEDUSA_ADMIN_TOLGEE_API_KEY: Możesz znaleźć lub wygenerować nowy klucz API, przechodząc do /account/apiKeys w swoim pulpicie nawigacyjnym Tolgee. Jeśli jeszcze nie wygenerowałeś klucza API, utwórz go, postępując zgodnie z instrukcjami w interfejsie Tolgee.

Zsynchronizuj wszystkie produkty z Tolgee

Po skonfigurowaniu zmiennych środowiskowych i ustawieniu wtyczki, czas zsynchronizować dane produktów z Tolgee, aby umożliwić tłumaczenia na całej platformie eCommerce. Oto jak zakończyć proces synchronizacji i rozpocząć tłumaczenie produktów:

Zrestartuj Medusa: Najpierw upewnij się, że wszystkie zmiany zostały zapisane, a następnie zrestartuj serwer Medusa, aby zastosować nowe ustawienia konfiguracyjne. To zapewni prawidłowe załadowanie wszystkich komponentów, w tym nowo skonfigurowanej wtyczki do zarządzania tłumaczeniami.

Uzyskaj dostęp do sekcji zarządzania tłumaczeniami: Przejdź do strony edycji produktu w panelu administracyjnym Medusa. Oto, co musisz zrobić:

Przewiń do sekcji Zarządzanie tłumaczeniami: Na stronie edycji produktu przewiń w dół, aż znajdziesz nową sekcję oznaczoną "Zarządzanie tłumaczeniami". Ta sekcja została dodana przez wtyczkę medusa-multilingual-tolgee i zapewnia narzędzia niezbędne do zarządzania tłumaczeniami produktów.

Rozpocznij proces synchronizacji: Kliknij przycisk "Synchronizuj wszystkie tłumaczenia" w sekcji Zarządzanie tłumaczeniami. To działanie uruchamia zadanie wsadowe, które komunikuje się z Tolgee w celu utworzenia tłumaczeń dla istniejących produktów.

Poczekaj na zakończenie: Po kliknięciu przycisku synchronizacji proces może zająć trochę czasu w zależności od liczby produktów i złożoności tłumaczeń.

Jak używać wtyczki na frontendzie?

• Router stron Next.js: Tolgee Pages Router

• Router aplikacji Next.js: Tolgee App Router

• Przewodnik krok po kroku dotyczący jej używania ze storefrontem Medusa: Wkrótce

Ostatnie kroki

Gratulacje! Twoja konfiguracja jest zakończona i możesz rozpocząć tłumaczenie wszystkich swoich produktów. 🎉

Jeśli chcesz przetłumaczyć słowo, naciśnij przycisk ALT i kliknij na słowo w kolumnie Wartość.

Jeśli masz jakiekolwiek pytania, potrzebujesz pomocy przy instalacji lub konfiguracji wtyczki, lub szukasz wsparcia przy projekcie Medusa — skontaktuj się z nami!