¶ Menedżer plików i obrazków - wgrywanie i optymalizacja zdjęć
Menedżer plików i obrazków to jedno miejsce w panelu Hummerce do wgrywania, edycji i porządkowania zdjęć oraz plików sklepu - zdjęć towarów, grafik do treści, instrukcji i certyfikatów. Zdjęcia można od razu skompresować i zapisać w nowoczesnych formatach WebP i AVIF, co przyspiesza ładowanie sklepu i poprawia wyniki Google PageSpeed.
Stan na wersję Hummerce 2.35 (ostatnie zmiany w module: 2.35.51), aktualizacja 2026-09-28.
¶ Korzyści i zastosowania
- Szybsze strony: AVIF jest zwykle o 20-50% lżejszy od WebP przy porównywalnej jakości, WebP - wyraźnie lżejszy od jpg i png.
- Lepsza ocena Google PageSpeed bez ręcznej obróbki zdjęć - format dobiera przeglądarka klienta.
- Zdjęcie towaru w kilku rozmiarach jednym wgraniem, bez programu graficznego - także kadrowanie i znak wodny.
- Pliki do pobrania (instrukcje, karty katalogowe, certyfikaty, deklaracje) wgrywane i podmieniane przez obsługę sklepu, bez dostępu do FTP.
- Kontrola, kto może zmieniać pliki sklepu - przez uprawnienia administratorów.
- Hurtowe zdjęcia z importu - np. nowa kolekcja kilkuset towarów bez ręcznego wgrywania.
- Zdjęcia dodawane przez asystenta AI - np. uzupełnienie brakujących zdjęć lub przeniesienie katalogu do drugiego sklepu.
¶ Jak to wygląda
Zrzuty ze sklepu demonstracyjnego Hummerce.
¶ Menedżer plików w panelu
¶ Konfiguracja zdjęć
¶ Zasady działania
¶ Menedżer plików
- Przeglądanie katalogów z plikami sklepu, wyszukiwanie po nazwie, sortowanie po nazwie i rozmiarze, podgląd z wymiarami, wielkością i datą modyfikacji.
- Wgrywanie wielu plików naraz (także przeciągnięciem), tworzenie i usuwanie katalogów, zmiana nazwy, pobieranie, usuwanie pojedyncze i grupowe.
- Dwa tryby:
- zdjęcia - domyślnie pliki jpg, jpeg, png, gif, webp, avif,
- pliki - domyślnie pdf, txt, xls, dwg, doc oraz wszystkie formaty zdjęć.
- Listy dozwolonych rozszerzeń sklep zmienia w konfiguracji.
- Każdy wgrywany plik jest sprawdzany - sklep odrzuca:
- pliki wykonywalne i skrypty (np. php, jsp, exe, sh, js), bez względu na ustawienia,
- pliki, w których treści jest kod skryptu (np. zdjęcie z ukrytym skryptem),
- rozszerzenia spoza listy dozwolonych.
- Nazwy plików: litery bez polskich znaków, cyfry i podkreślnik.
- Ten sam menedżer otwiera się wszędzie, gdzie w panelu wybiera się zdjęcie lub plik: w karcie towaru (Zdjęcia i pliki), w parametrach typu zdjęcie i plik, w edytorze treści (WYSIWYG).
- Dostęp do menedżera nadaje się w uprawnieniach administratorów - można np. udostępnić pliki tylko wybranym osobom (Uprawnienia administratorów).
¶ Wgrywanie zdjęcia do towaru i treści
- Zdjęcie wybiera się z dysku albo z plików już wgranych do sklepu.
- Przed zapisem zdjęcie można poprawić we wbudowanym edytorze: kadrowanie, obrót, odbicie, filtry, korekta jasności i kolorów, zmiana rozmiaru, napisy i znak wodny.
- Jednym wgraniem zapisuje się wszystkie rozmiary zdjęcia towaru (np. miniatura, zdjęcie na karcie, powiększenie) - okno pokazuje rozmiar docelowy każdego z nich.
- Skalowanie działa, gdy w konfiguracji włączone jest Skaluj wgrywane obrazki. Proporcje zdjęcia są zachowane.
- Wymiary poszczególnych rozmiarów są ustawiane dla sklepu przy wdrożeniu (zależą od szablonu).
- Przy wgrywaniu można zaznaczyć:
- Kompresuj zdjęcia - kompresja jpg i png bez widocznej utraty jakości (png bezstratnie, jpg z jakością ustawioną w konfiguracji),
- Zapisz wersję webp, Zapisz wersję avif - dodatkowy plik w nowoczesnym formacie obok oryginału.
- Wartości domyślne tych pól wynikają z konfiguracji sklepu (Automatyczna kompresja, Konwertuj do WEBP, Konwertuj do AVIF).
- Zdjęcia alternatywne (galeria towaru) dodaje się tak samo - każde ma własny komplet rozmiarów.
¶ Optymalizacja i formaty WebP, AVIF
- Automatyczna kompresja - zdjęcie jest kompresowane za każdym razem, gdy zmienia się zdjęcie w towarze, kategorii, stronie itp. Plik jest podmieniany tylko wtedy, gdy wynik jest mniejszy od oryginału.
- Konwertuj do WEBP / Konwertuj do AVIF - obok każdego kompresowanego zdjęcia powstaje jego wersja WebP / AVIF. Oryginał jpg lub png zostaje.
- Pokaż WEBP w tagu image / Pokaż AVIF w tagu image - sklep podaje przeglądarce kilka wersji zdjęcia, a ta wybiera najlepszą, którą obsługuje: AVIF, potem WebP, na końcu jpg lub png.
- Pokaż plik źródłowy w tagu image - czy podawać też oryginał jpg lub png jako wersję zapasową (domyślnie tak).
- Jakość konwersji ustawia się osobno dla każdego formatu. Domyślnie: JPG 85, PNG 95, WebP 80, AVIF 80 (skala 1-100).
- Wykluczone katalogi - katalogi, których zdjęć sklep nie optymalizuje (np. grafiki przygotowane ręcznie).
- Zdjęcia wgrane wcześniej optymalizuje i konwertuje transfer Optymalizacja obrazów (Transfer danych):
- przechodzi po wszystkich zdjęciach jpg i png sklepu i tworzy brakujące wersje WebP i AVIF zgodnie z konfiguracją,
- pole Data od ogranicza pracę do zdjęć zmienionych po tej dacie,
- przy dużej liczbie zdjęć może trwać wiele godzin; przerwanie nie cofa wersji już utworzonych.
¶ Import zdjęć towarów
Dwa transfery do hurtowego przypisania zdjęć, gdy jest ich za dużo na ręczne wgrywanie (np. nowa dostawa, zdjęcia od producenta).
- Import zdjęć towarów (z ftp) - przypisuje zdjęcia już wgrane do sklepu (np. przez menedżer plików):
- katalogi mają nazwy rozmiarów zdjęć (np.
_small,_big,_popup, a dla zdjęć alternatywnych_big_multi_1itd.), - plik w katalogu nazywa się symbolem towaru, np.
ABC123.jpg, - formaty: jpg, jpeg, png, gif, bmp, tiff,
- zdjęcia nie są skalowane - każdy rozmiar trzeba przygotować wcześniej,
- tryb testowy pozwala sprawdzić wynik bez zapisu; raport pokazuje liczbę zdjęć, których nie udało się przypisać (brak towaru o danym symbolu).
- katalogi mają nazwy rozmiarów zdjęć (np.
- Import zdjęć - pobiera oryginały ze wskazanego serwera (FTP lub adres internetowy), skaluje je do wszystkich rozmiarów sklepu i przypisuje do towarów:
- źródło: lista plików w parametrze towaru "Zdjęcia do importu" albo katalog na serwerze nazwany symbolem towaru (lub wartością parametru "Indeks katalogowy - zdjęcia"),
- pierwsze zdjęcie staje się zdjęciem głównym, kolejne - alternatywnymi,
- pliki dostają przyjazne nazwy na podstawie adresu towaru (lepsze pozycjonowanie w wyszukiwarce grafik), zapisane w parametrze "Przyjazna nazwa zdjęć",
- zakres towarów wybiera się kryteriami; import jest dostępny także jako operacja grupowa na liście towarów (Operacje grupowe na towarach).
¶ Wersja
- Od wersji 2.33 - menedżer plików, nowe okno wgrywania zdjęć z edytorem, optymalizacja i WebP przy wgrywaniu. W starszych wersjach działa wcześniejsze narzędzie.
- Format AVIF - od wersji 2.34.
- Obsługa zdjęć przez asystenta AI (MCP) - od wersji 2.35.
- Ostatnie zmiany w module: wersja 2.35.51.
¶ Zależności
- Serwer zdjęć i plików sklepu skonfigurowany w grupach Konfiguracja zdjęć i Konfiguracja plików (adres, ścieżki zapisu i odczytu) - ustawiamy przy wdrożeniu sklepu.
- Program do przetwarzania obrazów na serwerze sklepu, wymagany do skalowania, kompresji i konwersji; AVIF wymaga wersji z obsługą tego formatu.
- Wyświetlanie WebP i AVIF w sklepie - szablon musi pokazywać zdjęcia standardowym mechanizmem Hummerce. Tak jest w głównych miejscach szablonów BS5 i BS4 (listy i karta towaru).
- Import z zewnętrznego serwera - dane dostępu do serwera źródłowego (grupa Import zdjęć).
¶ Wdrożenie
- Działa po aktualizacji do 2.33 - menedżer zastępuje wcześniejsze narzędzie. Wymaga sprawdzenia konfiguracji i testu. Zakres:
- weryfikacja ustawień serwera zdjęć i plików oraz wymiarów zdjęć,
- nadanie uprawnień do menedżera wybranym administratorom,
- test wgrywania zdjęcia towaru, pliku i grafiki w edytorze treści.
- WebP i AVIF wymagają uruchomienia - funkcja jest w sklepie, ale domyślnie wyłączona. Zakres:
- włączenie konwersji i ustawienie jakości,
- uruchomienie transferu Optymalizacja obrazów dla istniejących zdjęć (czas pracy serwera zależy od liczby zdjęć, nie wlicza się w godziny prac),
- włączenie wyświetlania dopiero po wygenerowaniu wersji dla istniejących zdjęć,
- dodanie obsługi AVIF w miejscach szablonu, które pokazują zdjęcia własnym kodem (np. miniatury galerii, banery),
- kontrola wyglądu i szybkości strony po zmianie.
- Minimalny szacowany czas:
- menedżer plików po aktualizacji - od 1 h,
- WebP i AVIF, szablon BS5 - od 3 h,
- WebP i AVIF, szablon BS4 lub szablon indywidualny - od 6 h,
- import zdjęć z zewnętrznego serwera - od 2 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba miejsc w szablonie, które wyświetlają zdjęcia poza standardowym mechanizmem (banery, sliderki, bloki na stronie głównej),
- stopień indywidualizacji szablonu,
- liczba zdjęć w sklepie - od niej zależy czas transferu i kontrola wyniku,
- wersja sklepu - sklep na wersji starszej niż 2.33 (dla AVIF - 2.34) wymaga najpierw aktualizacji (wycena osobno),
- nietypowa struktura zdjęć u dostawcy przy imporcie (wycena osobno).
¶ Ograniczenia
- WebP i AVIF to dodatkowe pliki obok oryginału - zdjęcia zajmują więcej miejsca na serwerze.
- Po włączeniu wyświetlania WebP lub AVIF sklep zakłada, że wersja istnieje. Dla zdjęcia bez wygenerowanej wersji przeglądarka może nie pokazać obrazka - dlatego wyświetlanie włącza się po zakończeniu transferu Optymalizacja obrazów.
- Transfer Optymalizacja obrazów obsługuje tylko jpg i png - zdjęcia gif nie są kompresowane ani konwertowane.
- Zdjęcia wstawione w opisach (edytor treści WYSIWYG) i grafiki w banerach wyświetlają się w formacie oryginału. Wersję WebP lub AVIF można wgrać, ale wstawić ją trzeba samodzielnie.
- Szablony BS5 i BS4 pokazują AVIF tylko tam, gdzie zdjęcia wyświetla standardowy mechanizm. Miejsca z własnym kodem (np. miniatury galerii towaru, flagi języków) mają dziś tylko WebP.
- Skalowanie nie przycina zdjęcia - przy innych proporcjach niż rozmiar docelowy powstaje zdjęcie mniejsze z jednej strony. Kadrowanie trzeba zrobić w edytorze.
- Import zdjęć towarów (z ftp) nie skaluje zdjęć i nie przyjmuje plików WebP ani AVIF - każdy rozmiar trzeba przygotować wcześniej w jpg lub png.
- Domyślnie menedżer nie przyjmuje formatów docx, xlsx, zip ani svg - trzeba je dopisać do listy rozszerzeń (svg nie jest skalowane ani konwertowane).
- Nazwy plików bez polskich znaków i spacji - pliki z takimi nazwami trzeba przemianować przed wgraniem.
- Menedżer nie wersjonuje plików - podmiana lub usunięcie pliku jest nieodwracalne, a usunięcie pliku nie usuwa odwołań do niego w towarach i treściach.
- Kompresja nie zmniejszy znacząco zdjęć już skompresowanych - większy zysk daje dopiero wersja WebP lub AVIF.
- Nie weryfikujemy praw do wgrywanych zdjęć i plików - licencje, zgody na wizerunek i prawa autorskie są po stronie sklepu.
¶ Potencjał rozwoju
- Automatyczna zamiana zdjęć w opisach (WYSIWYG) i banerach na WebP i AVIF.
- Obsługa AVIF we wszystkich miejscach szablonów BS5 i BS4.
- Wgrywanie zdjęć WebP i AVIF jako oryginałów z automatycznym utworzeniem wersji jpg.
- Funkcje AI w menedżerze, np. generowanie tekstów alternatywnych, usuwanie tła, powiększanie zdjęć.
- Wykrywanie nieużywanych plików i zdjęć.
- Kosz z możliwością przywrócenia usuniętego pliku.
¶ Najczęstsze pytania
Czy Hummerce automatycznie tworzy wersje WebP i AVIF zdjęć?
Tak, po włączeniu konwersji w konfiguracji. Powstają jako dodatkowe pliki obok oryginału, a przeglądarka klienta dostaje najlepszy format, jaki obsługuje.
Czy zdjęcia można poprawić bez programu graficznego?
Tak - wbudowany edytor pozwala kadrować, obracać, odbijać, poprawiać jasność i kolory, zmieniać rozmiar oraz dodawać napisy i znak wodny przed zapisem.
Czy da się wgrać zdjęcia do kilkuset towarów naraz?
Tak, transferami Import zdjęć towarów (z ftp) i Import zdjęć - drugi z nich sam skaluje zdjęcia do wszystkich rozmiarów i przypisuje je do towarów.
Ile trwa uruchomienie menedżera i formatów WebP/AVIF?
Menedżer plików po aktualizacji - od 1 h. WebP i AVIF - od 3 h w szablonie BS5, od 6 h w szablonie BS4 lub indywidualnym.
Czy da się cofnąć usunięcie pliku?
Nie. Menedżer nie wersjonuje plików - podmiana lub usunięcie jest nieodwracalne, a usunięcie nie usuwa odwołań do pliku w towarach i treściach.
¶ Powiązane
- Banery - zdjęcia i grafiki banerów wgrywa się tym samym menedżerem.
- Edytor parametrów HTML (WYSIWYG) - wstawianie zdjęć w treściach.
- Operacje grupowe na towarach - hurtowy import zdjęć jako operacja grupowa.
- Dostępność cyfrowa (WCAG, EAA) - opisy alternatywne zdjęć towarów i banerów.
Chcesz zobaczyć, jak menedżer plików i obrazków może działać w Waszym sklepie? Umów bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Menedżer plików: Treść -> Pliki.
- Zdjęcia towaru: karta towaru, zakładka Zdjęcia i pliki.
- Konfiguracja w panelu (konfiguracja techniczna):
- grupa Konfiguracja zdjęć:
- Automatyczna kompresja - domyślnie wyłączona,
- Skaluj wgrywane obrazki,
- Konwertuj do WEBP, Pokaż WEBP w tagu image - domyślnie wyłączone,
- Konwertuj do AVIF, Pokaż AVIF w tagu image - domyślnie wyłączone,
- Pokaż plik źródłowy w tagu image - domyślnie włączone,
- JPG - Domyślna jakość, PNG - Domyślna jakość bezstratna, WEBP - Domyślna jakość, AVIF - Domyślna jakość,
- Wykluczone katalogi,
- Rozszerzenia zdjęć - formaty przyjmowane przez menedżer,
- adres i ścieżki serwera zdjęć (Host zapisu zdjęć, Ścieżka zapisu zdjęć, Host odczytu zdjęć, Ścieżka odczytu zdjęć),
- grupa Konfiguracja plików: Rozszerzenia plików oraz adres i ścieżki serwera plików,
- grupa Import zdjęć: serwer źródłowy i docelowy importu, Importuj z propertiesa (lista plików w parametrze albo katalog nazwany symbolem towaru).
- grupa Konfiguracja zdjęć:
- Transfer danych: Optymalizacja obrazów, Import zdjęć towarów (z ftp), Import zdjęć.
- Operacja grupowa na towarach: Import zdjęć.
- Towar: parametry "Zdjęcia do importu", "Przyjazna nazwa zdjęć", "Indeks katalogowy - zdjęcia".
- Uprawnienia: dostęp do menedżera plików nadawany w rolach administratorów (Uprawnienia administratorów).
¶ REST API i MCP
- MCP (Asystent AI - serwer MCP):
ec2_image_upload(wgranie zdjęcia, opcjonalnie od razu z przypisaniem do towaru, kategorii lub strony i tekstem alternatywnym),ec2_image_list(lista zdjęć w danym rozmiarze),ec2_image_get(pobranie zdjęcia, np. do przeniesienia do innego sklepu). Wymagają uprawnień do zdjęć w panelu; limit ok. 12 MB na zdjęcie.
¶ Parametry
| Symbol | Obiekt | Etykieta |
|---|---|---|
_small, _big, _popup (oraz alternatywne ..._multi_1 itd.) |
towar | rozmiary zdjęcia towaru - zarazem nazwy katalogów zdjęć; zestaw zależy od sklepu |
images_to_import |
towar | Zdjęcia do importu |
friendly_url_for_image |
towar | Przyjazna nazwa zdjęć |
_imageCatalogIndex |
towar | Indeks katalogowy - zdjęcia |