# Tłumaczenie AI i SEO: kompletny przewodnik > Ten moduł tłumaczy i ulepsza treść oraz dane SEO Twoich produktów, kategorii, stron CMS i marek z wybraną przez Ciebie AI: ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google) lub Mistral, we… - Strona: - Język: pl - Zaktualizowano: 2026-07-31 - Inne języki: [fr](https://www.datafirefly.com/documentation/ai-translation-seo-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/ai-translation-seo-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/ai-translation-seo-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/ai-translation-seo-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/ai-translation-seo-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/ai-translation-seo-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/ai-translation-seo-prestashop/index.md) - Indeks: Ten moduł tłumaczy i ulepsza treść oraz dane SEO Twoich **produktów, kategorii, stron CMS i marek** z wybraną przez Ciebie AI: ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google) lub Mistral, we wszystkich językach zainstalowanych w sklepie PrestaShop 8 lub 9. Zaprojektowany dla osoby zarządzającej sklepem: zaznaczasz, wybierasz języki, uruchamiasz. **W skrócie:** podłącz klucz API, zaznacz karty, wybierz język źródłowy i języki docelowe, kliknij _Uruchom_. Pasek postępu przetwarza każdą kombinację karta i język bez timeoutu serwera. Podgląd przed/po, wynik SEO i rollback jednym kliknięciem w zestawie. ## Instalacja 1. W panelu administracyjnym przejdź do **Moduły > Menedżer modułów**, kliknij **Wgraj moduł** i wskaż plik `dfaicontent-1.1.0.zip`. 2. Po instalacji pod menu **Katalog** pojawia się zakładka **Treść AI i SEO**. 3. Otwórz zakładkę **Ustawienia** i skonfiguruj co najmniej jednego dostawcę AI przed pierwszym użyciem. ## Konfiguracja dostawcy AI Moduł współpracuje z czterema dostawcami. Używasz **własnego klucza API** i płacisz za AI według zużycia bezpośrednio u dostawcy: moduł nie nalicza żadnego dodatkowego abonamentu. - **Aktywny dostawca**: dostawca używany do generowania treści. - **Klucz API** i **Model** per dostawca: na przykład `gpt-4o-mini` (OpenAI), `claude-sonnet-4` (Anthropic), `gemini-2.0-flash` (Google), `mistral-small-latest` (Mistral). - Kliknij **Test** obok każdego dostawcy, aby sprawdzić połączenie. Aby kontrolować budżet, zacznij od ekonomicznego modelu (Mistral Small, GPT-4o mini). Kompletne tłumaczenie karty produktu kosztuje zwykle ułamek centa. ## Uruchomienie tłumaczenia (3 kroki) 1. **Zaznacz** produkty lub kategorie na liście (wyszukiwanie po nazwie lub ID pomaga filtrować). 2. Na pasku akcji ustaw **język źródłowy**, **języki docelowe**, **pola** do przetworzenia, **tryb** i **szybkość** (1 do 3 równoległych żądań). 3. Kliknij **Uruchom**. Wyświetla się szacunek tokenów i kosztu do potwierdzenia, po czym kolejka wykonuje się z paskiem postępu i dziennikiem. ### Trzy tryby - **Tłumacz**: wierne tłumaczenie z języka źródłowego na każdy język docelowy. - **Tłumacz i ulepsz** (domyślny): tłumaczenie, a następnie przepisanie pod kątem copywritingu i SEO. - **Ulepsz (ten sam język)**: przepisuje każdy język docelowy na miejscu, język źródłowy jest pomijany. ### Obsługiwane pola - **Produkty**: nazwa, krótki opis, opis, meta tytuł, meta opis, przyjazny URL, tagi (słowa kluczowe) i atrybuty alt obrazów. - **Kategorie**: nazwa, opis, opis dodatkowy, meta, przyjazny URL. - **Strony CMS**: treść, meta tytuł, meta opis, przyjazny URL. - **Marki**: opis krótki i długi, meta tytuł, meta opis. PrestaShop 8 usunął pole _meta keywords_: moduł generuje w zamian **tagi produktów**. W sklepie po migracji, gdzie kolumna nadal istnieje, jest ona wykrywana i proponowana automatycznie. ## Podgląd przed / po Przycisk **Podgląd** w wierszu generuje treść **bez zapisywania czegokolwiek** i pokazuje porównanie przed/po. Jeśli wynik odpowiada, _Zastosuj tę treść_ zapisuje dokładnie to, co zostało podejrzane, bez drugiego wywołania AI, czyli bez dodatkowego kosztu. Zawsze przetestuj jedną kartę w podglądzie przed dużą partią. ## Wynik SEO Przycisk **SEO** w każdym wierszu wylicza wynik od 0 do 100 per język, ze szczegółową listą kontrolną: długości meta tytułu i meta opisu, obecność słowa kluczowego na początku tytułu, bogactwo treści, śródtytuły, poprawność sluga, liczba tagów i pokrycie atrybutów alt. ## Zgodność z Creative Elements Opisy zbudowane w Creative Elements (lub Elementorze) są chronione dwoma mechanizmami: - **Tokenizacja**: skrypty, style, ramki iframe, SVG, shortcode'y `[...]` i placeholdery `{...}` są zastępowane tokenami przed wysłaniem do AI, a następnie wstawiane z powrotem w identycznej formie. - **Ścisła instrukcja systemowa**: AI tłumaczy wyłącznie widoczny tekst i zachowuje wszystkie tagi, klasy, identyfikatory, style inline oraz atrybuty `data-*`. Jeśli używasz widgetu Creative Elements, który generuje nieobsłużony wzorzec, dodaj wzorzec w metodzie `protect()` klasy `DfAiContentProcessor`. ## Historia i rollback Każda partia jest logowana wraz z poprzednimi wartościami wszystkich pól. Zakładka **Historia** pozwala przywrócić kompletną operację jednym kliknięciem, włącznie z tagami i atrybutami alt. Wpis historii zostaje wtedy usunięty. ## Szacunek kosztu Przed każdym uruchomieniem moduł mierzy rzeczywistą objętość wybranych treści w bazie danych i wyświetla liczbę wywołań, szacowane tokeny wejściowe i wyjściowe oraz odpowiadający im koszt według skonfigurowanych przez Ciebie stawek za milion tokenów. ## Cron automatycznego tłumaczenia Moduł może tłumaczyć nowe treści automatycznie: 1. W **Ustawienia > Cron** włącz cron i ustaw język źródłowy, języki docelowe, pola, typy treści oraz limit na jedno wykonanie. 2. Skopiuj **URL zabezpieczony tokenem** i wywołuj go co 5 do 15 minut z harmonogramu swojego hostingu. Przy każdym przebiegu moduł wykrywa karty, których źródło ma treść, ale cele nie mają ani meta tytułu, ani opisu, i tłumaczy ich małą partię. Lista pominięć zapobiega nieskończonemu ponawianiu karty z błędem, a dziennik ostatniego przebiegu jest wyświetlany w ustawieniach. Po wygenerowaniu nowego tokenu stary URL crona natychmiast przestaje działać: pamiętaj o aktualizacji harmonogramu. ## Ustawienia redakcyjne - **Terminy chronione**: marki i nazwy produktów nigdy nietłumaczone (jeden na wiersz). - **Glosariusz**: narzucone tłumaczenia, jedna reguła na wiersz w formacie `termin źródłowy => tłumaczenie`. - **Ton pisania**, **maksymalne długości SEO** i **własne instrukcje** właściwe dla Twojego sklepu. ## Rozwiązywanie problemów - **„Source content is empty”**: karta nie ma treści w wybranym języku źródłowym, wskaż inny język źródłowy. - **Błąd klucza API**: sprawdź klucz i model w Ustawieniach, a następnie użyj przycisku Test. - **Język docelowy identyczny ze źródłowym** jest automatycznie pomijany w trybie Tłumacz. ## Uwagi techniczne - Zgodny z PrestaShop 8.0 do 9.x, bez override'u rdzenia (kontroler administracyjny i natywne mechanizmy). - W trybie multisklep działa na sklepie bieżącego kontekstu. - Brak zależności Composer; treści są wysyłane wyłącznie do API wybranego dostawcy przez Twój klucz.