# DataFirefly Group Catalog: ukrywanie produktów dla grup klientów i katalog na tablet

> Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, wysyłając plik ZIP. Podczas instalacji moduł tworzy swoje tabele, rejestruje hooki i dodaje zakładkę Katalog > Widoczność wg grup.…

- Strona: <https://www.datafirefly.com/pl/documentation/dfgroupcatalog/>
- Język: pl
- Zaktualizowano: 2026-09-29
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfgroupcatalog/index.md), [en](https://www.datafirefly.com/en/documentation/dfgroupcatalog/index.md), [it](https://www.datafirefly.com/it/documentation/dfgroupcatalog/index.md), [es](https://www.datafirefly.com/es/documentation/dfgroupcatalog/index.md), [de](https://www.datafirefly.com/de/documentation/dfgroupcatalog/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgroupcatalog/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfgroupcatalog/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Instalacja

Zainstaluj moduł w **Moduły > Menedżer modułów > Załaduj moduł**, wysyłając plik ZIP. Podczas instalacji moduł tworzy swoje tabele, rejestruje hooki i dodaje zakładkę **Katalog > Widoczność wg grup**.

Aby zaktualizować wcześniejszą wersję, wystarczy wgrać nowy plik ZIP: skrypt aktualizacji tworzy brakujące elementy bez zmiany zarezerwowanych produktów.

## Pierwsze ustawienie: grupa personelu

Moduł rozróżnia dwa rodzaje grup klientów:

- **Grupy personelu** widzą wszystkie zarezerwowane produkty i otwierają katalog na tablet. To grupa sprzedawców w sklepie stacjonarnym.
- **Pozostałe grupy**, na przykład odsprzedawcy B2B, widzą tylko przypisane im produkty zarezerwowane.

Najpierw utwórz osobną grupę w **Klienci > Grupy**, na przykład "Sprzedawcy", z takimi samymi warunkami cenowymi jak grupa Klient (rabat grupowy, ceny brutto lub netto), aby personel widział ceny publiczne. Następnie otwórz **Katalog > Widoczność wg grup**, zakładkę **Ustawienia**, zaznacz tę grupę w **Grupy personelu** i zapisz. Na koniec utwórz konto klienta dla każdego tabletu lub sprzedawcy i przypisz je do tej grupy.

Nie używaj grupy Klient jako grupy personelu: wszyscy klienci widzieliby wtedy produkty zarezerwowane.

## Rezerwacja produktu z karty produktu

Na karcie produktu otwórz zakładkę **Moduły** (nowa karta produktu w PrestaShop 8.1 i 9) lub sekcję modułów (stara karta). Panel **Widoczność wg grup klientów** oferuje dwie opcje:

- **Publiczny**: produkt stosuje swoje natywne ustawienia widoczności.
- **Zarezerwowany**: produkt jest ukryty w sklepie. Pozostaje widoczny dla grup personelu i grup zaznaczonych tuż poniżej.

Kliknij **Zapisz widoczność**. Zapis jest natychmiastowy i niezależny od przycisku zapisu karty produktu.

### Co daje rezerwacja

Produkt przechodzi na natywną widoczność _Nigdzie_. Znika więc z kategorii, wyszukiwarki, nawigacji fasetowej i modułów wyróżnionych produktów. Moduł zapamiętuje pierwotną widoczność, aby przywrócić ją przy publikacji, i dodaje trzy zabezpieczenia, których natywna widoczność nie zapewnia:

- bezpośredni URL produktu zwraca stronę nie znaleziono lub, przy włączonej opcji, stronę logowania dla niezalogowanego odwiedzającego;
- dodanie do koszyka jest blokowane;
- jeśli zarezerwowany produkt jest już w koszyku, zostaje usunięty przy składaniu zamówienia, a klient otrzymuje informację.

Zarezerwowany produkt musi pozostać **włączony**. Wyłączonego produktu nie widzi nikt, ani personel, ani uprawnione grupy.

## Masowe zarządzanie widocznością

Strona **Katalog > Widoczność wg grup**, zakładka **Produkty**, pokazuje cały katalog wraz ze statusem. Filtruj po nazwie, indeksie, EAN lub ID, po kategorii (z podkategoriami) i po statusie Publiczny lub Zarezerwowany.

Następnie wybierz zakres (**Zaznaczone produkty** lub **wszystkie produkty pasujące do filtra**) i akcję:

- **Zarezerwuj dla zaznaczonych grup**: zastępuje obecne grupy.
- **Dodaj** lub **Usuń zaznaczone grupy**: dotyczy tylko produktów już zarezerwowanych.
- **Upublicznij teraz**, z opcją włączenia również zamawiania.
- **Upublicznij w wybranym dniu** lub **Anuluj zaplanowaną publikację**.

### Akcja na liście indeksów

Blok **Zastosuj akcję do listy indeksów** przyjmuje indeksy, EAN, UPC lub ID produktów, po jednym w wierszu lub rozdzielone przecinkami. Indeks lub kod kreskowy wariantu wybiera jego produkt. Nieznalezione kody są wyświetlane po operacji, co pozwala poprawić plik od dostawcy.

### Automatyczna rezerwacja nowych produktów

W ustawieniach opcja **Automatycznie rezerwuj nowe produkty** sprawia, że każdy nowo utworzony produkt startuje jako Zarezerwowany, z grupami zaznaczonymi domyślnie. Przydatne, gdy przygotowujesz kolekcję przed publikacją w sklepie.

## Zaplanowana publikacja

Zarezerwowany produkt może stać się publiczny o określonej dacie i godzinie. Na karcie produktu uzupełnij pole **Upublicznij automatycznie** i w razie potrzeby zaznacz **i włącz zamawianie**. Masowo użyj akcji **Upublicznij w wybranym dniu**. Kolumna Widoczność na liście pokazuje zaplanowaną datę.

W wyznaczonym terminie moduł przywraca pierwotną widoczność, włącza zamawianie, jeśli o to poproszono, i ponownie uruchamia indeksowanie wyszukiwarki. Bez dodatkowej konfiguracji publikacja następuje przy pierwszej wizycie w sklepie po terminie. Aby uzyskać dokładną godzinę, wywołuj co 5 lub 15 minut adres cron widoczny w **Ustawienia > Konserwacja**. Jest on chroniony tokenem właściwym dla Twojego sklepu.

## Katalog na tablet

### Dostęp i instalacja

Adres katalogu znajduje się w **Ustawienia > Katalog sklepowy na tablety**, w postaci `/module/dfgroupcatalog/catalog`. Link pojawia się także w sekcji Moje konto uprawnionych klientów. Na tablecie zaloguj się raz kontem z grupy personelu, otwórz adres i dodaj go do ekranu głównego: katalog otworzy się wtedy na pełnym ekranie jak aplikacja.

Grupy zaznaczone w **Inne grupy z dostępem do katalogu sklepowego** też mogą go otworzyć, ale widzą tylko produkty publiczne i własne produkty zarezerwowane.

### Wyszukiwanie i skanowanie

- Wyszukiwanie obejmuje nazwę, indeks, EAN oraz indeksy i kody kreskowe wariantów.
- Przycisk skanowania używa kamery tabletu. Na Androidzie wykorzystywany jest natywny detektor przeglądarki, na iPadzie zadanie przejmuje biblioteka odczytu dołączona do modułu. Latarka jest dostępna, jeśli urządzenie ją ma.
- Czytnik kodów USB lub Bluetooth działa w dowolnym miejscu strony, także przy otwartej karcie produktu.
- Gdy kod dokładnie odpowiada produktowi lub wariantowi, karta otwiera się od razu na właściwym wierszu.

Panel **Kategorie**, filtr **Tylko dostępne**, sortowanie oraz, dla personelu, filtr Publiczny lub Zarezerwowany uzupełniają wyszukiwanie. Ostatnio oglądane produkty są wyświetlane na górze listy.

### Karta produktu na tablecie

Pokazuje galerię z powiększeniem na pełnym ekranie, cenę (przekreśloną przy rabacie, netto i brutto przy włączonej opcji), ceny wg ilości zalogowanej grupy, stan, datę ponownej dostępności, cechy i opis. Tabela wariantów podaje dla każdego indeks, EAN, cenę, stan i lokalizację w magazynie, jeśli została uzupełniona. Dotknięcie wariantu pokazuje jego zdjęcie. Personel widzi także, dla jakich grup zarezerwowany produkt jest widoczny.

### Widok klienta i kod QR

Przycisk **Widok klienta** u góry ekranu ukrywa stany magazynowe, lokalizacje, etykiety Zarezerwowany i wiersz "Widoczny dla", zanim odwrócisz tablet do klienta. Przy produkcie publicznym przycisk **Pokaż klientowi** wyświetla kod QR, który otwiera kartę produktu na jego telefonie.

## Ustawienia

- **Grupy personelu**, **Inne grupy z dostępem do katalogu sklepowego** i **Grupy zaznaczone domyślnie**.
- **Automatycznie rezerwuj nowe produkty**.
- **Odwiedzający otwierający produkt zarezerwowany**: strona logowania zamiast strony nie znaleziono.
- **Produkty zarezerwowane na listach sklepu**: patrz sekcja B2B.
- Dla katalogu na tablet: tytuł, liczba produktów na stronę, stany magazynowe, ceny netto i brutto, przycisk Widok klienta.

## Moduł w kanale B2B

Utwórz grupę odsprzedawców i zaznacz ją przy przeznaczonych dla niej produktach zarezerwowanych. Ci klienci otwierają kartę produktu, dodają do koszyka i zamawiają normalnie, a klienci B2C nic nie widzą.

Domyślnie zarezerwowany produkt nie pojawia się w kategoriach ani wyszukiwarce, nawet dla uprawnionej grupy: dostęp jest przez link lub katalog na tablet. Opcja **Produkty zarezerwowane na listach sklepu** pokazuje je uprawnionym grupom w kategoriach i wyszukiwarce. Dotyczy tylko tych klientów i tylko kategorii zawierających zarezerwowane dla nich produkty; widzą tam proste sortowanie zamiast filtrów fasetowych. Klienci B2C nigdy nie są objęci.

## Konserwacja i odinstalowanie

**Sprawdź produkty zarezerwowane** ponownie ukrywa zarezerwowany produkt, którego widoczność zmieniono poza modułem, przez import lub przez pracownika, którego profil nie ma uprawnień do modułu.

**Upublicznij wszystkie produkty** przywraca każdemu zarezerwowanemu produktowi pierwotną widoczność. Użyj tej opcji przed odinstalowaniem: w przeciwnym razie produkty zarezerwowane pozostaną ukryte, co jest najbezpieczniejszym ustawieniem.

## Rozwiązywanie problemów

### Personel nie widzi produktów zarezerwowanych

Sprawdź, czy konto należy do grupy zaznaczonej w Grupy personelu i czy produkt jest włączony, a następnie wyloguj i ponownie zaloguj konto na tablecie.

### Zarezerwowany produkt znów jest widoczny

Jego widoczność została prawdopodobnie zmieniona przez import lub pracownika bez uprawnień do modułu. Uruchom **Sprawdź produkty zarezerwowane** i nadaj profilowi uprawnienie "Wyświetl" dla modułu w **Zaawansowane > Zespół > Uprawnienia**.

### Brak przycisku skanowania lub kamera jest zablokowana

Kamera jest dostępna tylko w sklepie działającym na HTTPS. Zezwól stronie na dostęp do kamery w ustawieniach przeglądarki tabletu. Alternatywą pozostaje czytnik kodów kreskowych.

### Zaplanowany produkt nie jest jeszcze publiczny

Bez zadania cron publikacja czeka na następną wizytę w sklepie. Otwórz dowolną stronę sklepu lub skonfiguruj adres cron. Wyczyść pamięć podręczną, jeśli aktywny jest moduł cache stron.

### Ceny w katalogu na tablet różnią się od cen na stronie

Katalog pokazuje ceny grupy zalogowanego konta. Nadaj grupie personelu te same rabaty i ten sam sposób wyświetlania podatku co grupie Klient.

## Znane ograniczenia

- Feedy produktowe obsługiwane przez inne moduły (Google Shopping, marketplace, porównywarki) nie są filtrowane wg grup: wyklucz w nich produkty zarezerwowane.
- Bloki akcesoriów dodawane przez moduły zewnętrzne mogą pokazywać produkt zarezerwowany powiązany z produktem publicznym.

## Kompatybilność

- PrestaShop 8.0 do 9.x w jednym pliku ZIP, stara i nowa karta produktu.
- Natywna nawigacja fasetowa (ps_facetedsearch).
- Architektura ModuleAdminController, bez zależności Composer.
- Interfejs przetłumaczony na francuski, angielski, hiszpański, niemiecki, włoski, niderlandzki, polski i portugalski.
