W tym artykule porozmawiamy o tworzeniu i dołączaniu plików tłumaczeniowych, a następnie o tłumaczeniu tekstu we wtyczkach i motywach. Również tutaj pokrótce omówiłem kilka punktów teoretycznych, najczęstszych błędów, jak pracować z programem Poedit. Cóż, dam radę dotyczącą tłumaczeń.

Co przetłumaczyć?

Zanim przejdziemy do tłumaczenia, zdecydujmy, co musimy przetłumaczyć, ponieważ ma to wpływ na to, jak musimy tłumaczyć.

Tłumaczenie motywu / wtyczki z katalogu WordPress

Do takiego tłumaczenia musisz skorzystać ze strony translate.wordpress.org. Co powinno być zrobione:

1. Zaloguj sie.
2. Wybierz żądany język tłumaczenia
3. Znajdź wtyczkę / motyw, który chcesz przetłumaczyć.
4. I przetłumacz bezpośrednio na stronie.

Po zweryfikowaniu tłumaczenia w obszarze administracyjnym witryny WordPress zobaczysz aktualizacje tłumaczenia wtyczki / motywu.

5. Aktualizacja. Tłumaczenie gotowe!

Uwaga: Nie wszystkie wtyczki w katalogu obsługują tłumaczenie przez translate.wordpress.org. W takich przypadkach przetłumacz jak zwykle (przeczytaj następny akapit).

Tłumaczenie motywu / wtyczki NIE z katalogu WordPress

W takim przypadku potrzebujesz:

Tłumaczenie twojego motywu / wtyczki

Jak to się robi i jak to działa, opisano poniżej w „Etap 1” i „Etap 2”.

Jeśli planujesz umieścić swoją wtyczkę / motyw w katalogu WordPress. Zdecydowanie zaleca się wykonanie tłumaczenia za pośrednictwem translate.wordpress.org. Więcej na ten temat (po angielsku) (szczegóły nie są opisane w tym artykule).

Jak działa tłumaczenie w WordPressie (teoria)

Musimy zacząć od najważniejszej rzeczy: plików tłumaczeń: .mo .po .pot. PHP działa tylko z plikami .mo, .po i .pot - są przeznaczone dla ludzi i programów tłumaczących.

W WordPressie do tłumaczenia używany jest tylko plik .mo. Podczas generowania strony plik ten jest dołączany - z niego tworzony jest obiekt PHP ze znakami nowej linii i umieszczany w pamięci. Ponadto, podczas używania funkcji translacji w kodzie, tłumaczenie żądanego ciągu jest pobierane z tego obiektu. Tak to działa.

Tak więc, aby przetłumaczyć napisy w motywie / wtyczce, potrzebujemy:

Ważne jest, aby zrozumiećże przy podłączaniu pliku .mo nadawany jest mu identyfikator (parametr domeny $) i taki identyfikator (domena) jest określony dla funkcji translacji napisów. Domena kojarzy plik .mo z funkcjami tłumaczenia. Te. podczas tłumaczenia w funkcji wskazujemy, z którego pliku MO należy pobrać tłumaczenie określonego ciągu. Przykład:

// podłącz plik tłumaczenia MO i określ dla niego identyfikator - mojadomena: load_theme_textdomain ("moja_domena", katalog_szablonu (). "/ języki"); // przetłumacz - podaj ponownie ID - moja_domena: _e ("Komentarz:", "moja_domena");

Etap 1: Stwórz swoją wtyczkę i przetłumacz ją

Jeśli masz już gotowy motyw/wtyczkę i potrzebujesz go po prostu przetłumaczyć, przejdź bezpośrednio do tłumaczenia (etap 2).

Aby proces tłumaczenia był przejrzysty, stwórzmy bardzo prostą wtyczkę i przetłumaczmy ją na język rosyjski. Nazwijmy wtyczkę my-translation-demo. Powinniśmy mieć następującą strukturę wtyczki:

1. W folderze wtyczek WordPress utwórz folder my-translation-demo: / plugins / my-translation-demo.
2. W tym folderze utwórz folder lang: / my-translation-demo / lang.
3. Stwórzmy plik my-translation-demo.php: /my-translation-demo/my-translation-demo.php.
4. Dodajmy następujący kod do wygenerowanego pliku php:

E () -

Były () -

X () -

N (1) -

N (3) -

N (10) -

Nx (1) -

Nx (3) -

Nx (10) -

esc_attr __ () -

esc_attr_e () -

esc_html __ () -

esc_html_e () -

Wtyczka jest gotowa! Przejdźmy do panelu administracyjnego, aktywuj wtyczkę, przejdź do strony wtyczki.

Wtyczka wykorzystuje wszystkie funkcje tłumaczenia, które ma WordPress. Dołączony jest również plik tłumaczenia myl10n-ru_RU.mo, który jeszcze nie istnieje. Po utworzeniu pliku .mo wtyczka zostanie przetłumaczona (utworzymy ją poniżej).

Zwróć uwagę na parametry podczas tworzenia wtyczki. Muszą być poprawnie określone, aby tłumaczenie nazwy i opisu wtyczki działało na stronie wtyczek.

* Domena tekstowa: myl10n * Ścieżka domeny: / lang

Również w tym celu dodajemy tytuł i opis w funkcji tłumaczenia, aby parser je znalazł.

// ciągi do tłumaczenia nagłówków wtyczek, aby trafiały do ​​pliku .po. __ („Tłumaczenie demo WordPress”); __ („Wtyczka testowa do nauki tworzenia tłumaczeń w WordPressie”);

WordPress używa również parametru Text Domain: do wyszukiwania pliku tłumaczenia. Tam plik powinien mieć nazwę DOMAIN-TRANSFER_LOCAL.mo.

Etap 2: Tłumaczenie. Twórz pliki .mo .po

Aby stworzyć plik MO musimy mieć gotowy plik PO, więc całe zadanie sprowadza się do stworzenia pliku PO.

Istnieje kilka opcji tworzenia pliku PO, tutaj rozważymy pracę z programem Poedit. Najpierw musisz pobrać Poedit i zainstalować go (darmowa wersja pozwala robić wszystko, czego potrzebujemy).

Możesz stworzyć plik PO przez Poedit, ale utworzymy go w niestandardowy sposób - o wiele łatwiej w ten sposób:

Tłumaczenie jest gotowe i działa. Jeśli teraz przejdziesz do strony wtyczki, wszystkie wiersze zostaną przetłumaczone:

Dlaczego wygodnie jest ręcznie utworzyć plik .po, a nie przez program Poedit?

Ponieważ jest to szybsze: w tym przypadku nie trzeba określać żadnych ustawień, wystarczy skopiować kod (z punktu 2) do pliku .po, wgrać ten plik do Poedit, kliknąć „Wyodrębnij z kodu źródłowego”, a następnie "OK" i przetłumacz. (ustawienia można zmienić w samym pliku po, program nie jest do tego potrzebny).

Aby utworzyć plik za pomocą Poedit, potrzebujesz:

1. Otwórz Poedit.
2. Wybierz: Plik> Nowy ....
3. W wyświetlonym oknie wybierz język, na który tłumaczymy.
4. Okno po prostu zniknie, a my siedzimy głupio „i co dalej?”.
5. A potem musisz nacisnąć przycisk Zapisać, w wyświetlonym eksploratorze znajdź folder motywu, przejdź do folderu lang, wprowadź nazwę pliku myl10n-ru_RU.po i kliknij OK.
6. Okno znów znika, a my dalej nudzimy „co teraz robić?”.

Teraz musisz nacisnąć przycisk: Wyciąg ze źródła... Otworzy się okno, w którym należy ustawić ustawienia pliku PO. Wszystko, co jest napisane w kodzie powyższego pliku PO: nazwa projektu, zespół projektowy, kodowania, foldery do zbierania ciągów tłumaczeniowych, słowa kluczowe do wyszukiwania ciągów tłumaczeniowych. Ogólnie rzecz biorąc, tutaj będziesz musiał majstrować i się nie mylić.

Po ustawieniu ustawień kliknij „OK”.

7. Następnie czekamy na teraz, ciągi tłumaczeń są pobierane z plików projektu i przechodzimy do okna ciągów tłumaczeń (screen powyżej). Tłumaczymy wiersze, klik Zapisać.
8. Utworzono tłumaczenie i plik MO!

Aktualizacja tłumaczenia (przy zmianie kodu)

Tutaj wszystko jest niezwykle proste:

1. Otwarcie Poedit.
2. Wrzucamy do niego dowolny plik PO z projektu i kliknij "Aktualizuj z kodu"(przycisk na panelu).
3. Tłumaczymy nowe linie i kliknij "Zapisz"(przycisk na panelu).
4. Tłumaczenie zaktualizowane! Możesz zamknąć Poedit.

Tworzenie pliku POT

Plik pot jest szablonem tłumaczenia. Jest to bezpośrednia kopia pliku .po, tylko wtedy, gdy nie są tłumaczone żadne wiersze. Te. wszystkie ciągi tłumaczeń pochodzą z plików projektu, ale nic nie zostało jeszcze przetłumaczone.

Z powyższego wynika, aby utworzyć plik POT, którego potrzebujesz przejść przez całą procedurę tworzenia pliku .po, a na koniec niczego nie tłumaczyć, tylko przejść do Plik> Zapisz jako i zapisać plik z rozszerzeniem .pot.

Jeszcze łatwiej jest utworzyć plik POT. Weź plik .po i zmień jego rozszerzenie na .pot. Jest to prosta metoda, ale taki plik z przetłumaczonymi ciągami znaków może być również użyty jako szablon do tworzenia tłumaczenia na dowolny język (przynajmniej tak działa Poedit).

Dlaczego potrzebuję pliku .pot?
Aby istniał jeden plik, w którym ciągi tłumaczeń są zawsze aktualne. Wykorzystanie go jako podstawy do stworzenia tłumaczenia na inny język.

Na przykład, jeśli pliki tłumaczeń PO i MO są umieszczone w globalnym folderze tłumaczeń, nie możemy wgrać pliku PO do programu i kliknąć „Aktualizuj z kodu”, ponieważ w pliku PO ścieżka do plików wtyczek najprawdopodobniej będzie niepoprawny (lub w ogóle go tam nie będzie), a ciągi tłumaczeń nie będą mogły zostać zaktualizowane. W tym przypadku używany jest plik POT, który zawsze powinien znajdować się w folderze wtyczek i gdy kod się w nim zmienia, należy zaktualizować ciągi tłumaczeń, dzięki czemu otrzymujemy zawsze aktualny szablon ciągów tłumaczeniowych.

Jeśli plik PO znajduje się w folderze wtyczek, plik POT nie jest potrzebny, tłumaczenie można utworzyć z pliku PO.

W tym plik do tłumaczenia .mo

Sposób podłączenia pliku MO we wtyczce jest już w powyższym kodzie wtyczki. I tutaj skupię się na funkcjach WordPress do podłączenia tego pliku. Funkcje:

load_plugin_textdomain ($ domena, false, $ plugin_rel_path) Podłącz plik MO z wtyczki. Opakowanie dla load_textdomain (). Najpierw szuka pliku MO w ogólnym folderze tłumaczeń wtyczek: /wp-content/język/wtyczki. Plik musi mieć nazwę DOMAIN_Translation-LOCAL.mo. load_muplugin_textdomain ($ domena, $ plugin_rel_path) Podłącz plik MO z wtyczki MU. Opakowanie dla load_textdomain (). Najpierw szuka pliku MO w ogólnym folderze tłumaczenia wtyczek: /wp-content/język/wtyczki. Plik musi mieć nazwę DOMAIN_Translation-LOCAL.mo. load_theme_textdomain (domena $, ścieżka $) Podłącz plik MO z tematu. Opakowanie dla load_textdomain (). Najpierw szuka pliku MO w folderze tłumaczeń ogólnych motywów: /wp-content/język/motywy. Plik powinien mieć nazwę LOCAL.mo (gdy plik znajduje się w motywie) i FOLDER_THEMES-LOCAL.mo (gdy plik znajduje się w udostępnionym folderze). load_textdomain ($domena, $mofile) Podłącz plik MO z dowolnego miejsca (musisz podać pełną ścieżkę do pliku MO, wraz z nazwą pliku).

Spójrzmy na kilka przykładów łączenia plików MO.

Zakłada się, że kod połączenia będzie znajdował się w głównym pliku plugin/theme lub w pliku znajdującym się w katalogu głównym plugin/theme. Jeśli tak nie jest, __PLIK__ należy zastąpić odpowiednią ścieżką.

// plik tłumaczenia wtyczki. // plik musi mieć nazwę: DOMAIN-LOCAL.mo, na przykład: myl10n-ru_RU.mo add_action ("plugins_loaded", function() (load_plugin_textdomain ("my-plugin", false, dirname (plugin_basename (__ FILE__)) . "/ języki "));)); // plik tłumaczenia dla wtyczki MU. // plik musi mieć nazwę: DOMAIN-LOCAL.mo, na przykład: myl10n-ru_RU.mo load_muplugin_textdomain ("moja-wtyczka", dirname (nazwa_bazy_wtyczki (__ PLIK__)). "/ języki")); // plik tłumaczenia motywu. // plik musi mieć nazwę aktualnej lokalizacji, na przykład: ru_RU.mo add_action („after_setup_theme”, function() (load_theme_textdomain („my_theme”, get_template_directory (). "/ języki");)); // dowolny plik tłumaczenia // Dołącz plik .mo (nazwa pliku: ru_RU.mo lub inny, w zależności od ustawień regionalnych) add_action ("plugins_loaded", function() ($ mo_file_path = dirname (__ FILE__). "/ lang / ". get_locale (). ".mo"; load_textdomain ("mytranslate", $ mo_file_path);)

Nie trzeba podłączać funkcji do hooków, ale w przykładach zrobiłem to zgodnie z zaleceniami.

Uwaga: jeśli plik tłumaczenia znajduje się w, funkcje te można pominąć. WordPress automatycznie łączy pliki tłumaczeń z folderu globalnego na podstawie parametru Text Domain: w nagłówku wtyczki.

Funkcje tłumaczeniowe

Jak korzystać z funkcji tłumaczenia jest już w powyższym kodzie wtyczki. I tutaj opiszę każdą funkcję (przeczytaj szczegółowy opis w opisie funkcji).

__ (tekst $, domena $) Tłumaczy określony tekst i zwraca go do przetworzenia. _e (tekst $, domena $) Tłumaczy określony tekst i wyświetla go na ekranie. _x (tekst $, kontekst $, domena $) Tłumaczy określony tekst w określonym kontekście i zwraca go do przetworzenia. _ex (tekst $, kontekst $, domena $) Tłumaczy określony tekst w określonym kontekście i wyświetla go na ekranie. _n ($ pojedynczy, $ liczba mnoga, $ liczba, $ domena) Pobiera ciąg tłumaczenia liczby pojedynczej lub mnogiej, który pasuje do określonej liczby (1 komentarz, 2 komentarze). _nx ($ pojedynczy, $ liczba mnoga, $ liczba, $ kontekst, $ domena) Pobiera pojedynczy lub mnogi ciąg tłumaczenia w określonym kontekście. _n_noop ($ liczba pojedyncza, $ liczba mnoga, $ domena) Funkcja fikcyjna. Analogowe _n (). Używane, gdy musisz zdefiniować ciągi tłumaczenia dla liczby mnogiej, ale użyj ich gdzieś w dalszej części kodu. Wynik zwracany przez funkcję musi zostać przetworzony za pomocą funkcji translate_nooped_plural() . Wynik działania tej funkcji jest na przykład wygodny w użyciu w parametrach, gdy nie wiemy z góry, jaka będzie liczba, a później musimy dokonać tłumaczenia. _nx_noop ($ liczba pojedyncza, $ mnoga, $ kontekst, $ domena) To samo co _n_noop (), ale z kontekstem. esc_attr __ (tekst $, domena $) Tłumaczenie wartości atrybutów znaczników HTML. Skrót dla esc_attr (__ ()). esc_attr_e (tekst $, domena $) Tak samo jak esc_attr __ (), tylko natychmiast wyświetla wynik na ekranie. esc_html __ (tekst $, domena $) Tłumaczenie tekstu, który może zawierać znaczniki HTML. Skrót dla esc_html (__ ()). esc_html_e (tekst $, domena $) To samo co esc_html __ (), ale natychmiast wyświetla wynik na ekranie.

Błędy podczas korzystania z funkcji tłumaczenia

# 1 Nie można używać zmiennych / stałych w parametrach funkcji translacji

Ponieważ programy mogą analizować tylko ciągi, a nie zmienne. Programy nie analizują tego, co znajduje się w podanej zmiennej, tylko skanują kod jako tekst i wyciągają ciągi do tłumaczenia...

// Tak _e ("Hello World!", "Mydomain"); // Nie _e ($ string, "moja_domena"); _e („Witaj świecie!”, domena $); _e („Witaj świecie!”, DOMENA);

# 2 Nie używaj HTML w ciągach tłumaczeniowych (jeśli to możliwe)

Na przykład, jeśli określisz