Converter for Media – Convert WebP and AVIF & Optimize Images | Ease image optimization

FAQ

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

Bitte füge immer dein Thema hinzu, lies zuerst alle anderen Fragen in den FAQ des Plugins und die anderen Themen 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 einen Fehler auf der Seite mit den Plugin-Einstellungen? Bitte lese dieses Thema, wenn du Fehler hast.

2. URL deiner Website.

3. Konfiguration deines Servers (Link dazu finden du auf der Einstellungsseite des Plugins im Abschnitt „Wir warten auf deine Nachricht“) – bitte mach ein Bildschirmfoto von der GESAMTEN Seite und sende diese uns.

4. Einstellungen des Plugins – bitte mache ein Bildschirmfoto der GESAMTEN Seite und sende dieses mir zu.

5. 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 für alle Fragen einzufügen, indem du ein Thema hinzufügst. Es ist viel einfacher und beschleunigt die Lösung deines Problems.

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 einen Fehler erhältst: “%s“ ist keine gültige Bilddatei. bedeutet, dass die Datei in irgendeiner Weise beschädigt ist. Lade die Datei auf die Festplatte herunter, speicher diese erneut mit einem beliebigen Grafikprogramm und füge sie der Seite erneut hinzu. Wenn der Fehler auf einzelne Bilder zutrifft, kannst du 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.

Im Falle der oben genannten Probleme ist die Kontaktaufnahme mit dem Support-Forum nutzlos. Leider können wir dir nicht helfen, wenn deine Dateien beschädigt sind. Du musst diese selbst reparieren. Wenn du zuvor andere Tools verwendet hast, die die Originaldateien geändert und beschädigt haben, wirst du nichts weiter tun können.

Denke daran, dass es vorkommt, dass andere Plugins Probleme mit dem Zugriff auf Dateien oder die REST-API verursachen können. Bitte versuche, alle anderen Plugins zu deaktivieren und das Standardthema festzulegen, um sicherzustellen, dass es nicht eines von ihnen ist, das diese Art von Problemen verursacht.

Was sind die Anforderungen an das Plugin?

Praktisch jedes Hosting erfüllt diese Anforderungen. Du musst mindestens PHP 7.0 verwenden und die GD– oder Imagick-Erweiterung installiert haben. Die Erweiterung muss das WebP-Format unterstützen. Wenn du einen Fehler hast, der besagt, dass die GD- oder Imagick-Bibliothek nicht installiert ist, du sie aber installiert hast, 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 korrekte Serverkonfiguration findest du hier. Den Link zu deiner aktuellen Konfiguration findest du im Administratorbereich auf der Plugin-Seite im Abschnitt „Wir warten auf deine Nachricht“ (oder über den URL-Pfad: / wp-admin/options-general.php?page=webpc_admin_page&action=server).

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.

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

Wie überprüfe ich, ob das Plugin funktioniert?

Weitere Informationen über die 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;
} );

Pfad zum /uploads Verzeichnis (relativ zum Stammverzeichnis)::

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    if ( $directory !== 'uploads' ) {
        return $path;
    }
    return 'wp-content/uploads';
}, 10, 2 );

Verzeichnispfad mit konvertierten WebP-Dateien (relativ zum Stammverzeichnis)::

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    if ( $directory !== 'webp' ) {
        return $path;
    }
    return 'wp-content/uploads-webpc';
}, 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/webp'; // your valid path to root
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    if ( $directory !== 'uploads' ) {
        return $path;
    }
    return 'app/uploads';
}, 10, 2 );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    if ( $directory !== 'webp' ) {
        return $path;
    }
    return 'app/uploads-webpc';
}, 10, 2 );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

Nach dem Setzen der Filter gehst du zu Einstellungen -> WebP Converter in das Admin-Panel und klicke auf die Änderungen speichern Schaltfläche. Dateien mit .htaccess entsprechenden Regeln sollten in den Verzeichnissen und erstellt /uploads /uploads-webpc 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 ( ! $status || in_array( $directory_name, $excluded_directories ) ) {
        return false;
    }

    return $status;
}, 10, 3 );

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

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_files = [ 'my-image.jpg' ];
    if ( ! $status || in_array( $file_name, $excluded_files ) ) {
        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.

Wie führe ich die manuelle Konvertierung durch?

Standardmäßig werden alle Bilder konvertiert, wenn du auf die Alle regenerieren Schaltfläche 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 );

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 );

Argument $paths ist ein Array von absoluten Serverpfaden und $skip_exists bedeutet, ob konvertierte Bilder übersprungen werden sollen.

Du kannst auch die Liste der Bildpfade für einen Anhang ändern, z. um eine Bildgröße auszuschließen. Verwende dazu den folgenden Filter:

add_filter( 'webpc_attachment_paths', function( $paths, $attachment_id ) {
    return $paths;
}, 10, 2 );

Argument $paths ist ein Array absoluter Serverpfade und die $attachment_id Beitrags-ID der Anlage, die der Medienbibliothek hinzugefügt wurde.

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 webp-converter calculate

Konvertieren aller Bilder:

wp webp-converter regenerate

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

wp webp-converter 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.

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.

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)::

# BEGIN WebP 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;
    add_header Cache-Control "private" always;
    expires 365d;
    try_files
        /wp-content/uploads-webpc/$path.$ext$ext_avif
        /wp-content/uploads-webpc/$path.$ext$ext_webp
        $uri =404;
}
# END WebP Converter for Media

Bearbeite dann 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;

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

systemctl restart nginx