Converter for Media – Optimize images | Convert WebP & AVIF

FAQ

How can I report security bugs?

You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities.

Report a security vulnerability.

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

Als je een Nginx server gebruikt die geen .htaccess regels ondersteunt, is er aanvullende Nginx serverconfiguratie vereist om de plugin correct te laten werken.

Lees deze handleiding voor meer informatie.

Configuratie voor Nginx proxy

Als je een nginx server gebruikt die .htaccess regels ondersteund, maar je hebt nog steeds een server configuratie fout op de plugin instellingen pagina, dan is er extra nginx server configuratie nodig om de plugin goed te laten werken.

Lees deze handleiding voor meer informatie.

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?

To exclude selected directories, provide them in the Excluded directories field in the Advanced Settings tab in the plugin settings.

In this field, you can enter a directory name or path. Here are examples:
– 2023
– 2024/01
– 2023,2024/01

Om geselecteerde bestanden uit te sluiten, gebruik de volgende filter (in dit geval met het achtervoegsel “-skipped” in een bestandsnaam, bijv. image-skipped.png):

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipped';
    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.

Changes to excluded directories and files take effect before images are converted – they do not affect already converted images. These images must be manually removed from the directory: /wp-content/uploads-webpc/.

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)