dfaimetagen: generator AI meta tytułów, opisów i ALT

Prezentacja

dfaimetagen generuje masowo meta tytuły, meta opisy i atrybuty ALT obrazów przez AI (Anthropic Claude, OpenAI GPT albo Mistral) w PrestaShop 8 i 9. Moduł obsługuje 6 typów encji (produkty, kategorie, strony CMS, producenci, dostawcy, obrazy produktów), stosuje sprawdzone wzorce CTR, tworzy warianty A/B, kontroluje długości pod SERP i odrzuca duplikaty przez podobieństwo Jaccarda.

Wymagania

• PrestaShop 8.0 do 9.x
• PHP 8.1, 8.2, 8.3 albo 8.4
• Rozszerzenia PHP: curl, json, iconv
• MySQL 5.7+ albo MariaDB 10.3+
• Klucz API u co najmniej jednego dostawcy: Anthropic, OpenAI albo Mistral

Instalacja

1. Pobierz plik dfaimetagen.zip ze swojego konta klienta.
2. W back office PrestaShop przejdź do Moduły > Menedżer modułów > Dodaj nowy moduł.
3. Wgraj plik ZIP i kliknij Zainstaluj.
4. Moduł tworzy 6 tabel w bazie (prefiks df_aimeta_), instaluje 11 domyślnych wzorców CTR i generuje losowy token CRON.
5. W menu Katalog pojawia się nowa zakładka AI Meta Generator.

Konfiguracja dostawcy AI

1. Przejdź do Katalog > AI Meta Generator > Ustawienia.
2. Wybierz aktywnego dostawcę: Anthropic (dobre rezultaty przy krótkich tekstach marketingowych, również po polsku), OpenAI albo Mistral.
3. Wklej swój klucz API w odpowiednie pole.
4. Kliknij przycisk Test obok pola, aby sprawdzić połączenie: powinieneś otrzymać odpowiedź „OK”.
5. Domyślne modele to claude-sonnet-4-5, gpt-4o-mini i mistral-large-latest. Możesz je zmienić, jeśli wolisz inny model tego samego dostawcy.

Ustawienia generowania

Nadal w Ustawieniach możesz dostosować:

• Limity długości: domyślnie zgodne z zaleceniami Google SERP: meta tytuł od 35 do 60 znaków, meta opis od 120 do 158, ALT od 25 do 125. Jeśli AI przekroczy limit, tekst jest przycinany czysto na granicy wyrazu.
• Warianty A/B na pozycję: od 1 do 5 alternatyw generowanych na encję i na język.
• Próg ochrony przed duplikatami: procent podobieństwa Jaccarda, powyżej którego wariant jest odrzucany (domyślnie 85 procent). Porównanie jest niewrażliwe na znaki diakrytyczne.
• Rozmiar partii: liczba pozycji przetwarzanych na jeden cykl AJAX albo CRON (domyślnie 10, maksymalnie 100).
• Timeout HTTP: maksymalny czas oczekiwania na odpowiedź dostawcy (domyślnie 60 s).
• Nadpisz / Pomiń niepuste: domyślne zachowanie wobec już uzupełnionych metadanych.

Uruchomienie masowego generowania

1. Przejdź do Katalog > AI Meta Generator > Bulk Generation.
2. Encja: produkty, kategorie, strony CMS, producenci, dostawcy albo obrazy produktów.
3. Pole: meta tytuł, meta opis albo ALT obrazu (ALT dotyczy obrazów produktów).
4. Wzorzec CTR: wybierz konkretny wzorzec albo zostaw Auto, aby użyć domyślnego wzorca dla danego pola.
5. Języki: wybór wielokrotny, generowanie jest mnożone (pozycje × języki).
6. Zakres: wszystkie encje, lista identyfikatorów albo filtr po kategorii lub producencie.
7. Limit: ustaw 10 albo 20 na potrzeby testu, 0 aby przetworzyć wszystko.
8. Kliknij Utwórz zadanie.

Śledzenie i uruchamianie zadań

Strona Zadania wymienia wszystkie zadania z ich postępem, statystykami (udane / nieudane / pominięte) i statusem. Trzy tryby uruchamiania:

• Uruchom do końca (strona szczegółów zadania): przetwarza partie w pętli przez AJAX z paskiem postępu na żywo. Zostaw kartę otwartą.
• Uruchom jedną partię: przetwarza jedną partię, po czym przeładowuje stronę.
• CRON: przetwarzanie w tle, zalecane przy dużych katalogach (opis poniżej).

Zadanie można anulować w trakcie, uruchomić ponownie od początku albo usunąć. Pełna historia każdej generacji (status, tokeny wejściowe i wyjściowe, ewentualny błąd) jest zachowywana w zakładce Historia w szczegółach zadania.

Konfiguracja CRON

1. W Ustawieniach, w sekcji CRON, skopiuj wyświetlony adres URL. Ma on postać:
   https://twoj-sklep.pl/modules/dfaimetagen/cron.php?token=TWOJ_TOKEN
2. Dodaj go do crontaba serwera, na przykład co 5 minut:
   */5 * * * * curl -s "https://twoj-sklep.pl/modules/dfaimetagen/cron.php?token=TWOJ_TOKEN" >/dev/null
3. Każde przejście przetwarza do 5 partii najstarszego oczekującego zadania. Parametry opcjonalne: &batch=20 (rozmiar partii) i &loops=10 (liczba partii na przejście).

Warianty A/B i aktywacja

Każda generacja tworzy skonfigurowaną liczbę wariantów (od 1 do 5). Pierwszy poprawny wariant jest zapisywany na encji i oznaczany jako Aktywny. Pozostałe czekają w rezerwie na stronie szczegółów zadania:

• Kliknij Aktywuj obok wariantu, aby natychmiast zapisać go na encji.
• Pozostałe warianty tej samej trójki (encja, pole, język) są automatycznie dezaktywowane.
• Licznik znaków przy każdym wariancie pozwala jednym rzutem oka sprawdzić zgodność z SERP.

Wzorce CTR

11 preinstalowanych wzorców obejmuje trzy rodziny:

• Meta tytuły: korzyść plus rok, lista numerowana, nawiasy z USP, pytanie przyciągające uwagę, słowa o dużej sile oddziaływania.
• Meta opisy: nawarstwianie korzyści, społeczny dowód słuszności, problem i rozwiązanie, bezpośrednie CTA.
• ALT obrazów: opisowy, kontekstowy.

Aby tworzyć własne wzorce, przejdź do Katalog > AI Meta Generator > Wzorce. Szablon przyjmuje tokeny dynamiczne:

• {NAME}, {BRAND}, {CATEGORY}, {PRICE}, {YEAR}, {NUMBER}, {LANG_NAME}: wypełniane automatycznie przez moduł;
• {BENEFIT}, {USP}, {CONTEXT}: wypełniane przez AI w momencie generowania.

Wzorce oznaczone jako „systemowe” są dostarczane z modułem i zachowywane przy aktualizacjach.

Zaawansowane szablony promptów

Aby mieć pełną kontrolę nad zachowaniem AI, twórz szablony w Katalog > AI Meta Generator > Prompt Templates. Każdy szablon celuje w trójkę (encja, pole, język albo wszystkie języki) i definiuje:

• system prompt: rolę, ton, ograniczenia globalne;
• user prompt: z tokenami {NAME}, {BRAND}, {CATEGORY}, {DESCRIPTION}, {PRICE}, {PATTERN}, {LANG_NAME}, {MIN_LENGTH}, {MAX_LENGTH}, {AB_VARIANTS}, {EXISTING}.

Oznacz szablon jako „domyślny”, aby stosował się automatycznie do swojej trójki.

Ochrona przed duplikatami

Zanim wariant zostanie zachowany, moduł porównuje go z wariantami już zapisanymi:

1. Dokładny hash (sha1 znormalizowanej wersji): natychmiastowe odrzucenie przy idealnym duplikacie.
2. Podobieństwo Jaccarda na zbiorach znormalizowanych słów (małe litery, bez znaków diakrytycznych): odrzucenie, jeśli podobieństwo przekracza skonfigurowany próg.

Odrzucony wariant jest automatycznie generowany ponownie przez AI (w granicach liczby prób danej partii).

Pulpit

Strona Pulpit agreguje: liczbę zadań (łącznie, oczekujących, zakończonych), warianty wygenerowane i aktywne, generacje udane i nieudane, zużyte tokeny (wejściowe plus wyjściowe), ostatnie zadania i ostatnie generacje. Używaj jej do pilnowania budżetu AI i wykrywania błędów dostawcy.

Multistore

Moduł odczytuje i zapisuje wartości z uwzględnieniem kontekstu sklepu, jeśli dana tabela *_lang ma kolumnę id_shop. Przy instalacji multistore wybierz docelowy sklep w formularzu masowego generowania.

Rozwiązywanie problemów

• „FAIL” przy teście połączenia: sprawdź klucz API, saldo kredytów u dostawcy oraz to, czy Twój serwer zezwala na wychodzące połączenia HTTPS (cURL) do api.anthropic.com, api.openai.com albo api.mistral.ai.
• Zadanie zablokowane w stanie „running”: uruchom partię ręcznie ze strony szczegółów albo poczekaj na kolejne przejście CRON. Zadanie zawsze można anulować i uruchomić ponownie.
• Puste albo przycięte warianty: zwiększ timeout HTTP w Ustawieniach albo wybierz szybszy model.
• 403 na adresie CRON: token w adresie URL już nie pasuje (mógł zostać wygenerowany ponownie). Skopiuj adres URL jeszcze raz z Ustawień.
• Dla niektórych encji nic się nie generuje: jeśli opcja „Pomiń niepuste” jest aktywna, encje już uzupełnione są celowo pomijane. Zaznacz „Nadpisz”, aby wymusić generowanie.

Deinstalacja

Deinstalacja usuwa 6 tabel modułu i jego klucze konfiguracji. Metadane wygenerowane i już zapisane na Twoich produktach, kategoriach i obrazach zostają zachowane: należą do Twojego katalogu.