WebP AVIF Pro — Komplettanleitung

WebP AVIF Pro konvertiert und komprimiert die Bilder deiner Mediathek zu WebP oder AVIF, lokal, ohne Abo und ohne Kontingent. Diese Anleitung behandelt die Installation, die zwei Auslieferungsmodi, die KI-ALT-Text-Erzeugung, das Bild-SEO, die Stapelverarbeitung, den WP-Cron-Hintergrund und WP-CLI sowie Backup und Fehlerbehebung.

Serveranforderungen

Das Plugin funktioniert mit einer der beiden Bild-Engines von PHP:

• Imagick kompiliert mit libheif (AVIF) und WebP-Unterstützung — empfohlen;
• GD mit den Funktionen imagewebp() und imageavif() (PHP 8.1 oder höher).

Die Einstellungen-Seite des Plugins zeigt Plaketten mit den auf deinem Hosting tatsächlich verfügbaren Engines und Formaten (Imagick, GD, WebP, AVIF).

Installation

1. Lade den Ordner df-webp-avif-pro nach /wp-content/plugins/ hoch (oder installiere das ZIP über Plugins und dann Installieren).
2. Aktiviere das Plugin über das Menü Plugins.
3. Gehe zu WebP AVIF Pro und dann Einstellungen, um Format, Auslieferungsmodus, Umbenennung und KI zu konfigurieren.
4. Starte eine Analyse (Simulation) und dann die Optimierung über die Seite Optimierung.

Ausgabeformat und Komprimierung

Wähle WebP (maximale Kompatibilität) oder AVIF (bessere Komprimierung). Hauptoptionen:

• Automatischer WebP-Fallback: Wird AVIF angefordert, ist aber nicht verfügbar, erzeugt das Plugin WebP statt zu scheitern.
• Qualität: von 1 bis 100, empfohlen zwischen 78 und 85.
• Größenanpassung: begrenzt die längste Kante auf einen Pixelwert (0 = aus). Nur im Ersetzen-Modus.
• EXIF/ICC-Entfernung: entfernt Metadaten, um Dateien leichter zu machen.
• Animierte GIFs überspringen: vermeidet das Zerstören von Animationen.

Auslieferungsmodi

WebP AVIF Pro bietet zwei Strategien, passend zu deinem Kontext.

Ersetzen

Die Originaldatei wird konvertiert, optional umbenannt, und alle Verweise (Beitragsinhalt, Metadaten) werden auf die neue Datei umgeschrieben. Originale werden gesichert, um eine Wiederherstellung zu ermöglichen.

Original behalten (nicht-destruktiv)

Eine Next-gen-Datei wird neben dem Original erzeugt (zum Beispiel photo.jpg und photo.jpg.webp). Bei der Ausgabe liefert das Plugin die Next-gen-Version nur an Browser aus, die sie akzeptieren, über den Accept-Header; die anderen erhalten das Original. Es ist keine htaccess-Regel erforderlich.

SEO-Umbenennung

Es gibt vier Modi zur Dateiumbenennung: keiner, Produktname (WooCommerce), benutzerdefinierte Vorlage oder Base64 (Anonymisierung). Der Vorlagen-Modus akzeptiert Token:

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

Beispiel: {product}-{cat}-{n} erzeugt einen Dateinamen wie massteppich-eingang-a1b2c3.webp. Die Umbenennung gilt nicht im Behalten-Modus.

KI-ALT-Text

WebP AVIF Pro erzeugt beschreibende ALT-Attribute per KI, in mehreren Sprachen, aus dem Bild und dem Produktkontext.

1. Aktiviere die KI in den Einstellungen, wähle einen Anbieter (Anthropic, OpenAI, Gemini, Mistral mit Bildanalyse oder DeepSeek nur per Kontext) und gib deinen API-Schlüssel ein.
2. Wähle die gewünschten Sprachen. Die erste markierte Sprache füllt den Haupt-ALT; die anderen werden mit den Polylang-Übersetzungen synchronisiert, sofern vorhanden.
3. Erzeuge die ALT-Texte über die Seite ALT KI (im Stapel), automatisch beim Hochladen oder Bild für Bild über die Mediathek-Aktion „ALT erzeugen (KI)“.

Front-end-SEO

• Anti-CLS-Dimensionen: fügt Inhaltsbildern, denen sie fehlen, die Attribute width und height hinzu, um Layout-Verschiebungen (Core Web Vitals) zu reduzieren.
• ImageObject-Schema: gibt einen JSON-LD-Block auf Seiten und Produktansichten aus (Beitragsbild und WooCommerce-Galerie).

Stapeloptimierung

Über die Seite Optimierung:

• Analysieren (Simulation): schätzt die Einsparung an einer Stichprobe, ohne etwas zu verändern.
• Gesamte Mediathek optimieren: verarbeitet die Bilder in Stapeln, ohne den Server zu blockieren. Du kannst die Seite verlassen und später fortsetzen; die Verarbeitung wird mit den verbleibenden Bildern fortgesetzt.

Die Statistikkarten zeigen die Anzahl der konvertierten Bilder, den eingesparten Speicher und einen monatlichen Verlauf.

Hintergrund (WP-Cron) und WP-CLI

Aktiviere für große Mediatheken die Hintergrundverarbeitung: Das Plugin optimiert alle 5 Minuten einen Stapel per WP-Cron, ohne einen Tab offen zu halten. Agenturen können das Plugin auch über die Befehlszeile steuern:

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

Backup, Bereinigung und Wiederherstellung

Im Ersetzen-Modus werden Originale nach /wp-content/uploads/df-wap-backups/ kopiert (geschützter Ordner). Du kannst:

• Ein einzelnes Bild wiederherstellen (Mediathek-Aktion) oder die gesamte Mediathek (Schaltfläche „Alle wiederherstellen“).
• Backups nach einer festgelegten Anzahl von Tagen automatisch bereinigen, um Speicherplatz zurückzugewinnen.

Im Behalten-Modus löscht die Wiederherstellung lediglich die Next-gen-Dateien, da die Originale nie verändert wurden.

Diagnose

Die Seite Optimierung zeigt kontextbezogene Warnungen: Vorhandensein eines Medien-Offload-Plugins (S3/CDN), erkannte Page-Builder, AVIF angefordert aber nicht verfügbar, oder wenig Speicherplatz. Befolge diese Empfehlungen vor einem großen Durchlauf.

Fehlerbehebung

• AVIF nicht verfügbar: Aktiviere den WebP-Fallback oder stelle das Ausgabeformat auf WebP. Die Einstellungen-Seite zeigt die verfügbaren Engines.
• Bilder werden in einem Page-Builder nicht ersetzt: Einige von Buildern gespeicherte URLs entgehen dem Umschreiben. Bevorzuge den Behalten-Modus.
• ALT nicht erzeugt: Prüfe, ob die KI aktiviert ist, der API-Schlüssel gültig ist und beim Anbieter Guthaben verbleibt.
• Die Stapelverarbeitung wirkt langsam: Senke die Anzahl der Bilder pro Stapel (AVIF ist rechenintensiv) oder nutze den Hintergrund / WP-CLI.