Parametry w Hummerce pozwalają opisać towar, kategorię, klienta, zamówienie czy niemal każdy inny obiekt dowolnymi polami - nazwą, kolorem, wagą, opisem, zdjęciem czy plikiem - bez zmian w kodzie sklepu. Lokacje decydują, gdzie i w jakiej kolejności dany parametr się pojawia: w konkretnej zakładce panelu albo w konkretnym miejscu sklepu. To fundament, na którym stoi katalog towarów, warianty, konfiguratory produktów i wiele widoków w jednym sklepie.
Stan na: funkcja podstawowa platformy - dostępna we wszystkich obecnych wersjach, aktualizacja 2026-09-29.
- Dowolna liczba pól bez zmian w kodzie - nowy parametr towaru, klienta czy zamówienia zakłada się w panelu, nie w projekcie programistycznym.
- Parametry wielojęzyczne - osobna wartość dla każdego języka sklepu, np. nazwa i opis towaru po polsku i angielsku.
- Parametry wielowartościowe - jeden parametr przechowuje kilka wartości naraz, np. kilka kolorów jednego towaru.
- Parametry wielowidokowe - osobna wartość dla każdego widoku; gdy widok nie ma własnej wartości, sklep pokazuje wartość widoku domyślnego. Cechy da się dowolnie łączyć - parametr może być jednocześnie wielojęzyczny, wielowartościowy i wielowidokowy.
- Jeden parametr, wiele miejsc - lokacje pozwalają pokazać ten sam parametr w kilku ekranach panelu i sklepu bez powielania danych.
- Fundament pod warianty, konfiguratory i wyszukiwarkę - typy i wartości parametrów napędzają warianty towaru, wyszukiwarkę i filtry oraz kategorie wirtualne.
- Przenoszenie zestawu pól między sklepami - definicje parametrów i lokacji da się wyeksportować i zaimportować plikiem, bez ręcznego odtwarzania konfiguracji.
Zachowanie parametru zależy od jego typu, ustalonego raz przy tworzeniu. Podstawowe typy:
- Krótki tekst - jedna linia tekstu.
- Długi tekst - tekst wielolinijkowy.
- Tak/Nie - tylko dwie wartości.
- Liczba całkowita - liczba bez części dziesiętnej, np. 20.
- Liczba zmiennoprzecinkowa - liczba z częścią dziesiętną, np. 19,99.
- HTML - treść edytowana domyślnie w edytorze WYSIWYG.
- Kwota - cena z podatkiem, wariantem brutto/netto i walutą.
- Wyliczeniowy - lista wartości do wyboru.
- Data - wartość w formacie daty, zwykle z kalendarzem przy edycji.
- Procent - wartość procentowa, np. rabat.
- Obrazek/Zdjęcie - link do zdjęcia z możliwością wgrania pliku, tekstu alternatywnego i linku docelowego.
- Plik - link do pliku z możliwością wgrania.
- Kilkanaście dalszych, bardziej wyspecjalizowanych typów - pełną listę z nazwami widocznymi w panelu zwraca narzędzie
ec2_property_types w asystencie AI.
Domyślnie sklep pokazuje i edytuje parametr w sposób wynikający z jego typu (np. przycisk wgrywania przy zdjęciu). Typu parametru nie da się zmienić po utworzeniu - inny typ wymaga nowego parametru.
Niezależnie od typu, każdy parametr można oznaczyć jedną lub kilkoma cechami:
- wielojęzyczny - wartości przechowywane osobno dla każdego języka sklepu,
- wielowartościowy - parametr przechowuje więcej niż jedną wartość naraz,
- wielowidokowy - wartość domyślna, którą każdy widok może nadpisać własną (Widoki).
Parametr działający jak słownik wartości (typowo wyliczeniowy) ma dodatkowe ustawienia:
- czy wartość musi pochodzić wyłącznie ze słownika, czy operator może wpisać nową,
- czy nowo wpisana wartość dopisuje się do słownika,
- czy w edycji widać tylko wartości już zapisane w słowniku,
- czy sklep podpowiada operatorowi synonimy wpisanej wartości.
Lokacja decyduje, gdzie parametr się pokazuje - np. w zakładce edycji towaru, w formularzu rejestracji klienta albo przy kopiowaniu danych klienta do zamówienia.
- Symbole lokacji zwykle mają budowę trójczłonową, np.
itemAdminList: item (obiekt, którego dotyczy lokacja) + Admin (panel administracyjny, w odróżnieniu od Shop - front sklepu) + List (konkretne miejsce, np. lista).
- Lokacje mogą być ułożone w drzewo - tak są zbudowane np. zakładki w edycji obiektu w panelu.
- Edycja lokacji pozwala zmienić jej ustawienia oraz zarządzać przypisanymi do niej parametrami: dodawać, zmieniać kolejność i usuwać.
- Definicje parametrów razem z lokacjami, w których się pokazują, da się wyeksportować i zaimportować plikiem XML przez Transfer danych - to sposób przenoszenia zestawu pól między sklepami Hummerce albo zapisania kopii konfiguracji.
- Osobny format pliku XML przenosi wartości parametrów zapisane na konkretnych obiektach (np. stronach statycznych, kategoriach parametrów) - w odróżnieniu od samych definicji.
- Import parametrów może dopisywać nowe elementy albo nadpisywać istniejące - nadpisanie atrybutów parametru, jego meta-parametrów albo lokacji to osobne opcje, każda działająca na całym zaznaczonym zakresie importu naraz.
- Eksport pozwala ograniczyć zakres do wybranego języka, widoku i daty utworzenia parametru.
- Parametry i lokacje to podstawowy mechanizm platformy Hummerce - działa we wszystkich obecnych wersjach.
- Import i eksport parametrów przez Transfer danych - dostępny w standardowej konfiguracji.
- Zarządzanie parametrami i lokacjami przez asystenta AI - w ramach serwera MCP, który działa od wersji 2.34 (zalecana 2.35.55 lub nowsza).
- Parametry wielojęzyczne wymagają języków skonfigurowanych w sklepie (Wielojęzyczność).
- Parametry wielowidokowe wymagają widoków (Widoki).
- Pokazanie parametru wymaga lokacji, którą odczytuje konkretny ekran panelu albo szablon sklepu - nowa lokacja bez odpowiedniego miejsca w szablonie nie pokaże się nigdzie.
- Import i eksport parametrów korzysta z tego samego mechanizmu Transfer danych, co pozostałe transfery XML.
- Nowy parametr działa po aktualizacji - założenie parametru i jego lokacji w istniejącym miejscu panelu lub sklepu to praca w panelu, bez zmian w kodzie.
- Pokazanie parametru w nowym, nieistniejącym dotąd miejscu szablonu (np. dodatkowa sekcja karty produktu) albo własny sposób edycji/wyświetlania wymaga wdrożenia.
- Minimalny szacowany czas:
- nowy parametr z lokacją w istniejącym miejscu panelu lub sklepu - od 1 h,
- nowa lokacja w miejscu, którego szablon jeszcze nie odczytuje - wyceniana indywidualnie po analizie zakresu.
- Od czego zależy czas:
- liczba języków i widoków, dla których parametr ma osobne wartości,
- liczba lokacji, w których parametr ma się pokazać,
- potrzeba zmian w szablonie sklepu,
- wielkość zestawu parametrów przy imporcie lub eksporcie między sklepami.
- Typu parametru nie da się zmienić po utworzeniu - inny typ wymaga nowego parametru i przeniesienia danych.
- Sam parametr nic nie pokazuje - dopiero dodanie go do lokacji wystawia go na konkretnym ekranie.
- Dodanie parametru do wyszukiwarki i filtrów sklepu to osobny krok konfiguracji, wykonywany poza samym utworzeniem parametru (zobacz Wyszukiwarka i filtry).
- Import z nadpisaniem (atrybutów, meta-parametrów albo lokacji) obejmuje cały zaznaczony zakres pliku naraz - zbyt szeroki zakres pliku może nadpisać parametry, których zmieniać nie chcieliśmy.
- Nie weryfikujemy konfiguracji parametrów pod kątem zgodności z prawem (np. wymogi etykietowania towaru, RODO dla parametrów klienta).
- Jedna operacja łącząca utworzenie parametru i dodanie go do wybranej lokacji, zamiast dwóch osobnych kroków w panelu.
- Włączenie parametru do wyszukiwarki i filtrów razem z dodaniem lokacji, bez osobnej konfiguracji w module wyszukiwarki.
Czy jeden parametr może mieć różne wartości w różnych językach sklepu?
Tak - parametr oznaczony jako wielojęzyczny przechowuje osobną wartość dla każdego języka.
Czy wartość parametru może być inna w każdym widoku sklepu?
Tak - parametr wielowidokowy ma wartość domyślną, którą każdy widok może nadpisać własną; widok bez własnej wartości pokazuje wartość domyślną.
Czy da się zmienić typ istniejącego parametru?
Nie. Trzeba utworzyć nowy parametr z innym typem - zmiana typu na istniejącym parametrze nie jest możliwa bez utraty zapisanych wartości.
Czy parametry da się przenieść z jednego sklepu Hummerce do drugiego?
Tak, plikiem XML przez Transfer danych - eksport z jednego sklepu i import do drugiego, z podglądem zmian przed zapisem.
Czy asystent AI może utworzyć parametr i pokazać go w panelu?
Tak, z uprawnieniami administratora - zakłada parametr, ustawia jego meta-dane i dodaje go do wybranej lokacji.
Ile trwa dodanie nowego parametru?
Od 1 h dla parametru z lokacją w istniejącym miejscu panelu lub sklepu; pokazanie go w nowym miejscu szablonu wyceniamy indywidualnie.
Chcecie zobaczyć, jak parametry i lokacje mogą działać w Waszym katalogu? Umówcie bezpłatną prezentację.
- Definicje i typy parametrów: Asortyment -> Parametry - spis typów parametrów, dodawanie i edycja parametru.
- Lokacje per obiekt: podmenu Parametry rozbite na obiekty, których dotyczą lokacje - m.in. Kategorie, Towary, Klienci, Zamówienia, Strony statyczne, Widok, Administratorzy, Typy komponentów; każde pokazuje lokacje danego typu obiektu z przypisanymi parametrami.
- Jednostki miary (osobny obiekt parametryzowany) - Asortyment -> Jednostki miary (Jednostki miary i sprzedaży).
- Import i eksport: Transfer danych - plik
<shopExtension> dla definicji parametrów i lokacji, plik <extension> dla wartości parametrów zapisanych na obiektach.
- REST API: odczyt i zapis parametrów oraz ich wartości na obiektach - towarach, klientach, zamówieniach, kategoriach, stronach i widokach (REST API).
- MCP (Asystent AI - serwer MCP):
ec2_property_types - lista typów parametrów z nazwami w języku operatora; warto sprawdzić przed ec2_property_create - typu nie da się zmienić po utworzeniu,ec2_property_create - zakłada nowy parametr (symbol, typ, nazwy per język, wielojęzyczność, wielowartościowość, wielowidokowość); Admin only,ec2_property_get - pełne dane o parametrze: typ, flagi, meta-parametry, nazwy per język i wszystkie lokacje, w których się pokazuje,ec2_property_set_meta - ustawia meta-parametr parametru (_format, _mandatory, _validation, _name, _description); Admin only,ec2_property_locations - bez parametru target pokazuje typy obiektów i liczbę ich lokacji; z target - lokacje danego obiektu; z location - parametry przypisane do tej lokacji, w kolejności wyświetlania,ec2_property_location_add / ec2_property_location_remove / ec2_property_location_reorder - dodanie, usunięcie i zmiana kolejności parametru w lokacji; Admin only,ec2_properties_xml_write / ec2_extension_xml_write - budują plik transferu (definicje parametrów i lokacje / wartości na obiektach) w katalogu transferu sklepu,ec2_properties_xml_import / ec2_extension_xml_import - importują taki plik; domyślnie w trybie podglądu, zapis dopiero z apply=true; Admin only,ec2_transfer_xml_spec - gramatyka obu formatów transferu razem ze słownictwem konkretnego sklepu (typy, lokacje, symbole parametrów) - do budowy pliku spoza panelu.
Nazwę i opis parametru ustawia się bezpośrednio w jego definicji (pole Nazwa dla każdego języka sklepu), a nie przez edytor komunikatów - komunikaty służą tu do etykiet ekranów panelu (menu Parametry i jego podmenu), nie do treści samych parametrów.
Meta-parametry, którymi opisuje się sam parametr (ustawiane przez ec2_property_set_meta albo w edycji parametru w panelu):
| Symbol |
Opis |
_name |
Nazwa parametru, per język |
_description |
Opis parametru, per język |
_format |
Podpowiedź formatu wpisywanej wartości |
_mandatory |
Czy pole jest wymagane |
_validation |
Reguła walidacji wartości |