WebP AVIF Pro: kompletny przewodnik

WebP AVIF Pro konwertuje i kompresuje obrazy z Twojej biblioteki mediów do WebP albo AVIF, lokalnie, bez abonamentu i bez limitów. Ten przewodnik obejmuje instalację, dwa tryby dostarczania, generowanie tekstu ALT przez AI, SEO obrazów, przetwarzanie wsadowe, pracę w tle przez WP-Cron i WP-CLI, a także kopie zapasowe i rozwiązywanie problemów.

Wymagania serwerowe

Wtyczka działa z jednym z dwóch silników graficznych PHP:

• Imagick skompilowany z libheif (AVIF) i obsługą WebP: zalecany;
• GD z funkcjami imagewebp() i imageavif() (PHP 8.1 lub nowszy).

Strona Ustawienia wtyczki pokazuje plakietki wskazujące silniki i formaty faktycznie dostępne na Twoim hostingu (Imagick, GD, WebP, AVIF).

Instalacja

1. Wgraj katalog df-webp-avif-pro do /wp-content/plugins/ (albo zainstaluj ZIP przez Wtyczki, a następnie Dodaj nową).
2. Włącz rozszerzenie z menu Wtyczki.
3. Przejdź do WebP AVIF Pro, a następnie Ustawienia, aby skonfigurować format, tryb dostarczania, zmianę nazw i AI.
4. Uruchom analizę (symulację), a następnie optymalizację ze strony Optymalizacja.

Format wyjściowy i kompresja

Wybierz WebP (maksymalna zgodność) albo AVIF (lepsza kompresja). Główne opcje:

• Automatyczny fallback do WebP: jeśli żądany jest AVIF, ale jest niedostępny, wtyczka tworzy WebP zamiast zgłaszać błąd.
• Jakość: od 1 do 100, zalecane między 78 a 85.
• Skalowanie: ogranicza dłuższy bok do wartości w pikselach (0 = wyłączone). Tylko w trybie „zastąp”.
• Usuwanie EXIF/ICC: usuwa metadane, aby odchudzić pliki.
• Pomijanie animowanych GIF-ów: zapobiega psuciu animacji.

Tryby dostarczania

WebP AVIF Pro oferuje dwie strategie, do wyboru zależnie od kontekstu.

Zastąp

Plik oryginalny jest konwertowany, ewentualnie przemianowany, a wszystkie odwołania (treść wpisów, metadane) są przepisywane na nowy plik. Oryginały trafiają do kopii zapasowej, co umożliwia przywrócenie.

Zachowaj oryginał (nieniszczący)

Plik next-gen powstaje obok oryginału (na przykład photo.jpg i photo.jpg.webp). Przy wyświetlaniu wtyczka serwuje wersję next-gen wyłącznie przeglądarkom, które ją akceptują, na podstawie nagłówka Accept; pozostałe dostają oryginał. Żadne reguły htaccess nie są potrzebne.

Zmiana nazw pod SEO

Dostępne są cztery tryby zmiany nazw plików: brak, nazwa produktu (WooCommerce), własny szablon albo base64 (anonimizacja). Tryb szablon przyjmuje tokeny:

• {product} {title} {sku} {cat} {alt} {id} {date} {n}

Przykład: {product}-{cat}-{n} daje nazwę pliku w rodzaju dywan-na-wymiar-wejscie-a1b2c3.webp. Zmiana nazw nie działa w trybie „zachowaj oryginał”.

Tekst ALT przez AI

WebP AVIF Pro generuje opisowe atrybuty ALT przez AI, w wielu językach, na podstawie obrazu i kontekstu produktowego.

1. Włącz AI w Ustawieniach, wybierz dostawcę (Anthropic, OpenAI, Gemini, Mistral przy analizie wizualnej albo DeepSeek na samym kontekście) i wpisz swój klucz API.
2. Zaznacz pożądane języki. Pierwszy zaznaczony język zasila główny ALT; pozostałe są synchronizowane z tłumaczeniami Polylanga, jeśli istnieją.
3. Generuj teksty ALT ze strony ALT AI (wsadowo), automatycznie przy wysyłaniu albo obraz po obrazie przez akcję „Generuj ALT (AI)” w bibliotece mediów.

SEO na froncie

• Wymiary anty-CLS: dodaje atrybuty width i height do obrazów w treści, którym ich brakuje, aby ograniczyć przesunięcia układu (Core Web Vitals).
• Schema ImageObject: emituje blok JSON-LD na stronach i kartach produktów (obraz wyróżniający i galeria WooCommerce).

Optymalizacja wsadowa

Ze strony Optymalizacja:

• Analizuj (symulacja): szacuje zysk na próbce, bez żadnych zmian.
• Zoptymalizuj całą bibliotekę mediów: przetwarza obrazy partiami, bez blokowania serwera. Możesz opuścić stronę i wrócić później; przetwarzanie wznawia się w miejscu przerwania.

Karty statystyk pokazują liczbę przekonwertowanych obrazów, zaoszczędzone miejsce i historię miesięczną.

Praca w tle (WP-Cron) i WP-CLI

Przy dużych bibliotekach mediów włącz przetwarzanie w tle: wtyczka optymalizuje jedną partię co 5 minut przez WP-Cron, bez trzymania otwartej karty. Agencje mogą też sterować wtyczką z wiersza poleceń:

wp df-wap status
wp df-wap optimize --batch=20
wp df-wap optimize --dry-run
wp df-wap alt --batch=10
wp df-wap restore --yes

Kopie zapasowe, czyszczenie i przywracanie

W trybie „zastąp” oryginały kopiowane są do /wp-content/uploads/df-wap-backups/ (katalog chroniony). Możesz:

• Przywrócić pojedynczy obraz (akcja w bibliotece mediów) albo całą bibliotekę (przycisk „Przywróć wszystko”).
• Automatycznie czyścić kopie po zadanej liczbie dni, aby odzyskać miejsce na dysku.

W trybie „zachowaj” przywracanie po prostu usuwa pliki next-gen, ponieważ oryginały nigdy nie były modyfikowane.

Diagnostyka

Strona Optymalizacja wyświetla kontekstowe ostrzeżenia: obecność modułu przenoszącego media (S3/CDN), wykryte page buildery, żądany, ale niedostępny AVIF albo mało miejsca na dysku. Zastosuj się do tych zaleceń przed masowym przetwarzaniem.

Rozwiązywanie problemów

• AVIF niedostępny: włącz fallback do WebP albo przestaw format wyjściowy na WebP. Strona Ustawienia pokazuje dostępne silniki.
• Obrazy niezastąpione w page builderze: niektóre adresy przechowywane przez buildery wymykają się przepisywaniu. Wybierz tryb „zachowaj oryginał”.
• Teksty ALT niewygenerowane: sprawdź, czy AI jest włączone, czy klucz API jest prawidłowy i czy u dostawcy pozostał kredyt.
• Przetwarzanie wsadowe wydaje się wolne: zmniejsz liczbę obrazów w partii (AVIF jest zasobożerny) albo skorzystaj z pracy w tle lub WP-CLI.