Generator altów AI dla WordPress: instalacja i konfiguracja

Wtyczka DockAccess AI Alt Generator dodaje generowanie tekstu alternatywnego do biblioteki mediów WordPressa oraz osobny ekran pracy zbiorczej. Wygenerowany opis zapisuje od razu w polu Tekst alternatywny załącznika. Nie wymaga instalacji widżetu dostępności.

Wymagania i zakres

Potrzebujesz WordPressa 6.0 lub nowszego, PHP 7.4 lub nowszego, uprawnień do instalowania wtyczek i edycji mediów oraz konta DockAccess. Zacznij od kilku kopii obrazów testowych. Wtyczka obsługuje obrazy biblioteki mediów; nie dodaje automatycznie altów do wszystkich ikon motywu ani teł CSS.

Krok 1. Przygotuj stronę 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 wtyczkę

1. Otwórz stronę generatora i sekcję Integracje. Wybierz WordPress i pobierz udostępnioną tam paczkę. Jeżeli karta nie ma przycisku pobierania, paczka nie została jeszcze udostępniona w katalogu.
2. W WordPressie przejdź do Wtyczki → Dodaj nową wtyczkę → Wyślij wtyczkę na serwer. Wskaż ZIP, wybierz Zainstaluj teraz, a następnie Włącz wtyczkę.
3. Otwórz Ustawienia → AI Alt Generator → Połączenie (Connection). Wklej token strony, login i hasło DockAccess. Wybierz Połącz (Connect).
4. Sprawdź status połączenia, adres witryny i aktywność usługi. Uruchom Test the endpoint, aby sprawdzić odbieranie zmian z DockAccess.

Użyj paczki generatora altów. Wtyczka Assist For WCAG służy do widżetu i ma osobną konfigurację. Jeżeli WordPress działa w podkatalogu lub za proxy, przed połączeniem sprawdź jego główny adres i działanie REST API.

Krok 3. Ustaw domyślne parametry

W Ustawienia → AI Alt Generator → Generowanie (Generation) wpisz kontekst witryny, do 500 znaków, i wybierz ton. Te wartości są punktem wyjścia; możesz je zmienić dla konkretnego obrazu. Dla dostępności zacznij od tonu neutralnego lub opisowego i kontekstu opisującego przeznaczenie zdjęć.

Krok 4. Wygeneruj i popraw jeden alt

1. Otwórz Media → Biblioteka i wybierz obraz.
2. Przy polu Tekst alternatywny sprawdź język oraz ustawienia generowania. Wybierz Generuj tekst alternatywny (Generate alt text).
3. Opis zostanie zastosowany i zapisany od razu. Sprawdź go i popraw ręcznie, jeżeli wymaga korekty.
4. Otwórz stronę używającą tego obrazu i sprawdź jej wynikowy img alt. Blok, kreator lub wcześniej zapisany HTML może mieć własny tekst, niezależny od biblioteki.

Krok 5. Generowanie zbiorcze

Otwórz Ustawienia → AI Alt Generator → Generowanie zbiorcze (Bulk generation). Wyszukaj obrazy, ustaw filtr brakujących altów, zaznacz wybrane pozycje i uruchom partię. Obrazy są wysyłane kolejno, a opisy zapisywane po każdym wyniku. Przejrzyj zaznaczenie: pusty alt może oznaczać świadomie pominiętą dekorację. Nie uruchamiaj równocześnie kilku partii dla tych samych mediów.

WPML, Polylang i synchronizacja

Wtyczka ustala język dla konkretnego medium z WPML lub Polylang; możesz go nadpisać przy obrazie. Bez takiej informacji korzysta z ustawień języka witryny. WordPress przechowuje jeden alt na załącznik. Jeżeli jedna wersja medium jest używana w kilku językach, zastosuj osobne tłumaczenia mediów lub rozwiązanie redakcyjne odpowiednie dla używanego systemu wielojęzycznego.

Po pierwszym generowaniu wtyczka zna identyfikator obrazu w DockAccess. Późniejsza zmiana jego pola alt w WordPressie jest synchronizowana z kontem. Wtyczka potrafi też przyjąć podpisaną aktualizację REST, ale obecna edycja na koncie nie uruchamia takiej wysyłki. Poprawkę wykonaną w DockAccess zapisz również w WordPressie. Synchronizacja nie obejmuje automatycznie każdego zdjęcia istniejącego wcześniej w bibliotece.

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 rozłączenie

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.

Rozłączenie wykonasz na ekranie Połączenie, podając dane DockAccess, albo przy integracji na koncie. Usunięcie połączenia nie usuwa tekstów zapisanych w bibliotece. Zasady pisania i sprawdzania opisów znajdziesz w poradniku obsługi generatora.