Skip to content

FG Image WP

FG Image WP ist ein WordPress-Plugin von FUNCKGROUP zur serverseitigen Erzeugung und Auslieferung moderner Bildformate. Es kann registrierte WordPress-Bildgrößen als WebP und AVIF erzeugen und im Frontend über <picture> und srcset ausliefern, während das ursprüngliche <img> als Fallback erhalten bleibt.

WordPress speichert hochgeladene Bilder typischerweise im Originalformat und erzeugt daraus mehrere Bildgrößen. FG Image ergänzt diese vorhandenen Größen um moderne Varianten, ohne die Originaldateien zu ersetzen.

Die Konvertierung findet im Upload-/Medienprozess, bei manueller Verarbeitung oder in der Mediathek-Stapelverarbeitung statt. Normale Frontend-Aufrufe erzeugen keine Bilddateien.

  • Erzeugung von WebP- und AVIF-Varianten für unterstützte WordPress-Bildgrößen.
  • Lokale Konvertierung über WordPress Image Editor mit tatsächlich getesteter Imagick- oder GD-Unterstützung.
  • Optionaler Remote-Encoder als Fallback, wenn ein lokaler Encoder fehlt oder eine lokale Konvertierung mit einem Laufzeitfehler endet.
  • Ausgabe über <picture> mit der Reihenfolge AVIF → WebP → Original.
  • Vollständigkeitsprüfung für srcset, damit ein moderner Source nur verwendet wird, wenn alle benötigten Kandidaten vorhanden sind.
  • Erweiterung bereits vorhandener <picture>-Elemente ohne Verschachtelung oder Duplizierung vorhandener AVIF-/WebP-Sources.
  • Mediathek-Werkzeuge für Einzelbilder, Stapelverarbeitung und Reparatur registrierter Varianten.
  • Nicht-destruktive Deaktivierung und Deinstallation hinsichtlich erzeugter Bildvarianten.
  • Technische Integrationspunkte für FG Performance, FG Static Export und Cache-Invalidierung.
  • Produktions- und Encoder-Diagnose im WordPress-Adminbereich.

FG Image WP eignet sich für WordPress-Installationen, die Bilddateien lokal oder über einen ausdrücklich konfigurierten Remote-Encoder in WebP und AVIF bereitstellen möchten. Das Plugin ist auf WordPress-Attachments und deren registrierte Bildgrößen ausgerichtet.

Bei der Generierung ermittelt FG Image die Originaldatei und die von WordPress registrierten Zwischengrößen. Für jede unterstützte Quelle werden die aktivierten Zielformate erzeugt. Eine Variante wird nur registriert, wenn sie kleiner als die Quelle ist und die konfigurierte Mindest-Ersparnis erreicht.

Die erzeugten Dateipfade werden im Attachment-Metafeld _fg_image_variants gespeichert. Im Frontend liest das Plugin ausschließlich diese registrierten Varianten und erzeugt daraus passende <source>-Elemente. Die Original-WordPress-Ausgabe bleibt als Fallback bestehen.

Voraussetzung Wert
WordPress mindestens 6.5
PHP mindestens 8.1
Upload-Verzeichnis muss für die Generierung beschreibbar sein
Lokale Konvertierung funktionierender Imagick- oder GD-Encoder für das jeweilige Zielformat
Alternative optional konfigurierbarer Remote-Encoder
Frontend-Markup WP_HTML_Tag_Processor muss verfügbar sein

Der mitgelieferte Composer-Autoloader befindet sich im Release. Ein Composer-Lauf ist auf dem Zielsystem nicht erforderlich, sofern das vollständige Plugin-Paket installiert wird.

FG Image WP 1.0.4
Öffentliche API-Linie: FG_IMAGE_API_VERSION = 1.0

Version 1.0.4 ergänzt insbesondere die Layout-Kompatibilität für von FG Image erzeugte <picture>-Wrapper innerhalb von Bootstrap-.ratio-Containern.