# WebP AVIF Pro: volledige handleiding > WebP AVIF Pro zet de afbeeldingen uit uw mediabibliotheek lokaal om naar WebP of AVIF en comprimeert ze, zonder abonnement of quotum. Deze handleiding behandelt de installatie, de twee leveringsmodi,… - Pagina: - Taal: nl - Bijgewerkt op: 2026-08-19 - Andere talen: [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), [pl](https://www.datafirefly.com/pl/documentation/webp-avif-pro/index.md), [pt](https://www.datafirefly.com/pt/documentation/webp-avif-pro/index.md) - Index: WebP AVIF Pro zet de afbeeldingen uit uw mediabibliotheek lokaal om naar WebP of AVIF en comprimeert ze, zonder abonnement of quotum. Deze handleiding behandelt de installatie, de twee leveringsmodi, het genereren van ALT-teksten met AI, beeld-SEO, de bulkverwerking, de achtergrondverwerking via WP-Cron en WP-CLI, en tot slot de back-up en het oplossen van problemen. ## Serververeisten De plugin werkt met een van de twee beeldmotoren van PHP: - **Imagick**, gecompileerd met libheif (AVIF) en WebP-ondersteuning, wat de aanbeveling is; - **GD**, met de functies imagewebp() en imageavif() (PHP 8.1 of hoger). De pagina **Instellingen** van de plugin toont met bolletjes welke motoren en formaten daadwerkelijk op uw hosting beschikbaar zijn (Imagick, GD, WebP, AVIF). Op gedeelde hosting is AVIF niet altijd beschikbaar. Schakel de automatische terugval naar WebP in (zie verderop) om in elk geval een conversie te garanderen. ## Installatie 1. Upload de map `df-webp-avif-pro` naar `/wp-content/plugins/` (of installeer de ZIP via Plugins en daarna Nieuwe plugin). 2. Activeer de plugin via het menu **Plugins**. 3. Ga naar **WebP AVIF Pro en daarna Instellingen** om het formaat, de leveringsmodus, de hernoeming en de AI in te stellen. 4. Start een analyse (simulatie) en daarna de optimalisatie via de pagina **Optimalisatie**. ## Uitvoerformaat en compressie Kies **WebP** (maximale compatibiliteit) of **AVIF** (betere compressie). De belangrijkste opties: - **Automatische terugval naar WebP**: is AVIF gevraagd maar niet beschikbaar, dan maakt de plugin WebP in plaats van te mislukken. - **Kwaliteit**: van 1 tot 100, aanbevolen tussen 78 en 85. - **Verkleinen**: begrenst de langste zijde tot een waarde in pixels (0 schakelt dit uit). Alleen in de modus "vervangen". - **EXIF en ICC verwijderen**: haalt de metagegevens weg om de bestanden lichter te maken. - **Geanimeerde GIF's overslaan**: voorkomt dat animaties kapotgaan. ## Leveringsmodi WebP AVIF Pro biedt twee strategieën, die u naargelang uw situatie kiest. ### Vervangen Het oorspronkelijke bestand wordt omgezet, eventueel hernoemd, en alle verwijzingen (inhoud van berichten, metagegevens) worden naar het nieuwe bestand herschreven. De originelen worden bewaard zodat u kunt herstellen. Maak een back-up van uw database en uw bestanden vóór een eerste grootschalige verwerking. Controleer of de optie om de originelen te bewaren actief is, zodat u kunt terugkeren. ### Origineel behouden (niet-destructief) Er wordt een next-gen-bestand _naast_ het origineel gegenereerd (bijvoorbeeld foto.jpg en foto.jpg.webp). Bij de weergave serveert de plugin de next-gen-versie alleen aan browsers die die aanvaarden, op basis van de Accept-header; de andere krijgen het origineel. Er zijn geen htaccess-regels nodig. De modus "behouden" is het veiligst voor AVIF, voor media die elders staan (CDN of S3) en voor page builders, omdat het oorspronkelijke bestand en de database nooit worden gewijzigd. ## SEO-hernoeming Er zijn vier manieren om bestanden te hernoemen: geen, de productnaam (WooCommerce), een eigen sjabloon, of base64 (anonimisering). De modus **sjabloon** accepteert plaatsaanduidingen: - `{product}` `{title}` `{sku}` `{cat}` `{alt}` `{id}` `{date}` `{n}` Voorbeeld: `{product}-{cat}-{n}` levert een bestandsnaam op als `tapijt-op-maat-entree-a1b2c3.webp`. De hernoeming geldt niet in de modus "origineel behouden". ## ALT-tekst met AI WebP AVIF Pro genereert beschrijvende ALT-attributen met AI, in meerdere talen, op basis van het beeld en de productcontext. 1. Schakel de AI in bij de instellingen, kies een **provider** (Anthropic, OpenAI, Gemini of Mistral voor beeldanalyse, of DeepSeek op basis van de context alleen) en vul uw **API-sleutel** in. 2. Selecteer de gewenste **talen**. De eerst aangevinkte taal vult de hoofd-ALT; de overige worden gesynchroniseerd met de Polylang-vertalingen als die bestaan. 3. Genereer de ALT-teksten vanaf de pagina **ALT AI** (in bulk), automatisch bij het uploaden, of afbeelding per afbeelding via de actie "ALT genereren (AI)" in de mediabibliotheek. De plugin werkt zonder abonnement, maar elke AI-aanroep wordt door uw provider aangerekend op basis van uw API-sleutel. Het genereren in bulk verloopt in kleine pakketjes, om de ratelimieten te respecteren. ## SEO aan de voorkant - **Afmetingen tegen CLS**: voegt de attributen width en height toe aan afbeeldingen in de inhoud die ze missen, om verschuiving van de lay-out te beperken (Core Web Vitals). - **Schema ImageObject**: stuurt een JSON-LD-blok uit op pagina's en productpagina's (uitgelichte afbeelding en WooCommerce-galerij). ## Optimalisatie in bulk Via de pagina **Optimalisatie**: - **Analyseren (simulatie)**: schat de winst op een steekproef, zonder iets te wijzigen. - **De hele mediabibliotheek optimaliseren**: verwerkt de afbeeldingen in blokken, zonder de server te blokkeren. U kunt de pagina verlaten en later opnieuw starten; de verwerking gaat verder waar ze is gestopt. De statistiekkaarten tonen het aantal omgezette afbeeldingen, de bespaarde ruimte en een maandelijkse historiek. ## Achtergrondverwerking (WP-Cron) en WP-CLI Schakel bij grote mediabibliotheken de **achtergrondverwerking** in: de plugin optimaliseert dan elke 5 minuten een blok via WP-Cron, zonder dat u een tabblad open hoeft te houden. Bureaus kunnen de plugin ook via de opdrachtregel aansturen: ``` 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 ``` ## Back-up, opruiming en herstel In de modus "vervangen" worden de originelen gekopieerd naar `/wp-content/uploads/df-wap-backups/` (een beveiligde map). U kunt: - één afbeelding **herstellen** (via een actie in de mediabibliotheek) of de hele mediabibliotheek (knop "Alles herstellen"); - de back-ups **automatisch opruimen** na een ingesteld aantal dagen, om schijfruimte terug te winnen. In de modus "behouden" verwijdert het herstel gewoon de next-gen-bestanden, want de originelen zijn nooit gewijzigd. ## Diagnose De pagina Optimalisatie toont waarschuwingen die bij uw situatie passen: de aanwezigheid van een module die media elders opslaat (S3 of CDN), herkende page builders, AVIF gevraagd maar niet beschikbaar, of weinig schijfruimte. Volg die aanbevelingen op vóór een grootschalige verwerking. ## Probleemoplossing - **AVIF niet beschikbaar**: schakel de WebP-terugval in, of zet het uitvoerformaat op WebP. De pagina Instellingen toont welke motoren beschikbaar zijn. - **Afbeeldingen worden niet vervangen in een page builder**: sommige URL's die builders opslaan, ontsnappen aan het herschrijven. Kies dan liever de modus "origineel behouden". - **Er worden geen ALT-teksten gegenereerd**: controleer of de AI is ingeschakeld, of de API-sleutel geldig is en of er nog tegoed bij de provider is. - **De bulkverwerking lijkt traag**: verlaag het aantal afbeeldingen per blok (AVIF is zwaar), of gebruik de achtergrondverwerking of WP-CLI. De plugin werkt met WordPress 6.5+, WooCommerce (HPOS), Polylang, multisite en PHP 8.1 tot 8.3.