Generator altów AI dla PrestaShop: instalacja i konfiguracja

Moduł DockAccess AI Alt Generator generuje opisy zdjęć produktów i zapisuje je jako legendy obrazów w wybranym języku sklepu. Możesz generować pojedynczo, pracować na zaznaczonej partii oraz synchronizować ręczne poprawki z DockAccess.

Wymagania i zakres

Moduł jest przeznaczony dla PrestaShop 1.7.8+, 8.x i 9.x oraz PHP 7.4+. Potrzebujesz konta DockAccess i dostępu do instalacji modułów oraz katalogu produktów. Ekran generatora dotyczy zdjęć produktów, nie wszystkich grafik sklepu: bannery, logo, obrazy kategorii i tła wymagają osobnej obsługi.

Krok 1. Przygotuj sklep w DockAccess

1. Zaloguj się do DockAccess lub załóż konto, a następnie potwierdź adres e-mail.
2. Otwórz Moje strony, wybierz Dodaj stronę i wpisz domenę produkcyjną, bez protokołu i ścieżki. Jeżeli strona już istnieje, otwórz jej konfigurację zamiast tworzyć duplikat.
3. Włącz Generator ALT dla tej strony i zapisz zmiany. Jeżeli usługa jest wstrzymana, najpierw rozwiąż problem z limitem stron na koncie.
4. Skopiuj token strony z jej konfiguracji. W formularzu połączenia w CMS-ie podaj ten token oraz login i hasło konta DockAccess, do którego należy strona. Wybierz Połącz.
5. Sprawdź status połączenia i adres strony, a następnie wygeneruj jeden opis próbny przed uruchomieniem większej partii. Wtyczka powinna być też widoczna wśród połączonych integracji tej strony w DockAccess.

Token strony identyfikuje witrynę. Różni się od klucza API konta i sekretu połączenia. Podaj dane logowania do DockAccess, a nie dane administratora CMS-a. Oficjalne wtyczki używają hasła przy żądaniu połączenia i go nie zapisują. Jeżeli logujesz się przez konto społecznościowe i nie masz hasła, najpierw ustaw je przez odzyskiwanie hasła.

Krok 2. Zainstaluj i połącz moduł

1. Pobierz ZIP generatora altów dla PrestaShop. Nie rozpakowuj go.
2. W zapleczu PrestaShop otwórz Moduły → Menedżer modułów → Załaduj moduł. Prześlij ZIP i przejdź do Konfiguruj przy AI Alt Generator.
3. W zakładce Połączenie (Connection) wklej token strony oraz login i hasło DockAccess. Wybierz Połącz (Connect).
4. Sprawdź adres sklepu i status aktywnej usługi. Uruchom Test the endpoint. Przy sklepie za reverse proxy adres powinien wskazywać publiczny HTTPS.

Krok 3. Kontekst i ton

W zakładce Generowanie (Generation) ustaw kontekst, do 500 znaków, i ton. Kontekst powinien opisywać ofertę lub zastosowanie zdjęć, np. „Zdjęcia produktów sklepu z plecakami”. Unikaj poleceń wstawiania słów kluczowych. Zapisz ustawienia i przejdź do Katalog → AI Alt Generator.

Krok 4. Język, opis i generowanie zbiorcze

1. Wybierz język sklepu na ekranie zdjęć. Każda wersja językowa ma osobną legendę.
2. Wyszukaj produkt lub użyj filtra brakujących opisów. Wygeneruj jeden alt i sprawdź jego wynik w polu legendy.
3. Popraw tekst i zapisz. PrestaShop ogranicza legendę do 128 znaków; znaki < > = { } są usuwane przez moduł zgodnie z ograniczeniami pola. Sprawdź zapisany wynik po skróceniu.
4. Po udanej próbie zaznacz wybrane zdjęcia i rozpocznij partię. Gotowe wyniki zapisują się kolejno. Powtórz pracę dla pozostałych języków, które chcesz uzupełnić.

Synchronizacja i kontrola na stronie produktu

Dla powiązanych zdjęć zmiany legendy wykonane w zapleczu są przesyłane do DockAccess. Moduł ma przygotowany odbiór podpisanych aktualizacji w pasujących językach sklepu, ale obecna edycja na koncie nie uruchamia ich wysyłania. Poprawkę z konta zapisz również w sklepie. Języki niewłączone w sklepie są pomijane przy odbiorze aktualizacji. Własny motyw musi wykorzystywać legendę w atrybucie alt: sprawdź kartę produktu, galerię i listę produktów po wyczyszczeniu cache. Zmiana danych modułu nie naprawi motywu, który ignoruje to pole.

Limity

Standardowy plan bezpłatny obejmuje 10 generowań opisów obrazów na dobę UTC i 1 stronę z włączonym Generatorem ALT. Gotowe integracje CMS działają również w planie bezpłatnym.

Płatne plany generatora altów mają limit na miesiąc kalendarzowy, dostępny w całości, bez podziału na dni. Limit stron jest niezależny od limitu generowania. Aktualny limit i wykorzystanie sprawdzisz na pulpicie konta. Sprawdź aktualne plany

Limit generowania jest wspólny dla całego konta: narzędzie online, połączone strony i API korzystają z tej samej puli. Ponowne wygenerowanie opisu też zużywa limit; ręczna edycja zapisanego tekstu nie generuje nowego opisu.

Limit dobowy odnawia się o 00:00 UTC, a miesięczny o 00:00 UTC pierwszego dnia kolejnego miesiąca kalendarzowego. Nie zależy to od daty płatności za subskrypcję. W Polsce 00:00 UTC przypada o 01:00 zimą i o 02:00 latem. Usługa zużycia zwraca dokładny termin odnowienia w polu resets_at.

Generowanie zbiorcze przetwarza obrazy kolejno. Po wyczerpaniu limitu konta gotowe opisy pozostają zapisane, a partia się zatrzymuje. Pozostałe obrazy przetwórz po odnowieniu limitu lub zmianie planu. Chwilowy limit częstotliwości powoduje oczekiwanie i ponowienie próby. Starsze wersje wtyczek mogą opisywać miesięczny licznik jako „dzienny”; sprawdzaj okres i termin odnowienia na koncie DockAccess.

Diagnostyka i utrzymanie

Odmowa połączenia: logowanie lub potwierdzenie e-maila

Użyj konta DockAccess, do którego należy token strony, potwierdź adres e-mail i sprawdź login oraz hasło. Powtarzające się błędne próby mogą czasowo zablokować kolejne połączenia.

Adres strony się nie zgadza

Sprawdź, czy produkcyjny adres CMS-a znajduje się wśród domen tokenu. Połączenie środowiska testowego nie potwierdza domeny produkcyjnej. Przed ponownym połączeniem sprawdź HTTPS, ustawienia reverse proxy i główny adres witryny.

Generator wyłączony (alt_disabled)

Włącz Generator ALT dla tej konkretnej strony w DockAccess i zapisz zmiany. Sama instalacja wtyczki nie uruchamia usługi.

Generator wstrzymany (alt_paused)

Przekroczono limit stron na koncie, np. po zmianie planu. Zwolnij miejsce, wyłączając usługę na innej stronie, lub zwiększ limit. Wstrzymane strony i wcześniej wygenerowane teksty nie są usuwane.

Strona jest już połączona

Zastąp połączenie tylko wtedy, gdy chcesz ponownie połączyć tę instalację. Potwierdzenie zastąpienia zmienia sekret połączenia, więc inne kopie korzystające z poprzedniego sekretu trzeba połączyć ponownie.

Wyczerpany limit dobowy lub miesięczny

Sprawdź pulpit konta i termin odnowienia. Gotowe teksty pozostają zapisane. Poczekaj na rozpoczęcie kolejnego okresu UTC lub wybierz wyższy plan; ponowne połączenie nie zeruje zużycia.

Zbyt wiele żądań w krótkim czasie

Pozwól, aby partia odczekała i ponowiła próbę. We własnej integracji uwzględniaj Retry-After i rozróżniaj X-Alt-Reason: rate_limited od limit_reached. Unikaj wielokrotnego klikania Generuj.

Nie można wygenerować opisu obrazu

Sprawdź, czy CMS może odczytać oryginalny plik lokalny. Użyj poprawnego obsługiwanego pliku rastrowego, np. JPEG, PNG lub WebP. Samo rozszerzenie nie wystarczy; nieobsługiwane lub uszkodzone pliki przekonwertuj albo zastąp. Joomla nie generuje opisów obrazów artykułów pobieranych z obcych serwerów.

Zmiany nie docierają do CMS-a

Obecna edycja na koncie nie wysyła zmian automatycznie do CMS-a; poprawkę zapisz również tam. Wtyczki mają przygotowany odbiór push. Przy wdrażaniu własnego nadawcy uruchom test endpointu, sprawdź publiczny HTTPS, trasy, zaporę, nagłówki podpisu i zegary serwerów. Podpisane żądania dopuszczają pięć minut różnicy czasu i wymagają powiązania z lokalnym obrazem.

Zapisany alt nie jest widoczny na stronie

Sprawdź wynikowy element img i wyczyść cache strony, szablonu oraz CDN. Pole obrazu w CMS-ie nie zawsze aktualizuje HTML zapisany wcześniej w artykule lub kreatorze stron. Popraw dane użycie obrazu albo szablon. Nie uzupełniaj zbiorczo celowo pustych altów obrazów dekoracyjnych.

Po aktualizacji modułu sprawdź połączenie i jeden produkt w każdym używanym języku. Do rozłączenia użyj formularza Connection albo listy integracji na koncie. Zachowaj poprawne legendy redakcyjne. Szersze zasady pracy opisuje poradnik obsługi generatora.