Converter for Media – Bilder optimieren | Konvertieren Sie WebP & AVIF

FAQ

Wie erhalte ich technischen Support? (bevor Sie um Hilfe bitten)

Bevor Sie einen neuen Thread hinzufügen, lesen Sie 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 Sie ein Thema hinzufügen, führen Sie die folgenden Schritte aus und antworten Sie auf jeden von ihnen:

1. Haben Sie Fehler auf der Seite mit den Plugin-Einstellungen? Bitte lesen Sie diesen Thread, wenn Sie Fehler haben.

2. URL Ihrer Website.

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

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

Bitte denken Sie daran, die Antworten auf alle Fragen in einem eigenen Thread zusammenzufassen. Das ist viel einfacher und beschleunigt die Lösung Ihres 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.

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

Schritt 1

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

und fügen Sie diesen Code hinzu (fügen Sie 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). Beachten Sie, wo die mit einem roten Rahmen markierten Regeln platziert sind.

Schritt 2

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

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

image/webp webp;
image/avif avif;

Schritt 3

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

systemctl restart nginx

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

Schritt 4

Sehen Sie auch die Frage «Konfiguration für Nginx Proxy» in den FAQ unten.

Konfiguration für Nginx Proxy

Wenn Sie auf der Seite mit den Plugin-Einstellungen den Serverkonfigurationsfehler mit einem Fehlercode sehen: 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, suchen Sie 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 suchen Sie 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 Sie solche Regeln finden, entfernen Sie die folgenden Formate aus ihnen:
– jpg und jpeg oder jpe?g
– png
– gif
– webp

Nachdem Sie Änderungen vorgenommen haben, denken Sie daran, den Dienst neu zu starten:

systemctl restart nginx

Fehler auf dem Plugin-Einstellungs Seite?

Wenn Sie einen Fehler auf dem Plugin-Einstellungsbildschirm haben, lesen Sie ihn bitte zunächst sorgfältig durch. Sie werden angezeigt, wenn ein Problem mit der Konfiguration Ihres Servers oder Ihrer Website vorliegt.

Die Nachrichten sind so konzipiert, dass die Anzahl der wiederholten Supportanfragen reduziert wird. Das spart Ihnen und uns Zeit. Bitte lesen Sie diesen Thread für weitere Informationen.

Fehler beim Konvertieren?

Sie können beim Konvertieren verschiedene Arten von Fehlern erhalten. Lesen Sie zunächst ihren Inhalt sorgfältig durch. In den meisten Fällen können Sie dieses Problem selbst lösen. Versuchen Sie dies oder wenden Sie sich an den Serveradministrator.

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

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

Wenn Sie einen Fehler erhalten: “%s“ ist keine gültige Bilddatei. bedeutet, dass die Datei in irgendeiner Weise beschädigt ist. Laden Sie die Datei auf die Festplatte herunter, speichern Sie sie erneut mit einem beliebigen Grafikprogramm und fügen Sie sie der Seite erneut hinzu. Wenn der Fehler auf einzelne Bilder zutrifft, können Sie ihn ignorieren – nur die Originalbilder werden 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. Sie müssen mindestens PHP 7.0 verwenden und die GD Imagick oder-Erweiterung installiert haben. Die Erweiterung muss WebP format unterstützen. Wenn Sie einen Fehler haben, der besagt, dass die GD- oder Imagick-Bibliothek nicht installiert ist, Aber Sie haben sie 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 finden Sie hier. Den Link zu Ihrer aktuellen Konfiguration finden Sie auf der Registerkarte Help Center auf dem Bildschirm mit den Plugin-Einstellungen.

Beachten Sie die rot markierten Elemente. Wenn die rot markierten Werte in Ihrem Fall nicht erscheinen, bedeutet dies, dass Ihr Server die technischen Anforderungen nicht erfüllt. Achten Sie 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 Ihr Server die technischen Anforderungen nicht erfüllt, wenden Sie sich bitte an Ihren Serveradministrator. Wir sind nicht in der Lage, Ihnen zu helfen. Bitte kontaktieren Sie uns nicht in dieser Angelegenheit, da dies ein Serverkonfigurationsproblem ist, kein Plugin.

Auch die REST-API muss aktiviert sein und ohne zusätzliche Einschränkungen funktionieren. Wenn Sie damit ein Problem haben, wenden Sie sich bitte an den Entwickler, der Ihre 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 finden Sie 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, überspringen Sie 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 );

Beachten Sie, 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
    ...

Verwenden Sie 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 Sie die Filter eingestellt haben, gehen Sie zu Settings -> Converter for Media im Admin-Bereich und klicken Sie 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 Sie 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, verwenden Sie 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 keine konvertierten Bilder mehr. Sie müssen 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 Sie Unterstützung für ein benutzerdefiniertes Verzeichnis hinzufügen möchten, fügen Sie der Datei functions.php in Ihrem Theme-Verzeichnis den folgenden Code hinzu (verwenden Sie einen korrekten Verzeichnisnamen anstelle von custom-directory):

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

Denken Sie 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 Sie auf die Massenoptimierung starten Schaltfläche klicken. Darüber hinaus erfolgt die Konvertierung automatisch, wenn Sie Ihrer Medienbibliothek neue Dateien hinzufügen.

Denken Sie 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 Sie mit Ihrem Plugin, das Bilder selbst generiert, integrieren möchten, können Sie 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 Sie ein anderes Plugin integrieren möchten, wenden Sie sich am besten an den Autor dieses Plugins und geben Sie ihm Informationen über die in unserem Plugin verfügbaren Aktionen. Dies wird Ihnen 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. Denken Sie daran, diese Aktion auszuführen, nachdem Sie alle Bildgrößen registriert haben (d. H. Nachdem Sie die add_image_size Funktion ausgeführt haben):

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

Um manuell konvertierte Dateien zu löschen, verwenden Sie die folgende Aktion, wobei Sie als Argument ein Array mit absoluten Serverpfaden zu den Dateien angeben (dies löscht manuell konvertierte Dateien):

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 Ihre 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 (lesen Sie vor der Verwendung die Anweisungen)