Generator altów AI dla Joomla: instalacja i konfiguracja

Pakiet DockAccess AI Alt Generator dla Joomla zawiera komponent zarządzania połączeniem i altami oraz wtyczkę treści synchronizującą zmiany w artykułach. Generuje opisy obrazu wprowadzenia i obrazu pełnego artykułu z zakładki Obrazy i łącza.

Wymagania i zakres

Potrzebujesz Joomla 5.4 lub nowszej z linii 5.x albo Joomla 6.x, PHP 8.1+, konta DockAccess oraz uprawnień instalacji rozszerzeń. Dostęp do komponentu i konfiguracji zależy od uprawnień Joomla; generowanie wymaga prawa do edycji danego artykułu. Obrazy osadzone wewnątrz treści artykułu, pola rozszerzeń, tła i grafiki szablonu nie są objęte tym ekranem. Obrazy z obcych serwerów są wyświetlane, ale generowanie wymaga lokalnego pliku.

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 pakiet

1. Pobierz pakiet ZIP dla Joomla. Nie rozpakowuj go.
2. W zapleczu Joomla przejdź do System → Instalacja → Rozszerzenia i prześlij ZIP. Możesz też użyć instalacji z adresu URL paczki.
3. Otwórz Komponenty → DockAccess AI Alt Generator → Połączenie (Connection). Podaj token strony, login i hasło DockAccess i wybierz Połącz (Connect).
4. Sprawdź połączony adres i aktywny generator. Wykonaj Test the push endpoint. Sprawdź też, czy wtyczka treści DockAccess AI Alt Generator jest włączona; instalator włącza ją automatycznie.

Krok 3. Ustaw parametry i wygeneruj opis

1. Na ekranie Połączenie ustaw domyślny kontekst, do 500 znaków, i ton. Zapisz ustawienia.
2. Otwórz Komponenty → DockAccess AI Alt Generator → Teksty alternatywne (Alt texts). Wyszukaj artykuł, ustaw filtr lub wybierz język.
3. Sprawdź, czy edytujesz obraz wprowadzenia, czy pełnego artykułu. Wybierz Generuj przy jednym obrazie. Wynik zapisuje się od razu w artykule, a flaga braku opisu dla tego pola jest wyłączana.
4. Popraw tekst i zapisz. Jeżeli obraz jest dekoracyjny, zachowaj świadomą decyzję o braku opisu zamiast generować go zbiorczo.
5. Po sprawdzeniu próby zaznacz obrazy do partii i uruchom generowanie. Obrazy niedostępne do generowania nie powinny być w niej przetwarzane.

Język i synchronizacja artykułów

Opis powstaje w języku artykułu. Artykuł przypisany do „Wszystkie” korzysta z domyślnego języka witryny. Jeden slot obrazu w artykule przechowuje jeden alt; inne tłumaczenie artykułu może mieć własny tekst.

Zmiana altu powiązanego obrazu na ekranie komponentu lub podczas zapisu artykułu jest przesyłana do DockAccess. Komponent może odbierać podpisane aktualizacje, wybierając tekst w języku artykułu lub pierwszy dostępny. Obecna edycja na koncie nie wysyła jednak tych aktualizacji automatycznie: poprawkę zapisz również w artykule Joomla. Zastąpienie pliku w danym slocie zrywa wcześniejsze powiązanie z obrazem: nowy plik wygeneruj ponownie.

Po zapisaniu sprawdź widok kategorii i pełnego artykułu. Szablon musi wykorzystywać pola alt obu obrazów. Usuń ewentualny cache Joomla i CDN.

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.

Aktualizacje i diagnostyka

Pakiet rejestruje serwer aktualizacji, więc nowe wydania instalujesz przez standardowy mechanizm aktualizacji Joomla. Po aktualizacji sprawdź połączenie i jeden artykuł. Odinstalowanie pakietu usuwa jego konfigurację i powiązania; teksty zapisane w artykułach pozostają w ich danych.

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.

Zasady sprawdzania opisów i obsługi konta znajdziesz w ogólnym poradniku generatora altów.