Masz motyw lub wtyczkę, w której część interfejsu jest po angielsku, a każda zmiana tekstu wymaga edycji plików i żonglowania Poedit oraz FTP. W praktyce takie poprawki są odkładane na nigdy, bo zajmują zbyt dużo czasu i łatwo je stracić po aktualizacji.
Loco Translate rozwiązuje ten problem, bo pozwala tłumaczyć frazy prosto z panelu WordPress, bez ręcznego kopiowania plików i bez dodatkowych programów. Masz pod ręką edytor tłumaczeń, synchronizację fraz ze źródłami oraz bezpieczne miejsce zapisu, dzięki czemu aktualizacje motywów i wtyczek nie kasują Twojej pracy.
Czym jest Loco Translate i jak działa
To edytor plików tłumaczeń zintegrowany z WordPress. Działa na standardzie Gettext, czyli na parach plików PO oraz MO. Skanuje motyw lub wtyczkę w poszukiwaniu fraz przygotowanych do tłumaczenia, pozwala je edytować w przeglądarce i zapisuje w bezpiecznej lokalizacji, z której WordPress odczytuje tłumaczenia w trakcie działania strony.
Największa różnica w codziennej pracy polega na tym, że nie potrzebujesz FTP ani Poedit. Zmiany robisz w jednym miejscu, a po kliknięciu zapisz Loco Translate kompiluje plik MO i natychmiast widać efekt na stronie lub w panelu.
Instalacja i pierwsze uruchomienie
Wyszukaj Loco Translate w katalogu wtyczek, zainstaluj i włącz. W menu pojawi się nowa pozycja, w której wybierasz konkretny motyw lub wtyczkę, klikasz dodaj nowy język, wskazujesz język witryny oraz lokalizację zapisu i możesz zaczynać tłumaczenie.
Gdzie zapisywać tłumaczenia aby nie zniknęły po aktualizacji
Najbezpieczniej zapisywać pliki w katalogu języków WordPress, a nie w folderze motywu czy wtyczki. Loco Translate proponuje własne miejsce w wp content languages loco. Dzięki temu aktualizacja nie nadpisze Twoich plików, bo nie leżą w katalogu aktualizowanego dodatku.
Jeśli już masz tłumaczenia w folderze motywu lub wtyczki, przenieś je do zalecanej lokalizacji i zsynchronizuj, czyli porównaj z szablonem fraz. Synchronizacja przydaje się także po każdej większej aktualizacji, bo dodaje nowe frazy i usuwa nieużywane.
Gdy serwer ma ograniczone prawa zapisu, możesz wskazać alternatywną lokalizację w ustawieniach Loco Translate. Ważne aby WordPress miał prawo odczytu i zapisu tych plików. W razie błędów uprawnień wtyczka to jasno komunikuję i podpowiada, co poprawić.
Szukanie i tłumaczenie konkretnych fraz
W widoku języka masz listę wszystkich fraz z możliwością filtrowania. Wpisz fragment słowa w wyszukiwarkę, kliknij wynik i dodaj tłumaczenie w polu edycji. Loco Translate zapisuje kopie zapasowe, więc jeśli coś popsujesz, możesz wrócić do wcześniejszej wersji.
Pamiętaj o opcjach synchronizacji i o zaznaczaniu tłumaczeń jako gotowe. Jeśli widzisz znacznik niepewne, oznacza to tłumaczenie do weryfikacji. Po zapisaniu pliku MO zmiany są natychmiast widoczne.
Obsługa liczby mnogiej i zmiennych w tekście
Frazy mogą mieć formy liczby mnogiej oraz zmienne w nawiasach procentowych, na przykład procent s lub procent d. To miejsca, w które WordPress wstawia liczby lub fragmenty tekstu. Zostaw je bez zmian i skup się na poprawnym brzmieniu całego zdania w danym kontekście.
Tłumaczenia a motywy i wtyczki które nie są przygotowane
Zdarza się, że frazy nie są przygotowane do tłumaczenia lub używają innej nazwy domeny tekstowej niż plik. Wtedy skan nie wyłapie wszystkich tekstów albo tłumaczenie nie zadziała. Rozpoznasz to po braku wyniku mimo widocznego angielskiego tekstu na stronie.
W takiej sytuacji sprawdź, czy fraza w ogóle pojawia się na liście i czy domena tekstowa pasuje do wybranego pakietu tłumaczeń. Jeśli nie pasuje, nic nie wymusisz po stronie tłumaczeń. Potrzebna jest poprawka w motywie lub wtyczce, aby używały funkcji i18n WordPress z właściwą domeną.
Bywa też, że tekst pochodzi z bazy danych, na przykład z ustawień wtyczki lub treści wpisu. Takie elementy tłumaczy się inaczej, nie przez pliki PO. Loco Translate nie służy do tłumaczenia zawartości wpisów ani szablonów budowanych kreatorem stron.
Dlaczego tłumaczenie nie działa mimo zapisania
Najczęstsze powody to zła lokalizacja plików, niewłaściwy język ustawiony w WordPress, brak kompilacji pliku MO lub pamięć podręczna. Sprawdź ustawienia języka witryny, synchronizację oraz to, czy po zapisaniu widzisz nowy plik MO w wybranej lokalizacji.
Jeśli używasz wtyczek cache, wyczyść pamięć podręczną wtyczki oraz przeglądarki. Gdy korzystasz z sieci CDN, poczekaj aż odświeży pliki. W przypadku WooCommerce dodatkowo odśwież szablony i pamięć podręczną wtyczki, bo część tekstów pojawia się w e mailach i widokach sklepu.
Wpływ na wydajność i bezpieczeństwo
Samo posiadanie tłumaczeń nie spowalnia strony w zauważalny sposób, bo WordPress i tak ładuje pliki językowe. Skanowanie źródeł jest bardziej zasobożerne i warto je robić ręcznie, a nie przy każdym wejściu. W kontekście bezpieczeństwa pamiętaj o rozsądnych uprawnieniach zapisu oraz o tym, by nie zostawiać tłumaczeń w katalogach aktualizowanych dodatków.
Kiedy Loco Translate ma sens a kiedy lepiej wybrać inne podejście
Jeśli chcesz spolszczyć motyw lub wtyczkę, poprawić pojedyncze frazy w WooCommerce czy zmienić komunikaty systemowe, to właśnie tu Loco Translate błyszczy. Masz szybkie poprawki z poziomu panelu i kontrolę nad tym, gdzie zapisywane są pliki.
Gdy potrzebujesz wielojęzycznej strony z oddzielnymi treściami dla każdego języka, użyj wtyczek do wielojęzyczności. Loco Translate nie tworzy wersji językowych wpisów ani stron, nie zarządza przełącznikiem języków i nie tłumaczy treści tworzonych kreatorami.
Praktyczne ustawienia które warto poznać
W ustawieniach projektu tłumaczeń ustaw filtr skanowania tak aby pomijał katalogi vendor oraz node modules jeśli istnieją. Włącz kopie zapasowe i trzymaj je w tej samej bezpiecznej lokalizacji. Dobrym nawykiem jest też eksport plików PO do repozytorium projektu, aby mieć historię zmian.
Gdy rozwijasz własny motyw lub wtyczkę, zadbaj o konsekwentną domenę tekstową, komplet nagłówków w pliku stylu oraz aktualne pliki POT. Dzięki temu Loco Translate bez problemu zeskanuje źródła i zsynchronizuje frazy z tłumaczeniami.
Codzienna praca i dobre praktyki
Rób małe serie zmian i po każdej serii klikaj zapisz oraz testuj miejsce w interfejsie, którego dotyczyła poprawka. Unikaj ruszania oryginalnych fraz w kodzie, bo stracisz możliwość łatwej aktualizacji. Trzymaj tłumaczenia poza katalogiem dodatków, regularnie synchronizuj po aktualizacjach oraz czyść cache, jeśli nie widzisz efektu od razu.
