Jak zbudować wielojęzykową migrację Shopify do WordPress

Spędziłeś miesiące na budowaniu wielojęzycznego sklepu Shopify. Twoje opisy produktów są przetłumaczone na francuski, niemiecki i hiszpański. Twój proces realizacji zamówienia działa w trzech językach. Następnie decydujesz się na migrację do WordPress i WooCommerce, aby uzyskać większą kontrolę, lepsze marże lub elastyczność w zakresie wtyczek.

Dane produktów przesyłają się bez problemu. Obrazy również. Ale co z twoimi tłumaczeniami? Znikają.

To jest ukryty koszt wielojęzycznej migracji WordPress, o którym nikt cię nie ostrzega. Shopify blokuje twoje tłumaczenia w swoim własnym, zastrzeżonym systemie, a WordPress używa zupełnie innej architektury. Bez jasnego planu spędzisz tygodnie na odbudowywaniu tego, co już miałeś. Ten przewodnik daje ci ten plan.

Dlaczego wielojęzyczne migracje się psują (a Shopify to pogarsza)

Migracje platform są wystarczająco bolesne w przypadku jednojęzycznych sklepów. Dodaj wiele języków, a złożoność wzrasta wielokrotnie. Przyczyną jest architektura: Shopify i WordPress obsługują tłumaczenia w fundamentalnie różny sposób.

Model tłumaczeń Shopify to zamknięty ogród

Shopify przechowuje tłumaczenia jako metadane dołączone do zasobów za pośrednictwem Translate and Adapt API. Każdy produkt, kolekcja i strona ma wpisy tłumaczeń powiązane z wewnętrznymi identyfikatorami zasobów Shopify.

Kiedy eksportujesz swój sklep za pomocą narzędzia do migracji, takiego jak Cart2Cart, LitExtension lub eksportu CSV, otrzymujesz zawartość w domyślnym języku. Tłumaczenia? Żyją w oddzielnej warstwie, którą większość narzędzi do migracji całkowicie ignoruje.

Co faktycznie się eksportuje (a co się traci)

Oto, co typowe narzędzie do migracji z Shopify do WordPress przenosi:

Wzorzec jest jasny. Twoja zawartość w domyślnym języku jest migrowana. Twoje tłumaczenia nie. I nawet jeśli wyodrębnisz je ręcznie, nie możesz po prostu wkleić tłumaczeń Shopify do WordPress. Systemy mówią różnymi językami, dosłownie.

Mapowanie języków Shopify na pliki tłumaczeń WordPress

Zanim zaczniesz odbudowywać, musisz zrozumieć, jak WordPress obsługuje wielojęzyczną zawartość. To tutaj większość przewodników migracji zawodzi.

Zrozumienie systemu Gettext

WordPress używa systemu lokalizacji Gettext. Zamiast przechowywać tłumaczenia w warstwie bazy danych, odczytuje je ze statycznych plików binarnych (pliki .mo) skompilowanych z czytelnych dla człowieka plików .po.

Plik .po wygląda tak:

msgid "Add to Cart"
msgstr "Ajouter au panier"

msgid "Search results for %s"
msgstr "Résultats de recherche pour %s"

Każdy motyw i wtyczka WordPress jest dostarczana z plikiem szablonu .pot zawierającym wszystkie teksty do przetłumaczenia. Tworzysz plik .po dla każdego języka, wypełniasz tłumaczenia, kompilujesz go do .mo i umieszczasz we właściwym katalogu.

To jest system, na który muszą być mapowane twoje tłumaczenia Shopify.

Problem z niedopasowaniem kodów językowych

Shopify używa tagów językowych IETF (en, fr, de). WordPress używa kodów regionalnych z wariantami regionów (fr_FR, de_DE, es_ES). Podczas migracji musisz zmapować każdy język Shopify na poprawny kod regionalny WordPress. Pomylenie tego oznacza, że WordPress nie może znaleźć twoich plików tłumaczeń.

Typowe mapowania, które wprowadzają ludzi w błąd:

• Shopify pt mapuje się na WordPress pt_PT (Portugalia) lub pt_BR (Brazylia) -- nie są one wymienne
• Shopify zh-CN mapuje się na WordPress zh_CN, ale Shopify zh-TW mapuje się na zh_TW
• Shopify nb (norweski Bokmål) mapuje się na WordPress nb_NO

Nazwij swoje pliki .po i .mo kodem regionalnym WordPress: nazwatemy-fr_FR.po, woocommerce-de_DE.mo. Nieprawidłowy kod oznacza, że WordPress ignoruje plik po cichu.

Krok po kroku przepływ pracy wielojęzycznej migracji WordPress

Oto konkretny przepływ pracy, aby zachować twoje tłumaczenia podczas migracji z Shopify do WordPress.

Krok 1: Eksportuj i sprawdź swoje tłumaczenia Shopify

Zanim dotkniesz WordPress, wyodrębnij wszystko z Shopify. Użyj Shopify Admin API lub narzędzia takiego jak Shopify Translate CSV Export, aby pobrać tłumaczenia do plików strukturalnych.

# Using Shopify CLI to export translations
shopify app translate export --locale fr
shopify app translate export --locale de
shopify app translate export --locale es

Sprawdź eksport. Policz, ile masz tekstów w każdym języku. Zidentyfikuj, które z nich są tłumaczeniami treści produktu (obsługiwane przez twój CMS lub wtyczkę wielojęzyczną w WordPress) a które tłumaczeniami tekstów motywu/UI (obsługiwane przez pliki .po).

Krok 2: Skonfiguruj strukturę językową WordPress i WooCommerce

Na swojej świeżej instalacji WordPress skonfiguruj swoją infrastrukturę językową przed zaimportowaniem jakiejkolwiek zawartości.

1. Przejdź do Ustawienia > Ogólne i ustaw język swojej witryny
2. Zainstaluj pakiety językowe dla każdego języka docelowego za pośrednictwem Ustawienia > Ogólne > Język witryny
3. Utwórz strukturę katalogów tłumaczeń:

/wp-content/languages/
/wp-content/languages/plugins/
/wp-content/languages/themes/

W przypadku tłumaczeń treści produktu (tytuły, opisy) będziesz potrzebować wtyczki do treści wielojęzycznych, takiej jak WPML lub Polylang. Ale w przypadku tekstów interfejsu użytkownika motywu i wtyczek -- przyciski, etykiety, komunikaty o błędach i proces realizacji zamówienia -- chcesz statycznych plików .po/.mo. To jest podejście oparte na chmurze, które pozwala uniknąć nadmiernego rozrostu wtyczek.

Krok 3: Przekonwertuj swoje tłumaczenia do formatu PO

Twoje tłumaczenia tekstów motywu Shopify muszą zostać przekonwertowane do formatu Gettext .po. To tutaj migracja staje się techniczna.

Jeśli twoje tłumaczenia Shopify są w formacie JSON lub CSV, możesz przekonwertować je na .po za pomocą skryptu lub narzędzia. Kluczem jest zmapowanie każdego tekstu źródłowego do pary msgid/msgstr:

import csv

with open('shopify_translations_fr.csv', 'r') as infile, \
     open('theme-fr_FR.po', 'w') as outfile:
    outfile.write('msgid ""\nmsgstr ""\n')
    outfile.write('"Language: fr_FR\\n"\n\n')
    reader = csv.DictReader(infile)
    for row in reader:
        outfile.write(f'msgid "{row["key"]}"\n')
        outfile.write(f'msgstr "{row["translation"]}"\n\n')

Daje ci to punkt wyjścia, ale twój nowy motyw WordPress i instalacja WooCommerce będą miały setki tekstów, które nie istniały w Shopify. Nie możesz ponownie użyć tłumaczenia Shopify „Dodaj do koszyka” dla WooCommerce, ponieważ otaczający kontekst kodu jest inny. Tekst WooCommerce może brzmieć Dodaj do koszyka (mała litera „k”) lub zawierać zmienną %s dla nazwy produktu.

To tutaj większość ludzi utyka. Masz częściowe tłumaczenia z Shopify i ogromną lukę nieprzetłumaczonych tekstów specyficznych dla WordPress.

Jak przetłumaczyć luki bez zaczynania od nowa

Dobra wiadomość: nie musisz tłumaczyć 5000 tekstów WooCommerce ręcznie. Zła wiadomość: nie możesz ich też pominąć, bo twój sklep pokaże rażącą mieszankę francuskich nagłówków i angielskich komunikatów o błędach.

Teksty motywu i wtyczek nadal wymagają tłumaczenia

Twój motyw WordPress ma swój własny plik .pot. WooCommerce ma swój własny. Każda zainstalowana wtyczka -- bramki płatności, kalkulatory wysyłki, kreatory formularzy -- każda ma teksty do przetłumaczenia. One nie istniały w twoim sklepie Shopify.

Najszybszym podejściem jest tłumaczenie tych dużych plików .po wsadowo, a nie tekst po tekście. Prześlij plik .pot swojego motywu, wybierz język docelowy i pozwól AI zająć się ciężką pracą.

Wsadowe tłumaczenie dużych plików WooCommerce

Plik językowy WooCommerce jest ogromny. Z tysiącami tekstów obejmujących wszystko, od wiadomości o koszyku po kody błędów podatkowych, jest to największe zadanie tłumaczeniowe w każdej migracji. SimplePoTranslate radzi sobie z tym poprzez Inteligentne Przetwarzanie Wsadowe -- dzielenie zbyt dużych plików na bezpieczne kawałki, przetwarzanie ich równolegle i scalanie wyników z powrotem w jeden czysty plik.

Krytyczny szczegół: twoje przetłumaczone pliki muszą zachować każdą zmienną kodu dokładnie tak, jak pojawia się w źródle. Nie można dodać spacji ani zamienić pozycji zmiennej %s w szablonie wiadomości e-mail WooCommerce podczas tłumaczenia. To tutaj blokowanie składni zapobiega uszkodzonym zmiennym przed dotarciem do twojego sklepu produkcyjnego.

Dzięki Wielu Formatom Wyjściowym SimplePoTranslate, otrzymujesz pliki .po, .mo, .json, .php i .xliff w jednym pliku ZIP do pobrania. Jest to szczególnie przydatne podczas migracji, ponieważ różne części twojego stosu WordPress mogą wykorzystywać tłumaczenia w różnych formatach. Twój motyw odczytuje pliki .mo. Headless front-end może potrzebować pliku .json. Niestandardowa integracja może oczekiwać .xliff. Jedno uruchomienie tłumaczenia obejmuje wszystkie.

Unikanie trzech najczęstszych błędów tłumaczeń migracji

Nawet przy odpowiednim przepływie pracy istnieją pułapki specyficzne dla migracji platform, które zaskakują doświadczonych programistów.

Uszkodzone zmienne w e-mailach transakcyjnych

E-maile transakcyjne WooCommerce są gęsto wypełnione symbolami zastępczymi: {order_number}, {customer_name}, %1$s, %2$s. Jeśli twój proces tłumaczenia uszkodzi choćby jeden z nich, klienci otrzymają e-maile takie jak „Witaj {customer_name}” dosłownie, lub co gorsza, e-maile z zamienionymi danymi.

Zawsze sprawdzaj swoje przetłumaczone pliki w odniesieniu do źródłowego pliku .pot przed wdrożeniem. Narzędzia takie jak Poedit oznaczą niezgodności symboli zastępczych, a tłumacze w chmurze z blokowaniem składni całkowicie eliminują tę klasę błędów.

Brakujące reguły liczby mnogiej

Shopify obsługuje liczby mnogie w prosty sposób. WordPress Gettext obsługuje złożone formy liczby mnogiej, które różnią się w zależności od języka. Rosyjski ma trzy formy liczby mnogiej. Arabski ma sześć. Jeśli twój przetłumaczony plik .po nie zawiera poprawnego nagłówka Plural-Forms i pasujących wpisów msgstr[0], msgstr[1], msgstr[2], WordPress wraca do nieprzetłumaczonego tekstu.

# Correct Russian plural forms header
"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : "
"n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : 2);\n"

msgid "%s item"
msgid_plural "%s items"
msgstr[0] "%s товар"
msgstr[1] "%s товара"
msgstr[2] "%s товаров"

To jest coś, o czym Shopify nigdy nie wymagał, abyś myślał. W WordPress ma to znaczenie.

Osierocone teksty po zmianie wtyczek

Kiedy migrujesz z Shopify, nie tylko zmieniasz platformę. Zastępujesz cały ekosystem wtyczek. Twoja bramka płatności Shopify staje się WooCommerce Payments lub Stripe dla WooCommerce. Twój system recenzji staje się wtyczką WordPress. Każda zamiana wprowadza nowe teksty do przetłumaczenia i sprawia, że stare tłumaczenia stają się przestarzałe.

Stwórz listę kontrolną każdej wtyczki, którą instalujesz po migracji, i sprawdź, czy każda z nich ma odpowiadający jej przetłumaczony plik .mo w /wp-content/languages/plugins/. Brak nawet jednej wtyczki oznacza, że twoi klienci widzą angielskie teksty pośrodku w przeciwnym razie przetłumaczonego interfejsu.

Uruchom swój wielojęzyczny sklep na WordPress

Wielojęzyczna migracja WordPress to nie tylko transfer danych. To re-architektura sposobu, w jaki twój sklep komunikuje się z międzynarodowymi klientami. Sklepy, które robią to dobrze, odnotowują wyższe współczynniki konwersji na rynkach innych niż angielskie, ponieważ doświadczenie wydaje się natywne, a nie zlepione.

Przepływ pracy jest prosty: wyeksportuj swoje tłumaczenia Shopify, zmapuj je na kody regionalne WordPress, przekonwertuj na format .po, wypełnij luki za pomocą wsadowego tłumaczenia AI, sprawdź swoje zmienne i wdróż statyczne pliki .mo. Żadnego nadmiernego rozrostu bazy danych. Żadnego obciążenia tłumaczeniami w czasie wykonywania. Po prostu szybki, niezawodny, wielojęzyczny handel.

Jeśli stoisz w obliczu migracji z tysiącami nieprzetłumaczonych tekstów WooCommerce, podejście SimplePoTranslate do lokalizacji dużych plików może zaoszczędzić ci tygodnie pracy ręcznej.

Gotowy do przetłumaczenia swojego sklepu WooCommerce po migracji? Wypróbuj SimplePoTranslate za darmo -- nie wymagana karta kredytowa. Prześlij swój plik .pot i uzyskaj tłumaczenia gotowe do produkcji w kilka minut.