Converter for Media – Optimize images | Convert WebP & AVIF

FAQ

Hoe krijg je technische ondersteuning? (voordat je om hulp vraagt)

Voordat je een nieuwe thread toevoegt, lees eerst alle andere vragen in deze FAQ en andere threads in het ondersteuning forum. Misschien had iemand een soortgelijk probleem en is het opgelost.

Als je een draad toevoegt, volg dan deze stappen en beantwoord ze allemaal:

1. Heb je fouten op de plugin instellingen pagina? Lees deze thread als je fouten hebt.

2. URL van je website.

3. Schermafbeelding van de Help centrum tab op het plugin instellingen scherm – maak een schermafbeelding van de ENIGE pagina.

4. Doe de test, die beschreven staat in de FAQ bij de vraag “Hoe controleer ik of de plugin werkt?”. Stuur een schermafbeelding van Devgereedschappen met de testresultaten.

Vergeet niet de antwoorden op alle vragen op te nemen door een thread toe te voegen. Het is veel gemakkelijker en versnelt de oplossing van je probleem.

Configuratie voor Nginx

Voor Nginx servers die geen .htaccess regels ondersteunen, is extra Nginx server configuratie nodig om de plugin goed te laten functioneren.

Volg de 4 onderstaande stappen (doe ze allemaal) :

Stap 1

Zoek het configuratiebestand in een van de paden (vergeet niet het configuratiebestand te selecteren dat door je vhost wordt gebruikt):
– /etc/nginx/sites-available/ of /etc/nginx/sites-enabled/
– /etc/nginx/conf.d/

en voeg deze code toe (voeg deze regels toe aan het begin van het server { ... } blok) – vergeet niet deze regels toe te voegen vóór alle andere location {} regels:

# 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 is een voorbeeld van hoe een correct toegevoegde Nginx configuratie eruit ziet (dit is een voorbeeld van een Nginx configuratie, maar in de meeste gevallen ziet het er vergelijkbaar uit). Let op waar de regels met een rode kader geplaatst zijn.

Stap 2

Voeg dan ondersteuning toe voor de vereiste MIME typen, als die niet worden ondersteund. Bewerk het configuratiebestand:
– /etc/nginx/mime.types

en voeg deze code toe (voeg deze regels toe binnen het types { ... } blok):

image/webp webp;
image/avif avif;

Stap 3

Vergeet niet de machine opnieuw op te starten nadat je wijzigingen hebt aangebracht:

systemctl restart nginx

In geval van problemen kan je contact met ons opnemen in het ondersteuningsforum. We zullen proberen te helpen.

Stap 4

Zie ook de vraag “Configuratie voor Nginx proxy” in de FAQ hieronder.

Configuratie voor Nginx proxy

Als je op de plugin instellingen pagina de foutmelding ‘Server configuratie fout’ ziet met een foutcode: bypassing_apache, rewrites_not_executed of rewrites_cached, betekent dit een probleem met Nginx Reverse Proxy voor statische bestanden of Nginx Caching voor statische bestanden.

Om dit probleem op te lossen, zoek je naar regels van dit type in een van de belangrijkste Nginx configuratiebestanden voor het domein (de lijst van extensies in de locatievoorwaarde kan verschillen, dus zoek naar overeenkomsten):

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

of

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

Als je dergelijke regels vindt, verwijder dan de volgende formaten:
– jpg and jpeg of jpe?g
– png
– gif
– webp

Vergeet niet de dienst opnieuw te starten nadat je wijzigingen hebt aangebracht:

systemctl restart nginx

Fout in plugin instellingen scherm?

Als je een fout hebt op het scherm van de plugin instellingen, lees deze dan eerst aandachtig door. Ze worden weergegeven wanneer er een probleem is met de configuratie van je server of website.

De berichten zijn bedoeld om het aantal herhaalde aanvragen om ondersteuning te verminderen. Het bespaart je en onze tijd. Lees deze thread voor meer informatie.

Fout bij het converteren?

Je kunt verschillende soorten fouten krijgen bij het omzetten. Lees eerst zorgvuldig de inhoud ervan. Meestal kun je dit probleem zelf oplossen. Probeer dit te doen of neem contact op met de serverbeheerder.

Als je een foutmelding krijgt: Bestand "%s" bestaat niet. Controleer het bestandspad. betekent dat de file_exists() functie in PHP false teruggaf met het bestandspad in de foutmelding. Controleer dit pad en zorg ervoor dat het correct is.

Als je een foutmelding krijgt: Bestand "%s" is onleesbaar. Controleer de bestandspermissies. betekent dat de is_readable() functie in PHP false teruggaf met het bestandspad in de foutmelding. Controleer de rechten voor het bestand en de map waarin het bestand zich bevindt.

Als je een foutmelding krijgt: "%s" is geen geldig afbeeldingsbestand. betekent dit dat het bestand op een of andere manier beschadigd is. Download het bestand naar schijf, sla het opnieuw op met een willekeurig grafisch programma en voeg het opnieuw toe aan de pagina. Als de fout van toepassing is op individuele afbeeldingen dan kan je het negeren – alleen de originele afbeeldingen worden geladen, niet WebP.

Als je een foutmelding krijgt: Afbeelding "%s" geconverteerd naar .webp is groter dan origineel en geconverteerd .webp bestand is verwijderd. betekent dat de originele afbeelding minder woog dan WebP. Dit gebeurt wanneer afbeeldingen eerder zijn gecomprimeerd. Schakel de optie “Automatische verwijdering van bestanden in uitvoerformaten groter dan origineel” in de plugin instellingen uit om het gebruik van WebP te forceren.

Wat zijn de vereisten voor de plugin?

Vrijwel elke hosting voldoet aan deze eisen. Je moet minimaal PHP 7.0 gebruiken en de GD of Imagick extensie geïnstalleerd hebben. De extensie moet WebP format ondersteunen. Als je een foutmelding krijgt dat de GD of Imagick bibliotheek niet is geïnstalleerd, maar je hebt deze wel geïnstalleerd, dan zijn ze waarschijnlijk verkeerd geconfigureerd en hebben ze geen WebP ondersteuning.

Dit zijn vereiste native PHP extensies, die onder meer door WordPress worden gebruikt om thumbnails te genereren. Je server moet ook de modules mod_mime, mod_rewrite en mod_expires ingeschakeld hebben.

Een voorbeeld van de juiste serverconfiguratie vindt je hier. De link naar je huidige configuratie is te vinden in de Help centrum tab op het plugin instellingen scherm.

Let op de rood gemarkeerde items. Als de rood gemarkeerde waarden in je geval niet voorkomen, betekent dit dat je server niet voldoet aan de technische vereisten. Let op de waarde WebP ondersteuning voor de GD bibliotheek en WEBP in de lijst met ondersteunde extensies voor de Imagick bibliotheek.

In een situatie waarin je server niet aan de technische eisen voldoet, neem dan contact op met je serverbeheerder. Wij kunnen je niet helpen. Neem hierover geen contact met ons op, want dit is een probleem met de serverconfiguratie, niet met een plugin.

Ook moet de REST-API ingeschakeld zijn en zonder extra beperkingen werken. Als je daar een probleem mee hebt, neem dan contact op met de ontwikkelaar die je website heeft gemaakt. Hij zou het probleem met de niet werkende REST-API gemakkelijk moeten kunnen vinden.

Hoe kan je controleren of de plugin werkt?

Meer informatie over de werking van de plugin vind je in onze handleiding.

Hoe kan je het pad naar uploads wijzigen?

Dit is mogelijk met behulp van de volgende soorten filters om standaardpaden te wijzigen. Het is een oplossing voor gevorderde gebruikers. Als je dat niet bent, sla deze vraag dan over.

Pad naar de root installatie map van WordPress (standaardABSPATH):

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

Paden naar mappen (relatief ten opzichte van de hoofdmap):

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

Merk op dat de map /uploads-webpc op hetzelfde niveau moet staan als de mappen /uploads, /plugins en /themes.

Voorvoegsel in URL van /wp-content/ map of equivalent (gebruikt in .htaccess):

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

Voor het volgende voorbeeld van een aangepaste WordPress structuur:

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

Gebruik de volgende filters:

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

Ga na het instellen van de filters naar Instellingen -> Converter for Media in het beheerpaneel en klik op de knop Wijzigingen opslaan. In de mappen /uploads en /uploadswebpc moeten .htaccess bestanden met de juiste regels worden aangemaakt.

Hoe paden uitsluiten van conversie?

Gebruik het volgende filter om geselecteerde mappen uit te sluiten:

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

Om geselecteerde bestanden uit te sluiten gebruik je het volgende filter (in dit geval met het achtervoegsel “-skipwebp” in een bestandsnaam, bijvoorbeeld afbeelding-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 );

Argument $server_path is het absolute server pad naar een map of bestand. Binnen de filters, kun je meer gecompliceerde regels toepassen indien nodig.

Filters worden uitgevoerd voordat afbeeldingen worden geconverteerd – ze ondersteunen geen geconverteerde afbeeldingen meer. Je moet ze handmatig verwijderen als ze niet geconverteerd moeten worden.

Ondersteuning voor aangepaste mappen

De plugin ondersteunt standaard de volgende mappen:
– /gallery
– /plugins
– /themes
– /uploads

Als je ondersteuning wil toevoegen voor een aangepaste map, voeg dan de volgende code toe aan het bestand functions.php in je thema map (gebruik een correcte map naam in plaats van custom-directory):

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

Vergeet niet dat deze map in de /wp-content map moet staan.

Hoe kan de conversie handmatig worden uitgevoerd?

Standaard worden alle afbeeldingen geconverteerd wanneer je op de knop Start bulk optimalisatie klikt. Bovendien gebeurt de conversie automatisch wanneer je nieuwe bestanden toevoegt aan je mediabibliotheek.

Vergeet niet dat onze plugin rekening houdt met afbeeldingen die door WordPress worden gegenereerd. Er zijn veel plugins die bijvoorbeeld afbeeldingen van een ander formaat of in een andere versie genereren.

Als je wil integreren met je plugin, die zelf afbeeldingen genereert, dan kan dat. Onze plugin biedt de mogelijkheid van dit soort integratie. Dit werkt voor alle afbeeldingen in de /wp-content map.

Het is een oplossing voor gevorderde gebruikers. Als je wil integreren met een andere plugin, kun je het beste contact opnemen met de auteur van die plugin en hem informatie geven over de beschikbare acties in onze plugin. Dit zal je helpen sneller een oplossing te vinden.

Je kunt het omzetten van geselecteerde bestanden handmatig uitvoeren, je kunt de actie gebruiken waaraan je een array met een lijst van paden doorgeeft (het moeten absolute serverpaden zijn):

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

Een alternatieve methode is het handmatig starten van de conversie van de geselecteerde bijlage door het bericht ID van de mediabibliotheek door te geven. Vergeet niet deze actie uit te voeren nadat alle afbeeldingsformaten zijn geregistreerd (d.w.z. na het uitvoeren van de functie add_image_size):

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

Om handmatig geconverteerde bestanden te verwijderen, gebruik je de volgende actie, met als argument een array van absolute serverpaden naar de bestanden (hierdoor worden handmatig geconverteerde bestanden verwijderd):

do_action( 'webpc_delete_paths', $paths );

Ondersteuning voor WP-CLI

De plugin ondersteunt WP-CLI, waardoor afbeeldingen sneller geconverteerd kunnen worden vanaf het serverniveau. Meer informatie over hoe aan de slag te gaan met WP-CLI is te vinden in het handboek. De ondersteunde commando’s worden hieronder beschreven.

Controleren hoeveel afbeeldingen er maximaal voor conversie op de website staan:

wp converter-for-media calculate

Converteer alle afbeeldingen:

wp converter-for-media regenerate

Alle afbeeldingen converteren (met de optie “Alle afbeeldingen opnieuw forceren”):

wp converter-for-media regenerate --force

Ondersteund de plugin CDN?

De website bestanden (WordPress bestanden) en de afbeeldingen uit de mediabibliotheek moeten op dezelfde server staan. Als dat zo is, zou alles goed moeten werken.

Als alleen je afbeeldingen op een andere CDN server staan, is een correcte werking helaas onmogelijk, omdat die afbeeldingen door een andere server worden beheerd.

Huidige lijst van ondersteunde CDN servers:
– BunnyCDN (bekijk de instructies voor gebruik)