¶ Kategorie wirtualne - automatyczne grupowanie towarów
Kategorie wirtualne w Hummerce same zbierają towary spełniające zapisane kryterium - np. "prezenty do 50 zł", "nowości", "wszystko producenta X" - i same aktualizują swoją zawartość, gdy zmieniają się ceny, parametry czy asortyment. Obsługa sklepu nie musi ręcznie przypinać każdego towaru do kategorii, a katalog nadąża za zmianami z importu albo z ERP.
Stan na wersję Hummerce 2.35 (ostatnie zmiany w module: 2.35.55), aktualizacja 2026-09-28.
¶ Korzyści i zastosowania
- Przedziały cenowe - np. "Prezenty do 50 zł", "Do 100 zł"; kategoria sama uwzględnia zmiany cen.
- Kategorie z parametrów - nowości, bestsellery, okazje, kolor, materiał, model pojazdu; także całe drzewo kategorii zbudowane z parametrów.
- Kategorie producenta lub marki - wszystkie towary danego producenta w jednym miejscu.
- Łączenie kategorii - np. "Na lato" z towarów kilku kategorii głównych.
- Hurtowe przypisanie do zwykłej kategorii - utwórzcie kategorię wirtualną, poczekajcie na przeliczenie, wyłączcie Kategoria wirtualna; zostaje zwykła kategoria z przypisanymi towarami, do której można dalej dodawać ręcznie.
- Filtr w panelu - niewidoczna kategoria wirtualna (np. towary w promocji) jako gotowy filtr listy towarów dla obsługi sklepu.
- Mniej pracy przy imporcie z ERP - wystarczy, że import ustawia parametry, a towary same trafiają do właściwych kategorii.
¶ Jak to wygląda
Zrzuty z panelu sklepu demonstracyjnego Hummerce.
¶ Kategoria wirtualna i kryterium w edycji kategorii
¶ Kryterium w trybie zaawansowanym
¶ Lista towarów kategorii - odświeżanie i kolejność
¶ Zasady działania
- Każda kategoria może być wirtualna - decyduje o tym pole Kategoria wirtualna w edycji kategorii.
- Pole Kryterium towarów określa, które towary trafiają do kategorii. Kilka warunków w kryterium musi być spełnionych jednocześnie.
¶ Jak towar trafia do kategorii wirtualnej
- Przeliczanie:
- automatycznie co godzinę - zadanie Aktualizacja kategorii wirtualnych; przelicza kategorie tylko wtedy, gdy od poprzedniego przebiegu zmieniły się jakiekolwiek towary lub kategorie,
- na żądanie - Odśwież kategorię wirtualną na liście towarów kategorii.
- Przy przeliczeniu:
- towary, które przestały spełniać kryterium, są usuwane z kategorii,
- nowe towary są dopisywane na końcu listy,
- pozostałe towary zachowują ustawioną kolejność - można ją zmieniać jak w zwykłej kategorii.
- Towary dodane do kategorii wirtualnej ręcznie znikną przy najbliższym przeliczeniu, jeśli nie spełniają kryterium.
- Kategoria wirtualna bez kryterium jest opróżniana przy najbliższym przeliczeniu.
- Kryterium nie wyklucza samo niczego: towary niewidoczne, niedostępne czy bez stanu trafią do kategorii, jeśli kryterium tego nie zabrania (warunki "Widoczne", "Dostępne", "Kupowalne").
- Warianty i artykuły trafiają do kategorii zgodnie z ustawieniami sklepu Warianty towarów na listach i Wyświetlaj artykuły na listach (grupa Nawigacja w sklepie). Przy wyłączonych wariantach na listach zamiast wariantu trafia do kategorii jego artykuł.
- Wyłączenie Kategoria wirtualna zatrzymuje aktualizację - ostatnio przypisane towary zostają, a kategoria działa dalej jak zwykła.
- Dla klienta sklepu kategoria wirtualna niczym nie różni się od zwykłej - ma swój adres, opis, filtry i sortowanie.
¶ Przykłady kryteriów (tryb Zaawansowane)
Warunki oddziela się średnikiem ;. Symbole parametrów sklepu - Konfiguracja -> Parametry -> Towary. Id kategorii i producenta widać w panelu, na liście lub w adresie strony edycji.
| Cel | Kryterium |
|---|---|
| Towary od 0,01 do 50 zł brutto | taxedPriceMin=0.01;taxedPriceMax=50.00 |
| Tylko widoczne i dostępne | visible=true;available=true |
| Towary z parametrem (np. nowość) | [symbol_parametru]=true |
| Nazwa zawiera słowo | [_name]*marketing |
| Towary jednego producenta | producerId=3 |
| Towary z kilku kategorii głównych | mainCategoryIds=[302, 281] |
| Towary z kategorii i jej podkategorii | ancestorId=302 |
| Bez wariantów / bez artykułów | notSubitem=true / notArticle=true |
¶ Wersja
- Kategorie wirtualne to funkcja podstawowa platformy - dostępna we wszystkich wspieranych wersjach.
- Od wersji 2.34 - poprawiona stabilność i wydajność przeliczania na dużych katalogach.
- Od wersji 2.35 - obsługa przez asystenta AI (MCP).
- Ostatnie zmiany w module: wersja 2.35.55.
¶ Zależności
- Parametry towarów, po których ma działać kryterium (np. "Nowość"), muszą istnieć i być uzupełnione - Parametry i lokacje.
- Wyszukiwarka sklepu (SOLR) - w sklepach, w których listy kategorii pochodzą z wyszukiwarki, zmiany zawartości kategorii są widoczne po aktualizacji indeksu (Wyszukiwarka i filtry).
- Zadanie Aktualizacja kategorii wirtualnych musi być włączone (domyślnie jest).
¶ Wdrożenie
- Działa po aktualizacji - funkcja jest częścią platformy, nie wymaga uruchamiania ani zmian w szablonie sklepu (BS5 i BS4). Kategorie wirtualne tworzy i konfiguruje obsługa sklepu w panelu.
- Minimalny szacowany czas:
- samodzielna konfiguracja przez sklep - 0 h,
- konfiguracja kategorii przez nas (kryteria, sprawdzenie zawartości) - od 1 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba kategorii i złożoność kryteriów,
- czy trzeba najpierw utworzyć lub uzupełnić parametry towarów (np. przez import),
- wielkość katalogu i konfiguracja wyszukiwarki sklepu,
- wersja sklepu - aktualizacja wyceniana osobno.
¶ Ograniczenia
- Przeliczanie automatyczne tylko co godzinę - na zmianę od razu trzeba użyć Odśwież kategorię wirtualną.
- W sklepach z wyszukiwarką SOLR nowe towary w kategorii mogą pojawić się w sklepie z opóźnieniem, w skrajnym przypadku dopiero po nocnej przebudowie indeksu.
- Usunięcie kryterium i przeliczenie opróżnia kategorię bez ostrzeżenia w panelu.
- Nie da się na stałe dodać do kategorii wirtualnej pojedynczego towaru "poza kryterium" ani wykluczyć jednego towaru inaczej niż warunkiem w kryterium.
- Nowe towary zawsze trafiają na koniec listy - przy ręcznie ustawionej kolejności trzeba je przesunąć samodzielnie.
- Warunki kryterium łączą się tylko przez "i" (wszystkie jednocześnie); alternatywę "lub" dla wartości daje wyrażenie regularne albo lista wartości (np. kilka kategorii).
- Zapis tekstowy kryterium nie jest sprawdzany przy zapisie - błąd w kryterium (np. pusta lista kategorii) może spowodować, że kategoria nie zostanie przeliczona poprawnie. Bezpieczniej budować kryterium w edytorze warunków.
- Kategorie wirtualne nie są dostępne przez REST API.
- Nie weryfikujemy zadania pod kątem zgodności z prawem (np. licencje przekazanych materiałów, RODO, regulamin sklepu).
¶ Potencjał rozwoju
- Natychmiastowa aktualizacja list w wyszukiwarce po przeliczeniu kategorii.
- Ostrzeżenie w panelu przed zapisem pustego lub błędnego kryterium, podgląd liczby pasujących towarów (dziś dostępny przez MCP).
- Wybór miejsca dla nowych towarów (początek / koniec listy / wg sortowania).
- Wyjątki: towary dodane lub wykluczone ręcznie, zachowane przy przeliczaniu.
- Obsługa kategorii wirtualnych w REST API.
¶ Najczęstsze pytania
Czy do kategorii wirtualnej można ręcznie dodać towar?
Nie na stałe. Towar dodany ręcznie zniknie przy najbliższym przeliczeniu, jeśli nie spełnia zapisanego kryterium.
Czy zawartość kategorii aktualizuje się natychmiast po zmianie towaru?
Częściowo. Automatyczne przeliczenie działa co godzinę i tylko wtedy, gdy od poprzedniego przebiegu były zmiany. Do natychmiastowej aktualizacji służy przycisk Odśwież kategorię wirtualną.
Czy usunięcie kryterium usuwa towary z kategorii?
Tak. Kategoria wirtualna bez kryterium jest opróżniana przy najbliższym przeliczeniu, a panel nie ostrzega przed tym przed zapisem.
Czy kategorie wirtualne są dostępne przez REST API?
Nie. Kategorie wirtualne obsługuje się w panelu albo przez asystenta AI (MCP) - REST API nie ma operacji na ich ustawieniach.
Ile trwa uruchomienie kategorii wirtualnej?
Samodzielna konfiguracja w panelu nie wymaga naszego udziału. Z naszą pomocą przy budowie kryteriów - od 1 h.
Czy kategoria wirtualna może łączyć towary z kilku kategorii głównych?
Tak, kryterium mainCategoryIds=[...] zbiera towary z kilku wskazanych kategorii głównych w jedną listę.
¶ Powiązane
- Parametry i lokacje - kryteria kategorii wirtualnych najczęściej korzystają z parametrów towarów.
- Wyszukiwarka i filtry - kategorie wirtualne mogą pobierać listę towarów z indeksu wyszukiwarki.
- Na hummerce.com: Nieograniczona parametryzacja.
Chcecie zobaczyć, jak kategorie wirtualne mogą działać w Waszym sklepie? Umówcie bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Edycja kategorii: Asortyment -> Kategorie - pola:
- Kategoria wirtualna - Tak / Nie,
- Kryterium towarów - edytor warunków (Dodaj nowe kryterium) albo zapis tekstowy w trybie Zaawansowane (opis składni).
- Lista towarów kategorii: Asortyment -> Towary z wybraną kategorią - Odśwież kategorię wirtualną (przeliczenie od razu) i Ustaw kolejność.
- Zadanie cykliczne: Status -> Zadania - Aktualizacja kategorii wirtualnych (co godzinę).
- Ustawienia sklepu: grupa Nawigacja w sklepie - Warianty towarów na listach, Wyświetlaj artykuły na listach.
¶ REST API i MCP
- REST API: kategorie można pobierać, tworzyć i zmieniać (REST API), ale bez ustawień kategorii wirtualnej i bez przeliczania.
- MCP (Asystent AI - serwer MCP):
ec2_virtual_categories_list- lista kategorii wirtualnych i informacja, czy mają kryterium,ec2_virtual_category_criteria_get- zapisane kryterium kategorii,ec2_virtual_category_criteria_set- ustawienie kryterium z opisu (producent, kategoria, cena, widoczność, dostępność, parametry); domyślnie tylko podgląd liczby i próbki towarów, zapis po potwierdzeniu; puste kryterium jest odrzucane,ec2_virtual_category_refresh- przeliczenie kategorii; odmawia, gdy kategoria nie ma kryterium,ec2_criteria_fields,ec2_criteria_build,ec2_criteria_explain- pola kryteriów w sklepie, budowa i objaśnienie zapisu tekstowego.
¶ Komunikaty sklepu
Moduł nie ma własnych komunikatów w sklepie ani szablonów maili. Nazwa, opis, SEO i tłumaczenia kategorii wirtualnej ustawia się jak w każdej kategorii - w edytorze komunikatów i w danych samej kategorii.
¶ Parametry
| Symbol | Obiekt | Etykieta |
|---|---|---|
_virtualCategory |
kategoria | Kategoria wirtualna |
_itemCriteria |
kategoria | Kryterium towarów |