# 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…

- Strona: <https://www.datafirefly.com/pl/documentation/df-translate/>
- Język: pl
- Zaktualizowano: 2026-07-29
- Inne języki: [fr](https://www.datafirefly.com/documentation/df-translate/index.md), [en](https://www.datafirefly.com/en/documentation/df-translate/index.md), [es](https://www.datafirefly.com/es/documentation/df-translate/index.md), [de](https://www.datafirefly.com/de/documentation/df-translate/index.md), [it](https://www.datafirefly.com/it/documentation/df-translate/index.md), [nl](https://www.datafirefly.com/nl/documentation/df-translate/index.md), [pt](https://www.datafirefly.com/pt/documentation/df-translate/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

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**.

Zgodne z WordPressem 6.2 i nowszym, PHP 8.0 do 8.3, multisite. Zgodne z WooCommerce (produkty proste, kategorie, etykiety) oraz z wtyczkami SEO Yoast, Rank Math, AIOSEO i SEOPress. Bez zależności Composera przy wdrożeniu.

## 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.

DeepL oferuje darmowy próg API: to dobra opcja na start bez kosztów. Dla najlepszej jakości redakcyjnej na kartach produktów zalecany jest Claude (Anthropic).

## 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.

Nie możesz usunąć języka domyślnego: najpierw wyznacz inny język jako domyślny. Po zmianie języków albo przedrostków URL wyczyść cache witryny i w razie potrzeby odśwież bezpośrednie odnośniki (Ustawienia → Bezpośrednie odnośniki → Zapisz).

## 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.

Bez abonamentu za słowo i bez proxy: Twoja treść opuszcza witrynę wyłącznie w kierunku dostawcy, którego skonfigurujesz, i tylko wtedy, gdy uruchomisz tłumaczenie. Możesz też nie konfigurować żadnego silnika i tłumaczyć w całości ręcznie.

## 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.

Gdy zmodyfikujesz przetłumaczoną już treść źródłową, jej tłumaczenia zostają oznaczone jako „nieaktualne" (↻). Otwórz je w widoku obok siebie, aby przetłumaczyć ponownie tylko zmienione pola.

## 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.

Produkty wariantowe, e-maile o zamówieniu w języku klienta i przetłumaczone bazy adresów URL należą do DF Translate Pro.

## 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).

Przed każdą migracją zrób kopię bazy, z zasady. Migracja zaprojektowana jest jako nieniszcząca, ale kopia zapasowa pozostaje dobrą praktyką.

## 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.