Converter for Media – Optimalizácia obrázkov | Konvertovanie WebP & AVIF

Časté otázky

Ako môžem hlásiť bezpečnostné chyby?

Bezpečnostné chyby môžete nahlásiť prostredníctvom programu Patchstack Vulnerability Disclosure Program. Tím Patchstack pomáha overovať, triediť a riešiť akékoľvek bezpečnostné chyby.

Nahlásiť bezpečnostnú chybu

Ako získať technickú podporu? (predtým, ako požiadate o pomoc)

Predtým, ako pridáte nové vlákno, prečítajte si najskôr všetky ostatné otázky v tejto sekcii FAQ a ostatné vlákna v podpornom fóre. Možno mal niekto podobný problém a ten bol už vyriešený.

Pri pridávaní vlákna postupujte podľa týchto krokov a odpovedzte na každý z nich:

1. Máte nejaké chyby na stránke nastavení pluginu? Ak máte nejaké chyby, prečítajte si toto vlákno.

2. URL vašej webovej stránky.

3. Screenshot karty Pomocné centrum na obrazovke nastavení pluginu – prosím, urobte screenshot CELEJ stránky.

4. Vykonajte test, ktorý je popísaný v častiach FAQ v otázke „Ako skontrolovať, či plugin funguje?“. Zašlite nám screenshot z Devtools s výsledkami testu.

Nezabudnite pridať odpovede na všetky otázky pridaním vlákna. Je to oveľa jednoduchšie a urýchľuje riešenie vášho problému.

Konfigurácia pre Nginx

Ak používate server Nginx, ktorý nepodporuje pravidlá .htaccess, je potrebná dodatočná konfigurácia servera Nginx, aby plugin fungoval správne.

Pre viac informácií si prečítajte tento návod.

Konfigurácia pre proxy server Nginx

Ak používate server Nginx, ktorý podporuje pravidlá .htaccess, ale na stránke s nastaveniami pluginu sa stále zobrazuje chyba konfigurácie servera, na správne fungovanie pluginu je potrebná dodatočná konfigurácia servera Nginx.

Pre viac informácií si prečítajte tento návod.

Chyba na obrazovke nastavení pluginu?

Ak sa vám na obrazovke nastavení pluginu zobrazuje chyba, najskôr si ju pozorne prečítajte. Zobrazujú sa v prípade, že je problém s konfiguráciou vášho servera alebo webovej stránky.

Tieto správy sú navrhnuté tak, aby znížili počet opakovaných žiadostí o podporu. Šetria váš aj náš čas. Pre viac informácií si prečítajte toto vlákno.

Chyba pri konverzii?

Pri konverzii sa môže vyskytnúť niekoľko typov chýb. Najskôr si pozorne prečítajte ich obsah. Vo väčšine prípadov môžete tento problém vyriešiť sami. Skúste to alebo kontaktujte správcu servera.

Ak sa zobrazí chyba: Súbor „%s“ neexistuje. Skontrolujte cestu k súboru. znamená to, že funkcia file_exists() v PHP vrátila hodnotu false pri použití cesty k súboru uvedenej v chybovej správe. Skontrolujte túto cestu a uistite sa, že je správna.

Ak sa zobrazí chyba: Súbor „%s“ nie je čitateľný. Skontrolujte oprávnenia súboru. znamená to, že funkcia is_readable() v PHP vrátila hodnotu false pri použití cesty k súboru uvedenej v chybovej správe. Skontrolujte oprávnenia pre súbor a adresár, v ktorom sa súbor nachádza.

Ak sa zobrazí chyba: „%s“ nie je platný obrazový súbor. znamená to, že súbor je nejakým spôsobom poškodený. Stiahnite súbor na disk, uložte ho znovu pomocou ľubovoľného grafického programu a pridajte ho znovu na stránku. Ak sa chyba týka jednotlivých obrázkov, môžete ju ignorovať – načítajú sa len pôvodné obrázky, nie WebP.

Ak sa zobrazí chyba: Obrázok „%s“ konvertovaný do formátu .webp je väčší ako originál a konvertovaný súbor .webp bol odstránený. znamená to, že pôvodný obrázok mal menšiu veľkosť ako WebP. K tomu dochádza, ak boli obrázky predtým komprimované. V nastaveniach pluginu deaktivujte možnosť „Automatické odstraňovanie súborov vo výstupných formátoch, ktoré sú väčšie ako originál“, aby sa vždy používal formát WebP.

Aké sú požiadavky na plugin?

Prakticky každý hosting spĺňa tieto požiadavky. Musíte používať PHP minimálne verzie 7.0 a mať nainštalované rozšírenie GD alebo Imagick. Rozšírenie musí podporovať formát WebP. Ak sa vám zobrazuje chyba, že knižnica GD alebo Imagick nie je nainštalovaná, ale máte ju nainštalovanú, pravdepodobne je nesprávne nakonfigurovaná a nepodporuje formát WebP.

Sú to potrebné natívne rozšírenia PHP, ktoré používa okrem iného aj WordPress na generovanie miniatúr. Váš server musí mať tiež povolené moduly mod_mime, mod_rewrite a mod_expires.

Príklad správnej konfigurácie servera nájdete tu. Odkaz na vašu aktuálnu konfiguráciu nájdete v karte Centrum pomoci na obrazovke nastavení doplnku.

Všimnite si položky označené červenou farbou. Ak sa hodnoty označené červenou farbou vo vašom prípade nezobrazujú, znamená to, že váš server nespĺňa technické požiadavky. Venujte pozornosť hodnote Podpora WebP pre knižnicu GD a WEBP v zozname podporovaných rozšírení pre knižnicu Imagick.

V prípade, že váš server nespĺňa technické požiadavky, kontaktujte správcu servera. My vám v tejto veci nemôžeme pomôcť. Neobracajte sa na nás s touto záležitosťou, pretože ide o problém s konfiguráciou servera, nie s pluginom.

Okrem toho musí byť REST API povolené a fungovať bez ďalších obmedzení. Ak máte s tým problém, kontaktujte vývojára, ktorý vytvoril vašu webovú stránku. Mal by ľahko nájsť problém s nefunkčným REST API.

Ako skontrolovať, či plugin funguje?

Viac informácií o fungovaní pluginu nájdete v našej príručke.

Ako zmeniť cestu k nahratým súborom?

To je možné pomocou nasledujúcich typov filtrov na zmenu predvolených ciest. Ide o riešenie pre pokročilých používateľov. Ak ním nie ste, túto otázku preskočte.

Cesta k koreňovému inštalačnému adresáru WordPressu (štandardne ABSPATH):

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

Cesty k adresárom (relatívne ku koreňovému adresáru):

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

Upozorňujeme, že adresár /uploads-webpc musí byť na rovnakej úrovni ako adresáre /uploads, /plugins a /themes.

Predpona v URL adrese adresára /wp-content/ alebo ekvivalentu (používaná v .htaccess):

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

Pre nasledujúcu vzorovú vlastnú štruktúru WordPress:

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

Použite nasledujúce filtre:

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

Po nastavení filtrov prejdite v administrátorskom paneli do sekcie Nastavenia -> Konvertor pre médiá a kliknite na tlačidlo Uložiť zmeny. Súbory .htaccess s príslušnými pravidlami by mali byť vytvorené v adresároch /uploads a /uploads-webpc.

Ako vylúčiť cesty z konverzie?

Ak chcete vylúčiť vybrané adresáre, zadajte ich do poľa Vylúčené adresáre na karte Pokročilé nastavenia v nastaveniach pluginu.

Do tohto poľa môžete zadať názov adresára alebo cestu. Tu sú príklady:
– 2023
– 2024/01
– 2023,2024/01

Na vylúčenie vybraných súborov použite nasledujúci filter (v tomto prípade s príponou „-skipped“ v názve súboru, napr. 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 je absolútna cesta servera k adresáru alebo súboru. Vo filtroch môžete podľa potreby použiť zložitejšie pravidlá.

Zmeny vylúčených adresárov a súborov nadobudnú platnosť pred konverziou obrázkov – nemajú vplyv na už konvertované obrázky. Tieto obrázky je potrebné ručne odstrániť z adresára: /wp-content/uploads-webpc/.

Podpora vlastných adresárov

Plugin štandardne podporuje nasledujúce adresáre:
– /gallery
– /plugins
– /themes
– /uploads

Ak chcete pridať podporu pre vlastný adresár, pridajte nasledujúci kód do súboru functions.php v adresári témy (namiesto custom-directory použite správny názov adresára):

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

Nezabudnite, že tento adresár musí byť umiestnený v adresári /wp-content.

Ako spustiť ručnú konverziu?

Pri kliknutí na tlačidlo Začať hromadnú optimalizáciu sa štandardne prevedú všetky obrázky. Okrem toho sa prevod vykoná automaticky, keď pridáte nové súbory do knižnice médií.

Nezabudnite, že náš plugin zohľadňuje obrázky generované WordPressom. Existuje mnoho pluginov, ktoré generujú napríklad obrázky inej veľkosti alebo v inej verzii.

Ak chcete integrovať svoj plugin, ktorý generuje obrázky sám, môžete tak urobiť. Náš plugin poskytuje možnosť tohto typu integrácie. Funguje to pre všetky obrázky v adresári /wp-content.

Je to riešenie pre pokročilých používateľov. Ak chcete integrovať s iným pluginom, najlepšie je kontaktovať autora tohto pluginu a poskytnúť mu informácie o akciách, ktoré sú k dispozícii v našom plugine. To vám pomôže nájsť riešenie rýchlejšie.

Prekonvertovanie vybraných súborov môžete spustiť ručne, môžete použiť akciu, ktorej odovzdáte pole so zoznamom ciest (musia to byť absolútne cesty na serveri):

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

Alternatívnou metódou je ručné spustenie konverzie vybranej prílohy pomocou ID príspevku z mediálnej knižnice. Nezabudnite túto akciu spustiť po registrácii všetkých veľkostí obrázkov (t. j. po spustení funkcie add_image_size):

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

Na odstránenie ručne konvertovaných súborov použite nasledujúcu akciu a ako argument zadajte pole absolútnych serverových ciest k súborom (týmto sa odstránia ručne konvertované súbory):

do_action( 'webpc_delete_paths', $paths );

Podpora pre WP-CLI

Plugin podporuje WP-CLI, čo umožňuje rýchlejšiu konverziu obrázkov na úrovni servera. Viac informácií o tom, ako začať s WP-CLI, nájdete v príručke. Podporované príkazy sú popísané nižšie.

Kontrola maximálneho počtu obrázkov na konverziu na webovej stránke:

wp converter-for-media calculate

Prekonvertovanie všetkých obrázkov:

wp converter-for-media regenerate

Prekonvertovanie všetkých obrázkov (s možnosťou „Vynútiť opätovnú konverziu všetkých obrázkov”):

wp converter-for-media regenerate --force

Podporuje plugin CDN?

Súbory webovej stránky (súbory WordPress) a obrázky z mediálnej knižnice musia byť na rovnakom serveri. Ak sú, všetko by malo fungovať bez problémov.

Ak sú vaše obrázky umiestnené na inom serveri CDN, správna funkcia nie je možná, pretože takéto obrázky sú spravované iným serverom.

Aktuálny zoznam podporovaných serverov CDN:
– (pred použitím si pozrite návod)