Tłumaczenie AI i SEO: kompletny przewodnik
Instalacja, konfiguracja i codzienna praca z tłumaczeniem oraz optymalizacją SEO przez AI produktów, kategorii, stron CMS i marek w PrestaShop 8 i 9.
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
- W panelu administracyjnym przejdź do Moduły > Menedżer modułów, kliknij Wgraj moduł i wskaż plik
dfaicontent-1.1.0.zip. - Po instalacji pod menu Katalog pojawia się zakładka Treść AI i SEO.
- 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)
- Zaznacz produkty lub kategorie na liście (wyszukiwanie po nazwie lub ID pomaga filtrować).
- 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ń).
- 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:
- 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.
- 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.