Hibaelhárítás

A legtöbb gondot a Tester fül előre jelzi, ezért először azt nézd meg. A képenkénti okokat a Napló fül mutatja.

Kulcs és kapcsolat

Amit látsz	Ok	Mit tegyél
„Nincs csatlakoztatva” / „A konvertálás bekapcsolásához illessz be egy API-kulcsot.”	Nincs kulcs.	Másold ki a kulcsot a console-ból, illeszd be, ments, majd Kapcsolat tesztelése.
„A kapcsolatteszt sikertelen: …”	Rossz vagy rotált kulcs, vagy a HelloIMG nem érhető el.	Másold be újra a kulcsot; a Tester „HelloImg API” sora mutatja a pontos hibát.
„Ez az API-kulcs a(z) X oldalhoz tartozik, ez az oldal viszont Y.”	A kulcs másik domainhez szól (pl. staging és éles, vagy domainváltás után).	Vedd fel ezt a domaint is a console-ban, és az ő kulcsát használd. Reverse proxy vagy multisite mögött: lw_img_site_host szűrő.
Bulk: „A futás leállt, mert az API elutasította a kulcsot…”	A kulcsot futás közben rotálták vagy törölték.	Írd be az új kulcsot, és indítsd újra; a maradék képek a sorban vannak.
Bulk: a futás leállt, elfogyott a keret	A havi keret elfogyott.	Csomagváltás után indítsd újra; a maradék képek a sorban vannak.

A régi URL-ek átirányítása (nginx)

Ha a tömeges optimalizálás nem indul, és ezt látod: „Ez a szerver maga válaszol a hiányzó képfájlokra…”, akkor a webszerver (jellemzően az nginx) maga ad 404-et a nem létező képekre. Így a WordPress nem tudja a régi .jpg címet az új .webp-re irányítani, és a régi hivatkozások elromlanának.

A javítás egy blokk az oldal nginx-konfigurációjába. A Tester fülön ugyanez kimásolható, az oldalad valódi feltöltési útvonalával:

nginx – az oldal server blokkjába

location ^~ /wp-content/uploads/ {
    location ~* \.(?:jpe?g|png|gif|bmp|tiff?)$ {
        expires max; access_log off; log_not_found off;
        add_header Cache-Control "public";
        try_files $uri /index.php$is_args$args;
    }
    location ~* \.(?:css|js|ico|svg|woff2?|ttf|eot|webp|avif|mp4|webm|pdf)$ {
        expires max; access_log off; log_not_found off;
        add_header Cache-Control "public";
        try_files $uri =404;
    }
    location ~* \.php$ { deny all; }
    try_files $uri =404;
}

Prefix (^~) location kell, mert egy sima regex-blokk alulmaradna a korábbi statikusfájl-szabályokkal szemben. Utána töltsd újra a webszervert, ürítsd a CDN gyorsítótárát, és a Tester fülön kattints a Tesztek újrafuttatása gombra.

Csak végszükség esetén

Parancssorból a --skip-redirect-check kapcsolóval a futás javítás nélkül is elindul, de ilyenkor a régi kép-URL-ek 404-et adnak.

Szerver

Amit látsz	Ok	Mit tegyél
Tester: a táblaszintű zárolás megakaszthatja az oldalt	A táblák MyISAM motorúak.	Mentés után ALTER TABLE <tábla> ENGINE=InnoDB (a Tester kimásolható parancsot ad).
Tester: „WebP bélyegkép-támogatás: nem támogatott”	A szerver képszerkesztője (Imagick/GD) nem tud WebP-t.	Kérj a tárhelyszolgáltatótól WebP-képes Imagicket vagy GD-t; addig ne indíts tömeges futást.
Tester: AVIF nem támogatott	AVIF kimenetnél a szerver nem tud AVIF bélyegképet készíteni.	Állítsd a formátumot WebP-re, vagy frissíttesd a képszerkesztőt.
Tester: a szerver nem éri el saját magát	A háttérfeladatok nem indulnak maguktól.	Tartsd nyitva a Bulk fület, vagy futtasd parancssorból: wp lw-img optimize --all.
A tömeges futás lassan halad vagy áll	A WP-Cron csak látogatáskor fut.	wp lw-img optimize --all, vagy rendszer-cron.
A bővítmény nem kapcsolható be	WordPress 6.6 vagy PHP 8.0 alatti verzió.	Frissíts WordPress 6.6+ és PHP 8.0+ verzióra.

Képek

Amit látsz	Ok	Mit tegyél
„Kihagyva — a konvertált X lenne az eredeti Y helyett”	A forrás már erősen tömörített, a WebP nagyobb lenne.	Ez helyes működés: az eredeti marad. Más szinten: wp lw-img requeue --skipped, majd --level=aggressive, vagy a kép szerkesztőoldalán újraoptimalizálás.
„Kihagyva”, file missing	A fájl nincs a lemezen.	A csatolmány hibás; nézd meg a Médiatárban.
Tester: más optimalizáló bővítmény is aktív	Két optimalizáló fut egyszerre.	Kapcsold ki az egyiket; két optimalizáló ugyanazon a médiatáron dupla konvertálást és elpazarolt keretet okoz.
Nem látszik az intelligens vágás	Négyzetes kép négyzetes méretre (nincs mit vágni), ki van kapcsolva az automatikus konvertálás, vagy a rendszer-cron még nem futott.	Meglévő képekre: wp lw-img smartcrop <id> vagy --all.

Ha elakadtál, írj nekünk: [email protected].