# 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… - Strona: - Język: pl - Zaktualizowano: 2026-07-29 - Inne języki: [fr](https://www.datafirefly.com/documentation/webp-avif-pro/index.md), [en](https://www.datafirefly.com/en/documentation/webp-avif-pro/index.md), [es](https://www.datafirefly.com/es/documentation/webp-avif-pro/index.md), [de](https://www.datafirefly.com/de/documentation/webp-avif-pro/index.md), [it](https://www.datafirefly.com/it/documentation/webp-avif-pro/index.md), [nl](https://www.datafirefly.com/nl/documentation/webp-avif-pro/index.md), [pt](https://www.datafirefly.com/pt/documentation/webp-avif-pro/index.md) - Indeks: 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). Na hostingu współdzielonym AVIF nie zawsze jest dostępny. Włącz automatyczny fallback do WebP (patrz niżej), aby zagwarantować konwersję w każdym przypadku. ## 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. Przed pierwszym masowym przetwarzaniem zrób kopię bazy i plików. Sprawdź, czy opcja tworzenia kopii oryginałów jest aktywna, aby móc się wycofać. ### 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. Tryb „zachowaj" jest najbezpieczniejszy dla AVIF, mediów przeniesionych (CDN/S3) i page builderów, ponieważ nigdy nie modyfikuje pliku źródłowego ani bazy. ## 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. Wtyczka jest bez abonamentu, ale każde wywołanie AI rozliczane jest przez Twojego dostawcę zgodnie z Twoim kluczem API. Generowanie wsadowe przebiega małymi paczkami, aby respektować limity przepustowości. ## 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. Wtyczka jest zgodna z WordPressem 6.5+, WooCommerce (HPOS), Polylangiem, trybem multisite oraz PHP od 8.1 do 8.3.