Zdjęcie jest, ale nie da się go pokazać
Plik jest na serwerze i baza na niego wskazuje, ale ma zero bajtów albo kilka pikseli. Klient widzi pustą ramkę, jakby zdjęcia w ogóle nie było.
Objaw
Biblioteka mediów pokazuje załącznik. Plik jest tam, gdzie WordPress go szuka. Sprawdzenie, które pyta tylko „czy plik jest?”, wypada dobrze. A karta produktu i tak pokazuje zepsuty obrazek albo pustą ramkę.
Merchlint wykrywa dwa takie przypadki. Pierwszy to plik, który ma zero bajtów, bo wysyłanie się przerwało. Drugi to obrazek o szerokości albo wysokości najwyżej 50 pikseli: kropka albo kafelek, który został po zepsutym imporcie albo po zdjęciu wstawionym z cudzej strony, które przestało działać.
Ten sam objaw mają też inne przyczyny, których ta kontrola nie sprawdza: plik ucięty w połowie, format, którego większość przeglądarek nie pokaże (TIFF, HEIC prosto z telefonu), albo brak pomniejszonych wersji zdjęcia, o które prosi motyw.
Ile to kosztuje
Tyle samo co brak zdjęcia. Do tego trudniej to zauważyć, bo zwykłe sprawdzenie „czy plik jest” niczego nie wykaże.
- Na karcie produktu jest dziura w miejscu, które najbardziej przekonuje do zakupu. Klient, który nie widzi towaru, go nie kupuje.
- Zwykle dotyczy wielu produktów naraz. Przerwane wysyłanie wielu zdjęć albo zepsuty import trafia od razu w dziesiątki produktów.
- W panelu wygląda to na chwilowy kłopot. Miniatura w bibliotece też jest pusta albo malutka, więc nikt się nią nie przejmuje.
Jak to sprawdzić samodzielnie
Puste pliki znajdziesz wprost na serwerze, w wierszu poleceń:
find wp-content/uploads -type f \( -name '*.jpg' -o -name '*.png' -o -name '*.webp' \) -size -1k
Polecenie wypisze pliki o zerowej wadze, także pomniejszone kopie zdjęć.
Malutkie obrazki pokaże polecenie ze strony Google Merchant Center image size (po angielsku). Wypisuje ono zdjęcia główne mniejsze niż 500 pikseli z ich wymiarami. Te, które mają 50 pikseli albo mniej z którejkolwiek strony, to przypadki tej kontroli. Polecenie bierze wymiary zapisane przy wgrywaniu, a Merchlint mierzy sam plik, więc przy pliku podmienionym z pominięciem WordPressa wyniki mogą się różnić.
Pliki uszkodzone, których Merchlint nie zgłasza, znajdzie identify z pakietu ImageMagick, jeśli
jest na serwerze. Przechodzi po każdym pliku i zgłasza błąd przy zepsutych:
find wp-content/uploads -name '*.jpg' -exec identify -quiet {} + 2>&1 | grep -i error
Brak pomniejszonych wersji widać w bazie: załącznik, którego _wp_attachment_metadata nie ma
tablicy sizes, nigdy nie przeszedł przez obróbkę zdjęć w WordPressie.
Jak naprawić
-
Przy pustych plikach wgraj oryginały jeszcze raz. Nie ma tu czego naprawiać, tych danych po prostu nie ma.
-
Malutki obrazek zastąp prawdziwym zdjęciem. Najczęściej zostawił go import, więc sprawdź, co jeszcze przyszło tą samą drogą.
-
Formaty, których przeglądarka nie pokaże (HEIC, TIFF), zamień na JPEG albo WebP przed wgraniem.
-
Odtwórz pomniejszone wersje tam, gdzie oryginał jest cały:
wp media regenerate --only-missing --yes -
Napraw źródło. Jeśli zrobił to import albo przeprowadzka sklepu, przy następnej okazji będzie tak samo.
Kiedy to fałszywy alarm
- Zdjęcia pokazywane z CDN-u albo przez wtyczkę, która trzyma je na zewnętrznym serwerze, gdy na dysku sklepu zostaje celowo pusty plik zastępczy. Merchlint nie rozpoznaje takich wtyczek, więc zgłosi te puste pliki. Ukryj wtedy te wyniki w raporcie.
- Sklep, który celowo używa drobnych grafik jako zdjęć głównych, na przykład ikonek albo próbek kolorów. Próg 50 pikseli można wtedy obniżyć w ustawieniach dodatku Pro albo ukryć te wyniki. Najpierw jednak zobacz, jak taki produkt wygląda na liście kategorii obok innych.
Jak znajduje to Merchlint
Merchlint bierze zdjęcie główne każdego opublikowanego produktu i własne zdjęcie każdego jego wariantu. Sprawdza, czy plik jest na serwerze, odczytuje jego wagę, a z nagłówka pliku wymiary w pikselach. Zgłasza zdjęcie, gdy plik ma zero bajtów albo gdy jego szerokość lub wysokość wynosi 50 pikseli albo mniej. Przy wyniku widać powód (pusty plik albo za małe zdjęcie) i wagę pliku, a przy za małym zdjęciu także jego wymiary i próg.
Czego ta kontrola nie zgłasza: brakującego pliku (to sprawdza kontrola Brakuje pliku zdjęcia), pliku uciętego w połowie, formatu, którego przeglądarka nie pokaże, ani braku pomniejszonych wersji. Plików, z których PHP nie odczyta wymiarów (SVG zawsze, AVIF na starszych wersjach PHP), nie ocenia, zamiast zgadywać. Zdjęć z galerii nie sprawdza.
Malutki obrazek trafia też do kontroli Zdjęcie za małe dla Google, która jest w wersji darmowej. Jedna mówi, że klient go nie zobaczy, druga, że Google go nie przyjmie. Jedno nowe zdjęcie załatwia obie.
Pewność: F — fakt z pliku na serwerze. Plik ma zero bajtów albo bok najwyżej 50 pikseli, albo nie.
Ta kontrola jest w dodatku Pro, który jeszcze przygotowujemy. Darmowa wtyczka jej nie uruchamia.
Zainstaluj za darmoCoś się nie zgadza z tym, co widzisz w sklepie? Napisz do nas. Czytamy każdą wiadomość. contact@merchlint.com
Masz wynik z wtyczki i nie wiesz, od czego zacząć? Do 30 listopada 2026 przeglądamy eksporty z dziesięciu sklepów — darmowy audyt katalogu.