Converter for Media – Bilder optimieren | Konvertiere WebP & AVIF

FAQ

Wie erhalte ich technischen Support? (bevor du um Hilfe bittest)

Bevor du einen neuen Thread hinzufügst, lese zuerst alle anderen Fragen in dieser FAQ und anderen Threads im Support-Forum . Vielleicht hatte jemand ein ähnliches Problem und es wurde gelöst.

Wenn du ein Thema hinzufügst, führe die folgenden Schritte aus und antworte auf jeden von ihnen:

1. Hast du Fehler auf der Seite mit den Plugin-Einstellungen? Bitte lese diesen Thread, wenn du Fehler hast.

2. URL deiner Website.

3 . Screenshot der Registerkarte Hilfe Center auf dem Bildschirm mit den Plugin-Einstellungen – bitte mache einen Screenshot der GESAMTEN Seite.

4. Bitte führe den Test durch, der in der fraglichen FAQ beschrieben wird „Wie kann ich überprüfen, ob das Plugin funktioniert?“. Bitte sende ein Bildschirmfoto von Devtools mit den Testergebnissen.

Bitte denke daran, die Antworten auf alle Fragen in einem eigenen Thread zusammenzufassen. Das ist viel einfacher und beschleunigt die Lösung deines Problems.

Konfiguration für Nginx

Für Nginx-Server, die .htaccess-Regeln nicht unterstützen, ist eine zusätzliche Nginx-Serverkonfiguration erforderlich, damit das Plugin ordnungsgemäß funktioniert.

Befolge die folgenden 4 Schritte (bitte alle ausführen)::

Schritt 1

Finde dann die Konfigurationsdatei in einem der Pfade (denke daran, die von deinem vhost verwendete Konfigurationsdatei auszuwählen)::
– /etc/nginx/sites-available/ oder /etc/nginx/sites-enabled/
– /etc/nginx/conf.d/

und füge diesen Code hinzu (füge diese Zeilen am Anfang des server { ... }-Blocks hinzu) – denken Sie daran, diese Regeln vor jedem anderen hinzuzufügen {}Standortregeln:

# BEGIN Converter for Media
set $ext_avif ".avif";
if ($http_accept !~* "image/avif") {
    set $ext_avif "";
}

set $ext_webp ".webp";
if ($http_accept !~* "image/webp") {
    set $ext_webp "";
}

location ~ /wp-content/(?<path>.+)\.(?<ext>jpe?g|png|gif|webp)$ {
    add_header Vary Accept;
    expires 365d;
    try_files
        /wp-content/uploads-webpc/$path.$ext$ext_avif
        /wp-content/uploads-webpc/$path.$ext$ext_webp
        $uri =404;
}
# END Converter for Media

Hier ist ein Beispiel dafür, wie eine korrekt hinzugefügte Nginx-Konfiguration aussieht (dies ist eine Beispiel-Nginx-Konfiguration, aber in den meisten Fällen sieht sie ähnlich aus). Beachte, wo die mit einem roten Rahmen markierten Regeln platziert sind.

Schritt 2

Füge dann Unterstützung für die erforderlichen MIME-Typen hinzu, falls diese nicht unterstützt werden. Bearbeite die Konfigurationsdatei:↵
– /etc/nginx/mime.types

und füge diesen Code hinzu (füge diese Zeilen innerhalb des types { ... } Blocks hinzu)::

image/webp webp;
image/avif avif;

Schritt 3

Vergesse nicht, das Gerät nach den Änderungen neu zu starten:

systemctl restart nginx

Bei Problemen kontaktiere uns bitte im Support-Forum. Wir werden versuchen zu helfen.

Schritt 4

Siehe auch die Frage „Konfiguration für Nginx Proxy“ in den FAQ unten.

Konfiguration für Nginx Proxy

Wenn du auf der Seite mit den Plugin-Einstellungen den Serverkonfigurationsfehler mit einem Fehlercode siehst: bypassing_apache, rewrites_not_executed oder rewrites_cached, liegt ein Problem mit Nginx vor Reverse-Proxy für statische Dateien oder Nginx-Caching für statische Dateien.

Um dieses Problem zu lösen, suche nach Regeln dieses Typs in einer der wichtigsten Nginx-Konfigurationsdateien für die Domäne (die Liste der Erweiterungen in der Standortbedingung kann variieren, also suche nach Ähnlichkeiten):

location ~* ^.+\.(css|js|jpg|jpeg|png|gif|webp|ico|eot|otf|woff|woff2|ttf)$ {
    expires max;
...

oder

location ~* ^.+\.(css|js|jpe?g|png|gif|webp|ico|eot|otf|woff|woff2|ttf)$ {
    expires 1M;
    try_files $uri @proxy;
...

Wenn du solche Regeln findesz, entferne die folgenden Formate aus ihnen:
– jpg und jpeg oder jpe?g
– png
– gif
– webp

Nachdem du Änderungen vorgenommen habst, denke daran, den Dienst neu zu starten:

systemctl restart nginx

Fehler auf dem Plugin-Einstellungs Seite?

Wenn du einen Fehler auf der Plugin-Einstellungsseite hast, lies diesen bitte zunächst sorgfältig durch. Dieser wird angezeigt, wenn ein Problem mit der Konfiguration deines Servers oder deiner Website vorliegt.

Die Nachrichten sollen die Anzahl der wiederholten Supportanfragen reduzieren. Es spart deine und unsere Zeit. Bitte lese dieses Thema für weitere Informationen.

Fehler beim Konvertieren?

Du kannst beim Konvertieren verschiedene Arten von Fehlern erhalten. Lies zunächst ihren Inhalt sorgfältig durch. In den meisten Fällen kannst du dieses Problem selbst lösen. Versuche dies oder wenden dich an den Serveradministrator.

Wenn du einen Fehler erhalten: Die Datei “%s“ existiert nicht. Bitte überprüfe den Pfad. bedeutet, dass die funktion file_exists() in PHP false mit dem in der Fehlermeldung angegebenen Dateipfad zurückgegeben wird. Überprüfe diesen Pfad und stelle sicher, dass er korrekt ist.

Wenn du einen Fehler erhältst: Die Datei “%s“ ist nicht lesbar. Bitte prüfe die Dateiberechtigungen. bedeutet, dass die funktion is_readable() in PHP false mit dem in der Fehlermeldung angegebenen Dateipfad zurückgegeben wird. Überprüfe die Berechtigungen für die Datei und das Verzeichnis, in dem sich die Datei befindet.

Wenn du eine Fehlermeldung erhältst: „%s“ ist keine gültige Bilddatei. bedeutet, dass die Datei auf irgendeine Weise beschädigt ist. Lade die Datei auf die Festplatte herunter, speichere sie erneut mit einem beliebigen Grafikprogramm und füge sie erneut der Seite hinzu. Wenn der Fehler auf einzelne Bilder zutrifft, kannst du ihn ignorieren – es werden nur die Originalbilder geladen, nicht WebP.

Wenn Sie eine Fehlermeldung erhälst: Das in .webp konvertierte Bild „%s“ ist größer als das Original und die konvertierte .webp-Datei wurde gelöscht. bedeutet, dass das Originalbild weniger wog als WebP. Dies passiert, wenn Bilder zuvor komprimiert wurden. Deaktiviere die Option „Automatisches Entfernen von Dateien in Ausgabeformaten, die größer als das Original sind“ in den Plugin-Einstellungen, um immer die Verwendung von WebP zu erzwingen.

Was sind die Anforderungen an das Plugin?

Praktisch jedes Hosting erfüllt diese Anforderungen. Du musst MINDESTENS PHP 7.0 verwenden und die GD Imagick oder-Erweiterung installiert haben. Die Erweiterung muss WebP format unterstützen. Wenn du einen Fehler hast, der besagt, dass die GD- oder Imagick-Bibliothek nicht installiert ist, aber du hast diese installiert, dann sind sie wahrscheinlich falsch konfiguriert und haben keine WebP-Unterstützung.

Sie sind benötigte native PHP-Erweiterungen, die unter anderem von WordPress verwendet werden, um Miniaturansichten zu generieren. Auf dem Server müssen auch die Module mod_mime mod_rewrite und aktiviert mod_expires sein.

Ein Beispiel für die richtige Serverkonfiguration findest du hier. Den Link zu deiner aktuellen Konfiguration findest du auf der Registerkarte Hilfe Center auf dem Bildschirm mit den Plugin-Einstellungen.

Beachte die rot markierten Elemente. Wenn die rot markierten Werte in deinem Fall erscheinen, bedeutet dies, dass dein Server die technischen Anforderungen nicht erfüllt. Achte auf den WebP-Unterstützungswert für die GD-Bibliothek und WEBP in der Liste der unterstützten Erweiterungen für die Imagick-Bibliothek.

In einer Situation, in der dein Server die technischen Anforderungen nicht erfüllt, wende dich bitte an deinen Serveradministrator. Wir sind nicht in der Lage, dir zu helfen. Bitte kontaktiere uns nicht in dieser Angelegenheit, da dies ein Serverkonfigurationsproblem ist, kein Plugin Fehler.

Außerdem muss die REST-API aktiviert sein und ohne zusätzliche Einschränkungen funktionieren. Wenn du damit ein Problem hast, wende dich bitte an den Entwickler, der deine Website erstellt hat. Er sollte das Problem mit der nicht funktionierenden REST-API leicht finden.

Wie überprüfe ich ob das Plugin funktioniert?

Weitere Informationen zur Funktionsweise des Plugins findest du in unserem Handbuch.

Wie ändere ich den Pfad zu Uploads?

Dies ist mit den folgenden Filtertypen möglich, um Standardpfade zu ändern. Es ist eine Lösung für fortgeschrittene Benutzer. Wenn dies nicht der Fall ist, überspringe bitte diese Frage.

Pfad zum Root-Installationsverzeichnis von WordPress ABSPATH (standardmäßig)::

add_filter( 'webpc_site_root', function( $path ) {
    return ABSPATH;
} );

Pfade zu Verzeichnissen (relativ zum Stammverzeichnis):

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'wp-content/uploads';
        case 'webp':
            return 'wp-content/uploads-webpc';
        case 'plugins':
            return 'wp-content/plugins';
        case 'themes':
            return 'wp-content/themes';
    }
    return $path;
}, 10, 2 );

Beachte, dass sich das /uploads-webpc Verzeichnis auf derselben Verschachtelungsebene wie /uploads die und /plugins /themes Verzeichnisse befinden muss.

Präfix in der URL des /wp-content/ Verzeichnisses oder eines gleichwertigen Verzeichnisses (wird in .htaccess verwendet)::

add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

Für die folgende benutzerdefinierte WordPress-Beispielstruktur:

...
├── web
    ...
    ├── app
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── uploads
    ├── wp-config.php
    ...

Verwende die folgenden Filter:

add_filter( 'webpc_site_root', function( $path ) {
    return 'C:/WAMP/www/project/web'; // your valid path to root
} );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'app/uploads';
        case 'webp':
            return 'app/uploads-webpc';
        case 'plugins':
            return 'app/plugins';
        case 'themes':
            return 'app/themes';
    }
    return $path;
}, 10, 2 );

Nachdem du die Filter eingestellt hast, geht du zu Settings -> Converter for Media im Admin-Bereich und klickst auf die Schaltfläche Änderungen speichern. .htaccess-Dateien mit entsprechenden Regeln sollten in den Verzeichnissen /uploads und /uploads-webpc erstellt werden.

Wie kann man Pfade von der Konvertierung ausschließen?

Um ausgewählte Verzeichnisse auszuschließen, verwende den folgenden Filter:

add_filter( 'webpc_supported_source_directory', function( bool $status, string $directory_name, string $server_path ): bool {
    $excluded_directories = [ 'my-directory' ];
    if ( in_array( $directory_name, $excluded_directories ) ) {
        return false;
    }
    return $status;
}, 10, 3 );

Um ausgewählte Dateien auszuschließen, verwende den folgenden Filter (in diesem Fall mit dem Suffix „-skipwebp“ in einem Dateinamen, z.B. image-skipwebp.png)):

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipwebp';
    if ( strpos( $file_name, $excluded_suffix . '.' ) !== false ) {
        return false;
    }
    return $status;
}, 10, 3 );

Das Argument $server_path ist der absolute Serverpfad zu einem Verzeichnis oder einer Datei. Innerhalb der Filter kannst du bei Bedarf kompliziertere Regeln anwenden.

Filter werden ausgeführt, bevor Bilder konvertiert werden – sie unterstützen konvertierte Bilder nicht mehr. Du musst sie manuell löschen, wenn sie nicht konvertiert werden sollen.

Unterstützung für benutzerdefinierte Verzeichnisse

Das Plugin unterstützt standardmäßig die folgenden Verzeichnisse:
– /gallery
– /plugins
– /themes
– /uploads

Wenn du Unterstützung für ein benutzerdefiniertes Verzeichnis hinzufügen möchtest, füge der Datei functions.php in Ihrem Theme-Verzeichnis den folgenden Code hinzu (verwende einen korrekten Verzeichnisnamen anstelle von custom-directory):

add_filter( 'webpc_source_directories', function ( $directories ) {
    $directories[] = 'custom-directory';
    return $directories;
} );

Denke daran, dass sich dieses Verzeichnis im /wp-content Verzeichnis befinden muss.

Wie führe ich die manuelle Konvertierung durch?

Standardmäßig werden alle Bilder konvertiert, wenn du auf die Schaltfläche Massenoptimierung starten klickst. Darüber hinaus erfolgt die Konvertierung automatisch, wenn du deiner Medienbibliothek neue Dateien hinzufügen.

Denke daran, dass unser Plugin Bilder berücksichtigt, die von WordPress generiert wurden. Es gibt viele Plugins, die beispielsweise Bilder einer anderen Größe oder in einer anderen Version generieren.

Wenn du ein Plugin, das Bilder selbst generiert, integrieren möchtest, kannst du dies tun. Unser Plugin bietet die Möglichkeit dieser Art der Integration. Dies funktioniert für alle Bilder im /wp-content Verzeichnis.

Es ist eine Lösung für fortgeschrittene Benutzer. Wenn du ein anderes Plugin integrieren möchtest, wenden dich am besten an den Autor dieses Plugins und gebe ihm Informationen über die in unserem Plugin verfügbaren Aktionen. Dies wird dir
helfen, schneller eine Lösung zu finden.

Du kannst die Konvertierung ausgewählter Dateien manuell durchführen, du kannst die Aktion verwenden, der du ein Array mit einer Liste von Pfaden (es müssen absolute Serverpfade sein) übergibst:

do_action( 'webpc_convert_paths', $paths, true );

Eine alternative Methode besteht darin, die Konvertierung des ausgewählten Anhangs manuell zu starten, indem die Beitrags-ID aus der Medienbibliothek übergeben wird. Denke daran, diese Aktion auszuführen, nachdem du alle Bildgrößen registriert hast (d. H. Nachdem du die add_image_size Funktion ausgeführt hast)::

do_action( 'webpc_convert_attachment', $post_id, true );

Um manuell konvertierte Dateien zu löschen, verwende die folgende Aktion, indem du als Argument die Anordnung von absoluten Serverpfaden zu den Dateien angibst(dadurch werden manuell konvertierte Dateien gelöscht)::

do_action( 'webpc_delete_paths', $paths );

Support für WP-CLI

Das Plugin unterstützt WP-CLI, was eine schnellere Bildkonvertierung von der Serverebene aus ermöglicht. Weitere Informationen zu den ersten Schritten mit WP-CLI finden Sie im Handbuch. Die unterstützten Befehle werden im Folgenden beschrieben.

Überprüfen, wie viele maximale Bilder für die Conversion auf der Website vorhanden sind:

wp converter-for-media calculate

Konvertieren aller Bilder:

wp converter-for-media regenerate

Konvertieren aller Bilder (mit der Option „Alle Bilder erneut konvertieren erzwingen“):

wp converter-for-media regenerate --force

Unterstützt das Plugin CDN?

Die Website-Dateien (WordPress-Dateien) und die Bilder aus der Mediathek müssen sich auf demselben Server befinden. Wenn ja, sollte alles gut funktionieren.

Wenn sich deine Bilder nur auf einem anderen CDN-Server befinden, ist ein korrekter Betrieb leider unmöglich, da solche Bilder von einem anderen Server verwaltet werden.

Aktuelle Liste der unterstützten CDN-Server:
– BunnyCDN (lese vor der Verwendung die Anweisungen)