Skip to main content
Panel ItemShop pozwala wgrywać obrazy produktów, logo, favicony i grafiki edytora bezpośrednio do magazynu sklepu. Backend sprawdza, kompresuje i konwertuje pliki do WebP, usuwa metadane oraz zapisuje wynik w skonfigurowanym Cloudflare R2/CDN.

​
Wgrywanie w panelu

1

Wybierz plik

W formularzu produktu lub edytorze kliknij Wgraj. Panel przyjmuje PNG, JPEG, WebP i GIF; pojedynczy plik może mieć do 8 MB.
2

Poczekaj na przetworzenie

Serwer sprawdzi, czy plik jest poprawnym obrazem, ograniczy jego wymiary zależnie od zastosowania i zwróci adres CDN. Samo rozszerzenie lub nagłówek MIME nie wystarcza do przejścia walidacji.
3

Zapisz formularz

Wgranie pliku nie publikuje jeszcze zmiany. Zapisz produkt albo opublikuj układ, aby obraz został oznaczony jako używany.

​
Limit i automatyczne czyszczenie

Każdy sklep ma 10 MB miejsca na przetworzone pliki. Zakładka Pliki pokazuje wykorzystanie, referencje i pozwala usunąć obiekt. Plik nieużywany w żadnym produkcie ani w ustawieniach jest automatycznie usuwany po okresie ochronnym: po 1 godzinie w planie Darmowym albo po 24 godzinach przy aktywnym planie Pro.
Usunięcie używanego pliku powoduje zniknięcie grafiki wszędzie, gdzie zapisano jego adres. Najpierw usuń lub zastąp referencję w produkcie albo edytorze.

​
Użycie API

POST /uploads/{shopId}/image przyjmuje obraz jako base64/data URL i wymaga dostępu full do sklepu. GET /uploads/{shopId}/files zwraca pliki oraz zużycie limitu. Produkty przechowują ostatecznie tablicę adresów URL, więc integracja API może też podać własny publiczny adres HTTPS; wtedy ItemShop nie kontroluje dostępności ani retencji zewnętrznego hosta.
Jeśli magazyn R2 nie jest skonfigurowany w instalacji, endpoint uploadu zwraca 503. To błąd konfiguracji wdrożenia, a nie pliku użytkownika.