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, 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).

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.

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.

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.

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.