DF Translate: kompletny przewodnik

DF Translate sprawia, że Twoja witryna WordPress i sklep WooCommerce stają się naprawdę wielojęzyczne. Każde tłumaczenie to realna treść w bazie danych (na sposób Polylanga albo WPML-a), a nie warstwa tekstu przepisywana w locie: właśnie to gwarantuje nienaganne SEO i pełną zgodność z Twoim motywem, page builderem i wtyczkami. Tłumaczenie automatyczne jest opcjonalne i opiera się na Twoim własnym kluczu API. Ten przewodnik obejmuje instalację, konfigurację języków i silnika AI, tłumaczenie treści i ciągów, SEO wielojęzyczne, edytor obok siebie, migrację z Polylanga, WooCommerce oraz rozwiązywanie problemów.

Instalacja

1. Pobierz archiwum dftranslate.zip ze swojego konta DataFirefly.
2. Panel WordPressa → Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer → wyślij ZIP, a następnie Włącz.
3. Przy aktywacji rozszerzenie tworzy swoje tabele (grupy tłumaczeń, ciągi, tłumaczenia ciągów) i dodaje menu DF Translate.

Start w pięć minut

1. Otwórz DF Translate → Ustawienia, zakładka Języki, i dodaj drugi język z listy gotowych ustawień (wersja darmowa obejmuje 2 języki). Ustal język domyślny.
2. Zakładka Tłumaczenie: wybierz silnik AI i wpisz swój klucz API (albo zostaw puste, aby tłumaczyć wszystko ręcznie). Kliknij Testuj połączenie.
3. Otwórz wpis albo produkt: w boksie Język i tłumaczenia kliknij ⚡ Utwórz i przetłumacz dla języka docelowego.
4. Przejrzyj tłumaczenie w edytorze obok siebie, a następnie opublikuj je.
5. Dodaj przełącznik języka do witryny (blok, widget, menu albo pasek administracyjny), aby odwiedzający mogli zmieniać język.

Konfiguracja języków

Wszystko dzieje się w DF Translate → Ustawienia → Języki.

Dodanie języka

Użyj listy rozwijanej gotowych ustawień (27 języków z wypełnionym kodem, locale, nazwą i flagą) albo przycisku Własny…, aby ręcznie wpisać kod (np. de), locale (np. de_DE) i wyświetlaną nazwę. Wersja darmowa dopuszcza 2 języki; DF Translate Pro znosi limit.

Język domyślny, kolejność i usuwanie

Język domyślny to język Twoich treści źródłowych (nie ma przedrostka w adresie URL). Zmieniaj kolejność języków strzałkami ▲▼ (kolejność odzwierciedla się w przełączniku) i usuwaj język przyciskiem ✕. Usunięcie języka z konfiguracji nie kasuje treści: pozostają w bazie i zostają ponownie podpięte, jeśli dodasz język z powrotem.

Konfiguracja silnika tłumaczenia AI

W DF Translate → Ustawienia → Tłumaczenie wybierz silnik i wpisz swój klucz.

• Claude (Anthropic): najlepsza jakość redakcyjna, idealny do treści marketingowych i kart produktów.
• DeepL: świetny stosunek jakości do ceny, dostępny darmowy próg.
• OpenAI: uniwersalny silnik GPT.
• LibreTranslate: serwer samodzielnie hostowany, dla pełnej suwerenności danych (podajesz adres swojej instancji).

Pole Ton pozwala ukierunkować styl (na przykład „profesjonalny”, „ciepły”). Twoje klucze są szyfrowane w spoczynku (libsodium, z fallbackiem na OpenSSL) i nigdy nie są ujawniane po stronie odwiedzającego.

Tłumaczenie treści

Każdy wpis, strona, produkt, kategoria i etykieta ma w edytorze boks Język i tłumaczenia oraz kolumnę Język na listach.

Z poziomu edytora

Boks pokazuje język treści i stan każdego tłumaczenia. Dla każdego brakującego języka ⚡ Utwórz i przetłumacz tworzy tłumaczenie i wypełnia je silnikiem AI; bez skonfigurowanego silnika + Utwórz tworzy pusty szkic. Treść przetłumaczona przez AI oznaczana jest ⚑ MT („do przejrzenia”), dopóki człowiek jej nie zredaguje.

Z poziomu list (macierz tłumaczeń)

W kolumnie Język macierz pokazuje dla każdego wiersza: jego własny język (pełna flaga), link ✎ do każdego istniejącego tłumaczenia (obramowanie kropkowane przy szkicu, pomarańczowe przy nieaktualnym) oraz przycisk ⚡ albo + do utworzenia brakujących. Treści bez języka („sieroty”) mają szybkie przypisanie bezpośrednio w komórce.

Filtrowanie i edycja zbiorcza

Nad listami linki widoków filtrują po języku wraz z licznikami, plus widok ⚑ Do przejrzenia. Język ustawia się też w Szybkiej edycji i w Edycji zbiorczej (opcja „— Bez zmian —”, aby nie nadpisywać niedotyczących wierszy).

Edytor obok siebie

Z poziomu tłumaczenia przycisk ⇆ Obok siebie (w boksie tłumaczeń, w akcjach wiersza albo w edytorze) otwiera ekran porównujący źródło i cel: tytuł, slug, zajawkę i metadane SEO w jednej linii. Każde pole ma przycisk ⧉ (kopiuj ze źródła) i ⚡ (przetłumacz to pole przez AI). Ekran uzupełniają wybór statusu, nawigacja między językami grupy i wskaźnik nieaktualności. Skrót Ctrl/Cmd + S zapisuje.

Tłumaczenie ciągów (teksty interfejsu)

Teksty, które nie są treścią redakcyjną (tytuł witryny, hasło, tytuły widgetów, etykiety motywu) obsługiwane są w DF Translate → Ciągi. Wpisz tłumaczenie każdego ciągu per język albo skorzystaj z importu/eksportu .po, aby powierzyć tę pracę tłumaczowi albo wykorzystać istniejący katalog.

SEO wielojęzyczne

• hreflang: znaczniki hreflang (z x-default) dodawane są automatycznie na każdej stronie, aby wskazać wyszukiwarkom wersje językowe.
• Adresy URL per język: każdy język inny niż domyślny ma przedrostek (np. /fr/), co daje czyste i indeksowalne adresy.
• Przetłumaczone slugi: slug tłumaczenia generowany jest od nowa z przetłumaczonego tytułu.
• Metadane SEO: tytuły, opisy i słowa kluczowe z Yoast, Rank Math, AIOSEO i SEOPress tłumaczone są równocześnie z treścią.

Przełącznik języka

Zaproponuj odwiedzającym zmianę języka w sposób pasujący do Twojego motywu:

• Blok Gutenberga „Przełącznik języka” w edytorze witryny albo treści.
• Klasyczny widget w obszarze widgetów.
• Shortcode [dft_switcher] w dowolnym miejscu.
• W menu: dodaj własny link z adresem #dft_switcher, rozwinie się w jeden element na język.
• Pasek administracyjny: przełącznik dostępny dla zalogowanych użytkowników.

Flagi to osadzone pliki SVG, ostre w każdym systemie (także w Windowsie, gdzie flagi emoji się nie wyświetlają).

Przetłumaczone menu

W Ustawienia → Menu przypisz inne menu per język do każdej lokalizacji motywu albo zostaw puste, aby ponownie użyć menu domyślnego. Przycisk ⚡ Generuj klonuje menu domyślne, przemapowując każdy element na jego tłumaczenie (etykiety podążają wtedy za przetłumaczonymi tytułami) i tłumacząc własne linki.

WooCommerce

DF Translate tłumaczy produkty proste, kategorie i etykiety produktów jak każdą inną treść. Stan magazynowy i cena pozostają zsynchronizowane między językami tego samego produktu, a język klienta zapisywany jest na zamówieniu.

Migracja z Polylanga

Jeśli używasz już Polylanga, otwórz DF Translate → Ustawienia i uruchom migrację jednym kliknięciem. Twoje języki, przypisania językowe treści i grupy tłumaczeń importowane są automatycznie. Dane Polylanga nie są modyfikowane, a istniejące języki zostają zachowane (scalanie, nie nadpisywanie).

Panel i kontrole stanu

Panel (DF Translate) pokazuje pokrycie tłumaczeniami per typ treści i per język, treści do przejrzenia oraz kontrole stanu: bezpośrednie odnośniki, treści bez języka, nieskonfigurowany silnik. Kilka problemów (jak treści osierocone) naprawia się jednym kliknięciem.

Wsparcie REST / headless

Pola dft_lang i dft_translations udostępniane są w REST API dla tłumaczalnych typów treści. Filtrowanie po języku odbywa się jawnie przez ?lang=; odpowiedzi API nigdy nie są filtrowane niejawnie przez ciasteczko języka, co zapobiega psuciu wyników frontendu headless.

Deinstalacja

Samo wyłączenie zachowuje wszystkie dane. Jeśli zaznaczysz w ustawieniach opcję usuwania danych, skasowanie rozszerzenia usunie tabele i opcje DF Translate; Twoje treści WordPressa i zamówienia nigdy nie są ruszane.

FAQ i rozwiązywanie problemów

Test połączenia z silnikiem się nie udaje. Sprawdź klucz API, jego limit po stronie dostawcy oraz to, czy serwer może osiągnąć API wychodzącym połączeniem. Przy LibreTranslate sprawdź adres instancji.

Tłumaczenie pozostaje oznaczone jako „do przejrzenia” (⚑ MT). To normalne po tłumaczeniu maszynowym: otwórz je i zapisz zmianę wprowadzoną przez człowieka (edytor, widok obok siebie albo import), aby zdjąć flagę.

Przełącznik języka nie pojawia się w moim menu. Sprawdź, czy własny link ma dokładnie adres #dft_switcher, a następnie zapisz menu.

Flagi wyświetlały się jako litery. DF Translate używa osadzonych flag SVG właśnie po to, aby uniknąć tego problemu (flagi emoji nie są renderowane w Windowsie). Wyczyść cache, jeśli utrzymuje się stare renderowanie.

Przetłumaczona strona zwraca błąd 404. Odśwież bezpośrednie odnośniki (Ustawienia → Bezpośrednie odnośniki → Zapisz) po dodaniu języka albo zmianie przedrostków URL.

Jak przejść na więcej niż 2 języki? DF Translate Pro znosi limit języków i dodaje tłumaczenie masowe, autopilota, pamięć tłumaczeń, glosariusz, eksport i import XLIFF oraz polecenia WP-CLI.