Brakuje pliku zdjęcia
Zdjęcie jest w bibliotece mediów i przypisane do produktu, ale pliku nie ma na serwerze. W panelu wszystko wygląda dobrze, a klient widzi pustą ramkę.
Objaw
Na karcie produktu w miejscu zdjęcia jest puste pole, ikona zepsutego obrazka albo grafika zastępcza. W bibliotece mediów zdjęcie jest na liście i wygląda jak każdy inny załącznik. Jego miniatura może się nawet nadal wyświetlać, jeśli został pomniejszony plik.
Wpis w bazie jest cały. Brakuje pliku, na który wskazuje.
Prawie zawsze dzieje się to na jeden z czterech sposobów: przeprowadzka sklepu, przy której
skopiowano bazę, ale nie katalog wp-content/uploads; synchronizacja z kopią testową puszczona
w złą stronę; usunięta wtyczka, która trzymała zdjęcia na zewnętrznym serwerze, choć pliki wciąż
tam leżały; zbyt gorliwe sprzątanie katalogu uploads.
Ile to kosztuje
- Produkt wygląda na zepsuty, a nie tylko na pozbawiony zdjęcia. Klient widzi w tym zaniedbanie i tak ocenia cały sklep, a nie jeden produkt.
- Taki produkt sprzedaje się gorzej niż produkt ze zdjęciem. Klient rzadko kupuje to, czego nie widzi.
- Z panelu tego nie widać. Lista produktów nie sprawdza, czy plik jest na serwerze, a sam WordPress nigdzie tego nie sprawdza.
- Kopia zapasowa potrafi przenieść ten stan dalej. Kopia bazy przywrócona na serwer, na którym
nie odtworzono katalogu
uploads, daje dokładnie ten problem, od razu przy wszystkich zdjęciach.
Jak to sprawdzić samodzielnie
Tego nie sprawdzi zapytanie SQL, bo chodzi o pliki na serwerze. WP-CLI sprawdzi obie strony naraz:
wp eval '
foreach ( get_posts([
"post_type" => "attachment",
"post_mime_type" => "image",
"posts_per_page" => -1,
"fields" => "ids",
]) as $id ) {
$file = get_attached_file( $id );
if ( $file && ! file_exists( $file ) ) {
printf( "%d\t%s\n", $id, $file );
}
}'
Skrypt przechodzi po każdym obrazku w bibliotece mediów, więc w dużej bibliotece uruchom go poza godzinami największego ruchu. Jeśli nic nie wypisze, każdy obrazek, o którym WordPress wie, jest tam, gdzie WordPress go szuka.
Skrypt sprawdza całą bibliotekę, także zdjęcia z galerii i obrazki, których żaden produkt nie używa. Merchlint sprawdza tylko zdjęcia główne opublikowanych produktów i własne zdjęcia ich wariantów, więc może pokazać mniej.
Jak naprawić
- Zanim ruszysz bazę, ustal, czy pliki gdzieś jeszcze są: w kopii zapasowej, na starym serwerze, w kopii testowej, w chmurze (na przykład w Amazon S3). Odtworzenie katalogu zawsze kosztuje mniej niż nowa sesja zdjęciowa albo ponowne zdobycie zdjęć od dostawcy.
- Jeśli pliki przepadły, podmień zdjęcie w produktach, które go używają, a dopiero potem usuń pusty załącznik. Gdy usuniesz załącznik najpierw, produkty zostaną bez zdjęcia i bez śladu, co na nim było.
- Sprawdź, ilu zdjęć brakuje. Dwa brakujące pliki to wypadek. Dwa tysiące to niedokończona przeprowadzka sklepu: trzeba ją dokończyć, a nie poprawiać produkty po jednym.
- Po każdej przeprowadzce sklepu uruchom audyt jeszcze raz. Wtedy ta kontrola przydaje się najbardziej.
Kiedy to fałszywy alarm
- Zdjęcia trzymane na zewnętrznym serwerze. Jeśli Twoje zdjęcia są w Amazon S3, Cloudflare R2 albo podobnej usłudze i sklep pokazuje je stamtąd, lokalnego pliku z założenia nie ma. To zdecydowanie najczęstszy fałszywy alarm tej kontroli. W takim sklepie ta kontrola nie mówi nic sensownego: ukryj te wyniki w raporcie, a nie wrócą w kolejnych audytach.
- CDN, który tylko zmienia adresy zdjęć, a pliki zostawia na serwerze. Lokalna kopia wtedy jest, więc problem Cię nie dotyczy.
Jak znajduje to Merchlint
Merchlint bierze zdjęcie główne każdego opublikowanego produktu i własne zdjęcie każdego jego wariantu, odczytuje zapisaną ścieżkę pliku i sprawdza na serwerze, czy taki plik jest. Niczego nie pobiera przez sieć, ani ze sklepu, ani skądinąd, więc kontrola działa tak samo na kopii lokalnej, na kopii testowej i w działającym sklepie. Zdjęć z galerii nie sprawdza.
Jedno zdjęcie bywa zdjęciem głównym wielu produktów, dlatego wynik dotyczy zdjęcia, a nie produktu. Przy wyniku widać numer zdjęcia (załącznika) i jeden przykładowy produkt, który go używa, a przy wariancie także jego produkt nadrzędny. Jedna poprawka naprawia wszystkie produkty z tym zdjęciem.
Pewność: F — fakt z bazy i z dysku serwera. Plik pod zapisaną ścieżką jest albo go nie ma.
Coś 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.